glcMeasureCountedString(3G)

NAME
     glcMeasureCountedString - 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.

DESCRIPTION
     glcMeasureCountedString 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