Flags and values

{ -a {ioca | ioca10 | ioca11 | im1 | ioca42 | ioca45} -a {IO1_G4 | IM1 | IO1 | IO1_MMR | PSEG_IO1_G4 | PSEG_IM1 | PSEG_IO1 | PSEG_IO1_MMR | OVLY_IO1_G4 | OVLY_IM1 | OVLY_IO1 | OVLY_IO1_MMR | FS45 | FS42 | FS10 | FS11}}
  • Choice of the output image type. The first syntax chooses between the IOCA FS 10 (ioca, ioca10), IOCA FS11 (ioca11), IM1, IOCA FS42 (ioca42), and IOCA FS45 (ioca45) output. IOCA FS10 and IM1 yield bi-level images, while IOCA FS11 results in 4-bit or 8-bit gray or 24-bit color output (see option -outbits). Currently, the only product that supports IOCA FS11 is AFP Workbench. IOCA FS42 can contain either bi-level or 4-bit banded CMYK image at 1-bit per band. IOCA FS45 is a superset of FS42 that also contains 32-bit banded CMYK images, compressed with either JPEG or LZW algorithms. The output compression algorithm is set with the -cmp option. To set the page type (page, overlay, page segment, or object), use the -pagetype option. FS45 produces IOCA FS45 output.
  • The second syntax is to maintain compatibility with the PostScript to AFP transform, and sets the image type (IO1 for IOCA FS10 or IM1 for IM1 output), compression (G4 for Group 4 or MMR for Group 3), and page type (PSEG for page segment or OVLY for overlay). If you do not specify PSEG or OVLY, the output is a printable page. If you do not specify a compression algorithm, the output is not compressed. You cannot use the second syntax for IOCA FS11 output.
  • Some older printers do not support IOCA images. In such cases, you should choose the IM1 output type. IM1 images are uncompressed, and thus, use more space. The processing might also take longer since the IM1 image cannot be scaled by the printer, so internal scaling algorithms must be used. See option -alg.
  • The default is ioca for IOCA FS10 output compressed using Group 4 algorithm.

-is3
  • Specifies that the transform produce IS/3 compliant datastreams.

