Edit

DrvQueryTrueTypeOutline function (winddi.h)

  • Article

The DrvQueryTrueTypeOutline function retrieves glyph outlines in native TrueType format.

Syntax

LONG DrvQueryTrueTypeOutline(
  DHPDEV          dhpdev,
  FONTOBJ         *pfo,
  HGLYPH          hglyph,
  BOOL            bMetricsOnly,
  GLYPHDATA       *pgldt,
  ULONG           cjBuf,
  TTPOLYGONHEADER *ppoly
);

Parameters

dhpdev

Handle to a physical device's PDEV structure returned from a call to DrvEnablePDEV.

pfo

Pointer to a FONTOBJ structure. Details of the font realization can be queried from this structure.

hglyph

Handle to the glyph for which the outline is being queried.

bMetricsOnly

Specifies that font metrics (only) should be returned, or that TrueType outlines should be returned in cubic Bezier format, or that the TrueType outlines should be returned unhinted. This value can be one of the following:

Flag Meaning
TTO_METRICS_ONLY Only font metrics are to be returned. Font data (either outlines or bitmaps) will not be returned.
TTO_QUBICS Outlines are to be returned in cubic Bezier format.
TTO_UNHINTED Outlines are to be returned unhinted.

pgldt

Pointer to the buffer where the GLYPHDATA structure for this glyph should be written. If pgldt is NULL, no data is written to the GLYPHDATA structure.

cjBuf

Specifies the size, in bytes, of the buffer that receives the TrueType outline.

ppoly

Pointer to the buffer where the TrueType outline should be written. The format of the data is in native TrueType format, stored in a TTPOLYGONHEADER structure. See the Microsoft Windows SDK documentation for more information about the TTPOLYGONHEADER structure.

Return value

The return value is the size, in bytes, required for the ppoly buffer if pgldt is NULL. If pgldt is not NULL, the return value is the number of bytes copied into the ppoly buffer. If an error occurs, the return value is FD_ERROR.

Remarks

DrvQueryTrueTypeOutline is required for TrueType font drivers.

Requirements

Requirement Value
Target Platform Desktop
Header winddi.h (include Winddi.h)

See also

DrvEnablePDEV

FONTOBJ