From 530ffd0b7d3c39757b20f00716e486b5caf89aff Mon Sep 17 00:00:00 2001 From: sanine Date: Wed, 12 Oct 2022 12:03:23 -0500 Subject: add cairo --- .../doc/public/html/cairo-Win32-Fonts.html | 436 +++++++++++++++++++++ 1 file changed, 436 insertions(+) create mode 100644 libs/cairo-1.16.0/doc/public/html/cairo-Win32-Fonts.html (limited to 'libs/cairo-1.16.0/doc/public/html/cairo-Win32-Fonts.html') diff --git a/libs/cairo-1.16.0/doc/public/html/cairo-Win32-Fonts.html b/libs/cairo-1.16.0/doc/public/html/cairo-Win32-Fonts.html new file mode 100644 index 0000000..af91c12 --- /dev/null +++ b/libs/cairo-1.16.0/doc/public/html/cairo-Win32-Fonts.html @@ -0,0 +1,436 @@ + + + + +Win32 Fonts: Cairo: A Vector Graphics Library + + + + + + + + + + + + + + + + +
+
+
+ + +
+

Win32 Fonts

+

Win32 Fonts — Font support for Microsoft Windows

+
+
+

Functions

+
++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+cairo_font_face_t * + +cairo_win32_font_face_create_for_logfontw () +
+cairo_font_face_t * + +cairo_win32_font_face_create_for_hfont () +
+cairo_font_face_t * + +cairo_win32_font_face_create_for_logfontw_hfont () +
+cairo_status_t + +cairo_win32_scaled_font_select_font () +
+void + +cairo_win32_scaled_font_done_font () +
+double + +cairo_win32_scaled_font_get_metrics_factor () +
+void + +cairo_win32_scaled_font_get_logical_to_device () +
+void + +cairo_win32_scaled_font_get_device_to_logical () +
+
+
+

Types and Values

+
++++ + + + + +
#defineCAIRO_HAS_WIN32_FONT
+
+
+

Description

+

The Microsoft Windows font backend is primarily used to render text on +Microsoft Windows systems.

+
+
+

Functions

+
+

cairo_win32_font_face_create_for_logfontw ()

+
cairo_font_face_t *
+cairo_win32_font_face_create_for_logfontw
+                               (LOGFONTW *logfont);
+

Creates a new font for the Win32 font backend based on a +LOGFONT. This font can then be used with +cairo_set_font_face() or cairo_scaled_font_create(). +The cairo_scaled_font_t +returned from cairo_scaled_font_create() is also for the Win32 backend +and can be used with functions such as cairo_win32_scaled_font_select_font().

+
+

Parameters

+
+++++ + + + + + +

logfont

A LOGFONTW structure specifying the font to use. +The lfHeight, lfWidth, lfOrientation and lfEscapement +fields of this structure are ignored.

 
+
+
+

Returns

+

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

+
+

Since: 1.0

+
+
+
+

cairo_win32_font_face_create_for_hfont ()

+
cairo_font_face_t *
+cairo_win32_font_face_create_for_hfont
+                               (HFONT font);
+

Creates a new font for the Win32 font backend based on a +HFONT. This font can then be used with +cairo_set_font_face() or cairo_scaled_font_create(). +The cairo_scaled_font_t +returned from cairo_scaled_font_create() is also for the Win32 backend +and can be used with functions such as cairo_win32_scaled_font_select_font().

+
+

Parameters

+
+++++ + + + + + +

font

An HFONT structure specifying the font to use.

 
+
+
+

Returns

+

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

+
+

Since: 1.2

+
+
+
+

cairo_win32_font_face_create_for_logfontw_hfont ()

+
cairo_font_face_t *
+cairo_win32_font_face_create_for_logfontw_hfont
+                               (LOGFONTW *logfont,
+                                HFONT font);
+

Creates a new font for the Win32 font backend based on a +LOGFONT. This font can then be used with +cairo_set_font_face() or cairo_scaled_font_create(). +The cairo_scaled_font_t +returned from cairo_scaled_font_create() is also for the Win32 backend +and can be used with functions such as cairo_win32_scaled_font_select_font().

+
+

Parameters

