mirror of
https://github.com/godotengine/godot.git
synced 2024-11-27 09:16:35 +08:00
a19e389f4f
Antialiasing cannot be adjusted on fonts rendered with MSDF. Internally, Godot always uses grayscale antialiasing for those fonts. This also tweaks property hints for consistency, and renames uses of "sub-pixel" to the more commonly used "subpixel".
48 lines
3.2 KiB
XML
48 lines
3.2 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="SystemFont" inherits="Font" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
|
|
<brief_description>
|
|
Font loaded from a system font.
|
|
[b]Note:[/b] This class is implemented on iOS, Linux, macOS and Windows, on other platforms it will fallback to default theme font.
|
|
</brief_description>
|
|
<description>
|
|
[SystemFont] loads a font from a system font with the first matching name from [member 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" and/or "italic" features set.
|
|
You can create [FontVariation] of the system font for fine control over its features.
|
|
</description>
|
|
<tutorials>
|
|
</tutorials>
|
|
<members>
|
|
<member name="antialiasing" type="int" setter="set_antialiasing" getter="get_antialiasing" enum="TextServer.FontAntialiasing" default="1">
|
|
Font anti-aliasing mode.
|
|
</member>
|
|
<member name="fallbacks" type="Font[]" setter="set_fallbacks" getter="get_fallbacks" default="[]">
|
|
Array of fallback [Font]s.
|
|
</member>
|
|
<member name="font_names" type="PackedStringArray" setter="set_font_names" getter="get_font_names" default="PackedStringArray()">
|
|
Array of font family names to search, first matching font found is used.
|
|
</member>
|
|
<member name="font_style" type="int" setter="set_font_style" getter="get_font_style" enum="TextServer.FontStyle" default="0">
|
|
Font style flags, see [enum TextServer.FontStyle].
|
|
</member>
|
|
<member name="force_autohinter" type="bool" setter="set_force_autohinter" getter="is_force_autohinter" default="false">
|
|
If set to [code]true[/code], auto-hinting is supported and preferred over font built-in hinting.
|
|
</member>
|
|
<member name="generate_mipmaps" type="bool" setter="set_generate_mipmaps" getter="get_generate_mipmaps" default="false">
|
|
If set to [code]true[/code], generate mipmaps for the font textures.
|
|
</member>
|
|
<member name="hinting" type="int" setter="set_hinting" getter="get_hinting" enum="TextServer.Hinting" default="1">
|
|
Font hinting mode.
|
|
</member>
|
|
<member name="multichannel_signed_distance_field" type="bool" setter="set_multichannel_signed_distance_field" getter="is_multichannel_signed_distance_field" default="false">
|
|
If set to [code]true[/code], glyphs of all sizes are rendered using single multichannel signed distance field generated from the dynamic font vector data.
|
|
</member>
|
|
<member name="oversampling" type="float" setter="set_oversampling" getter="get_oversampling" default="0.0">
|
|
Font oversampling factor, if set to [code]0.0[/code] global oversampling factor is used instead.
|
|
</member>
|
|
<member name="subpixel_positioning" type="int" setter="set_subpixel_positioning" getter="get_subpixel_positioning" enum="TextServer.SubpixelPositioning" default="1">
|
|
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 [constant TextServer.SUBPIXEL_POSITIONING_AUTO] to automatically enable it based on the font size.
|
|
</member>
|
|
</members>
|
|
</class>
|