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 | 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.
- -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.
- 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
orpdf2afp -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.
- 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:
- Any other value different than 1 or 3 is signaled as error.
- 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 issmall
.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.
- 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.
- 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.
- -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.
- 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.
- -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.
- 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:
- 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.
- 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.
- 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:
- 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.
- 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.
- 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.