Skip to main content

Text Style Palette

Using theThe Text StyleStyles Palettepalette section fromallows the Solution Options ("File" > "Solution Options"), it is possibleyou to create, editedit, and delete differentvarious text style templates.

drawing-5-1697796476.png

If there are no fonts imported already,fonts, the userfonts can importbe any available fontsimported using the "[ Import Fonts"Fonts... ] button in the upper-upper right corner of the Text StyleStyles Palettepalette section. The button[ will open the "Import Fonts"Fonts panel] whichdialog window displayed by this button can also be openeddisplayed by usingselecting fonts from the "Import"menu bar [ Import > "Import Resources..." menu.].

drawing-5-1697793737.pngdrawing-4-1714612140.png

Text Stylesstyles are necessaryrequired for nodes and controls that display texts.text. E.g.For example, 2D Texttext Node has a property "Style", Controls like the Text Control and the Text Button Controlnodes have a property "TextStyle"called [ Style ] and controls such as text controls and text button controls have a property called [ TextStyle ]. These properties can be used to configureset the styletext of the displayed texts by setting a TextStyle.style.

drawing-4-1699246142.pngdrawing-4-1714612386.png

A click on the magnifying glass icon will open the Text Style Palette.

Adding a new Text Style

To add a new TextStyletext style, press the Add textText styleStyle button,button which willto open the Add New Text Style dialogdialog.

drawing-5-1697800319.pngdrawing-4-1714612625.png


Please refer to Font Palette for detailed information about the "Default font" field.


ForThe anynewly created created text style there arehas four different sections that can be seen on the right side of the Text StyleStyles Palettepalette window:window.

  • Text Style
  • Metrics
  • General
  • Asset

The

following
subsections

Underare provided below the "Texttext Style"style section another sub-sections are available:section.

  • Entries
  • Cultures

ItFonts iscan possiblebe to configure the fontsconfigured based on both unicode rangesrange and on the basis of language. In other words, the fontISO selectioncode canof be conditioned bythe language ISO codes (the standardizedstandard nomenclature used to classify languages).

Inconditions the font selection.

"Entries"Entries
section different fonts

Entries can be set thatto willdifferent befonts, which are used for any text edited in SceneComposer.Scene Composer. First, a new childchildren has tomust be added using the "+" button. Any child can be deleted orand movedthe (uporder orin down).which Forthey everyappear can be changed. Every new child there arehas three main propertiesproperties.

