openscenegraph
Classes | Public Types | Public Member Functions | Static Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes | Friends | List of all members
osgText::Font Class Reference
Inheritance diagram for osgText::Font:
osg::Object osg::Referenced

Classes

class  FontImplementation
 

Public Types

typedef std::vector< osg::ref_ptr< osg::StateSet > > StateSets
 
typedef OpenThreads::Mutex FontMutex
 
typedef std::vector< osg::ref_ptr< GlyphTexture > > GlyphTextureList
 
- Public Types inherited from osg::Object
enum  DataVariance { DYNAMIC , STATIC , UNSPECIFIED }
 

Public Member Functions

 Font (FontImplementation *implementation=0)
 
virtual osg::Object * cloneType () const
 
virtual osg::Object * clone (const osg::CopyOp &) const
 
virtual bool isSameKindAs (const osg::Object *obj) const
 
virtual const char * className () const
 
virtual const char * libraryName () const
 
virtual std::string getFileName () const
 
StateSets & getCachedStateSets ()
 
const StateSets & getCachedStateSets () const
 
virtual osg::Vec2 getKerning (const FontResolution &fontRes, unsigned int leftcharcode, unsigned int rightcharcode, KerningType kerningType)
 
virtual Glyph * getGlyph (const FontResolution &fontSize, unsigned int charcode)
 
virtual Glyph3D * getGlyph3D (const FontResolution &fontSize, unsigned int charcode)
 
virtual bool hasVertical () const
 
virtual bool getVerticalSize (float &ascender, float &descender) const
 
void setTextureSizeHint (unsigned int width, unsigned int height)
 
unsigned int getTextureWidthHint () const
 
unsigned int getTextureHeightHint () const
 
void setMinFilterHint (osg::Texture::FilterMode mode)
 
osg::Texture::FilterMode getMinFilterHint () const
 
void setMagFilterHint (osg::Texture::FilterMode mode)
 
osg::Texture::FilterMode getMagFilterHint () const
 
void setMaxAnisotropy (float anis)
 
float getMaxAnisotropy () const
 
unsigned int getFontDepth () const
 
void setNumberCurveSamples (unsigned int numSamples)
 
unsigned int getNumberCurveSamples () const
 
void setImplementation (FontImplementation *implementation)
 
FontImplementation * getImplementation ()
 
const FontImplementation * getImplementation () const
 
virtual void setThreadSafeRefUnref (bool threadSafe)
 
virtual void resizeGLObjectBuffers (unsigned int maxSize)
 
virtual void releaseGLObjects (osg::State *state=0) const
 
GlyphTextureList & getGlyphTextureList ()
 
void assignGlyphToGlyphTexture (Glyph *glyph, ShaderTechnique shaderTechnique)
 
- Public Member Functions inherited from osg::Object
 Object ()
 
 Object (bool threadSafeRefUnref)
 
 Object (const Object &, const CopyOp &copyop=CopyOp::SHALLOW_COPY)
 
virtual Object * cloneType () const =0
 
virtual Object * clone (const CopyOp &) const =0
 
virtual bool isSameKindAs (const Object *) const
 
virtual const char * libraryName () const =0
 
virtual const char * className () const =0
 
std::string getCompoundClassName () const
 
virtual Node * asNode ()
 
virtual const Node * asNode () const
 
virtual NodeVisitor * asNodeVisitor ()
 
virtual const NodeVisitor * asNodeVisitor () const
 
virtual StateSet * asStateSet ()
 
virtual const StateSet * asStateSet () const
 
virtual StateAttribute * asStateAttribute ()
 
virtual const StateAttribute * asStateAttribute () const
 
virtual Uniform * asUniform ()
 
virtual const Uniform * asUniform () const
 
virtual Camera * asCamera ()
 
virtual const Camera * asCamera () const
 
virtual Drawable * asDrawable ()
 
virtual const Drawable * asDrawable () const
 
virtual Callback * asCallback ()
 
virtual const Callback * asCallback () const
 
virtual CallbackObject * asCallbackObject ()
 
virtual const CallbackObject * asCallbackObject () const
 
virtual UserDataContainer * asUserDataContainer ()
 
