osgText::TextBase Class Reference

Inheritance diagram for osgText::TextBase:

osg::Drawable osg::Object osg::Referenced osgText::Text osgText::Text3D osgText::FadeText

List of all members.

Public Types

enum  CharacterSizeMode { OBJECT_COORDS, SCREEN_COORDS, OBJECT_COORDS_WITH_MAXIMUM_SCREEN_SIZE_CAPPED_BY_FONT_HEIGHT }
enum  AlignmentType {
  LEFT_TOP, LEFT_CENTER, LEFT_BOTTOM, CENTER_TOP,
  CENTER_CENTER, CENTER_BOTTOM, RIGHT_TOP, RIGHT_CENTER,
  RIGHT_BOTTOM, LEFT_BASE_LINE, CENTER_BASE_LINE, RIGHT_BASE_LINE,
  LEFT_BOTTOM_BASE_LINE, CENTER_BOTTOM_BASE_LINE, RIGHT_BOTTOM_BASE_LINE, BASE_LINE = LEFT_BASE_LINE
}
enum  AxisAlignment {
  XY_PLANE, REVERSED_XY_PLANE, XZ_PLANE, REVERSED_XZ_PLANE,
  YZ_PLANE, REVERSED_YZ_PLANE, SCREEN, USER_DEFINED_ROTATION
}
enum  Layout { LEFT_TO_RIGHT, RIGHT_TO_LEFT, VERTICAL }
enum  DrawModeMask { TEXT = 1, BOUNDINGBOX = 2, ALIGNMENT = 4 }

Public Member Functions

 TextBase ()
 TextBase (const TextBase &text, const osg::CopyOp &copyop=osg::CopyOp::SHALLOW_COPY)
virtual bool isSameKindAs (const osg::Object *obj) const
virtual const char * className () const
virtual const char * libraryName () const
void setFontResolution (unsigned int width, unsigned int height)
unsigned int getFontWidth () const
unsigned int getFontHeight () const
void setText (const String &text)
void setText (const std::string &text)
void setText (const std::string &text, String::Encoding encoding)
void setText (const wchar_t *text)
StringgetText ()
const StringgetText () const
void update ()
void setCharacterSize (float height, float aspectRatio=1.0f)
float getCharacterHeight () const
float getCharacterAspectRatio () const
void setCharacterSizeMode (CharacterSizeMode mode)
CharacterSizeMode getCharacterSizeMode () const
void setMaximumWidth (float maximumWidth)
float getMaximumWidth () const
void setMaximumHeight (float maximumHeight)
float getMaximumHeight () const
void setLineSpacing (float lineSpacing)
float getLineSpacing () const
void setPosition (const osg::Vec3 &pos)
const osg::Vec3getPosition () const
void setAlignment (AlignmentType alignment)
AlignmentType getAlignment () const
void setAxisAlignment (AxisAlignment axis)
AxisAlignment getAxisAlignment () const
void setRotation (const osg::Quat &quat)
const osg::QuatgetRotation () const
void setAutoRotateToScreen (bool autoRotateToScreen)
bool getAutoRotateToScreen () const
void setLayout (Layout layout)
Layout getLayout () const
void setDrawMode (unsigned int mode)
unsigned int getDrawMode () const
void setKerningType (KerningType kerningType)
KerningType getKerningType () const
unsigned int getLineCount () const
virtual void setThreadSafeRefUnref (bool threadSafe)
virtual void resizeGLObjectBuffers (unsigned int maxSize)
virtual void releaseGLObjects (osg::State *state=0) const
virtual osg::BoundingBox computeBound () const

Protected Member Functions

virtual ~TextBase ()
void positionCursor (const osg::Vec2 &endOfLine_coords, osg::Vec2 &cursor, unsigned int linelength)
void computePositions ()
String::iterator computeLastCharacterOnLine (osg::Vec2 &cursor, String::iterator first, String::iterator last)
virtual void computePositions (unsigned int contextID) const =0
virtual void computeGlyphRepresentation ()=0

Protected Attributes

FontResolution _fontSize
float _characterHeight
float _characterAspectRatio
CharacterSizeMode _characterSizeMode
float _maximumWidth
float _maximumHeight
float _lineSpacing
String _text
osg::Vec3 _position
AlignmentType _alignment
AxisAlignment _axisAlignment
osg::Quat _rotation
bool _autoRotateToScreen
Layout _layout
unsigned int _drawMode
KerningType _kerningType
unsigned int _lineCount
osg::buffered_object
< AutoTransformCache
_autoTransformCache
osg::Vec3 _offset
osg::Vec3 _normal
osg::BoundingBox _textBB

Classes

