Header file for SDL_ttf library. More...

Classes
class	SDL::Font
	The internal structure containing font information. More...
struct	SDL::FontRef
	Reference for Font. More...
class	SDL::TextEngine
	A text engine used to create text objects. More...
struct	SDL::SurfaceTextEngine
	A surface based text engine. More...
struct	SDL::RendererTextEngine
	A renderer based text engine. More...
struct	SDL::GPUTextEngine
	A GPU based text engine. More...
class	SDL::Text
	Text created with TextEngine.CreateText(). More...
struct	SDL::TextRef
	Reference for Text. More...
class	SDL::SubStringIterator
	Iterator for substrings. More...

Macros
#define	SDL_TTF_VERSION
	This is the version number macro for the current SDL_ttf version.
#define	SDL_TTF_VERSION_ATLEAST(X, Y, Z)
	This macro will evaluate to true if compiled with SDL_ttf at least X.Y.Z.

Typedefs
using	SDL::FontRaw = TTF_Font*
	Alias to raw representation for Font.
using	SDL::TextEngineRaw = TTF_TextEngine*
	Alias to raw representation for TextEngine.
using	SDL::TextEngineRef = ObjParam<TextEngineRaw>
	Safely wrap TextEngine for non owning parameters.
using	SDL::TextRaw = TTF_Text*
	Alias to raw representation for Text.
using	SDL::TextRawConst = const TTF_Text*
	Alias to const raw representation for Text.
using	SDL::TextConstRef = ObjConstParam<TextRaw, TextRawConst>
	Safely wrap Text for non owning const parameters.
using	SDL::FontStyleFlags = Uint32
	Font style flags for Font.
using	SDL::HintingFlags = TTF_HintingFlags
	Hinting flags for TTF (TrueType Fonts).
using	SDL::HorizontalAlignment = TTF_HorizontalAlignment
	The horizontal alignment used when rendering wrapped text.
using	SDL::Direction = TTF_Direction
	Direction flags.
using	SDL::ImageType = TTF_ImageType
	The type of data in a glyph image.
using	SDL::SubStringFlags = Uint32
	Flags for SubString.
using	SDL::GPUTextEngineWinding = TTF_GPUTextEngineWinding
	The winding order of the vertices returned by Text.GetGPUDrawData.
using	SDL::GPUAtlasDrawSequence = TTF_GPUAtlasDrawSequence
	Draw sequence returned by Text.GetGPUDrawData.
using	SDL::SubString = TTF_SubString
	The representation of a substring within text.
using	SDL::TextData = TTF_TextData
	Internal data for Text.

Functions
void	SDL::GetFreeTypeVersion (int major, int minor, int *patch)
	Query the version of the FreeType library in use.
void	SDL::GetHarfBuzzVersion (int major, int minor, int *patch)
	Query the version of the HarfBuzz library in use.
Font	SDL::OpenFont (StringParam file, float ptsize)
	Create a font from a file, using a specified point size.
Font	SDL::OpenFontIO (IOStreamRef src, float ptsize, bool closeio=false)
	Create a font from an IOStream, using a specified point size.
Font	SDL::OpenFontWithProperties (PropertiesRef props)
	Create a font with the specified properties.
Font	SDL::CopyFont (FontRef existing_font)
	Create a copy of an existing font.
PropertiesRef	SDL::GetFontProperties (FontRef font)
	Get the properties associated with a font.
Uint32	SDL::GetFontGeneration (FontRef font)
	Get the font generation.
void	SDL::AddFallbackFont (FontRef font, FontRef fallback)
	Add a fallback font.
void	SDL::RemoveFallbackFont (FontRef font, FontRef fallback)
	Remove a fallback font.
void	SDL::ClearFallbackFonts (FontRef font)
	Remove all fallback fonts.
void	SDL::SetFontSize (FontRef font, float ptsize)
	Set a font's size dynamically.
void	SDL::SetFontSizeDPI (FontRef font, float ptsize, int hdpi, int vdpi)
	Set font size dynamically with target resolutions, in dots per inch.
float	SDL::GetFontSize (FontRef font)
	Get the size of a font.
void	SDL::GetFontDPI (FontRef font, int hdpi, int vdpi)
	Get font target resolutions, in dots per inch.
void	SDL::SetFontStyle (FontRef font, FontStyleFlags style)
	Set a font's current style.
FontStyleFlags	SDL::GetFontStyle (FontRef font)
	Query a font's current style.
void	SDL::SetFontOutline (FontRef font, int outline)
	Set a font's current outline.
int	SDL::GetFontOutline (FontRef font)
	Query a font's current outline.
void	SDL::SetFontHinting (FontRef font, HintingFlags hinting)
	Set a font's current hinter setting.
int	SDL::GetNumFontFaces (FontRef font)
	Query the number of faces of a font.
HintingFlags	SDL::GetFontHinting (FontRef font)
	Query a font's current FreeType hinter setting.
void	SDL::SetFontSDF (FontRef font, bool enabled)
	Enable Signed Distance Field rendering for a font.
bool	SDL::GetFontSDF (FontRef font)
	Query whether Signed Distance Field rendering is enabled for a font.
int	SDL::GetFontWeight (FontRef font)
	Query a font's weight, in terms of the lightness/heaviness of the strokes.
void	SDL::SetFontWrapAlignment (FontRef font, HorizontalAlignment align)
	Set a font's current wrap alignment option.
HorizontalAlignment	SDL::GetFontWrapAlignment (FontRef font)
	Query a font's current wrap alignment option.
int	SDL::GetFontHeight (FontRef font)
	Query the total height of a font.
int	SDL::GetFontAscent (FontRef font)
	Query the offset from the baseline to the top of a font.
int	SDL::GetFontDescent (FontRef font)
	Query the offset from the baseline to the bottom of a font.
void	SDL::SetFontLineSkip (FontRef font, int lineskip)
	Set the spacing between lines of text for a font.
int	SDL::GetFontLineSkip (FontRef font)
	Query the spacing between lines of text for a font.
void	SDL::SetFontKerning (FontRef font, bool enabled)
	Set if kerning is enabled for a font.
bool	SDL::GetFontKerning (FontRef font)
	Query whether or not kerning is enabled for a font.
bool	SDL::FontIsFixedWidth (FontRef font)
	Query whether a font is fixed-width.
bool	SDL::FontIsScalable (FontRef font)
	Query whether a font is scalable or not.
const char *	SDL::GetFontFamilyName (FontRef font)
	Query a font's family name.
const char *	SDL::GetFontStyleName (FontRef font)
	Query a font's style name.
void	SDL::SetFontDirection (FontRef font, Direction direction)
	Set the direction to be used for text shaping by a font.
Direction	SDL::GetFontDirection (FontRef font)
	Get the direction to be used for text shaping by a font.
Uint32	SDL::StringToTag (StringParam string)
	Convert from a 4 character string to a 32-bit tag.
void	SDL::TagToString (Uint32 tag, char *string, size_t size)
	Convert from a 32-bit tag to a 4 character string.
void	SDL::SetFontScript (FontRef font, Uint32 script)
	Set the script to be used for text shaping by a font.
Uint32	SDL::GetFontScript (FontRef font)
	Get the script used for text shaping a font.
Uint32	SDL::GetGlyphScript (Uint32 ch)
	Get the script used by a 32-bit codepoint.
void	SDL::SetFontLanguage (FontRef font, StringParam language_bcp47)
	Set language to be used for text shaping by a font.
bool	SDL::FontHasGlyph (FontRef font, Uint32 ch)
	Check whether a glyph is provided by the font for a UNICODE codepoint.
Surface	SDL::GetGlyphImage (FontRef font, Uint32 ch, ImageType *image_type)
	Get the pixel image for a UNICODE codepoint.
Surface	SDL::GetGlyphImageForIndex (FontRef font, Uint32 glyph_index, ImageType *image_type)
	Get the pixel image for a character index.
void	SDL::GetGlyphMetrics (FontRef font, Uint32 ch, int minx, int maxx, int miny, int maxy, int *advance)
	Query the metrics (dimensions) of a font's glyph for a UNICODE codepoint.
int	SDL::GetGlyphKerning (FontRef font, Uint32 previous_ch, Uint32 ch)
	Query the kerning size between the glyphs of two UNICODE codepoints.
void	SDL::GetStringSize (FontRef font, std::string_view text, int w, int h)
	Calculate the dimensions of a rendered string of UTF-8 text.
void	SDL::GetStringSizeWrapped (FontRef font, std::string_view text, int wrap_width, int w, int h)
	Calculate the dimensions of a rendered string of UTF-8 text.
void	SDL::MeasureString (FontRef font, std::string_view text, int max_width, int measured_width, size_t measured_length)
	Calculate how much of a UTF-8 string will fit in a given width.
Surface	SDL::RenderText_Solid (FontRef font, std::string_view text, Color fg)
	Render UTF-8 text at fast quality to a new 8-bit surface.
Surface	SDL::RenderText_Solid_Wrapped (FontRef font, std::string_view text, Color fg, int wrapLength)
	Render word-wrapped UTF-8 text at fast quality to a new 8-bit surface.
Surface	SDL::RenderGlyph_Solid (FontRef font, Uint32 ch, ColorRaw fg)
	Render a single 32-bit glyph at fast quality to a new 8-bit surface.
Surface	SDL::RenderText_Shaded (FontRef font, std::string_view text, Color fg, Color bg)
	Render UTF-8 text at high quality to a new 8-bit surface.
Surface	SDL::RenderText_Shaded_Wrapped (FontRef font, std::string_view text, Color fg, Color bg, int wrap_width)
	Render word-wrapped UTF-8 text at high quality to a new 8-bit surface.
Surface	SDL::RenderGlyph_Shaded (FontRef font, Uint32 ch, ColorRaw fg, ColorRaw bg)
	Render a single UNICODE codepoint at high quality to a new 8-bit surface.
Surface	SDL::RenderText_Blended (FontRef font, std::string_view text, Color fg)
	Render UTF-8 text at high quality to a new ARGB surface.
Surface	SDL::RenderText_Blended_Wrapped (FontRef font, std::string_view text, Color fg, int wrap_width)
	Render word-wrapped UTF-8 text at high quality to a new ARGB surface.
Surface	SDL::RenderGlyph_Blended (FontRef font, Uint32 ch, ColorRaw fg)
	Render a single UNICODE codepoint at high quality to a new ARGB surface.
Surface	SDL::RenderText_LCD (FontRef font, std::string_view text, Color fg, Color bg)
	Render UTF-8 text at LCD subpixel quality to a new ARGB surface.
Surface	SDL::RenderText_LCD_Wrapped (FontRef font, std::string_view text, Color fg, Color bg, int wrap_width)
	Render word-wrapped UTF-8 text at LCD subpixel quality to a new ARGB surface.
Surface	SDL::RenderGlyph_LCD (FontRef font, Uint32 ch, ColorRaw fg, ColorRaw bg)
	Render a single UNICODE codepoint at LCD subpixel quality to a new ARGB surface.
SurfaceTextEngine	SDL::CreateSurfaceTextEngine ()
	Create a text engine for drawing text on SDL surfaces.
void	SDL::DrawSurfaceText (TextConstRef text, Point p, SurfaceRef surface)
	Draw text to an SDL surface.
void	SDL::DestroySurfaceTextEngine (TextEngineRaw engine)
	Destroy a text engine created for drawing text on SDL surfaces.
RendererTextEngine	SDL::CreateRendererTextEngine (RendererRef renderer)
	Create a text engine for drawing text on an SDL renderer.
RendererTextEngine	SDL::CreateRendererTextEngineWithProperties (PropertiesRef props)
	Create a text engine for drawing text on an SDL renderer, with the specified properties.
void	SDL::DrawRendererText (TextConstRef text, FPoint p)
	Draw text to an SDL renderer.
void	SDL::DestroyRendererTextEngine (TextEngineRaw engine)
	Destroy a text engine created for drawing text on an SDL renderer.
GPUTextEngine	SDL::CreateGPUTextEngine (GPUDeviceRef device)
	Create a text engine for drawing text with the SDL GPU API.
GPUTextEngine	SDL::CreateGPUTextEngineWithProperties (PropertiesRef props)
	Create a text engine for drawing text with the SDL GPU API, with the specified properties.
GPUAtlasDrawSequence *	SDL::GetGPUTextDrawData (TextConstRef text)
	Get the geometry data needed for drawing the text.
void	SDL::DestroyGPUTextEngine (TextEngineRaw engine)
	Destroy a text engine created for drawing text with the SDL GPU API.
void	SDL::SetGPUTextEngineWinding (TextEngineRef engine, GPUTextEngineWinding winding)
	Sets the winding order of the vertices returned by Text.GetGPUDrawData for a particular GPU text engine.
GPUTextEngineWinding	SDL::GetGPUTextEngineWinding (TextEngineRef engine)
	Get the winding order of the vertices returned by Text.GetGPUDrawData for a particular GPU text engine.
Text	SDL::CreateText (TextEngineRef engine, FontRef font, std::string_view text)
	Create a text object from UTF-8 text and a text engine.
PropertiesRef	SDL::GetTextProperties (TextConstRef text)
	Get the properties associated with a text object.
void	SDL::SetTextEngine (TextRef text, TextEngineRef engine)
	Set the text engine used by a text object.
TextEngineRef	SDL::GetTextEngine (TextConstRef text)
	Get the text engine used by a text object.
bool	SDL::SetTextFont (TextRef text, FontRef font)
	Set the font used by a text object.
FontRef	SDL::GetTextFont (TextConstRef text)
	Get the font used by a text object.
void	SDL::SetTextDirection (TextRef text, Direction direction)
	Set the direction to be used for text shaping a text object.
Direction	SDL::GetTextDirection (TextConstRef text)
	Get the direction to be used for text shaping a text object.
void	SDL::SetTextScript (TextRef text, Uint32 script)
	Set the script to be used for text shaping a text object.
Uint32	SDL::GetTextScript (TextConstRef text)
	Get the script used for text shaping a text object.
void	SDL::SetTextColor (TextRef text, Color c)
	Set the color of a text object.
void	SDL::SetTextColorFloat (TextRef text, FColor c)
	Set the color of a text object.
void	SDL::GetTextColor (TextConstRef text, Uint8 r, Uint8 g, Uint8 b, Uint8 a)
	Get the color of a text object.
Color	SDL::GetTextColor (TextRef text)
	Get the color of a text object.
void	SDL::GetTextColorFloat (TextConstRef text, float r, float g, float b, float a)
	Get the color of a text object.
FColor	SDL::GetTextColorFloat (TextRef text)
	Get the color of a text object.
void	SDL::SetTextPosition (TextRef text, const PointRaw &p)
	Set the position of a text object.
void	SDL::GetTextPosition (TextConstRef text, int x, int y)
	Get the position of a text object.
Point	SDL::GetTextPosition (TextRef text)
	Get the position of a text object.
void	SDL::SetTextWrapWidth (TextRef text, int wrap_width)
	Set whether wrapping is enabled on a text object.
int	SDL::GetTextWrapWidth (TextConstRef text)
	Get whether wrapping is enabled on a text object.
void	SDL::SetTextWrapWhitespaceVisible (TextRef text, bool visible)
	Set whether whitespace should be visible when wrapping a text object.
bool	SDL::TextWrapWhitespaceVisible (TextConstRef text)
	Return whether whitespace is shown when wrapping a text object.
void	SDL::SetTextString (TextRef text, std::string_view string)
	Set the UTF-8 text used by a text object.
void	SDL::InsertTextString (TextRef text, int offset, std::string_view string)
	Insert UTF-8 text into a text object.
void	SDL::AppendTextString (TextRef text, std::string_view string)
	Append UTF-8 text to a text object.
void	SDL::DeleteTextString (TextRef text, int offset, int length)
	Delete UTF-8 text from a text object.
void	SDL::GetTextSize (TextConstRef text, int w, int h)
	Get the size of a text object.
Point	SDL::GetTextSize (TextRef text)
	Get the size of a text object.
void	SDL::GetTextSubString (TextConstRef text, int offset, SubString *substring)
	Get the substring of a text object that surrounds a text offset.
void	SDL::GetTextSubStringForLine (TextConstRef text, int line, SubString *substring)
	Get the substring of a text object that contains the given line.
OwnArray< SubString * >	SDL::GetTextSubStringsForRange (TextConstRef text, int offset, int length)
	Get the substrings of a text object that contain a range of text.
void	SDL::GetTextSubStringForPoint (TextConstRef text, Point p, SubString *substring)
	Get the portion of a text string that is closest to a point.
void	SDL::GetPreviousTextSubString (TextConstRef text, const SubString &substring, SubString *previous)
	Get the previous substring in a text object.
void	SDL::GetNextTextSubString (TextConstRef text, const SubString &substring, SubString *next)
	Get the next substring in a text object.
void	SDL::UpdateText (TextRef text)
	Update the layout of a text object.
void	SDL::DestroyText (TextRaw text)
	Destroy a text object created by a text engine.
void	SDL::CloseFont (FontRaw font)
	Dispose of a previously-created font.
	SDL::Font::Font (StringParam file, float ptsize)
	Create a font from a file, using a specified point size.
	SDL::Font::Font (IOStreamRef src, float ptsize, bool closeio=false)
	Create a font from an IOStream, using a specified point size.
	SDL::Font::Font (PropertiesRef props)
	Create a font with the specified properties.
Font	SDL::Font::Copy () const
	Create a copy of an existing font.
PropertiesRef	SDL::Font::GetProperties ()
	Get the properties associated with a font.
Uint32	SDL::Font::GetGeneration () const
	Get the font generation.
void	SDL::Font::AddFallback (FontRef fallback)
	Add a fallback font.
void	SDL::Font::RemoveFallback (FontRef fallback)
	Remove a fallback font.
void	SDL::Font::ClearFallbacks ()
	Remove all fallback fonts.
void	SDL::Font::SetSize (float ptsize)
	Set a font's size dynamically.
void	SDL::Font::SetSizeDPI (float ptsize, int hdpi, int vdpi)
	Set font size dynamically with target resolutions, in dots per inch.
float	SDL::Font::GetSize () const
	Get the size of a font.
void	SDL::Font::GetDPI (int hdpi, int vdpi) const
	Get font target resolutions, in dots per inch.