{ -alg {afp | alg1 | alg2 | alg3} -alg {htod1 | htfs} -alg htcal1}
  • Choice of the scaling and halftoning algorithms. You can specify multiple choices, separated by commas, for one -alg option. The effect is the same as specifying multiple -alg options. For example, -alg htfs,htcal is equivalent to -alg htfs -alg htcal.
  • The scaling algorithms are:
    • If afp is chosen, the scaling is done using the default algorithm in the printer. This makes the transform run much faster. If the image must be reduced, however, this algorithm might drop some information from the image, such as thin lines.
    • alg1 activates the internal scaling algorithm to scale the image explicitly to the specified size. This algorithm is guaranteed not to discard any ink. “White space” in the image, however, might be lost (that is, features close to one another might merge). This algorithm makes the transform run longer, and might occasionally make for a “dirty” image, since the occasional “noise pixels” in the scanned images tend to be amplified.
    • alg2 activates the more flexible version of alg1. If this algorithm is selected, option -clean can be used to specify the amount of ink “cleanup” to be done. Option -clean 0.0 makes the algorithm alg2 perform like alg1 (although more slowly). Increasing the value specified in -clean discards more and more ink, until -clean 1.0 results in a blank page.
    • alg3 activates a scaling algorithm that works by deleting or duplicating rows and columns in the image. This is a fast general-purpose algorithm.
  • For bi-level images, the default is afp if the output image type is IOCA and alg3 if the output image type is IM1. For color images with bi-level output, the scaling is always done before the halftoning algorithm. If a grayscale or color output is chosen (-a ioca11), this option is ignored and the algorithm is set to afp.
  • The halftoning algorithms are:
    • htod1 uses an ordered dither with a screen derived from the value of the -thresh option. The default is an 85 line per inch screen.
    • htfs uses the Floyd-Steinberg algorithm.
    • htcal1 recalibrates the halftoning algorithm for each image. htcal1 forces the transform to read the whole image into memory and requires an additional pass through the image. Use it only for very light or very dark images.
  • The default is htod1. Each halftoning algorithm uses a different internal default calibration curve. If the automatic calibration is turned on, a different set of calibration curves is used.
  • See options -clean, -gcorr, -ink, -paper, -scale, -thresh, -l, -w, -x, and -y.

 -choice {full | reduced | both}
  • TIFF image files can contain both full and reduced resolution versions of each image. the transform can output both versions, or full resolution only, or reduced resolution only, depending on the value for this option. The default is to output the full resolution images only.
  • See the -mp and -nomp options.

 -clean {0.5 | x.xxx}
  • The internal scaling algorithm alg2 allows for variable thresholding. The scaled pixel is declared painted if the fraction of its area greater than the threshold is painted in the original image. The value x.xxx is a real number between zero and 1 inclusive and gives this threshold.
  • If the option -clean 0.0 is issued, alg2 behaves like alg1 and turns on a pixel as long as any part of the pixel has been painted in the original image. -clean 1.0 results in a blank image because the output pixels are never painted.
  • The setting -clean 0.95 and 0.9999999 turns on the pixels that had essentially all the area painted in the original picture. Depending on the data, most of the image will probably be preserved. Increasing -clean by a small amount to 1.0 erases the image. If the scaling algorithm is not alg2, this option is ignored. The default is -clean 0.5.

 -cmp {g4 | none | mh | mmr | g3 | jpeg | lzw}
  • Choice of the output image compression algorithm:
    none
    Uncompressed output
    mh
    ITU-T T.4 G3 Modified Huffman
    mmr
    infoprint® Modified Modified Read
    g3
    ITU-T T.4 G3 Modified Read
    g4
    ITU-T T.6 G4
    jpeg
    JPEG non-differential Huffman coding with baseline DCT. The output image data should be compressed to reduce the file sizes and increase the printing speed.
    lzw
    If lzw is specified, linework of 600 dpi is produced; otherwise, lossy JPEG at 300 dpi is produced. lzw only applies to FS45.

    The default compression is ITU-T T.6 Group 4 for bi-level images and no compression for gray scale or color images. Some printers might not support Group 4 compression algorithm and require using the -cmp option to choose a different one. The JPEG algorithm can compress only 8-bit gray scale and 24-bit color images. 4-bit grayscale images cannot be compressed.

-cmrpath searchPath , searchPath
  • Specifies the search order for locating color resources. This search order is a series of directory paths that color resources are located in. If you specify two or more -cmrpath flags, the transform will concatenate these search orders.

 -crop t , b , l , r {d | i | m | p}
  • Image cropping. t,b,l,r specify how much should be cropped from the image top, bottom, left edge, and right edge. The numbers are floating point and can be either positive or negative. Negative numbers indicate that a blank space should be inserted. The units are inches, millimeters, points, and dots (pels). The default is dots. The cropping is specified in the context of the output page, so that “top” means the top of the output page and so on, regardless of the -rot option. To crop, the transform enlarges the image by the amount to be cropped, then crops the specified amount by manipulating the actual bitmap. The resulting image has the size as specified by the explicit (or implicit) -scale option. See also option -j.
  • If -fit trim is specified, the right and the bottom edge of the image are not cropped. Instead, the image grows as necessary. Because -fit trim causes the output data stream to contain the “position and trim” specification, the printer discards any extra image.

-devmodel model
  • Specify the device model of the actual device.

-devtype type
  • Specify the device type of the actual device.

 -fit {trim | scale}

Determines whether the printer behavior will be position-and-trim or scale-to-fit if the image is too large to fit on the paper. The default is trim.

 -force

