Fonts
RCSS implements a simpler version of the CSS2 font model when dealing with text rendering. This is for two reasons:
- The document renderer is fully under the control of the author, so (for example) a specific font can be assumed to exist.
- Improved performance.
Fonts are specified in a similar fashion. NOTE: You will need to load all ttf files via the C++ interfaces before they can be used in RCSS.
Font specification properties
Font family: the ‘font-family’ property
font-family
Value: | <string> |
Initial: | undefined |
Applies to: | all elements |
Inherited: | yes |
Percentages: | N/A |
This property specifies the name of a family of fonts to be used to render sections of text descending from the element. Note that, unlike CSS, only a single font family can be specified with this property, not a comma-delimited font set.
Font styling: the ‘font-style’ and ‘font-weight’ properties
font-style
Value: | normal | italic |
Initial: | normal |
Applies to: | all elements |
Inherited: | yes |
Percentages: | N/A |
This property can be used to request normal or italicised versions of a font from within a font-family. Note that RCSS does not yet support oblique font styles.
font-weight
Value: | normal | bold | <number [1,1000]> |
Initial: | normal |
Applies to: | all elements |
Inherited: | yes |
Percentages: | N/A |
This property can be used to request normal or bolded versions of a font from within a font-family. A numeric value can be specified for more granularity on supported fonts. The range is based on the commonly used OpenType specification: 100 (Thin), 200 (Extra Light), 300 (Light), 400 (Normal), 500 (Medium), 600 (Semi Bold), 700 (Bold), 800 (Extra Bold), 900 (Black).
Font size: the ‘font-size’ property
font-size
Value: | <length> | <percentage> |
Initial: | 12px |
Applies to: | all elements |
Inherited: | yes |
Percentages: | Font size of parent element |
Values have the following meanings:
<length>
- The font size is generated at the point size requested. For font-relative units (such as
em
), the font size is relative to the parent element’s font size. <percentage>
- The font size is generated at the point size of the element’s parent’s font, scaled by the percentage.
Font shorthand
font
Value: | font-style font-weight font-size font-family |
Initial: | See individual properties |
Applies to: | all elements |
Inherited: | yes |
Percentages: | N/A |
A shorthand property for setting all the font properties at once.