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 |
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,
|
|
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,
|
|
Transform Autocrop an Image |
None |
|
Transform Flip an Image |
/a = Flip direction. 0 = Horizontal, 1 = Vertical |
|
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, |
|
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 |
|
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 |
|
Twirl Rotates an image more at the center than at the edges |
/a = Pitch Angle (degrees) -360.0 to +360.0 |
|
Reproduce Creates multiple copies of the input image along the vertical and horizontal axis |
/a = Number of copies. |
|
Autocontrast Autocrop an Image |
None |
|
Autolevel Autolevel an image |
None |
|
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) |
|
Color Blue |
/a = Color Level Adjustment (-255 to +255). 0 = No change to blue level of every pixel. |
|
Brightness |
/a = Brightness Level Adjustment (-255 to +255). 0 = No change. |
|
Red, Green, Blue Lightness |
/a = Red Lightness (0 to 255) /b = Green Lightness (0 to 255) /c = Blue Lightness (0 to 255) |
|
Contrast |
/a = Brightness Level Adjustment (0.0 to 1.0). 1.0 = No change. |
|
Desaturate |
None |
|
Equalize |
/a = Equalization (Must be greater than or equal to 0.0) |
|
Gamma |
/a = Gamma (Must be greater than or equal to 0.0). 1.0 = No Change |
|
Color Green |
/a = Color Level Adjustment (-255 to +255). 0 = No change to green level of every pixel. |
|
Hue |
/a = Hue. Angle of color rotation (-360.0 to +360.0) |
|
Intensity |
None |
|
Color inversion |
None |
|
Lightness |
/a = Color Lightness Adjustment (-1.0 to +1.0). -1.0 = All Black +1.0 = All White |
|
Tonal Levels |
/a = Number of tonal levels (2 to 255) |
|
Color Red |
/a = Color Level Adjustment (-255 to +255). 0 = No change to red level of every pixel. |
|
Saturation level |
/a = Saturation Level (-1.0 to 1.0) -1.0 = same as desaturateRHID_P18_Desaturate +1.0 = All pixels extremely saturated |
|
Threshold Level |
/a = Threshold Level (0 to 255) All pixels greater than threshold are turned to white, less to black |
|
High Pass Filter |
/a = High Pass Filter Type 0 = Medium High Pass Filter 1 = Strong High Pass Filter 2 = Weak High Pass Filter |
|
Low Pass Filter |
/a = Low Pass Filter Type 0 = Strong Low Pass Filter 1 = Medium Low Pass Filter 2 = Weak High Pass Filter |
|
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 |
|
Laplas Filter |
/a = Filter Type 0 = Laplas High 1 = Laplas Low |
|
Sobel Filter |
/a = Filter Type 0 = Vertical Search for Irregularity 1 = Horizontal Search for Irregularity |
|
Prewitt Filter |
/a = Filter Type 0 = Vertical Search for Irregularity 1 = Horizontal Search for Irregularity |
|
Roberts Filter |
/a = Filter Type 0 = 1st Diagonal 1 = 2nd Diagonal |
|
Isotropic Filter |
/a = Filter Type 0 = Vertical Search for Irregularity 1 = Horizontal Search for Irregularity |
|
Isotropic Filter |
/a = Filter Type 0 = Vertical Search for Irregularity 1 = Horizontal Search for Irregularity 2 = 1st Diagonal 3 = 2nd Diagonal |
|
Blur Filter |
/a Blur amount (0.0 to 1.0) |
|
Sharpen Filter |
/a Sharpen amount (0.0 to 1.0) |
|
Minimal Filter |
/a Size of Filtering (1 to 256) |
|
Maximal Filter |
/a Size of Filtering (1 to 256) |
|
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
Specifying a Conversion Job File
Image Conversion File Type Constants