Command-Line Parameters
AutoImager offers extensive command-line
support. With over 150 configurable command-line choices, you can easily
create batch files to perform image processing tasks which may need to be done
routinely. You can set up your computer to run the batch file on a schedule
and leave the routine image processing tasks to AutoImager.
Clicking the Show Command Line item on the Options menu displays the command line text
string for the processing or conversion files and options selected. The text can
then be easily copied and pasted into a batch file or the Run dialog box for use.
Below is a list of the command-line options. Items appearing between parentheses
are explanations. Items appearing in angle brackets need to be replaced with a
value.
For example, for /q (quiet mode), the (quiet mode) explains that
putting /q causes AutoImager to run in quiet mode. If you see /oq <jpeg quality>,
you need to replace <jpeg quality> with a value such as /oq 75. Following
the command-line options are a few examples.
Help
/? (command-line help)
List and Image Managing
/l <listname>
/f <filename(s)>
Click for examples:
The /f command allows you to specify the following items:
- Path (/f c:\Images)
- Wildcard (/f c\:Images*.jpg)
- Single file (/f c:\ImagesSample.jpg)
All three of these options can be a single or multiple or any combination. For example, (/f c:\Images,c:\Other\*.bmp,c:\DataImage.tif) adds all the images in the Images directory (folder), all the bmp images in the Other directory, and the Image.tif image.
/p <process>
Click for list:
The available processes are as follows:
Auto-Trim
Crop
Deskew
Flip
Mirror
Resample
Resize
Rotate
Shear
AddNoise
Anti-Alias
Average
Bending
BorderRemove
Brightness
Buttonize
ColorResolution
ColoredGray
Contour
Contrast
Cylindrical
Despeckle
Dilate
DotRemove
DPIResolution
EdgeDetector
Emboss
Erode
Etch
GammaCorrect
GaussianBlur
Glow
Gradient
Grayscale
Half-Tone
HistoContrast
HolePunchRemove
Hue
Impressionist
IntensityDetect
Invert
InvertText
Laplacian
LineRemove
LineSegment
MaxFilter
Median
MinFilter
Mosaic
MotionBlur
Multiply
Oilify
OldPhoto
Pixelate
Polar
Posterize
Prewitt
Punch
RadialWave
Ripple
Saturation
Sharpen
ShiftandDifference
Smooth
Sobel
Solarize
Spherize
StretchIntensity
Swirl
Underlay
UnsharpMask
Waggle
Wave
WaveShear
Wind
ZoomBlur
ZoomWave
/c <convert>
Click for list:
The available conversion types are:
AWD
BMP
CLP
CUR
CUT
DCM
EPS
EXF
FPX
GIF
ICA
ICO
IFF
IMG
ITG
J2K
JBG
JPG
PCT
PCX
PDF(1)
PDF(2)
PDF(3)
PNG
PSD
RAS
RAW
SCT
SGI
SMP
TGA
TIF(1)
TIF(2)
WBMP
WMF
WPG
Image Conversion and Processing Settings
/op <output path>
/q (quiet mode)
/s (include subfolders)
/oq <jpeg quality: 1-100>
Image Conversion Settings
/oc <color depth> Valid settings for color depth include 1, 4, 8, 16, 24, and 32 as supported by the output format.
/u (use source path for output)
/d (delete source after processing)
/om <multi-page output filename>
/mpfb <multi-page file behavior>
Click for options:
Valid values include the following:
0 = Outputs multi-page files when supported by destination format.
1 = Outputs single-page images for each frame of multi-page files.
2 = Outputs single-page images from the first page of multi-page files.
Image Processing Settings
/orp
(prompt to replace)
/ora (auto overwrite)
/ore <append text>
/os (apply processing to source)
Add Noise
/anl <level: 0 - 1000>
/anc <channel>
Click for options:
The Anti-Alias filter options are as follows:
0 = Master
1 = Red
2 = Green
3 = Blue
Anti-Alias
/aat <threshold: 0 - 25>
/aams <mask size: 1- 25>
/aaf <filter>
Click for options:
0 - Vertical and Horizontal
1 - Omnidirectional
2 - Omnidirectional (The filter used for this option is different from the filter used for the previous option.)
3 - Diagonal
4 - Horizontal
5 - Vertical
Auto-Trim
/atthresh <threshold: 0 - 244>
Average
/avs <sample size: 2 - 255>
Bending
/bv <bending value (-500 to 500)>
/bcx <centerX...X coordinate of the center of the arc> This parameter is ignored when either Horizontal or Vertical is set in the Flags parameter.
/bcy <centerY...Y coordinate of the center of the arc> This parameter is ignored when either Horizontal or Vertical is set in the Flags parameter.
/bfc <bending fill color> Specify color settings in RGB using comma delimiters. For example: 0,0,0
/bf <bending flags> Flag settings can accept multiple options by using a bit wise value (|) to specify one flag from each group.
Click for options:
Peripherally exposed areas:
0 - Fill any exposed area with fill color.
1 - Stretch the edges of the image to fill the exposed area.
2 - Leave the exposed area as is, without changing it.
Exposed center:
0 - Rotate the image inside the arc pattern.
16 - Fill the exposed center as you would any other exposed area. This is determined by setting flags for the peripherally exposed areas. This flag is ignored if the Value parameter is negative.
Bitmap bending:
0 - Stretch the image along the vertical and horizontal planes.
256 - Stretch the image along the horizontal plane.
512 - Stretch the image along the vertical plane.
Border Remove
/brf <flags>
Click for options:
2 = Single Region
4 = Internal Region
8 = Callback Region
16 = Unchanged Image
2048 = Use Variance
2978 = All Flags
/brs <location of holes>
Click for options:
-1 = Delta Max
1 = Left
2 = Right
4 = Top
8 = Bottom
15 = All Sides
/brp <border percent>
/brwnl <white noise length>
/brv <variance>
Brightness
/btp <percent: -1000 - 1000>
Buttonize
/bzd <depth> in pixels
/bzw <weight> in pixels
/bzo (oval mode)
/bzt <type> (0 - 2)
Color Resolution
/crb <bits per pixel: 1 - 32>
/crd <dither method>
Click for options:
The following are the available dither types:
0 = None
1 = Floyd-Steinberg
2 = Stucki
3 = Burkes
4 = Sierra
5 = Stevenson Arce
6 = Jarvis
7 = Ordered Dithering
8 = Clustered Dithering
/crp <palette>
Click for options:
The Palette choices are:
0 = RGB color order
1 = Fixed
2 = Optimized
4 = BGR color order
8 = Windows Identity
64 = Netscape Fixed
128 = Use grayscale
/crc <colors: integer value>
Colored Gray
Important
- The
Red Weight, Green Weight, and Blue Weight values must total 1000 when you add
them together. The commonly-used values are 300, 500, and 110.
/cgrv
<red weight: 0 - 1000>
/cggv <green weight: 0 - 1000>
/cgbv <blue
weight: 0 - 1000>
/cgra <red weight factor modifier: 50 - 500>
/cgga
<green weight factor modifier: 50 - 500>
/cgba <blue weight factor
modifier: 50 - 500>
Contour
/coo <option>
Click for options:
0 = Return after the thinning algorithm
1 = Return after contour linking, using only black and white
2 = Return after contour linking, using 256 grayscale
3 = Return after contour linking, using colors
4 = Return after line segment approximation, using colors
/cot <threshold: 1 - 254>
/cod <delta direction: 1 - 64>
/com <maximum error: 0 - 255> (5 is used in most cases)
Contrast
/ctp <percent: -1000 - 1000>
Crop
/cpup (use percentage)
/cpp <crop percentage value>
/cpl <left>
/cpt <top>
/cpw <width>
/cph <height>
Cylindrical
/cyv <value: (-100 to 100)>
/cyf <flag>
Click for options:
Type (0 = Horizontal; 1 = Vertical)
Dilate
/dff <dilate filter>
Click for options:
4 = Omnidirectional
5 = Horizontal
6 = Vertical
7 = Diagonal
Dot Remove
/drf <flags>
Click for options:
1 = Use DPI
2 = Single Region
4 = Internal Region
8 = Callback Region
16 = Image Unchanged
32 = Use Size
4096 = Diagonals
4159 = All Flags
/drmw <min dot width>
/drmh <min dot height>
/drxw <max dot width>
/drxh <max dot height>
DPI Resolution
/dpiw <width>
/dpih <height>
Edge Detector
/edt <edge detect threshold>
/edft <edge detect filter type>
Click for options:
257 = Detect the vertical edges
258 = Detect the horizontal edges
259 = Detect horizontal & vertical edges
513 = Detect the vertical edges
514 = Detect the horizontal edges
515 = Detect horizontal & vertical edges
769 = Detect vertical & horizontal edges
770 = Detect general edges
771 = Detect general edges. (The filter used for this option is different
than the filter used for the 770 switch.)
772 = Detect the diagonal edges
773 = Detect the horizontal edges
774 = Detect the vertical edges
1025 = Detect north edges
1026 = Detect north east edges
1027 = Detect east edges
1028 = Detect south east edges
1029 = Detect south edges
1030 = Detect south west edges
1031 = Detect west edges
1032 = Detect north west edges
Emboss
/emdir <direction>
Click for options:
The available direction choices are:
0 = North
1 = North-East
2 = East
3 = South-East
4 = South
5 = South-West
6 = West
7 = North-West
/emdep <depth: 0 - 1000>
Erode
/erf <direction>
Click for options:
0 = Omnidirectional
1 = Horizontal
2 = Vertical
3 = Diagonal
Gamma Correct
/gcv <value: 1 - 499>
Gaussian Blur
/gfv <blur size: 1 - 1000>
Gradient
/gf <gradient filter>
Click for options:
8 = North
9 = North-east
10 = East
11 = South-east
12 = South
13 = South-west
14 = West
15 = North-west
Grayscale
/gsr <red factor>
/gsg <green factor>
/gsb <blue factor>
Half-Tone
/htt <type>
Click for options:
0 = Halftone for printing
1 = Halftone for display
2 = Rectangular halftone
3 = Circular halftone
4 = Elliptical halftone
5 = Random halftone
6 = Linear halftone
/hta <angle>
/hts <grain size>
HistoContrast
/hcp <percent: -1000 - 1000>
Hole Punch Remove
/hpcmin <min hole count>
/hpcmax <max hole count>
/hpmw <min hole width>
/hpmh <min hole height>
/hpxw <max hole width>
/hpxh <max hole height>
/hpl <location of holes>
Click for options:
1 = Left
2 = Right
3 = Top
4 = Bottom
/hpf <flags>
Click for options:
2 = Single Region
4 = Internal region
8 = Callback Region
16 = Image Unchanged
255 = All
Hue
/hua <angle: -360 - 360>
Impressionist
/ihv <horizontal value> Pass in the RGB format: (0,0,0)
/ivv <vertical value> Pass in the RGB format: (0,0,0)
Intensity Detect
/idl <low value>
/idh <high value>
/idic <in color>
/idoc <out color>
/idc <channel>
Click for options:
0 = Master
1 = Red
16 = Green
256 = Blue
Invert Text
/itf <flags>
Click for options:
2 = Single Region
4 = Internal Region
8 = Callback Region
26 = Unchanged Image
2048 = Use Variance
2078 = All Flags
/itmw <min width>
/itmh <min height>
/itmbc <min black percent>
/itxbc <max black percent>
Line Remove
/lrf <flags>
Click for options:
1 = Use DPI
2 = Single Region
4 = Internal Region
8 = Callback Region
16 = Unchanged Image
512 = Remove Entire
1024 = Use Gap
2048 = Use Variance
3615 = All Flags
/lrml <min length>
/lrxw <max width>
/lrwh <wall height>
/lrwp <wall percent>
/lrxg <max gap>
/lrv <variance>
/lrs <lines to remove>
Click for options:
1 = Horizontal
2 = Vertical
Laplacian Filter
/lf <filter>
Click for options:
16 = Omnidirectional Type 1
17 = Omnidirectional Type 2
18 = Omnidirectional Type 3
19 = Diagonal
20 = Horizontal
21 = Vertical
Line Segment
/lsf <filter>
Click for options:
29 = Horizontal
30 = Vertical
31 = Left to Right
32 = Right to Left
Max Filter
/mxfs
<sample size: 2 - 100>
Median
/mds <sample size: 2 - 100>
Min Filter
/mnfs <sample size: 2 - 100>
Mosaic
/mos <tile size: 2 - 64>
Motion Blur
/mbs <size: 3 - 100>
/mba <angle: 1 - 360>
/mbud (unidirectional)
Multiply
/mf <factor>
Oilify
/ofs <sample size: 2 - 255>
Pixelate
/pixcw <cell width>
Click for options:
If Flags contains:____ and Cell Width contains:____, then the range of
possible values for Cell Width are:
- 32 | 256 - the number of cells around the CenterX,CenterY point. That is, the circle around the CenterX,CenterY is divided into Cell Width equal parts. - 1 to 360. The circle can be divided into anywhere from 1 to 360 equal parts.
- 32 | 512 - the size, in degrees of the cells around the CenterX,CenterY. That is, the circle around the CenterX,CenterY is divided into cells of Cell Width degrees - 1 to 360. The circle can be divided into cells of 1 degree to 360 degrees.
- 16 | 256 - the number of cells present across the width of the image - 1 to the image width.
- 16 | 512 - the width of each rectangular cell, in pixels - 1 to the image width.
/pixch <cell height>
Click for options:
If Flags contains:____ and Cell Height contains:____, then the range of
possible values for Cell Height are:
32 | 1024 - the number of cells present along the radius of the circular cell - 1 to the diagonal of the image.
32 | 2048 - the radial length of each circular cell, in pixels - 1 to the diagonal of the image.
16 | 1024 - the number of cells present across the height of the image - 1 to the image height.
16 | 2048 - the height of each rectangular cell, in pixels - 1 to the image height.
/pixo <opacity>
/pixcx <centerx>
/pixcy <centery>
/pixf <flags> Flag settings can accept multiple options by using a bit wise value (|) to specify one flag from each group.
Click for options:
0 = Fill the cell with its maximum pixel value.
1 = Fill the cell with its minimum pixel value.
2 = Fill the cell with its average pixel value.
16 = Divide the image into rectangular cells. If this flag used, the CellWidth value contains the cell width in pixels or the number of cells across the width of the image. CellHeight contains the cell height in pixels or the number of cells across the height of the image.
32 = Divide the image into circular cells, centered around CenterX,CenterY. If this setting is used, the Cell Width value determines the angular component of the cell, and Cell Height determines the radial component of the cell. Please note that this setting must be combined with (512) or (256)
256 = Indicates the number of cells along the width of the image if rectangular cells are used. If circular cells are used, this indicates the number of cells present around the center of the circle.
512 = Indicates the width, in pixels of a cell, if rectangular cells are used. If circular cells are used, this indicates the number of degrees in each cell around the center point.
1024 = Indicates the number of cells along the height of the image if rectangular cells are used. If circular cells are used, this indicates the number of cells present along the radius of the circle.
2048 = Indicates the height, in pixels of a cell, if rectangular cells are used. If circular cells are used, this indicates the radial length of each cell along the radius.
Polar
/polc <color>Pass in the RGB format: (0,0,0)
/polf <flags>Flag settings can accept multiple options by using a bit wise value (|) to specify one flag from each group.
Click for options:
Exposed areas:
0 = Fill any exposed areas with the fill color.
1 = Stretch the image edges to fill the exposed area.
2 = Leave the exposed area as is, without changing it.
Conversion:
0 = Convert the image from Cartesian (rectangular) coordinates to polar coordinates.
16 = Convert the image from polar coordinates to Cartesian (rectangular) coordinates.
Posterize
/pol <levels: 2 - 64>
Prewitt
/pref <filter>
Click for options:
24 = Horizontal
25 = Vertical
Punch
/punv <value>
/puns <stress>
/puncx <centerX>
/puncy <centerY>
/punfc <fill color> Pass in the RGB format: (0,0,0)
/punf <flags> Flag settings can accept multiple options by using a bit wise value (|) to specify one flag from each group.
Click for options:
Exposed areas:
0 = Fill any exposed areas with the fill color. Pass in the RGB format: (0,0,0)
1 = Stretch the image edges to fill the exposed area.
2 = Leave the exposed area as is, without changing it.
Centrally exposed areas:
0 - Rotate the image inside the pinch pattern.
16 - Fill the exposed center the same way the peripherally exposed areas are filled.
Radial Blur
/radv <value: (1 to 100)>
/radcx <centerx>
/radcy <centery>
/rads <stress>
Radial Wave
/rwva <amplitude: (0 to 100)>
/rwvcx <centerx>
/rwvcy <centery>
/rwvwl <wave length>
Click for options:
0 - The value in Wave Length is a wavelength given as a percent of the image dimensions. If this value is set, the valid range of Wave Length is from 0 to 100.
1 - The value in Wave Length is the frequency, or the number of times the wave repeats.
/rwvwp <wave phase>
/rwvfc <wave fill color> Pass in the RGB format: (0,0,0)
/rwvf <flags>
Click for options:
Exposed areas:
0 = Fill any exposed areas with the fill color.
1 = Stretch the image edges to fill the exposed area.
2 = Leave the exposed area as is, without changing it.
Resample
/rska (keep aspect)
Click for information:
To always use height when keeping aspect ratio, pass 0 for the width.
To always use width when keeping aspect ratio, pass 0 for the height.
/rsw <use width: 0 - 32767>
/rsh <use height: 0 - 32767 >
/rsp <percentage>
Resize
/rzka (keep aspect)
Click for information:
To always use height when keeping aspect ratio, pass 0 for the width.
To always use width when keeping aspect ratio, pass 0 for the height.
/rzw <use width: 0 - 32767>
/rzh <use height: 0 - 32767>
/rzp <percentage>
Ripple
/rif <frequency: 1 - 100>
/rih <height: 1 - 100>
/ripa <amplitude>
/ripcx <centerx>
/ripcy <centery>
/ripf <flags>
Click for options:
Exposed areas:
0 = Fill any exposed areas with the fill color. Pass in the RGB format: (0,0,0)
1 = Stretch the image edges to fill the exposed area.
2 = Leave the exposed area as is, without changing it.
/ripp <phase>
/ripatt <attenuation> (0 to 1000)
/ripfc <fill color>Pass in the RGB format: (0,0,0)
/ripfq <frequency>
Rotate
/rta <angle: -360 to 360>
/rtf <flags>
Click for options:
1 = Standard Resize
2 = Resample
3 = Bicublic Resample
Saturation
/sap <percentage: -1000 - 1000>
Sharpen
/shp <percentage: -1000 - 1000>
Shear
/sa <shear angle: -360 to 360 degrees>
/seh (enable horizontal)
/sbc <shear background color> Note: Specify color settings in RGB using comma delimiters. For example: 0,0,0
Shift and Difference
/sadf <filter>
Click for options:
26 = Diagonal
27 = Horizontal
28 = Vertical
Smooth
/sml <length:>
/smf <flags>
Click for options:
2 = Single Region
4 = Internal Region
16 = Unchanged Image
256 = Favor Long
278 = All Flags
Sobel Filter
/sobf <filter>
Click for options:
22 = Horizontal
23 = Vertical
Solarize
/sothresh <threshold: 0 - 255>
Spherize
/sphv <value>
/sphcx <centerX>
/sphcy <centerY>
/sphfc <fill color> Pass in the RGB format: (0,0,0)
/sphf <flags> Flag settings can accept multiple options by using a bit wise value (|) to specify one flag from each group.
Click for options:
Exposed areas:
0 = Fill any exposed areas with the fill color. Pass in the RGB format: (0,0,0)
1 = Stretch the image edges to fill the exposed area.
2 = Leave the exposed area as is, without changing it.
Exposed areas inside the sphere:
0 - Rotate the image inside the sphere pattern.
16 - Fill the exposed sphere pattern center as you would exposed
Swirl
/swa <angle>
/swcx <centerX>
/swcy <centerY>
Underlay
/ulf <flags>
Click for options:
Unsharp Mask
/usma <amount>
/usmr <radius>
/usmt <threshold>
Wave
/wavv <amplitude>
/wavl <wave length>
Click for options:
0 - The value in Wave Length is a wavelength given as a percent of the image dimensions. If this value is set, the valid range of Wave Length is from 0 to 100.
1 - The value in Wave Length is the frequency, or the number of times the wave repeats.
/wava <wave angle>
/wavhs <wave horizontal scale>
/wavvs <wave vertical scale>
/wavfc <wave fill color> Pass in the RGB format: (0,0,0)
/wavf <wave flags> Flag settings can accept multiple options by using a bit wise value (|) to specify one flag from each group.
Click for options:
Flags for exposed areas:
0 = Fill any exposed areas with the fill color. Pass in the RGB format: (0,0,0)
1 = Stretch the image edges to fill the exposed area.
2 = Leave the exposed area as is, without changing it.
Modes:
0 - The wave is a sinusoidal wave.
256 - The wave is a sinusoidal wave shifted by 90 degrees.
512 - The wave is a square wave.
768 - The wave is a triangular wave.
Wave Shear
/wavss <scale>
/wavsfc <fill color> Pass in the RGB format: (0,0,0)
/wavsf <flags> Flag settings can accept multiple options by using a bit wise value (|) to specify one flag from each group.
Click for options:
Directions:
0 = Horizontal
1 = Vertical
Flags for exposed areas:
0 = Fill any exposed areas with the fill color.
1 = Stretch the image edges to fill the exposed area.
2 = Leave the exposed area as is, without changing it.
Wind
/winv <value> (1 to 100)
/wina <angle>
/wino <opacity> (0 to 100)
Zoom Blur
/zbv <value>
/zbs <stress>
/zbcx <centerX>
/zbcy <centerY>
Zoom Wave
/zwa <amplitude>
/zwcx <centerX>
/zwcy <centerY>
/zwfq <frequency>
/zwp <phase>
/zwzf <zoom factor>
/zwfc <fill color> Pass in the RGB format: (0,0,0)
/zwf <flags> Flag settings can accept multiple options by using a bit wise value (|) to specify one flag from each group.
Click for options:
These flags are for exposed areas.
Options:
0 = Fill any exposed areas with the fill color.
1 = Stretch the image edges to fill the exposed area.
2 = Leave the exposed area as is, without changing it.
Examples
To use the processing options from a command line, type the name of the option followed by the appropriate switches for that processing option, as in the following examples.
Tip
To: Convert two images to bitmaps and store
the result in the same directory.
Use: AutoImager /c bmp /f c:\images\image1.jpg,c:\images\image2.jpg /u
To: Convert file named Test.jpg to
GIF in quiet mode using the source path for output.
Use: AutoImager /f test.jpg /c gif /q /u
To: Resize Desktop.bmp to 640x480 and set the output to c:\windows.
Use: AutoImager /f desktop.bmp /p resize /rzw 640 /rzh 480 /op c:\windows
To: Invert an image, resize it, and save to a specific location:
Use: Autoimager.exe /f c:\Test.jpg /p invert,resize /rzw 240 /rzh 200 /op c:\OutputFiles\
To perform more than one process or conversion at a time, you must create a batch file. The following is
an example of a batch file that converts all images in the Images directory to
JPG and writes the files to a directory call Thumbs. After this, the process
resizes the new images to 100x100 while maintaining the aspect ratio and setting
the JPG quality to 90%.
AutoImager /f C:\Images\*.* /c jpg /op C:\Thumbs
Autoimager /f C\Thumbs\*.jpg /p Resample /rska /rsw 100 /rsh 100 /oq 90 /os
Type the above two lines in any text program and save the file as <filename>.bat.
You can then double-click this file in the Windows Explorer to run it.
Related Topics