GINO Graphics Suite - GINO v9.0  

gEnqSelectedPen

Syntax

[C/C++:]
void gEnqSelectedPen(int *col, float *width, int *type);
[F90:]
subroutine gEnqSelectedPen(col, width, type)

integer, intent(out) :: col,type
real, intent(out) :: width

Arguments

col
Colour setting (see gSetLineColour())

width
Pen width in current units (see gSetLineWidth())

type
Pen type (see gSetPenType())

= 0, No pen types implemented

Description

The routine gEnqSelectedPen() returns the physical pen attributes currently implemented by the device. Devices cannot always implement colour, width and pen type exactly as requested and this is always reflected in the values returned by gEnqSelectedPen(). The colour and pen type requested simply may not be available or, for devices like plotters where the three attributes are associated, the exact combination of attributes may not be available. The width value returned is the pen width in current units.

Note that in the case of direct colour devices, the return value of col will contain a 24bit RGB triplet irrespective of whether the line colour was selected using a colour identifier, a colour table index or a 24bit RGB triplet.

See Also

gEnqSelectedPen Usage
gSetLineColour
gSetPenType