juce::GlyphArrangement Class Reference

#include <juce_GlyphArrangement.h>

Public Member Functions
	GlyphArrangement ()
	GlyphArrangement (const GlyphArrangement &)=default
GlyphArrangement &	operator= (const GlyphArrangement &)=default
	GlyphArrangement (GlyphArrangement &&)=default
GlyphArrangement &	operator= (GlyphArrangement &&)=default
	~GlyphArrangement ()=default
int	getNumGlyphs () const noexcept
PositionedGlyph &	getGlyph (int index) noexcept
const PositionedGlyph *	begin () const
const PositionedGlyph *	end () const
void	clear ()
void	addLineOfText (const Font &font, const String &text, float x, float y)
void	addCurtailedLineOfText (const Font &font, const String &text, float x, float y, float maxWidthPixels, bool useEllipsis)
void	addJustifiedText (const Font &font, const String &text, float x, float y, float maxLineWidth, Justification horizontalLayout, float leading=0.0f)
void	addFittedText (const Font &font, const String &text, float x, float y, float width, float height, Justification layout, int maximumLinesToUse, float minimumHorizontalScale=0.0f)
void	addGlyphArrangement (const GlyphArrangement &)
void	addGlyph (const PositionedGlyph &)
void	draw (const Graphics &) const
void	draw (const Graphics &, AffineTransform) const
void	createPath (Path &path) const
int	findGlyphIndexAt (float x, float y) const
Rectangle< float >	getBoundingBox (int startIndex, int numGlyphs, bool includeWhitespace) const
void	moveRangeOfGlyphs (int startIndex, int numGlyphs, float deltaX, float deltaY)
void	removeRangeOfGlyphs (int startIndex, int numGlyphs)
void	stretchRangeOfGlyphs (int startIndex, int numGlyphs, float horizontalScaleFactor)
void	justifyGlyphs (int startIndex, int numGlyphs, float x, float y, float width, float height, Justification justification)

Private Member Functions
int	insertEllipsis (const Font &, float maxXPos, int startIndex, int endIndex)
int	fitLineIntoSpace (int start, int numGlyphs, float x, float y, float w, float h, const Font &, Justification, float minimumHorizontalScale)
void	spreadOutLine (int start, int numGlyphs, float targetWidth)
void	splitLines (const String &, Font, int start, float x, float y, float w, float h, int maxLines, float lineWidth, Justification, float minimumHorizontalScale)
void	addLinesWithLineBreaks (const String &, const Font &, float x, float y, float width, float height, Justification)
void	drawGlyphUnderline (const Graphics &, const PositionedGlyph &, int, AffineTransform) const

Private Attributes
Array< PositionedGlyph >	glyphs

Detailed Description

A set of glyphs, each with a position.

You can create a GlyphArrangement, text to it and then draw it onto a graphics context. It's used internally by the text methods in the Graphics class, but can be used directly if more control is needed.

See also

Font, PositionedGlyph

@tags{Graphics}

Constructor & Destructor Documentation

GlyphArrangement() [1/3]

juce::GlyphArrangement::GlyphArrangement

(

)

Creates an empty arrangement.

GlyphArrangement() [2/3]

juce::GlyphArrangement::GlyphArrangement ( const GlyphArrangement & )

default

GlyphArrangement() [3/3]

juce::GlyphArrangement::GlyphArrangement ( GlyphArrangement && )

default

~GlyphArrangement()

juce::GlyphArrangement::~GlyphArrangement ( )

default

Destructor.

Member Function Documentation

addCurtailedLineOfText()

void juce::GlyphArrangement::addCurtailedLineOfText	(	const Font &	font,
		const String &	text,
		float	x,
		float	y,
		float	maxWidthPixels,
		bool	useEllipsis )

Adds a line of text, truncating it if it's wider than a specified size.

This is the same as addLineOfText(), but if the line's width exceeds the value specified in maxWidthPixels, it will be truncated using either ellipsis (i.e. dots: "..."), if useEllipsis is true, or if this is false, it will just drop any subsequent characters.

addFittedText()

