Subcommands

GRAPHID Subcommand
GRAPHID {00 | nn}
Specifies a number that is used later to identify as the box or set of boxes to be closed by the ENDGRAPHIC command. The default is 00.
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 for the first box. This position is relative to the LAYOUT command's position statement or the current position.
SpeLPOScifies 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.
BOXSIZE Subcommand
BOXSIZE width [IN | MM | CM | POINTS | PELS]
     [height [IN | MM | CM | POINTS | PELS]]
Specifies the horizontal and, optionally, vertical dimensions of the box. The first parameter is required and specifies the horizontal width of the box, which is a fixed size. The second parameter is optional and if given, specifies the fixed vertical depth of the box. If the second parameter is omitted, the box is a variable size or floating box. For a floating box, the depth of the box is determined when the box is closed with an ENDGRAPHIC command.
ROUNDED Subcommand
ROUNDED {MEDIUM | SMALL | LARGE | MAX}
Specifies the size of the rounded corner:
MEDIUM
Medium corner length: equates to a radius of 20 pels at 240 pels/inch or 120 pels at 1440 pels/inch
SMALL
Small corner length:- equates to a radius of 10 pels at 240 pels/inch or 60 pels at 1440 pels/inch.
LARGE
Large corner length: equates to a radius of 30 pels at 240 pels/inch or 180 pels at 1440 pels/inch
MAX
Maximum corner length gives an arc with a radius that extends half the length of the shortest box side. If boxes are rounded MAX, they cannot be open-ended.
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 box border. 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 [0 | n] [IN | MM | CM | POINTS | PELS]
Specifies that the box repeats at regular intervals either across or down the page. The total number of boxes is one more than the value specified on this parameter.
Note: If boxes are repeated in the DOWN direction, they cannot be open-ended.

Spaced Boxes (not to scale).

Spaced Boxes (not to scale).

Boxes Spaced 0 (not to scale).

Boxes Spaced 0 (not to scale).
SPACED
Specifies the spacing between the boxes. The default is to have no space between the boxes. If there is no space between the boxes, the common border is shared and not duplicated.
FILL Subcommand
[FILL [ALL | BOX n] [SOLID | NOFILL | DOT01 | DOT02 | DOT03 |
DOT04 | DOT05 | DOT06 | DOT07 | DOT08 | VERTLN | HORZLN | BLTR1 | 
BLTR2 | TLBR1 | TLBR2] [COLOR colorname]]…
Specifies that a box 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 box, the last FILL wins.

ALL
Fill all boxes. This is the default.
BOXn
Specifies the box to be filled. Boxes 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 boxes has been specified as filled and one or more of them are to be left empty. In the example, boxes 1, 2, 4, and 5 are filled with solid blue and box 3 is empty: 
			LAYOUT ...
				Drawgraphic BOX boxsize 1 in .2 in copy down 4
				Linetype solid color green
				FILL ALL SOLID Color Blue
				FILL Box 3 NOFILL;
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:
  1. See AFP Color Management for more information about using the RENDER subcommand.
  2. 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;
Parent topic: DRAWGRAPHIC BOX Command (Record Format and XML)