Flags and values

This section describes the flags and values for the pdf2afp and ps2afp transforms:
-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 | FS45.ovly | FS45.pseg | IOCA | IOCA10 | IOCA45 | NONE}
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. It is the default specified in the ps2afpd daemon and ps2afp command configuration files.
Note: The InfoPrint 3816 printer does not support printing with an image type of IO1_G4. For this printer, specify an image type of IO1_MMR because it is the compressed image type supported by this printer. This will result in faster printing than uncompressed image types.

PPDS, PCL, and TCP/IP-attached IPDS printers can print IOCA images.

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, you might want to use the -p flag to select which page is to be made into a page segment; otherwise, multiple page segments will be 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, you might want to use the -p flag to select which page is to be made into an overlay; otherwise, multiple overlays will be 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.
IOCA
IOCA image. This value can only be used with Adobe PDF Print Engine.
IOCA10
IOCA FS10 image. This value can only be used with Adobe PDF Print Engine.
IOCA45
IOCA FS45 image. This value can only be used with Adobe PDF Print Engine.
NONE
Produces no output. Completely process input datastream, but does not generate any actual AFP from resulting pages. This value can only be used with Adobe PDF Print Engine.

This flag is similar to the image-out-format document attribute on the pdpr command.

-cmrpathsearchPath[,searchPath...] [-cmrpathsearchPath[,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, InfoPrint will concatenate these search orders.
    Note:
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).
-C ConfigurationFile
Specifies the path and file name of the customized configuration file InfoPrint uses with the transform. If you specify the -C flag with an AIX print command (enq, lp, or qprt), or with the lprafp command, specify the fully qualified name of the file, including its path; for example:
With AIX or Linux
/usr/lpp/psf/ps2afp/myfile.cfg
With Windows
install_path\ps2afp\myfile.cfg
-c
Concatenates multiple input files without putting a Ctrl-D (end of job) character between the files. The ps2afp command interprets the input files as a continuous data stream, and processes them as if they were one PostScript or PDF job. This flag can be useful when processing PostScript with inline resources. (See Examples). This flag only applies to the ps2afp command.
    Note:
  • Do not use this flag when you perform the data stream transform by submitting a print job with the pdpr command.
  • This parameter is not supported with Adobe PDF Print Engine (APPE) and Artifex GhostPDL (AGSPDL).
-cmp {jpeg-sub | jpeg | lzw| g4 | mmr | none}
Enables JPEG or LZW compression.

Values are:

-cmp jpeg-sub
This value is used for JPEG compression and subsampled files. This is the default value.
-cmp jpeg
This value is used for JPEG compression and unsubsampled files.
-cmp lzw
This value is used for LZW compression and unsubsampled files.
-cmp g4
Compressed Image Object Content Architecture (IOCA). This value can only be used with Adobe PDF Print Engine and Black and White.
-cmp mmr
Compressed IOCA image in Modified Modified Read (MMR). This value can only be used with Adobe PDF Print Engine and Black and White.
-cmp none
No compression. This value can only be used with Adobe PDF Print Engine and Black and White.
    Note:
  • The compression algorithm should be used when the output is IOCA objects and when the color path (FS45) is selected.
In case of transparency masks type objects, this flag is ignored. The transparency masks type objects use the G4 MMR algorithm, which is the default compression type. This default compression is used even if another compression parameter is specified.

-device “[plex], [inputn=(size[,type=x,color=y,weight=z]) inputn=...]”
Specifies whether to recognize plex mapping, and optionally, 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, InfoPrint recognizes plex mappings with no additional information for the tray contents.

Note: You can specify [inputn=... as many times as you need to.

If only input1 is specified, the width (-w) and length (-l) values must match the size of the media specified for input1. For example:

ps2afp test.ps -o test.afp -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:
ps2afp test.ps -o test.afp -w 8.5i -l 11i -device 'plex, 
input1=(letter), input2=(a4)'
    Note:
  • This setting is not necessary with PDF input and Adobe PDF Print Engine as the transformer.
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).

-devmodelmodel
Specifies the device model of the actual device.
    Note:
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).
-devtypetype
Specifies the device type of the actual device.
    Note:
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).
-FFontMapFile[,FontMapFile...]
Specifies the path and file name ps2afp uses for the font mapping file. This file correlates PostScript font names with their file locations. A font mapping file must exist on the system where the ps2afpd and apped daemons are running (specified by the -S flag).