void juce::GlyphArrangement::addFittedText	(	const Font &	font,
		const String &	text,
		float	x,
		float	y,
		float	width,
		float	height,
		Justification	layout,
		int	maximumLinesToUse,
		float	minimumHorizontalScale = 0.0f )

Tries to fit some text within a given space.

This does its best to make the given text readable within the specified rectangle, so it's useful for labelling things.

If the text is too big, it'll be squashed horizontally or broken over multiple lines if the maximumLinesToUse value allows this. If the text just won't fit into the space, it'll cram as much as possible in there, and put some ellipsis at the end to show that it's been truncated.

A Justification parameter lets you specify how the text is laid out within the rectangle, both horizontally and vertically.

The minimumHorizontalScale parameter specifies how much the text can be squashed horizontally to try to squeeze it into the space. If you don't want any horizontal scaling to occur, you can set this value to 1.0f. Pass 0 if you want it to use the default value.

See also

Graphics::drawFittedText

addGlyph()

void juce::GlyphArrangement::addGlyph

(

const PositionedGlyph &

glyph

)

Appends a custom glyph to the arrangement.

addGlyphArrangement()

void juce::GlyphArrangement::addGlyphArrangement

(

const GlyphArrangement &

other

)

Appends another glyph arrangement to this one.

addJustifiedText()

void juce::GlyphArrangement::addJustifiedText	(	const Font &	font,
		const String &	text,
		float	x,
		float	y,
		float	maxLineWidth,
		Justification	horizontalLayout,
		float	leading = 0.0f )

Adds some multi-line text, breaking lines at word-boundaries if they are too wide.

This will add text to the arrangement, breaking it into new lines either where there is a new-line or carriage-return character in the text, or where a line's width exceeds the value set in maxLineWidth.

Each line that is added will be laid out using the flags set in horizontalLayout, so the lines can be left- or right-justified, or centred horizontally in the space between x and (x + maxLineWidth).

The y coordinate is the position of the baseline of the first line of text - subsequent lines will be placed below it, separated by a distance of font.getHeight() + leading.

addLineOfText()

void juce::GlyphArrangement::addLineOfText	(	const Font &	font,
		const String &	text,
		float	x,
		float	y )

Appends a line of text to the arrangement.

This will add the text as a single line, where x is the left-hand edge of the first character, and y is the position for the text's baseline.

If the text contains new-lines or carriage-returns, this will ignore them - use addJustifiedText() to add multi-line arrangements.

addLinesWithLineBreaks()

void juce::GlyphArrangement::addLinesWithLineBreaks ( const String & text, const Font & f, float x, float y, float width, float height, Justification layout )

private

begin()

const PositionedGlyph * juce::GlyphArrangement::begin ( ) const

inline

clear()

void juce::GlyphArrangement::clear

(

)

Clears all text from the arrangement and resets it.

createPath()

void juce::GlyphArrangement::createPath

(

Path &

path

)

const

Converts the set of glyphs into a path.

Parameters

path	the glyphs' outlines will be appended to this path

draw() [1/2]

void juce::GlyphArrangement::draw

(

const Graphics &

g

)

const

Draws this glyph arrangement to a graphics context.

This uses cached bitmaps so is much faster than the draw (Graphics&, AffineTransform) method, which renders the glyphs as filled vectors.

draw() [2/2]

void juce::GlyphArrangement::draw	(	const Graphics &	g,
		AffineTransform	transform ) const

Draws this glyph arrangement to a graphics context.

This renders the paths as filled vectors, so is far slower than the draw (Graphics&) method for non-transformed arrangements.

drawGlyphUnderline()

void juce::GlyphArrangement::drawGlyphUnderline ( const Graphics & g, const PositionedGlyph & pg, int i, AffineTransform transform ) const

private

end()

const PositionedGlyph * juce::GlyphArrangement::end ( ) const

inline

findGlyphIndexAt()

int juce::GlyphArrangement::findGlyphIndexAt	(	float	x,
		float	y ) const

Looks for a glyph that contains the given coordinate.

Returns

the index of the glyph, or -1 if none were found.

fitLineIntoSpace()

