Subcommands
- POSITION Subcommand
-
POSITION LPOS [[(+) |(–)] horiz {IN | MM | CM | POINTS | PELS}] NEXT [{LPOS | CPOS} [(+) | (–)] vert {IN | MM | CM | POINTS | PELS}]Specifies the horizontal and vertical position of the center of the first circle. This position is relative to the LAYOUT command's position statement or the current position.- LPOS
- Specifies the layout position. If LPOS is used alone, the position is the same position as is specified on the LAYOUT command. If it is used with a + or - value, the position moves that amount from the LAYOUT position.
- CPOS
- Specifies the current position. If CPOS is used alone, the position is the same position as is specified on the previous FIELD or DRAWGRAPHIC command command. If it is used with a + or - value, the position moves that amount from the FIELD or DRAWGRAPHIC command position.
- RADIUS Subcommand
-
RADIUS n [IN | MM | CM | POINTS | PELS]
Specifies the circle radius. (The radius is measured from the center of the circle to the middle of the line width.) - LINEWT Subcommand
-
LINEWT [MEDIUM | LIGHT | BOLD | n]
Specifes the weight of the line either as one of the following keywords or in lineweights (1 lineweight = .01 inch). Specify 0 if you want invisible borders (type and color are then ignored).- LIGHT
- The same as LINEWT 1 (.01 inch)
- MEDIUM
- The same as LINEWT 2 (0.2 inch
- BOLD
- the same as LINEWT 3 (.03 inch)
- LINETYPE Subcommand
-
LINETYPE [SOLID | DOTTED | SHORTDASH | DASHDOT | DBLDOT | LONGDASH | DSHDBLDOT] [COLOR colorname]Specifies the line type using one of these keywords:- SOLID
- DOTTED
- SHORTDASH
- DASHDOT
- DBLDOT (double dot)
- LONGDASH
- DSHDBLDOT (dash double dot)
- COLORcolorname
- Specifies the color to be used for the line. The color name must be either one of the pre-defined OCA keywords or the color name from the DEFINE COLOR command.
- COPY Subcommand
-
COPY {ACROSS | DOWN} n [SPACED {DIAMETER | n [IN | MM | CM | POINTS | PELS]}]]Repeats the same circle at regular intervals either across or down the page. The total number of circles is one more than the value specified on this parameter.- SPACED
- Specifies the spacing between the lines.
- DIAMETER
- The circles are placed to join at one point with the center positions of each being one diameter width apart.
See Figures Repeating Circles with .45 Inch Spacing (Not to Scale) and Repeating Circles with DIAMETER Spacing (Not to Scale) for a pictorial view of repeating circles.
Repeating Circles with .45 Inch Spacing (Not to Scale)
Repeating Circles with DIAMETER Spacing (Not to Scale)
- FILL Subcommand
-
[FILL [ALL | CIRCLE n] [SOLID | NOFILL | DOT01 | DOT02 | DOT03 | DOT04 | DOT05 | DOT06 | DOT07 | DOT08 | VERTLN | HORZLN | BLTR1 | BLTR2 | TLBR1 | TLBR2] [COLOR colorname]]…
Specifies that a circle is to be filled with a pre-defined GOCA pattern and optionally specifies a fill color.If more than one FILL subcommand applies to a circle, the last FILL wins.
- ALL
- Fill all boxes. This is the default.
- CIRCLEn
- Specifies the circle to be filled. Circles are numbered in the order that they are defined by the COPY parameter, starting with 1.
- SOLID | NOFILL | DOT01 | DOT02 | DOT03 | DOT04 | DOT05 | DOT06 | DOT07 | DOT08 | VERTLN | HORZLN | BLTR1 | BLTR2 | TLBR1 | TLBR2
- Specifies the fill pattern to use. For an example of the various GOCA-supported fill
patterns, see Fill Patterns for DRAWGRAPHIC Commands.
- NOFILL
- The NOFILL keyword can be used when a series of circles has been specified as filled and one or more of them are to be left empty.
- RENDER Subcommand
-
RENDER {PERCEPTUAL | SATURATION | RELCM | ABSCM} - Specifies the rendering intent (RI) for a defined graphic (GOCA) object within a page
definition. RI is used to modify the final appearance of color data and is defined
by the International Color Consortium (ICC).
- Note:
- See AFP Color Management for more information about using the RENDER subcommand.
- See the current level of the ICC Specification for more information on RI.
- PERCEPTUAL
- Perceptual rendering intent. It can be abbreviated as PERCP. With this rendering intent, gamut mapping is vendor-specific, and colors are adjusted to give a pleasing appearance. This intent is typically used to render continuous-tone images.
- SATURATION
- Saturation rendering intent. It can be abbreviated as SATUR. With this rendering intent, gamut mapping is vendor-specific, and colors are adjusted to emphasize saturation. This intent results in vivid colors and is typically used for business graphics.
- RELCM
- Media-relative colorimetric rendering intent. In-gamut colors are rendered accurately, and out-of-gamut colors are mapped to the nearest value within the gamut. Colors are rendered with respect to the source white point and are adjusted for the media white point. Therefore colors printed on two different media with different white points won't match colorimetrically, but may match visually. This intent is typically used for vector graphics.
- ABSCM
- ICC-absolute colorimetric rendering intent. In-gamut colors are rendered accurately, and out-of-gamut colors are mapped to the nearest value within the gamut. Colors are rendered only with respect to the source white point and are not adjusted for the media white point. Therefore colors printed on two different media with different white points should match colorimetrically, but may not match visually. This intent is typically used for logos.
- CMR Subcommand
-
[CMR cmrlname {AUDIT | INSTR | LINK}]… - Specifies a Color management resource (CMR) and its process mode for a graphics object
within the page definition.
Note: See AFP Color Management for more information about using the CMR subcommand.
- cmr-lname
- The CMR local name. This name must have been defined with a DEFINE CMRNAME command.
Note: This parameter must immediately follow the CMR keyword.
- Processing mode parameter
- Specify the processing mode for the CMR.
- AUDIT
- Process this CMR as an audit CMR.
- INSTR
- Process this CMR as an instruction CMR.
- LINK
- Process this CMR as a link CMR. This processing mode is only valid for device link (DL) CMRs.
Code Example: The following examples show how to define CMRs and rendering intent for graphics objects. Rendering intent and a CMR are defined for Record Format and XML page definitions. These are the only two page definition types for which DRAWGRAPHIC commands are legal.
DEFINE mycmr CMRNAME ... ; PAGEDEF cmr11L REPLACE yes; FONT f1; LAYOUT 'L1'; DRAWGRAPHIC BOX BOXSIZE 1 in 2 in RENDER relcm CMR myCMR audit; PAGEDEF cmr11X REPLACE yes; FONT f1 TYPE ebcdic; XLAYOUT QTAG 'x1'; DRAWGRAPHIC BOX BOXSIZE 1 in 2 in RENDER relcm CMR myCMR audit;