Mention named instances in the var-fonts section

This commit is contained in:
Matthias Clasen 2022-12-31 08:51:19 -05:00 committed by Behdad Esfahbod
parent 37e90c64c1
commit a390590451
1 changed files with 12 additions and 1 deletions

View File

@ -467,13 +467,24 @@
range actually implemented in the font's variation axis. After range actually implemented in the font's variation axis. After
all, a font might only provide lighter-than-regular weights, and all, a font might only provide lighter-than-regular weights, and
setting a heavier value on the <literal>wght</literal> axis will setting a heavier value on the <literal>wght</literal> axis will
not change that. not change that.
</para> </para>
<para> <para>
Once your variation settings are specified on your font object, Once your variation settings are specified on your font object,
however, shaping with a variable font is just like shaping a however, shaping with a variable font is just like shaping a
static font. static font.
</para> </para>
<para>
In addition to providing the variation axes themselves, fonts may also
pre-define certain variation coordinates as named instances. HarfBuzz
makes these coordinates (and their associated names) available via
<function>hb_ot_var_named_instance_get_design_coords()</function> and
<function>hb_ot_var_named_instance_get_subfamily_name_id()</function>.
</para>
<para>
Applications should treat named instances like multiple independent,
static fonts.
</para>
</section> </section>
</chapter> </chapter>