virtual const UserDataContainer * asUserDataContainer () const
 
virtual ValueObject * asValueObject ()
 
virtual const ValueObject * asValueObject () const
 
virtual Image * asImage ()
 
virtual const Image * asImage () const
 
virtual void setThreadSafeRefUnref (bool threadSafe)
 
virtual void setName (const std::string &name)
 
void setName (const char *name)
 
const std::string & getName () const
 
void setDataVariance (DataVariance dv)
 
DataVariance getDataVariance () const
 
virtual void computeDataVariance ()
 
void setUserDataContainer (osg::UserDataContainer *udc)
 
template<class T >
void setUserDataContainer (const ref_ptr< T > &udc)
 
osg::UserDataContainer * getUserDataContainer ()
 
const osg::UserDataContainer * getUserDataContainer () const
 
osg::UserDataContainer * getOrCreateUserDataContainer ()
 
virtual void setUserData (Referenced *obj)
 
template<class T >
void setUserData (const ref_ptr< T > &ud)
 
virtual Referenced * getUserData ()
 
virtual const Referenced * getUserData () const
 
template<typename T >
bool getUserValue (const std::string &name, T &value) const
 
template<typename T >
void setUserValue (const std::string &name, const T &value)
 
virtual void resizeGLObjectBuffers (unsigned int)
 
virtual void releaseGLObjects (osg::State *=0) const
 
template<typename T >
BoolValueObject UCharValueObject UShortValueObject UIntValueObject DoubleValueObject Vec3fValueObject Vec2dValueObject Vec4dValueObject PlaneValueObject MatrixdValueObject BoundingBoxdValueObject BoundingSpheredValueObject bool getUserValue (const std::string &name, T &value) const
 
- Public Member Functions inherited from osg::Referenced
 Referenced ()
 
 Referenced (bool threadSafeRefUnref)
 
 Referenced (const Referenced &)
 
Referenced & operator= (const Referenced &)
 
virtual void setThreadSafeRefUnref (bool)
 
bool getThreadSafeRefUnref () const
 
OpenThreads::Mutex * getRefMutex () const
 
int ref () const
 
int unref () const
 
int unref_nodelete () const
 
int referenceCount () const
 
ObserverSet * getObserverSet () const
 
ObserverSet * getOrCreateObserverSet () const
 
void addObserver (Observer *observer) const
 
void removeObserver (Observer *observer) const
 

Static Public Member Functions

static osg::ref_ptr< Font > getDefaultFont ()
 
- Static Public Member Functions inherited from osg::Referenced
static OpenThreads::Mutex * getGlobalReferencedMutex ()
 
static void setDeleteHandler (DeleteHandler *handler)
 
static DeleteHandler * getDeleteHandler ()
 

Protected Types

typedef std::map< unsigned int, osg::ref_ptr< Glyph > > GlyphMap
 
typedef std::map< unsigned int, osg::ref_ptr< Glyph3D > > Glyph3DMap
 
typedef std::map< FontResolution, GlyphMap > FontSizeGlyphMap
 
typedef std::map< FontResolution, Glyph3DMap > FontSizeGlyph3DMap
 

Protected Member Functions

virtual ~Font ()
 
void addGlyph (const FontResolution &fontRes, unsigned int charcode, Glyph *glyph)
 
- Protected Member Functions inherited from osg::Object
virtual ~Object ()
 
- Protected Member Functions inherited from osg::Referenced
virtual ~Referenced ()
 
void signalObserversAndDelete (bool signalDelete, bool doDelete) const
 
void deleteUsingDeleteHandler () const
 

Protected Attributes

OpenThreads::Mutex _glyphMapMutex
 
StateSets _statesets
 
FontSizeGlyphMap _sizeGlyphMap
 
GlyphTextureList _glyphTextureList
 
FontSizeGlyph3DMap _sizeGlyph3DMap
 
FontResolution _fontSize
 
unsigned int _textureWidthHint
 
unsigned int _textureHeightHint
 
osg::Texture::FilterMode _minFilterHint
 
osg::Texture::FilterMode _magFilterHint
 
float _maxAnisotropy
 
unsigned int _depth
 
