#include <include/Inventor/misc/SoGlyph.h>
SoGlyph is the public interface all text nodes (both built-in and extensions) should use to generate bitmaps and outlines for font glyphs. It maintains an internal cache of previously requested glyphs to avoid needless calls into the font library.
Primer: a glyph is the graphical representation of a given character of a given font at a given size and orientation. It can be either a bitmap (pixel aligned with the viewport) or an outline (polygonal representation) that can be transformed or extruded like any other 3D geometry. Bitmaps are used by SoText2, while the other text nodes uses outlines.
Be aware that this class is an extension for Coin, and it is not available in the original SGI Open Inventor v2.1 API.
Public Member Functions | |
void | unref (void) const |
const SbVec2f * | getCoords (void) const |
const int * | getFaceIndices (void) const |
const int * | getEdgeIndices (void) const |
const int * | getNextCWEdge (const int edgeidx) const |
const int * | getNextCCWEdge (const int edgeidx) const |
float | getWidth (void) const |
const SbBox2f & | getBoundingBox (void) const |
SbVec2s | getAdvance (void) const |
SbVec2s | getKerning (const SoGlyph &rightglyph) const |
unsigned char * | getBitmap (SbVec2s &size, SbVec2s &pos, const SbBool antialiased) const |
Static Public Member Functions | |
const SoGlyph * | getGlyph (const char character, const SbName &font) |
const SoGlyph * | getGlyph (SoState *state, const unsigned int character, const SbVec2s &size, const float angle) |
Protected Member Functions | |
SoGlyph (void) | |
~SoGlyph () | |
void | setCoords (SbVec2f *coords, int numcoords=-1) |
void | setFaceIndices (int *indices, int numindices=-1) |
void | setEdgeIndices (int *indices, int numindices=-1) |
|
Constructor. |
|
Destructor. |
|
Should be called when a node no longer will use a glyph. Will free memory used by this glyph when it is no longer used by any node. |
|
Returns a character of the specified font, suitable for polygonal rendering. |
|
Returns coordinates for this glyph. |
|
Returns face indices for this glyph. |
|
Returns edge indices for this glyph. |
|
Returns a pointer to the next clockwise edge. Returns NULL if none could be found. |
|
Returns a pointer to the next counter clockwise edge. NULL if none could be found. |
|
Convenience method which returns the exact width of the glyph. |
|
Returns the bounding box of this glyph. This value is cached for performance. |
|
Returns a character of the specified font, suitable for bitmap rendering. The size parameter overrides state's SoFontSizeElement (if != SbVec2s(0,0)) |
|
Bitmap for glyph. size and pos are return parameters. Antialiased bitmap graphics not yet supported.
Note that this function may return |
|
Sets the coordinates for this glyph. If numcoords > 0, the data will be copied before returing. If numcoords <= 0, coords will be used directly. |
|
Sets the face indices for this glyph. If numindices > 0, the data will be copied before returning. If numcoords <= 0, indices will be used directly. |
|
Sets the edge indices for this glyph. If numindices > 0, the data will be copied before returning. If numcoords <= 0, indices will be used directly. |