You can include multiple values in the -F flag by separating each value with a comma (,). The values will be concatenated. When you specify multiple -F flags, ps2afp concatenates them from left-to-right (first entered to last entered) in that order.

For CPSI, the -F value overrides the ps_font_map_files value in the ps2afp configuration file and the ps2afpd configuration file. If you do not specify -F, ps2afp uses the font mapping file specified in the ps2afp command or ps2afpd daemon configuration file. By default, the CPSI ps2afpd daemon configuration file specifies the font mapping file as follows:

For AIX or Linux
/usr/lpp/psf/ps/psfonts.map
For Windows
install_path\ps\fonts.map

For APPE, the -F value overrides the appe_font_map_files value in the ps2afp configuration file and the ps2afpd configuration file. If you do not specify -F, ps2afp uses the font mapping file specified in the ps2afp command or apped daemon configuration file. By default, the APPE apped daemon configuration file specifies the font mapping file as follows:

For AIX or Linux
/usr/lpp/psf/appe/fontmaps/FontMapSample.cfg
For Windows
install_path\appe\fontmaps\FontMapSample.cfg

If you specify -F without a file name, or if the file does not exist, the ps2afp command does not work.

    Note:
  • PostScript or PDF processing is slower when you use the -F flag. You can improve performance by changing the value in the daemon configuration file rather than using -F on a regular basis.
  • Specify the fully qualified name of the file if you specify the -F flag with an AIX print command.
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).

-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 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 internal mapping table has been optimized for the 600-pel InfoPrint 4000 laser printer. You shouldn't change this unless you know what you are doing. See also options -alg and -thresh. PostScript code submitted using the -thresh option can have the same effect as -gcorr.
    Note:
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).
-gPageRange
Specifies that the output should only contain selected pages. When you specify multiple -g flags, the ps2afp command transforms only the specified pages in the PostScript or PDF input data stream, 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 should 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.
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).

-icmrcolorResourceName[,colorResourceName...] [-icmrcolorResourceName[,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
    Note:
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).
.
-inline {yes | no}
Specifies whether the output Color Management Resource (CMR) will be placed inline with the data stream. If you specify two or more -inline flags on a transform command line, InfoPrint will use the last specified value.
    Note:
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).
InputFile ...
Specifies one or more input files to be transformed. If you specify more than one input file name, the ps2afp command concatenates the files and separates them with the Ctrl-D (end of job) character. The results of the transform are written to a single output file (if one is specified) or to standard output.

In addition, you can specify PostScript inline resource files as input files to the ps2afp command. The file name of the inline resource file must precede the file name of the PostScript or PDF print file so that ps2afp concatenates the files in the correct order.

If you do not specify an input file, ps2afp uses standard input. If the ps2afp command cannot read from standard input, ps2afp issues a message.

When using a StdIN input file with the ps2afp or pdf2afp transform, you must identify the datatype for the input file as shown in these examples:

ps2afp -datatype ps -<tiger.ps> testtigr.afp
or
pdf2afp -datatype pdf -<lion.pdf> testlion.afp
    Note:
  • Adobe PDF Print Engine does not support multiple input files in a single job.
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).

-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, InfoPrint will use the last specified value.
    Note:
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).
-j {20 | 1to9998 | 9999}
Specifies the maximum amount of time, in minutes, to spend processing the job.

Values are:

20
20 minutes, the default
1 to 9998
The timer ranges from 1 to 9998 minutes, in one-minute increments
9999
No time limit

Note: This parameter is not supported with Adobe PDF Print Engine (APPE) and Artifex GhostPDL (AGSPDL).

-imgsmall sizeunnnn.nnnu
This defines the size limit for images; 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), ps2afp uses pels as the unit type. You cannot specify fractional values (that is, you cannot use a decimal point) for pels.