void	SDL::Font::SetStyle (FontStyleFlags style)
	Set a font's current style.
FontStyleFlags	SDL::Font::GetStyle () const
	Query a font's current style.
void	SDL::Font::SetOutline (int outline)
	Set a font's current outline.
int	SDL::Font::GetOutline () const
	Query a font's current outline.
void	SDL::Font::SetHinting (HintingFlags hinting)
	Set a font's current hinter setting.
int	SDL::Font::GetNumFaces () const
	Query the number of faces of a font.
HintingFlags	SDL::Font::GetHinting () const
	Query a font's current FreeType hinter setting.
void	SDL::Font::SetSDF (bool enabled)
	Enable Signed Distance Field rendering for a font.
bool	SDL::Font::GetSDF () const
	Query whether Signed Distance Field rendering is enabled for a font.
int	SDL::Font::GetWeight () const
	Query a font's weight, in terms of the lightness/heaviness of the strokes.
void	SDL::Font::SetWrapAlignment (HorizontalAlignment align)
	Set a font's current wrap alignment option.
HorizontalAlignment	SDL::Font::GetWrapAlignment () const
	Query a font's current wrap alignment option.
int	SDL::Font::GetHeight () const
	Query the total height of a font.
int	SDL::Font::GetAscent () const
	Query the offset from the baseline to the top of a font.
int	SDL::Font::GetDescent () const
	Query the offset from the baseline to the bottom of a font.
void	SDL::Font::SetLineSkip (int lineskip)
	Set the spacing between lines of text for a font.
int	SDL::Font::GetLineSkip () const
	Query the spacing between lines of text for a font.
void	SDL::Font::SetKerning (bool enabled)
	Set if kerning is enabled for a font.
bool	SDL::Font::GetKerning () const
	Query whether or not kerning is enabled for a font.
bool	SDL::Font::IsFixedWidth () const
	Query whether a font is fixed-width.
bool	SDL::Font::IsScalable () const
	Query whether a font is scalable or not.
const char *	SDL::Font::GetFamilyName () const
	Query a font's family name.
const char *	SDL::Font::GetStyleName () const
	Query a font's style name.
void	SDL::Font::SetDirection (Direction direction)
	Set the direction to be used for text shaping by a font.
Direction	SDL::Font::GetDirection () const
	Get the direction to be used for text shaping by a font.
void	SDL::Font::SetScript (Uint32 script)
	Set the script to be used for text shaping by a font.
Uint32	SDL::Font::GetScript () const
	Get the script used for text shaping a font.
static Uint32	SDL::Font::GetGlyphScript (Uint32 ch)
	Get the script used by a 32-bit codepoint.
void	SDL::Font::SetLanguage (StringParam language_bcp47)
	Set language to be used for text shaping by a font.
bool	SDL::Font::HasGlyph (Uint32 ch) const
	Check whether a glyph is provided by the font for a UNICODE codepoint.
Surface	SDL::Font::GetGlyphImage (Uint32 ch, ImageType *image_type) const
	Get the pixel image for a UNICODE codepoint.
Surface	SDL::Font::GetGlyphImageForIndex (Uint32 glyph_index, ImageType *image_type) const
	Get the pixel image for a character index.
void	SDL::Font::GetGlyphMetrics (Uint32 ch, int minx, int maxx, int miny, int maxy, int *advance) const
	Query the metrics (dimensions) of a font's glyph for a UNICODE codepoint.
int	SDL::Font::GetGlyphKerning (Uint32 previous_ch, Uint32 ch) const
	Query the kerning size between the glyphs of two UNICODE codepoints.
void	SDL::Font::GetStringSize (std::string_view text, int w, int h) const
	Calculate the dimensions of a rendered string of UTF-8 text.
void	SDL::Font::GetStringSizeWrapped (std::string_view text, int wrap_width, int w, int h) const
	Calculate the dimensions of a rendered string of UTF-8 text.
void	SDL::Font::MeasureString (std::string_view text, int max_width, int measured_width, size_t measured_length) const
	Calculate how much of a UTF-8 string will fit in a given width.
Surface	SDL::Font::RenderText_Solid (std::string_view text, Color fg) const
	Render UTF-8 text at fast quality to a new 8-bit surface.
Surface	SDL::Font::RenderText_Solid_Wrapped (std::string_view text, Color fg, int wrapLength) const
	Render word-wrapped UTF-8 text at fast quality to a new 8-bit surface.
Surface	SDL::Font::RenderGlyph_Solid (Uint32 ch, ColorRaw fg) const
	Render a single 32-bit glyph at fast quality to a new 8-bit surface.
Surface	SDL::Font::RenderText_Shaded (std::string_view text, Color fg, Color bg) const
	Render UTF-8 text at high quality to a new 8-bit surface.
Surface	SDL::Font::RenderText_Shaded_Wrapped (std::string_view text, Color fg, Color bg, int wrap_width) const
	Render word-wrapped UTF-8 text at high quality to a new 8-bit surface.
Surface	SDL::Font::RenderGlyph_Shaded (Uint32 ch, ColorRaw fg, ColorRaw bg) const
	Render a single UNICODE codepoint at high quality to a new 8-bit surface.
Surface	SDL::Font::RenderText_Blended (std::string_view text, Color fg) const
	Render UTF-8 text at high quality to a new ARGB surface.
Surface	SDL::Font::RenderText_Blended_Wrapped (std::string_view text, Color fg, int wrap_width) const
	Render word-wrapped UTF-8 text at high quality to a new ARGB surface.
Surface	SDL::Font::RenderGlyph_Blended (Uint32 ch, ColorRaw fg) const
	Render a single UNICODE codepoint at high quality to a new ARGB surface.
Surface	SDL::Font::RenderText_LCD (std::string_view text, Color fg, Color bg) const
	Render UTF-8 text at LCD subpixel quality to a new ARGB surface.
Surface	SDL::Font::RenderText_LCD_Wrapped (std::string_view text, Color fg, Color bg, int wrap_width) const
	Render word-wrapped UTF-8 text at LCD subpixel quality to a new ARGB surface.
Surface	SDL::Font::RenderGlyph_LCD (Uint32 ch, ColorRaw fg, ColorRaw bg) const
	Render a single UNICODE codepoint at LCD subpixel quality to a new ARGB surface.
	SDL::SurfaceTextEngine::SurfaceTextEngine ()
	Create a text engine for drawing text on SDL surfaces.
void	SDL::Text::DrawSurface (Point p, SurfaceRef surface) const
	Draw text to an SDL surface.
void	SDL::SurfaceTextEngine::Destroy () final
	Destroy a text engine created for drawing text on SDL surfaces.
	SDL::RendererTextEngine::RendererTextEngine (RendererRef renderer)
	Create a text engine for drawing text on an SDL renderer.
	SDL::RendererTextEngine::RendererTextEngine (PropertiesRef props)
	Create a text engine for drawing text on an SDL renderer, with the specified properties.
void	SDL::Text::DrawRenderer (FPoint p) const
	Draw text to an SDL renderer.
void	SDL::RendererTextEngine::Destroy () final
	Destroy a text engine created for drawing text on an SDL renderer.
	SDL::GPUTextEngine::GPUTextEngine (GPUDeviceRef device)
	Create a text engine for drawing text with the SDL GPU API.
	SDL::GPUTextEngine::GPUTextEngine (PropertiesRef props)
	Create a text engine for drawing text with the SDL GPU API, with the specified properties.
GPUAtlasDrawSequence *	SDL::Text::GetGPUDrawData () const
	Get the geometry data needed for drawing the text.
void	SDL::GPUTextEngine::Destroy () final
	Destroy a text engine created for drawing text with the SDL GPU API.
void	SDL::GPUTextEngine::SetGPUWinding (GPUTextEngineWinding winding)
	Sets the winding order of the vertices returned by Text.GetGPUDrawData for a particular GPU text engine.
GPUTextEngineWinding	SDL::GPUTextEngine::GetGPUWinding () const
	Get the winding order of the vertices returned by Text.GetGPUDrawData for a particular GPU text engine.
Text	SDL::TextEngine::CreateText (FontRef font, std::string_view text)
	Create a text object from UTF-8 text and a text engine.
	SDL::Text::Text (TextEngineRef engine, FontRef font, std::string_view text)
	Create a text object from UTF-8 text and a text engine.
PropertiesRef	SDL::Text::GetProperties () const
	Get the properties associated with a text object.
void	SDL::Text::SetEngine (TextEngineRef engine)
	Set the text engine used by a text object.
TextEngineRef	SDL::Text::GetEngine () const
	Get the text engine used by a text object.
bool	SDL::Text::SetFont (FontRef font)
	Set the font used by a text object.
FontRef	SDL::Text::GetFont () const
	Get the font used by a text object.
void	SDL::Text::SetDirection (Direction direction)
	Set the direction to be used for text shaping a text object.
Direction	SDL::Text::GetDirection () const
	Get the direction to be used for text shaping a text object.
void	SDL::Text::SetScript (Uint32 script)
	Set the script to be used for text shaping a text object.
Uint32	SDL::Text::GetScript () const
	Get the script used for text shaping a text object.
void	SDL::Text::SetColor (Color c)
	Set the color of a text object.
void	SDL::Text::SetColorFloat (FColor c)
	Set the color of a text object.
void	SDL::Text::GetColor (Uint8 r, Uint8 g, Uint8 b, Uint8 a) const
	Get the color of a text object.
Color	SDL::Text::GetColor () const
	Get the color of a text object.
void	SDL::Text::GetColorFloat (float r, float g, float b, float a) const
	Get the color of a text object.
FColor	SDL::Text::GetColorFloat () const
	Get the color of a text object.
void	SDL::Text::SetPosition (const PointRaw &p)
	Set the position of a text object.
void	SDL::Text::GetPosition (int x, int y) const
	Get the position of a text object.
Point	SDL::Text::GetPosition () const
	Get the position of a text object.
void	SDL::Text::SetWrapWidth (int wrap_width)
	Set whether wrapping is enabled on a text object.
int	SDL::Text::GetWrapWidth () const
	Get whether wrapping is enabled on a text object.
void	SDL::Text::SetWrapWhitespaceVisible (bool visible)
	Set whether whitespace should be visible when wrapping a text object.
bool	SDL::Text::IsWrapWhitespaceVisible () const
	Return whether whitespace is shown when wrapping a text object.
void	SDL::Text::SetString (std::string_view string)
	Set the UTF-8 text used by a text object.
void	SDL::Text::InsertString (int offset, std::string_view string)
	Insert UTF-8 text into a text object.
void	SDL::Text::AppendString (std::string_view string)
	Append UTF-8 text to a text object.
void	SDL::Text::DeleteString (int offset, int length)
	Delete UTF-8 text from a text object.
void	SDL::Text::GetSize (int w, int h) const
	Get the size of a text object.
Point	SDL::Text::GetSize () const
	Get the size of a text object.
void	SDL::Text::GetSubString (int offset, SubString *substring) const
	Get the substring of a text object that surrounds a text offset.
void	SDL::Text::GetSubStringForLine (int line, SubString *substring) const
	Get the substring of a text object that contains the given line.
OwnArray< SubString * >	SDL::Text::GetSubStringsForRange (int offset, int length=-1) const
	Get the substrings of a text object that contain a range of text.
void	SDL::Text::GetSubStringForPoint (Point p, SubString *substring) const
	Get the portion of a text string that is closest to a point.
void	SDL::Text::GetPreviousSubString (const SubString &substring, SubString *previous) const
	Get the previous substring in a text object.
void	SDL::Text::GetNextSubString (const SubString &substring, SubString *next) const
	Get the next substring in a text object.
void	SDL::Text::Update ()
	Update the layout of a text object.
void	SDL::Text::Destroy ()
	Destroy a text object created by a text engine.
void	SDL::Font::Close ()
	Dispose of a previously-created font.

Variables
constexpr FontStyleFlags	SDL::STYLE_NORMAL = TTF_STYLE_NORMAL
	No special style.
constexpr FontStyleFlags	SDL::STYLE_BOLD = TTF_STYLE_BOLD
	Bold style.
constexpr FontStyleFlags	SDL::STYLE_ITALIC = TTF_STYLE_ITALIC
	Italic style.
constexpr FontStyleFlags	SDL::STYLE_UNDERLINE
	Underlined text.
constexpr FontStyleFlags	SDL::STYLE_STRIKETHROUGH
	Strikethrough text.
constexpr HintingFlags	SDL::HINTING_INVALID = TTF_HINTING_INVALID
	INVALID.
constexpr HintingFlags	SDL::HINTING_NORMAL
	Normal hinting applies standard grid-fitting.
constexpr HintingFlags	SDL::HINTING_LIGHT = TTF_HINTING_LIGHT
	Light hinting applies subtle adjustments to improve rendering.
constexpr HintingFlags	SDL::HINTING_MONO = TTF_HINTING_MONO
	Monochrome hinting adjusts the font for better rendering at lower resolutions.
constexpr HintingFlags	SDL::HINTING_NONE = TTF_HINTING_NONE
	No hinting, the font is rendered without any grid-fitting.
constexpr HintingFlags	SDL::HINTING_LIGHT_SUBPIXEL = TTF_HINTING_LIGHT_SUBPIXEL
	Light hinting with subpixel rendering for more precise font edges.
constexpr HorizontalAlignment	SDL::HORIZONTAL_ALIGN_INVALID
	INVALID.
constexpr HorizontalAlignment	SDL::HORIZONTAL_ALIGN_LEFT
	LEFT.
constexpr HorizontalAlignment	SDL::HORIZONTAL_ALIGN_CENTER
	CENTER.
constexpr HorizontalAlignment	SDL::HORIZONTAL_ALIGN_RIGHT
	RIGHT.
constexpr Direction	SDL::DIRECTION_INVALID = TTF_DIRECTION_INVALID
	INVALID.
constexpr Direction	SDL::DIRECTION_LTR = TTF_DIRECTION_LTR
	Left to Right.
constexpr Direction	SDL::DIRECTION_RTL = TTF_DIRECTION_RTL
	Right to Left.
constexpr Direction	SDL::DIRECTION_TTB = TTF_DIRECTION_TTB
	Top to Bottom.
constexpr Direction	SDL::DIRECTION_BTT = TTF_DIRECTION_BTT
	Bottom to Top.
constexpr ImageType	SDL::IMAGE_INVALID = TTF_IMAGE_INVALID
	INVALID.
constexpr ImageType	SDL::IMAGE_ALPHA
	The color channels are white.
constexpr ImageType	SDL::IMAGE_COLOR
	The color channels have image data.
constexpr ImageType	SDL::IMAGE_SDF = TTF_IMAGE_SDF
	The alpha channel has signed distance field information.
constexpr int	SDL::FONT_WEIGHT_THIN
	Thin (100) named font weight value.
constexpr int	SDL::FONT_WEIGHT_EXTRA_LIGHT
	ExtraLight (200) named font weight value.
constexpr int	SDL::FONT_WEIGHT_LIGHT
	Light (300) named font weight value.
constexpr int	SDL::FONT_WEIGHT_NORMAL
	Normal (400) named font weight value.
constexpr int	SDL::FONT_WEIGHT_MEDIUM
	Medium (500) named font weight value.
constexpr int	SDL::FONT_WEIGHT_SEMI_BOLD
	SemiBold (600) named font weight value.
constexpr int	SDL::FONT_WEIGHT_BOLD
	Bold (700) named font weight value.
constexpr int	SDL::FONT_WEIGHT_EXTRA_BOLD
	ExtraBold (800) named font weight value.
constexpr int	SDL::FONT_WEIGHT_BLACK
	Black (900) named font weight value.
constexpr int	SDL::FONT_WEIGHT_EXTRA_BLACK
	ExtraBlack (950) named font weight value.
constexpr SubStringFlags	SDL::SUBSTRING_DIRECTION_MASK
	The mask for the flow direction for this substring.
constexpr SubStringFlags	SDL::SUBSTRING_TEXT_START
	This substring contains the beginning of the text.
constexpr SubStringFlags	SDL::SUBSTRING_LINE_START = TTF_SUBSTRING_LINE_START
	This substring contains the beginning of line line_index.
constexpr SubStringFlags	SDL::SUBSTRING_LINE_END = TTF_SUBSTRING_LINE_END
	This substring contains the end of line line_index.
constexpr SubStringFlags	SDL::SUBSTRING_TEXT_END
	This substring contains the end of the text.
constexpr GPUTextEngineWinding	SDL::GPU_TEXTENGINE_WINDING_INVALID
	INVALID.
constexpr GPUTextEngineWinding	SDL::GPU_TEXTENGINE_WINDING_CLOCKWISE
	CLOCKWISE.
constexpr GPUTextEngineWinding	SDL::GPU_TEXTENGINE_WINDING_COUNTER_CLOCKWISE
	COUNTER_CLOCKWISE.

Detailed Description

Header file for SDL_ttf library.

This library is a wrapper around the excellent FreeType 2.0 library, available at: https://www.freetype.org/

Macro Definition Documentation

◆ SDL_TTF_VERSION

#define SDL_TTF_VERSION

Value:

SDL_VERSIONNUM( \

SDL_TTF_MAJOR_VERSION, SDL_TTF_MINOR_VERSION, SDL_TTF_MICRO_VERSION)

SDL_VERSIONNUM

#define SDL_VERSIONNUM(major, minor, patch)

This macro turns the version numbers into a numeric value.

Definition SDL3pp_version.h:57

This is the version number macro for the current SDL_ttf version.

◆ SDL_TTF_VERSION_ATLEAST

#define SDL_TTF_VERSION_ATLEAST	(	X,
		Y,
		Z )

Value:

((SDL_TTF_MAJOR_VERSION >= X) &&                                             \
 (SDL_TTF_MAJOR_VERSION > X || SDL_TTF_MINOR_VERSION >= Y) &&                \
 (SDL_TTF_MAJOR_VERSION > X || SDL_TTF_MINOR_VERSION > Y ||                  \
  SDL_TTF_MICRO_VERSION >= Z))

This macro will evaluate to true if compiled with SDL_ttf at least X.Y.Z.

Typedef Documentation

◆ Direction

using SDL::Direction = TTF_Direction

Direction flags.

The values here are chosen to match hb_direction_t