struct  AutoTransformCache


Member Enumeration Documentation

Enumerator:
OBJECT_COORDS 
SCREEN_COORDS  default
OBJECT_COORDS_WITH_MAXIMUM_SCREEN_SIZE_CAPPED_BY_FONT_HEIGHT  internally scale the characters to be constant screen size.

text that behavaves like OBJECT_COORDS sized text when a long distance way, but has its screen sized capped automatically when the viewer gets near.

Enumerator:
LEFT_TOP 
LEFT_CENTER 
LEFT_BOTTOM 
CENTER_TOP 
CENTER_CENTER 
CENTER_BOTTOM 
RIGHT_TOP 
RIGHT_CENTER 
RIGHT_BOTTOM 
LEFT_BASE_LINE 
CENTER_BASE_LINE 
RIGHT_BASE_LINE 
LEFT_BOTTOM_BASE_LINE 
CENTER_BOTTOM_BASE_LINE 
RIGHT_BOTTOM_BASE_LINE 
BASE_LINE 

Enumerator:
XY_PLANE 
REVERSED_XY_PLANE 
XZ_PLANE 
REVERSED_XZ_PLANE 
YZ_PLANE 
REVERSED_YZ_PLANE 
SCREEN 
USER_DEFINED_ROTATION 

Enumerator:
LEFT_TO_RIGHT 
RIGHT_TO_LEFT  default
VERTICAL 

Enumerator:
TEXT 
BOUNDINGBOX  default
ALIGNMENT 


Constructor & Destructor Documentation

osgText::TextBase::TextBase (  ) 

osgText::TextBase::TextBase ( const TextBase text,
const osg::CopyOp copyop = osg::CopyOp::SHALLOW_COPY 
)

virtual osgText::TextBase::~TextBase (  )  [protected, virtual]


Member Function Documentation

virtual bool osgText::TextBase::isSameKindAs ( const osg::Object obj  )  const [inline, virtual]

Reimplemented from osg::Drawable.

Reimplemented in osgText::Text.

References NULL.

virtual const char* osgText::TextBase::className (  )  const [inline, virtual]

return the name of the object's class type. Must be defined by derived classes.

Reimplemented from osg::Drawable.

Reimplemented in osgText::Text.

virtual const char* osgText::TextBase::libraryName (  )  const [inline, virtual]

return the name of the object's library. Must be defined by derived classes. The OpenSceneGraph convention is that the namespace of a library is the same as the library name.

Reimplemented from osg::Drawable.

Reimplemented in osgText::Text.

void osgText::TextBase::setFontResolution ( unsigned int  width,
unsigned int  height 
)

Set the Font reference width and height resolution in texels. Note, the size may not be supported by current font, the closest supported font size will be selected.

unsigned int osgText::TextBase::getFontWidth (  )  const [inline]

unsigned int osgText::TextBase::getFontHeight (  )  const [inline]

void osgText::TextBase::setText ( const String text  ) 

Set the text using a osgText::String.

void osgText::TextBase::setText ( const std::string &  text  ) 

Set the text using a std::string, which is converted to an internal TextString.

void osgText::TextBase::setText ( const std::string &  text,
String::Encoding  encoding 
)

Set the text using a Unicode encoded std::string, which is converted to an internal TextString. The encoding parameter specificies which Unicode encodeding is used in the std::string.

void osgText::TextBase::setText ( const wchar_t *  text  ) 

Set the text using a wchar_t string, which is converted to an internal TextString.

String& osgText::TextBase::getText (  )  [inline]

Get the text string. Note, if you modify the string you must call Text::update() for the internal glyph reprentation to be updated.

const String& osgText::TextBase::getText (  )  const [inline]

Get the const text string.

void osgText::TextBase::update (  )  [inline]

update internal glyph respresentation used for rendering, and bounding volume.

void osgText::TextBase::setCharacterSize ( float  height,
float  aspectRatio = 1.0f 
)

Set the rendered character size in object coordinates.

float osgText::TextBase::getCharacterHeight (  )  const [inline]

float osgText::TextBase::getCharacterAspectRatio (  )  const [inline]

void osgText::TextBase::setCharacterSizeMode ( CharacterSizeMode  mode  )  [inline]

Set how the CharacterSize value relates to the final rendered character.

CharacterSizeMode osgText::TextBase::getCharacterSizeMode (  )  const [inline]

Get the CharacterSizeMode.

void osgText::TextBase::setMaximumWidth ( float  maximumWidth  ) 

Set the maximum width of the text box. With horizontal layouts any characters which do not fit are wrapped around. 0 or negative values indicate that no maximum width is set, lines can be as long as they need be to fit thre required text

