Flags and values

-a {IO1_G4 | IO1_MMR | PSEG_IO1_G4 | PSEG_IM1 | PSEG_IO1 | IM1 | IO1 | PSEG_IO1_MMR | OVLY_IO1_G4 | OVLY_IM1 | OVLY_IO1 | OVLY_IO1_MMR | FS45.xxx | IOCA | IOCA10 | IOCA45 | FS45 | NONE}
    Note:
  • The old -a values still work, but we recommend that you use:
    • -a to specify the type of image output (like IOCA10, IOCA45).
    • -cmp to specify the type of compression (like G4, JPEG-SUB).
    • -pagetype to specify type of AFP generated (like DOCUMENT, OVERLAY).
Determines the type of AFP data stream image to generate for each page in the 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.
IM1
IM1 image. This type of image is not compressed.
IO1
IOCA image. This type of image is not compressed.
IOCA
IOCA image.
IOCA10
IOCA FS10 image.
IOCA45
IOCA FS45 image.
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, you must use the -p flag to select which page is made into a page segment.
OVLY_IO1_G4 | OVLY_IM1 | OVLY_IO1 | OVLY_IO1_MMR
Overlay of the specified image type.
    Note:
  • When generating overlays from multiple-page documents, you MUST use the -p flag to select which page is made into an overlay.
FS45
IOCA color format.
FS45
IOCA color format for pages.
FS45.ovly
IOCA color format for overlays.
FS45.pseg
IOCA color format for page segments.
FS45.pg
IOCA color format for pages (no BDT/EDT).
FS45.im
IOCA color format for image only output.
NONE
Produce no output.

Processes input datastreams but does not generate any AFP from resulting pages.

-cmp {MMR | G4 | JPEG | JPEG-SUB | LZW | NONE}
Choice of the output image compression algorithm:
G4
Compressed Image Object Content Architecture (IOCA).
MMR
Compressed IOCA image in Modified Modified Read (MMR) format.
JPEG
Unsubsampled JPEG images.
JPEG-SUB
SubSampled JPEG images.
lzw
LZW-compressed, unsubsampled images.
NONE
No compression.
    Note:
  • LZW, JPEG, and JPEG-SUB compression is not supported for black and white output.
  • G4 and MMR compression is supported only for FS10 output.
-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 APPE transform concatenates these search orders.
-devmodel model
Specify the device model of the actual device.
-devtype type
Specify the device type of the actual device.
-g PageRange
Specifies that the output must only contain selected pages. When you specify multiple -g flags, the PDF to AFP transforms the specified pages in the 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.
-g 1 -g 3 -g 6
Output pages 1, 3, and 6, in that order.
-g1 -g6 -g3
Output pages 1, 3, and 6, in that order.
    Note:
  • You cannot specify both the -g flag and the -p flag.
-gcorr FileName
Specifies a file with gray scale mapping table for halftoning of the gray scale 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:
  • 256 real numbers, one for each level of gray in the 8-bit gray scale image.
The algorithm converts every image to 8-bit gray scale before applying the halftoning algorithm. The default internal mapping table has been optimized for the 600-pel InfoPrint 4000 laser printer. Do not change this unless you know what you are doing. See also option -thresh.
-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) are 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.
-is {1 | 3}
Specifies the interchange set version.
Values are:
1
The output is IS/1 compliant. This is the default value.
3
The output is IS/3 compliant.
    Note:
  • When you specify -a IM1, the -is3 flag is ignored.
-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), millimeters (m), or resolution-independent points (p). If you do not specify a unit (i, m, or p), PDF to AFP uses resolution-dependent pels as the unit type. You cannot specify fractional values (that is, you cannot use a decimal point) for pels or points.
    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 792p
-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

-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 are 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 PDF 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.
-p 1 -p 3 -p 6
Output pages 1, 3, and 6, in that order.
-p1 -p6 -p3
Output pages 1, 3, and 6, in that order.

