Module org.freedesktop.cairo

Package org.freedesktop.cairo

Class FTFontFace

java.lang.Object

io.github.jwharm.cairobindings.Proxy

org.freedesktop.cairo.FontFace

org.freedesktop.cairo.FTFontFace

public final class FTFontFace
extends FontFace

Provides a FontFace for FreeType.

The FreeType font backend is primarily used to render text on GNU/Linux systems, but can be used on other platforms too.

Since:

1.0

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
static FTFontFace	create(Face ftFace, int loadFlags)	Creates a new font face for the FreeType font backend from a pre-opened FreeType face.
Set<FTSynthesize>	getSynthesize()	See FTSynthesize.
void	setSynthesize(Set<FTSynthesize> synthFlags)	FreeType provides the ability to synthesize different glyphs from a base font, which is useful if you lack those glyphs from a true bold or oblique font.
void	unsetSynthesize(Set<FTSynthesize> synthFlags)	See FTSynthesize.

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

FTFontFace

public FTFontFace(MemorySegment address)

Constructor used internally to instantiate a java FTFontFace object for a native cairo_font_face instance

Parameters:

address - the memory address of the native cairo_font_face instance

Method Details

create

public static FTFontFace create(Face ftFace,
 int loadFlags)

Creates a new font face for the FreeType font backend from a pre-opened FreeType face. This font can then be used with Context.setFontFace(FontFace) or FTScaledFont.create(FTFontFace, Matrix, Matrix, FontOptions). The FTScaledFont returned from FTScaledFont.create() is also for the FreeType backend and can be used with functions such as FTScaledFont.lockFace(). Note that Cairo may keep a reference to the FT_Face alive in a font-cache and the exact lifetime of the reference depends highly upon the exact usage pattern and is subject to external factors. The Java bindings will call FT_Done_Face() when the last reference to the FTFontFace has been dropped (using a Cleaner).

Parameters:

ftFace - A FreeType face object, already opened.

loadFlags - flags to pass to FT_Load_Glyph when loading glyphs from the font. These flags are OR'ed together with the flags derived from the FontOptions passed to ScaledFont.create(FontFace, Matrix, Matrix, FontOptions), so only a few values such as FT_LOAD_VERTICAL_LAYOUT, and FT_LOAD_FORCE_AUTOHINT are useful. You should not pass any of the flags affecting the load target, such as FT_LOAD_TARGET_LIGHT.

Returns:

a newly created FTFontFace.

Since:

1.0

getSynthesize

public Set<FTSynthesize> getSynthesize()

See FTSynthesize.

Returns:

the current set of synthesis options.

Since:

1.12

setSynthesize

public void setSynthesize(Set<FTSynthesize> synthFlags)

FreeType provides the ability to synthesize different glyphs from a base font, which is useful if you lack those glyphs from a true bold or oblique font. See also FTSynthesize.

Parameters:

synthFlags - the set of synthesis options to enable

Since:

1.12

unsetSynthesize

public void unsetSynthesize(Set<FTSynthesize> synthFlags)

See FTSynthesize.

Parameters:

synthFlags - the set of synthesis options to disable

Since:

1.12