If present, this option forces TIFF to AFP to decompress and recompress the image, regardless of other factors.

 -gcorr FileName
  • Specifies a FileName with a gray scale mapping table for halftoning of the gray scale and color images to bi-level for output. The FileName you specify can be a fully qualified filename. If you do not specify a path, the transform looks in /opt/infoprint/itm/hn/resources/common/color on the Linux workstation.
  • The mapping table must be provided to compensate for the printing characteristics of the particular output device and paper type, such as dot gain. This file must contain either:
    • 256 real numbers, one for each level of gray in the 8-bit gray scale image
    • The PostScript settransfer operator
  • The algorithm converts every image to 8-bit gray scale before applying the halftoning algorithm. The default might not produce the halftone image quality that your printer is capable of. Mapping tables for several different engine types and line screens are supplied with the transform and are installed in /opt/infoprint/itm/hn/resources/common/color on the Linux workstation. To tune your image quality, select the file that matches your printer model. See also options -alg and -thresh. PostScript code submitted using the -thresh option can have the same effect as -gcorr.

-icmr colorResourceName , colorResourceName
  • Specifies one or more input or audit color resources. The color resources can be either ICC Profiles or Color Management Resources (CMRs). If you specify two or more -icmr flags on a transform command line, InfoPrint will concatenate the resources together. If two or more resources that are specified by the -icmr flags are for the same color space, InfoPrint will use the last specified resource.

-inline {yes | no}
  • Specifies whether the output Color Management Resource (CMR) will be placed inline in the data stream. If you specify two or more -inline flags on a transform command line, the transform will use the last specified value.

 -ink {white | black}
  • You only use this option with scaling algorithm alg1 or alg2. The TIFF images can be either black on white or white on black. The internal scaling algorithm must know which, because “ink” is preserved at the expense of “non-ink”. The default value, “black”, indicates that the image is black on white.
  • If you use the -inv option to print the reversed image, the inversion is done as the data is read by the transform, before any processing is done. The black or white must thus be specified in the terms of the printed image, not in the terms of the input TIFF image.

-intent {relative | perceptual | saturation | absolute}
  • Specifies the rendering intent. You can also use the -pragma option to specify the rendering intent by setting:
    -pragma colorRendering=relative
    If you specify two or more -intent flags on a transform command line, the transform will use the last specified value.

 -inv

Reverses the image. Areas that are black in the original image become white and vice versa. The reversed image might be either black on white or white on black, depending on the original image.

 -l {11i yyy.yy {d | m | i | p}}

Specifies the paper length. The optional units are dots (pels), millimeters, inches, or points. The default unit is dots. If the unit is dots, decimals (if any) are ignored. The default paper length is 11 inches. See options -w to set the paper width or -paper to set both dimensions at the same time.

 -lut LookupTable { , rgb | lab | cmyk}
  • Specifies the FileName for the color conversion lookup table file. The FileName you specify can be a fully qualified filename. If you do not specify a path, the transform looks in /opt/infoprint/itm/hn/resources/common/color on the Linux workstation.
  • Fast and accurate conversion between color spaces can be implemented as a multidimensional lookup with an interpolation algorithm for missing nodes. The file specified with the -lut option must contain a valid lookup table for the conversion between the input and output color spaces. The lookup tables currently come in either ASCII (.lut) or binary formats (.lutbin).

    If the optional colorspace tag is not provided, the table is assumed to match the input image. If there is a serious mismatch between the table and the image (for example, the table is RGB to CMYK and the input image is CMYK), the -lut is ignored for the image. Otherwise, it is used to convert the colors and any mismatch (for example, using a lab table for rgb data) results in corrupted output.

    If the colorspace tag is provided, the transform uses the lookup table only for the relevant colorspace image. Multiple lut tables can be specified if you are unsure about the input colorspace. If the lut files are binary, parsing extra files does not slow performance much.

    Example:

    -lut 3170-005.rgb.cmyk.perceptual.lutbin,rgb

    Where 3170-005 is the model-type; rgb.cmyk is for RGB images; and perceptual is the color-rendering-intent value.

 -M {0 | nnn}

