mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-05 14:10:19 +03:00
1516 lines
64 KiB
Plaintext
1516 lines
64 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
||
# Copyright (C) 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0)
|
||
# This file is distributed under the same license as the Godot Engine package.
|
||
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
||
#
|
||
#, fuzzy
|
||
msgid ""
|
||
msgstr ""
|
||
"Project-Id-Version: Godot Engine latest\n"
|
||
"Report-Msgid-Bugs-To: \n"
|
||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||
"MIME-Version: 1.0\n"
|
||
"Content-Type: text/plain; charset=UTF-8\n"
|
||
"Content-Transfer-Encoding: 8bit\n"
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:4
|
||
msgid "BBCode in RichTextLabel"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:7
|
||
msgid "Introduction"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:9
|
||
msgid ":ref:`class_Label` nodes are great for displaying basic text, but they have limitations. If you want to change the color of the text, or its alignment, you can only do that to the entire label. You can't make a part of the text have another color, or have a part of the text centered. To get around these limitations, you would use a :ref:`class_RichTextLabel`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:14
|
||
msgid ":ref:`class_RichTextLabel` allows for complex formatting of text using a markup syntax or the built-in API. It uses BBCodes for the markup syntax, a system of tags that designate formatting rules for a part of the text. You may be familiar with them if you ever used forums (also known as `bulletin boards`, hence the \"BB\" in \"BBCode\")."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:19
|
||
msgid "Unlike Label, RichTextLabel also comes with its own vertical scrollbar. This scrollbar is automatically displayed if the text does not fit within the control's size. The scrollbar can be disabled by unchecking the **Scroll Active** property in the RichTextLabel inspector."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:24
|
||
msgid "Note that the BBCode tags can also be used to some extent for other use cases:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:26
|
||
msgid "BBCode can be used to :ref:`format comments in the XML source of the class reference <doc_class_reference_bbcode>`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:27
|
||
msgid "BBCode can be used in :ref:`GDScript documentation comments <doc_gdscript_documentation_comments_bbcode_and_class_reference>`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:28
|
||
msgid "BBCode can be used when :ref:`printing rich text to the Output bottom panel <doc_output_panel_printing_rich_text>`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:32
|
||
msgid "You can see how BBCode in RichTextLabel works in action using the `Rich Text Label with BBCode demo project <https://github.com/godotengine/godot-demo-projects/tree/master/gui/rich_text_bbcode>`__."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:36
|
||
msgid "Using BBCode"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:38
|
||
msgid "By default, :ref:`class_RichTextLabel` functions like a normal :ref:`class_Label`. It has the :ref:`property_text <class_RichTextLabel_property_text>` property, which you can edit to have uniformly formatted text. To be able to use BBCode for rich text formatting, you need to turn on the BBCode mode by setting :ref:`bbcode_enabled <class_RichTextLabel_property_bbcode_enabled>`. After that, you can edit the :ref:`text <class_RichTextLabel_property_text>` property using available tags. Both properties are located at the top of the inspector after selecting a RichTextLabel node."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:48
|
||
msgid "For example, ``BBCode [color=green]test[/color]`` would render the word \"test\" with a green color."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:53
|
||
msgid "Most BBCodes consist of 3 parts: the opening tag, the content and the closing tag. The opening tag delimits the start of the formatted part, and can also carry some configuration options. Some opening tags, like the ``color`` one shown above, also require a value to work. Other opening tags may accept multiple options (separated by spaces within the opening tag). The closing tag delimits the end of the formatted part. In some cases, both the closing tag and the content can be omitted."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:61
|
||
msgid "Unlike BBCode in HTML, leading/trailing whitespace is not removed by a RichTextLabel upon display. Duplicate spaces are also displayed as-is in the final output. This means that when displaying a code block in a RichTextLabel, you don't need to use a preformatted text tag."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:76
|
||
msgid "RichTextLabel doesn't support entangled BBCode tags. For example, instead of using:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:83
|
||
msgid "Use:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:92
|
||
msgid "Handling user input safely"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:94
|
||
msgid "In a scenario where users may freely input text (such as chat in a multiplayer game), you should make sure users cannot use arbitrary BBCode tags that will be parsed by RichTextLabel. This is to avoid inappropriate use of formatting, which can be problematic if ``[url]`` tags are handled by your RichTextLabel (as players may be able to create clickable links to phishing sites or similar)."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:100
|
||
msgid "Using RichTextLabel's ``[lb]`` and/or ``[rb]`` tags, we can replace the opening and/or closing brackets of any BBCode tag in a message with those escaped tags. This prevents users from using BBCode that will be parsed as tags – instead, the BBCode will be displayed as text."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:105
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:109
|
||
msgid "Example of unescaped user input resulting in BBCode injection (2nd line) and escaped user input (3rd line)"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:111
|
||
msgid "The above image was created using the following script:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:140
|
||
msgid "Stripping BBCode tags"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:142
|
||
msgid "For certain use cases, it can be desired to remove BBCode tags from the string. This is useful when displaying the RichTextLabel's text in another Control that does not support BBCode (such as a tooltip):"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:158
|
||
msgid "Removing BBCode tags entirely isn't advised for user input, as it can modify the displayed text without users understanding why part of their message was removed. :ref:`Escaping user input <doc_bbcode_in_richtextlabel_handling_user_input_safely>` should be preferred instead."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:165
|
||
msgid "Performance"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:167
|
||
msgid "In most cases, you can use BBCode directly as-is since text formatting is rarely a heavy task. However, with particularly large RichTextLabels (such as console logs spanning thousands of lines), you may encounter stuttering during gameplay when the RichTextLabel's text is updated."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:172
|
||
msgid "There are several ways to alleviate this:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:174
|
||
msgid "Use the ``append_text()`` function instead of appending to the ``text`` property. This function will only parse BBCode for the added text, rather than parsing BBCode from the entire ``text`` property."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:177
|
||
msgid "Use ``push_[tag]()`` and ``pop()`` functions to add tags to RichTextLabel instead of using BBCode."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:179
|
||
msgid "Enable the **Threading > Threaded** property in RichTextLabel. This won't speed up processing, but it will prevent the main thread from blocking, which avoids stuttering during gameplay. Only enable threading if it's actually needed in your project, as threading has some overhead."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:187
|
||
msgid "Using push_[tag]() and pop() functions instead of BBCode"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:189
|
||
msgid "If you don't want to use BBCode for performance reasons, you can use functions provided by RichTextLabel to create formatting tags without writing BBCode in the text."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:193
|
||
msgid "Every BBCode tag (including effects) has a ``push_[tag]()`` function (where ``[tag]`` is the tag's name). There are also a few convenience functions available, such as ``push_bold_italics()`` that combines both ``push_bold()`` and ``push_italics()`` into a single tag. See the :ref:`RichTextLabel class reference <class_RichTextLabel>` for a complete list of ``push_[tag]()`` functions."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:200
|
||
msgid "The ``pop()`` function is used to end *any* tag. Since BBCode is a tag *stack*, using ``pop()`` will close the most recently started tags first."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:203
|
||
msgid "The following script will result in the same visual output as using ``BBCode [color=green]test [i]example[/i][/color]``:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:221
|
||
msgid "Do **not** set the ``text`` property directly when using formatting functions. Appending to the ``text`` property will erase all modifications made to the RichTextLabel using the ``append_text()``, ``push_[tag]()`` and ``pop()`` functions."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:227
|
||
msgid "Reference"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:231
|
||
msgid "*Some* of these BBCode tags can be used in tooltips for ``@export`` script variables as well as in the XML source of the class reference. For more information, see :ref:`Class reference BBCode <doc_class_reference_bbcode>`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:240
|
||
msgid "Tag"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:241
|
||
msgid "Example"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**b**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Makes ``{text}`` use the bold (or bold italics) font of ``RichTextLabel``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:246
|
||
msgid "``[b]{text}[/b]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**i**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Makes ``{text}`` use the italics (or bold italics) font of ``RichTextLabel``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:251
|
||
msgid "``[i]{text}[/i]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**u**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Makes ``{text}`` underlined."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:256
|
||
msgid "``[u]{text}[/u]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**s**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Makes ``{text}`` strikethrough."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:261
|
||
msgid "``[s]{text}[/s]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**code**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Makes ``{text}`` use the mono font of ``RichTextLabel``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:266
|
||
msgid "``[code]{text}[/code]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**char**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Adds Unicode character with hexadecimal UTF-32 ``{codepoint}``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:271
|
||
msgid "``[char={codepoint}]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**p**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Adds new paragraph with ``{text}``. Supports configuration options, see :ref:`doc_bbcode_in_richtextlabel_paragraph_options`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[p]{text}[/p]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[p {options}]{text}[/p]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**br**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Adds line break in a text, without adding a new paragraph. If used within a list, this won't create a new list item, but will add a line break within the current item instead."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:285
|
||
msgid "``[br]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**hr**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Adds new a horizontal rule to separate content. Supports configuration options, see :ref:`doc_bbcode_in_richtextlabel_hr_options`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[hr]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[hr {options}]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**center**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Makes ``{text}`` horizontally centered."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Same as ``[p align=center]``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:298
|
||
msgid "``[center]{text}[/center]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**left**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Makes ``{text}`` horizontally left-aligned."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Same as ``[p align=left]``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:304
|
||
msgid "``[left]{text}[/left]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**right**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Makes ``{text}`` horizontally right-aligned."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Same as ``[p align=right]``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:310
|
||
msgid "``[right]{text}[/right]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**fill**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Makes ``{text}`` fill the full width of ``RichTextLabel``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Same as ``[p align=fill]``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:316
|
||
msgid "``[fill]{text}[/fill]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**indent**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Indents ``{text}`` once. The indentation width is the same as with ``[ul]`` or ``[ol]``, but without a bullet point."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:322
|
||
msgid "``[indent]{text}[/indent]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**url**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Creates a hyperlink (underlined and clickable text). Can contain optional ``{text}`` or display ``{link}`` as is."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**Must be handled with the \"meta_clicked\" signal to have an effect,** see :ref:`doc_bbcode_in_richtextlabel_handling_url_tag_clicks`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[url]{link}[/url]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[url={link}]{text}[/url]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**hint**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Creates a tooltip hint that is displayed when hovering the text with the mouse. While not required, it's recommended to put tooltip text between double or single quotes. Note that it is not possible to escape quotes using ``\\\"`` or ``\\'``. To use single quotes for apostrophes in the hint string, you must use double quotes to surround the string."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[hint=\"{tooltip text displayed on hover}\"]{text}[/hint]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**img**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Inserts an image from the ``{path}`` (can be any valid :ref:`class_Texture2D` resource)."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "If ``{width}`` is provided, the image will try to fit that width maintaining the aspect ratio."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "If both ``{width}`` and ``{height}`` are provided, the image will be scaled to that size."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Add ``%`` to the end of ``{width}`` or ``{height}`` value to specify it as percentages of the control width instead of pixels."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "If ``{valign}`` configuration is provided, the image will try to align to the surrounding text, see :ref:`doc_bbcode_in_richtextlabel_image_and_table_alignment`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Supports configuration options, see :ref:`doc_bbcode_in_richtextlabel_image_options`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[img]{path}[/img]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[img={width}]{path}[/img]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[img={width}x{height}]{path}[/img]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[img={valign}]{path}[/img]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[img {options}]{path}[/img]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**font**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Makes ``{text}`` use a font resource from the ``{path}``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Supports configuration options, see :ref:`doc_bbcode_in_richtextlabel_font_options`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[font={path}]{text}[/font]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[font {options}]{text}[/font]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**font_size**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Use custom font size for ``{text}``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:367
|
||
msgid "``[font_size={size}]{text}[/font_size]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**dropcap**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Use a different font size and color for ``{text}``, while making the tag's contents span multiple lines if it's large enough."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "A `drop cap <https://www.computerhope.com/jargon/d/dropcap.htm>`__ is typically one uppercase character, but ``[dropcap]`` supports containing multiple characters. ``margins`` values are comma-separated and can be positive, zero or negative. Values must **not** be separated by spaces; otherwise, the values won't be parsed correctly. Negative top and bottom margins are particularly useful to allow the rest of the paragraph to display below the dropcap."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:379
|
||
msgid "``[dropcap font={font} font_size={size} color={color} outline_size={size} outline_color={color} margins={left},{top},{right},{bottom}]{text}[/dropcap]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**opentype_features**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Enables custom OpenType font features for ``{text}``. Features must be provided as a comma-separated ``{list}``. Values must **not** be separated by spaces; otherwise, the list won't be parsed correctly."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[opentype_features={list}]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``{text}``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[/opentype_features]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**lang**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Overrides the language for ``{text}`` that is set by the **BiDi > Language** property in :ref:`class_RichTextLabel`. ``{code}`` must be an ISO :ref:`language code <doc_locales>`. This can be used to enforce the use of a specific script for a language without starting a new paragraph. Some font files may contain script-specific substitutes, in which case they will be used."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:397
|
||
msgid "``[lang={code}]{text}[/lang]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:618
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:664
|
||
msgid "**color**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Changes the color of ``{text}``. Color must be provided by a common name (see :ref:`doc_bbcode_in_richtextlabel_named_colors`) or using the HEX format (e.g. ``#ff00ff``, see :ref:`doc_bbcode_in_richtextlabel_hex_colors`)."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:404
|
||
msgid "``[color={code/name}]{text}[/color]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**bgcolor**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Draws the color behind ``{text}``. This can be used to highlight text. Accepts same values as the ``color`` tag. By default, there is a slight padding which is controlled by the ``text_highlight_h_padding`` and ``text_highlight_v_padding`` theme items in the RichTextLabel node. Set padding to ``0`` to avoid potential overlapping issues when there are background colors on neighboring lines/columns."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:414
|
||
msgid "``[bgcolor={code/name}]{text}[/bgcolor]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**fgcolor**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Draws the color in front of ``{text}``. This can be used to \"redact\" text by using an opaque foreground color. Accepts same values as the ``color`` tag. By default, there is a slight padding which is controlled by the ``text_highlight_h_padding`` and ``text_highlight_v_padding`` theme items in the RichTextLabel node. Set padding to ``0`` to avoid potential overlapping issues when there are foreground colors on neighboring lines/columns."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:424
|
||
msgid "``[fgcolor={code/name}]{text}[/fgcolor]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**outline_size**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Use custom font outline size for ``{text}``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[outline_size={size}]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[/outline_size]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**outline_color**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Use custom outline color for ``{text}``. Accepts same values as the ``color`` tag."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[outline_color={code/name}]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[/outline_color]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**table**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Creates a table with the ``{number}`` of columns. Use the ``cell`` tag to define table cells."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "If ``{valign}`` configuration is provided, the table will try to align to the surrounding text, see :ref:`doc_bbcode_in_richtextlabel_image_and_table_alignment`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "If baseline alignment is used, the table is aligned to the baseline of the row with index ``{alignment_row}`` (zero-based)."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[table={number}]{cells}[/table]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[table={number},{valign}]{cells}[/table]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[table={number},{valign},{alignment_row}]{cells}[/table]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**cell**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Adds a cell with ``{text}`` to the table."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "If ``{ratio}`` is provided, the cell will try to expand to that value proportionally to other cells and their ratio values."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Supports configuration options, see :ref:`doc_bbcode_in_richtextlabel_cell_options`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[cell]{text}[/cell]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[cell={ratio}]{text}[/cell]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[cell {options}]{text}[/cell]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**ul**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Adds an unordered list. List ``{items}`` must be provided by putting one item per line of text."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "The bullet point can be customized using the ``{bullet}`` parameter, see :ref:`doc_bbcode_in_richtextlabel_unordered_list_bullet`."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[ul]{items}[/ul]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[ul bullet={bullet}]{items}[/ul]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**ol**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Adds an ordered (numbered) list of the given ``{type}`` (see :ref:`doc_bbcode_in_richtextlabel_list_types`). List ``{items}`` must be provided by putting one item per line of text."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:474
|
||
msgid "``[ol type={type}]{items}[/ol]``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "**lb**, **rb**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Adds ``[`` and ``]`` respectively. Allows escaping BBCode markup."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "These are self-closing tags, which means you do not need to close them (and there is no ``[/lb]`` or ``[/rb]`` closing tag)."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[lb]b[rb]text[lb]/b[rb]`` will display as ``[b]text[/b]``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "Several Unicode control characters can be added using their own self-closing tags."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "This can result in easier maintenance compared to pasting those"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "control characters directly in the text."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[lrm]`` (left-to-right mark), ``[rlm]`` (right-to-left mark), ``[lre]`` (left-to-right embedding),"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[rle]`` (right-to-left embedding), ``[lro]`` (left-to-right override), ``[rlo]`` (right-to-left override),"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[pdf]`` (pop directional formatting), ``[alm]`` (Arabic letter mark), ``[lri]`` (left-to-right isolate),"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[rli]`` (right-to-left isolate), ``[fsi]`` (first strong isolate), ``[pdi]`` (pop directional isolate),"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[zwj]`` (zero-width joiner), ``[zwnj]`` (zero-width non-joiner), ``[wj]`` (word joiner),"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:0
|
||
msgid "``[shy]`` (soft hyphen)"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:496
|
||
msgid "Tags for bold (``[b]``) and italics (``[i]``) formatting work best if the appropriate custom fonts are set up in the RichTextLabelNode's theme overrides. If no custom bold or italic fonts are defined, `faux bold and italic fonts <https://fonts.google.com/knowledge/glossary/faux_fake_pseudo_synthesized>`__ will be generated by Godot. These fonts rarely look good in comparison to hand-made bold/italic font variants."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:502
|
||
msgid "The monospaced (``[code]``) tag **only** works if a custom font is set up in the RichTextLabel node's theme overrides. Otherwise, monospaced text will use the regular font."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:505
|
||
msgid "There are no BBCode tags to control vertical centering of text yet."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:507
|
||
msgid "Options can be skipped for all tags."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:512
|
||
msgid "Paragraph options"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:514
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:648
|
||
msgid "**align**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:517
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:527
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:538
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:550
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:560
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:570
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:621
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:631
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:641
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:651
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:667
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:677
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:687
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:697
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:707
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:717
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:769
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:779
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:789
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:799
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:809
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:819
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:829
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:839
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:849
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:859
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:875
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:926
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:937
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:947
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:958
|
||
msgid "`Values`"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:517
|
||
msgid "``left`` (or ``l``), ``center`` (or ``c``), ``right`` (or ``r``), ``fill`` (or ``f``)"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:519
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:530
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:542
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:552
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:562
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:572
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:623
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:633
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:643
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:653
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:669
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:679
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:689
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:699
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:709
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:719
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:771
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:781
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:791
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:801
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:811
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:821
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:831
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:841
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:851
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:861
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:877
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:928
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:939
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:949
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:960
|
||
msgid "`Default`"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:519
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:653
|
||
msgid "``left``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:522
|
||
msgid "Text horizontal alignment."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:524
|
||
msgid "**bidi_override**, **st**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:527
|
||
msgid "``default`` (of ``d``), ``uri`` (or ``u``), ``file`` (or ``f``), ``email`` (or ``e``), ``list`` (or ``l``), ``none`` (or ``n``), ``custom`` (or ``c``)"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:530
|
||
msgid "``default``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:533
|
||
msgid "Structured text override."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:535
|
||
msgid "**justification_flags**, **jst**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:538
|
||
msgid "Comma-separated list of the following values (no space after each comma): ``kashida`` (or ``k``), ``word`` (or ``w``), ``trim`` (or ``tr``), ``after_last_tab`` (or ``lt``), ``skip_last`` (or ``sl``), ``skip_last_with_chars`` (or ``sv``), ``do_not_skip_single`` (or ``ns``)."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:542
|
||
msgid "``word,kashida,skip_last,do_not_skip_single``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:545
|
||
msgid "Justification (fill alignment) option. See :ref:`class_TextServer` for more details."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:547
|
||
msgid "**direction**, **dir**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:550
|
||
msgid "``ltr`` (or ``l``), ``rtl`` (or ``r``), ``auto`` (or ``a``)"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:552
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:562
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:669
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:679
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:689
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:699
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:771
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:781
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:791
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:801
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:811
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:821
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:939
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:949
|
||
msgid "Inherit"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:555
|
||
msgid "Base BiDi direction."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:557
|
||
msgid "**language**, **lang**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:560
|
||
msgid "ISO language codes. See :ref:`doc_locales`"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:565
|
||
msgid "Locale override. Some font files may contain script-specific substitutes, in which case they will be used."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:567
|
||
msgid "**tab_stops**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:570
|
||
msgid "List of floating-point numbers, e.g. ``10.0,30.0``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:572
|
||
msgid "Width of the space character in the font"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:575
|
||
msgid "Overrides the horizontal offsets for each tab character. When the end of the list is reached, the tab stops will loop over. For example, if you set ``tab_stops`` to ``10.0,30.0``, the first tab will be at ``10`` pixels, the second tab will be at ``10 + 30 = 40`` pixels, and the third tab will be at ``10 + 30 + 10 = 50`` pixels from the origin of the RichTextLabel."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:584
|
||
msgid "Handling ``[url]`` tag clicks"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:586
|
||
msgid "By default, ``[url]`` tags do nothing when clicked. This is to allow flexible use of ``[url]`` tags rather than limiting them to opening URLs in a web browser."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:589
|
||
msgid "To handle clicked ``[url]`` tags, connect the ``RichTextLabel`` node's :ref:`meta_clicked <class_RichTextLabel_signal_meta_clicked>` signal to a script function."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:592
|
||
msgid "For example, the following method can be connected to ``meta_clicked`` to open clicked URLs using the user's default web browser:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:604
|
||
msgid "For more advanced use cases, it's also possible to store JSON in a ``[url]`` tag's option and parse it in the function that handles the ``meta_clicked`` signal. For example:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:616
|
||
msgid "Horizontal rule options"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:621
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:667
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:937
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:947
|
||
msgid "Color name or color in HEX format"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:623
|
||
msgid "``Color(1, 1, 1, 1)``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:626
|
||
msgid "Color tint of the rule (modulation)."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:628
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:674
|
||
msgid "**height**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:631
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:641
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:677
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:687
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:926
|
||
msgid "Integer number"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:633
|
||
msgid "``2``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:636
|
||
msgid "Target height of the rule in pixels, add ``%`` to the end of value to specify it as percentages of the control width instead of pixels."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:638
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:684
|
||
msgid "**width**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:643
|
||
msgid "``90%``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:646
|
||
msgid "Target width of the rule in pixels, add ``%`` to the end of value to specify it as percentages of the control width instead of pixels."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:651
|
||
msgid "``left`` (or ``l``), ``center`` (or ``c``), ``right`` (or ``r``)"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:656
|
||
msgid "Horizontal alignment."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:662
|
||
msgid "Image options"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:672
|
||
msgid "Color tint of the image (modulation)."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:682
|
||
msgid "Target height of the image in pixels, add ``%`` to the end of value to specify it as percentages of the control width instead of pixels."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:692
|
||
msgid "Target width of the image in pixels, add ``%`` to the end of value to specify it as percentages of the control width instead of pixels."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:694
|
||
msgid "**region**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:697
|
||
msgid "x,y,width,height in pixels"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:702
|
||
msgid "Region rect of the image. This can be used to display a single image from a spritesheet."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:704
|
||
msgid "**pad**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:707
|
||
msgid "``false``, ``true``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:709
|
||
msgid "``false``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:712
|
||
msgid "If set to ``true``, and the image is smaller than the size specified by ``width`` and ``height``, the image padding is added to match the size instead of upscaling."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:714
|
||
msgid "**tooltip**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:717
|
||
msgid "String"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:722
|
||
msgid "Image tooltip."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:727
|
||
msgid "Image and table vertical alignment"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:729
|
||
msgid "When a vertical alignment value is provided with the ``[img]`` or ``[table]`` tag the image/table will try to align itself against the surrounding text. Alignment is performed using a vertical point of the image and a vertical point of the text. There are 3 possible points on the image (``top``, ``center``, and ``bottom``) and 4 possible points on the text and table (``top``, ``center``, ``baseline``, and ``bottom``), which can be used in any combination."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:736
|
||
msgid "To specify both points, use their full or short names as a value of the image/table tag:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:753
|
||
msgid "You can also specify just one value (``top``, ``center``, or ``bottom``) to make use of a corresponding preset (``top-top``, ``center-center``, and ``bottom-bottom`` respectively)."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:757
|
||
msgid "Short names for the values are ``t`` (``top``), ``c`` (``center``), ``l`` (``baseline``), and ``b`` (``bottom``)."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:764
|
||
msgid "Font options"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:766
|
||
msgid "**name**, **n**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:769
|
||
msgid "A valid Font resource path."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:774
|
||
msgid "Font resource path."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:776
|
||
msgid "**size**, **s**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:779
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:789
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:799
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:809
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:819
|
||
msgid "Number in pixels."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:784
|
||
msgid "Custom font size."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:786
|
||
msgid "**glyph_spacing**, **gl**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:794
|
||
msgid "Extra spacing for each glyph."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:796
|
||
msgid "**space_spacing**, **sp**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:804
|
||
msgid "Extra spacing for the space character."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:806
|
||
msgid "**top_spacing**, **top**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:814
|
||
msgid "Extra spacing at the top of the line."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:816
|
||
msgid "**bottom_spacing**, **bt**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:824
|
||
msgid "Extra spacing at the bottom of the line."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:826
|
||
msgid "**embolden**, **emb**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:829
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:849
|
||
msgid "Floating-point number."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:831
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:851
|
||
msgid "``0.0``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:834
|
||
msgid "Font embolden strength, if it is not equal to zero, emboldens the font outlines. Negative values reduce the outline thickness."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:836
|
||
msgid "**face_index**, **fi**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:839
|
||
msgid "Integer number."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:841
|
||
msgid "``0``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:844
|
||
msgid "An active face index in the TrueType / OpenType collection."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:846
|
||
msgid "**slant**, **sln**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:854
|
||
msgid "Font slant strength, positive values slant glyphs to the right. Negative values to the left."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:856
|
||
msgid "**opentype_variation**, **otv**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:859
|
||
msgid "Comma-separated list of the OpenType variation tags (no space after each comma)."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:864
|
||
msgid "Font OpenType variation coordinates. See `OpenType variation tags <https://docs.microsoft.com/en-us/typography/opentype/spec/dvaraxisreg>`__."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:866
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:882
|
||
msgid "Note: The value should be enclosed in ``\"`` to allow using ``=`` inside it:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:872
|
||
msgid "**opentype_features**, **otf**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:875
|
||
msgid "Comma-separated list of the OpenType feature tags (no space after each comma)."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:880
|
||
msgid "Font OpenType features. See `OpenType features tags <https://docs.microsoft.com/en-us/typography/opentype/spec/featuretags>`__."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:891
|
||
msgid "Named colors"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:893
|
||
msgid "For tags that allow specifying a color by name, you can use names of the constants from the built-in :ref:`class_Color` class. Named classes can be specified in a number of styles using different casings: ``DARK_RED``, ``DarkRed``, and ``darkred`` will give the same exact result."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:898
|
||
msgid "See this image for a list of color constants:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:902
|
||
msgid "`View at full size <https://raw.githubusercontent.com/godotengine/godot-docs/master/img/color_constants.png>`__"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:907
|
||
msgid "Hexadecimal color codes"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:909
|
||
msgid "For opaque RGB colors, any valid 6-digit hexadecimal code is supported, e.g. ``[color=#ffffff]white[/color]``. Shorthand RGB color codes such as ``#6f2`` (equivalent to ``#66ff22``) are also supported."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:913
|
||
msgid "For transparent RGB colors, any RGBA 8-digit hexadecimal code can be used, e.g. ``[color=#ffffff88]translucent white[/color]``. Note that the alpha channel is the **last** component of the color code, not the first one. Short RGBA color codes such as ``#6f28`` (equivalent to ``#66ff2288``) are supported as well."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:921
|
||
msgid "Cell options"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:923
|
||
msgid "**expand**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:928
|
||
msgid "1"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:931
|
||
msgid "Cell expansion ratio. This defines which cells will try to expand to proportionally to other cells and their expansion ratios."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:934
|
||
msgid "**border**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:942
|
||
msgid "Cell border color."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:944
|
||
msgid "**bg**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:952
|
||
msgid "Cell background color. For alternating odd/even row backgrounds, you can use ``bg=odd_color,even_color``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:955
|
||
msgid "**padding**"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:958
|
||
msgid "4 comma-separated floating-point numbers (no space after each comma)"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:960
|
||
msgid "``0,0,0,0``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:963
|
||
msgid "Left, top, right, and bottom cell padding."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:968
|
||
msgid "Unordered list bullet"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:970
|
||
msgid "By default, the ``[ul]`` tag uses the ``U+2022`` \"Bullet\" Unicode glyph as the bullet character. This behavior is similar to web browsers. The bullet character can be customized using ``[ul bullet={bullet}]``. If provided, this ``{bullet}`` parameter must be a string with no enclosing quotes (for example, ``[bullet=*]``). You can add trailing spaces after the bullet character to increase the spacing between the bullet and the list item text."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:977
|
||
msgid "See `Bullet (typography) on Wikipedia <https://en.wikipedia.org/wiki/Bullet_(typography)>`__ for a list of common bullet characters that you can paste directly in the ``bullet`` parameter."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:983
|
||
msgid "Ordered list types"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:985
|
||
msgid "Ordered lists can be used to automatically mark items with numbers or letters in ascending order. This tag supports the following type options:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:989
|
||
msgid "``1`` - Numbers, using language specific numbering system if possible."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:990
|
||
msgid "``a``, ``A`` - Lower and upper case Latin letters."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:991
|
||
msgid "``i``, ``I`` - Lower and upper case Roman numerals."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:994
|
||
msgid "Text effects"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:996
|
||
msgid "BBCode can also be used to create different text effects that can optionally be animated. Five customizable effects are provided out of the box, and you can easily create your own. By default, animated effects will pause :ref:`when the SceneTree is paused <doc_pausing_games>`. You can change this behavior by adjusting the RichTextLabel's **Process > Mode** property."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1002
|
||
msgid "All examples below mention the default values for options in the listed tag format."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1006
|
||
msgid "Text effects that move characters' positions may result in characters being clipped by the RichTextLabel node bounds."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1009
|
||
msgid "You can resolve this by disabling **Control > Layout > Clip Contents** in the inspector after selecting the RichTextLabel node, or ensuring there is enough margin added around the text by using line breaks above and below the line using the effect."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1015
|
||
msgid "Pulse"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1019
|
||
msgid "Pulse creates an animated pulsing effect that multiplies each character's opacity and color. It can be used to bring attention to specific text. Its tag format is ``[pulse freq=1.0 color=#ffffff40 ease=-2.0]{text}[/pulse]``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1023
|
||
msgid "``freq`` controls the frequency of the half-pulsing cycle (higher is faster). A full pulsing cycle takes ``2 * (1.0 / freq)`` seconds. ``color`` is the target color multiplier for blinking. The default mostly fades out text, but not entirely. ``ease`` is the easing function exponent to use. Negative values provide in-out easing, which is why the default is ``-2.0``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1030
|
||
msgid "Wave"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1034
|
||
msgid "Wave makes the text go up and down. Its tag format is ``[wave amp=50.0 freq=5.0 connected=1]{text}[/wave]``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1037
|
||
msgid "``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. 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."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1046
|
||
msgid "Tornado"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1050
|
||
msgid "Tornado makes the text move around in a circle. Its tag format is ``[tornado radius=10.0 freq=1.0 connected=1]{text}[/tornado]``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1053
|
||
msgid "``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. 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."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1062
|
||
msgid "Shake"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1066
|
||
msgid "Shake makes the text shake. Its tag format is ``[shake rate=20.0 level=5 connected=1]{text}[/shake]``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1069
|
||
msgid "``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."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1076
|
||
msgid "Fade"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1080
|
||
msgid "Fade creates a static fade effect that multiplies each character's opacity. Its tag format is ``[fade start=4 length=14]{text}[/fade]``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1083
|
||
msgid "``start`` controls the starting position of the falloff relative to where the fade command is inserted, ``length`` controls over how many characters should the fade out take place."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1088
|
||
msgid "Rainbow"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1092
|
||
msgid "Rainbow gives the text a rainbow color that changes over time. Its tag format is ``[rainbow freq=1.0 sat=0.8 val=0.8 speed=1.0]{text}[/rainbow]``."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1095
|
||
msgid "``freq`` determines how many letters the rainbow extends over before it repeats itself, ``sat`` is the saturation of the rainbow, ``val`` is the value of the rainbow. ``speed`` is the number of full rainbow cycles per second. A positive ``speed`` value will play the animation forwards, a value of ``0`` will pause the animation, and a negative ``speed`` value will play the animation backwards."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1101
|
||
msgid "Font outlines are *not* affected by the rainbow effect (they keep their original color). Existing font colors are overridden by the rainbow effect. However, CanvasItem's **Modulate** and **Self Modulate** properties will affect how the rainbow effect looks, as modulation multiplies its final colors."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1107
|
||
msgid "Custom BBCode tags and text effects"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1109
|
||
msgid "You can extend the :ref:`class_RichTextEffect` resource type to create your own custom BBCode tags. Create a new script file that extends the :ref:`class_RichTextEffect` resource type and give the script a ``class_name`` so that the effect can be selected in the inspector. Add the ``@tool`` annotation to your GDScript file if you wish to have these custom effects run within the editor itself. The RichTextLabel does not need to have a script attached, nor does it need to be running in ``tool`` mode. The new effect can be registered in the Inspector by adding it to the **Markup > Custom Effects** array, or in code with the :ref:`install_effect() <class_RichTextLabel_method_install_effect>` method:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1118
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1122
|
||
msgid "Selecting a custom RichTextEffect after saving a script that extends RichTextEffect with a ``class_name``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1126
|
||
msgid "If the custom effect is not registered within the RichTextLabel's **Markup > Custom Effects** property, no effect will be visible and the original tag will be left as-is."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1130
|
||
msgid "There is only one function that you need to extend: ``_process_custom_fx(char_fx)``. Optionally, you can also provide a custom BBCode identifier by adding a member name ``bbcode``. The code will check the ``bbcode`` property automatically or will use the name of the file to determine what the BBCode tag should be."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1136
|
||
msgid "``_process_custom_fx``"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1138
|
||
msgid "This is where the logic of each effect takes place and is called once per glyph during the draw phase of text rendering. This passes in a :ref:`class_CharFXTransform` object, which holds a few variables to control how the associated glyph is rendered:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1142
|
||
msgid "``outline`` is ``true`` if effect is called for drawing text outline."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1143
|
||
msgid "``range`` tells you how far into a given custom effect block you are in as an index."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1145
|
||
msgid "``elapsed_time`` is the total amount of time the text effect has been running."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1146
|
||
msgid "``visible`` will tell you whether the glyph is visible or not and will also allow you to hide a given portion of text."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1148
|
||
msgid "``offset`` is an offset position relative to where the given glyph should render under normal circumstances."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1150
|
||
msgid "``color`` is the color of a given glyph."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1151
|
||
msgid "``glyph_index`` and ``font`` is glyph being drawn and font data resource used to draw it."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1152
|
||
msgid "Finally, ``env`` is a :ref:`class_Dictionary` of parameters assigned to a given custom effect. You can use :ref:`get() <class_Dictionary_method_get>` with an optional default value to retrieve each parameter, if specified by the user. For example ``[custom_fx spread=0.5 color=#FFFF00]test[/custom_fx]`` would have a float ``spread`` and Color ``color`` parameters in its ``env`` Dictionary. See below for more usage examples."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1158
|
||
msgid "The last thing to note about this function is that it is necessary to return a boolean ``true`` value to verify that the effect processed correctly. This way, if there's a problem with rendering a given glyph, it will back out of rendering custom effects entirely until the user fixes whatever error cropped up in their custom effect logic."
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1163
|
||
msgid "Here are some examples of custom effects:"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1166
|
||
msgid "Ghost"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1189
|
||
msgid "Matrix"
|
||
msgstr ""
|
||
|
||
#: ../../docs/tutorials/ui/bbcode_in_richtextlabel.rst:1227
|
||
msgid "This will add a few new BBCode commands, which can be used like so:"
|
||
msgstr ""
|