Flags and values

-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}
Determines the type of AFP data stream image to generate for each page in the PostScript or PDF file.
Values are:
IO1_G4
Compressed Image Object Content Architecture (IOCA) image in Modified TSS (formerly CCITT) T.6 G4 Facsimile Coding Scheme (G4 MMR) format. This is the recommended output type because it takes up less space on the fixed disk, and it prints faster.
    Note:
  • The 3812 and 3816 printers do not support printing with an image type of IO1_G4. For these printers, specify an image type of IO1_MMR because it is the compressed image type supported by these printers. This results in faster printing than uncompressed image types.
PPDS, PCL, and TCP/IP-attached IPDS printers can print IOCA images. However, only channel-attached printers that have the Advanced Function Image and Graphics (AFIG) feature installed can print IOCA images. Therefore, if you are printing images on channel-attached printers without the AFIG feature, select the IM1 value.
IM1
IM1 image. This type of image is not compressed.
IO1
IOCA image. This type of image is not compressed.
IO1_MMR
Compressed IOCA image in Modified Modified Read (MMR) format.
{PSEG_IO1_G4 | PSEG_IM1 | PSEG_IO1 | PSEG_IO1_MMR}
Page segment of the specified image type.
    Note:
  • When generating page segments from multiple-page documents, use the -p flag to select which page is made into a page segment. Otherwise, multiple page segments are created, one for each page of PostScript or PDF.
{OVLY_IO1_G4 | OVLY_IM1 | OVLY_IO1 | OVLY_IO1_MMR}
Overlay of the specified image type.
    Note:
  • When generating overlays from multiple-page documents, use the -p flag to select which page is made into an overlay. Otherwise, multiple overlays are created, one for each page of PostScript or PDF.
