All Command Line Switches

A full description for each switch is shown below:

Switch

Meaning

/J{File}

Specify a 'Conversion Job' file (*.SII) to be done. You must have previously created a 'Conversion Job' file to use this switch.

/S{File}

Input File(s) to be converted.

 

A single file including its complete path can be specified for a single file conversion. For example:

/S"D:\MyImageFiles\SingleImage.jpg"

 

If specifying a single file, make sure that the /T switch also specifies a single output file. For example:

/T"D:\OutputFiles\TargetOutput.gif"

 

Alternatively, you can specify whole directories by using the wildcard syntax. For example:

/S"D:\MyImageFiles\*.png"

If specifying a whole directory, make sure the /T also specifies a whole directory. For example:

/T"D:\OutputFiles\*.GIF"

 

Use double quotes around the path to ensure it works properly.

 

See also /R for subfolders.

/F #

File type of the Input file(s). /F must be followed by a number indicating the file type of the image to be converted. Please see the File Type Constants table for a list of valid values.

 

/T{File}

Output File(s) to be created when converting the Input file(s).

 

See the /S{File} switch description for proper use of the /T{File} switch when specifying a single or multiple files to convert.

 

This switch is ignored if the /G switch is used.

/C #

File type of the Output file(s).  Please see the File Type Constants table below for a list of valid values.

/G

Save files to the same location as the input folder(s). Use this instead of /T to place the converted files in the same folder as the input file. Cannot be used when converting a single file. For a single file use the /T switch instead.

Files will be saved with the same name as the input but with a different file extension as specified by the /C# switch.

You cannot specify a different name for the output file when using the /G switch.

/V

Verbose mode. Specify this switch to display a message box indicating how the conversion went. See also /L

/R

Recursive sub folders. Seek out and do all files found in the sub-folders specified in the /S switch.  You may add this switch if you are processing whole folders of files. See /S, /T and /G for more details on selecting whole directories to be converted.

/L{File}

Log file path and name (i.e. D:\MyLogs\ConvertImage.LOG) If this switch is specified a log file with the given path and name will be created and the results of the conversion will be written to it. See also /V.

/B{File}

Save the Log file as a 'Conversion Job' ONLY IF ERRORS OCCURRED. This is useful if the files that had problems, they can be done at a later time, perhaps with a different method. /B differs from /L, since the file generated with /B will not include extraneous comments not allowed in a 'Conversion Job' file. Use the *.SII file type extension so it can be loaded as a job.

/1{Pages To Convert}

TIFF: Specify which pages of a Tiff file to convert. For example if you have a multipage TIFF and you want to convert the 1st and 3rd page use "/1 1,3". To do pages 2-5 use "/1 2-5"

/2#

TIFF: Compression to use when converting TO a TIFF file (default is no compression). Use "/2 0" for no compression and "/2 2" for LZW compression.

0 - No compression. Save image as 24bpp uncompressed TIFF file.

1 - LZW. Save image as 24bpp TIFF file with LZW compression.

2 - RLE. Save image as 1bpp TIFF file with RLE compression.

3 - CCITT3. Save image as 1bpp TIFF file with CCITT3 compression.

4 - CCITT4. Save image as 1bpp TIFF file with CCITT4 compression.

/3{TRUE/FALSE}

TIFF: Append to existing when converting to a TIFF. Use "/3 TRUE" to append "/3 FALSE" not to.

/4#

 

JPEG: Quality of the resulting JPG from 0 to 100 (default is 100). 0 is lowest and 100 is highest quality. The higher the quality the larger the resulting output file. Use "/4 100" for highest quality.

/5{Tag}

TAG: TITLE of the image. For example to associate the title of "President" to the resulting image use "/5 President"

/6{Tag}

TAG: DESCRIPTION of the image. For example to associate the description of "Money is the product of a humans capacity to think" to the resulting image use "/6 Money is the product of a humans capacity to think"

/7{Tag}

TAG: DATE/TIME of the image. For example to associate the date/time "July 4th 1976" to the resulting image use "/7 July 4th 1976"

/8{Tag}

TAG: AUTHOR of the image. For example to associate the author "Krishnamurti" to the resulting image use "/8 Krishnamurti"

/9{Tag}

TAG: COPYRIGHT of the image. For example to associate the copyright "Copyright 2005, Softinterface" to the resulting image use "/9 Copyright 2005, Softinterface".

/P#

Special Process Identifier. An integer, which tells 'Convert Image' which special process to apply to the Input files. For example /P2 tells 'Convert Image' to resize an image. /P is almost always used with /a- /j switches. See table below for each possible value and associated /a- /j switches.

[/a- /j]

/a- /j are used to specify additional parameters that may be necessary for the special process (see /P) being done. For example /P2 tells 'Convert Image' to resize an image. In this case /a is used to specify the width, /b is used to specify the height, /c is used to specify the method of interpolation and /d is used to specify the background color. This might end up looking like:

ConvertImage /SC:\Input\Tryme.jpg /TC:\Output\Out.jpg /P2 /a10 /b20 /c2 /d0 /V

Table Above: All Command Line Switches

 

Table Below: Special Process /P# Switches and Associated /a-/j switches

NOTE: Below is the table for all Special Processes /P. Click on the number at the left part of the table to go to an example of how to use the special process from the command line.

 

/P#

Meaning

Extra Parameters: /a{Parameter1}…./j

2

Transform

Resize an Image

/a = New width of the image (Pixels)

/b = New height of the image (Pixels)

/c = Method of Interpolation (0 = None, 1 = Billinear, 2 = Bicubic). The method by which the picture is recalculated (shrunk or stretched). You have 3 choices (None, Billinear, and Bicubic).

/d = Background color of the new image. This is an integer value.

