Main Page Class Hierarchy Alphabetical List Compound List File List Compound Members File Members

TextFont Class Reference

An encapsulation of a font; i.e. More...

#include <textFont.h>

Inheritance diagram for TextFont:


Public Member Functions
	TextFont ()
virtual	~TextFont ()
bool	is_valid () const
	Returns true if the font is valid and ready to use, false otherwise.
float	get_line_height () const
	Returns the number of units high each line of text is.
void	set_line_height (float line_height)
	Changes the number of units high each line of text is.
float	get_space_advance () const
	Returns the number of units wide a space is.
void	set_space_advance (float space_advance)
	Changes the number of units wide a space is.
float	calc_width (int character)
	Returns the width of a single character of the font, or 0.0 if the character is not known.
float	calc_width (const string &line)
	Returns the width of a line of text of arbitrary characters.
string	wordwrap_to (const string &text, float wordwrap_width, bool preserve_trailing_whitespace)
	Inserts newlines into the given text at the appropriate places in order to make each line be the longest possible line that is not longer than wordwrap_width (and does not break any words, if possible).
virtual void	write (ostream &out, int indent_level) const
float	calc_width (const wstring &line)
	Returns the width of a line of text of arbitrary characters.
wstring	wordwrap_to (const wstring &text, float wordwrap_width, bool preserve_trailing_whitespace)
	Inserts newlines into the given text at the appropriate places in order to make each line be the longest possible line that is not longer than wordwrap_width (and does not break any words, if possible).
virtual bool	get_glyph (int character, const TextGlyph *&glyph)=0
virtual TypeHandle	get_type () const
virtual TypeHandle	force_init_type ()
int	get_type_index () const
	Returns the internal index number associated with this object's TypeHandle, a unique number for each different type.
bool	is_of_type (TypeHandle handle) const
	Returns true if the current object is or derives from the indicated type.
bool	is_exact_type (TypeHandle handle) const
	Returns true if the current object is the indicated type exactly.
int	get_ref_count () const
	Returns the current reference count.
int	ref () const
	Explicitly increments the reference count.
int	unref () const
	Explicitly decrements the reference count.
void	test_ref_count_integrity () const
	Does some easy checks to make sure that the reference count isn't completely bogus.
void	set_name (const string &name)
void	clear_name ()
	Resets the Namable's name to empty.
bool	has_name () const
	Returns true if the Namable has a nonempty name set, false if the name is empty.
const string &	get_name () const
void	output (ostream &out) const
	Outputs the Namable.
Static Public Member Functions
TypeHandle	get_class_type ()
void	init_type ()
Protected Attributes
bool	_is_valid
float	_line_height
float	_space_advance
Static Private Attributes
TypeHandle	_type_handle

Detailed Description

An encapsulation of a font; i.e.

a set of glyphs that may be assembled together by a TextNode to represent a string of text.

This is just an abstract interface; see StaticTextFont or DynamicTextFont for an actual implementation.

Definition at line 54 of file textFont.h.

Constructor & Destructor Documentation

TextFont::TextFont ( )

Definition at line 66 of file textFont.cxx.
References _space_advance.

TextFont::~TextFont ( ) [virtual]

Definition at line 80 of file textFont.cxx.
References NULL.

Member Function Documentation

float TextFont::calc_width ( const wstring & line )

Returns the width of a line of text of arbitrary characters.
The line should not include the newline character.
Definition at line 289 of file textFont.cxx.
References calc_width(), isspacew(), nassertr, size_t, width, and wstring.

float TextFont::calc_width ( const string & line )

Returns the width of a line of text of arbitrary characters.
The line should not include the newline character.
Definition at line 123 of file textFont.cxx.
References calc_width(), and size_t.

float TextFont::calc_width ( int character )

Returns the width of a single character of the font, or 0.0 if the character is not known.

Definition at line 94 of file textFont.cxx.
References width.
Referenced by calc_width(), and write().

void Namable::clear_name ( ) [inline, inherited]

Resets the Namable's name to empty.

Definition at line 82 of file namable.I.
References Namable::_name, and INLINE.

virtual TypeHandle TextFont::force_init_type ( void ) [inline, virtual]

Reimplemented from TypedReferenceCount.
Definition at line 99 of file textFont.h.

TypeHandle TextFont::get_class_type ( void ) [inline, static]

Reimplemented from Namable.
Definition at line 88 of file textFont.h.

virtual bool TextFont::get_glyph ( int character,

const TextGlyph *& glyph

) [pure virtual]

Implemented in StaticTextFont.
Referenced by TextNode::tack_on_accent().

