AFP2PDF Plus Transform Options File
a2pxopts.cfg
. When running the transform function with the afp2pdf
client command-line program, the options file must reside in the same directory as
the program module.If running the transform function from the API, you can locate the options file in any directory on the system and you can use any file name. By setting the szOptionsFile option in the structure passed to the transform function, you can specify different option files for different types of documents.
- Note:
- The format of the
a2pxopts.cfg
file has changed. All available options are listed in the file, along with an explanation of each option. Uncomment the option you wish to use and add any required parameters. Where appropriate, you can manually specify multiple options of the same type. See Comparison with AFP2PDF Transform for a comparison list of AFP2PDF vs. AFP2PDF Plus transform options. - Parameters in the options file must be specified on separate lines and have the format
parameter=value
. For example:Disable_Compression=True Auto_Rotate=True
- Variable text should be enclosed in double quotes if the value contains blanks. For
example,
Subject=”Advance Function Presentation”
. - Parameters and values are not case-sensitive.
- Lines starting with a semicolon (;) or a pound (#) character are comments.
- Previous versions of the options file work with AFP2PDF Plus.
The AFP2PDF Plus Transform option parameters are:
- Append_PDF_File=file,n[,”[tm1 tm2 tm3 tm4 tm5 tm6]”]
- Indicates where or how the first page of the specified PDF file is appended to the
generated PDF file, where:
- file
- Specifies the name and location of the PDF file that is to be appended to the generated PDF file.
- n
- Specifies where the PDF is appended or if the PDF is used as a background form or
overlay. Values are:
- 0
- Appended to the beginning of the generated file.
- 1
- Appended to the end of the generated file.
- 2
- Used as a preprinted form on all pages of the generated file.
- 3
- Used as a preprinted form on even pages of the generated file.
- 4
- Used as a preprinted form on odd pages of the generated file.
- 5
- Used as a preprinted form on the first page of the generated file.
- 6
- Used as a preprinted form on all pages of the generated file, except for the first page.
- 7
- Used on top of the content from all pages of the generated file.
- 8
- Used on top of the content from the even pages of the generated file.
- 9
- Used on top of the content from the odd pages of the generated file.
- 10
- Used on top of the content from the first page of the generated file.
- 11
- Used on top of the content from all pages of the generated file, except for the first page.
- tm1 tm2 tm3 tm4 tm5 tm6
- Specifies the linear transformation matrix values that define the origin, rotation,
or scale of the appended PDF file. For example:
1 0 0 1 ox oy
- Specifies origin changes, where:
- ox
- Specifies the distance to translate the horizontal dimension.
- oy
- Specifies the distance to translate the vertical dimension.
sx 0 0 sy 0 0
- Specifies scaling changes, where:
- sx
- Specifies the scale factor (1.0-100%) for the horizontal direction.
- sy
- Specifies the scale factor (1.0-100%) for the vertical direction.
cos θ sin θ –sin θ cos θ 0 0
- Specifies rotation changes by an angle θ counterclockwise.
The origin for this operation is the bottom left-hand corner of the page.
For example,
Append_PDF_File=C:\term.pdf,0
appends thec:\term.pdf
file to the beginning of the generated PDF file, whileAppend_PDF_File=C:\term.pdf,1
appends thec:\term.pdf
file to the end of the generated PDF file. - Append_PDF_File2=file,n[,”[tm1 tm2 tm3 tm4 tm5 tm6]”]
- Indicates where or how the first page of the specified PDF file is appended to the generated PDF file. This parameter is the same as Append_PDF_File except that the origin is the top left-hand corner of the page
- Author=name
- Specifies 1–62 characters for the author name in the Info Dictionary of the output PDF file. This information is displayed to the user if the function is selected in Adobe Acrobat.
- Auto_Rotate=True | False
- Indicates whether the transform determines the orientation of each page and rotates it so that the text appears right-side up. By default, the AFP document is converted as is, so if the AFP page is formatted in a rotated orientation, the output PDF is also rotated. Setting this parameter to True is useful when pages in a document are rotated with different orientations.
- Auto_Rotate_CountBlanks=True | False
- Indicates whether blanks are counted in the auto-rotate algorithm. This parameter is used only with Auto_Rotate=True.
- Auto_Rotate_ParseOverlays=True | False
- Indicates whether page overlays are parsed in the auto-rotate algorithm. This parameter is used only with Auto_Rotate=True.
- Auto_Rotate_UseCharacterRotation=True | False
- Indicates whether character rotation is used along with the text orientation in the auto-rotate algorithm. This parameter is used only with Auto_Rotate=True.
- AVE_Control_File=file
- Specifies the fully qualified name of the AFP Visual Environment control file. This control file contains the names and parameters of the Pipeline Manager filter programs to be run on the AFP before conversion to PDF. See AFP2PDF Plus Transform Options File for information about their use.
- Bookmarks_Csname=font character set name[,font character set name...]
- Specifies that bookmarks are created from strings of text that use the font character sets listed.
- You can include multiple values, but they must be separated by commas. For example,
Bookmarks_Csname="C0FONT01","C0FONT02"
. - When Bookmarks_Csname is specified and a match is found, Show_Pageids is ignored.
- For more information on bookmarks, see the description of Disable_Bookmark_Generation.
- Cache_AFP_Overlay=True | False
- Indicates whether AFP overlays are saved during transformation. The default setting this parameter is True, which can result in a smaller PDF file and a faster conversion.
- Capture_Files_For_Debug=directory
- Specifies the directory where an archive file can be created that contains the captured
job information, such as:
- the input and the output files;
- the debugging log file specified in the AFP2PDF Plus Transform Options FileLogging parameter;
- the contents of the font directory;
- the AFP2PDF Plus options file;
- the contents of the directories specified in the AFP2PDF Plus Transform Options FilePfmPfb_Directory parameter, the AFP2PDF Plus Transform Options FileTrueType_Directory parameter, and the Locale_PathAFP2PDF Plus Transform Options File parameter;
- the files specified in the AFP2PDF Plus Transform Options FileAppend_PDF_File parameter, AFP2PDF Plus Transform Options FileAppend_PDF_File2 parameter, and the AFP2PDF Plus Transform Options FileConcatenate_PDF_File parameter;
- the imagemap file from the
-V
command line parameter or thesetImageMapFile
API;For more information on AFP2PDF Plus Transform APIs, see JAVA Application Programming Interfaces.
- the images specified in the
imagemap
file; - the external form definition from the
-f
command line parameter or thesetFormDef
API; - the external AFP resource group file from the
-r
command line parameter orA2PDocStart2
API; - any AFP resources used in the conversion of the input file.
- In the directory specified on this parameter, a new subdirectory is created for the job, that contains an archive file, both using a name derived from the input file name.
- Certificate=pkcs12_file,pkcs12_password[,cache_directory]
- Specifies the PKCS#12 certificate file used to sign the document, where:
- pkcs12_file
- Specifies the fully qualified path name of the PKCS#12 certificate file.
- pkcs12_password
- Specifies the password needed to read the PKCS#12 file.
- cache_directory
- Specifies the fully qualified path to a directory that is used for certificate storage. This is an optional value that can be used to improve the performance of the conversion.
- Certificate2=pkcs12_file,pwd_file[,cache_directory]
- Specifies the PKCS#12 certificate file used to sign the document.
- pkcs12_file
- Specifies the fully qualified path name of the PKCS#12 certificate file.
- pwd_file
- Specifies the fully qualified path name of a file that contains the password needed to read the PKCS#12 certificate file.
- cache_directory
- Specifies the fully qualified path to a directory that is used for certificate storage. This is an optional value that can be used to improve the performance of the conversion.
- Color=afpname,red,green,blue
- Specifies the RGB value color setting that overrides the display of named color values
in the AFP OCA (graphics objects), where:
- afpname
- Specifies one of the colors defined in AFP: BLUE, BROWN, CYAN, DARKBLUE, DARKCYAN, DARKGREEN, GREEN, GREY, HIGHLIGHT0, HIGHLIGHT1, HIGHLIGHT2, HIGHLIGHT3, MAGENTA, MUSTARD, ORANGE, PURPLE, RED, WHITE, YELLOW.
- red
- green
- blue
- Specifies the RGB value settings in the range of 0 to 255.
- For example, the AFP named color BLUE changes to a light gray color with these values: Color=BLUE, 220, 220, 220.
To override text (PTOCA) named color values, include Modify_Text_Colors. For more information, see the Modify_Text_Colors parameter.
To override bar code objects (BCOCA) named color values, include Modify_BCOCA_Colors. For more information, see the Modify_ BCOCA_Colors parameter.
- Concatenate_PDF_File=file
- Indicates that the entire specified PDF file is appended to the end of the generated
PDF file, where:
- file
- Specifies the name and location of the PDF file that is to be appended to the generated PDF file.
- Convert_Text_CMYK=True | False | Legacy
- Indicates whether all AFP text defined with the CMYK color space are converted to
the RGB color space in the PDF output, when the Preserve_CMYK parameter is not specified or set to false. Valid values for this parameter:
- False: for no conversion.
- True: converts color space values from CMYK to RGB.
- Legacy: uses the CMYK to RGB formula from the legacy AFP2PDF transform.
- See Preserve_CMYK for more information on the APF image conversion to RGB.
- Creator=name
- Specifies 0–62 characters for the creator name in the Info Dictionary of the output
PDF file. This information is displayed to the user if the
- Note:
- If the Creator parameter is included into the options file, but contains an empty value, then the Creator property in the output PDF file is also empty.
- If no Creator parameter is included into the options file, the output PDF document uses the name and the version of the AFP2PDF Plus transform, by default.
function is selected in Adobe Acrobat.
- DASH_PATTERN_style="[on off...] phase"
- When using GOCA lines, adjusts the dash pattern used. The values are:
- style
- Indicates the dash pattern that is used. The values are:
- DASH Specifies a dash pattern ( ------- ).
- DASHDOT Specifies a dash dot pattern ( -.-.-.-. ).
- DASHDOTDOT Specifies a dash dot dot pattern ( -..-..-.. ).
- DBLDOT Specifies a double dot pattern ( .. .. .. .. ).
- DOT Specifies a dot pattern ( ......... ).
- LONGDASH Specifies a long dash pattern ( _ _ _ _ ).
- SOLID Specifies a solid line pattern ( _____ ).
- on
- Specifies the dash pattern length in 1/72 units per inch.
- off
- Specifies the spacing length between the dash pattern.
- phase
- Specifies the distance to start in the dash pattern.
- The on and off values are optional. When used, the pair can be specified multiple times. For example:
- "[] 0" specifies a solid line.
- "[0.2 0.4] 0.4" specifies a dash pattern length of 0.2 units, a spacing length between the dash pattern of 0.4 units, and a start pattern at 0.4 units from the beginning of the pattern.
- "[0.5 1 0.5 2] 0" specifies a dash pattern length of 0.5 units, a spacing length between the dash pattern of 1 unit, a dash pattern length of 0.5 units, a spacing length between the dash pattern of 2 units, and a start pattern at the beginning of the pattern.
- DASH_PATTERN_ENDCAP=[BUTT, ROUND, SQUARE]
- Specifies the mode that is used at the end of the line patterns. The values are:
- BUTT
- Specifies a line that is squared off at the endpoints
- ROUND
- Specifies a line that has semicircular arcs (with a diameter equal to the line width) drawn around the endpoints. This is the default.
- SQUARE
- Specifies a line that is extended beyond the endpoints for half of the line width and then squared off.
- Default_Encryption_Permissions=[Acrobat_functions[ ,n [ ,encryption_functions ]]]
- Sets one or more default encryption permissions to be used when encrypting the PDF
output. The permission codes are:
- Acrobat_functions
-
- a
- Adding or changing annotations or form fields in Acrobat is denied.
- c
- Changing the document in Acrobat is denied.
- p
- Printing the document in Acrobat is denied.
- s
- Selecting and copy text and graphics in Acrobat is denied.
- n
- Specifies the level of encryption:
- 5
- RC4 128-bit encryption
- 6
- AES 128-bit encryption
- 7
- AES 256-bit encryption
- encryption_functions
- You can set one or more of these codes with 128-bit and 256-bit encryption:
- e
- Extracting text and graphics in Acrobat is denied.
- d
- Assembling text and graphics in Acrobat is denied.
- i
- Editing form fields in Acrobat is denied.
- q
- Printing high quality in Acrobat is denied.
- Note:
- Using RC4 128-bit encryption produces a file that can only be opened with Acrobat 5.0 or later.
- Using AES 128-bit encryption produces a file that can only be opened with Acrobat 7.0 or later.
- Using AES 256-bit encryption produces a file that can only be opened with Acrobat 10.0 or later.
- Codes 5, 6, and 7 can be used in combination with one of the a, c, p, or s codes to force 128-bit or 256-bit encryption without setting the i, e, d, or q codes.
- Default_Linearization=True | False
- Indicates whether the PDF output file is linearized (or enabled for Fast Web Viewing).
- See the -m parameter from Parameters for more information about linearization.
- Default_Owner_Password=password
- Specifies a default alphanumeric owner encryption password.
- Default_User_Password=password
- Specifies a default alphanumeric user encryption password.
- Disable_Bookmark_Generation=True | False
- Indicates whether PDF bookmarks are created. If page level indexing information is available in the input AFP document, PDF bookmarks are automatically generated. If you do not want bookmarks created, set this parameter to True.
- Disable_Compression=True | False
- Indicates whether the transform compresses PDF data. Setting this parameter to True to turn off compression can be useful when trying to determine problems that might exist in the PDF output file.
- Disable_TTF_subsetting=True | False
- Indicates whether TrueType fonts are subsetted.
- DotDensity,patternid,afpcolorname=red,green,blue
- Specifies the RGB value color setting for the AFP GOCA pattern that is used to fill
the interior of an area, where:
- patternid
- Specifies the GOCA pattern identifier, which defines various dot fill patterns of varying density. Pattern ID supports values from 1 to 8.
- afpcolorname
- Specifies one of the pattern foreground colors defined in AFP: BLACK, BLUE, BROWN, CYAN, DARKBLUE, DARKGREEN, DARKTURQUOISE, DEFAULT, GREEN, GREY, MAGENTA, MUSTARD, ORANGE, PURPLE, RED, WHITE, YELLOW.
- red
- Specifies the red value settings in the range of 0 to 255.
- green
- Specifies the green value settings in the range of 0 to 255.
- blue
- Specifies the blue value settings in the range of 0 to 255.
For example: DotDensity,5,GREY=220,220,220 specifies the RGB value of 220, 220, 220 for GOCA pattern 5 with a grey foreground color.
- Enable_Auto_Font_Image=True | False
- Indicates whether a font is mapped automatically. Setting this parameter to True causes the font to be converted to image data if the font resources exist and a font mapping does not exist.
- Enable_Auto_Image_Cache=True | False
- Indicates whether images are saved.
- FIPS_Mode=True | False
- Indicates whether the transform functions in an environment that is compliant with the Federal Information Processing Standard (FIPS). When set to True, encryption options and digital certificate options are disabled. For example, any request to add user passwords or owner passwords to the PDF file and any attempt to digitally sign a PDF file are ignored.
- Flate_Compression_Level=n
- Specifies the level of the Flate compression used in the PDF file, where n is 0 to 9. The larger the number the longer the conversion takes, but a smaller PDF file should be created. The default is 6.
- FontExt=*.extension
- Specifies the file extension that the transform uses to search for font resources
in resource directories. For example, if FontExt=*.EXT and the AFP document reference a font named C0FONTCS, the transform searches for
a file named C0FONTCS.EXT in the resource directories.
- Note:
- The extension value is case-sensitive on most operating systems.
- If you add this parameter to the configuration file, the transform starts the search with the customized extension. If not set or not found, AFP2PDF Plus searches for the file extension by default, using this search order: no extension, .OLN, .FONTOLN, .240, .FONT3820, .FONT38PP, .CFT, .CDP, .300, .FONT300.
- Font_Path=directory
- Specifies the base directory that the transform users to search for the font configuration
files. By default, this base directory is the
\font
subdirectory where the transform modules were installed. If the parameter is used when the font configuration files have been moved to a different location, the same directory structure of the font configuration files must be preserved. For example, if this entry was given:Font_Path=c:\fontfils
, the code page map files must reside in thec:\fontfils\maps
directory. - Generate_Type3=True | False
- Indicates whether Type 3 fonts are generated in the PDF output instead of the raster
images of font characters. Type 3 fonts are raster fonts that can be used to display
the exact AFP raster font characters. For more information, see AFP2PDF Plus Transform Options File.
- Note:
- If the AFP font was generated with the standard AFP Graphic Character Global Identifiers (GCGIDs), the Type 3 font uses the searchable text. You can use the text search function in a PDF to find any text that uses a Type 3 font and standard IDs.
- Global_Scale= n.n
- Applies a scaling factor to all the data on the page relative to the paper or media represented in the PDF. For example, a scale of 50.0 reduces the data in half relative to the page. The accepted values are between 0 and 6400. The default value is 100.0.
- GOCA_Color_Of_Medium=White | Transparent
- Specifies how to treat the color of medium color in AFP Graphics Object Content Architecture (GOCA). The options are White and Transparent. The default value is White.
- GOCA_Pattern=patternid,var1,var2
- Specifies the characteristics for the AFP Graphics Object Content Architecture (GOCA)
pattern that is used to fill the interior of an area, where:
- patternid
- Specifies the GOCA pattern identifier, which defines various line fill patterns. Pattern ID supports values from 9 to 14.
- var1
- Defines the line width.
- var2
- Defines the line spacing.
For example: GOCA_Pattern=9,10,250 specifies GOCA pattern 9 with a line width of 10 and a line spacing of 250.
- GOCA_Use_Circles=True | False
- Indicates whether the transform uses circles or dots for GOCA patterns 1 through 8,
instead of shaded areas. Setting this parameter to True increases the PDF file size.
- Note:
- DotDensity overrides the GOCA_Use_Circles setting, for the DotDensity specific pattern.
- Honor_Constant_Forms=True | False
- Indicates whether the transform generates extra pages created from the constant forms control function, which is a function in AFP architecture that produces one or more static overlays on a page without variable data from the print file.
- Honor_Medium_Orientation=True | False
- Indicates whether the transform applies the medium orientation specified in the form definition to created PDF pages.
- Horizontal_Offset=n
- Applies a horizontal offset to all the data on the page relative to the paper or media represented in the PDF. The units of this setting are 1440 units per inch.
- Ignore_Bar_Code_Object_Area_Size=True | False
- Indicates whether the object area size of a bar code object is ignored when checking
if the generated bar code symbol fits within a specified area. By default, the object
area size of the bar code is used to check if the generated bar code symbol is larger
than the specified area to fit.
- Note:
- Setting this parameter to True ignores the area size of the bar code object and increases the size of the bar code symbol.
- Ignore_Data_Font_Height=True | False
- Indicates whether the transform ignores the font height. By default, the transform
uses the font height value specified in the AFP data. If this parameter is set to
True, the font height setting in the AFP data is ignored and the font size specified in
the font configuration file
csdef.fnt
is used. - Ignore_PTOCA_STC=True | False
- Indicates whether the color specified with the Set Text Color (STC) control to display text in Presentation Text Object Content Architecture (PTOCA) is honored. When True is specified, the STC-specified color is ignored and black is used.
- ImageMapEntries_File=file,[True | False]
- Specifies the file that the transform uses to output the image information from the AFP file. The information in this file can then be modified and passed as input back into the transform function to change the conversion method for individual AFP images. The optional flag after the file specifies whether MD5 checksums for images are generated. The checksums can also be used as matching criteria with image mapping. See Mapping AFP images for more information about the mapping images.
- JPEG_Quality_Level=n
- Specifies the JPEG quality level, where 0.0 is the least quality and maximum compression and 1.0 is the best quality with no compression. The default is 0.95. This parameter only affects RGB images.
- Keywords=text
- Specifies 1 to 120 characters for the Keywords entry in the Info Dictionary of the output PDF file. This information is displayed to the user if the function is selected in Adobe Acrobat.
- Layer=n
-
- n
- Specifies the default layer where Shaded_Area is placed, in relation to the text of the enclosing AFP object. Values are:
-
- 1
- Bottom: Place Shaded_Area under the entire text.
- 2
- In-place: Place Shaded_Area in the same position as the image that it is replacing.
- 3
- Top: Place Shaded_Area on top of the entire text.
For more information about shaded areas, see AFP2PDF Plus Transform Options File.
- Legacy_Font_Map=True | False
- If you specify True, AFP2PDF Plus uses the font mapping process from the legacy AFP2PDF transform.
- Locale_Path=path
- Specifies the path location of the locale-specific information files needed during the transform process. Only use this parameter when converting multiple-byte language files (Traditional Chinese, Simplified Chinese, Japanese, Korean, or Unicode).
- Logging=[ True | Append | Jobname], logDir, lvl
- Specifies the type of tracing that is turned on for program debugging and where the log file is located.
- Parameter options:
- When set to True, logging traces on a document boundary and overwrites the trace data from a previous
document in the log file. For True and Append options, the log file name is
Afp2Pdf.log
. - When set to Append, the logging process appends data to the end of the log file.
- When set to Jobname, the logging process creates a new log file for each job processed. The new log file
name concatenates the input file name and
-Afp2Pdf.log
together. For example, for theTestLog.afp
input file, the resulting log file isTestLog.afp-Afp2Pdf.log
. - The logDir setting specifies the fully qualified directory where the log file is saved. The
log file name is
Afp2Pdf.log
. - The lvl setting specifies the log level: SEVERE, WARNING, or INFO. The default is WARNING. This command overrides the settings in the
logging.properties
file.
- When set to True, logging traces on a document boundary and overwrites the trace data from a previous
document in the log file. For True and Append options, the log file name is
- Modify_BCOCA_Colors=True | False
- Indicates whether RGB value color settings override the display of named color values in the AFP Bar code objects (BCOCA). For more information, see the Color parameter.
- Modify_Text_Colors=True | False
- Indicates whether RGB value color settings override the display of named color values in the AFP text (PTOCA). For more information, see the Color parameter.
- Output_IndexInfo=True | False
- Indicates whether the group level index information of the document is placed as a
bookmark with this format:
index attribute : index value
- Other applications processing the PDF file can search for the bookmark text.
- Note:
- If the parameter is set to True on password protected files, the bookmark text becomes encrypted.
- Output_IndexInfo2=True | False
- Indicates whether the group level index information of the document is placed as a
bookmark with this format:
index attribute index value1 index value2
- Other applications processing the PDF file can search for the bookmark text.
- Note:
- If the parameter is set to True on password protected files, the bookmark text becomes encrypted.
- This parameter overrides Output_IndexInfo, if both Output_IndexInfo and Output_IndexInfo2 are specified.
- OverlayExt=*.extension
- Specifies the file extension that the transform uses to search for overlay resources
in resource directories. For example, if OverlayExt=*.OVE and the AFP document reference an overlay named O1OVERLY, the transform searches
for a file named O1OVERLY.OVE in the resource directories.
- Note:
- The extension value is case-sensitive on most operating systems.
- If you add this parameter to the configuration file, the transform starts the search with the customized extension. If not set or not found, AFP2PDF Plus searches for the file extension by default, using this search order: no extension, .OVLY3820, .OVLY38PP, .OVL, .OLY.
- Page_rotation=0 | 90 | 180 | 270
- Specifies the rotation value to use when transforming the file. Some AFP files might have already been formatted with a rotated orientation. In this case, you must use this parameter to align the text in an upright position.
- Page_Count_Output=file
- Specifies the location of the output file that stores the number of pages transformed
for each job. The output file contains the values in a comma-separated value (CSV)
format. By default, the transformed page numbers are not saved.
Note: To create the output file, the transform must have write permissions on the specified location.
- PageSegExt=*.extension
- Specifies the file extension that the transform uses to search for page segment resources
in resource directories. For example, if PageSegExt=*.SEG and the AFP document reference a page segment named S1PAGSEG, the transform searches
for a file named S1PAGSEG.SEG in the resource directories.
- Note:
- The extension value is case-sensitive on most operating systems.
- If you add this parameter to the configuration file, the transform starts the search with the customized extension. If not set or not found, AFP2PDF Plus searches for the file extension by default, using this search order: no extension, .PSEG3820, .PSEG38PP, .PSG, .PSE.
- PDF/A=True | False [,conformance level]
- Indicates whether the transform generates output that conforms to the PDF/A-1b, PDF/A-2b,
or PDF/A-3b specification. The accepted values for the optional parameter [conformance level] are 1b, 2b, or 3b.
Note: The default conformance level is 1b when the value is missing or the value specified after True is not accepted.
When this parameter is set to True, these conditions must be met for the transform to generate output that conforms to the specification:
-
All fonts must be embedded for PDF/A-1b, PDF/A-2b, or PDF/A-3b compliance. See AFP2PDF Plus Transform Options File for information about embedding fonts; see AFP2PDF Plus Transform Options File
-
The PDF file must not contain any passwords or encryption; therefore, none of the functions described in AFP2PDF Plus Transform Options File should be used when this parameter is set.
-
- PER_JOB_IMAGE_CACHE=True | False
- Indicates if images are cached at job level. Depending on the job content, if this option is set to true, the performance is improved, but it also uses extra memory.
- PfmPfb_Directory=directory
- Specifies the directory that the transform uses to search for PFB and PFM (or AFM) files when mapping AFP fonts to Type1 fonts. If not set, the default directory is “Font_Path/Type1”.
- Preserve_CMYK=True | False | Legacy
- Indicates if all AFP images are converted to the RGB color space in the PDF output.
Valid values for this parameter:
- False: for no AFP image conversion.
- True: preserves AFP images defined with the CMYK color space so that they are not converted
to RGB.
This parameter uses a compression in the PDF that does not cause any loss of color quality.
- Legacy: uses the CMYK to RGB formula from the legacy AFP2PDF transform.
- Producer=name
- Specifies 0-62 characters for the producer name in the Info Dictionary of the output
PDF file. The information is displayed when the Properties function under File is selected in Adobe Acrobat.
- Note:
- If the Producer parameter is included into the options file, but contains an empty value, then the Producer property in the output PDF file is also empty.
- If no Producer parameter is included into the options file, the output PDF document uses the name and the version of the AFP2PDF Plus transform, by default.
- PTX_Drawrule_Use_Line=True | False
- Indicates whether the transform uses line operators in the generated output for PTX draw rules (DIR and DBR). When this parameter is set to False, the system uses rectangle operators. For some PDF viewers this can impact the way the thin lines are rendered at different zoom levels. The default value is False.
- Resize_Page_with_Offsets=True | False
- This parameter affects only the AFP page size values used for the output PDF page.
When set to True, any offsets specified in the form definition and in the Horizontal_Offset and Vertical_Offset parameters are added to the AFP page width and AFP page length.
The sizes of the output PDF page are determined by the values from the Medium overlay size, the AFP page size or the Static_Paper_Width and Static_Paper_Length parameters:
- The width of the output PDF page
- If the Static_Paper_Width parameter is specified, the output PDF page width is set by that value. If Static_Paper_Width is not specified, the larger of the Medium overlay width and AFP page width determines the output PDF page width.
- The length of the output PDF page
- If the Static_Paper_Length parameter is specified, the output PDF page length is set by that value. If Static_Paper_Length is not specified, the larger of the Medium overlay length and AFP page length determines the output PDF page length.
- Resource_Cache_Size=n
- Specifies the maximum number of non MODCA image resources and PDF resources each to be cached for the duration of a transform job. Values bellow 1 will result in constant cache misses that can negatively affect performance.
- ResourceDataPath=directory[;directory]
- Specifies the directories that the transform uses to search for AFP resources. You can specify multiple directories, but they must be separated with a semicolon (;). See AFP2PDF Plus Transform Options File for more information.
- Shade_RGB=red, green, blue
- Specifies the intensity of the red, green, and blue colors when generating the color
of shaded areas. The color values are in the range of 0.0 to 1.0, with 0.0 for black
and 1.0 for white. For example: Shade_RGB=0.5, 0.5, 0.5.
See AFP2PDF Plus Transform Options File for more information about shaded areas.
- Show_Outline=True | False
- Indicates whether the outline window is displayed. If an AFP document contains index data, the transform converts this index information into PDF outline and bookmark functions. If the output PDF file contains any bookmark information, the outline window is always displayed when viewed with Adobe Acrobat. This parameter can be set to False so the outline window is not displayed.
- Show_Pageids=True | False
- Indicates whether the Page Identifier values are displayed in the bookmark pane.
- Static_Paper_Length=n
- Overrides the AFP logical page size used by the default for the page or media dimensions represented in the PDF. Using 72 units per inch, you can set a specific paper length for the entire document.
- Static_Paper_Width=n
- Overrides the AFP logical page size used by the default for the page or media dimensions represented in the PDF. Using 72 units per inch, you can set a specific paper width for the entire document.
- Subject=text
- Specifies 1–62 characters for the Subject entry in the Info Dictionary of the output PDF file. This information is displayed to the user if the function is selected in Adobe Acrobat.
- Substitute_Default_Medium_Map_Allowed=True | False
- Allows the use of the default Medium Map when processing the AFP pages, if the Medium Map requested with the Invoke Medium Map (IMM) or Begin Page (BPG) structured field is not found in the active form definition.
- Title=text
- Specifies 1–62 characters for the Title entry in the Info Dictionary of the output PDF file. This information is displayed to the user if the function is selected in Adobe Acrobat.
- Transform_All_Subgroups=True | False
- Specifies whether the transform converts all of the subgroup formatting from the AFP form definition resource. By default, the transform processes the first subgroup.
- TrueType_Directory=directory
- Specifies the directory that the transform uses to search for TrueType font files when mapping AFP fonts to TrueType fonts. If not set, the default directory is "Font_Path/TrueType".
- Type3Glyph_Position_Legacy=True | False
- Specifies whether the glyph is positioned using the formula from the legacy AFP2PDF transform, when positioning Type3 font glyphs.
- When set to True, the transform uses the legacy glyph positioning formula.
- UDC_Range=low1,high1[,low2,high2][,low3,high3][,low4,high4]
- Specifies one to four section ranges that the transform can search when processing
user-defined characters for double-byte character set (DBCS) text. The ranges restrict
which DBCS sections are searched, which causes the transform to run more efficiently.
For example, if the user-defined characters are present in sections 129, 130, and 131, the parameter can specify these low and high sections: UDC_Range=129,131.
- Use_AFP_Metrics=n
-
Specifies a number that tells the transform to use the AFP font metrics instead of the mapped font metrics. For example, Use_AFP_Metrics=255. With this option the transform uses the AFP font metrics instead of the metrics of the mapped font.
See Using AFP metrics in mapped font for more information.
- Use_Default_Hash_Code=True | False
-
Specifies whether the transform uses a default method to determine if two page segments or overlays are identical, based on the resource name and content. The alternative is an optimized method where two overlays are equal when they have the same content, even if they are named differently. Setting this to True can improve performance in some cases.
- Vertical_Offset=n
- Applies a vertical offset to all the data on the page relative to the paper or media represented in the PDF. The units of this setting are in 1440 units per inch.