The smaller of the width and height of the intersection of the image area and the current clipping path will be compared against the value given.

For 240-pel resolution printers, values are:

0.5 to 5i
1 inches, the default
120 to 1200
The length can be from 120 pels to 1200 pels, 0.5i to 5i, or 12.7m to 127m.

For 300-pel resolution printers, values are:

0.5 to 5i
1 inches, the default
150 to 1500
The length can be from 150 pels to 1500 pels, 0.5i to 5i, or 12.7m to 127m.

For 480-pel resolution printers, values are:

0.5 to 5i
1 inches, the default
240 to 2400
The length can be from 240 pels to 2400 pels, 0.5i to 5i, or 12.7m to 127m.

For 600-pel resolution printers, values are:

0.5 to 5i
1 inches, the default
300 to 3000
The length can be from 300 pels to 3000 pels, 0.5i to 5i, or 12.7m to 127m.

For 720-pel resolution printers, values are:

0.5 to 5i
1 inches, the default
360 to 3600
The length can be from 360 pels to 3600 pels, 0.5i to 5i, or 12.7m to 127m.

For 1200-pel resolution printers, values are:

0.5 to 5i
1 inches, the default
600 to 6000
The length can be from 600 pels to 6000 pels, 0.5i to 5i, or 12.7m to 127m.

Note: This parameter is not supported with Adobe PDF Print Engine (APPE) and Artifex GhostPDL (AGSPDL).

-is {1 | 3}
Specifies the interchange set version.

Values are:

1
If you specify 1, the output is IS/1 compliant. This is the default value.
3
If you specify 3, the output is IS/3 compliant.
    Note:
  1. Any other value different than 1 or 3 is signaled as error.
  2. If you specify 3 as a value for the -is flag, make sure that the output type selected is one of the following: IO1, IO1_G4, IO1_MMR, PSEG_IO1, PSEG_IO1_G4, PSEG_IO1_MMR, OVLY_IO1, OVLY_IO1_G4, OVLY_IO1_MMR, FS45. Only these output types are compatible with the IS/3 flag.

-lnnnn.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), ps2afp 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 12720
The length can be from 16 pels to 12720 pels, 0.065i to 53i, or 1.641m to 1346.2m. For example, these values 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 15900
The length can be from 16 pels to 15900 pels, 0.052i to 53i, or 1.313m to 1346.2m. For example, these values 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 25440
The length can be from 16 pels to 25440 pels, 0.065i to 53i, or 1.641m to 1346.2m. For example, these values 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 31800
The length can be from 16 pels to 31800 pels, 0.052i to 53i, or 1.313m to 1346.2m. For example, these values are all valid:
-l 40m
-l 200.5m
-l 13i
-l 10000

This flag is equivalent to the image-length document attribute on the pdpr command.

-linesmall sizeunnnn.nnnu
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), ps2afp uses pels as the unit type.

For all PostScript variations of the fill operator and shfill, InfoPrint Manager switches to a single cell halftone when the smaller of the bounding box of the object is small and to all variations of stroke when the current line width is small.

For 240-pel resolution printers, values are:

0.5 to 5i
1 inches, the default
120 to 1200
The length can be from 120 pels to 1200 pels, 0.5i to 5i, or 12.7m to 127m.

For 300-pel resolution printers, values are:

0.5 to 5i
1 inches, the default
150 to 1500
The length can be from 150 pels to 1500 pels, 0.5i to 5i, or 12.7m to 127m.

For 480-pel resolution printers, values are:

0.5 to 5i
1 inches, the default
240 to 2400
The length can be from 240 pels to 2400 pels, 0.5i to 5i, or 12.7m to 127m.

For 600-pel resolution printers, values are:

0.5 to 5i
1 inches, the default
300 to 3000
The length can be from 300 pels to 3000 pels, 0.5i to 5i, or 12.7m to 127m.

For 720-pel resolution printers, values are:

0.5 to 5i
1 inches, the default
360 to 3600
The length can be from 360 pels to 3600 pels, 0.5i to 5i, or 12.7m to 127m.

For 1200-pel resolution printers, values are:

