Crazy Eddies GUI System  0.7.2
Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes | List of all members
CEGUI::FreeTypeFont Class Reference

Implementation of the Font class interface using the FreeType library. More...

+ Inheritance diagram for CEGUI::FreeTypeFont:
+ Collaboration diagram for CEGUI::FreeTypeFont:

Public Member Functions

 FreeTypeFont (const String &font_name, const float point_size, const bool anti_aliased, const String &font_filename, const String &resource_group="", const bool auto_scaled=false, const float native_horz_res=640.0f, const float native_vert_res=480.0f, const float specific_line_spacing=0.0f)
 Constructor for FreeTypeFont based fonts. More...
 
 ~FreeTypeFont ()
 Destructor.
 
float getPointSize () const
 return the point size of the freetype font.
 
bool isAntiAliased () const
 return whether the freetype font is rendered anti-aliased.
 
void setPointSize (const float point_size)
 return the point size of the freetype font.
 
void setAntiAliased (const bool anti_alaised)
 return whether the freetype font is rendered anti-aliased.
 
- Public Member Functions inherited from CEGUI::Font
virtual ~Font ()
 Destructor.
 
const StringgetName () const
 Return the string holding the font name.
 
const StringgetTypeName () const
 Return the type of the font.
 
bool isCodepointAvailable (utf32 cp) const
 Return whether this Font can draw the specified code-point. More...
 
void drawText (GeometryBuffer &buffer, const String &text, const Vector2 &position, const Rect *clip_rect, const ColourRect &colours, const float space_extra=0.0f, const float x_scale=1.0f, const float y_scale=1.0f)
 Draw text into a specified area of the display. More...
 
void setNativeResolution (const Size &size)
 Set the native resolution for this Font. More...
 
Size getNativeResolution () const
 Return the native display size for this Font. This is only relevant if the Font is being auto-scaled. More...
 
void setAutoScaled (const bool auto_scaled)
 Enable or disable auto-scaling for this Font. More...
 
bool isAutoScaled () const
 Return whether this Font is auto-scaled. More...
 
virtual void notifyDisplaySizeChanged (const Size &size)
 Notify the Font that the display size may have changed. More...
 
float getLineSpacing (float y_scale=1.0f) const
 Return the pixel line spacing value for. More...
 
float getFontHeight (float y_scale=1.0f) const
 return the exact pixel height of the font. More...
 
float getBaseline (float y_scale=1.0f) const
 Return the number of pixels from the top of the highest glyph to the baseline. More...
 
float getTextExtent (const String &text, float x_scale=1.0f) const
 Return the pixel width of the specified text if rendered with this Font. More...
 
size_t getCharAtPixel (const String &text, float pixel, float x_scale=1.0f) const
 Return the index of the closest text character in String text that corresponds to pixel location pixel if the text were rendered. More...
 
size_t getCharAtPixel (const String &text, size_t start_char, float pixel, float x_scale=1.0f) const
 Return the index of the closest text character in String text, starting at character index start_char, that corresponds to pixel location pixel if the text were to be rendered. More...
 
void writeXMLToStream (XMLSerializer &xml_stream) const
 Writes an xml representation of this Font to out_stream. More...
 
const FontGlyphgetGlyphData (utf32 codepoint) const
 Return a pointer to the glyphDat struct for the given codepoint, or 0 if the codepoint does not have a glyph defined. More...
 
- Public Member Functions inherited from CEGUI::PropertySet
 PropertySet (void)
 Constructs a new PropertySet object.
 
virtual ~PropertySet (void)
 Destructor for PropertySet objects.
 
void addProperty (Property *property)
 Adds a new Property to the PropertySet. More...
 
void removeProperty (const String &name)
 Removes a Property from the PropertySet. More...
 
void clearProperties (void)
 Removes all Property objects from the PropertySet. More...
 
bool isPropertyPresent (const String &name) const
 Checks to see if a Property with the given name is in the PropertySet. More...
 
const StringgetPropertyHelp (const String &name) const
 Return the help text for the specified Property. More...
 
String getProperty (const String &name) const
 Gets the current value of the specified Property. More...
 
void setProperty (const String &name, const String &value)
 Sets the current value of a Property. More...
 
bool isPropertyDefault (const String &name) const
 Returns whether a Property is at it's default value. More...
 
String getPropertyDefault (const String &name) const
 Returns the default value of a Property as a String. More...
 
Iterator getIterator (void) const
 Return a PropertySet::Iterator object to iterate over the available Properties.
 

Protected Types

typedef std::vector< Imageset * > ImagesetVector
 Type definition for ImagesetVector.
 
- Protected Types inherited from CEGUI::Font
typedef std::map< utf32,
FontGlyph
CodepointMap
 Definition of CodepointMap type.
 

Protected Member Functions

void drawGlyphToBuffer (argb_t *buffer, uint buf_width) const
 Copy the current glyph data into buffer, which has a width of buf_width pixels (not bytes). More...
 
uint getTextureSize (CodepointMap::const_iterator s, CodepointMap::const_iterator e) const
 Return the required texture size required to store imagery for the glyphs from s to e. More...
 
void addFreeTypeFontProperties ()
 Register all properties of this class.
 
void free ()
 Free all allocated font data.
 
void rasterise (utf32 start_codepoint, utf32 end_codepoint) const
 This function prepares a certain range of glyphs to be ready for displaying. This means that after returning from this function glyphs from d_cp_map[start_codepoint] to d_cp_map[end_codepoint] should have their d_image member set. If there is an error during rasterisation of some glyph, it's okay to leave the d_image field set to NULL, in which case such glyphs will be skipped from display. More...
 
void updateFont ()
 Update the font as needed, according to the current parameters.
 
