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.