summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorthemancalledjakob <jakob@jrkb.land>2023-03-01 15:11:45 +0100
committerYuri Sizov <yuris@humnom.net>2023-03-13 14:33:24 +0100
commite043484d36fb51c89cff65a5611157e7956dd932 (patch)
treeba621d3a6ea088d13f38458f8d672c7f36c9683a /doc
parenta026669cc59e83a99e3dcac1169c955d01859320 (diff)
improve documentation for Font and FontVariation
Co-authored-by: Hugo Locurcio <hugo.locurcio@hugo.pro> (cherry picked from commit fb5c2d9f755f31edf127256b01d0e2c60c49805f)
Diffstat (limited to 'doc')
-rw-r--r--doc/classes/Font.xml11
-rw-r--r--doc/classes/FontVariation.xml11
2 files changed, 21 insertions, 1 deletions
diff --git a/doc/classes/Font.xml b/doc/classes/Font.xml
index 2f1c68c322..4b46f00821 100644
--- a/doc/classes/Font.xml
+++ b/doc/classes/Font.xml
@@ -271,6 +271,17 @@
<description>
Returns list of supported [url=https://docs.microsoft.com/en-us/typography/opentype/spec/dvaraxisreg]variation coordinates[/url], each coordinate is returned as [code]tag: Vector3i(min_value,max_value,default_value)[/code].
Font variations allow for continuous change of glyph characteristics along some given design axis, such as weight, width or slant.
+ To print available variation axes of a variable font:
+ [codeblock]
+ var fv = FontVariation.new()
+ fv.set_base_font = load("res://RobotoFlex.ttf")
+ var variation_list = fv.get_supported_variation_list()
+ for tag in variation_list:
+ var name = TextServerManager.get_primary_interface().tag_to_name(tag)
+ var values = variation_list[tag]
+ print("variation axis: %s (%d)\n\tmin, max, default: %s" % [name, tag, values])
+ [/codeblock]
+ [b]Note:[/b] To set and get variation coordinates of a [FontVariation], use [member FontVariation.variation_opentype].
</description>
</method>
<method name="get_underline_position" qualifiers="const">
diff --git a/doc/classes/FontVariation.xml b/doc/classes/FontVariation.xml
index 11286e46a4..abe282db7e 100644
--- a/doc/classes/FontVariation.xml
+++ b/doc/classes/FontVariation.xml
@@ -22,6 +22,13 @@
GetNode("Label").AddThemeFontSizeOverride("font_size", 64);
[/csharp]
[/codeblocks]
+ To set the coordinate of multiple variation axes:
+ [codeblock]
+ var fv = FontVariation.new();
+ var ts = TextServerManager.get_primary_interface()
+ fv.base_font = load("res://BarlowCondensed-Regular.ttf")
+ fv.variation_opentype = { ts.name_to_tag("wght"): 900, ts.name_to_tag("custom_hght"): 900 }
+ [/codeblock]
</description>
<tutorials>
</tutorials>
@@ -40,7 +47,7 @@
Base font used to create a variation. If not set, default [Theme] font is used.
</member>
<member name="fallbacks" type="Font[]" setter="set_fallbacks" getter="get_fallbacks" default="[]">
- Array of fallback [Font]s. If not set [member base_font] fallback are ussed.
+ Array of fallback [Font]s to use as a substitute if a glyph is not found in this [FontVariation]. If not set, [member base_font]'s fallbacks are used instead.
</member>
<member name="opentype_features" type="Dictionary" setter="set_opentype_features" getter="get_opentype_features" default="{}">
A set of OpenType feature tags. More info: [url=https://docs.microsoft.com/en-us/typography/opentype/spec/featuretags]OpenType feature tags[/url].
@@ -66,6 +73,8 @@
</member>
<member name="variation_opentype" type="Dictionary" setter="set_variation_opentype" getter="get_variation_opentype" default="{}">
Font OpenType variation coordinates. More info: [url=https://docs.microsoft.com/en-us/typography/opentype/spec/dvaraxisreg]OpenType variation tags[/url].
+ [b]Note:[/b] This [Dictionary] uses OpenType tags as keys. Variation axes can be identified both by tags([code]int[/code]) and names ([code]string[/code]). Some axes might be accessible by multiple names. For example, [code]wght[/code] refers to the same axis as [code]weight[/code]. Tags on the other hand are unique. To convert between names and tags, use [method TextServer.name_to_tag] and [method TextServer.tag_to_name].
+ [b]Note:[/b] To get available variation axes of a font, use [method Font.get_supported_variation_list].
</member>
<member name="variation_transform" type="Transform2D" setter="set_variation_transform" getter="get_variation_transform" default="Transform2D(1, 0, 0, 1, 0, 0)">
2D transform, applied to the font outlines, can be used for slanting, flipping and rotating glyphs.