GINO Graphics Suite - GINO v9.0  

gSetHardCharSize

Syntax

[C/C++:]
void gSetHardCharSize(int nsize, int nhv);
[F90:]
subroutine gSetHardCharSize(nsize, nhv)
integer, intent(in) :: nsize,nhv

Arguments

nsize
Hardware character size index

= 0, Default character size

nhv
Hardware character orientation

= GHORIZ, Horizontal (0 degrees)
= GVERT, Vertical (90 degrees)

Description

The routine gSetHardCharSize() is used to select hardware characters on older devices that only had a preset number of sizes available.  It selects a hardware character size and orientation according to the values in nsize and nhv. If nsize is less than zero, a warning message is output and the absolute value of nsize is used to determine the character size.

The character size should be converted by the device driver into an actual character width and height. This can subsequently be enquired by calling gEnqCharAttribs(). Even if the device cannot generate characters as requested, the device driver may still carry out the conversion. GINO will then generate characters with a size suited to the device (pseudo-hardware character generation). If no response is obtained from the device driver, the current character size is set to the default character size. Available hardware character sizes for each device are given in Appendix B.

A call to gSetHardCharSize() overrides the combined effect of any calls to gSetHardChars(), gSetMixedChars(), gSetSoftChars(), gSetCharTransformMode(), gSetCharSize(), gSetStrAngle() or gSetItalicAngle(). gSetHardCharSize() will remain in effect until any one of these routines is called.

See Also

gSetHardCharSize Usage
Device Drivers
gSetStrAngle
gEnqCharAttribs
gSetCharSize
gSetCharTransformMode
gSetHardChars
gSetItalicAngle
gSetMixedChars
gSetSoftChars