Since: This enum is available since SDL_ttf 3.0.0.

See also: Font.SetDirection

◆ FontStyleFlags

using SDL::FontStyleFlags = Uint32

Font style flags for Font.

These are the flags which can be used to set the style of a font in SDL_ttf. A combination of these flags can be used with functions that set or query font style, such as Font.SetStyle or Font.GetStyle.

Since: This datatype is available since SDL_ttf 3.0.0.

See also: Font.SetStyle; Font.GetStyle

◆ GPUAtlasDrawSequence

using SDL::GPUAtlasDrawSequence = TTF_GPUAtlasDrawSequence

Draw sequence returned by Text.GetGPUDrawData.

Since: This struct is available since SDL_ttf 3.0.0.

See also: Text.GetGPUDrawData

◆ GPUTextEngineWinding

using SDL::GPUTextEngineWinding = TTF_GPUTextEngineWinding

The winding order of the vertices returned by Text.GetGPUDrawData.

Since: This enum is available since SDL_ttf 3.0.0.

◆ HintingFlags

using SDL::HintingFlags = TTF_HintingFlags

Hinting flags for TTF (TrueType Fonts).

This enum specifies the level of hinting to be applied to the font rendering. The hinting level determines how much the font's outlines are adjusted for better alignment on the pixel grid.

Since: This enum is available since SDL_ttf 3.0.0.

See also: Font.SetHinting; Font.GetHinting

◆ HorizontalAlignment

using SDL::HorizontalAlignment = TTF_HorizontalAlignment

The horizontal alignment used when rendering wrapped text.

Since: This enum is available since SDL_ttf 3.0.0.

◆ ImageType

using SDL::ImageType = TTF_ImageType

The type of data in a glyph image.

Since: This enum is available since SDL_ttf 3.0.0.

◆ SubString

using SDL::SubString = TTF_SubString

The representation of a substring within text.

Since: This struct is available since SDL_ttf 3.0.0.

See also: Text.GetNextSubString; Text.GetPreviousSubString; Text.GetSubString; Text.GetSubStringForLine; Text.GetSubStringForPoint; Text.GetSubStringsForRange

◆ SubStringFlags

using SDL::SubStringFlags = Uint32

Flags for SubString.

Since: This datatype is available since SDL_ttf 3.0.0.

See also: SubString

◆ TextData

using SDL::TextData = TTF_TextData

Internal data for Text.

Since: This struct is available since SDL_ttf 3.0.0.

Function Documentation

◆ AddFallback()

void SDL::Font::AddFallback ( FontRef fallback )

inline

Add a fallback font.

Add a font that will be used for glyphs that are not in the current font. The fallback font should have the same size and style as the current font.

If there are multiple fallback fonts, they are used in the order added.

This updates any Text objects using this font.

Parameters

fallback the font to add as a fallback.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created both fonts.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.ClearFallbacks; Font.RemoveFallback

◆ AddFallbackFont()

void SDL::AddFallbackFont	(	FontRef	font,
		FontRef	fallback )

inline

Add a fallback font.

Add a font that will be used for glyphs that are not in the current font. The fallback font should have the same size and style as the current font.

If there are multiple fallback fonts, they are used in the order added.

This updates any Text objects using this font.

Parameters

font	the font to modify.
fallback	the font to add as a fallback.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created both fonts.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.ClearFallbacks; Font.RemoveFallback

◆ AppendString()

void SDL::Text::AppendString ( std::string_view string )

inline

Append UTF-8 text to a text object.

This function may cause the internal text representation to be rebuilt.

Parameters

string the UTF-8 text to insert.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.DeleteString; Text.InsertString; Text.SetString

◆ AppendTextString()

void SDL::AppendTextString	(	TextRef	text,
		std::string_view	string )

inline

Append UTF-8 text to a text object.

This function may cause the internal text representation to be rebuilt.

Parameters

text	the Text to modify.
string	the UTF-8 text to insert.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.DeleteString; Text.InsertString; Text.SetString

◆ ClearFallbackFonts()

void SDL::ClearFallbackFonts ( FontRef font )

inline

Remove all fallback fonts.

This updates any Text objects using this font.

Parameters

font	the font to modify.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.AddFallback; Font.RemoveFallback

◆ ClearFallbacks()

void SDL::Font::ClearFallbacks ( )

inline

Remove all fallback fonts.

This updates any Text objects using this font.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.AddFallback; Font.RemoveFallback

◆ Close()

void SDL::Font::Close ( )

inline

Dispose of a previously-created font.

Call this when done with a font. This function will free any resources associated with it. It is safe to call this function on nullptr, for example on the result of a failed call to OpenFont().

The font is not valid after being passed to this function. String pointers from functions that return information on this font, such as Font.GetFamilyName() and Font.GetStyleName(), are no longer valid after this call, as well.

Thread safety:: This function should not be called while any other thread is using the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: OpenFont; OpenFontIO

◆ CloseFont()

void SDL::CloseFont ( FontRaw font )

inline

Dispose of a previously-created font.

Call this when done with a font. This function will free any resources associated with it. It is safe to call this function on nullptr, for example on the result of a failed call to OpenFont().

The font is not valid after being passed to this function. String pointers from functions that return information on this font, such as Font.GetFamilyName() and Font.GetStyleName(), are no longer valid after this call, as well.

Parameters

font	the font to dispose of.

Thread safety:: This function should not be called while any other thread is using the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: OpenFont; OpenFontIO

◆ Copy()

Font SDL::Font::Copy ( ) const

inline

Create a copy of an existing font.

The copy will be distinct from the original, but will share the font file and have the same size and style as the original.

Returns: a valid Font on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the original font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.Close

◆ CopyFont()

Font SDL::CopyFont ( FontRef existing_font )

inline

Create a copy of an existing font.

The copy will be distinct from the original, but will share the font file and have the same size and style as the original.

When done with the returned Font, use Font.Close() to dispose of it.

Parameters

existing_font the font to copy.

Returns: a valid Font on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the original font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.Close

◆ CreateGPUTextEngine()

GPUTextEngine SDL::CreateGPUTextEngine ( GPUDeviceRef device )

inline

Create a text engine for drawing text with the SDL GPU API.

Parameters

device the GPUDevice to use for creating textures and drawing text.

Returns: a TextEngine object or nullptr on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the device.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateGPUTextEngineWithProperties; GPUTextEngine.Destroy; Text.GetGPUDrawData

◆ CreateGPUTextEngineWithProperties()

GPUTextEngine SDL::CreateGPUTextEngineWithProperties ( PropertiesRef props )

inline

Create a text engine for drawing text with the SDL GPU API, with the specified properties.

These are the supported properties:

prop::GpuTextEngine.DEVICE_POINTER: the GPUDevice to use for creating textures and drawing text.
prop::GpuTextEngine.ATLAS_TEXTURE_SIZE_NUMBER: the size of the texture atlas

Parameters

props the properties to use.

Returns: a TextEngine object or nullptr on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the device.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateGPUTextEngine; GPUTextEngine.Destroy; Text.GetGPUDrawData

◆ CreateRendererTextEngine()

RendererTextEngine SDL::CreateRendererTextEngine ( RendererRef renderer )

inline

Create a text engine for drawing text on an SDL renderer.

Parameters

renderer the renderer to use for creating textures and drawing text.

Returns: a TextEngine object or nullptr on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the renderer.

Since: This function is available since SDL_ttf 3.0.0.

See also: RendererTextEngine.Destroy; Text.DrawRenderer; CreateRendererTextEngineWithProperties

◆ CreateRendererTextEngineWithProperties()

RendererTextEngine SDL::CreateRendererTextEngineWithProperties ( PropertiesRef props )

inline

Create a text engine for drawing text on an SDL renderer, with the specified properties.

These are the supported properties:

prop::RendererTextEngine.RENDERER_POINTER: the renderer to use for creating textures and drawing text
prop::RendererTextEngine.ATLAS_TEXTURE_SIZE_NUMBER: the size of the texture atlas

Parameters

props the properties to use.

Returns: a TextEngine object or nullptr on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the renderer.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateRendererTextEngine; RendererTextEngine.Destroy; Text.DrawRenderer

◆ CreateSurfaceTextEngine()

SurfaceTextEngine SDL::CreateSurfaceTextEngine ( )

inline

Create a text engine for drawing text on SDL surfaces.

Returns: a TextEngine object or nullptr on failure; call GetError() for more information.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: SurfaceTextEngine.Destroy; Text.DrawSurface

◆ CreateText() [1/2]

Text SDL::CreateText	(	TextEngineRef	engine,
		FontRef	font,
		std::string_view	text )

inline

Create a text object from UTF-8 text and a text engine.

Parameters

engine	the text engine to use when creating the text object, may be nullptr.
font	the font to render with.
text	the text to use, in UTF-8 encoding.

Returns: a Text object or nullptr on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the font and text engine.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.Destroy

◆ CreateText() [2/2]

Text SDL::TextEngine::CreateText	(	FontRef	font,
		std::string_view	text )

inline

Create a text object from UTF-8 text and a text engine.

Parameters

font	the font to render with.
text	the text to use, in UTF-8 encoding.

Returns: a Text object or nullptr on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the font and text engine.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.Destroy

◆ DeleteString()

void SDL::Text::DeleteString	(	int	offset,
		int	length )

inline

Delete UTF-8 text from a text object.

This function may cause the internal text representation to be rebuilt.

Parameters

offset	the offset, in bytes, from the beginning of the string if >= 0, the offset from the end of the string if < 0. Note that this does not do UTF-8 validation, so you should only delete at UTF-8 sequence boundaries.
length	the length of text to delete, in bytes, or -1 for the remainder of the string.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.AppendString; Text.InsertString; Text.SetString

◆ DeleteTextString()

void SDL::DeleteTextString	(	TextRef	text,
		int	offset,
		int	length )

inline

Delete UTF-8 text from a text object.

This function may cause the internal text representation to be rebuilt.

Parameters

text	the Text to modify.
offset	the offset, in bytes, from the beginning of the string if >= 0, the offset from the end of the string if < 0. Note that this does not do UTF-8 validation, so you should only delete at UTF-8 sequence boundaries.
length	the length of text to delete, in bytes, or -1 for the remainder of the string.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.AppendString; Text.InsertString; Text.SetString

◆ Destroy() [1/4]

void SDL::GPUTextEngine::Destroy ( )

inlinefinalvirtual

Destroy a text engine created for drawing text with the SDL GPU API.

All text created by this engine should be destroyed before calling this function.

Thread safety:: This function should be called on the thread that created the engine.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateGPUTextEngine

Implements SDL::TextEngine.

◆ Destroy() [2/4]

void SDL::RendererTextEngine::Destroy ( )

inlinefinalvirtual

Destroy a text engine created for drawing text on an SDL renderer.

All text created by this engine should be destroyed before calling this function.

Thread safety:: This function should be called on the thread that created the engine.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateRendererTextEngine

Implements SDL::TextEngine.

◆ Destroy() [3/4]

void SDL::SurfaceTextEngine::Destroy ( )

inlinefinalvirtual

Destroy a text engine created for drawing text on SDL surfaces.

All text created by this engine should be destroyed before calling this function.

Thread safety:: This function should be called on the thread that created the engine.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateSurfaceTextEngine

Implements SDL::TextEngine.

◆ Destroy() [4/4]

void SDL::Text::Destroy ( )

inline

Destroy a text object created by a text engine.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: TextEngine.CreateText

◆ DestroyGPUTextEngine()

void SDL::DestroyGPUTextEngine ( TextEngineRaw engine )

inline

Destroy a text engine created for drawing text with the SDL GPU API.

All text created by this engine should be destroyed before calling this function.

Parameters

engine a TextEngine object created with CreateGPUTextEngine().

Thread safety:: This function should be called on the thread that created the engine.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateGPUTextEngine

◆ DestroyRendererTextEngine()

void SDL::DestroyRendererTextEngine ( TextEngineRaw engine )

inline

Destroy a text engine created for drawing text on an SDL renderer.

All text created by this engine should be destroyed before calling this function.

Parameters

engine a TextEngine object created with CreateRendererTextEngine().

Thread safety:: This function should be called on the thread that created the engine.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateRendererTextEngine

◆ DestroySurfaceTextEngine()

void SDL::DestroySurfaceTextEngine ( TextEngineRaw engine )

inline

Destroy a text engine created for drawing text on SDL surfaces.

All text created by this engine should be destroyed before calling this function.

Parameters

engine a TextEngine object created with CreateSurfaceTextEngine().

Thread safety:: This function should be called on the thread that created the engine.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateSurfaceTextEngine

◆ DestroyText()

void SDL::DestroyText ( TextRaw text )

inline

Destroy a text object created by a text engine.

Parameters

text	the text to destroy.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: TextEngine.CreateText

◆ DrawRenderer()

void SDL::Text::DrawRenderer ( FPoint p ) const

inline

Draw text to an SDL renderer.

text must have been created using a TextEngine from CreateRendererTextEngine(), and will draw using the renderer passed to that function.

Parameters

p	the x,y coordinates in pixels, positive from the top-left edge towards the bottom-right.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateRendererTextEngine; TextEngine.CreateText

◆ DrawRendererText()

void SDL::DrawRendererText	(	TextConstRef	text,
		FPoint	p )

inline

Draw text to an SDL renderer.

text must have been created using a TextEngine from CreateRendererTextEngine(), and will draw using the renderer passed to that function.

Parameters

text	the text to draw.
p	the (x, y) coordinate in pixels, positive from the left edge towards the right and from the top edge towards the bottom.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateRendererTextEngine; TextEngine.CreateText

◆ DrawSurface()

void SDL::Text::DrawSurface	(	Point	p,
		SurfaceRef	surface ) const

inline

Draw text to an SDL surface.

text must have been created using a TextEngine from CreateSurfaceTextEngine().

Parameters

p	the x,y coordinates in pixels, positive from the top-left edge towards the bottom-right.
surface	the surface to draw on.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateSurfaceTextEngine; TextEngine.CreateText

◆ DrawSurfaceText()

void SDL::DrawSurfaceText	(	TextConstRef	text,
		Point	p,
		SurfaceRef	surface )

inline

Draw text to an SDL surface.

text must have been created using a TextEngine from CreateSurfaceTextEngine().

Parameters

text	the text to draw.
p	the (x, y) coordinate in pixels, positive from the left edge towards the right and from the top edge towards the bottom.
surface	the surface to draw on.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateSurfaceTextEngine; TextEngine.CreateText

◆ Font() [1/3]

SDL::Font::Font	(	IOStreamRef	src,
		float	ptsize,
		bool	closeio = false )

inline

Create a font from an IOStream, using a specified point size.

Some .fon fonts will have several sizes embedded in the file, so the point size becomes the index of choosing which size. If the value is too high, the last indexed size will be the default.

If closeio is true, src will be automatically closed once the font is closed. Otherwise you should keep src open until the font is closed.

Parameters

src	an IOStream to provide a font file's data.
ptsize	point size to use for the newly-opened font.
closeio	true to close src when the font is closed, false to leave it open.

Postcondition: a valid Font on success.

Exceptions

Error on failure.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.Close

◆ Font() [2/3]

SDL::Font::Font ( PropertiesRef props )

inline

Create a font with the specified properties.

These are the supported properties:

prop::Font.CREATE_FILENAME_STRING: the font file to open, if an IOStream isn't being used. This is required if prop::Font.CREATE_IOSTREAM_POINTER and prop::Font.CREATE_EXISTING_FONT aren't set.
prop::Font.CREATE_IOSTREAM_POINTER: an IOStream containing the font to be opened. This should not be closed until the font is closed. This is required if prop::Font.CREATE_FILENAME_STRING and prop::Font.CREATE_EXISTING_FONT aren't set.
prop::Font.CREATE_IOSTREAM_OFFSET_NUMBER: the offset in the iostream for the beginning of the font, defaults to 0.
prop::Font.CREATE_IOSTREAM_AUTOCLOSE_BOOLEAN: true if closing the font should also close the associated IOStream.
prop::Font.CREATE_SIZE_FLOAT: the point size of the font. Some .fon fonts will have several sizes embedded in the file, so the point size becomes the index of choosing which size. If the value is too high, the last indexed size will be the default.
prop::Font.CREATE_FACE_NUMBER: the face index of the font, if the font contains multiple font faces.
prop::Font.CREATE_HORIZONTAL_DPI_NUMBER: the horizontal DPI to use for font rendering, defaults to prop::Font.CREATE_VERTICAL_DPI_NUMBER if set, or 72 otherwise.
prop::Font.CREATE_VERTICAL_DPI_NUMBER: the vertical DPI to use for font rendering, defaults to prop::Font.CREATE_HORIZONTAL_DPI_NUMBER if set, or 72 otherwise.
prop::Font.CREATE_EXISTING_FONT: an optional Font that, if set, will be used as the font data source and the initial size and style of the new font.

Parameters

props the properties to use.

Postcondition: a valid Font on success.

Exceptions

Error on failure.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.Close

◆ Font() [3/3]

SDL::Font::Font	(	StringParam	file,
		float	ptsize )

inline

Create a font from a file, using a specified point size.

Some .fon fonts will have several sizes embedded in the file, so the point size becomes the index of choosing which size. If the value is too high, the last indexed size will be the default.

Parameters

file	path to font file.
ptsize	point size to use for the newly-opened font.

Postcondition: a valid Font on success.

Exceptions

Error on failure.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.Close

◆ FontHasGlyph()

bool SDL::FontHasGlyph	(	FontRef	font,
		Uint32	ch )

inline

Check whether a glyph is provided by the font for a UNICODE codepoint.

Parameters

font	the font to query.
ch	the codepoint to check.

Returns: true if font provides a glyph for this character, false if not.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ FontIsFixedWidth()

bool SDL::FontIsFixedWidth ( FontRef font )

inline

Query whether a font is fixed-width.

A "fixed-width" font means all glyphs are the same width across; a lowercase 'i' will be the same size across as a capital 'W', for example. This is common for terminals and text editors, and other apps that treat text as a grid. Most other things (WYSIWYG word processors, web pages, etc) are more likely to not be fixed-width in most cases.

Parameters

font	the font to query.

Returns: true if the font is fixed-width, false otherwise.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ FontIsScalable()

