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

#include <juce_Typeface.h>

Inheritance diagram for Typeface:

Collaboration diagram for Typeface:

[legend]

Public Types
typedef ReferenceCountedObjectPtr< Typeface >	Ptr
	A handy typedef for a pointer to a typeface. More...

Public Member Functions
virtual	~Typeface ()
	Destructor. More...

void	applyVerticalHintingTransform (float fontHeight, Path &path)
	Makes an attempt at performing a good overall distortion that will scale a font of the given size to align vertically with the pixel grid. More...

void	decReferenceCount () noexcept
	Decreases the object's reference count. More...

bool	decReferenceCountWithoutDeleting () noexcept
	Decreases the object's reference count. More...

virtual float	getAscent () const =0
	Returns the ascent of the font, as a proportion of its height. More...

virtual float	getDescent () const =0
	Returns the descent of the font, as a proportion of its height. More...

virtual EdgeTable *	getEdgeTableForGlyph (int glyphNumber, const AffineTransform &transform, float fontHeight)
	Returns a new EdgeTable that contains the path for the givem glyph, with the specified transform applied. More...

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. More...

virtual float	getHeightToPointsFactor () const =0
	Returns the value by which you should multiply a juce font-height value to convert it to the equivalent point-size. More...

const String &	getName () const noexcept
	Returns the font family of the typeface. More...

virtual bool	getOutlineForGlyph (int glyphNumber, Path &path)=0
	Returns the outline for a glyph. More...

int	getReferenceCount () const noexcept
	Returns the object's current reference count. More...

virtual float	getStringWidth (const String &text)=0
	Measures the width of a line of text. More...

const String &	getStyle () const noexcept
	Returns the font style of the typeface. More...

void	incReferenceCount () noexcept
	Increments the object's reference count. More...

virtual bool	isHinted () const
	Returns true if the typeface uses hinting. More...

virtual bool	isSuitableForFont (const Font &) const
	Returns true if this typeface can be used to render the specified font. More...

Static Public Member Functions
static void	clearTypefaceCache ()
	Clears any fonts that are currently cached in memory. More...

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

