IN_SetVectorPen

image\bltlrgsq_shg.gif Editions  image\bltlrgsq_shg.gif Related Functions  image\bltlrgsq_shg.gif Example

The IN_SetVectorPen function defines the color, width, units, and dashing pattern for a particular vector pen line. Pen settings are used in HPGL and Calcomp 906/907 vector files.

Syntax

int IN_SetVectorPen( penNumber, color, width, units, dashCnt, dash1, dash2, dash3, dash4 )

Parameters

Values

Meaning

SHORT penNumber

0 to 255

number of the pen to define

IN_RGB color

pen color. Representing colors using 24-bit RGB values.

DOUBLE width

0 | 1 | 2 | ...

pen width in the specified units

USHORT units

units to use:

IN_UNITS_INCH (1)

IN_UNITS_MM (5)

IN_UNITS_POINTS (7)

SHORT dashCnt

0 | 4

no dashing | dashing pattern

DOUBLE dash1 to DOUBLE dash4

1 | 2 | 3 | ...

length of the dashes in the line pattern.

Release information

Added to Imagenation for Windows in Release 4.53.

As of Release 5.1, also available in Imagenation for UNIX.

See also

Selecting vector pen settings