Limits the amount of memory available to TIFF to AFP. nnn is the maximum amount of memory in kilobytes. A value of 0 means there is no memory limit. nnn can be set from 0 to the maximum value that the operating system allows. The default is 0.

{ -mp |  -nomp}

Each TIFF image is supposed to have a marker bit set if there are multiple TIFF images in the file. This marker is sometimes missing, even if there are multiple images present in the file. The -mp option instructs the transform to behave as if the multipage marker bit were set. the transform then processes all the images in the file, subject to the -p and -choice options. The default is to leave the marker bit unset (-nomp).

-nomp
See -mp.
-nosniff
See -sniff.
-nov
See -v.

{ -ocmr colorResourceName}
  • Specifies an output color resource. The color resource can be either an ICC Profile or a Color Management Resource (CMR). If you specify two or more -ocmr flags on a transform command line, the transform will use the last specified value.

{ -otag {none | normal | passthru}}
  • Specifies how the output AFP will be tagged with color information. The allowed values are:
    none
    There will be no tagging in the output AFP.
    normal
    The transform will use the specified -ocmr value to tag the output AFP as an input (audit) Color Management Resource (CMR).
    passthru
    The transform will use the specified -ocmr value to tag the output AFP as both an input (audit) CMR and an output (instruction) CMR.
    If you specify two or more -otag flags on a transform command line, the transform will use the last specified value.

 -outbits NumberOfOutputBits

Sets the number of bits per pel in output. This value must be 1, 4, 8, or 24. If the output image type is IOCA FS10 or IM1, the number of output bits is set to 1 and this option is ignored. For IOCA FS11 output, the default is 24. This number represents the maximum number of bits used per pel. Thus, even if the number of bits is set to 24, a 4-bit gray scale image is still displayed in 4-bit format.

 -outcolor {ycbcr | rgb | ycrcb}

Sets the output color model to RGB, YCbCr, or YCrCb if the image type is IOCA FS11 and the number of output bits is 24. Otherwise, this option is ignored. The default is ycbcr.

 -p {even | odd | nn | nn-mm | nn- }
  • Specifies that the output should only contain the specified pages. If no -p option is given, all the pages are output (but see the -choice option for printing full or reduced resolution images of each page). Multiple -p options can be specified. Their effect is cumulative. Regardless of the order in which the pages are specified, they are always printed in ascending order.
  • The recognized values are:
    even
    Print all even pages
    odd
    Print all odd pages
    nn
    Print page nn
    nn-mm
    Print pages nn to mm, inclusive
    nn-
    Print all pages starting with page nn
  • Pages are numbered starting with 1.

 -pagetype {page | overlay | ovly | pseg | object}

Sets the output page type to be page, overlay, page segment, or object. The same page type is set for every page in the output. Thus, unless you use the -p option to select a single page, multiple page segments or overlays are stored in the output file. The default is page. See option -a.

 -paper {letter | a5 | a4 | a3 | folio | legal | ledger xxx.xx , yyy.yy {d | m | i | p}}
  • Specifies the output paper size. The supported values are:
    a3
    A3 format (297 by 420 mm or 11.69 by 16.54 inches)
    a4
    A4 format (210 by 297 mm or 8.27 by 11.69 inches)
    a5
    A5 format (148 by 210 mm or 5.83 by 8.27 inches)
    letter
    8.5 by 11 inches (216 by 279 mm)
    folio
    8.5 by 13.0 inches (216 by 330 mm)
    legal
    8.5 by 14.0 inches (216 by 356 mm)
    ledger
    11.0 by 17.0 inches (279 by 432 mm)
    xxx.xx,yyy.yy
    Horizontal and vertical image dimensions. The optional units are dots (pels), millimeters, inches, or points.
  • The default paper size is letter. If -paper is not used, the paper size is increased, if necessary, to contain the output image.
  • See options -l, -w, and -scale.

 -r {600 | 300 | nnn}

