cairo_dwrite_font_face_create_for_dwrite_fontface ()

cairo_font_face_t *
cairo_dwrite_font_face_create_for_dwrite_fontface
                               (IDWriteFontFace *dwrite_font_face);

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

Here is an example of how this function might be used:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

#include <cairo-dwrite.h>
#include <dwrite.h>

IDWriteFactory* dWriteFactory = NULL;
HRESULT hr = DWriteCreateFactory(
    DWRITE_FACTORY_TYPE_SHARED,
    __uuidof(IDWriteFactory),
   reinterpret_cast<IUnknown**>(&dWriteFactory));

IDWriteFontCollection *systemCollection;
hr = dWriteFactory->GetSystemFontCollection(&systemCollection);

UINT32 idx;
BOOL found;
systemCollection->FindFamilyName(L"Segoe UI Emoji", &idx, &found);

IDWriteFontFamily *family;
systemCollection->GetFontFamily(idx, &family);

IDWriteFont *dwritefont;
DWRITE_FONT_WEIGHT weight = DWRITE_FONT_WEIGHT_NORMAL;
DWRITE_FONT_STYLE style = DWRITE_FONT_STYLE_NORMAL;
hr = family->GetFirstMatchingFont(weight, DWRITE_FONT_STRETCH_NORMAL, style, &dwritefont);

IDWriteFontFace *dwriteface;
hr = dwritefont->CreateFontFace(&dwriteface);

cairo_font_face_t *face;
face = cairo_dwrite_font_face_create_for_dwrite_fontface(dwriteface);
cairo_set_font_face(cr, face);
cairo_set_font_size(cr, 70);
cairo_move_to(cr, 100, 100);
cairo_show_text(cr, "😃");

Note: When printing a DWrite font to a CAIRO_SURFACE_TYPE_WIN32_PRINTING surface, the printing surface will substitute each DWrite font with a Win32 font created from the same underlying font file. If the matching font file can not be found, the CAIRO_SURFACE_TYPE_WIN32_PRINTING surface will convert each glyph to a filled path. If a DWrite font was not created from a system font, it is recommended that the font used to create the DWrite font be made available to GDI to avoid the undesirable fallback to emitting paths. This can be achieved using the GDI font loading functions such as AddFontMemResourceEx().

Since: 1.18

cairo_dwrite_font_face_get_rendering_params ()

IDWriteRenderingParams *
cairo_dwrite_font_face_get_rendering_params
                               (cairo_font_face_t *font_face);

Gets the IDWriteRenderingParams object of font_face .

Since: 1.18

cairo_dwrite_font_face_set_rendering_params ()

void
cairo_dwrite_font_face_set_rendering_params
                               (cairo_font_face_t *font_face,
                                IDWriteRenderingParams *params);

Sets the IDWriteRenderingParams object to font_face . This IDWriteRenderingParams is used to render glyphs if default values of font options are used. If non-defalut values of font options are specified when creating a cairo_scaled_font_t, cairo creates a new IDWriteRenderingParams object for the cairo_scaled_font_t object by overwriting the corresponding parameters.

Since: 1.18

cairo_dwrite_font_face_get_measuring_mode ()

DWRITE_MEASURING_MODE
cairo_dwrite_font_face_get_measuring_mode
                               (cairo_font_face_t *font_face);

Gets the DWRITE_MEASURING_MODE enum of font_face .

Since: 1.18

cairo_dwrite_font_face_set_measuring_mode ()

void
cairo_dwrite_font_face_set_measuring_mode
                               (cairo_font_face_t *font_face,
                                DWRITE_MEASURING_MODE mode);

Sets the DWRITE_MEASURING_MODE enum to font_face .

Since: 1.18

CAIRO_HAS_DWRITE_FONT

#define CAIRO_HAS_DWRITE_FONT

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

Since: 1.18