/ HALion Developer Resource / HALion Macro Page / Resources /

Font

Description

Font resources are used to define different text styles which are referenced by labels, text fields, and other controls that display text.

Each resource specifies which of the system fonts (available for both Mac and PC) are used, which font size, color, alpha channel value, and style (bold, italic, underlined). If you want to use a custom truetype font, you can specify this truetype font file in the custom font field. Even when you are working with custom fonts, it is still good practice to specify a system font to function as fallback solution for characters that might not exist in a specific truetype font.

❕ When distributing libraries that include TrueType fonts, only include those fonts that can be freely distributed. Do not include fonts that need to be licensed.

❕ TrueType fonts must be based on Unicode tables to work correctly.

Properties

PopertyDescription
NameThe name of the Font resource.
FontAllows you to select the system font to be used. These fonts are available on Windows and Mac or have their equivalents on Mac. If a custom TrueType font is to be be used instead, you can define it under Custom. In this case, the specified system family is only used as a fallback solution for characters that do not exist in the custom font file. For text edit controls that pop up a text edit field, the system font is also used to display the text during editing.
SizeDefines the font size in points.
StyleDefines the font style for the system font: bold, italic, underline.
ColorColors can be defined in different ways:
  • by setting a hex # value, e.g., 202020 (red, green, blue);
  • by setting RGB values (Red, Green, Blue);
  • by clicking on the color preview field and using the color picker.

Alpha: Sets the transparency (256 fully opaque, 0 fully transparent). When adjusting the alpha value, the preview field blends against a light grey background. The resulting color in the macro page will look different, depending on the local background color.

Color Picker:
  • The upper hue bar allows you to select the hue value.
  • The color field allows you to set saturation and value.
  • Right-click the color picker for further options: Copy Color, Paste Color, and Reset Color.
CustomAllows you to add a custom font. Drag and drop a TrueType file on the custom field or click the open icon to choose the location and file.