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).
- The old -a values still work, but we recommend that you use:
- 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.
- When you specify
- -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.
- -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.