+
+++++ + + + + + + + + + + + + +

logfont

A LOGFONTW structure specifying the font to use. +If font +is NULL then the lfHeight, lfWidth, lfOrientation and lfEscapement +fields of this structure are ignored. Otherwise lfWidth, lfOrientation and +lfEscapement must be zero.

 

font

An HFONT that can be used when the font matrix is a scale by +-lfHeight and the CTM is identity.

 
+
+
+

Returns

+

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

+
+

Since: 1.6

+
+
+
+

cairo_win32_scaled_font_select_font ()

+
cairo_status_t
+cairo_win32_scaled_font_select_font (cairo_scaled_font_t *scaled_font,
+                                     HDC hdc);
+

Selects the font into the given device context and changes the +map mode and world transformation of the device context to match +that of the font. This function is intended for use when using +layout APIs such as Uniscribe to do text layout with the +cairo font. After finishing using the device context, you must call +cairo_win32_scaled_font_done_font() to release any resources allocated +by this function.

+

See cairo_win32_scaled_font_get_metrics_factor() for converting logical +coordinates from the device context to font space.

+

Normally, calls to SaveDC() and RestoreDC() would be made around +the use of this function to preserve the original graphics state.

+
+

Parameters

+
+++++ + + + + + + + + + + + + +

scaled_font

A cairo_scaled_font_t from the Win32 font backend. Such an +object can be created with cairo_win32_font_face_create_for_logfontw().

 

hdc

a device context

 
+
+
+

Returns

+

CAIRO_STATUS_SUCCESS if the operation succeeded. +otherwise an error such as CAIRO_STATUS_NO_MEMORY and +the device context is unchanged.

+
+

Since: 1.0

+
+
+
+

cairo_win32_scaled_font_done_font ()

+
void
+cairo_win32_scaled_font_done_font (cairo_scaled_font_t *scaled_font);
+

Releases any resources allocated by cairo_win32_scaled_font_select_font()

+
+

Parameters

+
+++++ + + + + + +

scaled_font

A scaled font from the Win32 font backend.

 
+
+

Since: 1.0

+
+
+
+

cairo_win32_scaled_font_get_metrics_factor ()

+
double
+cairo_win32_scaled_font_get_metrics_factor
+                               (cairo_scaled_font_t *scaled_font);
+

Gets a scale factor between logical coordinates in the coordinate +space used by cairo_win32_scaled_font_select_font() (that is, the +coordinate system used by the Windows functions to return metrics) and +font space coordinates.

+
+

Parameters

+
+++++ + + + + + +

scaled_font

a scaled font from the Win32 font backend

 
+
+
+

Returns

+

factor to multiply logical units by to get font space +coordinates.

+
+

Since: 1.0

+
+
+
+

cairo_win32_scaled_font_get_logical_to_device ()

+
void
+cairo_win32_scaled_font_get_logical_to_device
+                               (cairo_scaled_font_t *scaled_font,
+                                cairo_matrix_t *logical_to_device);
+

Gets the transformation mapping the logical space used by scaled_font + +to device space.

+
+

Parameters

+
+++++ + + + + + + + + + + + + +

scaled_font

a scaled font from the Win32 font backend

 

logical_to_device

matrix to return

 
+
+

Since: 1.4

+
+
+
+

cairo_win32_scaled_font_get_device_to_logical ()

+
void
+cairo_win32_scaled_font_get_device_to_logical
+                               (cairo_scaled_font_t *scaled_font,
+                                cairo_matrix_t *device_to_logical);
+

Gets the transformation mapping device space to the logical space +used by scaled_font +.

+
+

Parameters

+
+++++ + + + + + + + + + + + + +

scaled_font

a scaled font from the Win32 font backend

 

device_to_logical

matrix to return

 
+
+

Since: 1.4

+
+
+
+

Types and Values

+
+

CAIRO_HAS_WIN32_FONT

+
#define CAIRO_HAS_WIN32_FONT 1
+
+

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

+

Since: 1.8

+
+
+
+

See Also

+

cairo_font_face_t

+
+
+
+
Generated by GTK-Doc V1.27
+ + \ No newline at end of file -- cgit v1.2.1