FS45
IOCA color format.
FS45.ovly
IOCA color format for overlays.
FS45.pseg
IOCA color format for page segments.
-cmp {lzw | jpeg | jpeg-sub}
Enables JPEG images and LZW compression.
Values are:
jpeg-sub
This value is used for JPEG compression and subsampled files. This is the default value.
jpeg
This value is used for JPEG compression and unsubsampled files.
lzw
This value is used for LZW compression and unsubsampled files.
-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 concatenates these search orders.
-device "plex,inputn=(size,type=x,color=y,weight=z)[,inputn]"
The plex value specifies whether the transform recognizes or honors the plex commands in the data stream. Optionally, it also specifies how to associate the AFP input tray (inputn) with the contents of the output bin. When you specify inputn, you must specify size, where size is a text string like letter, legal, a3, a4, b4, b5, ledger, or a dimension like 8.5ix11i. Dimensions can be specified as inches (i), millimeters (m), or points (p). The other three input descriptors (type, color, and weight) are optional, but when you specify them, you must separate them with a comma and no spaces.
When you do not specify inputn=...) with plex, plex commands with no additional information for the tray contents are recognized.
You can specify [inputn=... as many times as needed.
The number (n) you specify with input is the AFP input bin to be selected when the print description language tray selection characteristics are met.
If you do not specify plex, the plex commands in the data stream are ignored.
If only input1 is specified, the width (-w) and length (-l) values must match the size of the media specified for input1. For example: 
-w 210m -l 297m -device 'plex,input1=(a4)'
If more than one input is specified, the -w and -l values must match one of the inputn size specifications. For example: 
-w 8.5i -l 11i -device 'plex,input1=(letter),input2=(a4)'
-devmodel model
Specify the device model of the actual device.
-devtype type
Specify the device type of the actual device.
-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.
-g PageRange
Specifies that the output must only contain selected pages. When you specify multiple -g flags, the PostScript to AFP transforms only the specified pages in the PostScript or PDF input data stream. It then prints the transformed pages in normal numerical order, regardless of the order you specify. Examples of values include:
-g even
Output even pages.
-g odd
Output odd pages.
-g 1-10
Output pages 1 through 10.
-g 10-
Output pages from page 10 until the end of the job.
Only specify the -g flag when the input data conforms to Adobe Document Structuring Conventions (DSC). If you have any doubt about the input data, use the -p flag.
You cannot specify both the -g flag and the -p flag.
You can use -g when the PostScript to AFP transform is processing one file at a time. This flag is ignored if you specify multiple files within the same job.
-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 concatenates the resources together. If two or more resources specified by the -icmr flags are for the same color space, InfoPrint uses the last specified resource.
-inline {yes | no}
Specifies whether the output Color Management Resource (CMR) is placed inline in the data stream. If you specify two or more -inline flags on a transform command line, the transform uses the last specified value.
-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 uses the last specified value.
-is3
Specifies that the transform produces IS/3 compliant datastreams.
-l nnnn.nnnu
Specifies the length of the generated image. nnnn.nnn is a number that can optionally contain a decimal point and u is the units in inches (i) or millimeters (m). If you do not specify a unit (i or m), PostScript to AFP uses pels as the unit type. You cannot specify fractional values (that is, you cannot use a decimal point) for pels.
    Note:
  • If a text margin is already built into the file, try -l11i to set the length to 11 inches.
For 240-pel resolution printers, values are:
11i
11 inches, the default
16 to 8160
The length can be from 16 pels to 8160 pels, 0.065i to 34i, or 1.641m to 863.6m. For example, these are all valid: 
-l 40m
-l 200.5m
-l 13i
-l 4000
For 300-pel resolution printers, values are:
11i
11 inches, the default
16 to 10200
The length can be from 16 pels to 10200 pels, 0.052i to 34i, or 1.313m to 863.6m. For example, these are all valid: 
-l 40m
-l 200.5m
-l 13i
-l 5000
For 480-pel resolution printers, values are:
11i
11 inches, the default
16 to 16320
The length can be from 16 pels to 16320 pels, 0.065i to 34i or 1.641m to 863.6m. For example, these are all valid: 
-l 40m
-l 200.5m
-l 13i
-l 8000
For 600-pel resolution printers, values are:
11i
11 inches, the default
16 to 20400
The length can be from 16 pels to 20400 pels, 0.052i to 34i, or 1.313m to 863.6m. For example, these are all valid: 
-l 40m
-l 200.5m
-l 13i
-l 10000
-M {15000 | 11000 to nnnnnn}
Determines the maximum amount of memory, in KB, that the transform can use. This flag can be useful if you are processing large PostScript or PDF jobs that require much memory.

Values are:

15000
15000KB (15MB)
11000 to nnnnnn
The maximum memory ranges from 11000 to nnnnnn (where nnnnnn is the maximum upper limit the operating system allows) up to 999MB. 15000 is the default.

-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 uses the last specified value.
-otag {none | normal | passthru}
Specifies how the output AFP is tagged with color information. The allowed values are:
none
There is no tagging in the output AFP.
normal
The transform uses the specified -ocmr value to tag the output AFP as an input (audit) Color Management Resource (CMR).
passthru
The transform uses 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 uses the last specified value.
-p PageRange
Specifies that the output must only contain selected pages. When you specify multiple -p flags, the PostScript to AFP transforms all the pages in the input. It then extracts the specified MO:DCA-P pages and prints them in normal numerical order, regardless of the order you specify.
Examples of values include:
-p even
Output even pages.
-p odd
Output odd pages.
-p 1-10
Output pages 1 through 10.
-p 10-
Output pages from page 10 until the end of the job.
You cannot specify both the -g flag and the -p flag.
You can use -p when the PostScript to AFP transform is processing one file at a time. This flag is ignored if you specify multiple files within the same job.
-pragma IMAGECOMPRESSIONTYPE = {0 | 1 | 2}
Enables JPEG images and LZW compression.
Values are:
0
This value is used for JPEG compression and subsampled files. This is the default value.
1
This value is used for JPEG compression and unsubsampled files.
2
This value is used for LZW compression and unsubsampled files.
-pragma ps_x_origin = nnnn.nnnu
Specifies an X presentation page origin of the generated image. nnnn.nnnu is a number that can optionally contain a decimal point and u is the units in inches (i) or millimeters (m). If you do not specify a unit (i or m), PostScript to AFP uses pels as the unit type. You cannot specify fractional values (that is, you cannot use a decimal point) for pels. If this value is unspecified, zero is presumed.
-pragma ps_y_origin = nnnn.nnnu
Specifies an Y presentation page origin of the generated image. nnnn.nnnu is a number that can optionally contain a decimal point and u is the units in inches (i) or millimeters (m). If you do not specify a unit (i or m), PostScript to AFP uses pels as the unit type. You cannot specify fractional values, that is, you cannot use a decimal point, for pels. If this value is unspecified, zero is presumed.
-pragma AFPDSRECORDLENGTH = nnnnn
Use nnnnn to specify the maximum number of bytes in a record. For example, -pragma AFPDSRECORDLENGTH=8000 limits the record length to 8K.
The default is 32000, and the value range is 8000 to 32000.
-r {240 | 300 | 360 | 480 | 600 | 720 | 1200}
Specifies the resolution of the output image. Select the resolution based on the printer on which you are printing the image.
Values are:
240
240 pels-per-inch (for example, 3812, 3825, 3827, 3835, and 3900 printers).
300
300 pels-per-inch (for example, 4019, 4028, 4029, and 4039 printers and Hewlett-Packard printers).
360
360 pels-per-inch (for example, InfoPrint 5000 printers).
480
480 pels-per-inch
600
600 pels-per-inch (for example, InfoPrint 4100 printers), the default.
720
720 pels-per-inch (for example, InfoPrint 5000 printers).
1200
1200 pels-per-inch (for example, InfoPrint 5000 printers).
-s {20 | 1 to 9998 | 9999}
Specifies the maximum amount of time, in minutes, that the PostScript interpreter remains idle between jobs before it goes down. When the PostScript interpreter is running, it uses some of the workstation memory.
Values are:
20
The default time is 20 minutes.
1 to 9998
The time is the number of minutes specified in one-minute increments.
9999
There is no time limit.
-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.
-w nnnn.nnnu
Specifies the width of the generated image. nnnn.nnnu is a number that can optionally contain a decimal point and u is the units in inches (i) or millimeters (m). If you do not specify a unit (i or m), PostScript to AFP uses pels as the unit type. You cannot specify fractional values (that is, you cannot use a decimal point) for pels.
    Note:
  • If a text margin is already built into the file, try -w8.5i to set the width to 8.5 inches.
For 240-pel resolution printers, values are:
8.5i
8.5 inches, the default
16 to 10200
The width can be from 16 pels to 10200 pels, 0.052i to 34i, or 1.313m to 863.628m. For example, these are all valid: 
-w 40m
-w 200.5m
-w 13i
-w 5000
For 300-pel resolution printers, values are:
8.5i
8.5 inches, the default
16 to 10200
The width can be from 16 pels to 10200 pels, 0.052i to 34i, or 1.313m to 863.628m. For example, these are all valid: 
-w 40m
-w 200.5m
-w 13i
-w 5000
For 600-pel resolution printers, values are:
8.5i
8.5 inches, the default
16 to 20400
The width can be from 16 pels to 20400 pels, 0.052i to 34i, or 1.313m to 863.628m. For example, these are all valid: 
-w 40m
-w 200.5m
-w 13i
-w 5000
-x nnnn.nnnu
Specifies an X offset (horizontal offset) of the generated image. nnnn.nnn is a number that can optionally contain a decimal point and u is the units in inches (i) or millimeters (m). If you do not specify a unit (i or m), PostScript to AFP uses pels as the unit type. You cannot specify fractional values (that is, you cannot use a decimal point) for pels.
An offset value specifies a border or margin around the generated image to avoid the non-printable areas of some printers. An X-offset value specifies the left and right margins of the generated image.
Values are:
0
No border is specified. This is the default.
0 to 17i
The X offset must be less than half of the width (-w) of the generated image. For example, if you specified -w=12i, this value can be no greater than 6i.
-y nnnn.nnnu
Specifies a Y offset (vertical offset) of the generated image. nnnn.nnn is a number that can optionally contain a decimal point and u is the units in inches (i) or millimeters (m). If you do not specify a unit (i or m), PostScript to AFP uses pels as the unit type. You cannot specify fractional values (that is, you cannot use a decimal point) for pels.
An offset value specifies a border or margin around the generated image to avoid the non-printable areas of some printers. A Y-offset value specifies the top and bottom margins of the generated image.
Values are:
0
No border is specified. This is the default.
0 to 17i
The Y offset must be less than half of the length (-l) of the generated image. For example, if you specified -l=16i, this value can be no greater than 8i.
Parent topic: Transform PDF or PostScript data to AFP