d3d8: Get rid of the format switching code in d3d8_device_CopyRects().
[wine.git] / include / dwrite.idl
blobbc530fc98a648794a0c5611d98b547f5c310defc
1 /*
2 * Copyright 2012 Nikolay Sivov for CodeWeavers
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
19 import "unknwn.idl";
20 import "dcommon.h";
22 interface IDWriteFactory;
23 interface IDWriteFontCollection;
24 interface IDWriteFontFamily;
25 interface IDWriteFontFace;
26 interface IDWriteInlineObject;
28 interface ID2D1SimplifiedGeometrySink;
29 typedef ID2D1SimplifiedGeometrySink IDWriteGeometrySink;
31 cpp_quote("#ifndef _WINDEF_")
32 /* already defined in windef.h but needed for WIDL */
33 typedef void *HMONITOR;
34 cpp_quote("#endif /* _WINDEF_ */")
36 cpp_quote("#ifdef WINE_NO_UNICODE_MACROS")
37 cpp_quote("#undef GetGlyphIndices")
38 cpp_quote("#endif")
40 typedef enum DWRITE_FACTORY_TYPE
42 DWRITE_FACTORY_TYPE_SHARED,
43 DWRITE_FACTORY_TYPE_ISOLATED
44 } DWRITE_FACTORY_TYPE;
46 typedef enum DWRITE_FONT_FILE_TYPE
48 DWRITE_FONT_FILE_TYPE_UNKNOWN,
49 DWRITE_FONT_FILE_TYPE_CFF,
50 DWRITE_FONT_FILE_TYPE_TRUETYPE,
51 DWRITE_FONT_FILE_TYPE_TRUETYPE_COLLECTION,
52 DWRITE_FONT_FILE_TYPE_TYPE1_PFM,
53 DWRITE_FONT_FILE_TYPE_TYPE1_PFB,
54 DWRITE_FONT_FILE_TYPE_VECTOR,
55 DWRITE_FONT_FILE_TYPE_BITMAP
56 } DWRITE_FONT_FILE_TYPE;
58 typedef enum DWRITE_FONT_FACE_TYPE
60 DWRITE_FONT_FACE_TYPE_CFF,
61 DWRITE_FONT_FACE_TYPE_TRUETYPE,
62 DWRITE_FONT_FACE_TYPE_TRUETYPE_COLLECTION,
63 DWRITE_FONT_FACE_TYPE_TYPE1,
64 DWRITE_FONT_FACE_TYPE_VECTOR,
65 DWRITE_FONT_FACE_TYPE_BITMAP,
66 DWRITE_FONT_FACE_TYPE_UNKNOWN,
67 DWRITE_FONT_FACE_TYPE_RAW_CFF
68 } DWRITE_FONT_FACE_TYPE;
70 typedef enum DWRITE_FONT_WEIGHT
72 DWRITE_FONT_WEIGHT_THIN = 100,
73 DWRITE_FONT_WEIGHT_EXTRA_LIGHT = 200,
74 DWRITE_FONT_WEIGHT_ULTRA_LIGHT = 200,
75 DWRITE_FONT_WEIGHT_LIGHT = 300,
76 DWRITE_FONT_WEIGHT_NORMAL = 400,
77 DWRITE_FONT_WEIGHT_REGULAR = 400,
78 DWRITE_FONT_WEIGHT_MEDIUM = 500,
79 DWRITE_FONT_WEIGHT_DEMI_BOLD = 600,
80 DWRITE_FONT_WEIGHT_SEMI_BOLD = 600,
81 DWRITE_FONT_WEIGHT_BOLD = 700,
82 DWRITE_FONT_WEIGHT_EXTRA_BOLD = 800,
83 DWRITE_FONT_WEIGHT_ULTRA_BOLD = 800,
84 DWRITE_FONT_WEIGHT_BLACK = 900,
85 DWRITE_FONT_WEIGHT_HEAVY = 900,
86 DWRITE_FONT_WEIGHT_EXTRA_BLACK = 950,
87 DWRITE_FONT_WEIGHT_ULTRA_BLACK = 950
88 } DWRITE_FONT_WEIGHT;
90 typedef enum DWRITE_FONT_STRETCH
92 DWRITE_FONT_STRETCH_UNDEFINED = 0,
93 DWRITE_FONT_STRETCH_ULTRA_CONDENSED = 1,
94 DWRITE_FONT_STRETCH_EXTRA_CONDENSED = 2,
95 DWRITE_FONT_STRETCH_CONDENSED = 3,
96 DWRITE_FONT_STRETCH_SEMI_CONDENSED = 4,
97 DWRITE_FONT_STRETCH_NORMAL = 5,
98 DWRITE_FONT_STRETCH_MEDIUM = 5,
99 DWRITE_FONT_STRETCH_SEMI_EXPANDED = 6,
100 DWRITE_FONT_STRETCH_EXPANDED = 7,
101 DWRITE_FONT_STRETCH_EXTRA_EXPANDED = 8,
102 DWRITE_FONT_STRETCH_ULTRA_EXPANDED = 9
103 } DWRITE_FONT_STRETCH;
105 typedef enum DWRITE_FONT_STYLE
107 DWRITE_FONT_STYLE_NORMAL,
108 DWRITE_FONT_STYLE_OBLIQUE,
109 DWRITE_FONT_STYLE_ITALIC
110 } DWRITE_FONT_STYLE;
112 typedef enum DWRITE_INFORMATIONAL_STRING_ID
114 DWRITE_INFORMATIONAL_STRING_NONE,
115 DWRITE_INFORMATIONAL_STRING_COPYRIGHT_NOTICE,
116 DWRITE_INFORMATIONAL_STRING_VERSION_STRINGS,
117 DWRITE_INFORMATIONAL_STRING_TRADEMARK,
118 DWRITE_INFORMATIONAL_STRING_MANUFACTURER,
119 DWRITE_INFORMATIONAL_STRING_DESIGNER,
120 DWRITE_INFORMATIONAL_STRING_DESIGNER_URL,
121 DWRITE_INFORMATIONAL_STRING_DESCRIPTION,
122 DWRITE_INFORMATIONAL_STRING_FONT_VENDOR_URL,
123 DWRITE_INFORMATIONAL_STRING_LICENSE_DESCRIPTION,
124 DWRITE_INFORMATIONAL_STRING_LICENSE_INFO_URL,
125 DWRITE_INFORMATIONAL_STRING_WIN32_FAMILY_NAMES,
126 DWRITE_INFORMATIONAL_STRING_WIN32_SUBFAMILY_NAMES,
127 DWRITE_INFORMATIONAL_STRING_PREFERRED_FAMILY_NAMES,
128 DWRITE_INFORMATIONAL_STRING_PREFERRED_SUBFAMILY_NAMES,
129 DWRITE_INFORMATIONAL_STRING_SAMPLE_TEXT,
130 DWRITE_INFORMATIONAL_STRING_FULL_NAME,
131 DWRITE_INFORMATIONAL_STRING_POSTSCRIPT_NAME,
132 DWRITE_INFORMATIONAL_STRING_POSTSCRIPT_CID_NAME
133 } DWRITE_INFORMATIONAL_STRING_ID;
135 typedef enum DWRITE_FONT_SIMULATIONS
137 DWRITE_FONT_SIMULATIONS_NONE,
138 DWRITE_FONT_SIMULATIONS_BOLD,
139 DWRITE_FONT_SIMULATIONS_OBLIQUE
140 } DWRITE_FONT_SIMULATIONS;
142 typedef enum DWRITE_PIXEL_GEOMETRY
144 DWRITE_PIXEL_GEOMETRY_FLAT,
145 DWRITE_PIXEL_GEOMETRY_RGB,
146 DWRITE_PIXEL_GEOMETRY_BGR
147 } DWRITE_PIXEL_GEOMETRY;
149 typedef enum DWRITE_RENDERING_MODE
151 DWRITE_RENDERING_MODE_DEFAULT,
152 DWRITE_RENDERING_MODE_ALIASED,
153 DWRITE_RENDERING_MODE_GDI_CLASSIC,
154 DWRITE_RENDERING_MODE_GDI_NATURAL,
155 DWRITE_RENDERING_MODE_NATURAL,
156 DWRITE_RENDERING_MODE_NATURAL_SYMMETRIC,
157 DWRITE_RENDERING_MODE_OUTLINE,
158 DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC = DWRITE_RENDERING_MODE_GDI_CLASSIC,
159 DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURAL = DWRITE_RENDERING_MODE_GDI_NATURAL,
160 DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL = DWRITE_RENDERING_MODE_NATURAL,
161 DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL_SYMMETRIC = DWRITE_RENDERING_MODE_NATURAL_SYMMETRIC
162 } DWRITE_RENDERING_MODE;
164 typedef enum DWRITE_TEXT_ALIGNMENT
166 DWRITE_TEXT_ALIGNMENT_LEADING,
167 DWRITE_TEXT_ALIGNMENT_TRAILING,
168 DWRITE_TEXT_ALIGNMENT_CENTER,
169 DWRITE_TEXT_ALIGNMENT_JUSTIFIED
170 } DWRITE_TEXT_ALIGNMENT;
172 typedef enum DWRITE_PARAGRAPH_ALIGNMENT
174 DWRITE_PARAGRAPH_ALIGNMENT_NEAR,
175 DWRITE_PARAGRAPH_ALIGNMENT_FAR,
176 DWRITE_PARAGRAPH_ALIGNMENT_CENTER
177 } DWRITE_PARAGRAPH_ALIGNMENT;
179 typedef enum DWRITE_WORD_WRAPPING
181 DWRITE_WORD_WRAPPING_WRAP,
182 DWRITE_WORD_WRAPPING_NO_WRAP,
183 DWRITE_WORD_WRAPPING_EMERGENCY_BREAK,
184 DWRITE_WORD_WRAPPING_WHOLE_WORD,
185 DWRITE_WORD_WRAPPING_CHARACTER
186 } DWRITE_WORD_WRAPPING;
188 typedef enum DWRITE_READING_DIRECTION
190 DWRITE_READING_DIRECTION_LEFT_TO_RIGHT,
191 DWRITE_READING_DIRECTION_RIGHT_TO_LEFT,
192 DWRITE_READING_DIRECTION_TOP_TO_BOTTOM,
193 DWRITE_READING_DIRECTION_BOTTOM_TO_TOP
194 } DWRITE_READING_DIRECTION;
196 typedef enum DWRITE_FLOW_DIRECTION
198 DWRITE_FLOW_DIRECTION_TOP_TO_BOTTOM,
199 DWRITE_FLOW_DIRECTION_BOTTOM_TO_TOP,
200 DWRITE_FLOW_DIRECTION_LEFT_TO_RIGHT,
201 DWRITE_FLOW_DIRECTION_RIGHT_TO_LEFT
202 } DWRITE_FLOW_DIRECTION;
204 typedef enum DWRITE_TRIMMING_GRANULARITY
206 DWRITE_TRIMMING_GRANULARITY_NONE,
207 DWRITE_TRIMMING_GRANULARITY_CHARACTER,
208 DWRITE_TRIMMING_GRANULARITY_WORD
209 } DWRITE_TRIMMING_GRANULARITY;
211 typedef enum DWRITE_BREAK_CONDITION
213 DWRITE_BREAK_CONDITION_NEUTRAL,
214 DWRITE_BREAK_CONDITION_CAN_BREAK,
215 DWRITE_BREAK_CONDITION_MAY_NOT_BREAK,
216 DWRITE_BREAK_CONDITION_MUST_BREAK
217 } DWRITE_BREAK_CONDITION;
219 typedef enum DWRITE_LINE_SPACING_METHOD
221 DWRITE_LINE_SPACING_METHOD_DEFAULT,
222 DWRITE_LINE_SPACING_METHOD_UNIFORM
223 } DWRITE_LINE_SPACING_METHOD;
225 typedef enum DWRITE_FONT_FEATURE_TAG
227 DWRITE_FONT_FEATURE_TAG_ALTERNATIVE_FRACTIONS = 0x63726661, /* 'afrc' */
228 DWRITE_FONT_FEATURE_TAG_PETITE_CAPITALS_FROM_CAPITALS = 0x63703263, /* 'c2pc' */
229 DWRITE_FONT_FEATURE_TAG_SMALL_CAPITALS_FROM_CAPITALS = 0x63733263, /* 'c2sc' */
230 DWRITE_FONT_FEATURE_TAG_CONTEXTUAL_ALTERNATES = 0x746c6163, /* 'calt' */
231 DWRITE_FONT_FEATURE_TAG_CASE_SENSITIVE_FORMS = 0x65736163, /* 'case' */
232 DWRITE_FONT_FEATURE_TAG_GLYPH_COMPOSITION_DECOMPOSITION = 0x706d6363, /* 'ccmp' */
233 DWRITE_FONT_FEATURE_TAG_CONTEXTUAL_LIGATURES = 0x67696c63, /* 'clig' */
234 DWRITE_FONT_FEATURE_TAG_CAPITAL_SPACING = 0x70737063, /* 'cpsp' */
235 DWRITE_FONT_FEATURE_TAG_CONTEXTUAL_SWASH = 0x68777363, /* 'cswh' */
236 DWRITE_FONT_FEATURE_TAG_CURSIVE_POSITIONING = 0x73727563, /* 'curs' */
237 DWRITE_FONT_FEATURE_TAG_DEFAULT = 0x746c6664, /* 'dflt' */
238 DWRITE_FONT_FEATURE_TAG_DISCRETIONARY_LIGATURES = 0x67696c64, /* 'dlig' */
239 DWRITE_FONT_FEATURE_TAG_EXPERT_FORMS = 0x74707865, /* 'expt' */
240 DWRITE_FONT_FEATURE_TAG_FRACTIONS = 0x63617266, /* 'frac' */
241 DWRITE_FONT_FEATURE_TAG_FULL_WIDTH = 0x64697766, /* 'fwid' */
242 DWRITE_FONT_FEATURE_TAG_HALF_FORMS = 0x666c6168, /* 'half' */
243 DWRITE_FONT_FEATURE_TAG_HALANT_FORMS = 0x6e6c6168, /* 'haln' */
244 DWRITE_FONT_FEATURE_TAG_ALTERNATE_HALF_WIDTH = 0x746c6168, /* 'halt' */
245 DWRITE_FONT_FEATURE_TAG_HISTORICAL_FORMS = 0x74736968, /* 'hist' */
246 DWRITE_FONT_FEATURE_TAG_HORIZONTAL_KANA_ALTERNATES = 0x616e6b68, /* 'hkna' */
247 DWRITE_FONT_FEATURE_TAG_HISTORICAL_LIGATURES = 0x67696c68, /* 'hlig' */
248 DWRITE_FONT_FEATURE_TAG_HALF_WIDTH = 0x64697768, /* 'hwid' */
249 DWRITE_FONT_FEATURE_TAG_HOJO_KANJI_FORMS = 0x6f6a6f68, /* 'hojo' */
250 DWRITE_FONT_FEATURE_TAG_JIS04_FORMS = 0x3430706a, /* 'jp04' */
251 DWRITE_FONT_FEATURE_TAG_JIS78_FORMS = 0x3837706a, /* 'jp78' */
252 DWRITE_FONT_FEATURE_TAG_JIS83_FORMS = 0x3338706a, /* 'jp83' */
253 DWRITE_FONT_FEATURE_TAG_JIS90_FORMS = 0x3039706a, /* 'jp90' */
254 DWRITE_FONT_FEATURE_TAG_KERNING = 0x6e72656b, /* 'kern' */
255 DWRITE_FONT_FEATURE_TAG_STANDARD_LIGATURES = 0x6167696c, /* 'liga' */
256 DWRITE_FONT_FEATURE_TAG_LINING_FIGURES = 0x6d756e6c, /* 'lnum' */
257 DWRITE_FONT_FEATURE_TAG_LOCALIZED_FORMS = 0x6c636f6c, /* 'locl' */
258 DWRITE_FONT_FEATURE_TAG_MARK_POSITIONING = 0x6b72616d, /* 'mark' */
259 DWRITE_FONT_FEATURE_TAG_MATHEMATICAL_GREEK = 0x6b72676d, /* 'mgrk' */
260 DWRITE_FONT_FEATURE_TAG_MARK_TO_MARK_POSITIONING = 0x6b6d6b6d, /* 'mkmk' */
261 DWRITE_FONT_FEATURE_TAG_ALTERNATE_ANNOTATION_FORMS = 0x746c616e, /* 'nalt' */
262 DWRITE_FONT_FEATURE_TAG_NLC_KANJI_FORMS = 0x6b636c6e, /* 'nlck' */
263 DWRITE_FONT_FEATURE_TAG_OLD_STYLE_FIGURES = 0x6d756e6f, /* 'onum' */
264 DWRITE_FONT_FEATURE_TAG_ORDINALS = 0x6e64726f, /* 'ordn' */
265 DWRITE_FONT_FEATURE_TAG_PROPORTIONAL_ALTERNATE_WIDTH = 0x746c6170, /* 'palt' */
266 DWRITE_FONT_FEATURE_TAG_PETITE_CAPITALS = 0x70616370, /* 'pcap' */
267 DWRITE_FONT_FEATURE_TAG_PROPORTIONAL_FIGURES = 0x6d756e70, /* 'pnum' */
268 DWRITE_FONT_FEATURE_TAG_PROPORTIONAL_WIDTHS = 0x64697770, /* 'pwid' */
269 DWRITE_FONT_FEATURE_TAG_QUARTER_WIDTHS = 0x64697771, /* 'qwid' */
270 DWRITE_FONT_FEATURE_TAG_REQUIRED_LIGATURES = 0x67696c72, /* 'rlig' */
271 DWRITE_FONT_FEATURE_TAG_RUBY_NOTATION_FORMS = 0x79627572, /* 'ruby' */
272 DWRITE_FONT_FEATURE_TAG_STYLISTIC_ALTERNATES = 0x746c6173, /* 'salt' */
273 DWRITE_FONT_FEATURE_TAG_SCIENTIFIC_INFERIORS = 0x666e6973, /* 'sinf' */
274 DWRITE_FONT_FEATURE_TAG_SMALL_CAPITALS = 0x70636d73, /* 'smcp' */
275 DWRITE_FONT_FEATURE_TAG_SIMPLIFIED_FORMS = 0x6c706d73, /* 'smpl' */
276 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_1 = 0x31307373, /* 'ss01' */
277 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_2 = 0x32307373, /* 'ss02' */
278 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_3 = 0x33307373, /* 'ss03' */
279 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_4 = 0x34307373, /* 'ss04' */
280 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_5 = 0x35307373, /* 'ss05' */
281 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_6 = 0x36307373, /* 'ss06' */
282 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_7 = 0x37307373, /* 'ss07' */
283 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_8 = 0x38307373, /* 'ss08' */
284 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_9 = 0x39307373, /* 'ss09' */
285 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_10 = 0x30317373, /* 'ss10' */
286 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_11 = 0x31317373, /* 'ss11' */
287 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_12 = 0x32317373, /* 'ss12' */
288 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_13 = 0x33317373, /* 'ss13' */
289 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_14 = 0x34317373, /* 'ss14' */
290 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_15 = 0x35317373, /* 'ss15' */
291 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_16 = 0x36317373, /* 'ss16' */
292 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_17 = 0x37317373, /* 'ss17' */
293 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_18 = 0x38317373, /* 'ss18' */
294 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_19 = 0x39317373, /* 'ss19' */
295 DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_20 = 0x30327373, /* 'ss20' */
296 DWRITE_FONT_FEATURE_TAG_SUBSCRIPT = 0x73627573, /* 'subs' */
297 DWRITE_FONT_FEATURE_TAG_SUPERSCRIPT = 0x73707573, /* 'sups' */
298 DWRITE_FONT_FEATURE_TAG_SWASH = 0x68737773, /* 'swsh' */
299 DWRITE_FONT_FEATURE_TAG_TITLING = 0x6c746974, /* 'titl' */
300 DWRITE_FONT_FEATURE_TAG_TRADITIONAL_NAME_FORMS = 0x6d616e74, /* 'tnam' */
301 DWRITE_FONT_FEATURE_TAG_TABULAR_FIGURES = 0x6d756e74, /* 'tnum' */
302 DWRITE_FONT_FEATURE_TAG_TRADITIONAL_FORMS = 0x64617274, /* 'trad' */
303 DWRITE_FONT_FEATURE_TAG_THIRD_WIDTHS = 0x64697774, /* 'twid' */
304 DWRITE_FONT_FEATURE_TAG_UNICASE = 0x63696e75, /* 'unic' */
305 DWRITE_FONT_FEATURE_TAG_VERTICAL_WRITING = 0x74726576, /* 'vert' */
306 DWRITE_FONT_FEATURE_TAG_VERTICAL_ALTERNATES_AND_ROTATION= 0x32747276, /* 'vrt2' */
307 DWRITE_FONT_FEATURE_TAG_SLASHED_ZERO = 0x6f72657a, /* 'zero' */
308 } DWRITE_FONT_FEATURE_TAG;
310 typedef enum DWRITE_SCRIPT_SHAPES
312 DWRITE_SCRIPT_SHAPES_DEFAULT = 0,
313 DWRITE_SCRIPT_SHAPES_NO_VISUAL = 1
314 } DWRITE_SCRIPT_SHAPES;
316 typedef enum DWRITE_NUMBER_SUBSTITUTION_METHOD
318 DWRITE_NUMBER_SUBSTITUTION_METHOD_FROM_CULTURE,
319 DWRITE_NUMBER_SUBSTITUTION_METHOD_CONTEXTUAL,
320 DWRITE_NUMBER_SUBSTITUTION_METHOD_NONE,
321 DWRITE_NUMBER_SUBSTITUTION_METHOD_NATIONAL,
322 DWRITE_NUMBER_SUBSTITUTION_METHOD_TRADITIONAL
323 } DWRITE_NUMBER_SUBSTITUTION_METHOD;
325 typedef enum DWRITE_TEXTURE_TYPE
327 DWRITE_TEXTURE_ALIASED_1x1,
328 DWRITE_TEXTURE_CLEARTYPE_3x1
329 } DWRITE_TEXTURE_TYPE;
331 typedef struct DWRITE_FONT_METRICS
333 UINT16 designUnitsPerEm;
334 UINT16 ascent;
335 UINT16 descent;
336 INT16 lineGap;
337 UINT16 capHeight;
338 UINT16 xHeight;
339 INT16 underlinePosition;
340 UINT16 underlineThickness;
341 INT16 strikethroughPosition;
342 UINT16 strikethroughThickness;
343 } DWRITE_FONT_METRICS;
345 typedef struct DWRITE_GLYPH_METRICS
347 INT32 leftSideBearing;
348 UINT32 advanceWidth;
349 INT32 rightSideBearing;
350 INT32 topSideBearing;
351 UINT32 advanceHeight;
352 INT32 bottomSideBearing;
353 INT32 verticalOriginY;
354 } DWRITE_GLYPH_METRICS;
356 typedef struct DWRITE_GLYPH_OFFSET
358 FLOAT advanceOffset;
359 FLOAT ascenderOffset;
360 } DWRITE_GLYPH_OFFSET;
362 typedef struct DWRITE_MATRIX
364 FLOAT m11;
365 FLOAT m12;
366 FLOAT m21;
367 FLOAT m22;
368 FLOAT dx;
369 FLOAT dy;
370 } DWRITE_MATRIX;
372 typedef struct DWRITE_TRIMMING
374 DWRITE_TRIMMING_GRANULARITY granularity;
375 UINT32 delimiter;
376 UINT32 delimiterCount;
377 } DWRITE_TRIMMING;
379 typedef struct DWRITE_GLYPH_RUN
381 IDWriteFontFace* fontFace;
382 FLOAT fontEmSize;
383 UINT32 glyphCount;
384 UINT16 const* glyphIndices;
385 FLOAT const* glyphAdvances;
386 DWRITE_GLYPH_OFFSET const* glyphOffsets;
387 BOOL isSideways;
388 UINT32 bidiLevel;
389 } DWRITE_GLYPH_RUN;
391 typedef struct DWRITE_GLYPH_RUN_DESCRIPTION
393 WCHAR const* localeName;
394 WCHAR const* string;
395 UINT32 stringLength;
396 UINT16 const* clusterMap;
397 UINT32 textPosition;
398 } DWRITE_GLYPH_RUN_DESCRIPTION;
400 typedef struct DWRITE_UNDERLINE
402 FLOAT width;
403 FLOAT thickness;
404 FLOAT offset;
405 FLOAT runHeight;
406 DWRITE_READING_DIRECTION readingDirection;
407 DWRITE_FLOW_DIRECTION flowDirection;
408 WCHAR const* localeName;
409 DWRITE_MEASURING_MODE measuringMode;
410 } DWRITE_UNDERLINE;
412 typedef struct DWRITE_STRIKETHROUGH
414 FLOAT width;
415 FLOAT thickness;
416 FLOAT offset;
417 DWRITE_READING_DIRECTION readingDirection;
418 DWRITE_FLOW_DIRECTION flowDirection;
419 WCHAR const* localeName;
420 DWRITE_MEASURING_MODE measuringMode;
421 } DWRITE_STRIKETHROUGH;
423 typedef struct DWRITE_INLINE_OBJECT_METRICS
425 FLOAT width;
426 FLOAT height;
427 FLOAT baseline;
428 BOOL supportsSideways;
429 } DWRITE_INLINE_OBJECT_METRICS;
431 typedef struct DWRITE_OVERHANG_METRICS
433 FLOAT left;
434 FLOAT top;
435 FLOAT right;
436 FLOAT bottom;
437 } DWRITE_OVERHANG_METRICS;
439 typedef struct DWRITE_FONT_FEATURE
441 DWRITE_FONT_FEATURE_TAG nameTag;
442 UINT32 parameter;
443 } DWRITE_FONT_FEATURE;
445 typedef struct DWRITE_TEXT_RANGE
447 UINT32 startPosition;
448 UINT32 length;
449 } DWRITE_TEXT_RANGE;
451 typedef struct DWRITE_LINE_METRICS
453 UINT32 length;
454 UINT32 trailingWhitespaceLength;
455 UINT32 newlineLength;
456 FLOAT height;
457 FLOAT baseline;
458 BOOL isTrimmed;
459 } DWRITE_LINE_METRICS;
461 typedef struct DWRITE_TEXT_METRICS
463 FLOAT left;
464 FLOAT top;
465 FLOAT width;
466 FLOAT widthIncludingTrailingWhitespace;
467 FLOAT height;
468 FLOAT layoutWidth;
469 FLOAT layoutHeight;
470 UINT32 maxBidiReorderingDepth;
471 UINT32 lineCount;
472 } DWRITE_TEXT_METRICS;
474 typedef struct DWRITE_CLUSTER_METRICS
476 FLOAT width;
477 UINT16 length;
478 UINT16 canWrapLineAfter : 1;
479 UINT16 isWhitespace : 1;
480 UINT16 isNewline : 1;
481 UINT16 isSoftHyphen : 1;
482 UINT16 isRightToLeft : 1;
483 UINT16 padding : 11;
484 } DWRITE_CLUSTER_METRICS;
486 typedef struct DWRITE_HIT_TEST_METRICS
488 UINT32 textPosition;
489 UINT32 length;
490 FLOAT left;
491 FLOAT top;
492 FLOAT width;
493 FLOAT height;
494 UINT32 bidiLevel;
495 BOOL isText;
496 BOOL isTrimmed;
497 } DWRITE_HIT_TEST_METRICS;
499 typedef struct DWRITE_SCRIPT_ANALYSIS
501 UINT16 script;
502 DWRITE_SCRIPT_SHAPES shapes;
503 } DWRITE_SCRIPT_ANALYSIS;
505 typedef struct DWRITE_LINE_BREAKPOINT
507 UINT8 breakConditionBefore : 2;
508 UINT8 breakConditionAfter : 2;
509 UINT8 isWhitespace : 1;
510 UINT8 isSoftHyphen : 1;
511 UINT8 padding : 2;
512 } DWRITE_LINE_BREAKPOINT;
514 typedef struct DWRITE_TYPOGRAPHIC_FEATURES
516 DWRITE_FONT_FEATURE* features;
517 UINT32 featureCount;
518 } DWRITE_TYPOGRAPHIC_FEATURES;
520 typedef struct DWRITE_SHAPING_TEXT_PROPERTIES
522 UINT16 isShapedAlone : 1;
523 UINT16 reserved : 15;
524 } DWRITE_SHAPING_TEXT_PROPERTIES;
526 typedef struct DWRITE_SHAPING_GLYPH_PROPERTIES
528 UINT16 justification : 4;
529 UINT16 isClusterStart : 1;
530 UINT16 isDiacritic : 1;
531 UINT16 isZeroWidthSpace : 1;
532 UINT16 reserved : 9;
533 } DWRITE_SHAPING_GLYPH_PROPERTIES;
536 local,
537 object,
538 uuid(6d4865fe-0ab8-4d91-8f62-5dd6be34a3e0)
540 interface IDWriteFontFileStream : IUnknown
542 HRESULT ReadFileFragment(
543 void const **fragment_start,
544 UINT64 offset,
545 UINT64 fragment_size,
546 void **fragment_context);
548 void ReleaseFileFragment(void *fragment_context);
549 HRESULT GetFileSize(UINT64 *size);
550 HRESULT GetLastWriteTime(UINT64 *last_writetime);
554 local,
555 object,
556 uuid(727cad4e-d6af-4c9e-8a08-d695b11caa49)
558 interface IDWriteFontFileLoader : IUnknown
560 HRESULT CreateStreamFromKey(
561 void const *key,
562 UINT32 key_size,
563 IDWriteFontFileStream **stream);
567 local,
568 object,
569 uuid(b2d9f3ec-c9fe-4a11-a2ec-d86208f7c0a2)
571 interface IDWriteLocalFontFileLoader : IDWriteFontFileLoader
573 HRESULT GetFilePathLengthFromKey(void const *key, UINT32 key_size, UINT32 *length);
574 HRESULT GetFilePathFromKey(void const *key, UINT32 key_size, WCHAR *path, UINT32 length);
575 HRESULT GetLastWriteTimeFromKey(void const *key, UINT32 key_size, FILETIME *writetime);
579 local,
580 object,
581 uuid(739d886a-cef5-47dc-8769-1a8b41bebbb0)
583 interface IDWriteFontFile : IUnknown
585 HRESULT GetReferenceKey(
586 void const **key,
587 UINT32 *key_size);
589 HRESULT GetLoader(IDWriteFontFileLoader **loader);
591 HRESULT Analyze(
592 BOOL *is_supported_fonttype,
593 DWRITE_FONT_FILE_TYPE *file_type,
594 DWRITE_FONT_FACE_TYPE *face_type,
595 UINT32 *faces_num);
599 local,
600 object,
601 uuid(72755049-5ff7-435d-8348-4be97cfa6c7c)
603 interface IDWriteFontFileEnumerator : IUnknown
605 HRESULT MoveNext(BOOL *has_current_file);
606 HRESULT GetCurrentFontFile(IDWriteFontFile **font_file);
610 local,
611 object,
612 uuid(cca920e4-52f0-492b-bfa8-29c72ee0a468)
614 interface IDWriteFontCollectionLoader : IUnknown
616 HRESULT CreateEnumeratorFromKey(
617 IDWriteFactory* factory,
618 void const* key,
619 UINT32 key_size,
620 IDWriteFontFileEnumerator **enumerator);
624 local,
625 object,
626 uuid(08256209-099a-4b34-b86d-c22b110e7771)
628 interface IDWriteLocalizedStrings : IUnknown
630 UINT32 GetCount();
632 HRESULT FindLocaleName(
633 WCHAR const *locale_name,
634 UINT32 *index,
635 BOOL *exists);
637 HRESULT GetLocaleNameLength(UINT32 index, UINT32 *length);
638 HRESULT GetLocaleName(UINT32 index, WCHAR *locale_name, UINT32 size);
639 HRESULT GetStringLength(UINT32 index, UINT32 *length);
640 HRESULT GetString(UINT32 index, WCHAR *buffer, UINT32 size);
644 local,
645 object,
646 uuid(2f0da53a-2add-47cd-82ee-d9ec34688e75)
648 interface IDWriteRenderingParams : IUnknown
650 FLOAT GetGamma();
651 FLOAT GetEnhancedContrast();
652 FLOAT GetClearTypeLevel();
653 DWRITE_PIXEL_GEOMETRY GetPixelGeometry();
654 DWRITE_RENDERING_MODE GetRenderingMode();
658 local,
659 object,
660 uuid(5f49804d-7024-4d43-bfa9-d25984f53849)
662 interface IDWriteFontFace : IUnknown
664 DWRITE_FONT_FACE_TYPE GetType();
665 HRESULT GetFiles(UINT32 *number_of_files, IDWriteFontFile **fontfiles);
666 UINT32 GetIndex();
667 DWRITE_FONT_SIMULATIONS GetSimulations();
668 BOOL IsSymbolFont();
669 void GetMetrics(DWRITE_FONT_METRICS *metrics);
670 UINT16 GetGlyphCount();
672 HRESULT GetDesignGlyphMetrics(
673 UINT16 const *glyph_indices,
674 UINT32 glyph_count,
675 DWRITE_GLYPH_METRICS *metrics,
676 [defaultvalue(FALSE)] BOOL is_sideways);
678 HRESULT GetGlyphIndices(
679 UINT32 const *codepoints,
680 UINT32 count,
681 UINT16 *glyph_indices);
683 HRESULT TryGetFontTable(
684 UINT32 table_tag,
685 const void **table_data,
686 UINT32 *table_size,
687 void **context,
688 BOOL *exists);
690 void ReleaseFontTable(void *table_context);
692 HRESULT GetGlyphRunOutline(
693 FLOAT emSize,
694 UINT16 const *glyph_indices,
695 FLOAT const* glyph_advances,
696 DWRITE_GLYPH_OFFSET const *glyph_offsets,
697 UINT32 glyph_count,
698 BOOL is_sideways,
699 BOOL is_rtl,
700 IDWriteGeometrySink *geometrysink);
702 HRESULT GetRecommendedRenderingMode(
703 FLOAT emSize,
704 FLOAT pixels_per_dip,
705 DWRITE_MEASURING_MODE mode,
706 IDWriteRenderingParams* params,
707 DWRITE_RENDERING_MODE* rendering_mode);
709 HRESULT GetGdiCompatibleMetrics(
710 FLOAT emSize,
711 FLOAT pixels_per_dip,
712 DWRITE_MATRIX const *transform,
713 DWRITE_FONT_METRICS *metrics);
715 HRESULT GetGdiCompatibleGlyphMetrics(
716 FLOAT emSize,
717 FLOAT pixels_per_dip,
718 DWRITE_MATRIX const *transform,
719 BOOL use_gdi_natural,
720 UINT16 const *glyph_indices,
721 UINT32 glyph_count,
722 DWRITE_GLYPH_METRICS *metrics,
723 [defaultvalue(FALSE)] BOOL is_sideways);
727 local,
728 object,
729 uuid(acd16696-8c14-4f5d-877e-fe3fc1d32737)
731 interface IDWriteFont : IUnknown
733 HRESULT GetFontFamily(IDWriteFontFamily **family);
734 DWRITE_FONT_WEIGHT GetWeight();
735 DWRITE_FONT_STRETCH GetStretch();
736 DWRITE_FONT_STYLE GetStyle();
737 BOOL IsSymbolFont();
739 HRESULT GetFaceNames(IDWriteLocalizedStrings **names);
740 HRESULT GetInformationalStrings(
741 DWRITE_INFORMATIONAL_STRING_ID stringid,
742 IDWriteLocalizedStrings **strings,
743 BOOL *exists);
745 DWRITE_FONT_SIMULATIONS GetSimulations();
746 void GetMetrics(DWRITE_FONT_METRICS *metrics);
747 HRESULT HasCharacter(UINT32 value, BOOL *exists);
748 HRESULT CreateFontFace(IDWriteFontFace **face);
752 local,
753 object,
754 uuid(1a0d8438-1d97-4ec1-aef9-a2fb86ed6acb)
756 interface IDWriteFontList : IUnknown
758 HRESULT GetFontCollection(IDWriteFontCollection **collection);
759 UINT32 GetFontCount();
760 HRESULT GetFont(UINT32 index, IDWriteFont **font);
764 local,
765 object,
766 uuid(da20d8ef-812a-4c43-9802-62ec4abd7add)
768 interface IDWriteFontFamily : IDWriteFontList
770 HRESULT GetFamilyNames(IDWriteLocalizedStrings **names);
772 HRESULT GetFirstMatchingFont(
773 DWRITE_FONT_WEIGHT weight,
774 DWRITE_FONT_STRETCH stretch,
775 DWRITE_FONT_STYLE style,
776 IDWriteFont **font);
778 HRESULT GetMatchingFonts(
779 DWRITE_FONT_WEIGHT weight,
780 DWRITE_FONT_STRETCH stretch,
781 DWRITE_FONT_STYLE style,
782 IDWriteFontList **fonts);
786 local,
787 object,
788 uuid(a84cee02-3eea-4eee-a827-87c1a02a0fcc)
790 interface IDWriteFontCollection : IUnknown
792 UINT32 GetFontFamilyCount();
793 HRESULT GetFontFamily(UINT32 index, IDWriteFontFamily **family);
794 HRESULT FindFamilyName(WCHAR const *name, UINT32 *index, BOOL *exists);
795 HRESULT GetFontFromFontFace(IDWriteFontFace *face, IDWriteFont **font);
799 local,
800 object,
801 uuid(eaf3a2da-ecf4-4d24-b644-b34f6842024b)
803 interface IDWritePixelSnapping : IUnknown
805 HRESULT IsPixelSnappingDisabled(
806 void *client_drawingcontext,
807 BOOL *disabled);
809 HRESULT GetCurrentTransform(
810 void *client_drawingcontext,
811 DWRITE_MATRIX *transform);
813 HRESULT GetPixelsPerDip(
814 void *client_drawingcontext,
815 FLOAT *pixels_per_dip);
819 local,
820 object,
821 uuid(ef8a8135-5cc6-45fe-8825-c5a0724eb819)
823 interface IDWriteTextRenderer : IDWritePixelSnapping
825 HRESULT DrawGlyphRun(
826 void* client_drawingcontext,
827 FLOAT baselineOriginX,
828 FLOAT baselineOriginY,
829 DWRITE_MEASURING_MODE mode,
830 DWRITE_GLYPH_RUN const *glyph_run,
831 DWRITE_GLYPH_RUN_DESCRIPTION const *run_descr,
832 IUnknown *drawing_effect);
834 HRESULT DrawUnderline(
835 void *client_drawingcontext,
836 FLOAT baselineOriginX,
837 FLOAT baselineOriginY,
838 DWRITE_UNDERLINE const* underline,
839 IUnknown *drawing_effect);
841 HRESULT DrawStrikethrough(
842 void *client_drawingcontext,
843 FLOAT baselineOriginX,
844 FLOAT baselineOriginY,
845 DWRITE_STRIKETHROUGH const* strikethrough,
846 IUnknown *drawing_effect);
848 HRESULT DrawInlineObject(
849 void *client_drawingcontext,
850 FLOAT originX,
851 FLOAT originY,
852 IDWriteInlineObject *object,
853 BOOL is_sideways,
854 BOOL is_rtl,
855 IUnknown *drawing_effect);
859 local,
860 object,
861 uuid(8339fde3-106f-47ab-8373-1c6295eb10b3)
863 interface IDWriteInlineObject : IUnknown
865 HRESULT Draw(
866 void* client_drawingontext,
867 IDWriteTextRenderer* renderer,
868 FLOAT originX,
869 FLOAT originY,
870 BOOL is_sideways,
871 BOOL is_rtl,
872 IUnknown *drawing_effect);
874 HRESULT GetMetrics(DWRITE_INLINE_OBJECT_METRICS *metrics);
875 HRESULT GetOverhangMetrics(DWRITE_OVERHANG_METRICS *overhangs);
876 HRESULT GetBreakConditions(
877 DWRITE_BREAK_CONDITION* condition_before,
878 DWRITE_BREAK_CONDITION* condition_after);
882 local,
883 object,
884 uuid(9c906818-31d7-4fd3-a151-7c5e225db55a)
886 interface IDWriteTextFormat : IUnknown
888 HRESULT SetTextAlignment(DWRITE_TEXT_ALIGNMENT alignment);
889 HRESULT SetParagraphAlignment(DWRITE_PARAGRAPH_ALIGNMENT alignment);
890 HRESULT SetWordWrapping(DWRITE_WORD_WRAPPING wrapping);
891 HRESULT SetReadingDirection(DWRITE_READING_DIRECTION direction);
892 HRESULT SetFlowDirection(DWRITE_FLOW_DIRECTION direction);
893 HRESULT SetIncrementalTabStop(FLOAT tabstop);
894 HRESULT SetTrimming(DWRITE_TRIMMING const *trimming, IDWriteInlineObject *trimming_sign);
895 HRESULT SetLineSpacing(DWRITE_LINE_SPACING_METHOD spacing, FLOAT line_spacing, FLOAT baseline);
896 DWRITE_TEXT_ALIGNMENT GetTextAlignment();
897 DWRITE_PARAGRAPH_ALIGNMENT GetParagraphAlignment();
898 DWRITE_WORD_WRAPPING GetWordWrapping();
899 DWRITE_READING_DIRECTION GetReadingDirection();
900 DWRITE_FLOW_DIRECTION GetFlowDirection();
901 FLOAT GetIncrementalTabStop();
902 HRESULT GetTrimming(DWRITE_TRIMMING *options, IDWriteInlineObject **trimming_sign);
904 HRESULT GetLineSpacing(
905 DWRITE_LINE_SPACING_METHOD *method,
906 FLOAT *spacing,
907 FLOAT *baseline);
909 HRESULT GetFontCollection(IDWriteFontCollection **collection);
910 UINT32 GetFontFamilyNameLength();
911 HRESULT GetFontFamilyName(WCHAR *name, UINT32 size);
912 DWRITE_FONT_WEIGHT GetFontWeight();
913 DWRITE_FONT_STYLE GetFontStyle();
914 DWRITE_FONT_STRETCH GetFontStretch();
915 FLOAT GetFontSize();
916 UINT32 GetLocaleNameLength();
917 HRESULT GetLocaleName(WCHAR *name, UINT32 size);
921 local,
922 object,
923 uuid(55f1112b-1dc2-4b3c-9541-f46894ed85b6)
925 interface IDWriteTypography : IUnknown
927 HRESULT AddFontFeature(DWRITE_FONT_FEATURE feature);
928 UINT32 GetFontFeatureCount();
929 HRESULT GetFontFeature(UINT32 index, DWRITE_FONT_FEATURE *feature);
933 local,
934 object,
935 uuid(5e5a32a3-8dff-4773-9ff6-0696eab77267)
937 interface IDWriteBitmapRenderTarget : IUnknown
939 HRESULT DrawGlyphRun(
940 FLOAT baselineOriginX,
941 FLOAT baselineOriginY,
942 DWRITE_MEASURING_MODE measuring_mode,
943 DWRITE_GLYPH_RUN const* glyph_run,
944 IDWriteRenderingParams* params,
945 COLORREF textColor,
946 [defaultvalue(NULL)] RECT *blackbox_rect);
948 HDC GetMemoryDC();
949 FLOAT GetPixelsPerDip();
950 HRESULT SetPixelsPerDip(FLOAT pixels_per_dip);
951 HRESULT GetCurrentTransform(DWRITE_MATRIX *transform);
952 HRESULT SetCurrentTransform(DWRITE_MATRIX const *transform);
953 HRESULT GetSize(SIZE *size);
954 HRESULT Resize(UINT32 width, UINT32 height);
957 cpp_quote("#ifndef _WINGDI_")
958 /* already defined in wingdi.h but needed for WIDL */
959 #define LF_FACESIZE 32
961 typedef struct tagLOGFONTW
963 LONG lfHeight;
964 LONG lfWidth;
965 LONG lfEscapement;
966 LONG lfOrientation;
967 LONG lfWeight;
968 BYTE lfItalic;
969 BYTE lfUnderline;
970 BYTE lfStrikeOut;
971 BYTE lfCharSet;
972 BYTE lfOutPrecision;
973 BYTE lfClipPrecision;
974 BYTE lfQuality;
975 BYTE lfPitchAndFamily;
976 WCHAR lfFaceName[LF_FACESIZE];
977 } LOGFONTW, *PLOGFONTW, *LPLOGFONTW;
978 cpp_quote("#endif /* _WINGDI_ */")
981 local,
982 object,
983 uuid(1edd9491-9853-4299-898f-6432983b6f3a)
985 interface IDWriteGdiInterop : IUnknown
987 HRESULT CreateFontFromLOGFONT(LOGFONTW const *logfont, IDWriteFont **font);
988 HRESULT ConvertFontToLOGFONT(
989 IDWriteFont* font,
990 LOGFONTW* logfont,
991 BOOL *is_systemfont);
993 HRESULT ConvertFontFaceToLOGFONT(IDWriteFontFace* font, LOGFONTW* logfont);
994 HRESULT CreateFontFaceFromHdc(HDC hdc, IDWriteFontFace **fontface);
995 HRESULT CreateBitmapRenderTarget(HDC hdc, UINT32 width, UINT32 height, IDWriteBitmapRenderTarget **target);
999 local,
1000 object,
1001 uuid(53737037-6d14-410b-9bfe-0b182bb70961)
1003 interface IDWriteTextLayout : IDWriteTextFormat
1005 HRESULT SetMaxWidth(FLOAT maxWidth);
1006 HRESULT SetMaxHeight(FLOAT maxHeight);
1007 HRESULT SetFontCollection(IDWriteFontCollection* collection, DWRITE_TEXT_RANGE range);
1008 HRESULT SetFontFamilyName(WCHAR const *name, DWRITE_TEXT_RANGE range);
1009 HRESULT SetFontWeight(DWRITE_FONT_WEIGHT weight, DWRITE_TEXT_RANGE range);
1010 HRESULT SetFontStyle(DWRITE_FONT_STYLE style, DWRITE_TEXT_RANGE range);
1011 HRESULT SetFontStretch(DWRITE_FONT_STRETCH stretch, DWRITE_TEXT_RANGE range);
1012 HRESULT SetFontSize(FLOAT size, DWRITE_TEXT_RANGE range);
1013 HRESULT SetUnderline(BOOL underline, DWRITE_TEXT_RANGE range);
1014 HRESULT SetStrikethrough(BOOL strikethrough, DWRITE_TEXT_RANGE range);
1015 HRESULT SetDrawingEffect(IUnknown* effect, DWRITE_TEXT_RANGE range);
1016 HRESULT SetInlineObject(IDWriteInlineObject *object, DWRITE_TEXT_RANGE range);
1017 HRESULT SetTypography(IDWriteTypography* typography, DWRITE_TEXT_RANGE range);
1018 HRESULT SetLocaleName(WCHAR const* locale, DWRITE_TEXT_RANGE range);
1020 FLOAT GetMaxWidth();
1021 FLOAT GetMaxHeight();
1022 HRESULT GetFontCollection(
1023 UINT32 pos,
1024 IDWriteFontCollection** collection,
1025 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1027 HRESULT GetFontFamilyNameLength(
1028 UINT32 pos,
1029 UINT32* len,
1030 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1032 HRESULT GetFontFamilyName(
1033 UINT32 position,
1034 WCHAR* name,
1035 UINT32 name_size,
1036 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1038 HRESULT GetFontWeight(
1039 UINT32 position,
1040 DWRITE_FONT_WEIGHT *weight,
1041 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1043 HRESULT GetFontStyle(
1044 UINT32 currentPosition,
1045 DWRITE_FONT_STYLE *style,
1046 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1048 HRESULT GetFontStretch(
1049 UINT32 position,
1050 DWRITE_FONT_STRETCH *stretch,
1051 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1053 HRESULT GetFontSize(
1054 UINT32 position,
1055 FLOAT *size,
1056 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1058 HRESULT GetUnderline(
1059 UINT32 position,
1060 BOOL *has_underline,
1061 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1063 HRESULT GetStrikethrough(
1064 UINT32 position,
1065 BOOL *has_strikethrough,
1066 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1068 HRESULT GetDrawingEffect(
1069 UINT32 position,
1070 IUnknown **effect,
1071 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1073 HRESULT GetInlineObject(
1074 UINT32 position,
1075 IDWriteInlineObject **object,
1076 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1078 HRESULT GetTypography(
1079 UINT32 position,
1080 IDWriteTypography** typography,
1081 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1083 HRESULT GetLocaleNameLength(
1084 UINT32 position,
1085 UINT32* length,
1086 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1088 HRESULT GetLocaleName(
1089 UINT32 position,
1090 WCHAR* name,
1091 UINT32 name_size,
1092 [defaultvalue(NULL)] DWRITE_TEXT_RANGE *range);
1094 HRESULT Draw(
1095 void *context,
1096 IDWriteTextRenderer* renderer,
1097 FLOAT originX,
1098 FLOAT originY);
1100 HRESULT GetLineMetrics(
1101 DWRITE_LINE_METRICS *metrics,
1102 UINT32 max_count,
1103 UINT32 *actual_count);
1105 HRESULT GetMetrics(DWRITE_TEXT_METRICS *metrics);
1106 HRESULT GetOverhangMetrics(DWRITE_OVERHANG_METRICS *overhangs);
1107 HRESULT GetClusterMetrics(
1108 DWRITE_CLUSTER_METRICS *metrics,
1109 UINT32 max_count,
1110 UINT32* act_count);
1112 HRESULT DetermineMinWidth(FLOAT* min_width);
1113 HRESULT HitTestPoint(
1114 FLOAT pointX,
1115 FLOAT pointY,
1116 BOOL* is_trailinghit,
1117 BOOL* is_inside,
1118 DWRITE_HIT_TEST_METRICS *metrics);
1120 HRESULT HitTestTextPosition(
1121 UINT32 textPosition,
1122 BOOL is_trailinghit,
1123 FLOAT* pointX,
1124 FLOAT* pointY,
1125 DWRITE_HIT_TEST_METRICS *metrics);
1127 HRESULT HitTestTextRange(
1128 UINT32 textPosition,
1129 UINT32 textLength,
1130 FLOAT originX,
1131 FLOAT originY,
1132 DWRITE_HIT_TEST_METRICS *metrics,
1133 UINT32 max_metricscount,
1134 UINT32* actual_metricscount);
1138 local,
1139 object,
1140 uuid(14885cc9-bab0-4f90-b6ed-5c366a2cd03d)
1142 interface IDWriteNumberSubstitution : IUnknown
1147 local,
1148 object,
1149 uuid(688e1a58-5094-47c8-adc8-fbcea60ae92b)
1151 interface IDWriteTextAnalysisSource : IUnknown
1153 HRESULT GetTextAtPosition(
1154 UINT32 position,
1155 WCHAR const** text,
1156 UINT32* text_len);
1158 HRESULT GetTextBeforePosition(
1159 UINT32 position,
1160 WCHAR const** text,
1161 UINT32* text_len);
1163 DWRITE_READING_DIRECTION GetParagraphReadingDirection();
1164 HRESULT GetLocaleName(
1165 UINT32 position,
1166 UINT32* text_len,
1167 WCHAR const** locale);
1169 HRESULT GetNumberSubstitution(
1170 UINT32 position,
1171 UINT32* text_len,
1172 IDWriteNumberSubstitution **substitution);
1176 local,
1177 object,
1178 uuid(5810cd44-0ca0-4701-b3fa-bec5182ae4f6)
1180 interface IDWriteTextAnalysisSink : IUnknown
1182 HRESULT SetScriptAnalysis(
1183 UINT32 position,
1184 UINT32 length,
1185 DWRITE_SCRIPT_ANALYSIS const* scriptanalysis);
1187 HRESULT SetLineBreakpoints(
1188 UINT32 position,
1189 UINT32 length,
1190 DWRITE_LINE_BREAKPOINT const* breakpoints);
1192 HRESULT SetBidiLevel(
1193 UINT32 position,
1194 UINT32 length,
1195 UINT8 explicitLevel,
1196 UINT8 resolvedLevel);
1198 HRESULT SetNumberSubstitution(
1199 UINT32 position,
1200 UINT32 length,
1201 IDWriteNumberSubstitution* substitution);
1205 local,
1206 object,
1207 uuid(b7e6163e-7f46-43b4-84b3-e4e6249c365d)
1209 interface IDWriteTextAnalyzer : IUnknown
1211 HRESULT AnalyzeScript(
1212 IDWriteTextAnalysisSource* source,
1213 UINT32 position,
1214 UINT32 length,
1215 IDWriteTextAnalysisSink* sink);
1217 HRESULT AnalyzeBidi(
1218 IDWriteTextAnalysisSource* source,
1219 UINT32 position,
1220 UINT32 length,
1221 IDWriteTextAnalysisSink* sink);
1223 HRESULT AnalyzeNumberSubstitution(
1224 IDWriteTextAnalysisSource* source,
1225 UINT32 position,
1226 UINT32 length,
1227 IDWriteTextAnalysisSink* sink);
1229 HRESULT AnalyzeLineBreakpoints(
1230 IDWriteTextAnalysisSource* source,
1231 UINT32 position,
1232 UINT32 length,
1233 IDWriteTextAnalysisSink* sink);
1235 HRESULT GetGlyphs(
1236 WCHAR const* text,
1237 UINT32 length,
1238 IDWriteFontFace* font_face,
1239 BOOL is_sideways,
1240 BOOL is_rtl,
1241 DWRITE_SCRIPT_ANALYSIS const* analysis,
1242 WCHAR const* locale,
1243 IDWriteNumberSubstitution* substitution,
1244 DWRITE_TYPOGRAPHIC_FEATURES const** features,
1245 UINT32 const* feature_range_len,
1246 UINT32 feature_ranges,
1247 UINT32 max_glyph_count,
1248 UINT16* clustermap,
1249 DWRITE_SHAPING_TEXT_PROPERTIES* text_props,
1250 UINT16* glyph_indices,
1251 DWRITE_SHAPING_GLYPH_PROPERTIES* glyph_props,
1252 UINT32* actual_glyph_count);
1254 HRESULT GetGlyphPlacements(
1255 WCHAR const* text,
1256 UINT16 const* clustermap,
1257 DWRITE_SHAPING_TEXT_PROPERTIES* props,
1258 UINT32 text_len,
1259 UINT16 const* glyph_indices,
1260 DWRITE_SHAPING_GLYPH_PROPERTIES const* glyph_props,
1261 UINT32 glyph_count,
1262 IDWriteFontFace * font_face,
1263 FLOAT fontEmSize,
1264 BOOL is_sideways,
1265 BOOL is_rtl,
1266 DWRITE_SCRIPT_ANALYSIS const* analysis,
1267 WCHAR const* locale,
1268 DWRITE_TYPOGRAPHIC_FEATURES const** features,
1269 UINT32 const* feature_range_len,
1270 UINT32 feature_ranges,
1271 FLOAT* glyph_advances,
1272 DWRITE_GLYPH_OFFSET* glyph_offsets);
1274 HRESULT GetGdiCompatibleGlyphPlacements(
1275 WCHAR const* text,
1276 UINT16 const* clustermap,
1277 DWRITE_SHAPING_TEXT_PROPERTIES* props,
1278 UINT32 text_len,
1279 UINT16 const* glyph_indices,
1280 DWRITE_SHAPING_GLYPH_PROPERTIES const* glyph_props,
1281 UINT32 glyph_count,
1282 IDWriteFontFace * font_face,
1283 FLOAT fontEmSize,
1284 FLOAT pixels_per_dip,
1285 DWRITE_MATRIX const* transform,
1286 BOOL use_gdi_natural,
1287 BOOL is_sideways,
1288 BOOL is_rtl,
1289 DWRITE_SCRIPT_ANALYSIS const* analysis,
1290 WCHAR const* locale,
1291 DWRITE_TYPOGRAPHIC_FEATURES const** features,
1292 UINT32 const* feature_range_lengths,
1293 UINT32 feature_ranges,
1294 FLOAT* glyph_advances,
1295 DWRITE_GLYPH_OFFSET* glyph_offsets);
1299 local,
1300 object,
1301 uuid(7d97dbf7-e085-42d4-81e3-6a883bded118)
1303 interface IDWriteGlyphRunAnalysis : IUnknown
1305 HRESULT GetAlphaTextureBounds(DWRITE_TEXTURE_TYPE type, RECT* bounds);
1306 HRESULT CreateAlphaTexture(DWRITE_TEXTURE_TYPE type, RECT const* bounds, BYTE* alphaValues, UINT32 bufferSize);
1307 HRESULT GetAlphaBlendParams(
1308 IDWriteRenderingParams* renderingParams,
1309 FLOAT* blendGamma,
1310 FLOAT* blendEnhancedContrast,
1311 FLOAT* blendClearTypeLevel);
1315 local,
1316 object,
1317 uuid(b859ee5a-d838-4b5b-a2e8-1adc7d93db48)
1319 interface IDWriteFactory : IUnknown
1321 HRESULT GetSystemFontCollection(IDWriteFontCollection **collection,
1322 [defaultvalue(FALSE)] BOOL check_for_updates);
1324 HRESULT CreateCustomFontCollection(
1325 IDWriteFontCollectionLoader *loader,
1326 void const *key,
1327 UINT32 key_size,
1328 IDWriteFontCollection **collection);
1330 HRESULT RegisterFontCollectionLoader(IDWriteFontCollectionLoader *loader);
1332 HRESULT UnregisterFontCollectionLoader(IDWriteFontCollectionLoader *loader);
1334 HRESULT CreateFontFileReference(
1335 WCHAR const *path,
1336 FILETIME const *writetime,
1337 IDWriteFontFile **font_file);
1339 HRESULT CreateCustomFontFileReference(
1340 void const *reference_key,
1341 UINT32 key_size,
1342 IDWriteFontFileLoader *loader,
1343 IDWriteFontFile **font_file);
1345 HRESULT CreateFontFace(
1346 DWRITE_FONT_FACE_TYPE facetype,
1347 UINT32 files_number,
1348 IDWriteFontFile* const* font_files,
1349 UINT32 index,
1350 DWRITE_FONT_SIMULATIONS sim_flags,
1351 IDWriteFontFace **font_face);
1353 HRESULT CreateRenderingParams(IDWriteRenderingParams **params);
1355 HRESULT CreateMonitorRenderingParams(
1356 HMONITOR monitor,
1357 IDWriteRenderingParams **params);
1359 HRESULT CreateCustomRenderingParams(
1360 FLOAT gamma,
1361 FLOAT enhancedContrast,
1362 FLOAT cleartype_level,
1363 DWRITE_PIXEL_GEOMETRY geometry,
1364 DWRITE_RENDERING_MODE mode,
1365 IDWriteRenderingParams **params);
1367 HRESULT RegisterFontFileLoader(IDWriteFontFileLoader *loader);
1369 HRESULT UnregisterFontFileLoader(IDWriteFontFileLoader *loader);
1371 HRESULT CreateTextFormat(
1372 WCHAR const* family_name,
1373 IDWriteFontCollection *collection,
1374 DWRITE_FONT_WEIGHT weight,
1375 DWRITE_FONT_STYLE style,
1376 DWRITE_FONT_STRETCH stretch,
1377 FLOAT size,
1378 WCHAR const *locale,
1379 IDWriteTextFormat **format);
1381 HRESULT CreateTypography(IDWriteTypography **typography);
1383 HRESULT GetGdiInterop(IDWriteGdiInterop **gdi_interop);
1385 HRESULT CreateTextLayout(
1386 WCHAR const* string,
1387 UINT32 len,
1388 IDWriteTextFormat *format,
1389 FLOAT max_width,
1390 FLOAT max_height,
1391 IDWriteTextLayout **layout);
1393 HRESULT CreateGdiCompatibleTextLayout(
1394 WCHAR const* string,
1395 UINT32 len,
1396 IDWriteTextFormat *format,
1397 FLOAT layout_width,
1398 FLOAT layout_height,
1399 FLOAT pixels_per_dip,
1400 DWRITE_MATRIX const* transform,
1401 BOOL use_gdi_natural,
1402 IDWriteTextLayout **layout);
1404 HRESULT CreateEllipsisTrimmingSign(
1405 IDWriteTextFormat *format,
1406 IDWriteInlineObject **trimming_sign);
1408 HRESULT CreateTextAnalyzer(IDWriteTextAnalyzer **analyzer);
1410 HRESULT CreateNumberSubstitution(
1411 DWRITE_NUMBER_SUBSTITUTION_METHOD method,
1412 WCHAR const* locale,
1413 BOOL ignore_user_override,
1414 IDWriteNumberSubstitution **substitution);
1416 HRESULT CreateGlyphRunAnalysis(
1417 DWRITE_GLYPH_RUN const *glyph_run,
1418 FLOAT pixels_per_dip,
1419 DWRITE_MATRIX const* transform,
1420 DWRITE_RENDERING_MODE rendering_mode,
1421 DWRITE_MEASURING_MODE measuring_mode,
1422 FLOAT baseline_x,
1423 FLOAT baseline_y,
1424 IDWriteGlyphRunAnalysis **analysis);
1427 cpp_quote("HRESULT WINAPI DWriteCreateFactory(DWRITE_FACTORY_TYPE,REFIID,IUnknown**);")
1429 /* error codes */
1430 cpp_quote("#define FACILITY_DWRITE 0x898")
1431 cpp_quote("#define DWRITE_ERR_BASE 0x5000")
1432 cpp_quote("#define MAKE_DWRITE_HR(severity, code) MAKE_HRESULT(severity, FACILITY_DWRITE, (DWRITE_ERR_BASE + code))")
1433 cpp_quote("#define MAKE_DWRITE_HR_ERR(code) MAKE_DWRITE_HR(SEVERITY_ERROR, code)")