GINO Graphics Suite - GINO v9.0  

gEnqCharAttribs

Syntax

[C/C++:]
void gEnqCharAttribs(GCHASTY *rep);
[F90:]
subroutine gEnqCharAttribs(rep)
type (GCHASTY), intent(out) :: rep

Arguments

rep.type
Character output type

= 1, Hardware (gSetHardChars(), gSetPointChars(), gSetMixedChars() or gSetHardCharSize())
= 2, Pseudo hardware (gSetHardChars(), gSetPointChars(), gSetMixedChars() or gSetHardCharSize())
= 3, Software untransformable (gSetSoftChars())
= 4, Software transformable (gSetCharTransformMode(GON))
rep.width
Character width in current units

rep.height
Character height in current units

rep.size
Hardware character size

= -2, Character size set using gSetCharSizePoint() or whilst gSetPointChars() is current
= -1, Character size set using gSetCharSize() - (default)
=  0, Character size set using gSetHardCharSize() and default size is current
= >0, Character size set using gSetHardCharSize()

rep.slant
Italic angle in degrees

rep.angle
String angle in degrees

rep.points
Character height in points

Description

The routine gEnqCharAttribs() returns information about the current character settings in the structure rep. The structure, which is of type GCHASTY contains the following elements:

If rep.size is returned as -1, a call to gSetCharSize() was used to set the character dimensions  and gSetPointChars() is NOT current. The working character specification is returned in rep.width, rep.height, rep.slant and rep.angle. These may differ slightly from the requested specification (see gSetPointChars(), gSetMixedChars() and gSetHardChars()). An approximate value for the current point size is also returned in rep.points.

If rep.size is returned as -2, a call to gSetCharSizePoint() was used to set the character dimensions or gSetPointChars() is current. The working character specification is returned in rep.points, rep.slant and rep.angle. This may differ slightly from the requested specification (see gSetPointChars(), gSetMixedChars() and gSetHardChars()). Approximate values are also returned in rep.width and rep.height.

If rep.size is greater than or equal to zero, gSetHardCharSize() has been used to set the current character size and orientation. The size is returned in rep.width and rep.height. rep.angle will be set to 0.0 or 90.0 and rep.slant will be set to zero. If rep.size is zero, rep.width and rep.height return the default character size.

See Also

gEnqCharAttribs Usage
gSetHardCharSize
gSetCharSize
gSetCharSizePoint
gSetCharTransformMode
gSetHardChars
gSetMixedChars
gSetPointChars
gSetSoftChars
gReturnStrInfo