Post

ScreenFontStyle

Posted Updated
By CREATE3000 4 min read

Overview

ScreenFontStyle is an X3DFontStyleNode defines the size, family, justification, and other styles used within a screen layout. ScreenFontStyle renders text so that it appears identical to typical 2D applications by specifying pointSize in points (as in 2D document layout) rather than size in meters. Each glyph of text is rendered as a quadrilateral with a texture applied.

The ScreenFontStyle node belongs to the Layout component and requires at least level 2, its default container field is fontStyle. It is available from X3D version 3.2 or higher.

Hierarchy

1
2
3

+ X3DNode
  + X3DFontStyleNode
    + ScreenFontStyle

Fields

SFNode [in, out] metadata NULL [X3DMetadataObject]

Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.

Hint

SFString [in, out] language “”

Language codes consist of a primary code and a (possibly empty) series of subcodes. [ language-code = primary-code ( “-“ subcode )* ] Two-letter primary codes are reserved for language abbreviations. Two-letter primary codes include en (English), fr (French), de (German), it (Italian), nl (Dutch), el (Greek), es (Spanish), pt (Portuguese), ar (Arabic), he (Hebrew), ru (Russian), zh (Chinese), ja (Japanese), hi (Hindi), ur (Urdu), and sa (Sanskrit). Any two-letter subcode is understood to be a country code.

Hints

Warning

  • Do not wrap extra quotation marks around these SFString enumeration values, since “quotation” “marks” are only used for MFString values.

MFString [in, out] family “SERIF” String or [URI]

Array of quoted font family names in preference order, browsers use the first supported family.

Hints

  • Example family array might be “Times” “SERIF”
  • Values with guaranteed support include “SERIF” “SANS” “TYPEWRITER”.
  • SERIF and SANS are variable-width fonts (for example, Times Roman and Arial).
  • TYPEWRITER is a fixed-width font (for example, Courier).
  • MFString arrays can have multiple values, so “separate each individual string” “by using quote marks”.
  • See 15.2.2.2 Font family and style for details.
  • Relates to Internationalization (i18n)
  • (X3D version 4.0 ISO.proof draft) accessType relaxed to inputOutput in order to support animation and user accessibility.

Warning

  • Font family support often varies.

SFString [in, out] style “PLAIN” [“PLAIN”|”BOLD”|”ITALIC”|”BOLDITALIC”|””]

Pick one of four values for text style (PLAIN or BOLD or ITALIC or BOLDITALIC).

Hints

Warnings

  • Overloaded name for CSS style attribute.
  • Do not wrap extra quotation marks around these SFString enumeration values, since “quotation” “marks” are only used for MFString values.

SFFloat [in, out] pointSize 12 (0,∞)

pointSize field specifies the size of text in points. Nominal height (in local coordinate system) of text glyphs, also sets default spacing between adjacent lines of text.

Hints

  • pointSize replaces the size field of the FontStyle node.
  • (X3D version 4.0 ISO.proof draft) accessType relaxed to inputOutput in order to support animation and user accessibility.

SFFloat [in, out] spacing 1 [0,∞)

Adjustment factor for line spacing between adjacent lines of text.

Hint

  • (X3D version 4.0 ISO.proof draft) accessType relaxed to inputOutput in order to support animation and user accessibility.

SFBool [in, out] horizontal TRUE

Whether text direction is horizontal (true) or vertical (false).

Hints

SFBool [in, out] leftToRight TRUE

Whether text direction is left-to-right (true) or right-to-left (false).

Hints

SFBool [in, out] topToBottom TRUE

Whether text direction is top-to-bottom (true) or bottom-to-top (false).

Hints

MFString [in, out] justify “BEGIN” [“BEGIN”, “END”, “FIRST”, “MIDDLE”, “”]

The justify field determines horizontal and vertical alignment of text layout, relative to the origin of the object coordinate system.

Hints

  • Preferred value is usually justify=’ “MIDDLE” “MIDDLE” ‘ for centered justification horizontally and vertically.
  • MFString arrays can have multiple values, so “separate each individual string” “by using quote marks”.
  • See 15.2.2.3 Direction and justification for details.
  • (X3D version 4.0 ISO.proof draft) accessType relaxed to inputOutput in order to support animation and user accessibility.

Warnings

  • Exactly two string values are provided for major and minor axis alignment.
  • Do not use illegal values such as LEFT RIGHT TOP BOTTOM or CENTER.

Supported File Formats

It is possible to specify in the family field a URL of a custom font file of the following types:

EncodingFile ExtensionMIME Type
Open Type.otfapplication/x-font-opentype
True Type.ttfapplication/x-font-truetype
WOFF.woffapplication/x-font-woff

Advice

Hints

See Also

Layout

components, Layout
ScreenFontStyle Layout
This post is licensed under CC BY 4.0 by the author.