Text class. More...

#include <text.hpp>

Public Types
enum	FONT_STYLE { STYLE_NORMAL = 0, STYLE_BOLD = 1, STYLE_ITALIC = 2, STYLE_UNDERLINE = 4 }

Public Member Functions
	pango_text ()

	pango_text (const pango_text &)=delete

pango_text &	operator= (const pango_text &)=delete

surface &	render ()
	Returns the rendered text. More...

int	get_width () const
	Returns the width needed for the text. More...

int	get_height () const
	Returns the height needed for the text. More...

point	get_size () const
	Returns the pixel size needed for the text. More...

bool	is_truncated () const
	Has the text been truncated? This happens if it exceeds max width or height. More...

unsigned	insert_text (const unsigned offset, const std::string &text)
	Inserts UTF-8 text. More...

bool	insert_unicode (const unsigned offset, char32_t unicode)
	Inserts a unicode char. More...

unsigned	insert_unicode (const unsigned offset, const std::u32string &unicode)
	Inserts unicode text. More...

point	get_cursor_position (const unsigned column, const unsigned line=0) const
	Gets the location for the cursor. More...

std::size_t	get_maximum_length () const
	Get maximum length. More...

std::string	get_token (const point &position, const char *delimiters=" \\) const
	Gets the largest collection of characters, including the token at position, and not including any characters from the delimiters set. More...

std::string	get_link (const point &position) const
	Checks if position points to a character in a link in the text, returns it if so, empty string otherwise. More...

point	get_column_line (const point &position) const
	Gets the column of line of the character at the position. More...

std::size_t	get_length () const
	Gets the length of the text in bytes. More...

bool	set_text (const std::string &text, const bool markedup)
	Sets the text to render. More...

const std::string &	text () const

pango_text &	set_family_class (font::family_class fclass)

pango_text &	set_font_size (const unsigned font_size)

pango_text &	set_font_style (const FONT_STYLE font_style)

pango_text &	set_foreground_color (const color_t &color)

pango_text &	set_maximum_width (int width)

pango_text &	set_characters_per_line (const unsigned characters_per_line)

pango_text &	set_maximum_height (int height, bool multiline)

pango_text &	set_ellipse_mode (const PangoEllipsizeMode ellipse_mode)

pango_text &	set_alignment (const PangoAlignment alignment)

pango_text &	set_maximum_length (const std::size_t maximum_length)

bool	link_aware () const

pango_text &	set_link_aware (bool b)

pango_text &	set_link_color (const color_t &color)

pango_text &	set_add_outline (bool do_add)

Private Member Functions
void	recalculate (const bool force=false) const
	Recalculates the text layout. More...

PangoRectangle	calculate_size (PangoLayout &layout) const
	Calculates surface size. More...

void	rerender (const bool force=false)
	Renders the text. More...

void	render (PangoLayout &layout, const PangoRectangle &rect, const std::size_t surface_buffer_offset, const unsigned stride)

bool	set_markup (utils::string_view text, PangoLayout &layout)
	Sets the markup'ed text. More...

bool	validate_markup (utils::string_view text, char **raw_text, std::string &semi_escaped) const

std::string	format_links (const std::string &text) const
	Replaces all instances of URLs in a given string with formatted links and returns the result. More...

Static Private Member Functions
static void	copy_layout_properties (PangoLayout &src, PangoLayout &dst)

Private Attributes
std::unique_ptr< PangoContext, std::function< void(void *)> >	context_

std::unique_ptr< PangoLayout, std::function< void(void *)> >	layout_

PangoRectangle	rect_

surface	surface_
	The SDL surface to render upon used as a cache. More...

std::string	text_
	The text to draw (stored as UTF-8). More...

bool	markedup_text_
	Does the text contain pango markup? If different render routines must be used. More...

bool	link_aware_
	Are hyperlinks in the text marked-up, and will get_link return them. More...

color_t	link_color_
	The color to render links in. More...

font::family_class	font_class_
	The font family class used. More...

unsigned	font_size_
	The font size to draw. More...

FONT_STYLE	font_style_
	The style of the font, this is an orred mask of the font flags. More...

color_t	foreground_color_
	The foreground color. More...

bool	add_outline_
	Whether to add an outline effect. More...

int	maximum_width_
	The maximum width of the text. More...

unsigned	characters_per_line_
	The number of characters per line. More...

int	maximum_height_
	The maximum height of the text. More...

PangoEllipsizeMode	ellipse_mode_
	The way too long text is shown depends on this mode. More...

PangoAlignment	alignment_
	The alignment of the text. More...

std::size_t	maximum_length_
	The maximum length of the text. More...

bool	calculation_dirty_
	The text has two dirty states: More...

std::size_t	length_
	Length of the text. More...

bool	surface_dirty_
	The dirty state of the surface. More...

std::vector< uint8_t >	surface_buffer_
	Buffer to store the image on. More...

Detailed Description

Text class.

This class represents text which is rendered using Pango.

It takes text, as a utf-8 std::string, plus formatting options including font and color. It provides a surface object which holds the rendered text.

Besides this, it can do some additional calculations using the font layout.

It can take an index into the text, and convert it to pixel coordinates, so that if we want to draw a cursor in an editbox, we know where to draw it.

It can also take a pixel coordinate with respect to the text layout, and translate it back to an index into the original text. This is useful if the user clicks on the text, and we want to know where to move the cursor.

The get_token method takes a pixel coordinate, which we assume represents a click position, and gets the corresponding "token" from the string. The default token delimiters are whitespace " \n\r\t". So, this returns the "word" that the user clicked on.

Finally, the get_link method represents special support for hyperlinks in text. A token "looks like a link" if it begins "http://" or "https://". If a text has link_aware enabled, then any such token is rendered with an underline and in a special color, see link_color. The get_link method calls get_token and further checks if the clicked token looks like a link.

This class stores the text to draw and uses pango with the cairo backend to render the text. See http://pango.org for more info.

Definition at line 74 of file text.hpp.

Member Enumeration Documentation

◆ FONT_STYLE

enum font::pango_text::FONT_STYLE

Enumerator
STYLE_NORMAL
STYLE_BOLD
STYLE_ITALIC
STYLE_UNDERLINE

Definition at line 137 of file text.hpp.

Constructor & Destructor Documentation

◆ pango_text() [1/2]

font::pango_text::pango_text ( )

Definition at line 43 of file text.cpp.

References alignment_, context_, ellipse_mode_, and layout_.

◆ pango_text() [2/2]

font::pango_text::pango_text ( const pango_text & )

delete

Member Function Documentation

◆ calculate_size()

PangoRectangle font::pango_text::calculate_size ( PangoLayout & layout ) const

private

Calculates surface size.

Definition at line 492 of file text.cpp.

References characters_per_line_, context_, DBG_GUI_L, gui2::debug_truncate(), f, font_class_, font_size_, font_style_, font::get_font_families(), markedup_text_, maximum_height_, maximum_width_, utf8::size(), STYLE_UNDERLINE, text_, and w.

Referenced by recalculate(), and rerender().

◆ copy_layout_properties()

void font::pango_text::copy_layout_properties	(	PangoLayout &	src,
		PangoLayout &	dst
	)

staticprivate

Definition at line 861 of file text.cpp.

Referenced by rerender().

◆ format_links()

std::string font::pango_text::format_links ( const std::string & text ) const

private

Replaces all instances of URLs in a given string with formatted links and returns the result.

Definition at line 789 of file text.cpp.

References font::format_as_link(), utf8::index(), link_color_, and font::looks_like_url().

Referenced by set_markup().

◆ get_column_line()

point font::pango_text::get_column_line ( const point & position ) const

Gets the column of line of the character at the position.

Parameters

position The pixel position in the text area.

Returns: A point with the x value the column and the y value the line of the character found (or last character if not found.

Todo:: There's still a bug left. When you select a text which is in the ellipses on the right side the text gets reformatted with ellipses on the left and the selected character is not the one under the cursor. Other widget toolkits don't show ellipses and have no indication more text is available. Haven't found what the best thing to do would be. Until that time leave it as is.

Definition at line 249 of file text.cpp.

References get_cursor_position(), i, utf8::index(), layout_, recalculate(), point::x, and point::y.

◆ get_cursor_position()

point font::pango_text::get_cursor_position	(	const unsigned	column,
		const unsigned	line = `0`
	)		const

Gets the location for the cursor.

Parameters

column	The column offset of the cursor.
line	The line offset of the cursor.

Returns: The position of the top of the cursor. It the requested location is out of range 0,0 is returned.

Definition at line 152 of file text.cpp.

References i, layout_, and recalculate().

Referenced by get_column_line().

◆ get_height()

int font::pango_text::get_height ( ) const

Returns the height needed for the text.

Definition at line 102 of file text.cpp.

References get_size(), and point::y.

◆ get_length()

std::size_t font::pango_text::get_length ( ) const

inline

Gets the length of the text in bytes.

The text set is UTF-8 so the length of the string might not be the length of the text.

Definition at line 206 of file text.hpp.

References length_, and set_text().

Referenced by gui2::text_box_base::handle_editing(), gui2::text_box_base::handle_key_delete(), gui2::text_box_base::handle_key_right_arrow(), gui2::text_box_base::set_cursor(), gui2::text_box_base::set_maximum_length(), gui2::text_box_base::set_selection(), and gui2::text_box_base::set_value().

◆ get_link()

std::string font::pango_text::get_link ( const point & position ) const

Checks if position points to a character in a link in the text, returns it if so, empty string otherwise.

Link-awareness must be enabled to get results.

Parameters

position The pixel position in the text area.

Returns: The link if one is found, the empty string otherwise.

Definition at line 234 of file text.cpp.

References get_token(), link_aware_, and font::looks_like_url().

Referenced by gui2::styled_widget::get_label_link().

◆ get_maximum_length()

std::size_t font::pango_text::get_maximum_length ( ) const

Get maximum length.

Returns: The maximum length of the text. The length of text should not exceed this value.

Definition at line 197 of file text.cpp.

References maximum_length_.

◆ get_size()

point font::pango_text::get_size ( ) const

Returns the pixel size needed for the text.

Definition at line 107 of file text.cpp.

References recalculate(), and rect_.

Referenced by gui2::styled_widget::get_best_text_size(), get_height(), and get_width().

◆ get_token()

std::string font::pango_text::get_token	(	const point &	position,
		const char *	delimiters = `" \n\r\t"`
	)		const

Gets the largest collection of characters, including the token at position, and not including any characters from the delimiters set.

Parameters

position	The pixel position in the text area.
delimiters

Returns: The token containing position, and none of the delimiter characters. If position is out of bounds, it returns the empty string.

Definition at line 202 of file text.cpp.

References d, utf8::index(), layout_, recalculate(), point::x, and point::y.

Referenced by gui2::styled_widget::get_label_token(), and get_link().

◆ get_width()

int font::pango_text::get_width ( ) const

Returns the width needed for the text.

Definition at line 97 of file text.cpp.

References get_size(), and point::x.

◆ insert_text()

unsigned font::pango_text::insert_text	(	const unsigned	offset,
		const std::string &	text
	)

Inserts UTF-8 text.

Parameters

offset	The position to insert the text.
text	The UTF-8 text to insert.

Returns: The number of characters inserted.

Definition at line 121 of file text.cpp.

References utf8::index(), utf8::insert(), length_, maximum_length_, set_text(), utf8::size(), and text_.

Referenced by gui2::text_box_base::handle_editing(), gui2::text_box_base::insert_char(), insert_unicode(), and gui2::text_box_base::paste_selection().

◆ insert_unicode() [1/2]

bool font::pango_text::insert_unicode	(	const unsigned	offset,
		char32_t	unicode
	)

Inserts a unicode char.

Parameters

offset	The position to insert the char.
unicode	The character to insert.

Returns: True upon success, false otherwise.

Definition at line 141 of file text.cpp.

◆ insert_unicode() [2/2]

unsigned font::pango_text::insert_unicode	(	const unsigned	offset,
		const std::u32string &	unicode
	)

Inserts unicode text.

Parameters

offset	The position to insert the text.
unicode	Vector with characters to insert.

Returns: The number of characters inserted.

Definition at line 146 of file text.cpp.

References utf8::insert(), insert_text(), and unicode_cast().

◆ is_truncated()

bool font::pango_text::is_truncated ( ) const

Has the text been truncated? This happens if it exceeds max width or height.

Definition at line 114 of file text.cpp.

References layout_, and recalculate().

Referenced by gui2::styled_widget::get_best_text_size(), and gui2::styled_widget::place().

◆ link_aware()

bool font::pango_text::link_aware ( ) const

inline

Definition at line 246 of file text.hpp.

References b, link_aware_, set_add_outline(), set_link_aware(), and set_link_color().

◆ operator=()

pango_text& font::pango_text::operator= ( const pango_text & )

delete

◆ recalculate()

void font::pango_text::recalculate ( const bool force = false ) const

private

Recalculates the text layout.

When the text is recalculated the surface is dirtied.

Parameters

force Recalculate even if not dirty?

Definition at line 480 of file text.cpp.

References calculate_size(), calculation_dirty_, layout_, rect_, and surface_dirty_.

Referenced by get_column_line(), get_cursor_position(), get_size(), get_token(), is_truncated(), and rerender().

◆ render() [1/2]

surface & font::pango_text::render ( )

Returns the rendered text.

Before rendering it tests whether a redraw is needed and if so it first redraws the surface before returning it.

Definition at line 90 of file text.cpp.

References rerender(), and surface_.

Referenced by font::floating_label::create_surface(), gui2::text_shape::draw(), display::refresh_report(), and rerender().

◆ render() [2/2]

void font::pango_text::render	(	PangoLayout &	layout,
		const PangoRectangle &	rect,
		const std::size_t	surface_buffer_offset,
		const unsigned	stride
	)

private

Definition at line 617 of file text.cpp.

References color_t::a, add_outline_, color_t::b, foreground_color_, color_t::g, maximum_height_, maximum_width_, color_t::r, and surface_buffer_.

◆ rerender()

void font::pango_text::rerender ( const bool force = false )

private

Renders the text.

It will do a recalculation first so no need to call both.

Parameters

force Render even if not dirty? This parameter is also send to recalculate().

Definition at line 670 of file text.cpp.

References calculate_size(), context_, copy_layout_properties(), font::from_cairo_format(), layout_, maximum_height_, maximum_width_, recalculate(), rect_, render(), set_markup(), surface_, surface_buffer_, surface_dirty_, and text_.

Referenced by render().

◆ set_add_outline()

pango_text & font::pango_text::set_add_outline ( bool do_add )

Definition at line 469 of file text.cpp.

References add_outline_, and surface_dirty_.

Referenced by link_aware().

◆ set_alignment()

pango_text & font::pango_text::set_alignment ( const PangoAlignment alignment )

Definition at line 424 of file text.cpp.

References alignment_, layout_, and surface_dirty_.

Referenced by gui2::text_shape::draw(), gui2::styled_widget::get_best_text_size(), and text().

◆ set_characters_per_line()

pango_text & font::pango_text::set_characters_per_line ( const unsigned characters_per_line )

Definition at line 379 of file text.cpp.

References calculation_dirty_, characters_per_line_, and surface_dirty_.

Referenced by gui2::text_shape::draw(), gui2::styled_widget::get_best_text_size(), and text().

◆ set_ellipse_mode()

pango_text & font::pango_text::set_ellipse_mode ( const PangoEllipsizeMode ellipse_mode )

Definition at line 410 of file text.cpp.

References calculation_dirty_, ellipse_mode_, layout_, and surface_dirty_.

Referenced by gui2::text_shape::draw(), gui2::styled_widget::get_best_text_size(), and text().

◆ set_family_class()

pango_text & font::pango_text::set_family_class ( font::family_class fclass )

Definition at line 320 of file text.cpp.

References calculation_dirty_, font_class_, and surface_dirty_.

Referenced by gui2::text_shape::draw(), gui2::styled_widget::get_best_text_size(), and text().

◆ set_font_size()

pango_text & font::pango_text::set_font_size ( const unsigned font_size )

Definition at line 331 of file text.cpp.

References calculation_dirty_, preferences::font_scaled(), font_size_, and surface_dirty_.

Referenced by font::floating_label::create_surface(), gui2::text_shape::draw(), gui2::styled_widget::get_best_text_size(), display::refresh_report(), and text().

◆ set_font_style()

pango_text & font::pango_text::set_font_style ( const FONT_STYLE font_style )

Definition at line 343 of file text.cpp.

References calculation_dirty_, font_style_, and surface_dirty_.

Referenced by gui2::text_shape::draw(), gui2::styled_widget::get_best_text_size(), and text().

◆ set_foreground_color()

pango_text & font::pango_text::set_foreground_color ( const color_t & color )

Definition at line 354 of file text.cpp.

References foreground_color_, and surface_dirty_.

Referenced by font::floating_label::create_surface(), gui2::text_shape::draw(), display::refresh_report(), and text().

◆ set_link_aware()

pango_text & font::pango_text::set_link_aware ( bool b )

Definition at line 448 of file text.cpp.

References b, calculation_dirty_, link_aware_, and surface_dirty_.

Referenced by gui2::text_shape::draw(), gui2::styled_widget::get_best_text_size(), and link_aware().

◆ set_link_color()

pango_text & font::pango_text::set_link_color ( const color_t & color )

Definition at line 458 of file text.cpp.

References calculation_dirty_, link_color_, and surface_dirty_.

Referenced by gui2::text_shape::draw(), gui2::styled_widget::get_best_text_size(), and link_aware().

◆ set_markup()

bool font::pango_text::set_markup	(	utils::string_view	text,
		PangoLayout &	layout
	)

private

Sets the markup'ed text.

It tries to set the text as markup. If the markup is invalid it will try a bit harder to recover from the errors and still set the markup.

Parameters

text	The text to set as markup.
layout

Returns: Whether the markup was set or an unrecoverable error occurred and the text is set as plain text with an error message.

Definition at line 760 of file text.cpp.

References _(), ERR_GUI_L, format_links(), link_aware_, set_text(), and validate_markup().

Referenced by rerender(), and set_text().

◆ set_maximum_height()

pango_text & font::pango_text::set_maximum_height	(	int	height,
		bool	multiline
	)

Definition at line 391 of file text.cpp.

References calculation_dirty_, layout_, maximum_height_, and surface_dirty_.

Referenced by font::floating_label::create_surface(), gui2::text_shape::draw(), display::refresh_report(), and text().

◆ set_maximum_length()

pango_text & font::pango_text::set_maximum_length ( const std::size_t maximum_length )

Definition at line 435 of file text.cpp.

References length_, maximum_length_, set_text(), text_, and utf8::truncate().

Referenced by gui2::text_box_base::set_maximum_length(), and text().

◆ set_maximum_width()

pango_text & font::pango_text::set_maximum_width ( int width )

Definition at line 364 of file text.cpp.

References calculation_dirty_, maximum_width_, and surface_dirty_.

Referenced by font::floating_label::create_surface(), gui2::text_shape::draw(), gui2::styled_widget::get_best_text_size(), display::refresh_report(), and text().

◆ set_text()

bool font::pango_text::set_text	(	const std::string &	text,
		const bool	markedup
	)

Sets the text to render.

Parameters

text	The text to render.
markedup	Should the text be rendered with pango markup. If the markup is invalid it's rendered as text without markup.

Returns: The status, if rendered as markup and the markup contains errors, false is returned else true.

Definition at line 283 of file text.cpp.

References calculation_dirty_, context_, ERR_GUI_L, layout_, length_, markedup_text_, set_markup(), surface_dirty_, text(), text_, and unicode_cast().

Referenced by font::floating_label::create_surface(), gui2::text_shape::draw(), gui2::styled_widget::get_best_text_size(), get_length(), gui2::text_box_base::handle_editing(), insert_text(), display::refresh_report(), gui2::styled_widget::set_label(), set_markup(), set_maximum_length(), and gui2::text_box_base::set_value().

◆ text()

const std::string& font::pango_text::text ( ) const

inline

Definition at line 224 of file text.hpp.

References gui::font_size, set_alignment(), set_characters_per_line(), set_ellipse_mode(), set_family_class(), set_font_size(), set_font_style(), set_foreground_color(), set_maximum_height(), set_maximum_length(), set_maximum_width(), and text_.

Referenced by gui2::text_box_base::copy_selection(), gui2::text_box_base::get_composition_length(), gui2::text_box_base::handle_editing(), set_text(), and gui2::text_box_base::set_value().

◆ validate_markup()

bool font::pango_text::validate_markup	(	utils::string_view	text,
		char **	raw_text,
		std::string &	semi_escaped
	)		const

private

Definition at line 823 of file text.cpp.

References font::semi_escape_text(), and WRN_GUI_L.

Referenced by set_markup().

Member Data Documentation

◆ add_outline_

bool font::pango_text::add_outline_

private

Whether to add an outline effect.

Definition at line 296 of file text.hpp.

Referenced by render(), and set_add_outline().

◆ alignment_

PangoAlignment font::pango_text::alignment_

private

The alignment of the text.

Definition at line 338 of file text.hpp.

Referenced by pango_text(), and set_alignment().

◆ calculation_dirty_

bool font::pango_text::calculation_dirty_

mutableprivate

The text has two dirty states:

The setting of the state and the size calculations.
The rendering of the surface.The dirty state of the calculations.

Definition at line 350 of file text.hpp.

Referenced by recalculate(), set_characters_per_line(), set_ellipse_mode(), set_family_class(), set_font_size(), set_font_style(), set_link_aware(), set_link_color(), set_maximum_height(), set_maximum_width(), and set_text().

◆ characters_per_line_

unsigned font::pango_text::characters_per_line_

private

The number of characters per line.

This can be used as an alternative of maximum_width_. The user can select a number of characters on a line for wrapping. When the value is non-zero it determines the maximum width based on the average character width.

If both maximum_width_ and characters_per_line_ are set the minimum of the two will be the maximum.

Note: Long lines are often harder to read, setting this value can automatically wrap on a number of characters regardless of the font size. Often 66 characters is considered the optimal value for a one column text.

Definition at line 324 of file text.hpp.

Referenced by calculate_size(), and set_characters_per_line().

◆ context_

std::unique_ptr<PangoContext, std::function<void(void*)> > font::pango_text::context_

private

Definition at line 257 of file text.hpp.

Referenced by calculate_size(), pango_text(), rerender(), and set_text().

◆ ellipse_mode_

PangoEllipsizeMode font::pango_text::ellipse_mode_

private

The way too long text is shown depends on this mode.

Definition at line 335 of file text.hpp.

Referenced by pango_text(), and set_ellipse_mode().

◆ font_class_

font::family_class font::pango_text::font_class_

private

The font family class used.

Definition at line 284 of file text.hpp.

Referenced by calculate_size(), and set_family_class().

◆ font_size_

unsigned font::pango_text::font_size_

private

The font size to draw.

Definition at line 287 of file text.hpp.

Referenced by calculate_size(), and set_font_size().

◆ font_style_

FONT_STYLE font::pango_text::font_style_

private

The style of the font, this is an orred mask of the font flags.

Definition at line 290 of file text.hpp.

Referenced by calculate_size(), and set_font_style().

◆ foreground_color_

color_t font::pango_text::foreground_color_

private

The foreground color.

Definition at line 293 of file text.hpp.

Referenced by render(), and set_foreground_color().

◆ layout_

std::unique_ptr<PangoLayout, std::function<void(void*)> > font::pango_text::layout_

private

Definition at line 258 of file text.hpp.

Referenced by get_column_line(), get_cursor_position(), get_token(), is_truncated(), pango_text(), recalculate(), rerender(), set_alignment(), set_ellipse_mode(), set_maximum_height(), and set_text().

◆ length_

std::size_t font::pango_text::length_

mutableprivate

Length of the text.

Definition at line 353 of file text.hpp.

Referenced by get_length(), insert_text(), set_maximum_length(), and set_text().

◆ link_aware_

bool font::pango_text::link_aware_

private

Are hyperlinks in the text marked-up, and will get_link return them.

Definition at line 272 of file text.hpp.

Referenced by get_link(), link_aware(), set_link_aware(), and set_markup().

◆ link_color_

color_t font::pango_text::link_color_

private

The color to render links in.

Links are formatted using pango <span> as follows:

Definition at line 281 of file text.hpp.

Referenced by format_links(), and set_link_color().

◆ markedup_text_

bool font::pango_text::markedup_text_

private

Does the text contain pango markup? If different render routines must be used.

Definition at line 269 of file text.hpp.

Referenced by calculate_size(), and set_text().

◆ maximum_height_

int font::pango_text::maximum_height_

private

The maximum height of the text.

Values less or equal to 0 mean no maximum and are internally stored as -1, since that's the value pango uses for it.

Definition at line 332 of file text.hpp.

Referenced by calculate_size(), render(), rerender(), and set_maximum_height().

◆ maximum_length_

std::size_t font::pango_text::maximum_length_

private

The maximum length of the text.

Definition at line 341 of file text.hpp.

Referenced by get_maximum_length(), insert_text(), and set_maximum_length().

◆ maximum_width_

int font::pango_text::maximum_width_

private

The maximum width of the text.

Values less or equal to 0 mean no maximum and are internally stored as -1, since that's the value pango uses for it.

See characters_per_line_.

Definition at line 306 of file text.hpp.

Referenced by calculate_size(), render(), rerender(), and set_maximum_width().

◆ rect_

PangoRectangle font::pango_text::rect_

mutableprivate

Definition at line 259 of file text.hpp.

Referenced by get_size(), recalculate(), and rerender().

◆ surface_

surface font::pango_text::surface_

mutableprivate

The SDL surface to render upon used as a cache.

Definition at line 262 of file text.hpp.

Referenced by render(), and rerender().

◆ surface_buffer_

std::vector<uint8_t> font::pango_text::surface_buffer_

mutableprivate

Buffer to store the image on.

We use a cairo surface to draw on this buffer and then use the buffer as data source for the SDL_Surface. This means the buffer needs to be stored in the object, since SDL_Surface doesn't own its buffer.

Definition at line 390 of file text.hpp.

Referenced by render(), and rerender().

◆ surface_dirty_

bool font::pango_text::surface_dirty_

mutableprivate

The dirty state of the surface.

Definition at line 368 of file text.hpp.

Referenced by recalculate(), rerender(), set_add_outline(), set_alignment(), set_characters_per_line(), set_ellipse_mode(), set_family_class(), set_font_size(), set_font_style(), set_foreground_color(), set_link_aware(), set_link_color(), set_maximum_height(), set_maximum_width(), and set_text().

◆ text_

std::string font::pango_text::text_

private

The text to draw (stored as UTF-8).

Definition at line 266 of file text.hpp.

Referenced by calculate_size(), insert_text(), rerender(), set_maximum_length(), set_text(), and text().

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

font/text.hpp
font/text.cpp

Public Types

Public Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Detailed Description

Member Enumeration Documentation

◆ FONT_STYLE

Constructor & Destructor Documentation

◆ pango_text() [1/2]

◆ pango_text() [2/2]

Member Function Documentation

◆ calculate_size()

◆ copy_layout_properties()

◆ format_links()

◆ get_column_line()

◆ get_cursor_position()

◆ get_height()

◆ get_length()

◆ get_link()

◆ get_maximum_length()

◆ get_size()

◆ get_token()

◆ get_width()

◆ insert_text()

◆ insert_unicode() [1/2]

◆ insert_unicode() [2/2]

◆ is_truncated()

◆ link_aware()

◆ operator=()

◆ recalculate()

◆ render() [1/2]

◆ render() [2/2]

◆ rerender()

◆ set_add_outline()

◆ set_alignment()

◆ set_characters_per_line()

◆ set_ellipse_mode()

◆ set_family_class()

◆ set_font_size()

◆ set_font_style()

◆ set_foreground_color()

◆ set_link_aware()

◆ set_link_color()

◆ set_markup()

◆ set_maximum_height()

◆ set_maximum_length()

◆ set_maximum_width()

◆ set_text()

◆ text()

◆ validate_markup()

Member Data Documentation

◆ add_outline_

◆ alignment_

◆ calculation_dirty_

◆ characters_per_line_

◆ context_

◆ ellipse_mode_

◆ font_class_

◆ font_size_

◆ font_style_

◆ foreground_color_

◆ layout_

◆ length_

◆ link_aware_

◆ link_color_

◆ markedup_text_

◆ maximum_height_

◆ maximum_length_

◆ maximum_width_

◆ rect_

◆ surface_

◆ surface_buffer_

◆ surface_dirty_

◆ text_