static Ptr	createSystemTypefaceFor (const void *fontFileData, size_t fontFileDataSize)
	Attempts to create a font from some raw font file data (e.g. More...

static void	scanFolderForFonts (const File &folder)
	On some platforms, this allows a specific path to be scanned. More...

static void	setTypefaceCacheSize (int numFontsToCache)
	Changes the number of fonts that are cached in memory. More...

Protected Member Functions
	Typeface (const String &name, const String &style) noexcept

void	resetReferenceCount () noexcept
	Resets the reference count to zero without deleting the object. More...

Static Protected Member Functions
static Ptr	getFallbackTypeface ()

Protected Attributes
String	name

String	style

Private Attributes
CriticalSection	hintingLock

ScopedPointer< HintingParams >	hintingParams

Friends
struct	ContainerDeletePolicy< HintingParams >

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

◆ Ptr

typedef ReferenceCountedObjectPtr<Typeface> Typeface::Ptr

A handy typedef for a pointer to a typeface.

Constructor & Destructor Documentation

◆ ~Typeface()

virtual Typeface::~Typeface ( )

virtual

Destructor.

◆ Typeface()

Typeface::Typeface	(	const String &	name,
		const String &	style
	)

protectednoexcept

Member Function Documentation

◆ applyVerticalHintingTransform()

void Typeface::applyVerticalHintingTransform	(	float	fontHeight,
		Path &	path
	)

Makes an attempt at performing a good overall distortion that will scale a font of the given size to align vertically with the pixel grid.

The path should be an unscaled (i.e. normalised to height of 1.0) path for a glyph.

◆ clearTypefaceCache()

static void Typeface::clearTypefaceCache ( )

static

Clears any fonts that are currently cached in memory.

◆ createSystemTypefaceFor() [1/2]

static Ptr Typeface::createSystemTypefaceFor ( const Font & font )

static

Creates a new system typeface.

◆ createSystemTypefaceFor() [2/2]

static Ptr Typeface::createSystemTypefaceFor	(	const void *	fontFileData,
		size_t	fontFileDataSize
	)

static

Attempts to create a font from some raw font file data (e.g.

a TTF or OTF file image). The system will take its own internal copy of the data, so you can free the block once this method has returned.

◆ decReferenceCount()

void ReferenceCountedObject::decReferenceCount ( )

inlinenoexceptinherited

Decreases the object's reference count.

If the count gets to zero, the object will be deleted.

References jassert.

◆ decReferenceCountWithoutDeleting()

bool ReferenceCountedObject::decReferenceCountWithoutDeleting ( )

inlinenoexceptinherited

Decreases the object's reference count.

If the count gets to zero, the object will not be deleted, but this method will return true, allowing the caller to take care of deletion.

References jassert.

◆ getAscent()

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.

◆ getDescent()

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.

◆ getEdgeTableForGlyph()

virtual EdgeTable* Typeface::getEdgeTableForGlyph	(	int	glyphNumber,
		const AffineTransform &	transform,
		float	fontHeight
	)

virtual

Returns a new EdgeTable that contains the path for the givem glyph, with the specified transform applied.

Reimplemented in CustomTypeface.

Referenced by RenderingHelpers::CachedGlyphEdgeTable< RendererType >::generate().

◆ getFallbackTypeface()

static Ptr Typeface::getFallbackTypeface ( )

staticprotected

◆ getGlyphPositions()

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.

◆ getHeightToPointsFactor()

virtual float Typeface::getHeightToPointsFactor ( ) const

pure virtual

Returns the value by which you should multiply a juce font-height value to convert it to the equivalent point-size.

Implemented in CustomTypeface.

◆ getName()

const String& Typeface::getName ( ) const

inlinenoexcept

Returns the font family of the typeface.

See also: Font::getTypefaceName

◆ getOutlineForGlyph()

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.

◆ getReferenceCount()

int ReferenceCountedObject::getReferenceCount ( ) const

inlinenoexceptinherited

Returns the object's current reference count.

◆ getStringWidth()

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.

◆ getStyle()

const String& Typeface::getStyle ( ) const

inlinenoexcept

Returns the font style of the typeface.

See also: Font::getTypefaceStyle

◆ incReferenceCount()

void ReferenceCountedObject::incReferenceCount ( )

inlinenoexceptinherited

Increments the object's reference count.

This is done automatically by the smart pointer, but is public just in case it's needed for nefarious purposes.

◆ isHinted()

virtual bool Typeface::isHinted ( ) const

inlinevirtual

Returns true if the typeface uses hinting.

Referenced by RenderingHelpers::CachedGlyphEdgeTable< RendererType >::generate().

◆ isSuitableForFont()

virtual bool Typeface::isSuitableForFont ( const Font & ) const

inlinevirtual

Returns true if this typeface can be used to render the specified font.

When called, the font will already have been checked to make sure that its name and style flags match the typeface.

◆ resetReferenceCount()

void ReferenceCountedObject::resetReferenceCount ( )

inlineprotectednoexceptinherited

Resets the reference count to zero without deleting the object.

You should probably never need to use this!

◆ scanFolderForFonts()

static void Typeface::scanFolderForFonts ( const File & folder )

static

On some platforms, this allows a specific path to be scanned.

Currently only available when using FreeType.

◆ setTypefaceCacheSize()

static void Typeface::setTypefaceCacheSize ( int numFontsToCache )

static

Changes the number of fonts that are cached in memory.

Friends And Related Function Documentation

◆ ContainerDeletePolicy< HintingParams >

friend struct ContainerDeletePolicy< HintingParams >

friend

Member Data Documentation

◆ hintingLock

CriticalSection Typeface::hintingLock

private

◆ hintingParams

ScopedPointer<HintingParams> Typeface::hintingParams

private

◆ name

String Typeface::name

protected

◆ style

String Typeface::style

protected

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

juce_Typeface.h

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ Ptr

Constructor & Destructor Documentation

◆ ~Typeface()

◆ Typeface()

Member Function Documentation

◆ applyVerticalHintingTransform()

◆ clearTypefaceCache()

◆ createSystemTypefaceFor() [1/2]

◆ createSystemTypefaceFor() [2/2]

◆ decReferenceCount()

◆ decReferenceCountWithoutDeleting()

◆ getAscent()

◆ getDescent()

◆ getEdgeTableForGlyph()

◆ getFallbackTypeface()

◆ getGlyphPositions()

◆ getHeightToPointsFactor()

◆ getName()

◆ getOutlineForGlyph()

◆ getReferenceCount()

◆ getStringWidth()

◆ getStyle()

◆ incReferenceCount()

◆ isHinted()

◆ isSuitableForFont()

◆ resetReferenceCount()

◆ scanFolderForFonts()

◆ setTypefaceCacheSize()

Friends And Related Function Documentation

◆ ContainerDeletePolicy< HintingParams >

Member Data Documentation

◆ hintingLock

◆ hintingParams

◆ name

◆ style