bool SDL::FontIsScalable ( FontRef font )

inline

Query whether a font is scalable or not.

Scalability lets us distinguish between outline and bitmap fonts.

Parameters

font	the font to query.

Returns: true if the font is scalable, false otherwise.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetSDF

◆ GetAscent()

int SDL::Font::GetAscent ( ) const

inline

Query the offset from the baseline to the top of a font.

This is a positive value, relative to the baseline.

Returns: the font's ascent.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetColor() [1/2]

Color SDL::Text::GetColor ( ) const

inline

Get the color of a text object.

Returns: The color in the range of 0-255 on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetColorFloat; Text.SetColor

◆ GetColor() [2/2]

void SDL::Text::GetColor	(	Uint8 *	r,
		Uint8 *	g,
		Uint8 *	b,
		Uint8 *	a ) const

inline

Get the color of a text object.

Parameters

r	a pointer filled in with the red color value in the range of 0-255, may be nullptr.
g	a pointer filled in with the green color value in the range of 0-255, may be nullptr.
b	a pointer filled in with the blue color value in the range of 0-255, may be nullptr.
a	a pointer filled in with the alpha value in the range of 0-255, may be nullptr.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetColorFloat; Text.SetColor

◆ GetColorFloat() [1/2]

FColor SDL::Text::GetColorFloat ( ) const

inline

Get the color of a text object.

Returns: The color in the range of 0-1 on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetColor; Text.SetColorFloat

◆ GetColorFloat() [2/2]

void SDL::Text::GetColorFloat	(	float *	r,
		float *	g,
		float *	b,
		float *	a ) const

inline

Get the color of a text object.

Parameters

r	a pointer filled in with the red color value, normally in the range of 0-1, may be nullptr.
g	a pointer filled in with the green color value, normally in the range of 0-1, may be nullptr.
b	a pointer filled in with the blue color value, normally in the range of 0-1, may be nullptr.
a	a pointer filled in with the alpha value in the range of 0-1, may be nullptr.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetColor; Text.SetColorFloat

◆ GetDescent()

int SDL::Font::GetDescent ( ) const

inline

Query the offset from the baseline to the bottom of a font.

This is a negative value, relative to the baseline.

Returns: the font's descent.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetDirection() [1/2]

Direction SDL::Font::GetDirection ( ) const

inline

Get the direction to be used for text shaping by a font.

This defaults to DIRECTION_INVALID if it hasn't been set.

Returns: the direction to be used for text shaping.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetDirection() [2/2]

Direction SDL::Text::GetDirection ( ) const

inline

Get the direction to be used for text shaping a text object.

This defaults to the direction of the font used by the text object.

Returns: the direction to be used for text shaping.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetDPI()

void SDL::Font::GetDPI	(	int *	hdpi,
		int *	vdpi ) const

inline

Get font target resolutions, in dots per inch.

Parameters

hdpi	a pointer filled in with the target horizontal DPI.
vdpi	a pointer filled in with the target vertical DPI.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetSizeDPI

◆ GetEngine()

TextEngineRef SDL::Text::GetEngine ( ) const

inline

Get the text engine used by a text object.

Returns: the TextEngine used by the text on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.SetEngine

◆ GetFamilyName()

const char * SDL::Font::GetFamilyName ( ) const

inline

Query a font's family name.

This string is dictated by the contents of the font file.

Note that the returned string is to internal storage, and should not be modified or free'd by the caller. The string becomes invalid, with the rest of the font, when font is handed to Font.Close().

Returns: the font's family name.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetFont()

FontRef SDL::Text::GetFont ( ) const

inline

Get the font used by a text object.

Returns: the Font used by the text on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.SetFont

◆ GetFontAscent()

int SDL::GetFontAscent ( FontRef font )

inline

Query the offset from the baseline to the top of a font.

This is a positive value, relative to the baseline.

Parameters

font	the font to query.

Returns: the font's ascent.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetFontDescent()

int SDL::GetFontDescent ( FontRef font )

inline

Query the offset from the baseline to the bottom of a font.

This is a negative value, relative to the baseline.

Parameters

font	the font to query.

Returns: the font's descent.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetFontDirection()

Direction SDL::GetFontDirection ( FontRef font )

inline

Get the direction to be used for text shaping by a font.

This defaults to DIRECTION_INVALID if it hasn't been set.

Parameters

font	the font to query.

Returns: the direction to be used for text shaping.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetFontDPI()

void SDL::GetFontDPI	(	FontRef	font,
		int *	hdpi,
		int *	vdpi )

inline

Get font target resolutions, in dots per inch.

Parameters

font	the font to query.
hdpi	a pointer filled in with the target horizontal DPI.
vdpi	a pointer filled in with the target vertical DPI.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetSizeDPI

◆ GetFontFamilyName()

const char * SDL::GetFontFamilyName ( FontRef font )

inline

Query a font's family name.

This string is dictated by the contents of the font file.

Note that the returned string is to internal storage, and should not be modified or free'd by the caller. The string becomes invalid, with the rest of the font, when font is handed to Font.Close().

Parameters

font	the font to query.

Returns: the font's family name.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetFontGeneration()

Uint32 SDL::GetFontGeneration ( FontRef font )

inline

Get the font generation.

The generation is incremented each time font properties change that require rebuilding glyphs, such as style, size, etc.

Parameters

font	the font to query.

Returns: the font generation or 0 on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetFontHeight()

int SDL::GetFontHeight ( FontRef font )

inline

Query the total height of a font.

This is usually equal to point size.

Parameters

font	the font to query.

Returns: the font's height.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetFontHinting()

HintingFlags SDL::GetFontHinting ( FontRef font )

inline

Query a font's current FreeType hinter setting.

The hinter setting is a single value:

HINTING_NORMAL
HINTING_LIGHT
HINTING_MONO
HINTING_NONE
HINTING_LIGHT_SUBPIXEL (available in SDL_ttf 3.0.0 and later)

Parameters

font	the font to query.

Returns: the font's current hinter value, or HINTING_INVALID if the font is invalid.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetHinting

◆ GetFontKerning()

bool SDL::GetFontKerning ( FontRef font )

inline

Query whether or not kerning is enabled for a font.

Parameters

font	the font to query.

Returns: true if kerning is enabled, false otherwise.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetKerning

◆ GetFontLineSkip()

int SDL::GetFontLineSkip ( FontRef font )

inline

Query the spacing between lines of text for a font.

Parameters

font	the font to query.

Returns: the font's recommended spacing.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetLineSkip

◆ GetFontOutline()

int SDL::GetFontOutline ( FontRef font )

inline

Query a font's current outline.

Parameters

font	the font to query.

Returns: the font's current outline value.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetOutline

◆ GetFontProperties()

PropertiesRef SDL::GetFontProperties ( FontRef font )

inline

Get the properties associated with a font.

The following read-write properties are provided by SDL:

prop::Font.OUTLINE_LINE_CAP_NUMBER: The FT_Stroker_LineCap value used when setting the font outline, defaults to FT_STROKER_LINECAP_ROUND.
prop::Font.OUTLINE_LINE_JOIN_NUMBER: The FT_Stroker_LineJoin value used when setting the font outline, defaults to FT_STROKER_LINEJOIN_ROUND.
prop::Font.OUTLINE_MITER_LIMIT_NUMBER: The FT_Fixed miter limit used when setting the font outline, defaults to 0.

Parameters

font	the font to query.

Returns: a valid property ID on success.

Exceptions

Error on failure.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetFontScript()

Uint32 SDL::GetFontScript ( FontRef font )

inline

Get the script used for text shaping a font.

Parameters

font	the font to query.

Returns: an ISO 15924 code or 0 if a script hasn't been set.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: TagToString

◆ GetFontSDF()

bool SDL::GetFontSDF ( FontRef font )

inline

Query whether Signed Distance Field rendering is enabled for a font.

Parameters

font	the font to query.

Returns: true if enabled, false otherwise.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetSDF

◆ GetFontSize()

float SDL::GetFontSize ( FontRef font )

inline

Get the size of a font.

Parameters

font	the font to query.

Returns: the size of the font, or 0.0f on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetSize; Font.SetSizeDPI

◆ GetFontStyle()

FontStyleFlags SDL::GetFontStyle ( FontRef font )

inline

Query a font's current style.

The font styles are a set of bit flags, OR'd together:

STYLE_NORMAL (is zero)
STYLE_BOLD
STYLE_ITALIC
STYLE_UNDERLINE
STYLE_STRIKETHROUGH

Parameters

font	the font to query.

Returns: the current font style, as a set of bit flags.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetStyle

◆ GetFontStyleName()

const char * SDL::GetFontStyleName ( FontRef font )

inline

Query a font's style name.

This string is dictated by the contents of the font file.

Note that the returned string is to internal storage, and should not be modified or free'd by the caller. The string becomes invalid, with the rest of the font, when font is handed to Font.Close().

Parameters

font	the font to query.

Returns: the font's style name.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetFontWeight()

int SDL::GetFontWeight ( FontRef font )

inline

Query a font's weight, in terms of the lightness/heaviness of the strokes.

Parameters

font	the font to query.

Returns: the font's current weight.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.2.2.

◆ GetFontWrapAlignment()

HorizontalAlignment SDL::GetFontWrapAlignment ( FontRef font )

inline

Query a font's current wrap alignment option.

Parameters

font	the font to query.

Returns: the font's current wrap alignment option.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetWrapAlignment

◆ GetFreeTypeVersion()

void SDL::GetFreeTypeVersion	(	int *	major,
		int *	minor,
		int *	patch )

inline

Query the version of the FreeType library in use.

TTF.Init() should be called before calling this function.

Parameters

major	to be filled in with the major version number. Can be nullptr.
minor	to be filled in with the minor version number. Can be nullptr.
patch	to be filled in with the param version number. Can be nullptr.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: TTF.Init

◆ GetGeneration()

Uint32 SDL::Font::GetGeneration ( ) const

inline

Get the font generation.

The generation is incremented each time font properties change that require rebuilding glyphs, such as style, size, etc.

Returns: the font generation or 0 on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetGlyphImage() [1/2]

Surface SDL::Font::GetGlyphImage	(	Uint32	ch,
		ImageType *	image_type ) const

inline

Get the pixel image for a UNICODE codepoint.

Parameters

ch	the codepoint to check.
image_type	a pointer filled in with the glyph image type, may be nullptr.

Returns: an Surface containing the glyph on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetGlyphImage() [2/2]

Surface SDL::GetGlyphImage	(	FontRef	font,
		Uint32	ch,
		ImageType *	image_type )

inline

Get the pixel image for a UNICODE codepoint.

Parameters

font	the font to query.
ch	the codepoint to check.
image_type	a pointer filled in with the glyph image type, may be nullptr.

Returns: an Surface containing the glyph on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetGlyphImageForIndex() [1/2]

Surface SDL::Font::GetGlyphImageForIndex	(	Uint32	glyph_index,
		ImageType *	image_type ) const

inline

Get the pixel image for a character index.

This is useful for text engine implementations, which can call this with the glyph_index in a TTF_CopyOperation

Parameters

glyph_index	the index of the glyph to return.
image_type	a pointer filled in with the glyph image type, may be nullptr.

Returns: an Surface containing the glyph on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetGlyphImageForIndex() [2/2]

Surface SDL::GetGlyphImageForIndex	(	FontRef	font,
		Uint32	glyph_index,
		ImageType *	image_type )

inline

Get the pixel image for a character index.

This is useful for text engine implementations, which can call this with the glyph_index in a TTF_CopyOperation

Parameters

font	the font to query.
glyph_index	the index of the glyph to return.
image_type	a pointer filled in with the glyph image type, may be nullptr.

Returns: an Surface containing the glyph on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetGlyphKerning() [1/2]

int SDL::Font::GetGlyphKerning	(	Uint32	previous_ch,
		Uint32	ch ) const

inline

Query the kerning size between the glyphs of two UNICODE codepoints.

Parameters

previous_ch	the previous codepoint.
ch	the current codepoint.

Returns: the kerning size between the two glyphs, in pixels.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetGlyphKerning() [2/2]

int SDL::GetGlyphKerning	(	FontRef	font,
		Uint32	previous_ch,
		Uint32	ch )

inline

Query the kerning size between the glyphs of two UNICODE codepoints.

Parameters

font	the font to query.
previous_ch	the previous codepoint.
ch	the current codepoint.

Returns: the kerning size between the two glyphs, in pixels.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetGlyphMetrics() [1/2]

void SDL::Font::GetGlyphMetrics	(	Uint32	ch,
		int *	minx,
		int *	maxx,
		int *	miny,
		int *	maxy,
		int *	advance ) const

inline

Query the metrics (dimensions) of a font's glyph for a UNICODE codepoint.

To understand what these metrics mean, here is a useful link:

https://freetype.sourceforge.net/freetype2/docs/tutorial/step2.html

Parameters

ch	the codepoint to check.
minx	a pointer filled in with the minimum x coordinate of the glyph from the left edge of its bounding box. This value may be negative.
maxx	a pointer filled in with the maximum x coordinate of the glyph from the left edge of its bounding box.
miny	a pointer filled in with the minimum y coordinate of the glyph from the bottom edge of its bounding box. This value may be negative.
maxy	a pointer filled in with the maximum y coordinate of the glyph from the bottom edge of its bounding box.
advance	a pointer filled in with the distance to the next glyph from the left edge of this glyph's bounding box.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetGlyphMetrics() [2/2]

void SDL::GetGlyphMetrics	(	FontRef	font,
		Uint32	ch,
		int *	minx,
		int *	maxx,
		int *	miny,
		int *	maxy,
		int *	advance )

inline

Query the metrics (dimensions) of a font's glyph for a UNICODE codepoint.

To understand what these metrics mean, here is a useful link:

https://freetype.sourceforge.net/freetype2/docs/tutorial/step2.html

Parameters

font	the font to query.
ch	the codepoint to check.
minx	a pointer filled in with the minimum x coordinate of the glyph from the left edge of its bounding box. This value may be negative.
maxx	a pointer filled in with the maximum x coordinate of the glyph from the left edge of its bounding box.
miny	a pointer filled in with the minimum y coordinate of the glyph from the bottom edge of its bounding box. This value may be negative.
maxy	a pointer filled in with the maximum y coordinate of the glyph from the bottom edge of its bounding box.
advance	a pointer filled in with the distance to the next glyph from the left edge of this glyph's bounding box.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetGlyphScript() [1/2]

Uint32 SDL::Font::GetGlyphScript ( Uint32 ch )

inlinestatic

Get the script used by a 32-bit codepoint.

Parameters

ch	the character code to check.

Returns: an ISO 15924 code on success.

Exceptions

Error on failure.

Thread safety:: This function is thread-safe.

Since: This function is available since SDL_ttf 3.0.0.

See also: TagToString

◆ GetGlyphScript() [2/2]

Uint32 SDL::GetGlyphScript ( Uint32 ch )

inline

Get the script used by a 32-bit codepoint.

Parameters

ch	the character code to check.

Returns: an ISO 15924 code on success.

Exceptions

Error on failure.

Thread safety:: This function is thread-safe.

Since: This function is available since SDL_ttf 3.0.0.

See also: TagToString

◆ GetGPUDrawData()

GPUAtlasDrawSequence * SDL::Text::GetGPUDrawData ( ) const

inline

Get the geometry data needed for drawing the text.

text must have been created using a TextEngine from CreateGPUTextEngine().

The positive X-axis is taken towards the right and the positive Y-axis is taken upwards for both the vertex and the texture coordinates, i.e, it follows the same convention used by the SDL_GPU API. If you want to use a different coordinate system you will need to transform the vertices yourself.

If the text looks blocky use linear filtering.

Returns: a nullptr terminated linked list of GPUAtlasDrawSequence objects or nullptr if the passed text is empty or in case of failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateGPUTextEngine; TextEngine.CreateText

◆ GetGPUTextDrawData()

GPUAtlasDrawSequence * SDL::GetGPUTextDrawData ( TextConstRef text )

inline

Get the geometry data needed for drawing the text.

text must have been created using a TextEngine from CreateGPUTextEngine().

The positive X-axis is taken towards the right and the positive Y-axis is taken upwards for both the vertex and the texture coordinates, i.e, it follows the same convention used by the SDL_GPU API. If you want to use a different coordinate system you will need to transform the vertices yourself.

If the text looks blocky use linear filtering.

Parameters

text	the text to draw.

Returns: a nullptr terminated linked list of GPUAtlasDrawSequence objects or nullptr if the passed text is empty or in case of failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateGPUTextEngine; TextEngine.CreateText

◆ GetGPUTextEngineWinding()

GPUTextEngineWinding SDL::GetGPUTextEngineWinding ( TextEngineRef engine )

inline

Get the winding order of the vertices returned by Text.GetGPUDrawData for a particular GPU text engine.

Parameters

engine a TextEngine object created with GPUTextEngine.GPUTextEngine().

Returns: the winding order used by the GPU text engine or GPU_TEXTENGINE_WINDING_INVALID in case of error.

Thread safety:: This function should be called on the thread that created the engine.

Since: This function is available since SDL_ttf 3.0.0.

See also: GPUTextEngine.SetGPUWinding

◆ GetGPUWinding()

GPUTextEngineWinding SDL::GPUTextEngine::GetGPUWinding ( ) const

inline

Get the winding order of the vertices returned by Text.GetGPUDrawData for a particular GPU text engine.

Returns: the winding order used by the GPU text engine or GPU_TEXTENGINE_WINDING_INVALID in case of error.

Thread safety:: This function should be called on the thread that created the engine.

Since: This function is available since SDL_ttf 3.0.0.

See also: GPUTextEngine.SetGPUWinding

◆ GetHarfBuzzVersion()

void SDL::GetHarfBuzzVersion	(	int *	major,
		int *	minor,
		int *	patch )

inline

Query the version of the HarfBuzz library in use.

If HarfBuzz is not available, the version reported is 0.0.0.

Parameters

major	to be filled in with the major version number. Can be nullptr.
minor	to be filled in with the minor version number. Can be nullptr.
patch	to be filled in with the param version number. Can be nullptr.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetHeight()

int SDL::Font::GetHeight ( ) const

inline

Query the total height of a font.

This is usually equal to point size.

Returns: the font's height.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetHinting()

