Crazy Eddie's GUI System  0.8.4
CEGUI::PixmapFont Class Reference

Implementation of the Font class interface using static Imageset's. More...

+ Inheritance diagram for CEGUI::PixmapFont:
+ Collaboration diagram for CEGUI::PixmapFont:

List of all members.

Public Member Functions

 PixmapFont (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))
 Constructor for Pixmap type fonts.
 ~PixmapFont ()
 Destructor.
void defineMapping (const utf32 codepoint, const String &image_name, const float horz_advance)
void defineMapping (const String &value)
const StringgetImageNamePrefix () const
 Return the image name prefix that the font is using for it's glyphs.
void setImageNamePrefix (const String &name_prefix)
 Set image name prefix font should use for it's glyphs.

Protected Member Functions

void reinit ()
 Initialize the imageset.
void addPixmapFontProperties ()
 Register all properties of this class.
void updateFont ()
 Update the font as needed, according to the current parameters.
void writeXMLToStream_impl (XMLSerializer &xml_stream) const
 implementaion version of writeXMLToStream.

Protected Attributes

String d_imageNamePrefix
 The Image name prefix used for the glyphs.
float d_origHorzScaling
 Current X scaling for glyph images.
bool d_imagesetOwner
 true if we own the imageset

Detailed Description

Implementation of the Font class interface using static Imageset's.

To create such a font you must create a Imageset with all the glyphs, and then define individual glyphs via defineMapping.


Constructor & Destructor Documentation

CEGUI::PixmapFont::PixmapFont ( 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) 
)

Constructor for Pixmap type fonts.

Parameters:
font_nameThe name that the font will use within the CEGUI system.
imageset_filenameThe 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_groupThe 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_scaledSpecifies 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_resThe horizontal native resolution value. This is only significant when auto scaling is enabled.
native_vert_resThe vertical native resolution value. This is only significant when auto scaling is enabled.

Member Function Documentation

void CEGUI::PixmapFont::setImageNamePrefix ( const String name_prefix)

Set image name prefix font should use for it's glyphs.

This will potentially cause existing images to be destroyed (if they were created specifically by, and for, this Font). Images using the new name prefix must already exist within the system.

Parameters:
name_prefixName prefix used by an existing set of images to be used as the glyph source for this Font.
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Friends