diff --git a/tutorials/ui/bbcode_in_richtextlabel.rst b/tutorials/ui/bbcode_in_richtextlabel.rst index 1b54aefaa..9eb1f0ed1 100644 --- a/tutorials/ui/bbcode_in_richtextlabel.rst +++ b/tutorials/ui/bbcode_in_richtextlabel.rst @@ -711,11 +711,15 @@ Wave .. image:: img/bbcode_in_richtextlabel_effect_wave.webp Wave makes the text go up and down. Its tag format is -``[wave amp=50.0 freq=5.0]{text}[/wave]``. +``[wave amp=50.0 freq=5.0 connected=1]{text}[/wave]``. ``amp`` controls how high and low the effect goes, and ``freq`` controls how fast the text goes up and down. A ``freq`` value of ``0`` will result in no -visible waves, and negative ``freq`` values won't display any waves either. +visible waves, and negative ``freq`` values won't display any waves either. If +``connected`` is ``1`` (default), glyphs with ligatures will be moved together. +If ``connected`` is ``0``, each glyph is moved individually even if they are +joined by ligatures. This can work around certain rendering issues with font +ligatures. Tornado ~~~~~~~ @@ -723,21 +727,29 @@ Tornado .. image:: img/bbcode_in_richtextlabel_effect_tornado.webp Tornao makes the text move around in a circle. Its tag format is -``[tornado radius=10.0 freq=1.0]{text}[/tornado]``. +``[tornado radius=10.0 freq=1.0 connected=1]{text}[/tornado]``. ``radius`` is the radius of the circle that controls the offset, ``freq`` is how fast the text moves in a circle. A ``freq`` value of ``0`` will pause the -animation, while negative ``freq`` will play the animation backwards. +animation, while negative ``freq`` will play the animation backwards. If +``connected`` is ``1`` (default), glyphs with ligatures will be moved together. +If ``connected`` is ``0``, each glyph is moved individually even if they are +joined by ligatures. This can work around certain rendering issues with font +ligatures. Shake ~~~~~ .. image:: img/bbcode_in_richtextlabel_effect_shake.webp -Shake makes the text shake. Its tag format is ``[shake rate=20.0 level=5]{text}[/shake]``. +Shake makes the text shake. Its tag format is +``[shake rate=20.0 level=5 connected=1]{text}[/shake]``. -``rate`` controls how fast the text shakes, ``level`` controls how far the text is -offset from the origin. +``rate`` controls how fast the text shakes, ``level`` controls how far the text +is offset from the origin. If ``connected`` is ``1`` (default), glyphs with +ligatures will be moved together. If ``connected`` is ``0``, each glyph is moved +individually even if they are joined by ligatures. This can work around certain +rendering issues with font ligatures. Fade ~~~~ diff --git a/tutorials/ui/gui_using_fonts.rst b/tutorials/ui/gui_using_fonts.rst index 7ee0f6511..f98a18a8f 100644 --- a/tutorials/ui/gui_using_fonts.rst +++ b/tutorials/ui/gui_using_fonts.rst @@ -629,6 +629,14 @@ For example, here's the `Inter `__ font without the OpenType feature comparison (Inter) +You can disable ligatures and/or kerning for a specific font by adding OpenType +features, then unchecking them in the inspector: + +.. figure:: img/using_fonts_font_variation_disable_ligatures.webp + :align: center + + Disabling ligatures and kerning for a font + .. _doc_using_fonts_system_fonts: System fonts diff --git a/tutorials/ui/img/using_fonts_font_variation_disable_ligatures.webp b/tutorials/ui/img/using_fonts_font_variation_disable_ligatures.webp new file mode 100644 index 000000000..cd4fe1e8c Binary files /dev/null and b/tutorials/ui/img/using_fonts_font_variation_disable_ligatures.webp differ