SAPscript: Definition of borders, lines, and shading 

Description

In SAPscript Release 3.0A, text commands were introduced for drawing borders, lines, and shading. Parameters can be set for position, size, border thickness, and shading. Within a layout set, individual windows or specific text passages within a window can therefore be output with a border or shading.

The SAP printer drivers based on page printers (HP Laserjet driver, Postscript driver, Kyocera Prescribe driver) convert this command during output. All other line printers or page printers not supported in the standard version ignore these commands.
This printout can be displayed in the SAPscript previewer (30A: UNIX Motif , 30B: DOS, NT WINDOWS).

How are the borders defined in the layout set?

Using the following new text commands:

1. /: BOX [XPOS] [YPOS] [WIDTH] [HEIGHT] [FRAME] [INTENSITY] 
2. /: POSITION [XORIGIN] [YORIGIN] [WINDOW] [PAGE] 
3. /: SIZE [WIDTH] [HEIGHT] [WINDOW] [PAGE] 
 
 

1. /: BOX [XPOS] [YPOS] [WIDTH] [HEIGHT] [FRAME] [INTENSITY]

Effect

Draws a box at this position with the specified size.

Additional

XPOS, YPOS, WIDTH, HEIGHT and FRAME always require

specifs.

a measurement and a unit of measurement to be specified. The additional specification INTENSITY requires the specification of a percent number between 0 and 100.

  • XPOS, YPOS
    Upper left corner of box, based on the values from the POSITION command.
    Default: Values from POSITION command

    The following internal calculation rule is used to determine the absolute output position of a box on the page:
    X(abs) = XORIGIN + XPOS
    Y(abs) = YORIGIN + YPOS
  • WIDTH
    Width of box
    Default: WIDTH value from SIZE command
  • HEIGHT
    Height of box
    Default: HEIGHT value from SIZE command
  • FRAME
    Frame thickness
    Default: 0 (no frame line)
  • INTENSITY
    Density of the box contents in %
    Default: 100 (solid black)

Measurements

Decimal measurements must be enclosed in inverted commas as literals (like ABAP number constants). The period should be used as the decimal point. Also see the following examples.

Unit

Valid units of measurement are TW (twip), PT (point), IN (inch), MM (millimeter), CM (centimeter), LN (line), CH (character). The following conversions apply:
1 TW = 1/20 PT
1 PT = 1/72 IN
1 IN = 2.54 CM
1 CM = 10 MM
1 CH = character height from layout set header (CPI)
1 LN = line height from layout set header (LPI)

Examples

/: BOX FRAME 10 TW

Draws a frame around the current window with a frame thickness of 10 TW (= 0.5 PT)

/: BOX INTENSITY 10

Shades the window background with a density (gray shade) of
10 %

/: BOX HEIGHT 0 TW FRAME 10 TW

Draws a horizontal line at the upper window border over the entire window width

/: BOX WIDTH 0 TW FRAME 10 TW

Draws a vertical line at the left window border over the entire window height

/: BOX WIDTH '17.5' CM HEIGHT '1' CM FRAME 10 TW INTENSITY 15 
/: BOX WIDTH '17.5' CM HEIGHT '13.5' CM FRAME 10 TW 
/: BOX XPOS '10.0' CM WIDTH 0 TW HEIGHT '13.5' CM FRAME 10 TW 
/: BOX XPOS '13.5' CM WIDTH 0 TW HEIGHT '13.5' CM FRAME 10 TW

Draws two rectangles and two lines to construct a three-column table with a highlighted heading line

2. /: POSITION [XORIGIN] [YORIGIN] [WINDOW] [PAGE]

Effect

Determines the origin of the coordinate system for the parameters XPOS and YPOS from the BOX command. When the window is output, the POSITION value is set to the upper left corner point of the window (default setting).

Additional

If a parameter value does not have a sign, its value is

specifs.

regarded as an absolute value, this means the values refer to the upper left corner point of the output page. If a parameter value does have a sign, the new value of this parameter is calculated relative to the old value. If a parameter is missing, the current value of this parameter is not changed.

  • XORIGIN, YORIGIN
    Origin of the coordinate system
  • WINDOW
    Sets the values for left and upper border to the values of the current window (default setting)
  • PAGE
    Sets the values for left and upper border to the values of the current output page (XORIGIN = 0 cm, YORIGIN = 0 cm)

Examples

/: POSITION WINDOW

Sets the coordinate origin to the upper left window corner point

/: POSITION XORIGIN 2 CM YORIGIN '2.5 CM'

Sets the coordinate origin to 2 CM measured from the left page border and 2.5 CM measured from the upper page border

/: POSITION XORIGIN '-1.5' CM YORIGIN -1 CM

Moves the upper left coordinate origin 1.5 cm to the left and 1 cm up

3. /: SIZE [WIDTH] [HEIGHT] [WINDOW] [PAGE]

Effect

Determines the values for the parameters WIDTH and HEIGHT from the BOX command. When a window is output, the SIZE value is set to the corresponding values of this window (default setting).

Additional

If a parameter is missing in the command, the current value

specifs.

of this parameter is not changed. If a parameter value does not contain a sign, its value is regarded as an absolute value. If a parameter value does contain a sign, the new value of this parameter is calculated relative to the old value.

  • WIDTH, HEIGHT
    Dimension of the rectangle or line
  • WINDOW
    Sets the values for width and height to the corresponding values of the current window (default setting)
  • PAGE
    Sets the values for width and height to the corresponding values of the current output page

Examples

/: SIZE WINDOW

Sets WIDTH and HEIGHT to the window dimensions

/: SIZE WIDTH '3.5' CM HEIGHT '7.6' CM

Sets WIDTH to 3.5 cm and HEIGHT to 7.6 cm

/: POSITION WINDOW 
/: POSITION XORIGIN -20 TW YORIGIN -20 TW 
/: SIZE WIDTH +40 TW HEIGHT +40 TW 
/: BOX FRAME 10 TW

The current window is framed. The frame projects beyond the beginning of the window so that the first and last text characters are not overwritten.