SystemFont loads a font from a system font with the first matching name from font_names.
It will attempt to match font style, but it's not guaranteed.
The returned font might be part of a font collection or be a variable font with OpenType "weight", "width" and/or "italic" features set.
You can create FontVariation of the system font for precise control over its features.
If set to true
, system fonts can be automatically used as fallbacks.
Font anti-aliasing mode.
If set to true
, italic or oblique font is preferred.
Array of font family names to search, first matching font found is used.
Preferred font stretch amount, compared to a normal width. A percentage value between 50%
and 200%
.
Preferred weight (boldness) of the font. A value in the 100...999
range, normal font weight is 400
, bold font weight is 700
.
If set to true
, auto-hinting is supported and preferred over font built-in hinting.
If set to true
, generate mipmaps for the font textures.
Font hinting mode.
The width of the range around the shape between the minimum and maximum representable signed distance. If using font outlines, msdf_pixel_range must be set to at least twice the size of the largest font outline. The default msdf_pixel_range value of 16
allows outline sizes up to 8
to look correct.
Source font size used to generate MSDF textures. Higher values allow for more precision, but are slower to render and require more memory. Only increase this value if you notice a visible lack of precision in glyph rendering.
If set to true
, glyphs of all sizes are rendered using single multichannel signed distance field generated from the dynamic font vector data.
Font oversampling factor, if set to 0.0
global oversampling factor is used instead.
Font glyph subpixel positioning mode. Subpixel positioning provides shaper text and better kerning for smaller font sizes, at the cost of memory usage and font rasterization speed. Use TextServer.SUBPIXEL_POSITIONING_AUTO to automatically enable it based on the font size.