which
shouldLower beBound set:Upper Bound 
Font 
    bounds (lower and upper) font (used later on)

    drawing-4-1681719413.pngdrawing-4-1714612875.png

    TheBound boundsin ofEntries therepresents entry represent thean ASCII decimal valuesvalue whichcorresponding are equivalents ofto all the letterletters of the Latin alphabet (65 to 90 -are capitaluppercase letters from A to Z;Z, 97 to 122 -are lowerlowercase cases)letters). If, forIf a specific selectedfont font,is selected, and the Lower Bound selected bounds will beis 65 ( = U+0041) forand the lowerUpper andBound is 90 ( = U+005A), for the upper,then all the capitaluppercase letters from ain text which usesusing that style will be drawnrendered within that specific chosenselected font.

    Bound set in decimal is automatically converted to the corresponding ISO code when the Enter key is pressed. For example, if Lower Bound is set to 3311, pressing the Enter key will automatically display it as the ISO code "U+0CEF". If Lower Bound is set to 200000, it will automatically display it as the ISO code "U+1E8480".

    After any bound has been set in decimal values, those values will be automatically transformed into the corresponding ISO codes when the "Enter" key is pressed. For instance, if the lower bound is set as 3311, after pressing "Enter" it will be automatically displayed as the "U+0CEF" ISO Code. If the lower bound is set as 200000, it will be automatically displayed as the "U+1E8480" ISO Code.

    Cultures

    In the "Cultures" sectionCulture, different entriesitems can be addedset exactlyafter adding children in the same mannerway as mentioned above. In this wayway, all the text style entriesitems are grouped by culture.

    Culture.
    For
    more
    information,
    see 
    See also:
      Culture Setting. in SceneComposer User Manual
      drawing-4-1681719663.pngdrawing-4-1714613245.png

      In the image below different cultures and entries can be seen (Click to enlarge image).

      02_text-style_7.png

      It is possible to create a style which uses a specific font associated for any letter if desired.

      drawing-4-1699246880.pngdrawing-4-1714613423.png
      • The "Text Style" section has a great importance because of the selection of the main font used in association with a created style.
      • The "Metrics" section presents font line spacing information:
        • Ascender: defines the part of a lower-case letter that is taller than the font's x-height
        • Descender: defines the portion of a letter that extends below the baseline of a font.
        • Line Height: represents the vertical distance between lines of text 
              lineGap = lineHeight - (ascender - descender)


      drawing-4-1676339672.pngdrawing-4-1676339672.png

       

      • The "General" section provides all the necessary information about the created style: Name, Description, Icon and so forth.
      • The "Asset" section provides information about exporting, Id, Symbolic name, and Candera name and path.

      To find the cultures that are used and the fonts that were set, a verification is done until a valid configuration is found. The codepoint resolution is done according to rules verified in the following order:

      • Check if Active Culture is in the Culture list of the current TextStyle
      • Check if Active Culture is in the Culture list of the Base Style
      • Configuration of Entries in current Text Style
      • Configuration of Entries in Base Style
      • Default Font from current Text Style
      • Default Font from Base Style

      If none of the above checks will give any result, the default code point will be used.

      Text Style Editor

      There are three ways to open the Text Style Editor:

      • Select a TextStyle in the Text Style Palette and press the Edit text style button, which will open the Text Style Editor.
      • Double-click on a TextStyle in the Solution Explorer panel.
      • Select a TextStyle in the Solution Explorer panel and choose Edit from the context menu.
      drawing-5-1698387903.pngdrawing-4-1714613516.png

      TextStyles from the ConstructionKit are not editable.

      The Text Style Editor is a dialog that is focused on editing Text Style properties. It provides three sections, which can also be found in the Properties panel:

      • Text Style properties
      • Entries
      • Cultures
      drawing-5-1698388237.pngdrawing-4-1714614245.png

      EveryAll TextStyletext isstyles are based on athe Default Font.Font, The default fontwhich can be changed by clicking on the magnifying-glassitem selection icon on the right side.(see Thisfigure willbelow). openAfter clicking on the icon, the Font Palette dialog,dialog opens and the Default Font can be selected from the selection box.

      drawing-4-1714614392.png

      Items in the [ Entries ] and [ Cultures ] sections can be edited using the toolbar on the right (see figure below). Pressing the [ Add Item ] icon opens the Text Style Entry Editor dialog where you can selectedit aadditional default font from a choice box.items.

      drawing-5-1698417223.png

      The items in the "Entries" and "Cultures" section can be edited using the little toolbars on the right.

      drawing-5-1698421611.pngdrawing-4-1714614572.png

      When sorting configuration items within Cultures, only items within the same cultureCultures can be sorted.
      e.g. In the belowfigure image,below, the user can swap therows 2nd1 and 3rd2 rows,(both with Culture as "en"), but usernot cannotrows swap the 1st2 and 2nd rows.3.

      drawing-4-1699421265.pngdrawing-4-1714614679.png

       

      Text Style Entry Editor 

      The Text Style Entry Editor is used to add or edit anitems. item.This Iteditor can be displayed in two ways The Text Style Entry Editor UI that is openeddisplayed when

      also
        depends pressingon the 'method selected.
          Press the +' icon on the right side of the Entries or Cultures section of the Text Style Editor ( Add Entries ). Double-click on an item that has already been set ( Edit Entries ).
          drawing-4-1714614883.png
          Add Entries

          As mentioned above, if you press the + icon to the right of the Entries section in the Text Style Editor, the Text Style Entry Editor shown below will appear. Settings can be made for multiple Entries.

          drawing-4-1714615023.png
          1 Add/Remove Bounds button

          Add and remove Bounds ranges for use in Entries. Press the + button to add anand itemthe or- button to delete.

            By pressing the + button, the Bounds range is added to the "Setting Bounds List" in the next section. double-clickingTo delete an alreadyitem, existingselect the item to editbe it.deleted in the "Setting Bounds List" in the next section and press the - button. 2 Setting Bounds List

            The Bounds list range added/edited in the previous section will be displayed.

            3 Select All / Deselect All button

            Select and deselect the checkboxes of the displayed Bounds items (red frame in the above figure) at once.

              By pressing the left button, all check boxes are checked. By pressing the right side button, the currently selected checkboxes will be unchecked all together.

              The Lower/Upper Bound value is automatically set according to the check status of the Bounds item's checkbox. For more information on the behavior of the set values, see Bounds Range Setting.

              Edit Entries

              Bounds editing for the selected Entry on the Text Style Editor. Here you will perform editing operations on the Bounds range set in  Add Entries.

              Similar to the explanation for Add Entries, the selection status of the checkboxes in the Boud list (red frame in the figure below) changes when the [Select All/Deselect All] button (orange frame in the figure below) is operated.

              drawing-4-1714615463.png
              Bounds range setting

              In the Text Style Entry Editor, the Bounds range for each Entry is set by checking the checkbox for each Bound displayed in the list.

                Click on the [ Select All ] button
                All Bounds will be checked and the Lower/Upper Bound values will be set as follows.
                Lower Bound value: U+0000
                Upper Bound value: U+FFFFFFFFFFF
                drawing-4-1714615696.png


                Click on the [ Deselect All ] button
                All Bounds will be unchecked and the Lower/Upper Bound values will be set as follows.
                Lower Bound value: U+0000
                Upper Bound value: U+0000
                drawing-4-1714615711.png


                Check any Bound item
                When any Bound item is checked, the Lower/Upper Bound values are set as follows.
                Lower Bound value: Lower value of the upper Bound item in the list among the Bound items in the selected range.
                Upper Bound value: Upper value of the lower Bound item in the list among the Bound items in the selected range.
                drawing-4-1714615788.png

                Font

                Pressing the magnifyingitem glassselection icon will openopens the Font Palette dialog,dialog, offeringwhere theyou possibility tocan select a new font.

                drawing-5-1699009237.png

                drawing-5-1699024278.pngdrawing-4-1714615968.png

                Select Culture

                When you are editing anitems entry fromin the Cultures section (lower section) of the Text Style Editor,Editor (orange boxed area in the figure below), you can use this pull-down menu to select the appropriate Cultureculture.

                can be selected using this drop down box.
                drawing-4-1714616166.png

                When editing anthe entryText Style Entry Editor from the Entries section (top section) of the Text Style Editor,Editor (red boxed section above), the drop pull-down boxmenu willin bethe Culture section is disabled and no culture can be selected.


                Enter Lower or Upper Bound

                The Lower and Upper Bounds of the Text Style Entry can be entered into these two input fields. 

                Check/Uncheck to Edit Bounds

                The lower section of the  Text Style Entry Editor offers a list, where you can choose your upper and lower bounds by checking or unchecking the checkboxes.

                • To change the lower bound, uncheck the checkboxes starting from first. The input field of the Lower Bound will be updated accordingly.
                • To change the upper bound, uncheck checkboxes starting from the last. The input field of the Upper Bound will be updated accordingly.

                Values greater than U+010000 are plane units.

                Back to top