Class providing a shared library of Font objects to the system. More...

Inheritance diagram for CEGUI::FontManager:

Collaboration diagram for CEGUI::FontManager:

Public Types
typedef ConstMapIterator < ObjectRegistry >	FontIterator
	ConstBaseIterator type definition.

Public Member Functions
	FontManager ()
	Constructor.

	~FontManager ()
	Destructor.

Font &	createFreeTypeFont (const String &font_name, const float point_size, const bool anti_aliased, const String &font_filename, const String &resource_group="", const AutoScaledMode auto_scaled=ASM_Disabled, const Sizef &native_res=Sizef(640.0f, 480.0f), XMLResourceExistsAction action=XREA_RETURN)
	Creates a FreeType type font. More...

Font &	createPixmapFont (const String &font_name, const String &imageset_filename, const String &resource_group="", const AutoScaledMode auto_scaled=ASM_Disabled, const Sizef &native_res=Sizef(640.0f, 480.0f), XMLResourceExistsAction action=XREA_RETURN)
	Creates a Pixmap type font. More...

void	notifyDisplaySizeChanged (const Sizef &size)
	Notify the FontManager that display size may have changed. More...

void	writeFontToStream (const String &name, OutStream &out_stream) const
	Writes a full XML font file for the specified Font to the given OutStream. More...

FontIterator	getIterator () const
	Return a FontManager::FontIterator object to iterate over the available Font objects.

Public Member Functions inherited from CEGUI::NamedXMLResourceManager< Font, Font_xmlHandler >
	NamedXMLResourceManager (const String &resource_type)
	Constructor. More...

virtual	~NamedXMLResourceManager ()
	Destructor.

Font &	createFromContainer (const RawDataContainer &source, XMLResourceExistsAction action=XREA_RETURN)
	Creates a new T object from a RawDataContainer and adds it to the collection. More...

Font &	createFromFile (const String &xml_filename, const String &resource_group="", XMLResourceExistsAction action=XREA_RETURN)
	Creates a new T object from an XML file and adds it to the collection. More...

Font &	createFromString (const String &source, XMLResourceExistsAction action=XREA_RETURN)
	Creates a new T object from a string and adds it to the collection. More...

void	destroy (const String &object_name)
	Destroy the object named object_name, or do nothing if such an object does not exist in the collection. More...

void	destroy (const Font &object)
	Destroy the object object, or do nothing if such an object does not exist in the collection. More...

void	destroyAll ()
	Destroy all objects.

Font &	get (const String &object_name) const
	Return a reference to the object named object_name. More...

bool	isDefined (const String &object_name) const
	Return whether an object named object_name exists.

void	createAll (const String &pattern, const String &resource_group)
	Create a new T object from files with names matching pattern in resource_group.

Additional Inherited Members
Static Public Member Functions inherited from CEGUI::Singleton< FontManager >
static FontManager &	getSingleton (void)

static FontManager *	getSingletonPtr (void)

Static Public Attributes inherited from CEGUI::ResourceEventSet
static const String	EventNamespace
	Namespace name for all resource managers.

static const String	EventResourceCreated

static const String	EventResourceDestroyed

static const String	EventResourceReplaced

Protected Types inherited from CEGUI::NamedXMLResourceManager< Font, Font_xmlHandler >
typedef std::map< String, Font , StringFastLessCompare CEGUI_MAP_ALLOC(String, Font )>	ObjectRegistry
	type of collection used to store and manage objects

Protected Member Functions inherited from CEGUI::NamedXMLResourceManager< Font, Font_xmlHandler >
void	destroyObject (typename ObjectRegistry::iterator ob)
	implementation of object destruction.

Font &	doExistingObjectAction (const String object_name, Font *object, const XMLResourceExistsAction action)
	function to enforce XMLResourceExistsAction policy.

virtual void	doPostObjectAdditionAction (Font &object)
	Function called each time a new object is added to the collection.

Protected Attributes inherited from CEGUI::NamedXMLResourceManager< Font, Font_xmlHandler >
const String	d_resourceType
	String holding the text for the resource type managed.

ObjectRegistry	d_objects
	the collection of objects

Static Protected Attributes inherited from CEGUI::Singleton< FontManager >
static FontManager *	ms_Singleton

Detailed Description

Class providing a shared library of Font objects to the system.

The FontManager is used to create, access, and destroy Font objects. The idea is that the FontManager will function as a central repository for Font objects used within the GUI system, and that those Font objects can be accessed, via a unique name, by any interested party within the system.

Member Function Documentation

Font& CEGUI::FontManager::createFreeTypeFont	(	const String &	font_name,
		const float	point_size,
		const bool	anti_aliased,
		const String &	font_filename,
		const String &	resource_group = `""`,
		const AutoScaledMode	auto_scaled = `ASM_Disabled`,
		const Sizef &	native_res = `Sizef(640.0f, 480.0f)`,
		XMLResourceExistsAction	action = `XREA_RETURN`
	)

Creates a FreeType type font.

Parameters

font_name	The name that the font will use within the CEGUI system.
point_size	Specifies the point size that the font is to be rendered at.
anti_aliased	Specifies whether the font should be rendered using anti aliasing.
font_filename	The filename of an font file that will be used as the source for glyph images for this font.
resource_group	The resource group identifier to use when loading the font file specified by font_filename.
auto_scaled	Specifies whether the font imagery should be automatically scaled to maintain the same physical size (which is calculated by using the native resolution setting).
native_horz_res	The horizontal native resolution value. This is only significant when auto scaling is enabled.
native_vert_res	The vertical native resolution value. This is only significant when auto scaling is enabled.
action	One of the XMLResourceExistsAction enumerated values indicating what action should be taken when a Font with the specified name already exists.

Returns: Reference to the newly create Font object.

Font& CEGUI::FontManager::createPixmapFont	(	const String &	font_name,
		const String &	imageset_filename,
		const String &	resource_group = `""`,
		const AutoScaledMode	auto_scaled = `ASM_Disabled`,
		const Sizef &	native_res = `Sizef(640.0f, 480.0f)`,
		XMLResourceExistsAction	action = `XREA_RETURN`
	)

Creates a Pixmap type font.

Parameters

font_name	The name that the font will use within the CEGUI system.
imageset_filename	The filename of an imageset to load that will be used as the source for glyph images for this font. If resource_group is the special value of "*", this parameter may instead refer to the name of an already loaded Imagset.
resource_group	The resource group identifier to use when loading the imageset file specified by imageset_filename. If this group is set to the special value of "", then imageset_filename* instead will refer to the name of an existing Imageset.
auto_scaled	Specifies whether the font imagery should be automatically scaled to maintain the same physical size (which is calculated by using the native resolution setting).
native_horz_res	The horizontal native resolution value. This is only significant when auto scaling is enabled.
native_vert_res	The vertical native resolution value. This is only significant when auto scaling is enabled.
action	One of the XMLResourceExistsAction enumerated values indicating what action should be taken when a Font with the specified name already exists.

Returns: Reference to the newly create Font object.

void CEGUI::FontManager::notifyDisplaySizeChanged ( const Sizef & size )

Notify the FontManager that display size may have changed.

Parameters

size	Size object describing the display resolution

void CEGUI::FontManager::writeFontToStream	(	const String &	name,
		OutStream &	out_stream
	)		const

Writes a full XML font file for the specified Font to the given OutStream.

Parameters

name	String holding the name of the Font to be written to the stream.
out_stream	OutStream (std::ostream based) object where data is to be sent.

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation