Module org.freedesktop.cairo

Package org.freedesktop.cairo

Class ToyFontFace

java.lang.Object

io.github.jwharm.cairobindings.Proxy

org.freedesktop.cairo.FontFace

org.freedesktop.cairo.ToyFontFace

public final class ToyFontFace
extends FontFace

ToyFontFace is used in cairo's toy text API. The toy API takes UTF-8 encoded text and is limited in its functionality to rendering simple left-to-right text with no advanced features. That means for example that most complex scripts like Hebrew, Arabic, and Indic scripts are out of question. No kerning or correct positioning of diacritical marks either. The font selection is pretty limited too and doesn't handle the case that the selected font does not cover the characters in the text. This set of functions are really that, a toy text API, for testing and demonstration purposes. Any serious application should avoid ToyFontFace.

Since:

1.8

See Also:

• Context
• FontFace

Constructor Summary

Constructors

Constructor	Description
ToyFontFace(MemorySegment address)	Constructor used internally to instantiate a java ToyFontFace object for a native cairo_font_face_t instance

Method Summary

Modifier and Type	Method	Description
static ToyFontFace	create()	Convenience constructor that invokes create(String, FontSlant, FontWeight) with a null family to specify the platform-specific default font family, FontSlant.NORMAL and FontWeight.NORMAL.
static ToyFontFace	create(String family, FontSlant slant, FontWeight weight)	Creates a toy font face from a triplet of family, slant, and weight.
String	getFamily()	Gets the family name of a toy font.
FontSlant	getSlant()	Gets the slant of a toy font.
FontWeight	getWeight()	Gets the weight a toy font.

Methods inherited from class org.freedesktop.cairo.FontFace

destroy, getFontType, getType, getUserData, setUserData, status

Methods inherited from class io.github.jwharm.cairobindings.Proxy

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ToyFontFace

public ToyFontFace(MemorySegment address)

Constructor used internally to instantiate a java ToyFontFace object for a native cairo_font_face_t instance

Parameters:

address - the memory address of the native cairo_font_face_t instance

Method Details

create

public static ToyFontFace create()

Convenience constructor that invokes create(String, FontSlant, FontWeight) with a null family to specify the platform-specific default font family, FontSlant.NORMAL and FontWeight.NORMAL.

Returns:

a newly created ToyFontFace

create

public static ToyFontFace create(String family,
 FontSlant slant,
 FontWeight weight)

Creates a toy font face from a triplet of family, slant, and weight. These font faces are used in implementation of the Cairo "toy" font API.

If family is empty, the platform-specific default family is assumed. The default family then can be queried using getFamily().

The Context.selectFontFace(String, FontSlant, FontWeight) function uses this to create font faces. See that function for limitations and other details of toy font faces.

Parameters:

family - a font family name

slant - the slant for the font

weight - the weight for the font

Returns:

a newly created ToyFontFace

Since:

1.8

getFamily

public String getFamily()

Gets the family name of a toy font.

Returns:

the family name

Since:

1.8

getSlant

public FontSlant getSlant()

Gets the slant of a toy font.

Returns:

the slant value

Since:

1.8

getWeight

public FontWeight getWeight()

Gets the weight a toy font.

Returns:

the weight value

Since:

1.8