0.5 to 5i
1 inches, the default
600 to 6000
The length can be from 600 pels to 6000 pels, 0.5i to 5i, or 12.7m to 127m.

Note: This parameter is not supported with Adobe PDF Print Engine (APPE) and Artifex GhostPDL (AGSPDL).

-M {96000 | 11000tonnnnnn}
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 a lot of memory.

Values are:

96000
96000KB (96MB)
11000 tonnnnnn
The maximum memory ranges from 11000 to nnnnnn (where nnnnnn is the maximum upper limit allowed by AIX or Linux) up to 999MB. 96000 is the default.
Note: This parameter is not supported with Adobe PDF Print Engine (APPE) and Artifex GhostPDL (AGSPDL).

-ocmrcolorResourceName
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, InfoPrint 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
InfoPrint will use the specified -ocmr value to tag the output AFP as an input (audit) Color Management Resource (CMR).
passthru
InfoPrint 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, InfoPrint will use the last specified value.
    Note:
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).
-oOutputFile
Specifies the output path and file into which the transformed files are to be written. If more than one output file is specified, the last specified file name and path is the one used. If no output file is specified, the result is written to standard output. Output from the ps2afp and pdf2afp transform contains binary encoded data that is not recognized by standard output devices such as an IBM AIX or Linux terminal session or a Microsoft Windows Command Prompt Window. For these standard output devices if an output file name is not specified, standard output should be redirected. For more information about redirecting output using either the greater than symbol (>) or the pipe symbol (|), see your operating system help or reference.

You cannot use -oOutputFile on the command line with the enq, lp, qprt, or lprafp commands. You can only use -oOutputFile with the ps2afp command. You can also specify the transform-output-file-name document attribute on the pdpr command.

-P {8251 | 924 tonnnnn}
Specifies the TCP/IP port number ps2afp uses to make a connection with the workstation on which the ps2afpd daemon is running (set by the -S flag). If your InfoPrint installation uses more than one PostScript daemon, use this flag to select the daemon.

This port should not be the same port used by the TCP/IP-attached IPDS printer or the PCL transform. To find out which ports are already being used on your system (although they might or might not be active), look in the /etc/services file.

Values are:

8251
The default port number.
924 tonnnnn
Any valid port number greater than or equal to 924. The maximum value, nnnnn, depends on AIX or Linux, but it must be equal to or less than 65535.

Note: You can only access secure ports, 924 to 1023, with root user authority.
-pPageRange
Specifies that the output should only contain selected pages. When you specify multiple -p flags, the ps2afp command transforms all the pages in the input, then extracts the specified MO:DCA-P pages and prints them in normal numerical order, regardless of the order you specify.

You cannot specify both the -g flag and the -p flag.

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.

-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.

    Note:
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).
-pdfproc [agspdl| appe | cpsi]
Used with the ps2afp and pdf2afp transform processing engines.

Values are:

-pdfproc agspdl
The transform uses the AGSPDL transformer processing engine.
-pdfproc cpsi
The transform uses the CPSI transformer processing engine.
-pdfproc appe
The transform uses the APPE transformer processing engine.
    Note:
  • This parameter can only be used with PDF files.

-psproc [agspdl | cpsi]
Used with the ps2afp transform processing engines.

Values are:

-psproc agspdl
The transform uses the AGSPDL transformer processing engine.
-psproc cpsi
The transform uses the CPSI transformer processing engine.
    Note:
  • This parameter can only be used with PostScript files.

-psc {ArtBox | BleedBox | CropBox | TrimBox}
Used with the pdf2afp transform processing engines to aid the positioning of content on the requested media in accordance with the intention of the PDF file creator.

Values are:

ArtBox
Specifies the ArtBox for the PDF file.
BleedBox
Specifies the BleedBox for the PDF file.
CropBox
Specifies the CropBox for the PDF file.
TrimBox
Specifies the TrimBox for the PDF file.
    Note:
  • This parameter can only be used with PDF files and the AGSPDL transformer processing engine.

-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.
  • This pragma can only be used with the APPE transformer processing engine.