You cannot specify both the -g flag and the -p flag.
You can use -p when the PDF to AFP transform is processing one file at a time. This flag is ignored if you specify multiple files within the same job.
-pagetype {IM | OBJECT | PG | PAGE | OVERLAY | OVLY | PSEG | DOCUMENT}
Determines the type of AFP structured fields to generate for each individual page in the PDF file.
Values are:
PAGE
Output pages (no BDT/EDT).
PG
Output pages (no BDT/EDT).
OVLY
Output overlay.
OVERLAY
Output overlay.
OBJECT
Output image object.
IM
Output image object.
PSEG
Output page segment.
DOCUMENT
Output document.
-pragma CMYKCUSTOM= {CMYK | DeviceCMYK | ICCCMYK | RGB | DeviceRGB | ICCRGB | Gray | DeviceGray | ICCGray | ICCBased},{Text | LineArt | Text LineArt | All},source_color=(c=n.n,m=n.n,y=n.n,k=n.n),replacement_color=(c=n.n,m=n.n,y=n.n,k=n.n)
Replaces a color from the Text and Line Art objects in the PDF file.
Values are:
CMYK
The CMYK color space
DeviceCMYK
A device-dependent CMYK color space.
ICCCMYK
An ICC-based CMYK color space.
RGB
The RGB color space.
DeviceRGB
A device-dependent RGB color space.
ICCRGB
An ICC-based RGB color space.
Gray
The Gray color space.
DeviceGray
A device-dependent Gray color space.
ICCBased
An ICC-based Gray color space.
Text
Text objects.
LineArt
Line art objects.
Text LineArt
Text and line art objects
All
All text and line art objects.
source_color
The source color to be replaced. The n.n is a number that contains a decimal point. The allowed values are between 0.0 and 1.0, where 0.0 represents 0% and 1.0 represents 100%.
replacement_color
The color that replaces the source color. The n.n is a number that contains a decimal point. The allowed values are between 0.0 and 1.0, where 0.0 represents 0% and 1.0 represents 100%.
    Note:
  • For color type image output, you must use the -a flag with FS45 value.
-pragma ERRORONMISSINGFONT
Displays an error message when a text or symbolic font is missing and the job fails.
-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), PDF 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), PDF 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 USEFONTEMULATION
Determines the characteristics of the requested font, when the font is not embedded in the PDF, to find a similar font.
-pragma USEDEFAULTFONTFORSUBSTITUTION
The CourierStd font replaces any missing text and symbolic font.
    Note:
  • If the CourierStd font does not support a requested character, a blank space or a dot is used.
-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 print the image.
Values are:
240
240 pels-per-inch (for example, InfoPrint 3812, 3825, 3827, 3835, and 3900 printers).
300
300 pels-per-inch (for example, InfoPrint 4019, 4028, 4029, and 4039 printers and Hewlett-Packard printers), the default.
360
360 pels-per-inch (for example, InfoPrint 5000 printers).
480
480 pels-per inch.
600
600 pels-per-inch (for example, InfoPrint 3900 printers).
720
720 pels-per-inch (for example, InfoPrint 5000 printers).
1200
1200 pels-per-inch (for example, InfoPrint Pro C900AFP printers).
-thresh FileName
Specifies a FileName that contains a PDF Type 1 or Type 3 halftone dictionary. Alternatively, the PDF 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 PDF code contains a transfer function, either in the halftone dictionary or specified by the settransfer operator, the current grayscale correction curve is overwritten. Just as if -gcorr were used.
-w nnnn.nnnu
Specifies the width of the generated image. nnnn.nnn is a number that can optionally contain a decimal point, and u is the units in inches (i), millimeters (m), or resolution-independent points (p). If you do not specify a unit (i, m, or p), PDF to AFP uses resolution-dependent pels as the unit type. You cannot specify fractional values (that is, you cannot use a decimal point) for pels or points.
    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, 16p to 2448p, 0.052i to 34i, or 1.313m to 863.628m. For example, these are all valid:
-w 612p
-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), PDF 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 value specified here can be no greater than half of the value specified on the -w flag. For example, if you specified -w=12i, this value can be no greater than 6i.
    Note:
  • The X offset specified with -x must be less than half the width specified with -w. If the -x value is greater than or equal to half the -w value, a blank page is printed.
  • The X-offset value specifies margins on both the left and right sides of the page. If you have a width of 8.5 inches and specify an X offset of 5 inches, the result is a blank page. This is because the margins on the left and right sides of the paper exceed the width of the paper.
-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), PDF 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 value specified here can be no greater than half of the value specified on the -l flag. For example, if you specified -l=16i, this value can be no greater than 8i.
    Note:
  • The Y offset specified with -y must be less than half the length specified with -l. If the -y value is greater than or equal to half the -l value, a blank page is printed.
  • The Y offset value specifies margins on both the top and bottom edges of the page. If you have a length of 11 inches and specify an Y offset of 6 inches, the result is a blank page. This is because the margins on the top and bottom of the paper exceed the length of the paper.