float osgText::TextBase::getMaximumWidth (  )  const [inline]

Get the maximim width of the text box.

void osgText::TextBase::setMaximumHeight ( float  maximumHeight  ) 

Set the maximum height of the text box. With horizontal layouts any characters which do not fit are wrapped around. 0 or negative values indicate that no maximum height is set, lines can be as long as they need be to fit the required text

float osgText::TextBase::getMaximumHeight (  )  const [inline]

Get the maximum height of the text box.

void osgText::TextBase::setLineSpacing ( float  lineSpacing  ) 

Set the line spacing of the text box, given as a percentage of the character height. The default value is 0 for backward compatibility. For longer paragraphs of text, a value of at least 25% (i.e. set line spacing to 0.25) is recommended.

float osgText::TextBase::getLineSpacing (  )  const [inline]

Get the line spacing of the text box.

void osgText::TextBase::setPosition ( const osg::Vec3 pos  ) 

Set the position of text.

const osg::Vec3& osgText::TextBase::getPosition (  )  const [inline]

Get the position of text.

void osgText::TextBase::setAlignment ( AlignmentType  alignment  ) 

AlignmentType osgText::TextBase::getAlignment (  )  const [inline]

void osgText::TextBase::setAxisAlignment ( AxisAlignment  axis  ) 

AxisAlignment osgText::TextBase::getAxisAlignment (  )  const [inline]

void osgText::TextBase::setRotation ( const osg::Quat quat  ) 

const osg::Quat& osgText::TextBase::getRotation (  )  const [inline]

void osgText::TextBase::setAutoRotateToScreen ( bool  autoRotateToScreen  ) 

bool osgText::TextBase::getAutoRotateToScreen (  )  const [inline]

void osgText::TextBase::setLayout ( Layout  layout  ) 

Layout osgText::TextBase::getLayout (  )  const [inline]

void osgText::TextBase::setDrawMode ( unsigned int  mode  ) 

unsigned int osgText::TextBase::getDrawMode (  )  const [inline]

void osgText::TextBase::setKerningType ( KerningType  kerningType  )  [inline]

KerningType osgText::TextBase::getKerningType (  )  const [inline]

unsigned int osgText::TextBase::getLineCount (  )  const [inline]

Get the number of wrapped lines - only valid after computeGlyphRepresentation() has been called, returns 0 otherwise

virtual void osgText::TextBase::setThreadSafeRefUnref ( bool  threadSafe  )  [virtual]

Set whether to use a mutex to ensure ref() and unref() are thread safe.

Reimplemented from osg::Drawable.

Reimplemented in osgText::Text, and osgText::Text3D.

virtual void osgText::TextBase::resizeGLObjectBuffers ( unsigned int  maxSize  )  [virtual]

Resize any per context GLObject buffers to specified size.

Reimplemented from osg::Drawable.

Reimplemented in osgText::Text, and osgText::Text3D.

virtual void osgText::TextBase::releaseGLObjects ( osg::State state = 0  )  const [virtual]

If State is non-zero, this function releases OpenGL objects for the specified graphics context. Otherwise, releases OpenGL objexts for all graphics contexts.

Reimplemented from osg::Drawable.

Reimplemented in osgText::Text, and osgText::Text3D.

virtual osg::BoundingBox osgText::TextBase::computeBound (  )  const [virtual]

Compute the bounding box around Drawables's geometry.

Reimplemented from osg::Drawable.

void osgText::TextBase::positionCursor ( const osg::Vec2 endOfLine_coords,
osg::Vec2 cursor,
unsigned int  linelength 
) [protected]

void osgText::TextBase::computePositions (  )  [protected]

String::iterator osgText::TextBase::computeLastCharacterOnLine ( osg::Vec2 cursor,
String::iterator  first,
String::iterator  last 
) [protected]

Reimplemented in osgText::Text, and osgText::Text3D.

virtual void osgText::TextBase::computePositions ( unsigned int  contextID  )  const [protected, pure virtual]

Implemented in osgText::Text, and osgText::Text3D.

virtual void osgText::TextBase::computeGlyphRepresentation (  )  [protected, pure virtual]

Implemented in osgText::Text, and osgText::Text3D.


Member Data Documentation

unsigned int osgText::TextBase::_drawMode [protected]

unsigned int osgText::TextBase::_lineCount [protected]

osg::Vec3 osgText::TextBase::_offset [mutable, protected]

osg::Vec3 osgText::TextBase::_normal [mutable, protected]


The documentation for this class was generated from the following file:

Generated on Wed Aug 13 17:03:41 2008 for openscenegraph by  doxygen 1.5.6