The output device resolution, specified in dots per inch. The default is 600.

 -rot {0 | 90 | 180 | 270} {p | i}
  • The image is rotated in the clockwise direction by the amount specified. The default is zero (that is, no rotation).

  • If p is specified, the transform sets the output data stream so that the printer does the actual image rotation. If i is specified, the transform rotates the output bitmap. When i is chosen, the transform takes much longer to run and uses much more memory. If no letter is specified, the default or any previous value remains in force.
  • The default is p.

 -scale {orig | a5 | a4 | a3 | letter | folio | legal | ledger xxx.xx , yyy.yy {d | m | i | p} | xxx%}
  • Specifies the output image size. The image is scaled to this size and centered in the area defined by the paper size and margin options. The supported values are:
    orig
    Preserve the input image size, regardless of the printable paper area
    a3
    A3 format (297 by 420 mm or 11.69 by 16.54 inches)
    a4
    A4 format (210 by 297 mm or 8.27 by 11.69 inches)
    a5
    A5 format (148 by 210 mm or 5.83 by 8.27 inches)
    letter
    8.5 by 11 inches (216 by 279 mm)
    folio
    8.5 by 13.0 inches (216 by 330 mm)
    legal
    8.5 by 14.0 inches (216 by 356 mm)
    ledger
    11.0 by 17.0 inches (279 by 432 mm)
    xxx.xx,yyy.yy
    Horizontal and vertical image dimensions. The optional units are dots (pels), millimeters, inches, or points.
    xxx%
    Magnification relative to the original image size. Numbers below 100% mean reduction, while numbers above 100% mean enlargement. For example, -scale 200% causes the output image to be twice as long and twice as wide as the input image.
  • The default image size is orig.

{ -nosniff |  -sniff}
  • Turns automatic conversion to black on white for bi-level images on (-sniff) or off (-nosniff). The automatic conversion algorithm counts the number of 0 and 1 bits in the image. If there are fewer zeros, it assumes the printed features are represented by zeros (white on black), and inverts the image to be black on white. The detection and conversion are done after the conversion specified by the Photometric Interpretation tag is applied (if any).
  • This option is ignored if the image is not bi-level.
  • The default is -nosniff.

 -thresh FileName
  • Specifies a FileName that contains a PostScript Type 1 or Type 3 halftone dictionary. The FileName you specify can be a fully qualified filename. If you do not specify a path, the transform looks in /opt/infoprint/itm/hn/resources/common/color on the Linux workstation.
  • Halftone dictionaries for several different engine types and line screens are supplied with the transform and are installed in /opt/infoprint/itm/hn/resources/common/color on the Linux workstation. To tune your image quality, select the file that matches your printer model.
  • Alternatively, the PostScript code can specify the setscreen operator instead of a Type 1 dictionary. The halftone cell in the dictionary is used to overwrite the default ordered dither clustered dot halftone cell. If the PostScript code contains a transfer function, either in the halftone dictionary or specified by the settransfer operator, the current grayscale correction curve is overwritten as if -gcorr were used.

{ -nov |  -v}
  • Turns verbose mode on (-v) or off (-nov).
    • When verbose mode is on, the transform prints a message as it opens each resource file, then echoes the command line, then prints a message for each file name as it is processed.
    • When verbose mode is off, the transform prints only error messages.

    The default is -nov.

 -w {8.5i yyy.yy {d | m | i | p}}

Specifies the paper width. The optional units are dots (pels), millimeters, inches, or points. The default unit is dots. The default page width is 8.5 inches. See options -l to set the paper length or -paper to set both dimensions at the same time.

 -x {0 nnn.nn {d | m | i | p}}

Specifies the left margin. The optional units are dots (pels), millimeters, inches, or points. The default unit is dots. The default is zero (no margin).

 -y {0 nnn.nn {d | m | i | p}}

Specifies the top margin. The optional units are dots (pels), millimeters, inches, or points. The default unit is dots. The default is zero (no margin).

 
Copyright © 2004, 2013