-pragma ERRORONMISSINGFONT
To ensure font fidelity, make sure that you embed all required fonts in your PDF print file. If a required font is not embedded, and cannot be located on the system, the print request will fail. This is the default action.

    Note:
  • This pragma can only be used with the APPE transformer processing engine.

-pragma IMAGECOMPRESSIONTYPE={0 | 1| 2}
Enables JPEG or 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.
    Note:
  • The compression algorithm should be used when the output is IOCA objects and when the color path (FS45) is selected.

    In case of transparency masks type objects, this flag is ignored. The transparency masks type objects use the G4 MMR algorithm, which is the default compression type. This default compression is used even if another compression parameter is specified.

  • This pragma can only be used with the CPSI transformer processing engine.

-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), ps2afp 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.

    Note:
  • This pragma can only be used with the CPSI transformer processing engine.

-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), ps2afp 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.

    Note:
  • This pragma can only be used with the CPSI transformer processing engine.

-pragma OutputFaceUp {PS | enable | disable}
Enhances the finishing processing support by offering OutputFaceUp following option:
PS
Where Output Face Up processing is controlled by PostScript. This is the default value
Enable
In this case the Face Up option is active at all times. This is useful for PostScript files that do not specify any Output Face Up processing, and for PDF files that cannot specify Output Face Up processing.
Disable
Disables the output Face Up processing.

    Note:
  • This pragma can only be used with the CPSI transformer processing engine.

-pragma USEDEFAULTFONTFORSUBSTITUTION
The rip uses the default font (CourierStd) as a substitute font for any missing font in the customer document. This font does not generate a correct document for viewing or printing, but it can be used to generate output (allow Proof level output). This pragma refers to an alternative mechanism. For any specific job, one of them is enabled.

The rules for this pragma are:

  • IF "Use Font Emulation" is ENABLED, then "Use Default Font For Substitution" is DISABLED
  • IF "Use Default Font For Substitution" is ENABLED, then "Use Font Emulation" is DISABLED

    Note:
  • This pragma can only be used with the CPSI transformer processing engine.

-pragma USEFONTEMULATION
The APPE transform attempts to locate and use available fonts to emulate based on font characteristics. It analyzes the unavailable font's style and character set comparing them to elements in the existing transform dictionary to select an appropriate font. This pragma refers to an alternative mechanism.
  • Textual fonts use font emulation.
  • Emulation can only occur when an appropriate font can be located and substituted successfully.
  • For symbolic fonts, APPE renders each symbol as a bullet or blank space.

The rules for this pragma are:

  • IF "Use Font Emulation" is ENABLED, then "Use Default Font For Substitution" is DISABLED
  • IF "Use Default Font For Substitution" is ENABLED, then "Use Font Emulation" is DISABLED
    Note:
  • This pragma can only be used with the APPE transformer processing engine.
-q
Quiets (suppresses) the echoing of the ps2afp command to the display.
-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 will be printing the image.

Values are:

240
240 pels-per-inch
300
300 pels-per-inch 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 4100 printers)
720
720 pels-per-inch (for example, InfoPrint 5000 printers)
1200
1200 pels-per-inch (for example, InfoPrint Pro C900AFP printers)

This flag is equivalent to the default-printer-resolution document attribute on the pdpr command.