HintingFlags SDL::Font::GetHinting ( ) const

inline

Query a font's current FreeType hinter setting.

The hinter setting is a single value:

HINTING_NORMAL
HINTING_LIGHT
HINTING_MONO
HINTING_NONE
HINTING_LIGHT_SUBPIXEL (available in SDL_ttf 3.0.0 and later)

Returns: the font's current hinter value, or HINTING_INVALID if the font is invalid.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetHinting

◆ GetKerning()

bool SDL::Font::GetKerning ( ) const

inline

Query whether or not kerning is enabled for a font.

Returns: true if kerning is enabled, false otherwise.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetKerning

◆ GetLineSkip()

int SDL::Font::GetLineSkip ( ) const

inline

Query the spacing between lines of text for a font.

Returns: the font's recommended spacing.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetLineSkip

◆ GetNextSubString()

void SDL::Text::GetNextSubString	(	const SubString &	substring,
		SubString *	next ) const

inline

Get the next substring in a text object.

If called at the end of the text, this will return a zero length substring with the SUBSTRING_TEXT_END flag set.

Parameters

substring	the SubString to query.
next	a pointer filled in with the next substring.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetNextTextSubString()

void SDL::GetNextTextSubString	(	TextConstRef	text,
		const SubString &	substring,
		SubString *	next )

inline

Get the next substring in a text object.

If called at the end of the text, this will return a zero length substring with the SUBSTRING_TEXT_END flag set.

Parameters

text	the Text to query.
substring	the SubString to query.
next	a pointer filled in with the next substring.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetNumFaces()

int SDL::Font::GetNumFaces ( ) const

inline

Query the number of faces of a font.

Returns: the number of FreeType font faces.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetNumFontFaces()

int SDL::GetNumFontFaces ( FontRef font )

inline

Query the number of faces of a font.

Parameters

font	the font to query.

Returns: the number of FreeType font faces.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetOutline()

int SDL::Font::GetOutline ( ) const

inline

Query a font's current outline.

Returns: the font's current outline value.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetOutline

◆ GetPosition() [1/2]

Point SDL::Text::GetPosition ( ) const

inline

Get the position of a text object.

Returns: a Point with the offset of the upper left corner of this text in pixels on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.SetPosition

◆ GetPosition() [2/2]

void SDL::Text::GetPosition	(	int *	x,
		int *	y ) const

inline

Get the position of a text object.

Parameters

x	a pointer filled in with the x offset of the upper left corner of this text in pixels, may be nullptr.
y	a pointer filled in with the y offset of the upper left corner of this text in pixels, may be nullptr.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.SetPosition

◆ GetPreviousSubString()

void SDL::Text::GetPreviousSubString	(	const SubString &	substring,
		SubString *	previous ) const

inline

Get the previous substring in a text object.

If called at the start of the text, this will return a zero length substring with the SUBSTRING_TEXT_START flag set.

Parameters

substring	the SubString to query.
previous	a pointer filled in with the previous substring in the text object.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetPreviousTextSubString()

void SDL::GetPreviousTextSubString	(	TextConstRef	text,
		const SubString &	substring,
		SubString *	previous )

inline

Get the previous substring in a text object.

If called at the start of the text, this will return a zero length substring with the SUBSTRING_TEXT_START flag set.

Parameters

text	the Text to query.
substring	the SubString to query.
previous	a pointer filled in with the previous substring in the text object.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetProperties() [1/2]

PropertiesRef SDL::Font::GetProperties ( )

inline

Get the properties associated with a font.

The following read-write properties are provided by SDL:

prop::Font.OUTLINE_LINE_CAP_NUMBER: The FT_Stroker_LineCap value used when setting the font outline, defaults to FT_STROKER_LINECAP_ROUND.
prop::Font.OUTLINE_LINE_JOIN_NUMBER: The FT_Stroker_LineJoin value used when setting the font outline, defaults to FT_STROKER_LINEJOIN_ROUND.
prop::Font.OUTLINE_MITER_LIMIT_NUMBER: The FT_Fixed miter limit used when setting the font outline, defaults to 0.

Returns: a valid property ID on success.

Exceptions

Error on failure.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetProperties() [2/2]

PropertiesRef SDL::Text::GetProperties ( ) const

inline

Get the properties associated with a text object.

Returns: a valid property ID on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetScript() [1/2]

Uint32 SDL::Font::GetScript ( ) const

inline

Get the script used for text shaping a font.

Returns: an ISO 15924 code or 0 if a script hasn't been set.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: TagToString

◆ GetScript() [2/2]

Uint32 SDL::Text::GetScript ( ) const

inline

Get the script used for text shaping a text object.

This defaults to the script of the font used by the text object.

Returns: an ISO 15924 code or 0 if a script hasn't been set on either the text object or the font.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: TagToString

◆ GetSDF()

bool SDL::Font::GetSDF ( ) const

inline

Query whether Signed Distance Field rendering is enabled for a font.

Returns: true if enabled, false otherwise.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetSDF

◆ GetSize() [1/3]

float SDL::Font::GetSize ( ) const

inline

Get the size of a font.

Returns: the size of the font, or 0.0f on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetSize; Font.SetSizeDPI

◆ GetSize() [2/3]

Point SDL::Text::GetSize ( ) const

inline

Get the size of a text object.

The size of the text may change when the font or font style and size change.

Returns: Point containing the size on x and y axis on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: GetSize(int*,int*) if might want only one of the coordinates

◆ GetSize() [3/3]

void SDL::Text::GetSize	(	int *	w,
		int *	h ) const

inline

Get the size of a text object.

The size of the text may change when the font or font style and size change.

Parameters

w	a pointer filled in with the width of the text, in pixels, may be nullptr.
h	a pointer filled in with the height of the text, in pixels, may be nullptr.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetStringSize() [1/2]

void SDL::Font::GetStringSize	(	std::string_view	text,
		int *	w,
		int *	h ) const

inline

Calculate the dimensions of a rendered string of UTF-8 text.

This will report the width and height, in pixels, of the space that the specified string will take to fully render.

Parameters

text	text to calculate, in UTF-8 encoding.
w	will be filled with width, in pixels, on return.
h	will be filled with height, in pixels, on return.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetStringSize() [2/2]

void SDL::GetStringSize	(	FontRef	font,
		std::string_view	text,
		int *	w,
		int *	h )

inline

Calculate the dimensions of a rendered string of UTF-8 text.

This will report the width and height, in pixels, of the space that the specified string will take to fully render.

Parameters

font	the font to query.
text	text to calculate, in UTF-8 encoding.
w	will be filled with width, in pixels, on return.
h	will be filled with height, in pixels, on return.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetStringSizeWrapped() [1/2]

void SDL::Font::GetStringSizeWrapped	(	std::string_view	text,
		int	wrap_width,
		int *	w,
		int *	h ) const

inline

Calculate the dimensions of a rendered string of UTF-8 text.

This will report the width and height, in pixels, of the space that the specified string will take to fully render.

Text is wrapped to multiple lines on line endings and on word boundaries if it extends beyond wrap_width in pixels.

If wrap_width is 0, this function will only wrap on newline characters.

Parameters

text	text to calculate, in UTF-8 encoding.
wrap_width	the maximum width or 0 to wrap on newline characters.
w	will be filled with width, in pixels, on return.
h	will be filled with height, in pixels, on return.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetStringSizeWrapped() [2/2]

void SDL::GetStringSizeWrapped	(	FontRef	font,
		std::string_view	text,
		int	wrap_width,
		int *	w,
		int *	h )

inline

Calculate the dimensions of a rendered string of UTF-8 text.

This will report the width and height, in pixels, of the space that the specified string will take to fully render.

Text is wrapped to multiple lines on line endings and on word boundaries if it extends beyond wrap_width in pixels.

If wrap_width is 0, this function will only wrap on newline characters.

Parameters

font	the font to query.
text	text to calculate, in UTF-8 encoding.
wrap_width	the maximum width or 0 to wrap on newline characters.
w	will be filled with width, in pixels, on return.
h	will be filled with height, in pixels, on return.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetStyle()

FontStyleFlags SDL::Font::GetStyle ( ) const

inline

Query a font's current style.

The font styles are a set of bit flags, OR'd together:

STYLE_NORMAL (is zero)
STYLE_BOLD
STYLE_ITALIC
STYLE_UNDERLINE
STYLE_STRIKETHROUGH

Returns: the current font style, as a set of bit flags.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetStyle

◆ GetStyleName()

const char * SDL::Font::GetStyleName ( ) const

inline

Query a font's style name.

This string is dictated by the contents of the font file.

Note that the returned string is to internal storage, and should not be modified or free'd by the caller. The string becomes invalid, with the rest of the font, when font is handed to Font.Close().

Returns: the font's style name.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetSubString()

void SDL::Text::GetSubString	(	int	offset,
		SubString *	substring ) const

inline

Get the substring of a text object that surrounds a text offset.

If offset is less than 0, this will return a zero length substring at the beginning of the text with the SUBSTRING_TEXT_START flag set. If offset is greater than or equal to the length of the text string, this will return a zero length substring at the end of the text with the SUBSTRING_TEXT_END flag set.

Parameters

offset	a byte offset into the text string.
substring	a pointer filled in with the substring containing the offset.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetSubStringForLine()

void SDL::Text::GetSubStringForLine	(	int	line,
		SubString *	substring ) const

inline

Get the substring of a text object that contains the given line.

If line is less than 0, this will return a zero length substring at the beginning of the text with the SUBSTRING_TEXT_START flag set. If line is greater than or equal to text->num_lines this will return a zero length substring at the end of the text with the SUBSTRING_TEXT_END flag set.

Parameters

line	a zero-based line index, in the range [0 .. text->num_lines-1].
substring	a pointer filled in with the substring containing the offset.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetSubStringForPoint()

void SDL::Text::GetSubStringForPoint	(	Point	p,
		SubString *	substring ) const

inline

Get the portion of a text string that is closest to a point.

This will return the closest substring of text to the given point.

Parameters

p	the coordinates relative to the top-left side of the text, may be outside the bounds of the text area.
substring	a pointer filled in with the closest substring of text to the given point.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetSubStringsForRange()

OwnArray< SubString * > SDL::Text::GetSubStringsForRange	(	int	offset,
		int	length = -1 ) const

inline

Get the substrings of a text object that contain a range of text.

Parameters

offset	a byte offset into the text string.
length	the length of the range being queried, in bytes, or -1 for the remainder of the string.

Returns: a nullptr terminated array of substring pointers or nullptr on failure; call GetError() for more information. This is a single allocation that should be freed with free() when it is no longer needed.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetTextColor() [1/2]

void SDL::GetTextColor	(	TextConstRef	text,
		Uint8 *	r,
		Uint8 *	g,
		Uint8 *	b,
		Uint8 *	a )

inline

Get the color of a text object.

Parameters

text	the Text to query.
r	a pointer filled in with the red color value in the range of 0-255, may be nullptr.
g	a pointer filled in with the green color value in the range of 0-255, may be nullptr.
b	a pointer filled in with the blue color value in the range of 0-255, may be nullptr.
a	a pointer filled in with the alpha value in the range of 0-255, may be nullptr.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetColorFloat; Text.SetColor

◆ GetTextColor() [2/2]

Color SDL::GetTextColor ( TextRef text )

inline

Get the color of a text object.

Parameters

text	the Text to query.

Returns: The color in the range of 0-255 on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetColorFloat; Text.SetColor

◆ GetTextColorFloat() [1/2]

void SDL::GetTextColorFloat	(	TextConstRef	text,
		float *	r,
		float *	g,
		float *	b,
		float *	a )

inline

Get the color of a text object.

Parameters

text	the Text to query.
r	a pointer filled in with the red color value, normally in the range of 0-1, may be nullptr.
g	a pointer filled in with the green color value, normally in the range of 0-1, may be nullptr.
b	a pointer filled in with the blue color value, normally in the range of 0-1, may be nullptr.
a	a pointer filled in with the alpha value in the range of 0-1, may be nullptr.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetColor; Text.SetColorFloat

◆ GetTextColorFloat() [2/2]

FColor SDL::GetTextColorFloat ( TextRef text )

inline

Get the color of a text object.

Parameters

text	the Text to query.

Returns: The color in the range of 0-1 on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetColor; Text.SetColorFloat

◆ GetTextDirection()

Direction SDL::GetTextDirection ( TextConstRef text )

inline

Get the direction to be used for text shaping a text object.

This defaults to the direction of the font used by the text object.

Parameters

text	the text to query.

Returns: the direction to be used for text shaping.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetTextEngine()

TextEngineRef SDL::GetTextEngine ( TextConstRef text )

inline

Get the text engine used by a text object.

Parameters

text	the Text to query.

Returns: the TextEngine used by the text on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.SetEngine

◆ GetTextFont()

FontRef SDL::GetTextFont ( TextConstRef text )

inline

Get the font used by a text object.

Parameters

text	the Text to query.

Returns: the Font used by the text on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.SetFont

◆ GetTextPosition() [1/2]

void SDL::GetTextPosition	(	TextConstRef	text,
		int *	x,
		int *	y )

inline

Get the position of a text object.

Parameters

text	the Text to query.
x	a pointer filled in with the x offset of the upper left corner of this text in pixels, may be nullptr.
y	a pointer filled in with the y offset of the upper left corner of this text in pixels, may be nullptr.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.SetPosition

◆ GetTextPosition() [2/2]

Point SDL::GetTextPosition ( TextRef text )

inline

Get the position of a text object.

Parameters

text	the Text to query.

Returns: a Point with the offset of the upper left corner of this text in pixels on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.SetPosition

◆ GetTextProperties()

PropertiesRef SDL::GetTextProperties ( TextConstRef text )

inline

Get the properties associated with a text object.

Parameters

text	the Text to query.

Returns: a valid property ID on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetTextScript()

Uint32 SDL::GetTextScript ( TextConstRef text )

inline

Get the script used for text shaping a text object.

This defaults to the script of the font used by the text object.

Parameters

text	the text to query.

Returns: an ISO 15924 code or 0 if a script hasn't been set on either the text object or the font.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: TagToString

◆ GetTextSize() [1/2]

void SDL::GetTextSize	(	TextConstRef	text,
		int *	w,
		int *	h )

inline

Get the size of a text object.

The size of the text may change when the font or font style and size change.

Parameters

text	the Text to query.
w	a pointer filled in with the width of the text, in pixels, may be nullptr.
h	a pointer filled in with the height of the text, in pixels, may be nullptr.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetTextSize() [2/2]

Point SDL::GetTextSize ( TextRef text )

inline

Get the size of a text object.

The size of the text may change when the font or font style and size change.

Parameters

text	the Text to query.

Returns: Point containing the size on x and y axis on success or std::nullopt on failure; call GetError() for more information.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetTextSubString()

void SDL::GetTextSubString	(	TextConstRef	text,
		int	offset,
		SubString *	substring )

inline

Get the substring of a text object that surrounds a text offset.

If offset is less than 0, this will return a zero length substring at the beginning of the text with the SUBSTRING_TEXT_START flag set. If offset is greater than or equal to the length of the text string, this will return a zero length substring at the end of the text with the SUBSTRING_TEXT_END flag set.

Parameters

text	the Text to query.
offset	a byte offset into the text string.
substring	a pointer filled in with the substring containing the offset.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetTextSubStringForLine()

void SDL::GetTextSubStringForLine	(	TextConstRef	text,
		int	line,
		SubString *	substring )

inline

Get the substring of a text object that contains the given line.

If line is less than 0, this will return a zero length substring at the beginning of the text with the SUBSTRING_TEXT_START flag set. If line is greater than or equal to text->num_lines this will return a zero length substring at the end of the text with the SUBSTRING_TEXT_END flag set.

Parameters

text	the Text to query.
line	a zero-based line index, in the range [0 .. text->num_lines-1].
substring	a pointer filled in with the substring containing the offset.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetTextSubStringForPoint()

void SDL::GetTextSubStringForPoint	(	TextConstRef	text,
		Point	p,
		SubString *	substring )

inline

Get the portion of a text string that is closest to a point.

This will return the closest substring of text to the given point.

Parameters

text	the Text to query.
p	the coordinates relative to the top-left side of the text, may be outside the bounds of the text area.
substring	a pointer filled in with the closest substring of text to the given point.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetTextSubStringsForRange()

OwnArray< SubString * > SDL::GetTextSubStringsForRange	(	TextConstRef	text,
		int	offset,
		int	length )

inline

Get the substrings of a text object that contain a range of text.

Parameters

text	the Text to query.
offset	a byte offset into the text string.
length	the length of the range being queried, in bytes, or -1 for the remainder of the string.

Returns: a nullptr terminated array of substring pointers or nullptr on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ GetTextWrapWidth()

int SDL::GetTextWrapWidth ( TextConstRef text )

inline

Get whether wrapping is enabled on a text object.

Parameters

text	the Text to query.

Returns: maximum width in pixels or 0 if the text is being wrapped on newline characters.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.SetWrapWidth

◆ GetWeight()

int SDL::Font::GetWeight ( ) const

inline

Query a font's weight, in terms of the lightness/heaviness of the strokes.

Returns: the font's current weight.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.2.2.

◆ GetWrapAlignment()

HorizontalAlignment SDL::Font::GetWrapAlignment ( ) const

inline

Query a font's current wrap alignment option.

Returns: the font's current wrap alignment option.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetWrapAlignment

◆ GetWrapWidth()

int SDL::Text::GetWrapWidth ( ) const

inline

Get whether wrapping is enabled on a text object.

Returns: an int with the maximum width in pixels or 0 if the text is being wrapped on newline characters on success.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.SetWrapWidth

◆ GPUTextEngine() [1/2]

SDL::GPUTextEngine::GPUTextEngine ( GPUDeviceRef device )

inline

Create a text engine for drawing text with the SDL GPU API.

Parameters

device the GPUDevice to use for creating textures and drawing text.

Postcondition: a TextEngine object or nullptr on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the device.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateGPUTextEngineWithProperties; GPUTextEngine.Destroy; Text.GetGPUDrawData

◆ GPUTextEngine() [2/2]

SDL::GPUTextEngine::GPUTextEngine ( PropertiesRef props )

inline

Create a text engine for drawing text with the SDL GPU API, with the specified properties.

