RESTYPE
Specifies the type of AFP print resources ACIF retrieves from the resource directories or libraries for inclusion in the resource file (specified with the RESOBJDD parameter). (See Search order for AFP resources for the order that ACIF searches for AFP resources.)
- RESTYPE={NONE | ALL | [FDEF][,PSEG][,OVLY][,FONT][,OBJCON][,BCOCA] [,GOCA][,IOCA][,PTOCA][,CMRALL][,CMRGEN][,INLINE][,INLONLY]}
- The values are:
- NONE
- Specifies that no resource file is created.
- ALL
- Specifies that all resources that are required to print or view the output document
file (specified with the OUTPUTDD parameter) are included in the resource file.
Note: Specifying this value can create large resource files, particularly when color management resources (CMRs) are included.
- FDEF
- Specifies that the form definition (specified with the FORMDEF parameter) that is used in processing the file is included in the resource file.
- PSEG
- Specifies that all page segments that are required to print or view the output document file are included in the resource file.
- OVLY
- Specifies that all overlays that are required to print or view the output document file are included in the resource file.
- FONT
- Specifies that all font character sets and code pages that are required to print or
view the output file are included in the resource file. Also used for TrueType and
OpenType fonts and specifies that all base fonts, linked fonts, and font collections
that are required to print the output file be included in the resource file. If MCF2REF=CF
is specified, ACIF also includes coded fonts in the resource file; otherwise, coded
fonts are not included in the resource file.
- Note:
- Specifying RESTYPE=FONT is not recommended with double-byte raster fonts because of the size and large number of library members that are needed to process double-byte raster fonts. If RESTYPE=FONT is specified, you might want to specify MCF2REF=CF, which can improve ACIF performance by reducing the number of font members ACIF processes.
- When you specify RESTYPE=FONT with TrueType and OpenType fonts, the embed flag must be set “on” to save the font in the resource file. For more information, see Using OpenType Fonts in an AFP System, G544-5876.
- ACIF wraps TrueType and OpenType fonts in MO:DCA-P structured fields when it saves them in the resource file.
- When EXTENSIONS=RESORDER is specified with RESTYPE=FONT, TrueType and OpenType fonts that were originally inline in the input file are not saved in the resource library.
- When RESTYPE=FONT is specified, ACIF checks to see whether a Map Data Resource (MDR) structured field setting requires that a requested data object font is inline in the input file resource group.
- OBJCON
- Specifies that all object container files requested by the input data stream be included
in the resource file. These object container files include objects such as color mapping
tables specified by the COLORMAP parameter, the COM setup file that is specified by
the COMSETUP parameter, color management resources (CMRs), Encapsulated PostScript (EPS), Portable Document
Format (PDF) objects, and TIFF images.Note: When printing only one page from a multiple page object container file, all pages in the object container are still saved in the resource file.
- BCOCA
- Specifies that all BCOCA objects included by an IOB structured field that is required to print or view the output document file is included in the resource file.
- GOCA
- Specifies that all GOCA objects included by an IOB structured field that is required to print or view the output document file is included in the resource file.
- IOCA
- Specifies that all IOCA objects included by an IOB structured field that is required to print or view the output document file is included in the resource file.
- PTOCA
- Specifies that all PTOCA objects included by an IOB structured field that is required to print or view the output document file is included in the resource file.
- CMRALL
- Specifies that all CMRs required to print or view the output document file (except link CMRs) are included in the resource file. These CMRs include all CMRs referenced in the data stream, all CMRs referenced through a data object or color management resource access table (RAT), and all generic halftone and tone transfer curve CMRs. For more information about the RAT, see Processing resources installed with resource access tables.
- CMRGEN
- Specifies that all CMRs referenced in the data stream plus any non-device specific CMRs referenced through a data object or color management RAT (except link CMRs) are included in the resource file. With CMRGEN, the output that is generated by ACIF is not device-specific, unless the data stream explicitly references a device-specific CMR.
- INLINE
- When one or more resource object types are specified with RESTYPE, specifies that all inline resources that match
the types are written to the output file in addition to the resource file. For example,
RESTYPE=FONT,PSEG,INLINE
causes any inline fonts and page segments to be written to the output file, in addition to writing all inline and library fonts and page segments to the resource file. The inline resources precede the document in the output file. For more information, see Processing inline resources. - INLONLY
- Specifies that all inline resources contained in the input file are written to the
output file, regardless of resource type. ACIF searches only for resources that are
inline, even if other RESTYPE values are specified. Also, no resource file is created,
even if the RESOBJDD parameter is specified.
Note: If no form definition is found inline and because a form definition is always required to process the document, ACIF searches for the requested form definition in the libraries.
Because multiple resource types are contained in the font, object container, and page segment libraries, and ACIF does not enforce a prefix for the 8-character resource name, define a naming convention that identifies each type of resource in the library. Ricoh suggests that you use a 2-character prefix naming convention for 8-character resource names. Other resource types (coded fonts, form definitions, and page definitions) use required prefixes for identification.
ACIF supports the specification of BCOCA, CMRALL, CMRGEN, FDEF, FONT, GOCA, IOCA, INLINE, OBJCON, OVLY, PSEG, and PTOCA in any combination. For example, if you want to specify form definitions, page segments, and overlays as the resource types, you can enter
RESTYPE=FDEF,PSEG,OVLY
orRESTYPE=OVLY,FDEF,PSEG
.However, ALL, INLONLY, and NONE are order-dependent and override any individual resource types specified. If more than one is specified, the last one is used. For example, if you specify
RESTYPE=FDEF,INLONLY,PSEG,NONE,OVLY,ALL
, all resources are included.- Note:
- When you are creating AFP files to view on the AFP Workbench Viewer, do not specify RESTYPE=FONT or RESTYPE=ALL. The AFP Workbench Viewer uses font definition files for font substitution instead of retrieving fonts from a resource file when it displays documents. Therefore, you do not need to download fonts to the resource file, which is time-consuming and increases the number of bytes transmitted when the file is transferred to the workstation or archived.
- If you have a resource type that you want saved in a resource file, and it is included in another resource type, you must specify both resource types. For example, if you request that only page segments be saved in a resource file, and the page segments are included in overlays, the page segments are not saved in the resource file because the overlays are not searched. In this case, you must request that both page segments and overlays be saved.
- ACIF saves specified inline resources in the resource file, even if they are not needed to print the job. However, if you specify EXTENSIONS=RESORDER, ACIF saves only the inline resources that are actually needed to print the job. You can also use a resource exit to filter out any resources that you do not want included in the resource file (see Resource exit for more information).