BackColor = Red + Green*256 + Blue*256*256 (Red, Green and Blue are 8 bits each)

For example, image\ebx_-1548167381.gif = (R=51, G=193, B = 172) = 51 + 193*256 + 172*256*256 = 11321651

 

3

Rotate

Rotates an image by the specified angle.

/a = Angle of rotation (degrees) -360.0 to +360.0

/b = Background color of the new image. This is an integer value.

BackColor = Red + Green*256 + Blue*256*256 (Red, Green and Blue are 8 bits each)

For example, image\ebx_-1548167381.gif = (R=51, G=193, B = 172) = 51 + 193*256 + 172*256*256 = 11321651

 

4

Transform

Autocrop an Image

None

5

Transform

Flip an Image

/a = Flip direction. 0 = Horizontal, 1 = Vertical

6

Shift

Shift an Image in the X and Y direction

/a = Horizontal displacement (pixels).

/b = Vertical displacement (pixels)

/c = Background color of the new image. This is an integer value.

BackColor = Red + Green*256 + Blue*256*256 (Red, Green and Blue are 8 bits each)

For example, image\ebx_-1548167381.gif = (R=51, G=193, B = 172) = 51 + 193*256 + 172*256*256 = 11321651

7

Perspective

Transform the oblique plane of a rectangle image to a straight on view

/a = Vertical correction. TRUE for Vertical and FALSE for Horizontal

/b = Pitch Angle (degrees) -90.0 to +90.0

8

Skew

Move one border relative to the opposite one

/a = Vertical correction. TRUE for Vertical and FALSE for Horizontal

/b = Pitch Angle (degrees) -90.0 to +90.0

9

Twirl

Rotates an image more at the center than at the edges

/a = Pitch Angle (degrees) -360.0 to +360.0

10

Reproduce

Creates multiple copies of the input image along the vertical and horizontal axis

/a = Number of copies.

11

Autocontrast

Autocrop an Image

None

12

Autolevel

Autolevel an image

None

13

Hue, Lightness and Saturation

/a = Hue angle of rotation (-360.0 to 360.0)

/b = Lightness (-1.0 to 1.0)

/c = Saturation (-1.0 to 1.0)

14

Color Blue

/a = Color Level Adjustment (-255 to +255). 0 = No change to blue level of every pixel.

15

Brightness

/a = Brightness Level Adjustment (-255 to +255). 0 = No change.

16

Red, Green, Blue Lightness

/a = Red Lightness (0 to 255)

/b = Green Lightness (0 to 255)

/c = Blue Lightness (0 to 255)

17

Contrast

/a = Brightness Level Adjustment (0.0 to 1.0). 1.0 = No change.

18

Desaturate

None

19

Equalize

/a = Equalization (Must be greater than or equal to 0.0)

20

Gamma

/a = Gamma (Must be greater than or equal to 0.0). 1.0 = No Change

21

Color Green

/a = Color Level Adjustment (-255 to +255). 0 = No change to green level of every pixel.

22

Hue

/a = Hue. Angle of color rotation (-360.0 to +360.0)

23

Intensity

None

24

Color inversion

None

25

Lightness

/a = Color Lightness Adjustment (-1.0 to +1.0). -1.0 = All Black

+1.0 = All White

26

Tonal Levels

/a = Number of tonal levels (2 to 255)

27

Color Red

/a = Color Level Adjustment (-255 to +255). 0 = No change to red level of every pixel.

28

Saturation level

/a = Saturation Level (-1.0 to 1.0)

-1.0 = same as desaturateRHID_P18_Desaturate

+1.0 = All pixels extremely saturated

29

Threshold Level

/a = Threshold Level (0 to 255)

All pixels greater than threshold are turned to white, less to black

45

High Pass Filter

/a = High Pass Filter Type

0 = Medium High Pass Filter

1 = Strong High Pass Filter

2 = Weak High Pass Filter

46

Low Pass Filter

/a = Low Pass Filter Type

0 = Strong Low Pass Filter

1 = Medium Low Pass Filter

2 = Weak High Pass Filter

47

Difference Filter

/a = Difference Filter Type

0 = Up

1 = Up-Left

2 = Left

3 = Down-Left

4 = Down

5 = Down-Right

6 = Right

7 = Up-Right

48

Laplas Filter

/a = Filter Type

0 = Laplas High

1 = Laplas Low

49

Sobel Filter

/a = Filter Type

0 = Vertical Search for Irregularity

1 = Horizontal Search for Irregularity

50

Prewitt Filter

/a = Filter Type

0 = Vertical Search for Irregularity

1 = Horizontal Search for Irregularity

51

Roberts Filter

/a = Filter Type

0 = 1st Diagonal

1 = 2nd Diagonal

52

Isotropic Filter

/a = Filter Type

0 = Vertical Search for Irregularity

1 = Horizontal Search for Irregularity

53

Isotropic Filter

/a = Filter Type

0 = Vertical Search for Irregularity

1 = Horizontal Search for Irregularity

2 = 1st Diagonal

3 = 2nd Diagonal

54

Blur Filter

/a Blur amount (0.0 to 1.0)

55

Sharpen Filter

/a Sharpen amount (0.0 to 1.0)

58

Minimal Filter

/a Size of Filtering (1 to 256)

59

Maximal Filter

/a Size of Filtering (1 to 256)

60

Deinterlace Filter

/a Interpolate Colors ("True" or "False")

/b Odd or Even lines (0 = Even, 1 = Odd)

Table: Special Process /P# Switches and Associated /a-/j switches

 

See Also:

Helpful Hints for Creating a Command Line

Command Line Examples

Specifying a Conversion Task

Specifying a Conversion Job File

Image Conversion File Type Constants

Using the Command Line

All Command Line Switches