These are the supported properties:

prop::GpuTextEngine.DEVICE_POINTER: the GPUDevice to use for creating textures and drawing text.
prop::GpuTextEngine.ATLAS_TEXTURE_SIZE_NUMBER: the size of the texture atlas

Parameters

props the properties to use.

Postcondition: a TextEngine object or nullptr on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the device.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateGPUTextEngine; GPUTextEngine.Destroy; Text.GetGPUDrawData

◆ HasGlyph()

bool SDL::Font::HasGlyph ( Uint32 ch ) const

inline

Check whether a glyph is provided by the font for a UNICODE codepoint.

Parameters

ch	the codepoint to check.

Returns: true if font provides a glyph for this character, false if not.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ InsertString()

void SDL::Text::InsertString	(	int	offset,
		std::string_view	string )

inline

Insert UTF-8 text into a text object.

This function may cause the internal text representation to be rebuilt.

Parameters

offset	the offset, in bytes, from the beginning of the string if >= 0, the offset from the end of the string if < 0. Note that this does not do UTF-8 validation, so you should only insert at UTF-8 sequence boundaries.
string	the UTF-8 text to insert.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.AppendString; Text.DeleteString; Text.SetString

◆ InsertTextString()

void SDL::InsertTextString	(	TextRef	text,
		int	offset,
		std::string_view	string )

inline

Insert UTF-8 text into a text object.

This function may cause the internal text representation to be rebuilt.

Parameters

text	the Text to modify.
offset	the offset, in bytes, from the beginning of the string if >= 0, the offset from the end of the string if < 0. Note that this does not do UTF-8 validation, so you should only insert at UTF-8 sequence boundaries.
string	the UTF-8 text to insert.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.AppendString; Text.DeleteString; Text.SetString

◆ IsFixedWidth()

bool SDL::Font::IsFixedWidth ( ) const

inline

Query whether a font is fixed-width.

A "fixed-width" font means all glyphs are the same width across; a lowercase 'i' will be the same size across as a capital 'W', for example. This is common for terminals and text editors, and other apps that treat text as a grid. Most other things (WYSIWYG word processors, web pages, etc) are more likely to not be fixed-width in most cases.

Returns: true if the font is fixed-width, false otherwise.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

◆ IsScalable()

bool SDL::Font::IsScalable ( ) const

inline

Query whether a font is scalable or not.

Scalability lets us distinguish between outline and bitmap fonts.

Returns: true if the font is scalable, false otherwise.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.SetSDF

◆ IsWrapWhitespaceVisible()

bool SDL::Text::IsWrapWhitespaceVisible ( ) const

inline

Return whether whitespace is shown when wrapping a text object.

Returns: true if whitespace is shown when wrapping text, or false otherwise.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.SetWrapWhitespaceVisible

◆ MeasureString() [1/2]

void SDL::Font::MeasureString	(	std::string_view	text,
		int	max_width,
		int *	measured_width,
		size_t *	measured_length ) const

inline

Calculate how much of a UTF-8 string will fit in a given width.

This reports the number of characters that can be rendered before reaching max_width.

This does not need to render the string to do this calculation.

Parameters

text	text to calculate, in UTF-8 encoding.
max_width	maximum width, in pixels, available for the string, or 0 for unbounded width.
measured_width	a pointer filled in with the width, in pixels, of the string that will fit, may be nullptr.
measured_length	a pointer filled in with the length, in bytes, of the string that will fit, may be nullptr.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ MeasureString() [2/2]

void SDL::MeasureString	(	FontRef	font,
		std::string_view	text,
		int	max_width,
		int *	measured_width,
		size_t *	measured_length )

inline

Calculate how much of a UTF-8 string will fit in a given width.

This reports the number of characters that can be rendered before reaching max_width.

This does not need to render the string to do this calculation.

Parameters

font	the font to query.
text	text to calculate, in UTF-8 encoding.
max_width	maximum width, in pixels, available for the string, or 0 for unbounded width.
measured_width	a pointer filled in with the width, in pixels, of the string that will fit, may be nullptr.
measured_length	a pointer filled in with the length, in bytes, of the string that will fit, may be nullptr.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ OpenFont()

Font SDL::OpenFont	(	StringParam	file,
		float	ptsize )

inline

Create a font from a file, using a specified point size.

Some .fon fonts will have several sizes embedded in the file, so the point size becomes the index of choosing which size. If the value is too high, the last indexed size will be the default.

When done with the returned Font, use Font.Close() to dispose of it.

Parameters

file	path to font file.
ptsize	point size to use for the newly-opened font.

Returns: a valid Font on success.

Exceptions

Error on failure.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.Close

◆ OpenFontIO()

Font SDL::OpenFontIO	(	IOStreamRef	src,
		float	ptsize,
		bool	closeio = false )

inline

Create a font from an IOStream, using a specified point size.

Some .fon fonts will have several sizes embedded in the file, so the point size becomes the index of choosing which size. If the value is too high, the last indexed size will be the default.

If closeio is true, src will be automatically closed once the font is closed. Otherwise you should keep src open until the font is closed.

When done with the returned Font, use Font.Close() to dispose of it.

Parameters

src	an IOStream to provide a font file's data.
ptsize	point size to use for the newly-opened font.
closeio	true to close src when the font is closed, false to leave it open.

Returns: a valid Font on success.

Exceptions

Error on failure.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.Close

◆ OpenFontWithProperties()

Font SDL::OpenFontWithProperties ( PropertiesRef props )

inline

Create a font with the specified properties.

These are the supported properties:

prop::Font.CREATE_FILENAME_STRING: the font file to open, if an IOStream isn't being used. This is required if prop::Font.CREATE_IOSTREAM_POINTER and prop::Font.CREATE_EXISTING_FONT aren't set.
prop::Font.CREATE_IOSTREAM_POINTER: an IOStream containing the font to be opened. This should not be closed until the font is closed. This is required if prop::Font.CREATE_FILENAME_STRING and prop::Font.CREATE_EXISTING_FONT aren't set.
prop::Font.CREATE_IOSTREAM_OFFSET_NUMBER: the offset in the iostream for the beginning of the font, defaults to 0.
prop::Font.CREATE_IOSTREAM_AUTOCLOSE_BOOLEAN: true if closing the font should also close the associated IOStream.
prop::Font.CREATE_SIZE_FLOAT: the point size of the font. Some .fon fonts will have several sizes embedded in the file, so the point size becomes the index of choosing which size. If the value is too high, the last indexed size will be the default.
prop::Font.CREATE_FACE_NUMBER: the face index of the font, if the font contains multiple font faces.
prop::Font.CREATE_HORIZONTAL_DPI_NUMBER: the horizontal DPI to use for font rendering, defaults to prop::Font.CREATE_VERTICAL_DPI_NUMBER if set, or 72 otherwise.
prop::Font.CREATE_VERTICAL_DPI_NUMBER: the vertical DPI to use for font rendering, defaults to prop::Font.CREATE_HORIZONTAL_DPI_NUMBER if set, or 72 otherwise.
prop::Font.CREATE_EXISTING_FONT: an optional Font that, if set, will be used as the font data source and the initial size and style of the new font.

Parameters

props the properties to use.

Returns: a valid Font on success.

Exceptions

Error on failure.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.Close

◆ RemoveFallback()

void SDL::Font::RemoveFallback ( FontRef fallback )

inline

Remove a fallback font.

This updates any Text objects using this font.

Parameters

fallback the font to remove as a fallback.

Thread safety:: This function should be called on the thread that created both fonts.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.AddFallback; Font.ClearFallbacks

◆ RemoveFallbackFont()

void SDL::RemoveFallbackFont	(	FontRef	font,
		FontRef	fallback )

inline

Remove a fallback font.

This updates any Text objects using this font.

Parameters

font	the font to modify.
fallback	the font to remove as a fallback.

Thread safety:: This function should be called on the thread that created both fonts.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.AddFallback; Font.ClearFallbacks

◆ RendererTextEngine() [1/2]

SDL::RendererTextEngine::RendererTextEngine ( PropertiesRef props )

inline

Create a text engine for drawing text on an SDL renderer, with the specified properties.

These are the supported properties:

prop::RendererTextEngine.RENDERER_POINTER: the renderer to use for creating textures and drawing text
prop::RendererTextEngine.ATLAS_TEXTURE_SIZE_NUMBER: the size of the texture atlas

Parameters

props the properties to use.

Postcondition: a TextEngine object or nullptr on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the renderer.

Since: This function is available since SDL_ttf 3.0.0.

See also: CreateRendererTextEngine; RendererTextEngine.Destroy; Text.DrawRenderer

◆ RendererTextEngine() [2/2]

SDL::RendererTextEngine::RendererTextEngine ( RendererRef renderer )

inline

Create a text engine for drawing text on an SDL renderer.

Parameters

renderer the renderer to use for creating textures and drawing text.

Postcondition: a TextEngine object or nullptr on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the renderer.

Since: This function is available since SDL_ttf 3.0.0.

See also: RendererTextEngine.Destroy; Text.DrawRenderer; CreateRendererTextEngineWithProperties

◆ RenderGlyph_Blended() [1/2]

Surface SDL::Font::RenderGlyph_Blended	(	Uint32	ch,
		ColorRaw	fg ) const

inline

Render a single UNICODE codepoint at high quality to a new ARGB surface.

This function will allocate a new 32-bit, ARGB surface, using alpha blending to dither the font with the given color. This function returns the new surface, or nullptr if there was an error.

The glyph is rendered without any padding or centering in the X direction, and aligned normally in the Y direction.

You can render at other quality levels with Font.RenderGlyph_Solid, Font.RenderGlyph_Shaded, and Font.RenderGlyph_LCD.

Parameters

ch	the codepoint to render.
fg	the foreground color for the text.

Returns: a new 32-bit, ARGB surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderGlyph_LCD; Font.RenderGlyph_Shaded; Font.RenderGlyph_Solid

◆ RenderGlyph_Blended() [2/2]

Surface SDL::RenderGlyph_Blended	(	FontRef	font,
		Uint32	ch,
		ColorRaw	fg )

inline

Render a single UNICODE codepoint at high quality to a new ARGB surface.

This function will allocate a new 32-bit, ARGB surface, using alpha blending to dither the font with the given color. This function returns the new surface, or nullptr if there was an error.

The glyph is rendered without any padding or centering in the X direction, and aligned normally in the Y direction.

You can render at other quality levels with Font.RenderGlyph_Solid, Font.RenderGlyph_Shaded, and Font.RenderGlyph_LCD.

Parameters

font	the font to render with.
ch	the codepoint to render.
fg	the foreground color for the text.

Returns: a new 32-bit, ARGB surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderGlyph_LCD; Font.RenderGlyph_Shaded; Font.RenderGlyph_Solid

◆ RenderGlyph_LCD() [1/2]

Surface SDL::Font::RenderGlyph_LCD	(	Uint32	ch,
		ColorRaw	fg,
		ColorRaw	bg ) const

inline

Render a single UNICODE codepoint at LCD subpixel quality to a new ARGB surface.

This function will allocate a new 32-bit, ARGB surface, and render alpha-blended text using FreeType's LCD subpixel rendering. This function returns the new surface, or nullptr if there was an error.

The glyph is rendered without any padding or centering in the X direction, and aligned normally in the Y direction.

You can render at other quality levels with Font.RenderGlyph_Solid, Font.RenderGlyph_Shaded, and Font.RenderGlyph_Blended.

Parameters

ch	the codepoint to render.
fg	the foreground color for the text.
bg	the background color for the text.

Returns: a new 32-bit, ARGB surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderGlyph_Blended; Font.RenderGlyph_Shaded; Font.RenderGlyph_Solid

◆ RenderGlyph_LCD() [2/2]

Surface SDL::RenderGlyph_LCD	(	FontRef	font,
		Uint32	ch,
		ColorRaw	fg,
		ColorRaw	bg )

inline

Render a single UNICODE codepoint at LCD subpixel quality to a new ARGB surface.

This function will allocate a new 32-bit, ARGB surface, and render alpha-blended text using FreeType's LCD subpixel rendering. This function returns the new surface, or nullptr if there was an error.

The glyph is rendered without any padding or centering in the X direction, and aligned normally in the Y direction.

You can render at other quality levels with Font.RenderGlyph_Solid, Font.RenderGlyph_Shaded, and Font.RenderGlyph_Blended.

Parameters

font	the font to render with.
ch	the codepoint to render.
fg	the foreground color for the text.
bg	the background color for the text.

Returns: a new 32-bit, ARGB surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderGlyph_Blended; Font.RenderGlyph_Shaded; Font.RenderGlyph_Solid

◆ RenderGlyph_Shaded() [1/2]

Surface SDL::Font::RenderGlyph_Shaded	(	Uint32	ch,
		ColorRaw	fg,
		ColorRaw	bg ) const

inline

Render a single UNICODE codepoint at high quality to a new 8-bit surface.

This function will allocate a new 8-bit, palettized surface. The surface's 0 pixel will be the specified background color, while other pixels have varying degrees of the foreground color. This function returns the new surface, or nullptr if there was an error.

The glyph is rendered without any padding or centering in the X direction, and aligned normally in the Y direction.

You can render at other quality levels with Font.RenderGlyph_Solid, Font.RenderGlyph_Blended, and Font.RenderGlyph_LCD.

Parameters

ch	the codepoint to render.
fg	the foreground color for the text.
bg	the background color for the text.

Returns: a new 8-bit, palettized surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderGlyph_Blended; Font.RenderGlyph_LCD; Font.RenderGlyph_Solid

◆ RenderGlyph_Shaded() [2/2]

Surface SDL::RenderGlyph_Shaded	(	FontRef	font,
		Uint32	ch,
		ColorRaw	fg,
		ColorRaw	bg )

inline

Render a single UNICODE codepoint at high quality to a new 8-bit surface.

This function will allocate a new 8-bit, palettized surface. The surface's 0 pixel will be the specified background color, while other pixels have varying degrees of the foreground color. This function returns the new surface, or nullptr if there was an error.

The glyph is rendered without any padding or centering in the X direction, and aligned normally in the Y direction.

You can render at other quality levels with Font.RenderGlyph_Solid, Font.RenderGlyph_Blended, and Font.RenderGlyph_LCD.

Parameters

font	the font to render with.
ch	the codepoint to render.
fg	the foreground color for the text.
bg	the background color for the text.

Returns: a new 8-bit, palettized surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderGlyph_Blended; Font.RenderGlyph_LCD; Font.RenderGlyph_Solid

◆ RenderGlyph_Solid() [1/2]

Surface SDL::Font::RenderGlyph_Solid	(	Uint32	ch,
		ColorRaw	fg ) const

inline

Render a single 32-bit glyph at fast quality to a new 8-bit surface.

This function will allocate a new 8-bit, palettized surface. The surface's 0 pixel will be the colorkey, giving a transparent background. The 1 pixel will be set to the text color.

The glyph is rendered without any padding or centering in the X direction, and aligned normally in the Y direction.

You can render at other quality levels with Font.RenderGlyph_Shaded, Font.RenderGlyph_Blended, and Font.RenderGlyph_LCD.

Parameters

ch	the character to render.
fg	the foreground color for the text.

Returns: a new 8-bit, palettized surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderGlyph_Blended; Font.RenderGlyph_LCD; Font.RenderGlyph_Shaded

◆ RenderGlyph_Solid() [2/2]

Surface SDL::RenderGlyph_Solid	(	FontRef	font,
		Uint32	ch,
		ColorRaw	fg )

inline

Render a single 32-bit glyph at fast quality to a new 8-bit surface.

This function will allocate a new 8-bit, palettized surface. The surface's 0 pixel will be the colorkey, giving a transparent background. The 1 pixel will be set to the text color.

The glyph is rendered without any padding or centering in the X direction, and aligned normally in the Y direction.

You can render at other quality levels with Font.RenderGlyph_Shaded, Font.RenderGlyph_Blended, and Font.RenderGlyph_LCD.

Parameters

font	the font to render with.
ch	the character to render.
fg	the foreground color for the text.

Returns: a new 8-bit, palettized surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderGlyph_Blended; Font.RenderGlyph_LCD; Font.RenderGlyph_Shaded

◆ RenderText_Blended() [1/2]

Surface SDL::Font::RenderText_Blended	(	std::string_view	text,
		Color	fg ) const

inline

Render UTF-8 text at high quality to a new ARGB surface.

This function will allocate a new 32-bit, ARGB surface, using alpha blending to dither the font with the given color. This function returns the new surface, or nullptr if there was an error.

This will not word-wrap the string; you'll get a surface with a single line of text, as long as the string requires. You can use Font.RenderText_Blended_Wrapped() instead if you need to wrap the output to multiple lines.

This will not wrap on newline characters.

You can render at other quality levels with Font.RenderText_Solid, Font.RenderText_Shaded, and Font.RenderText_LCD.

Parameters

text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.

Returns: a new 32-bit, ARGB surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended_Wrapped; Font.RenderText_LCD; Font.RenderText_Shaded; Font.RenderText_Solid

◆ RenderText_Blended() [2/2]

Surface SDL::RenderText_Blended	(	FontRef	font,
		std::string_view	text,
		Color	fg )

inline

Render UTF-8 text at high quality to a new ARGB surface.

This function will allocate a new 32-bit, ARGB surface, using alpha blending to dither the font with the given color. This function returns the new surface, or nullptr if there was an error.

This will not word-wrap the string; you'll get a surface with a single line of text, as long as the string requires. You can use Font.RenderText_Blended_Wrapped() instead if you need to wrap the output to multiple lines.

This will not wrap on newline characters.

You can render at other quality levels with Font.RenderText_Solid, Font.RenderText_Shaded, and Font.RenderText_LCD.

Parameters

font	the font to render with.
text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.

Returns: a new 32-bit, ARGB surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended_Wrapped; Font.RenderText_LCD; Font.RenderText_Shaded; Font.RenderText_Solid

◆ RenderText_Blended_Wrapped() [1/2]

Surface SDL::Font::RenderText_Blended_Wrapped	(	std::string_view	text,
		Color	fg,
		int	wrap_width ) const

inline

Render word-wrapped UTF-8 text at high quality to a new ARGB surface.