Note: If you specify a resolution that the printer does not support, InfoPrint will print the image under most conditions, but with degraded results. Specify the correct resolution for the printer on which you will print the job.
-S ServerName
Specifies the name of the AIX or Linux system on which the ps2afpd daemon is running. If you do not specify this flag, the ServerName defaults to the effective name of the workstation on which you issued the ps2afp command. The value is:
ServerName
A hostname, IPv4 or IPv6 address for any valid AIX or Linux system where the ps2afpd daemon is running.
-s {20 | 1to9998 | 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. If the PostScript interpreter goes down, you do not need to bring it back up; the interpreter automatically starts when you submit another PostScript or PDF job as long as the ps2afpd daemon is running.

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.

Note: This parameter is not supported with Adobe PDF Print Engine (APPE) and Artifex GhostPDL (AGSPDL).

-thresh FileName
Specifies a file that contains a PostScript Type 1 or Type 3 halftone dictionary. 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.
    Note:
  • This parameter is not supported with Artifex GhostPDL (AGSPDL).
-threshsmall {sc_ell | sc_euc }
This defines the extension part of the single cell file name to be constructed. The extension can be either sc_ell or sc_euc.

This will cause finding a single cell matching the super cell halftone file (specified using the -thresh option) by picking up the printer, frequency, and rotation from the latter and constructing a file name for the former using this information.

Values are:

sc_ell
sc_euc

Note: This parameter is not supported with Adobe PDF Print Engine (APPE) and Artifex GhostPDL (AGSPDL).

-txtsmall sizeu nnnn.nnnu
This defines the size limit for text; nnnn.nnn is a number that can optionally contain a decimal point, and u is the units in inches (i) or millimeters (m) or points (p). If you do not specify a unit (i or m or p), ps2afp uses pels as the unit type. You cannot specify fractional values (that is, you cannot use a decimal point) for pels.

The smaller of the width and height of the point size will be compared against the value given.

For 240-pel resolution printers, values are:

36 to 360 p
72 points, the default
120 to 1200
The length can be from 120 pels to 1200 pels, 0.5i to 5i, or 12.7m to 127m.

For 300-pel resolution printers, values are:

36 to 360 p
72 points, the default
150 to 1500
The length can be from 150 pels to 1500 pels, 0.5i to 5i, or 12.7m to 127m.

For 480-pel resolution printers, values are:

36 to 360 p
72 points, the default
240 to 2400
The length can be from 240 pels to 2400 pels, 0.5i to 5i, or 12.7m to 127m.

For 600-pel resolution printers, values are:

36 to 360 p
72 points, the default
300 to 3000
The length can be from 300 pels to 3000 pels, 0.5i to 5i, or 12.7m to 127m.

For 720-pel resolution printers, values are:

36 to 360 p
72 points, the default
360 to 3600
The length can be from 360 pels to 3600 pels, 0.5i to 5i, or 12.7m to 127m.

For 1200-pel resolution printers, values are:

36 to 360 p
72 points, the default
600 to 6000
The length can be from 600 pels to 6000 pels, 0.5i to 5i, or 12.7m to 127m.

Note: This parameter is not supported with Adobe PDF Print Engine (APPE) and Artifex GhostPDL (AGSPDL).

-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) or millimeters (m). If you do not specify a unit (i or m), then ps2afp 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 8160
The width can be from 16 pels to 8160 pels, 0.065i to 34i, or 1.641m to 863.628m. For example, these values are all valid:
-w 40m
-w 200.5m
-w 13i
-w 3300

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 values 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 values are all valid:
-w 40m
-w 200.5m
-w 13i
-w 5000

This flag is equivalent to the image-width document attribute on the pdpr command.

-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), ps2afp 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.

This flag is equivalent to the x-image-shift document attribute on the pdpr command.

    Note:
  1. The X offset specified with -x must be less than the width specified with -w. If the -x value is greater than or equal to the -w value, a blank page is printed.
  2. 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, a blank page will also result because the margins on the left and right sides of the paper exceed the width of the paper.
  3. PostScript or PDF processing is slower when you use the -x flag, because the ps2afpd daemon must stop and re-start the PostScript interpreter. You can improve performance by changing the ps_x_offset value in the ps2afpd daemon configuration file rather than using -x on a regular basis.

-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), ps2afp 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.

This flag is equivalent to the y-image-shift document attribute on the pdpr command.

    Note:
  1. The Y offset specified with -y must be less than the length specified with -l. If the -y value is greater than or equal to the -l value, a blank page is printed.
  2. 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, a blank page will also result because the margins on the top and bottom of the paper exceed the length of the paper.
  3. PostScript or PDF processing is slower when you use the -y flag, because the ps2afpd daemon must stop and re-start the PostScript interpreter. You can improve performance by changing the ps_y_offset value in the ps2afpd daemon configuration file rather than using -y on a regular basis.

-h | -?
Displays the pdf2afp or ps2afp help file.