glcMeasureCountedString(3G) OpenGL Character Renderer
NAMEglcMeasureCountedString - store a string of specified length in
measurement buffer
C SPECIFICATION
GLint glcMeasureCountedString( GLboolean inMeasureChars,
GLint inCount,
const GLCchar *inString )
PARAMETERS
inMeasureChars Specifies whether to compute metrics only for the string
or for the characters as well.
inCount Specifies the number of elements to measure, starting at
the first element.
inString Specifies the string to be measured.
DESCRIPTIONglcMeasureCountedString is identical to glcRenderCountedString but
instead of rendering a string, the command measures the resulting layout
and stores the measurements in the GLC measurement buffer.
The string consists of the first inCount elements of the array inString.
The array does not have to be zero terminated.
If the value of inMeasureChars is GL_TRUE, glcMeasureCountedString
computes metrics for each character and for the overall string. It
assigns the value inCount to the variable GLC_MEASURED_CHARACTER_COUNT.
Otherwise, glcMeasureCountedString computes metrics only for the overall
string, and it assigns the value zero to GLC_MEASURED_CHARACTER_COUNT.
If glcMeasureCountedString does not raise an error, its return value is
the value of inMeasureChars GLC_MEASURED_CHARACTER_COUNT.
ERRORS
GLC_STATE_ERROR is generated if the issuing thread has no current GLC
context.
ASSOCIATED GETS
glcGetStringCharMetric
glcGetStringMetric
glcGeti with argument GLC_MEASURED_CHAR_COUNT
Page 1
