RICOH Transforms Suite

ACIF

AFP Conversion and Indexing Facility

AES

Advanced Encryption Standard

AFM

Adobe Font Metric

AFP

Advanced Function Presentation

API

Application programming interface

AVE

AFP Visual Environment

BCOCA

Bar Code Object Content Architecture

CMOD

Content Manager OnDemand

CMR

Color management resource

CPGID

Code Page Global Identifier

DBCS

Double-Byte Character Set

ECM

Enterprise Content Management

FIFO

First In First Out

GIF

Graphical Interchange Format

IANA

Internet Assigned Numbers Authority

ICN

IBM Content Navigator

ICU

International Components for Unicode

IP

Internet Protocol

JFIF

JPEG File Interchange Format

JPEG

Joint Photographic Experts Group

JVM

JAVA Virtual Machine

NIST

National Institute of Standards and Technology

PCL

Printer Command Language

PDF

Portable Document Format

PTOCA

Presentation Text Object Content Architecture

RAT

Resource Access Table

STC

Set Text Color

TCP/IP

Transmission Control Protocol/Internet Protocol

TIFF

Tagged Image File Format

TLE

Tag Logical Element

UT

Universal Time

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.

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 the c:\term.pdf file to the beginning of the generated PDF file, while Append_PDF_File=C:\term.pdf,1 appends the c:\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 File ⇒ Properties 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 -Vcommand line parameter or the setImageMapFile 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 the setFormDef API;
• the external AFP resource group file from the -rcommand line parameter or A2PDocStart2 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 AFP 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 File ⇒ Properties function is selected in Adobe Acrobat.

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.

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 uses to search for the font configuration files. By default, this base directory is the \font subdirectory in the current working directory of the running application. When using the server mode, the running application is the server and not the client. 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 the c:\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. The default value is False. 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 File ⇒ Properties 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 the TestLog.afp input file, the resulting log file is TestLog.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. This command overrides the settings in the logging.properties file.

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 File ⇒ Properties 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 File ⇒ Properties 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.

Font Files and Subdirectories lists the AFP2PDF Plus Transform font support files and the subdirectories of the installation directory in which they are installed.

Font metric files should be set up to use the default PDF WinANSI encoding (code page 1252). They cannot be used for double-byte text (Asian languages). The files are located in the \font\Type1 subdirectory and are named Custom-Metrics-xx.met, where xx is 1 to 99.

To configure the transform, specify the name of the font metric file as the first parameter in the alias.fnt file. Set the second parameter, specifying the Adobe Font Metric (AFM) file name, to NULL.

Custom Font Metric files Defined in the alias.fnt File shows an example of the alias.fnt file with entries that define custom font metric files to the transform.

;**** Requested font=font name,Font metric/AFM file name (or
'NULL' for not used) *****
Font1=Custom-Metrics-1,NULL
Font2=Custom-Metrics-2,NULL
;******* End User-defined/Custom names *******

The format of custom font metric files follows the AFM specification, including these additional parameters that describe the font used for the display:

Flags

Specifies various characteristics of the font. Values for the Flags Parameter shows the allowable values.

Values for the Flags Parameter

Typeface	Flag
Courier—Serif Fixed Pitch	35
Courier Bold	262179
Courier Italic	99
Courier Bold Italic	262243
Helvetica (Arial)—Sans Serif Proportional	32
Helvetica Bold	262176
Helvetica Italic	96
Helvetica Bold Italic	262240
Sans Serif Fixed Pitch	33
Sans Serif Bold Fixed Pitch	262177
Sans Serif Italic Fixed Pitch	97
Sans Serif Bold Italic Fixed Pitch	262241
Times New Roman—Serif Proportional	34
Times New Roman Bold	262178
Times New Roman Italic	98
Times New Roman Bold Italic	262242

StemV

Specifies the width, measured in the x direction, of the dominant vertical stems of characters in the font.

In practical terms, StemV represents the weight or boldness of the font. A typical medium weight font has a value of 80. For a light font, the value might be in the 65–70 range. A bold font might have a value of 120. In all cases, use these values as a starting point. Adjust the StemV value to get the output PDF file to look like the original printed output.

ItalicAngle

Specifies the angle, in degrees counterclockwise from the vertical, of the dominant vertical strokes of the font. Typically, this value is in the range of -10 to -15. Adjust as necessary to get the output PDF file to look like the original printed output.

Example of a Custom Font Metric File shows an example of a custom metric file called Custom-Metrics-1.met.

FontName C0CUSTOM
; Description - 'Custom Font 1'
Ascender 924
CapHeight 720
Descender -216
Flags 32
FontBBox -47 -204 996 924
ItalicAngle 0
StemV 90
XHeight 720
StartCharMetrics
C 32 ; WX 240 ; N space ;
C 33 ; WX 252 ; N exclam ;
C 34 ; WX 408 ; N quotedbl ;
C 35 ; WX 480 ; N numbersign ;
C 36 ; WX 480 ; N dollar ;
C 37 ; WX 756 ; N percent ;
C 38 ; WX 552 ; N ampersand ; 
C 39 ; WX 240 ; N quotesingle ; 
   .
   .
   .
EndCharMetrics  

ACIF

AFP Conversion and Indexing Facility

AES

Advanced Encryption Standard

AFM

Adobe Font Metric

AFP

Advanced Function Presentation

API

Application programming interface

AVE

AFP Visual Environment

BCOCA

Bar Code Object Content Architecture

CMOD

Content Manager OnDemand

CMR

Color management resource

CPGID

Code Page Global Identifier

DBCS

Double-Byte Character Set

ECM

Enterprise Content Management

FIFO

First In First Out

GIF

Graphical Interchange Format

IANA

Internet Assigned Numbers Authority

ICN

IBM Content Navigator

ICU

International Components for Unicode

IP

Internet Protocol

JFIF

JPEG File Interchange Format

JPEG

Joint Photographic Experts Group

JVM

JAVA Virtual Machine

NIST

National Institute of Standards and Technology

PCL

Printer Command Language

PDF

Portable Document Format

PTOCA

Presentation Text Object Content Architecture

RAT

Resource Access Table

STC

Set Text Color

TCP/IP

Transmission Control Protocol/Internet Protocol

TIFF

Tagged Image File Format

TLE

Tag Logical Element

UT

Universal Time

AFP2PDF Plus Config UI is still under development. Some planned features are not yet implemented. Here is a list of current limitations:

• If the font resources for an AFP font are not available, not included in the AFP file, not provided in an external resource group file, and not found in a configured resource folder, the preview does not display with the default mapping and does not match the appearance of the printed output.
• The current version of AFP2PDF Plus Config UI does not fully import existing customer configuration files.
• You cannot create a mapping for an entire DBCS raster font. A DBCS raster font is created from several SBCS raster fonts. You can map only the individual SBCS fonts that it contains.
• Mapping to TrueType fonts, OpenType fonts, and fonts in TrueType collections is not yet supported.
• Custom metrics mappings are not yet supported for Type 1 fonts or for Base 14 fonts.