FontSynthesis

enum class FontSynthesis
kotlin.Any
   ↳ kotlin.Enum<androidx.ui.text.font.FontSynthesis>
   ↳ androidx.ui.text.font.FontSynthesis

Possible options for font synthesis.

FontSynthesis is used to specify whether the system should fake bold or slanted glyphs when the FontFamily used does not contain bold or oblique Fonts.

If the font family does not include a requested FontWeight or FontStyle, the system fakes bold or slanted glyphs when the Weight or Style, respectively, or both when All is set. If this is not desired, use None to disable font synthesis.

It is possible to fake an increase of FontWeight but not a decrease. It is possible to fake a regular font slanted, but not vice versa.

FontSynthesis works the same way as the CSS font-synthesis(https://www.w3

  • .org/TR/css-fonts-4/#font-synthesis) property.
import androidx.ui.core.Text
import androidx.ui.text.TextStyle
import androidx.ui.text.font.Font
import androidx.ui.text.font.FontFamily

// The font family contains a single font, with normal weight
val fontFamily = FontFamily(
    Font(name = "myfont.ttf", weight = FontWeight.Normal)
)
// Configuring the Text composable to be bold
// Using FontSynthesis.Weight to have the system render the font bold my making the glyphs
// thicker
Text(
    text = "Demo Text",
    style = TextStyle(
        fontFamily = fontFamily,
        fontWeight = FontWeight.Bold,
        fontSynthesis = FontSynthesis.Weight
    )
)

Summary

Enum values

The system synthesizes both bold and slanted fonts if either of them are not available in the FontFamily

Turns off font synthesis.

Only an slanted font is synthesized, if it is not available in the FontFamily.

Only a bold font is synthesized, if it is not available in the FontFamily.

Enum values

All

enum val All : FontSynthesis

The system synthesizes both bold and slanted fonts if either of them are not available in the FontFamily

None

enum val None : FontSynthesis

Turns off font synthesis. Neither bold nor slanted faces are synthesized if they don't exist in the FontFamily

Style

enum val Style : FontSynthesis

Only an slanted font is synthesized, if it is not available in the FontFamily. Bold fonts will not be synthesized.

Weight

enum val Weight : FontSynthesis

Only a bold font is synthesized, if it is not available in the FontFamily. Slanted fonts will not be synthesized.