unsigned int _numCurveSamples
 
osg::ref_ptr< FontImplementation > _implementation
 
- Protected Attributes inherited from osg::Object
std::string _name
 
DataVariance _dataVariance
 
osg::UserDataContainer * _userDataContainer
 
- Protected Attributes inherited from osg::Referenced
OpenThreads::AtomicPtr _observerSet
 
OpenThreads::Atomic _refCount
 

Friends

class FontImplementation
 

Detailed Description

Pure virtual base class for fonts. Concrete implementation are the DefaultFont found in src/osgText/DefaultFont.cpp and FreeTypeFont found in src/osgPlugins/freetype/FreeTypeFont.cpp

Member Typedef Documentation

◆ FontMutex

◆ FontSizeGlyph3DMap

◆ FontSizeGlyphMap

◆ Glyph3DMap

typedef std::map< unsigned int, osg::ref_ptr<Glyph3D> > osgText::Font::Glyph3DMap
protected

◆ GlyphMap

typedef std::map< unsigned int, osg::ref_ptr<Glyph> > osgText::Font::GlyphMap
protected

◆ GlyphTextureList

◆ StateSets

Constructor & Destructor Documentation

◆ Font()

osgText::Font::Font ( FontImplementation *  implementation = 0)

◆ ~Font()

virtual osgText::Font::~Font ( )
protectedvirtual

Member Function Documentation

◆ addGlyph()

void osgText::Font::addGlyph ( const FontResolution &  fontRes,
unsigned int  charcode,
Glyph *  glyph 
)
protected

◆ assignGlyphToGlyphTexture()

void osgText::Font::assignGlyphToGlyphTexture ( Glyph *  glyph,
ShaderTechnique  shaderTechnique 
)

◆ className()

virtual const char * osgText::Font::className ( ) const
inlinevirtual

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

Implements osg::Object.

◆ clone()

virtual osg::Object * osgText::Font::clone ( const osg::CopyOp &  ) const
inlinevirtual

Clone an object, with Object* return type. Must be defined by derived classes.

Implements osg::Object.

◆ cloneType()

virtual osg::Object * osgText::Font::cloneType ( ) const
inlinevirtual

Clone the type of an object, with Object* return type. Must be defined by derived classes.

Implements osg::Object.

◆ getCachedStateSets() [1/2]

StateSets & osgText::Font::getCachedStateSets ( )
inline

◆ getCachedStateSets() [2/2]

const StateSets & osgText::Font::getCachedStateSets ( ) const
inline

◆ getDefaultFont()

static osg::ref_ptr< Font > osgText::Font::getDefaultFont ( )
static

◆ getFileName()

virtual std::string osgText::Font::getFileName ( ) const
virtual

◆ getFontDepth()

unsigned int osgText::Font::getFontDepth ( ) const
inline

◆ getGlyph()

virtual Glyph * osgText::Font::getGlyph ( const FontResolution &  fontSize,
unsigned int  charcode 
)
virtual

Get a Glyph for specified charcode, and the font size nearest to the current font size hint.

◆ getGlyph3D()

virtual Glyph3D * osgText::Font::getGlyph3D ( const FontResolution &  fontSize,
unsigned int  charcode 
)
virtual

Get a Glyph3D for specified charcode and a font size.

◆ getGlyphTextureList()

GlyphTextureList & osgText::Font::getGlyphTextureList ( )
inline

◆ getImplementation() [1/2]

FontImplementation * osgText::Font::getImplementation ( )

◆ getImplementation() [2/2]

const FontImplementation * osgText::Font::getImplementation ( ) const

◆ getKerning()

virtual osg::Vec2 osgText::Font::getKerning ( const FontResolution &  fontRes,
unsigned int  leftcharcode,
unsigned int  rightcharcode,
KerningType  kerningType 
)
virtual

Get a kerning (adjustment of spacing of two adjacent character) for specified charcodes and a font resolution.

◆ getMagFilterHint()

osg::Texture::FilterMode osgText::Font::getMagFilterHint ( ) const

◆ getMaxAnisotropy()

float osgText::Font::getMaxAnisotropy ( ) const
inline

◆ getMinFilterHint()

