Quartz (CGFont) Fonts

Quartz (CGFont) Fonts — Font support via CGFont on OS X

Synopsis

#define             CAIRO_HAS_QUARTZ_FONT
cairo_font_face_t * cairo_quartz_font_face_create_for_cgfont
                                                        (CGFontRef font);
cairo_font_face_t * cairo_quartz_font_face_create_for_atsu_font_id
                                                        (ATSUFontID font_id);

Description

The Quartz font backend is primarily used to render text on Apple MacOS X systems. The CGFont API is used for the internal implementation of the font backend methods.

Details

CAIRO_HAS_QUARTZ_FONT

#define             CAIRO_HAS_QUARTZ_FONT

Defined if the Quartz font backend is available. This macro can be used to conditionally compile backend-specific code.


cairo_quartz_font_face_create_for_cgfont ()

cairo_font_face_t * cairo_quartz_font_face_create_for_cgfont
                                                        (CGFontRef font);

Creates a new font for the Quartz font backend based on a CGFontRef. This font can then be used with cairo_set_font_face() or cairo_scaled_font_create().

font :

a CGFontRef obtained through a method external to cairo.

Returns :

a newly created cairo_font_face_t. Free with cairo_font_face_destroy() when you are done using it.

Since 1.6


cairo_quartz_font_face_create_for_atsu_font_id ()

cairo_font_face_t * cairo_quartz_font_face_create_for_atsu_font_id
                                                        (ATSUFontID font_id);

Creates a new font for the Quartz font backend based on an ATSUFontID. This font can then be used with cairo_set_font_face() or cairo_scaled_font_create().

font_id :

an ATSUFontID for the font.

Returns :

a newly created cairo_font_face_t. Free with cairo_font_face_destroy() when you are done using it.

Since 1.6

See Also