class `SF::Font`
inherits `Reference` #

Class for loading and manipulating character fonts

Fonts can be loaded from a file, from memory or from a custom stream, and supports the most common types of fonts. See the load_from_file function for the complete list of supported formats.

Once it is loaded, a SF::Font instance provides three types of information about the font:

Global metrics, such as the line spacing
Per-glyph metrics, such as bounding box or kerning
Pixel representation of glyphs

Fonts alone are not very useful: they hold the font data but cannot make anything useful of it. To do so you need to use the SF::Text class, which is able to properly output text with several options such as character size, style, color, position, rotation, etc. This separation allows more flexibility and better performances: indeed a SF::Font is a heavy resource, and any operation on it is slow (often too slow for real-time applications). On the other side, a SF::Text is a lightweight object which can combine the glyphs data and metrics of a SF::Font to display any text on a render target. Note that it is also possible to bind several SF::Text instances to the same SF::Font.

It is important to note that the SF::Text instance doesn't copy the font that it uses, it only keeps a reference to it. Thus, a SF::Font must not be destructed while it is used by a SF::Text (i.e. never write a function that uses a local SF::Font instance for creating a text).

Usage example:

# Load a new font from file
font = SF::Font.from_file("arial.ttf")

# Create a text which uses our font
text1 = SF::Text.new("text", font, 30)

# Create another text using the same font, but with different parameters
text2 = SF::Text.new
text2.font = font
text2.character_size = 50
text2.style = SF::Text::Italic

Apart from loading font files, and passing them to instances of SF::Text, you should normally not have to deal directly with this class. However, it may be useful to access the font metrics or rasterized glyphs for advanced usage.

Note that if the font is a bitmap font, it is not scalable, thus not all requested sizes will be available to use. This needs to be taken into consideration when using SF::Text. If you need to display text of a certain size, make sure the corresponding bitmap font that supports that size is used.

See also: SF::Text

Constructors#

`.from_file(*args, **kwargs) : self`#

Shorthand for font = Font.new; font.load_from_file(...); font

Raises InitError on failure

class SF::Font inherits Reference #

Constructors#

.from_file(*args, **kwargs) : self#

.from_memory(*args, **kwargs) : self#

.from_stream(*args, **kwargs) : self#

.new#

Methods#

#dup : Font#

#finalize#

#get_glyph(code_point : Int, character_size : Int, bold : Bool, outline_thickness : Number = 0) : Glyph#

#get_kerning(first : Int, second : Int, character_size : Int, bold : Bool = false) : Float32#

#get_line_spacing(character_size : Int) : Float32#

#get_texture(character_size : Int) : Texture#

#get_underline_position(character_size : Int) : Float32#

#get_underline_thickness(character_size : Int) : Float32#

#glyph?(code_point : Int) : Bool#

#info : Font::Info#

#load_from_file(filename : String) : Bool#

#load_from_memory(data : Slice) : Bool#

#load_from_stream(stream : InputStream) : Bool#

#smooth=(smooth : Bool)#

#smooth? : Bool#

class `SF::Font`
inherits `Reference` #

`.from_file(*args, **kwargs) : self`#

`.from_memory(*args, **kwargs) : self`#

`.from_stream(*args, **kwargs) : self`#

`.new`#

`#dup : Font`#

`#finalize`#

`#get_glyph(code_point : Int, character_size : Int, bold : Bool, outline_thickness : Number = 0) : Glyph`#

`#get_kerning(first : Int, second : Int, character_size : Int, bold : Bool = false) : Float32`#

`#get_line_spacing(character_size : Int) : Float32`#

`#get_texture(character_size : Int) : Texture`#

`#get_underline_position(character_size : Int) : Float32`#

`#get_underline_thickness(character_size : Int) : Float32`#

`#glyph?(code_point : Int) : Bool`#

`#info : Font::Info`#

`#load_from_file(filename : String) : Bool`#

`#load_from_memory(data : Slice) : Bool`#

`#load_from_stream(stream : InputStream) : Bool`#

`#smooth=(smooth : Bool)`#

`#smooth? : Bool`#