UI Toolkit stores project-wide text settings in the Panel Text Settings asset. UI Toolkit uses a default Panel Text Settings asset for your text objects.
For runtime UI, you can create and assign a Panel Text Settings asset to the Panel Setting asset, and edit the text setting properties:
Note: In the current release, you can’t change the default Panel Text Settings for Editor UI.
This section describes all the properties for the Panel Text Settings asset. The Panel Text Settings asset controls the default values for all text objects used within that Panel.
You can edit the paths to store the font assets, sprite assets, custom style sheets, and the color gradient presets. The paths must be a sub-folder of a Resources folder. Create a Resources folder if you don’t have one in your project.
After you create a font asset from a font file, you must place it in the path set to store all the font assets.
| プロパティ | 説明 |
|---|---|
| Default Font Asset | Default font to use when you create a new text object. |
| パス | Path to store all the font assets. |
Manage the global fallback font assets list for this font asset.
Note: The local fallback set in the Font Asset Properties has precedence over the global fallback .
| プロパティ | 説明 | ||
|---|---|---|---|
| Fallback Font Assets List | Click + and - to add and remove font slots. Click the circle icon next to a font to open an Object Picker where you can choose a font asset. Drag the handles on the left side of any font asset to reorder the list. |
||
| <!– | Match Material Presets | Enable this to make glyphs from the fallback font match the style of the main font. When UI Toolkit uses a glyph from a fallback font, it creates a material with the same settings as the main font’s material. This looks best when the main font and the fallback font are similar. |
–> |
Project-wide settings to handle missing glyphs.
| プロパティ | 説明 |
|---|---|
| Missing Character Unicode | Unicode of the character to use when a missing glyph isn’t in any of the fallback fonts. The default value of 0 produces the outline of a square. |
| Clear Dynamic Data on Build | Clear all dynamic data and restore the font asset back to its default creation and empty state. |
| Disable Warnings | Enable this if you don’t want to log a warning for every missing glyph. |
After you create a sprit asset, you must place it in the path set to store all the sprite assets. You can set a default sprite asset and reference the sprites in the default sprite asset by index or sprite name.
| プロパティ | 説明 |
|---|---|
| Default Sprite Asset | Sprite asset to use by default. |
| Missing Sprite Unicode | Unicode of the sprite for a missing sprite. |
| パス | Path to store all the sprite assets. |
The fallback list set in the Panel Text Setting is called the global fallback. The local fallback set in the Sprite Asset has precedence over the global fallback list.
| プロパティ | 説明 |
|---|---|
| Sprite Asset Fallback List | Add or remove a sprite asset in the fallback list. You can also drag the handles on the left side of any sprit asset to reorder the list. |
After you create a custom style sheet, you must place it in the path set to store all the custom style sheet assets.
| プロパティ | 説明 |
|---|---|
| Default Style Sheet | Default style sheet to use by all text objects in the project. |
| パス | Path to store all the custom style sheet assets. |
Set the path to store all color gradients presets.
| プロパティ | 説明 |
|---|---|
| パス | Path to store the Color Gradient presets. |
To get correct line-breaking behavior for Asian languages, specify which characters behave as leading and following characters.
| プロパティ | 説明 |
|---|---|
| Leading Characters | Specify the text file that contains the list of leading characters. |
| Following Characters | Specify the text file that contains the list of following characters. |
| Korean Line Breaking Rules | Enable this to use modern rules. |