This function will allocate a new 32-bit, ARGB surface, using alpha blending to dither the font with the given color. This function returns the new surface, or nullptr if there was an error.

Text is wrapped to multiple lines on line endings and on word boundaries if it extends beyond wrap_width in pixels.

If wrap_width is 0, this function will only wrap on newline characters.

You can render at other quality levels with Font.RenderText_Solid_Wrapped, Font.RenderText_Shaded_Wrapped, and Font.RenderText_LCD_Wrapped.

Parameters

text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.
wrap_width	the maximum width of the text surface or 0 to wrap on newline characters.

Returns: a new 32-bit, ARGB surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended; Font.RenderText_LCD_Wrapped; Font.RenderText_Shaded_Wrapped; Font.RenderText_Solid_Wrapped

◆ RenderText_Blended_Wrapped() [2/2]

Surface SDL::RenderText_Blended_Wrapped	(	FontRef	font,
		std::string_view	text,
		Color	fg,
		int	wrap_width )

inline

Render word-wrapped UTF-8 text at high quality to a new ARGB surface.

This function will allocate a new 32-bit, ARGB surface, using alpha blending to dither the font with the given color. This function returns the new surface, or nullptr if there was an error.

Text is wrapped to multiple lines on line endings and on word boundaries if it extends beyond wrap_width in pixels.

If wrap_width is 0, this function will only wrap on newline characters.

You can render at other quality levels with Font.RenderText_Solid_Wrapped, Font.RenderText_Shaded_Wrapped, and Font.RenderText_LCD_Wrapped.

Parameters

font	the font to render with.
text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.
wrap_width	the maximum width of the text surface or 0 to wrap on newline characters.

Returns: a new 32-bit, ARGB surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended; Font.RenderText_LCD_Wrapped; Font.RenderText_Shaded_Wrapped; Font.RenderText_Solid_Wrapped

◆ RenderText_LCD() [1/2]

Surface SDL::Font::RenderText_LCD	(	std::string_view	text,
		Color	fg,
		Color	bg ) const

inline

Render UTF-8 text at LCD subpixel quality to a new ARGB surface.

This function will allocate a new 32-bit, ARGB surface, and render alpha-blended text using FreeType's LCD subpixel rendering. This function returns the new surface, or nullptr if there was an error.

This will not word-wrap the string; you'll get a surface with a single line of text, as long as the string requires. You can use Font.RenderText_LCD_Wrapped() instead if you need to wrap the output to multiple lines.

This will not wrap on newline characters.

You can render at other quality levels with Font.RenderText_Solid, Font.RenderText_Shaded, and Font.RenderText_Blended.

Parameters

text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.
bg	the background color for the text.

Returns: a new 32-bit, ARGB surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended; Font.RenderText_LCD_Wrapped; Font.RenderText_Shaded; Font.RenderText_Solid

◆ RenderText_LCD() [2/2]

Surface SDL::RenderText_LCD	(	FontRef	font,
		std::string_view	text,
		Color	fg,
		Color	bg )

inline

Render UTF-8 text at LCD subpixel quality to a new ARGB surface.

This function will allocate a new 32-bit, ARGB surface, and render alpha-blended text using FreeType's LCD subpixel rendering. This function returns the new surface, or nullptr if there was an error.

This will not word-wrap the string; you'll get a surface with a single line of text, as long as the string requires. You can use Font.RenderText_LCD_Wrapped() instead if you need to wrap the output to multiple lines.

This will not wrap on newline characters.

You can render at other quality levels with Font.RenderText_Solid, Font.RenderText_Shaded, and Font.RenderText_Blended.

Parameters

font	the font to render with.
text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.
bg	the background color for the text.

Returns: a new 32-bit, ARGB surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended; Font.RenderText_LCD_Wrapped; Font.RenderText_Shaded; Font.RenderText_Solid

◆ RenderText_LCD_Wrapped() [1/2]

Surface SDL::Font::RenderText_LCD_Wrapped	(	std::string_view	text,
		Color	fg,
		Color	bg,
		int	wrap_width ) const

inline

Render word-wrapped UTF-8 text at LCD subpixel quality to a new ARGB surface.

This function will allocate a new 32-bit, ARGB surface, and render alpha-blended text using FreeType's LCD subpixel rendering. This function returns the new surface, or nullptr if there was an error.

Text is wrapped to multiple lines on line endings and on word boundaries if it extends beyond wrap_width in pixels.

If wrap_width is 0, this function will only wrap on newline characters.

You can render at other quality levels with Font.RenderText_Solid_Wrapped, Font.RenderText_Shaded_Wrapped, and Font.RenderText_Blended_Wrapped.

Parameters

text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.
bg	the background color for the text.
wrap_width	the maximum width of the text surface or 0 to wrap on newline characters.

Returns: a new 32-bit, ARGB surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended_Wrapped; Font.RenderText_LCD; Font.RenderText_Shaded_Wrapped; Font.RenderText_Solid_Wrapped

◆ RenderText_LCD_Wrapped() [2/2]

Surface SDL::RenderText_LCD_Wrapped	(	FontRef	font,
		std::string_view	text,
		Color	fg,
		Color	bg,
		int	wrap_width )

inline

Render word-wrapped UTF-8 text at LCD subpixel quality to a new ARGB surface.

This function will allocate a new 32-bit, ARGB surface, and render alpha-blended text using FreeType's LCD subpixel rendering. This function returns the new surface, or nullptr if there was an error.

Text is wrapped to multiple lines on line endings and on word boundaries if it extends beyond wrap_width in pixels.

If wrap_width is 0, this function will only wrap on newline characters.

You can render at other quality levels with Font.RenderText_Solid_Wrapped, Font.RenderText_Shaded_Wrapped, and Font.RenderText_Blended_Wrapped.

Parameters

font	the font to render with.
text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.
bg	the background color for the text.
wrap_width	the maximum width of the text surface or 0 to wrap on newline characters.

Returns: a new 32-bit, ARGB surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended_Wrapped; Font.RenderText_LCD; Font.RenderText_Shaded_Wrapped; Font.RenderText_Solid_Wrapped

◆ RenderText_Shaded() [1/2]

Surface SDL::Font::RenderText_Shaded	(	std::string_view	text,
		Color	fg,
		Color	bg ) const

inline

Render UTF-8 text at high quality to a new 8-bit surface.

This function will allocate a new 8-bit, palettized surface. The surface's 0 pixel will be the specified background color, while other pixels have varying degrees of the foreground color. This function returns the new surface, or nullptr if there was an error.

This will not word-wrap the string; you'll get a surface with a single line of text, as long as the string requires. You can use Font.RenderText_Shaded_Wrapped() instead if you need to wrap the output to multiple lines.

This will not wrap on newline characters.

You can render at other quality levels with Font.RenderText_Solid, Font.RenderText_Blended, and Font.RenderText_LCD.

Parameters

text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.
bg	the background color for the text.

Returns: a new 8-bit, palettized surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended; Font.RenderText_LCD; Font.RenderText_Shaded_Wrapped; Font.RenderText_Solid

◆ RenderText_Shaded() [2/2]

Surface SDL::RenderText_Shaded	(	FontRef	font,
		std::string_view	text,
		Color	fg,
		Color	bg )

inline

Render UTF-8 text at high quality to a new 8-bit surface.

This function will allocate a new 8-bit, palettized surface. The surface's 0 pixel will be the specified background color, while other pixels have varying degrees of the foreground color. This function returns the new surface, or nullptr if there was an error.

This will not word-wrap the string; you'll get a surface with a single line of text, as long as the string requires. You can use Font.RenderText_Shaded_Wrapped() instead if you need to wrap the output to multiple lines.

This will not wrap on newline characters.

You can render at other quality levels with Font.RenderText_Solid, Font.RenderText_Blended, and Font.RenderText_LCD.

Parameters

font	the font to render with.
text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.
bg	the background color for the text.

Returns: a new 8-bit, palettized surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended; Font.RenderText_LCD; Font.RenderText_Shaded_Wrapped; Font.RenderText_Solid

◆ RenderText_Shaded_Wrapped() [1/2]

Surface SDL::Font::RenderText_Shaded_Wrapped	(	std::string_view	text,
		Color	fg,
		Color	bg,
		int	wrap_width ) const

inline

Render word-wrapped UTF-8 text at high quality to a new 8-bit surface.

This function will allocate a new 8-bit, palettized surface. The surface's 0 pixel will be the specified background color, while other pixels have varying degrees of the foreground color. This function returns the new surface, or nullptr if there was an error.

Text is wrapped to multiple lines on line endings and on word boundaries if it extends beyond wrap_width in pixels.

If wrap_width is 0, this function will only wrap on newline characters.

You can render at other quality levels with Font.RenderText_Solid_Wrapped, Font.RenderText_Blended_Wrapped, and Font.RenderText_LCD_Wrapped.

Parameters

text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.
bg	the background color for the text.
wrap_width	the maximum width of the text surface or 0 to wrap on newline characters.

Returns: a new 8-bit, palettized surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended_Wrapped; Font.RenderText_LCD_Wrapped; Font.RenderText_Shaded; Font.RenderText_Solid_Wrapped

◆ RenderText_Shaded_Wrapped() [2/2]

Surface SDL::RenderText_Shaded_Wrapped	(	FontRef	font,
		std::string_view	text,
		Color	fg,
		Color	bg,
		int	wrap_width )

inline

Render word-wrapped UTF-8 text at high quality to a new 8-bit surface.

This function will allocate a new 8-bit, palettized surface. The surface's 0 pixel will be the specified background color, while other pixels have varying degrees of the foreground color. This function returns the new surface, or nullptr if there was an error.

Text is wrapped to multiple lines on line endings and on word boundaries if it extends beyond wrap_width in pixels.

If wrap_width is 0, this function will only wrap on newline characters.

You can render at other quality levels with Font.RenderText_Solid_Wrapped, Font.RenderText_Blended_Wrapped, and Font.RenderText_LCD_Wrapped.

Parameters

font	the font to render with.
text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.
bg	the background color for the text.
wrap_width	the maximum width of the text surface or 0 to wrap on newline characters.

Returns: a new 8-bit, palettized surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended_Wrapped; Font.RenderText_LCD_Wrapped; Font.RenderText_Shaded; Font.RenderText_Solid_Wrapped

◆ RenderText_Solid() [1/2]

Surface SDL::Font::RenderText_Solid	(	std::string_view	text,
		Color	fg ) const

inline

Render UTF-8 text at fast quality to a new 8-bit surface.

This function will allocate a new 8-bit, palettized surface. The surface's 0 pixel will be the colorkey, giving a transparent background. The 1 pixel will be set to the text color.

This will not word-wrap the string; you'll get a surface with a single line of text, as long as the string requires. You can use Font.RenderText_Solid_Wrapped() instead if you need to wrap the output to multiple lines.

This will not wrap on newline characters.

You can render at other quality levels with Font.RenderText_Shaded, Font.RenderText_Blended, and Font.RenderText_LCD.

Parameters

text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.

Returns: a new 8-bit, palettized surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended; Font.RenderText_LCD; Font.RenderText_Shaded; Font.RenderText_Solid; Font.RenderText_Solid_Wrapped

◆ RenderText_Solid() [2/2]

Surface SDL::RenderText_Solid	(	FontRef	font,
		std::string_view	text,
		Color	fg )

inline

Render UTF-8 text at fast quality to a new 8-bit surface.

This function will allocate a new 8-bit, palettized surface. The surface's 0 pixel will be the colorkey, giving a transparent background. The 1 pixel will be set to the text color.

This will not word-wrap the string; you'll get a surface with a single line of text, as long as the string requires. You can use Font.RenderText_Solid_Wrapped() instead if you need to wrap the output to multiple lines.

This will not wrap on newline characters.

You can render at other quality levels with Font.RenderText_Shaded, Font.RenderText_Blended, and Font.RenderText_LCD.

Parameters

font	the font to render with.
text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.

Returns: a new 8-bit, palettized surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended; Font.RenderText_LCD; Font.RenderText_Shaded; Font.RenderText_Solid; Font.RenderText_Solid_Wrapped

◆ RenderText_Solid_Wrapped() [1/2]

Surface SDL::Font::RenderText_Solid_Wrapped	(	std::string_view	text,
		Color	fg,
		int	wrapLength ) const

inline

Render word-wrapped UTF-8 text at fast quality to a new 8-bit surface.

This function will allocate a new 8-bit, palettized surface. The surface's 0 pixel will be the colorkey, giving a transparent background. The 1 pixel will be set to the text color.

Text is wrapped to multiple lines on line endings and on word boundaries if it extends beyond wrapLength in pixels.

If wrapLength is 0, this function will only wrap on newline characters.

You can render at other quality levels with Font.RenderText_Shaded_Wrapped, Font.RenderText_Blended_Wrapped, and Font.RenderText_LCD_Wrapped.

Parameters

text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.
wrapLength	the maximum width of the text surface or 0 to wrap on newline characters.

Returns: a new 8-bit, palettized surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended_Wrapped; Font.RenderText_LCD_Wrapped; Font.RenderText_Shaded_Wrapped; Font.RenderText_Solid

◆ RenderText_Solid_Wrapped() [2/2]

Surface SDL::RenderText_Solid_Wrapped	(	FontRef	font,
		std::string_view	text,
		Color	fg,
		int	wrapLength )

inline

Render word-wrapped UTF-8 text at fast quality to a new 8-bit surface.

This function will allocate a new 8-bit, palettized surface. The surface's 0 pixel will be the colorkey, giving a transparent background. The 1 pixel will be set to the text color.

Text is wrapped to multiple lines on line endings and on word boundaries if it extends beyond wrapLength in pixels.

If wrapLength is 0, this function will only wrap on newline characters.

You can render at other quality levels with Font.RenderText_Shaded_Wrapped, Font.RenderText_Blended_Wrapped, and Font.RenderText_LCD_Wrapped.

Parameters

font	the font to render with.
text	text to render, in UTF-8 encoding.
fg	the foreground color for the text.
wrapLength	the maximum width of the text surface or 0 to wrap on newline characters.

Returns: a new 8-bit, palettized surface, or nullptr if there was an error.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.RenderText_Blended_Wrapped; Font.RenderText_LCD_Wrapped; Font.RenderText_Shaded_Wrapped; Font.RenderText_Solid

◆ SetColor()

void SDL::Text::SetColor ( Color c )

inline

Set the color of a text object.

The default text color is white (255, 255, 255, 255).

Parameters

c	the color values in the range of 0-255.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetColor; Text.SetColorFloat

◆ SetColorFloat()

void SDL::Text::SetColorFloat ( FColor c )

inline

Set the color of a text object.

The default text color is white (1.0f, 1.0f, 1.0f, 1.0f).

Parameters

c	the color value, normally in the range of 0-1.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetColorFloat; Text.SetColor

◆ SetDirection() [1/2]

void SDL::Font::SetDirection ( Direction direction )

inline

Set the direction to be used for text shaping by a font.

This function only supports left-to-right text shaping if SDL_ttf was not built with HarfBuzz support.

This updates any Text objects using this font.

Parameters

direction the new direction for text to flow.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ SetDirection() [2/2]

void SDL::Text::SetDirection ( Direction direction )

inline

Set the direction to be used for text shaping a text object.

This function only supports left-to-right text shaping if SDL_ttf was not built with HarfBuzz support.

Parameters

direction the new direction for text to flow.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ SetEngine()

void SDL::Text::SetEngine ( TextEngineRef engine )

inline

Set the text engine used by a text object.

This function may cause the internal text representation to be rebuilt.

Parameters

engine the text engine to use for drawing.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetEngine

◆ SetFont()

bool SDL::Text::SetFont ( FontRef font )

inline

Set the font used by a text object.

When a text object has a font, any changes to the font will automatically regenerate the text. If you set the font to nullptr, the text will continue to render but changes to the font will no longer affect the text.

This function may cause the internal text representation to be rebuilt.

Parameters

font	the font to use, may be nullptr.

Returns: false if the text pointer is null; otherwise, true. call GetError() for more information.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetFont

◆ SetFontDirection()

void SDL::SetFontDirection	(	FontRef	font,
		Direction	direction )

inline

Set the direction to be used for text shaping by a font.

This function only supports left-to-right text shaping if SDL_ttf was not built with HarfBuzz support.

This updates any Text objects using this font.

Parameters

font	the font to modify.
direction	the new direction for text to flow.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ SetFontHinting()

void SDL::SetFontHinting	(	FontRef	font,
		HintingFlags	hinting )

inline

Set a font's current hinter setting.

This updates any Text objects using this font, and clears already-generated glyphs, if any, from the cache.

The hinter setting is a single value:

HINTING_NORMAL
HINTING_LIGHT
HINTING_MONO
HINTING_NONE
HINTING_LIGHT_SUBPIXEL (available in SDL_ttf 3.0.0 and later)

Parameters

font	the font to set a new hinter setting on.
hinting	the new hinter setting.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetHinting

◆ SetFontKerning()

void SDL::SetFontKerning	(	FontRef	font,
		bool	enabled )

inline

Set if kerning is enabled for a font.

Newly-opened fonts default to allowing kerning. This is generally a good policy unless you have a strong reason to disable it, as it tends to produce better rendering (with kerning disabled, some fonts might render the word kerning as something that looks like keming for example).

This updates any Text objects using this font.

Parameters

font	the font to set kerning on.
enabled	true to enable kerning, false to disable.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetKerning

◆ SetFontLanguage()

void SDL::SetFontLanguage	(	FontRef	font,
		StringParam	language_bcp47 )

inline

Set language to be used for text shaping by a font.

If SDL_ttf was not built with HarfBuzz support, this function returns false.

This updates any Text objects using this font.

Parameters

font	the font to specify a language for.
language_bcp47	a null-terminated string containing the desired language's BCP47 code. Or null to reset the value.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ SetFontLineSkip()

void SDL::SetFontLineSkip	(	FontRef	font,
		int	lineskip )

inline

Set the spacing between lines of text for a font.

This updates any Text objects using this font.

Parameters

font	the font to modify.
lineskip	the new line spacing for the font.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetLineSkip

◆ SetFontOutline()

void SDL::SetFontOutline	(	FontRef	font,
		int	outline )

inline

Set a font's current outline.

