glutStrokeWidth man page

glutStrokeWidth — Returns the width in pixels of a character in a given font.

Library

OpenGLUT - fonts

Synopsis

#include <openglut.h>

float
glutStrokeWidth(void *fontID, int character);

Parameters


fontID


A GLUT stroked font identifier.


character


A character code.

Description

This function reports how far the model space origin will advance if you putput this


character


in the font named by


fontID.

Not all letters will use their full width, especially in fixed-width fonts.

Returns 0 if


character


is out of range or if the


fontID


is invalid.

Caveats

Historically, this function has been described as returning a pixel-width, but was implemented to return the width in model-space units, rounded to integers. GLUT never resolved this, and freeglut duplicated the confusion. OpenGLUT has decided to stay in model-space and to return the unrounded floating point value. An unreleased GLUT 3.8 was supposed to include glutStrokeWidthf() and glutStrokeLengthf() (note the *f suffixes), but that is not in wide use.

Todo

Determine if any glyphs are either wider than this function or if they render outside of the bounding box given by


(0,-descent)


by


(width,height-descent)


.

See Also

glutStrokeCharacter(3) glutStrokeLength(3) glutStrokeHeight(glutBitmapWidth) 3

 

Referenced By

glutBitmapWidth(3), glutStrokeCharacter(3), glutStrokeHeight(3), glutStrokeLength(3).