Typeface Class Reference

A typeface represents a size-independent font. More...

Inherits ReferenceCountedObject.

Inherited by CustomTypeface.

List of all members.

Public Types

typedef
ReferenceCountedObjectPtr
< Typeface
Ptr
 A handy typedef for a pointer to a typeface.

Public Member Functions

const String getName () const throw ()
 Returns the name of the typeface.
virtual ~Typeface ()
 Destructor.
virtual float getAscent () const =0
 Returns the ascent of the font, as a proportion of its height.
virtual float getDescent () const =0
 Returns the descent of the font, as a proportion of its height.
virtual float getStringWidth (const String &text)=0
 Measures the width of a line of text.
virtual void getGlyphPositions (const String &text, Array< int > &glyphs, Array< float > &xOffsets)=0
 Converts a line of text into its glyph numbers and their positions.
virtual bool getOutlineForGlyph (int glyphNumber, Path &path)=0
 Returns the outline for a glyph.

Static Public Member Functions

static const Ptr createSystemTypefaceFor (const Font &font)
 Creates a new system typeface.

Protected Member Functions

 Typeface (const String &name) throw ()

Protected Attributes

String name


Detailed Description

A typeface represents a size-independent font.

This base class is abstract, but calling createSystemTypefaceFor() will return a platform-specific subclass that can be used.

The CustomTypeface subclass allow you to build your own typeface, and to load and save it in the Juce typeface format.

Normally you should never need to deal directly with Typeface objects - the Font class does everything you typically need for rendering text.

See also:
CustomTypeface, Font

Member Typedef Documentation

A handy typedef for a pointer to a typeface.


Constructor & Destructor Documentation

virtual Typeface::~Typeface (  )  [virtual]

Destructor.

Typeface::Typeface ( const String name  )  throw () [protected]


Member Function Documentation

const String Typeface::getName (  )  const throw ()

Returns the name of the typeface.

See also:
Font::getTypefaceName

static const Ptr Typeface::createSystemTypefaceFor ( const Font font  )  [static]

Creates a new system typeface.

virtual float Typeface::getAscent (  )  const [pure virtual]

Returns the ascent of the font, as a proportion of its height.

The height is considered to always be normalised as 1.0, so this will be a value less that 1.0, indicating the proportion of the font that lies above its baseline.

Implemented in CustomTypeface.

virtual float Typeface::getDescent (  )  const [pure virtual]

Returns the descent of the font, as a proportion of its height.

The height is considered to always be normalised as 1.0, so this will be a value less that 1.0, indicating the proportion of the font that lies below its baseline.

Implemented in CustomTypeface.

virtual float Typeface::getStringWidth ( const String text  )  [pure virtual]

Measures the width of a line of text.

The distance returned is based on the font having an normalised height of 1.0.

You should never need to call this directly! Use Font::getStringWidth() instead!

Implemented in CustomTypeface.

virtual void Typeface::getGlyphPositions ( const String text,
Array< int > &  glyphs,
Array< float > &  xOffsets 
) [pure virtual]

Converts a line of text into its glyph numbers and their positions.

The distances returned are based on the font having an normalised height of 1.0.

You should never need to call this directly! Use Font::getGlyphPositions() instead!

Implemented in CustomTypeface.

virtual bool Typeface::getOutlineForGlyph ( int  glyphNumber,
Path path 
) [pure virtual]

Returns the outline for a glyph.

The path returned will be normalised to a font height of 1.0.

Implemented in CustomTypeface.


Member Data Documentation

String Typeface::name [protected]


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

Generated on Fri Nov 20 12:00:52 2009 for JUCE by  doxygen 1.5.9