float TextFont::get_line_height ( ) const [inline]

Returns the number of units high each line of text is.

Definition at line 49 of file textFont.I.
References _line_height.

const string & Namable::get_name ( ) const [inline, inherited]

Definition at line 109 of file namable.I.
Referenced by ComputedVerticesMaker::add_normal(), GLGraphicsStateGuardian::begin_bind_clip_planes(), GLGraphicsStateGuardian::begin_bind_lights(), BuilderBucket::BuilderBucket(), EggVertex::clear_grefs(), AnimBundleMaker::create_xfm_channel(), SceneGraphReducer::do_flatten_siblings(), BuilderBucket::done_geom(), DXTextureContext8::DXTextureContext8(), PartGroup::find_child(), EggLoader::find_collision_geometry(), EggGroupUniquifier::get_category(), PartBundle::get_control_effect(), PartGroup::get_num_children(), EggMorph< Parameter >::get_offset(), AnimChannelBase::has_changed(), Namable::has_name(), EggMaterial::is_equivalent_to(), Texture::load(), EggLoader::make_node(), AnimBundleMaker::make_node(), FindApproxPath::Component::matches(), LineSegs::move_to(), MovingPartBase::MovingPartBase(), NodeMap::NodeMap(), EggMorph< Parameter >::operator<(), operator<<(), MouseWatcherRegion::output(), AnimGroup::output(), EggXfmSAnim::r_transform(), Texture::read(), MouseWatcherGroup::remove_region(), EggLoader::reparent_decals(), CRGraphicsStateGuardian::set_blend_mode(), NodePath::set_color(), GLGraphicsStateGuardian::set_draw_buffer(), AnimChannelScalarTable::set_table(), NodePath::set_transparency(), NodePathComponent::uncollapse(), Texture::unprepare(), TextNode::wordwrap_to(), MovingPartBase::write(), CollisionNode::xform(), and EggVertex::~EggVertex().

int ReferenceCount::get_ref_count ( ) const [inline, inherited]

Returns the current reference count.

Definition at line 183 of file referenceCount.I.
Referenced by RenderState::determine_bin_index(), RenderEffects::determine_show_bounds(), FontPool::ns_garbage_collect(), TexturePool::ns_garbage_collect(), MaterialPool::ns_get_material(), and TexturePool::ns_release_texture().

float TextFont::get_space_advance ( ) const [inline]

Returns the number of units wide a space is.

Definition at line 77 of file textFont.I.

virtual TypeHandle TextFont::get_type ( void ) const [inline, virtual]

Reimplemented from TypedReferenceCount.
Definition at line 96 of file textFont.h.

int TypedObject::get_type_index ( ) const [inline, inherited]

Returns the internal index number associated with this object's TypeHandle, a unique number for each different type.
This is equivalent to get_type().get_index().
Definition at line 71 of file typedObject.I.
References TypeHandle::get_name(), TypedObject::get_type(), and INLINE.

bool Namable::has_name ( ) const [inline, inherited]

Returns true if the Namable has a nonempty name set, false if the name is empty.

Definition at line 97 of file namable.I.
References Namable::get_name(), and INLINE.
Referenced by EggGroupUniquifier::EggGroupUniquifier(), Texture::read(), and Texture::Texture().

void TextFont::init_type ( void ) [inline, static]

Reimplemented from Namable.
Definition at line 91 of file textFont.h.

bool TypedObject::is_exact_type ( TypeHandle handle ) const [inline, inherited]

Returns true if the current object is the indicated type exactly.

Definition at line 101 of file typedObject.I.
Referenced by PT(), and CollisionNode::xform().

bool TypedObject::is_of_type ( TypeHandle handle ) const [inline, inherited]

Returns true if the current object is or derives from the indicated type.

Definition at line 86 of file typedObject.I.
Referenced by EggMaterialCollection::collapse_equivalent_materials(), EggTextureCollection::collapse_equivalent_textures(), DeferredNodeProperty::compose(), AnimBundleMaker::create_s_channel(), CharacterMaker::create_slider(), ProjectionScreen::cull_callback(), DataNode::define_output(), EggNode::determine_draw_order(), CharacterMaker::egg_to_index(), EggGroupUniquifier::EggGroupUniquifier(), EggPoolUniquifier::EggPoolUniquifier(), EggGroupNode::find_textures(), StaticTextFont::get_glyph(), EggMaterialCollection::insert_materials(), EggTextureCollection::insert_textures(), CharacterJoint::make_copy(), PT(), EggGroupNode::r_flatten_transforms(), EggGroupNode::r_transform_vertices(), EggGroupNode::recompute_polygon_normals(), CollisionLevelState::reserve(), PandaFramework::reset_frame_rate(), PandaFramework::set_texture(), EggGroupNode::steal_children(), and DataGraphTraverser::traverse().

