glcmeasurecountedstring()



glcMeasureCountedString(3G)                          OpenGL Character Renderer



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 GLTRUE, glcMeasureCountedString
     computes metrics for each character and for the overall string. It
     assigns the value inCount to the variable GLCMEASUREDCHARACTERCOUNT.
     Otherwise, glcMeasureCountedString computes metrics only for the overall
     string, and it assigns the value zero to GLCMEASUREDCHARACTERCOUNT.

     If glcMeasureCountedString does not raise an error, its return value is
     the value of inMeasureChars GLCMEASUREDCHARACTERCOUNT.

ERRORS
     GLCSTATEERROR is generated if the issuing thread has no current GLC
     context.

ASSOCIATED GETS
     glcGetStringCharMetric
     glcGetStringMetric
     glcGeti with argument GLCMEASUREDCHARCOUNT










                                                                        Page 1
Museum
