Options and values

This section describes the options and values for the img2afp transform:
-a { fs10|fs45| ioca10|ioca45}
Choice of the output image type. For bi-level output, the input images are converted to grayscale, halftoned (see -gcorr, -lut, and -thresh for more information), and merged into a single image. For FS45 output, the objects of like type are merged depending on the -maxobj command. To set the page type (that is page, overlay, page segment, or object), the -pagetype option can be used.

The default is FS45.

-CConfigurationFileName
The name of a configuration file containing option-value pairs. If multiple -C options are given on the command line, they are processed in order..

If this option is not specified, the default configuration file /usr/lpp/psf/img2afp/img2afp.cfg for InfoPrint Manager for AIX or InfoPrint Manager for Linux.

-e{1|2}[,cycle[,switch]]
Engine calibration switch. If two calibration files have been specified with the -gcorr option, the -e option defines the algorithm for deciding which engine is used for which image. The first entry denotes the engine that is used to print the first image. The optional cycle entry specifies how many consecutive pages to print and the same engine and defaults to 1. The optional switch entry specifies the number of the page where the engine assignment switches and which prints on a different engine than it would otherwise (this feature is used for printing booklets). For example, -e 1,1 would cause the images to be halftones for engines 1 2 1 2 1 2 1 2 1 2; áe 1,1,3 would result in 1 2 2 1 2 1 2; and áe 1,4 would result in 1 1 1 1 2 2 2 2 1 1 1 1.

If the -gcorr option specifies only a single grayscale calibration curve, this option is ignored. If the áe option is missing, all images are halftoned using the first calibration curve specified with ágcorr, even if -gcorr specifies multiple curves.

-errtrace
Causes the transform to output a full error trace in addition to the regular error message. This trace should be communicated to IBM support personnel to assist them in diagnosing the problem.
-gcorrGrayscaleMappingTable[,GrayscaleMappingTable]
Specifies files with grayscale mapping tables for halftoning of the grayscale and color images to bi-level for output. 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 PostScript code specifying a transfer option, including the settransfer command can also be specified.

The algorithm converts every CMYK image to 8-bit grayscale before applying the halftoning algorithm.

If two files have been specified, img2afp uses each file to represent a engine calibration in a two-engine printer. In that case, the -e option is used to define the rules for switching between the calibration curves. See the -lut and -thresh options for more information.

Halftoning is very device-specific. Omitting the -gcorr option produces output that is probably unacceptable in quality. The calibration curves specified with -gcorr impact only the bi-level output. Therefore, this option is only meaningful for FS10 output.

-lutLookupTable file[,rgb|lab|cmyk]
Specifies the filename for the color conversion lookup table file. You can use this file to specify the conversion between the CMYK color found in the FS45 data and the K-only data that is needed to halftone the output. If this option is not specified, img2afp uses an internal 9x9x9x9 LUT. This option is only meaningful for FS10 output.
-maxobj [ct],[lw],[bw]
Governs the maximum number of output objects per scanline for continuous tone (ct), linework (lw), and bi-level (bw). The output is guaranteed to have no more than the number of objects specified, but can have fewer, depending on the input data. The numbers given must be greater than zero. If any value is omitted, the current value used by the transform remains unchanged. This option applies only to FS45 output. For FS10 output, a single object is built. The default is 2,2,2.
-no5a
By default, img2afp separates output MO:DCA records with the 0x5A byte separator. This option changes the behavior, so no separators are inserted.
Note: The output separator presence is unrelated to the presence of the separator in the input file.
-nomerge
By default, img2afp merges any inline image resources into the output pages. This option prevents merging, so the resources will remain separate.
-oOutputFile
Optional output file name. Specify "-" for standard output. The default is standard output.
-pagetype {page|overlayovly|pseg|object|pass}
Specifies the output page type as page, overlay, page segment, or object. When the input contains multiple pages, the overlays, page segments, or objects are stored in the output file. Pages are always enclosed in a document that begins with a BDT and ends with an EDT. Use pass to signify that the input objects should remain unchanged. The default is pass.
-routput resolution
Specifies the output data stream resolution. The default is 600.
-respathdirectory[:directory…]
Specifies the search path for resource files, such as the threshold grayscale calibration curve files. If a resource file name is specified as a relative name (does not start with a /), the transform searches every directory in the path, in the order specified in the path, until it finds the file (or fails). See options -lut, -thresh, and -gcorr for lookup table, halftone threshold array, and grayscale calibration curve. The default is the current directory.
-rot {0|90|180|270}[i|p|v][, {e|o}]
Specifies the output rotation. The specification has three parts: amount to rotate, who performs the rotation, and what does the rotation apply to. The output can be rotated in increments of 90 degrees. The rotation can be performed in the transform (i) or in the printer (p). There is also virtual rotation, where the page is rotated internally by the specified amount, while the printer rotation is set to the negative of the amount. This in effect pre-rotates the image if the printer does not print in the portrait mode. Examples are 1ûup printing on the continuous forms printers and landscape cutsheet printers, such as the InfoPrint 20. The i and p persist in the sense that a following rotation specification will retain internal/printer context unless it contains another i/p/v specification. The v applies only to the current specification. The final part of the option specifies whether the rotation applies to even pages or odd pages. If this specification is missing, the rotation applies to all pages. Rotation specifications are cumulative. The default is 0p (no rotation, printer, applies to all pages).
-threshFileName
Specifies a file that contains a PostScript Type 3 halftone dictionary. You can use the halftone cell in the dictionary to overwrite the default ordered dither clustered dot halftone cell. Halftoning is very device-specific. Omitting this option produces output that is likely to be of unacceptable quality. The output quality can also be affected adversely if the right calibration curve (specified with -gcorr) is not used. This option is only meaningful for FS10 output.
-v
Turns verbose mode on (-v). img2afp echoes each file name as it is being processed as well as echoing the command line. Verbose is off by default.
-wrkdirWorkDirectoryName
This option specifies which directory to use for work files. If this option is absent or the directory cannot be opened, the transform first tries to use /var/psf/img2afp as the working directory, and if /var/psf/img2afp is absent, the transform uses /tmp.

With AIX or Linux, the work files are never visible to you because the work files are immediately unlinked after creation. Thus, the work file is always deleted when img2afp finishes execution, even if img2afp is killed or otherwise terminates in error.

-infile[infile…]
Specifies one or more optional input files. If no input files are specified, img2afp expects input on the standard input.
Parent topic: img2afp command: transforms image data to AFP