int juce::GlyphArrangement::fitLineIntoSpace ( int start, int numGlyphs, float x, float y, float w, float h, const Font & font, Justification justification, float minimumHorizontalScale )

private

getBoundingBox()

Rectangle< float > juce::GlyphArrangement::getBoundingBox	(	int	startIndex,
		int	numGlyphs,
		bool	includeWhitespace ) const

Finds the smallest rectangle that will enclose a subset of the glyphs.

Parameters

startIndex	the first glyph to test
numGlyphs	the number of glyphs to include; if this is < 0, all glyphs after startIndex will be included
includeWhitespace	if true, the extent of any whitespace characters will also be taken into account

getGlyph()

PositionedGlyph & juce::GlyphArrangement::getGlyph ( int index )

noexcept

Returns one of the glyphs from the arrangement.

Parameters

index

the glyph's index, from 0 to (getNumGlyphs() - 1). Be careful not to pass an out-of-range index here, as it doesn't do any bounds-checking.

getNumGlyphs()

int juce::GlyphArrangement::getNumGlyphs ( ) const

inlinenoexcept

Returns the total number of glyphs in the arrangement.

insertEllipsis()

int juce::GlyphArrangement::insertEllipsis ( const Font & font, float maxXPos, int startIndex, int endIndex )

private

justifyGlyphs()

void juce::GlyphArrangement::justifyGlyphs	(	int	startIndex,
		int	numGlyphs,
		float	x,
		float	y,
		float	width,
		float	height,
		Justification	justification )

Justifies a set of glyphs within a given space.

This moves the glyphs as a block so that the whole thing is located within the given rectangle with the specified layout.

If the Justification::horizontallyJustified flag is specified, each line will be stretched out to fill the specified width.

moveRangeOfGlyphs()

void juce::GlyphArrangement::moveRangeOfGlyphs	(	int	startIndex,
		int	numGlyphs,
		float	deltaX,
		float	deltaY )

Shifts a set of glyphs by a given amount.

Parameters

startIndex	the first glyph to transform
numGlyphs	the number of glyphs to move; if this is < 0, all glyphs after startIndex will be used
deltaX	the amount to add to their x-positions
deltaY	the amount to add to their y-positions

operator=() [1/2]

GlyphArrangement & juce::GlyphArrangement::operator= ( const GlyphArrangement & )

default

operator=() [2/2]

GlyphArrangement & juce::GlyphArrangement::operator= ( GlyphArrangement && )

default

removeRangeOfGlyphs()

void juce::GlyphArrangement::removeRangeOfGlyphs	(	int	startIndex,
		int	numGlyphs )

Removes a set of glyphs from the arrangement.

Parameters

startIndex	the first glyph to remove
numGlyphs	the number of glyphs to remove; if this is < 0, all glyphs after startIndex will be deleted

splitLines()

void juce::GlyphArrangement::splitLines ( const String & text, Font font, int start, float x, float y, float w, float h, int maxLines, float lineWidth, Justification layout, float minimumHorizontalScale )

private

spreadOutLine()

void juce::GlyphArrangement::spreadOutLine ( int start, int numGlyphs, float targetWidth )

private

stretchRangeOfGlyphs()

void juce::GlyphArrangement::stretchRangeOfGlyphs	(	int	startIndex,
		int	numGlyphs,
		float	horizontalScaleFactor )

Expands or compresses a set of glyphs horizontally.

Parameters

startIndex	the first glyph to transform
numGlyphs	the number of glyphs to stretch; if this is < 0, all glyphs after startIndex will be used
horizontalScaleFactor	how much to scale their horizontal width by

Member Data Documentation

glyphs

Array<PositionedGlyph> juce::GlyphArrangement::glyphs

private

---

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

• /home/runner/work/lmms-fork/lmms-fork/plugins/CarlaBase/carla/source/modules/juce_graphics/fonts/juce_GlyphArrangement.h
• /home/runner/work/lmms-fork/lmms-fork/plugins/CarlaBase/carla/source/modules/juce_graphics/fonts/juce_GlyphArrangement.cpp