osg::Texture::FilterMode osgText::Font::getMinFilterHint ( ) const

◆ getNumberCurveSamples()

unsigned int osgText::Font::getNumberCurveSamples ( ) const
inline

◆ getTextureHeightHint()

unsigned int osgText::Font::getTextureHeightHint ( ) const

◆ getTextureWidthHint()

unsigned int osgText::Font::getTextureWidthHint ( ) const

◆ getVerticalSize()

virtual bool osgText::Font::getVerticalSize ( float &  ascender,
float &  descender 
) const
inlinevirtual

Get the ascender and descender sizes of the font where supported by the FontImplementation, return true on success, return false when not supported.

◆ hasVertical()

virtual bool osgText::Font::hasVertical ( ) const
virtual

Return true if this font provides vertical alignments and spacing or glyphs.

◆ isSameKindAs()

virtual bool osgText::Font::isSameKindAs ( const osg::Object *  obj) const
inlinevirtual

Reimplemented from osg::Object.

◆ libraryName()

virtual const char * osgText::Font::libraryName ( ) const
inlinevirtual

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.

Implements osg::Object.

◆ releaseGLObjects()

virtual void osgText::Font::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::Object.

◆ resizeGLObjectBuffers()

virtual void osgText::Font::resizeGLObjectBuffers ( unsigned int  maxSize)
virtual

Resize any per context GLObject buffers to specified size.

Reimplemented from osg::Object.

◆ setImplementation()

void osgText::Font::setImplementation ( FontImplementation *  implementation)

◆ setMagFilterHint()

void osgText::Font::setMagFilterHint ( osg::Texture::FilterMode  mode)

Set the magnification texture filter to use when creating the texture to store the glyph images when rendering. Note, this doesn't affect already created Texture Glhph's.

◆ setMaxAnisotropy()

void osgText::Font::setMaxAnisotropy ( float  anis)
inline

◆ setMinFilterHint()

void osgText::Font::setMinFilterHint ( osg::Texture::FilterMode  mode)

Set the minification texture filter to use when creating the texture to store the glyph images when rendering. Note, this doesn't affect already created Texture Glhph's.

◆ setNumberCurveSamples()

void osgText::Font::setNumberCurveSamples ( unsigned int  numSamples)
inline

◆ setTextureSizeHint()

void osgText::Font::setTextureSizeHint ( unsigned int  width,
unsigned int  height 
)

Set the size of texture to create to store the glyph images when rendering. Note, this doesn't affect already created Texture Glhph's.

◆ setThreadSafeRefUnref()

virtual void osgText::Font::setThreadSafeRefUnref ( bool  threadSafe)
virtual

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

Reimplemented from osg::Object.

Friends And Related Function Documentation

◆ FontImplementation

friend class FontImplementation
friend

Member Data Documentation

◆ _depth

unsigned int osgText::Font::_depth
protected

◆ _fontSize

FontResolution osgText::Font::_fontSize
protected

◆ _glyphMapMutex

OpenThreads::Mutex osgText::Font::_glyphMapMutex
mutableprotected

◆ _glyphTextureList

GlyphTextureList osgText::Font::_glyphTextureList
protected

◆ _implementation

osg::ref_ptr<FontImplementation> osgText::Font::_implementation
protected

◆ _magFilterHint

osg::Texture::FilterMode osgText::Font::_magFilterHint
protected

◆ _maxAnisotropy

float osgText::Font::_maxAnisotropy
protected

◆ _minFilterHint

osg::Texture::FilterMode osgText::Font::_minFilterHint
protected

◆ _numCurveSamples

unsigned int osgText::Font::_numCurveSamples
protected

◆ _sizeGlyph3DMap

FontSizeGlyph3DMap osgText::Font::_sizeGlyph3DMap
protected

◆ _sizeGlyphMap

FontSizeGlyphMap osgText::Font::_sizeGlyphMap
protected

◆ _statesets

StateSets osgText::Font::_statesets
protected

◆ _textureHeightHint

unsigned int osgText::Font::_textureHeightHint
protected

◆ _textureWidthHint

unsigned int osgText::Font::_textureWidthHint
protected

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