IN_GetVectorPen

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

The IN_GetVectorPen function returns the color, width, units, and dashing option of the specified vector pen line. Pen settings are used in HPGL and Calcomp 906/907 vector files.

Syntax

int IN_GetVectorPen( penNumber, pColor, pWidth, pUnits, pDashCnt, pDash1, pDash2, pDash3, pDash4 )

Input Parameters

Values

Meaning

SHORT penNumber

0 to 255

number of the pen to query

Output Parameters

Meaning

IN_RGB_PTR pColor

pointer to the pen color. Representing colors using 24-bit RGB values.

DOUBLEPTR pWidth

pointer to the pen width in the specified units

USHORTPTR pUnits

units to use:

IN_UNITS_INCH (1)

IN_UNITS_MM (5)

IN_UNITS_POINTS (7)

SHORTPTR pDashCnt

pointer to the number of dash options being used (0 to 4)

DOUBLEPTR pDash1 ... DOUBLEPTR pDash4

pointers to the 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