void writeXMLToStream_impl (XMLSerializer &xml_stream) const
 implementaion version of writeXMLToStream.
 
- Protected Member Functions inherited from CEGUI::Font
 Font (const String &name, const String &type_name, const String &filename, const String &resource_group, const bool auto_scaled, const float native_horz_res, const float native_vert_res)
 Constructor.
 
void addFontProperties ()
 Register all properties of this class.
 
void setMaxCodepoint (utf32 codepoint)
 Set the maximal glyph index. This reserves the respective number of bits in the d_glyphPageLoaded array.
 

Protected Attributes

float d_specificLineSpacing
 If non-zero, the overridden line spacing that we're to report.
 
float d_ptSize
 Point size of font.
 
bool d_antiAliased
 True if the font should be rendered as anti-alaised by freeType.
 
FT_Face d_fontFace
 FreeType-specific font handle.
 
RawDataContainer d_fontData
 Font file data.
 
ImagesetVector d_glyphImages
 Imagesets that holds the glyphs for this font.
 
- Protected Attributes inherited from CEGUI::Font
String d_name
 Name of this font.
 
String d_type
 Type name string for this font (not used internally)
 
String d_filename
 Name of the file used to create this font (font file or imagset)
 
String d_resourceGroup
 Name of the font file's resource group.
 
float d_ascender
 maximal font ascender (pixels above the baseline)
 
float d_descender
 maximal font descender (negative pixels below the baseline)
 
float d_height
 (ascender - descender) + linegap
 
bool d_autoScale
 true when auto-scaling is enabled.
 
float d_nativeHorzRes
 native horizontal resolution for this Imageset.
 
float d_nativeVertRes
 native vertical resolution for this Imageset.
 
float d_horzScaling
 current horizontal scaling factor.
 
float d_vertScaling
 current vertical scaling factor.
 
utf32 d_maxCodepoint
 Maximal codepoint for font glyphs.
 
uint * d_glyphPageLoaded
 This bitmap holds information about loaded 'pages' of glyphs. A glyph page is a set of 256 codepoints, starting at 256-multiples. For example, the 1st glyph page is 0-255, fourth is 1024-1279 etc. When a specific glyph is required for painting, the corresponding bit is checked to see if the respective page has been rasterised. If not, the rasterise() method is invoked, which prepares the glyphs from the respective glyph page for being painted. More...
 
CodepointMap d_cp_map
 Contains mappings from code points to Image objects.
 

Additional Inherited Members

- Public Types inherited from CEGUI::PropertySet
typedef ConstBaseIterator
< PropertyRegistry > 
Iterator
 
- Static Public Member Functions inherited from CEGUI::Font
static void setDefaultResourceGroup (const String &resourceGroup)
 Sets the default resource group to be used when loading font data. More...
 
static const StringgetDefaultResourceGroup ()
 Returns the default resource group currently set for Fonts. More...
 
- Static Public Attributes inherited from CEGUI::Font
static const argb_t DefaultColour
 Colour value used whenever a colour is not specified.
 
- Static Protected Attributes inherited from CEGUI::Font
static String d_defaultResourceGroup
 Holds default resource group for font loading.
 

Detailed Description

Implementation of the Font class interface using the FreeType library.

This implementation tries to provide maximal support for any kind of fonts supported by FreeType. It has been tested on outline font formats like TTF and PS as well as on bitmap font formats like PCF and FON.

Glyphs are rendered dynamically on demand, so a large font with lots of glyphs won't slow application startup time.

Constructor & Destructor Documentation

CEGUI::FreeTypeFont::FreeTypeFont ( const String font_name,
const float  point_size,
const bool  anti_aliased,
const String font_filename,
const String resource_group = "",
const bool  auto_scaled = false,
const float  native_horz_res = 640.0f,
const float  native_vert_res = 480.0f,
const float  specific_line_spacing = 0.0f 
)

Constructor for FreeTypeFont based fonts.

Parameters
font_nameThe name that the font will use within the CEGUI system.
point_sizeSpecifies the point size that the font is to be rendered at.
anti_aliasedSpecifies whether the font should be rendered using anti aliasing.
font_filenameThe filename of an font file that will be used as the source for glyph images for this font.
resource_groupThe resource group identifier to use when loading the font file specified by font_filename.
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.
specific_line_spacingIf specified (non-zero), this will be the line spacing that we will report for this font, regardless of what is mentioned in the font file itself.

Member Function Documentation

void CEGUI::FreeTypeFont::drawGlyphToBuffer ( argb_t buffer,
uint  buf_width 
) const
protected

Copy the current glyph data into buffer, which has a width of buf_width pixels (not bytes).

Parameters
bufferMemory buffer large enough to receive the imagery for the currently loaded glyph.
buf_widthWidth of buffer in pixels (where each pixel is a argb_t).
Returns
Nothing.
uint CEGUI::FreeTypeFont::getTextureSize ( CodepointMap::const_iterator  s,
CodepointMap::const_iterator  e 
) const
protected

Return the required texture size required to store imagery for the glyphs from s to e.

Parameters
sThe first glyph in set
eThe last glyph in set
void CEGUI::FreeTypeFont::rasterise ( utf32  start_codepoint,
utf32  end_codepoint 
) const
protectedvirtual

This function prepares a certain range of glyphs to be ready for displaying. This means that after returning from this function glyphs from d_cp_map[start_codepoint] to d_cp_map[end_codepoint] should have their d_image member set. If there is an error during rasterisation of some glyph, it's okay to leave the d_image field set to NULL, in which case such glyphs will be skipped from display.

Parameters
start_codepointThe lowest codepoint that should be rasterised
end_codepointThe highest codepoint that should be rasterised

Reimplemented from CEGUI::Font.