bool TextFont::is_valid ( ) const [inline]

Returns true if the font is valid and ready to use, false otherwise.

Definition at line 34 of file textFont.I.
References _line_height, and INLINE.

void Namable::output ( ostream & out ) const [inline, inherited]

Outputs the Namable.
This function simply writes the name to the output stream; most Namable derivatives will probably redefine this.
Reimplemented in BuilderBucket, AnimBundle, AnimChannelBase, AnimChannelFixed< SwitchType >, AnimGroup, PartBundle, CollisionNode, ButtonNode, HermiteCurve, RopeNode, Fog, GeomNode, LensNode, LightLensNode, LightNode, LODNode, PandaNode, PlaneNode, MouseWatcher, and MouseWatcherRegion.
Definition at line 126 of file namable.I.

int ReferenceCount::ref ( ) const [inline, inherited]

Explicitly increments the reference count.
User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.
This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.
The return value is the new reference count.
Definition at line 225 of file referenceCount.I.
Referenced by ClientDevice::ClientDevice(), EggGroupNode::find_textures(), EggGroupNode::r_apply_texmats(), EggGroupNode::r_flatten_transforms(), and EggGroupNode::reverse_vertex_ordering().

void TextFont::set_line_height ( float line_height ) [inline]

Changes the number of units high each line of text is.

Definition at line 64 of file textFont.I.
References _space_advance, and INLINE.

void Namable::set_name ( const string & name ) [inline, inherited]

Definition at line 69 of file namable.I.
References Namable::_name.
Referenced by BuilderBucket::BuilderBucket(), SceneGraphReducer::do_flatten_siblings(), Texture::read(), PandaNode::reparent(), and Texture::Texture().

void TextFont::set_space_advance ( float space_advance ) [inline]

Changes the number of units wide a space is.

Definition at line 90 of file textFont.I.

void ReferenceCount::test_ref_count_integrity ( ) const [inline, inherited]

Does some easy checks to make sure that the reference count isn't completely bogus.

Definition at line 328 of file referenceCount.I.
References INLINE.
Referenced by EggNode::determine_bin(), and ReferenceCount::~ReferenceCount().

int ReferenceCount::unref ( ) const [inline, inherited]

Explicitly decrements the reference count.
Note that the object will not be implicitly deleted by unref() simply because the reference count drops to zero. (Having a member function delete itself is problematic; plus, we don't have a virtual destructor anyway.) However, see the helper function unref_delete().
User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.
This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.
The return value is the new reference count.
Definition at line 293 of file referenceCount.I.
References INLINE.
Referenced by RenderState::determine_bin_index(), and RenderEffects::determine_show_bounds().

wstring TextFont::wordwrap_to ( const wstring & text,

float wordwrap_width,

bool preserve_trailing_whitespace

)

Inserts newlines into the given text at the appropriate places in order to make each line be the longest possible line that is not longer than wordwrap_width (and does not break any words, if possible).
Returns the new string.
Definition at line 317 of file textFont.cxx.
References isspacew().

string TextFont::wordwrap_to ( const string & text,

float wordwrap_width,

bool preserve_trailing_whitespace

)

Inserts newlines into the given text at the appropriate places in order to make each line be the longest possible line that is not longer than wordwrap_width (and does not break any words, if possible).
Returns the new string.
Definition at line 151 of file textFont.cxx.

void TextFont::write ( ostream & out,

int indent_level

) const [virtual]

Reimplemented in StaticTextFont.
Definition at line 271 of file textFont.cxx.
References calc_width(), isspacew(), size_t, and wstring.

Member Data Documentation

bool TextFont::_is_valid [protected]

Definition at line 83 of file textFont.h.

float TextFont::_line_height [protected]

Definition at line 84 of file textFont.h.
Referenced by get_line_height(), and is_valid().

float TextFont::_space_advance [protected]

Definition at line 85 of file textFont.h.
Referenced by set_line_height(), and TextFont().

TypeHandle TextFont::_type_handle [static, private]

Reimplemented from Namable.
Definition at line 26 of file textFont.cxx.

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

panda/src/text/textFont.h
panda/src/text/textFont.cxx
panda/src/text/textFont.I

Generated on Fri May 2 00:55:26 2003 for Panda by

1.3

TextFont Class Reference

Public Member Functions

Static Public Member Functions

Protected Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation