• Expert Advice
  • MFFAFP Filter Profile File GOCA Configuration for Output
MFFAFP Filter Profile File GOCA Configuration for Output

MFFAFP Filter Profile File GOCA Configuration for Output

 

The abbreviation MFF is short for for Mixed Format Filter. MFF input and output filters are part of the MFF architecture and, as part of DocBridge Core, support the processing steps in the DocBridge products. Some input filters read files of different formats, output filters write files into the respective output format. In some cases, a format is supported on input and output side.

Filters are configured in profile XML files with the file extension ".pro". In these profiles, you may specify where specific resources such as fonts are to be searched, the code pages to be used or the mapping of font names to font files. If a format is supported both as input and output format, such as AFP, input and output processing are configured in the same profile file.

This article describes the configuration of GOCA in the output section of the MFFAFP filter profile. GOCA is short for Graphics Object Content Architecture, which provides a collection of graphics values and control structures used to interchange and present vector graphics in AFP pages, page segments, or overlays. Vector graphic shapes are created with "drawing orders" that draw shapes, or set attributes and controls, that determine the appearance of those shapes.

The GOCA architecture defines two levels, Drawing Level 2 Version 0 (DR/2V0) and Graphics Subset Level 3 (GRS3).
Whether the AFP data should contain DR/2V0 or GRS3 generally depends on the device used to print it. To ensure the AFP filter produces the expected output, the GOCA configuration settings in the MFFAFP filter profile should be verified and adjusted when needed.

The most important GOCA related element in the output section of the MFFAFP filter profile is "goca" and the attribute "version". If the value of "goca" is set to "false", vector graphics such as lines, rectangles and paths are rendered in the output. If the value is set to "true", vector graphics are written to the output based on the "version" specified and the "drawing orders" enabled with the sub-elements.

The default "goca" value is set to "false" and the default version is "2" for GOCA Drawing Level 2 Version 0 (DR/2V0). To use GOCA Graphics Subset Level 3 (GRS3), version should be set to "3".

<goca value="false" version="2">

The following elements can be used to enable or disable GOCA drawing orders in the output.

1. SetProcessColorSupport:

The "Set Process Color" drawing order is used to assign a process color, highlight color or named color value to a shape. This element is commented out in the default profile, because support for "Set Process Color" is part of GRS3 and optional with DR/2V0.

The "SetProcessColorSupport" default value is "true" if GRS3 is defined and "false" for DR/2V0. If the device supports "Set Process Color" with DR/2V0, the element can be used to activate the drawing order.

Info: Please note that if the value is set to "false" and GRS3 is specified, "Set Process Color" will not be used in the output.

<SetProcessColorSupport value="false"/>

2. BoxSupport:

The box drawing orders are used to draw rectangular shapes with with square or rounded corners. This element is commented out in the default profile, because the box drawing orders are part of GRS3 and optional with DR/2V0.
If GRS3 is defined, the "BoxSupport" default value is "true" and for DR/2V0 the default value is "false". If the device supports box drawing orders with DR/2V0, the element can be used to activate the drawing order.

Info: Please note that if the value is set to "false" and GRS3 is specified, box drawing orders will not be used in the output.

<BoxSupport value="false"/>

3. SetFractionalLineWidthSupport:

The line width attribute consists of an integral and fractional part. If supported by the printer, the "Set Fractional Line Width" drawing order is used to set both the integer portion and the fractional portion of the line width.
This element is commented out in the default profile, because support for "Set Fractional Line Width" is part of GRS3 and optional with DR/2V0.

The "SetFractionalLineWidthSupport" default value is "true" if GRS3 is defined and "false" for DR/2V0. If the device supports "Set Fractional Line Width" with DR/2V0, the element can be used to activate the drawing order.

Info: Please note that if the value is set to "false" and GRS3 is specified, "Set Fractional Line Width" will not be used in the output.

<SetFractionalLineWidthSupport value="false"/>

4. SetLineEndOrderSupport:

The default line cap style defined with GRS3 is round, but with DR/2V0 the default style is device specific. The "Set Line End" drawing order is used to define the line end to be used.

This element is commented out in the default profile, because support for "Set Line End" is optional in both GRS3 and DR/2V0. The "SetLineEndOrderSupport" default value is "false". If the device supports the "Set Line End" drawing order, the value can be set to "true" to activate the drawing order. Lines with line caps other than the default are rendered in the output if "SetLineEndOrderSupport" is set to "false". Also refer to the element "GocaLineCapStyle".

<SetLineEndOrderSupport value="false"/>

5. SetLineJoinOrderSupport:

As with the line cap style, the default line join style is not defined by DR/2V0 and the default style defined with GRS3 is round. The "Set Line Join" drawing order is used to define the shape of the connection between lines.
Because support for "Set Line Join" is optional in both GRS3 and DR/2V0, this element is commented out in the default profile.

The "SetLineJoinOrderSupport" default value is "false". The value can be set to "true" to activate the drawing order if the device supports the "Set Line Join" drawing order. If "SetLineJoinOrderSupport" is set to "false", lines with line joins other than the default are rendered in the output. Also refer to the element "GocaLineJoinStyle".

<SetLineJoinOrderSupport value="false"/>

6. SetCustomLineTypeOrderSupport:

With the "Set Custom Line Type" drawing order a custom line type is defined by specifying a custom sequence of dashes, dots and moves.

This element is commented out in the default profile, because support for "Set Custom Line Type" is optional in both GRS3 and DR/2V0. The "SetCustomLineTypeOrderSupport" default value is "false". The value can be set to "true" to activate the drawing order if the device supports the "Set Custom Line Type" drawing order. If the value is set to "false", lines with line types not defined by the GOCA specification are rendered in the output.

<SetCustomLineTypeOrderSupport value="false"/>

7. NonzeroWindingModeSupport:

Nonzero Winding and Alternate mode are different ways to determine which areas in a complex vector graphic shape should be filled and which not.

This element is commented out in the default profile, because "Nonzero Winding Mode" support is optional in both GRS3 and DR/2V0. The "NonzeroWindingModeSupport" default value is "false". If the device supports "Nonzero Winding" mode, the value can be set to "true" to activate it. If the value is set to "false", areas filled with "Nonzero Winding Mode" are rendered in the output.

<NonzeroWindingModeSupport value="false"/>

8. GocaLineWidthBase:

All GOCA line widths are defined as a factor to be multiplied with the normal line width. GRS3 specifies a default normal line width value of 0.01 inch, but with DR/2V0 the value is device-dependent. If lines are thicker or thinner than expected, the normal line width of the device is not 0.01 inch. Use "GocaLineWidthBase" to specify the printer specific value.

<GocaLineWidthBase value="0.01 in"/>

9. GocaMaxLineWidthFactor:

If a line width exceeds the maximum supported by the printer, the printer maximum is used. The "GocaMaxLineWidthFactor" value is used by the Compart GOCA Library to determine if the line width is supported by the printer. Lines which width exceed the maximum supported by the printer are drawn with alternative drawing orders or rendered in the output to ensure visual accuracy. The type of this attribute is integer between 1 and 255, and its default value is 100.

<GocaMaxLineWidthFactor value="100"/>

10. GocaLineJoinStyle:

The default style for the shape used to join lines with GRS3 is "round ", but with DR/2V0 the default style is device specific. The "GocaLineJoinStyle" default value is "round". Use GocaLineJoinStyle to set one of the other supported values: "miter" or "bevel", if the default used by the device is not "round". See samples below:

<GocaLineJoinStyle value="round"/>

round

round

miter

miter

bevel

bevel

11. GocaLineCapStyle:

As with the line join style, the default line cap style is not defined by the DR/2V0 specification. The line cap shape used when no explicit value is set in the input data, depends on the device. The default style defined with GRS3 is round.
The "GocaLineCapStyle" default value is "round". If the default style used by the device is not "round", use GocaLineCapStyle to set one of the other supported values: "butt" (or "flat") or "square". See samples below:

<GocaLineCapStyle value="round"/>

round

round

butt

butt

square

square

Advice: Ask Compart support for the "GOCA configuration sheet" test file if you are not sure about your devices´ default line settings.

By using our website, you agree to our use of cookies. More