This uses the font properties prop::Font.OUTLINE_LINE_CAP_NUMBER, prop::Font.OUTLINE_LINE_JOIN_NUMBER, and prop::Font.OUTLINE_MITER_LIMIT_NUMBER when setting the font outline.

This updates any Text objects using this font, and clears already-generated glyphs, if any, from the cache.

Parameters

font	the font to set a new outline on.
outline	positive outline value, 0 to default.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetOutline

◆ SetFontScript()

void SDL::SetFontScript	(	FontRef	font,
		Uint32	script )

inline

Set the script to be used for text shaping by a font.

This returns false if SDL_ttf isn't built with HarfBuzz support.

This updates any Text objects using this font.

Parameters

font	the font to modify.
script	an ISO 15924 code.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: StringToTag

◆ SetFontSDF()

void SDL::SetFontSDF	(	FontRef	font,
		bool	enabled )

inline

Enable Signed Distance Field rendering for a font.

SDF is a technique that helps fonts look sharp even when scaling and rotating, and requires special shader support for display.

This works with Blended APIs, and generates the raw signed distance values in the alpha channel of the resulting texture.

This updates any Text objects using this font, and clears already-generated glyphs, if any, from the cache.

Parameters

font	the font to set SDF support on.
enabled	true to enable SDF, false to disable.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetSDF

◆ SetFontSize()

void SDL::SetFontSize	(	FontRef	font,
		float	ptsize )

inline

Set a font's size dynamically.

This updates any Text objects using this font, and clears already-generated glyphs, if any, from the cache.

Parameters

font	the font to resize.
ptsize	the new point size.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetSize

◆ SetFontSizeDPI()

void SDL::SetFontSizeDPI	(	FontRef	font,
		float	ptsize,
		int	hdpi,
		int	vdpi )

inline

Set font size dynamically with target resolutions, in dots per inch.

This updates any Text objects using this font, and clears already-generated glyphs, if any, from the cache.

Parameters

font	the font to resize.
ptsize	the new point size.
hdpi	the target horizontal DPI.
vdpi	the target vertical DPI.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetSize; TTF_GetFontSizeDPI

◆ SetFontStyle()

void SDL::SetFontStyle	(	FontRef	font,
		FontStyleFlags	style )

inline

Set a font's current style.

This updates any Text objects using this font, and clears already-generated glyphs, if any, from the cache.

The font styles are a set of bit flags, OR'd together:

STYLE_NORMAL (is zero)
STYLE_BOLD
STYLE_ITALIC
STYLE_UNDERLINE
STYLE_STRIKETHROUGH

Parameters

font	the font to set a new style on.
style	the new style values to set, OR'd together.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetStyle

◆ SetFontWrapAlignment()

void SDL::SetFontWrapAlignment	(	FontRef	font,
		HorizontalAlignment	align )

inline

Set a font's current wrap alignment option.

This updates any Text objects using this font.

Parameters

font	the font to set a new wrap alignment option on.
align	the new wrap alignment option.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetWrapAlignment

◆ SetGPUTextEngineWinding()

void SDL::SetGPUTextEngineWinding	(	TextEngineRef	engine,
		GPUTextEngineWinding	winding )

inline

Sets the winding order of the vertices returned by Text.GetGPUDrawData for a particular GPU text engine.

Parameters

engine	a TextEngine object created with GPUTextEngine.GPUTextEngine().
winding	the new winding order option.

Thread safety:: This function should be called on the thread that created the engine.

Since: This function is available since SDL_ttf 3.0.0.

See also: GPUTextEngine.GetGPUWinding

◆ SetGPUWinding()

void SDL::GPUTextEngine::SetGPUWinding ( GPUTextEngineWinding winding )

inline

Sets the winding order of the vertices returned by Text.GetGPUDrawData for a particular GPU text engine.

Parameters

winding the new winding order option.

Thread safety:: This function should be called on the thread that created the engine.

Since: This function is available since SDL_ttf 3.0.0.

See also: GPUTextEngine.GetGPUWinding

◆ SetHinting()

void SDL::Font::SetHinting ( HintingFlags hinting )

inline

Set a font's current hinter setting.

This updates any Text objects using this font, and clears already-generated glyphs, if any, from the cache.

The hinter setting is a single value:

HINTING_NORMAL
HINTING_LIGHT
HINTING_MONO
HINTING_NONE
HINTING_LIGHT_SUBPIXEL (available in SDL_ttf 3.0.0 and later)

Parameters

hinting the new hinter setting.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetHinting

◆ SetKerning()

void SDL::Font::SetKerning ( bool enabled )

inline

Set if kerning is enabled for a font.

Newly-opened fonts default to allowing kerning. This is generally a good policy unless you have a strong reason to disable it, as it tends to produce better rendering (with kerning disabled, some fonts might render the word kerning as something that looks like keming for example).

This updates any Text objects using this font.

Parameters

enabled true to enable kerning, false to disable.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetKerning

◆ SetLanguage()

void SDL::Font::SetLanguage ( StringParam language_bcp47 )

inline

Set language to be used for text shaping by a font.

If SDL_ttf was not built with HarfBuzz support, this function returns false.

This updates any Text objects using this font.

Parameters

language_bcp47 a null-terminated string containing the desired language's BCP47 code. Or null to reset the value.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

◆ SetLineSkip()

void SDL::Font::SetLineSkip ( int lineskip )

inline

Set the spacing between lines of text for a font.

This updates any Text objects using this font.

Parameters

lineskip the new line spacing for the font.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetLineSkip

◆ SetOutline()

void SDL::Font::SetOutline ( int outline )

inline

Set a font's current outline.

This uses the font properties prop::Font.OUTLINE_LINE_CAP_NUMBER, prop::Font.OUTLINE_LINE_JOIN_NUMBER, and prop::Font.OUTLINE_MITER_LIMIT_NUMBER when setting the font outline.

This updates any Text objects using this font, and clears already-generated glyphs, if any, from the cache.

Parameters

outline positive outline value, 0 to default.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetOutline

◆ SetPosition()

void SDL::Text::SetPosition ( const PointRaw & p )

inline

Set the position of a text object.

This can be used to position multiple text objects within a single wrapping text area.

This function may cause the internal text representation to be rebuilt.

Parameters

p	the x, y offset of the upper left corner of this text in pixels.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetPosition

◆ SetScript() [1/2]

void SDL::Font::SetScript ( Uint32 script )

inline

Set the script to be used for text shaping by a font.

This returns false if SDL_ttf isn't built with HarfBuzz support.

This updates any Text objects using this font.

Parameters

script an ISO 15924 code.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: StringToTag

◆ SetScript() [2/2]

void SDL::Text::SetScript ( Uint32 script )

inline

Set the script to be used for text shaping a text object.

This returns false if SDL_ttf isn't built with HarfBuzz support.

Parameters

script an ISO 15924 code.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: StringToTag

◆ SetSDF()

void SDL::Font::SetSDF ( bool enabled )

inline

Enable Signed Distance Field rendering for a font.

SDF is a technique that helps fonts look sharp even when scaling and rotating, and requires special shader support for display.

This works with Blended APIs, and generates the raw signed distance values in the alpha channel of the resulting texture.

This updates any Text objects using this font, and clears already-generated glyphs, if any, from the cache.

Parameters

enabled true to enable SDF, false to disable.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetSDF

◆ SetSize()

void SDL::Font::SetSize ( float ptsize )

inline

Set a font's size dynamically.

This updates any Text objects using this font, and clears already-generated glyphs, if any, from the cache.

Parameters

ptsize the new point size.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetSize

◆ SetSizeDPI()

void SDL::Font::SetSizeDPI	(	float	ptsize,
		int	hdpi,
		int	vdpi )

inline

Set font size dynamically with target resolutions, in dots per inch.

This updates any Text objects using this font, and clears already-generated glyphs, if any, from the cache.

Parameters

ptsize	the new point size.
hdpi	the target horizontal DPI.
vdpi	the target vertical DPI.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetSize; TTF_GetFontSizeDPI

◆ SetString()

void SDL::Text::SetString ( std::string_view string )

inline

Set the UTF-8 text used by a text object.

This function may cause the internal text representation to be rebuilt.

Parameters

string the UTF-8 text to use.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.AppendString; Text.DeleteString; Text.InsertString

◆ SetStyle()

void SDL::Font::SetStyle ( FontStyleFlags style )

inline

Set a font's current style.

This updates any Text objects using this font, and clears already-generated glyphs, if any, from the cache.

The font styles are a set of bit flags, OR'd together:

STYLE_NORMAL (is zero)
STYLE_BOLD
STYLE_ITALIC
STYLE_UNDERLINE
STYLE_STRIKETHROUGH

Parameters

style the new style values to set, OR'd together.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetStyle

◆ SetTextColor()

void SDL::SetTextColor	(	TextRef	text,
		Color	c )

inline

Set the color of a text object.

The default text color is white (255, 255, 255, 255).

Parameters

text	the Text to modify.
c	the color value in the range of 0-255.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetColor; Text.SetColorFloat

◆ SetTextColorFloat()

void SDL::SetTextColorFloat	(	TextRef	text,
		FColor	c )

inline

Set the color of a text object.

The default text color is white (1.0f, 1.0f, 1.0f, 1.0f).

Parameters

text	the Text to modify.
c	the color value, normally in the range of 0-1.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetColorFloat; Text.SetColor

◆ SetTextDirection()

void SDL::SetTextDirection	(	TextRef	text,
		Direction	direction )

inline

Set the direction to be used for text shaping a text object.

This function only supports left-to-right text shaping if SDL_ttf was not built with HarfBuzz support.

Parameters

text	the text to modify.
direction	the new direction for text to flow.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ SetTextEngine()

void SDL::SetTextEngine	(	TextRef	text,
		TextEngineRef	engine )

inline

Set the text engine used by a text object.

This function may cause the internal text representation to be rebuilt.

Parameters

text	the Text to modify.
engine	the text engine to use for drawing.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetEngine

◆ SetTextFont()

bool SDL::SetTextFont	(	TextRef	text,
		FontRef	font )

inline

Set the font used by a text object.

When a text object has a font, any changes to the font will automatically regenerate the text. If you set the font to nullptr, the text will continue to render but changes to the font will no longer affect the text.

This function may cause the internal text representation to be rebuilt.

Parameters

text	the Text to modify.
font	the font to use, may be nullptr.

Returns: false if the text pointer is null; otherwise, true. call GetError() for more information.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetFont

◆ SetTextPosition()

void SDL::SetTextPosition	(	TextRef	text,
		const PointRaw &	p )

inline

Set the position of a text object.

This can be used to position multiple text objects within a single wrapping text area.

This function may cause the internal text representation to be rebuilt.

Parameters

text	the Text to modify.
p	the x, y offset of the upper left corner of this text in pixels.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetPosition

◆ SetTextScript()

void SDL::SetTextScript	(	TextRef	text,
		Uint32	script )

inline

Set the script to be used for text shaping a text object.

This returns false if SDL_ttf isn't built with HarfBuzz support.

Parameters

text	the text to modify.
script	an ISO 15924 code.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: StringToTag

◆ SetTextString()

void SDL::SetTextString	(	TextRef	text,
		std::string_view	string )

inline

Set the UTF-8 text used by a text object.

This function may cause the internal text representation to be rebuilt.

Parameters

text	the Text to modify.
string	the UTF-8 text to use, may be nullptr.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.AppendString; Text.DeleteString; Text.InsertString

◆ SetTextWrapWhitespaceVisible()

void SDL::SetTextWrapWhitespaceVisible	(	TextRef	text,
		bool	visible )

inline

Set whether whitespace should be visible when wrapping a text object.

If the whitespace is visible, it will take up space for purposes of alignment and wrapping. This is good for editing, but looks better when centered or aligned if whitespace around line wrapping is hidden. This defaults false.

This function may cause the internal text representation to be rebuilt.

Parameters

text	the Text to modify.
visible	true to show whitespace when wrapping text, false to hide it.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.IsWrapWhitespaceVisible

◆ SetTextWrapWidth()

void SDL::SetTextWrapWidth	(	TextRef	text,
		int	wrap_width )

inline

Set whether wrapping is enabled on a text object.

This function may cause the internal text representation to be rebuilt.

Parameters

text	the Text to modify.
wrap_width	the maximum width in pixels, 0 to wrap on newline characters.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetWrapWidth

◆ SetWrapAlignment()

void SDL::Font::SetWrapAlignment ( HorizontalAlignment align )

inline

Set a font's current wrap alignment option.

This updates any Text objects using this font.

Parameters

align the new wrap alignment option.

Thread safety:: This function should be called on the thread that created the font.

Since: This function is available since SDL_ttf 3.0.0.

See also: Font.GetWrapAlignment

◆ SetWrapWhitespaceVisible()

void SDL::Text::SetWrapWhitespaceVisible ( bool visible )

inline

Set whether whitespace should be visible when wrapping a text object.

If the whitespace is visible, it will take up space for purposes of alignment and wrapping. This is good for editing, but looks better when centered or aligned if whitespace around line wrapping is hidden. This defaults false.

This function may cause the internal text representation to be rebuilt.

Parameters

visible true to show whitespace when wrapping text, false to hide it.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.IsWrapWhitespaceVisible

◆ SetWrapWidth()

void SDL::Text::SetWrapWidth ( int wrap_width )

inline

Set whether wrapping is enabled on a text object.

This function may cause the internal text representation to be rebuilt.

Parameters

wrap_width the maximum width in pixels, 0 to wrap on newline characters.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.GetWrapWidth

◆ StringToTag()

Uint32 SDL::StringToTag ( StringParam string )

inline

Convert from a 4 character string to a 32-bit tag.

Parameters

string the 4 character string to convert.

Returns: the 32-bit representation of the string.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: TagToString

◆ SurfaceTextEngine()

SDL::SurfaceTextEngine::SurfaceTextEngine ( )

inline

Create a text engine for drawing text on SDL surfaces.

Postcondition: a TextEngine object or nullptr on failure; call GetError() for more information.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: SurfaceTextEngine.Destroy; Text.DrawSurface

◆ TagToString()

void SDL::TagToString	(	Uint32	tag,
		char *	string,
		size_t	size )

inline

Convert from a 32-bit tag to a 4 character string.

Parameters

tag	the 32-bit tag to convert.
string	a pointer filled in with the 4 character representation of the tag.
size	the size of the buffer pointed at by string, should be at least 4.

Thread safety:: It is safe to call this function from any thread.

Since: This function is available since SDL_ttf 3.0.0.

See also: TagToString

◆ Text()

SDL::Text::Text	(	TextEngineRef	engine,
		FontRef	font,
		std::string_view	text )

inline

Create a text object from UTF-8 text and a text engine.

Parameters

engine	the text engine to use when creating the text object, may be nullptr.
font	the font to render with.
text	the text to use, in UTF-8 encoding.

Postcondition: a Text object or nullptr on failure; call GetError() for more information.

Thread safety:: This function should be called on the thread that created the font and text engine.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.Destroy

◆ TextWrapWhitespaceVisible()

bool SDL::TextWrapWhitespaceVisible ( TextConstRef text )

inline

Return whether whitespace is shown when wrapping a text object.

Parameters

text	the Text to query.

Returns: true if whitespace is shown when wrapping text, or false otherwise.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

See also: Text.SetWrapWhitespaceVisible

◆ Update()

void SDL::Text::Update ( )

inline

Update the layout of a text object.

This is automatically done when the layout is requested or the text is rendered, but you can call this if you need more control over the timing of when the layout and text engine representation are updated.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

◆ UpdateText()

void SDL::UpdateText ( TextRef text )

inline

Update the layout of a text object.

This is automatically done when the layout is requested or the text is rendered, but you can call this if you need more control over the timing of when the layout and text engine representation are updated.

Parameters

text	the Text to update.

Exceptions

Error on failure.

Thread safety:: This function should be called on the thread that created the text.

Since: This function is available since SDL_ttf 3.0.0.

This substring contains the beginning of the text.

Classes

Macros

Typedefs

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ SDL_TTF_VERSION

◆ SDL_TTF_VERSION_ATLEAST

Typedef Documentation

◆ Direction

◆ FontStyleFlags

◆ GPUAtlasDrawSequence

◆ GPUTextEngineWinding

◆ HintingFlags

◆ HorizontalAlignment

◆ ImageType

◆ SubString

◆ SubStringFlags

◆ TextData

Function Documentation

◆ AddFallback()

◆ AddFallbackFont()

◆ AppendString()

◆ AppendTextString()

◆ ClearFallbackFonts()

◆ ClearFallbacks()

◆ Close()

◆ CloseFont()

◆ Copy()

◆ CopyFont()

◆ CreateGPUTextEngine()

◆ CreateGPUTextEngineWithProperties()

◆ CreateRendererTextEngine()

◆ CreateRendererTextEngineWithProperties()

◆ CreateSurfaceTextEngine()

◆ CreateText() [1/2]

◆ CreateText() [2/2]

◆ DeleteString()

◆ DeleteTextString()

◆ Destroy() [1/4]

◆ Destroy() [2/4]

◆ Destroy() [3/4]

◆ Destroy() [4/4]

◆ DestroyGPUTextEngine()

◆ DestroyRendererTextEngine()

◆ DestroySurfaceTextEngine()

◆ DestroyText()

◆ DrawRenderer()

◆ DrawRendererText()

◆ DrawSurface()

◆ DrawSurfaceText()

◆ Font() [1/3]

◆ Font() [2/3]

◆ Font() [3/3]

◆ FontHasGlyph()

◆ FontIsFixedWidth()

◆ FontIsScalable()

◆ GetAscent()

◆ GetColor() [1/2]

◆ GetColor() [2/2]

◆ GetColorFloat() [1/2]

◆ GetColorFloat() [2/2]

◆ GetDescent()

◆ GetDirection() [1/2]

◆ GetDirection() [2/2]

◆ GetDPI()

◆ GetEngine()

◆ GetFamilyName()

◆ GetFont()

◆ GetFontAscent()

◆ GetFontDescent()

◆ GetFontDirection()

◆ GetFontDPI()

◆ GetFontFamilyName()

◆ GetFontGeneration()

◆ GetFontHeight()

◆ GetFontHinting()

◆ GetFontKerning()

◆ GetFontLineSkip()