dwrite.h

Go to the documentation of this file.

//+--------------------------------------------------------------------------
//
//  Copyright (c) Microsoft Corporation.  All rights reserved.
//
//  Abstract:
//     DirectX Typography Services public API definitions.
//
//----------------------------------------------------------------------------

#ifndef DWRITE_H_INCLUDED
#define DWRITE_H_INCLUDED

#pragma once

#ifndef DWRITE_NO_WINDOWS_H

#include <specstrings.h>
#include <unknwn.h>

#endif // DWRITE_NO_WINDOWS_H

#include <dcommon.h>

#ifndef DWRITE_DECLARE_INTERFACE
#define DWRITE_DECLARE_INTERFACE(iid) DECLSPEC_UUID(iid) DECLSPEC_NOVTABLE
#endif

#ifndef DWRITE_EXPORT
#define DWRITE_EXPORT __declspec(dllimport) WINAPI
#endif

enum DWRITE_FONT_FILE_TYPE
{
    DWRITE_FONT_FILE_TYPE_UNKNOWN,

    DWRITE_FONT_FILE_TYPE_CFF,

    DWRITE_FONT_FILE_TYPE_TRUETYPE,

    DWRITE_FONT_FILE_TYPE_OPENTYPE_COLLECTION,

    DWRITE_FONT_FILE_TYPE_TYPE1_PFM,

    DWRITE_FONT_FILE_TYPE_TYPE1_PFB,

    DWRITE_FONT_FILE_TYPE_VECTOR,

    DWRITE_FONT_FILE_TYPE_BITMAP,

    // The following name is obsolete, but kept as an alias to avoid breaking existing code.
    DWRITE_FONT_FILE_TYPE_TRUETYPE_COLLECTION = DWRITE_FONT_FILE_TYPE_OPENTYPE_COLLECTION,
};

enum DWRITE_FONT_FACE_TYPE
{
    DWRITE_FONT_FACE_TYPE_CFF,

    DWRITE_FONT_FACE_TYPE_TRUETYPE,

    DWRITE_FONT_FACE_TYPE_OPENTYPE_COLLECTION,

    DWRITE_FONT_FACE_TYPE_TYPE1,

    DWRITE_FONT_FACE_TYPE_VECTOR,

    DWRITE_FONT_FACE_TYPE_BITMAP,

    DWRITE_FONT_FACE_TYPE_UNKNOWN,

    DWRITE_FONT_FACE_TYPE_RAW_CFF,

    // The following name is obsolete, but kept as an alias to avoid breaking existing code.
    DWRITE_FONT_FACE_TYPE_TRUETYPE_COLLECTION = DWRITE_FONT_FACE_TYPE_OPENTYPE_COLLECTION,
};

enum DWRITE_FONT_SIMULATIONS
{
    DWRITE_FONT_SIMULATIONS_NONE    = 0x0000,

    DWRITE_FONT_SIMULATIONS_BOLD    = 0x0001,

    DWRITE_FONT_SIMULATIONS_OBLIQUE = 0x0002
};

#ifdef DEFINE_ENUM_FLAG_OPERATORS
DEFINE_ENUM_FLAG_OPERATORS(DWRITE_FONT_SIMULATIONS);
#endif

enum DWRITE_FONT_WEIGHT
{
    DWRITE_FONT_WEIGHT_THIN = 100,

    DWRITE_FONT_WEIGHT_EXTRA_LIGHT = 200,

    DWRITE_FONT_WEIGHT_ULTRA_LIGHT = 200,

    DWRITE_FONT_WEIGHT_LIGHT = 300,

    DWRITE_FONT_WEIGHT_SEMI_LIGHT = 350,

    DWRITE_FONT_WEIGHT_NORMAL = 400,

    DWRITE_FONT_WEIGHT_REGULAR = 400,

    DWRITE_FONT_WEIGHT_MEDIUM = 500,

    DWRITE_FONT_WEIGHT_DEMI_BOLD = 600,

    DWRITE_FONT_WEIGHT_SEMI_BOLD = 600,

    DWRITE_FONT_WEIGHT_BOLD = 700,

    DWRITE_FONT_WEIGHT_EXTRA_BOLD = 800,

    DWRITE_FONT_WEIGHT_ULTRA_BOLD = 800,

    DWRITE_FONT_WEIGHT_BLACK = 900,

    DWRITE_FONT_WEIGHT_HEAVY = 900,

    DWRITE_FONT_WEIGHT_EXTRA_BLACK = 950,

    DWRITE_FONT_WEIGHT_ULTRA_BLACK = 950
};

enum DWRITE_FONT_STRETCH
{
    DWRITE_FONT_STRETCH_UNDEFINED = 0,

    DWRITE_FONT_STRETCH_ULTRA_CONDENSED = 1,

    DWRITE_FONT_STRETCH_EXTRA_CONDENSED = 2,

    DWRITE_FONT_STRETCH_CONDENSED = 3,

    DWRITE_FONT_STRETCH_SEMI_CONDENSED = 4,

    DWRITE_FONT_STRETCH_NORMAL = 5,

    DWRITE_FONT_STRETCH_MEDIUM = 5,

    DWRITE_FONT_STRETCH_SEMI_EXPANDED = 6,

    DWRITE_FONT_STRETCH_EXPANDED = 7,

    DWRITE_FONT_STRETCH_EXTRA_EXPANDED = 8,

    DWRITE_FONT_STRETCH_ULTRA_EXPANDED = 9
};

enum DWRITE_FONT_STYLE
{
    DWRITE_FONT_STYLE_NORMAL,

    DWRITE_FONT_STYLE_OBLIQUE,

    DWRITE_FONT_STYLE_ITALIC

};

enum DWRITE_INFORMATIONAL_STRING_ID
{
    DWRITE_INFORMATIONAL_STRING_NONE,

    DWRITE_INFORMATIONAL_STRING_COPYRIGHT_NOTICE,

    DWRITE_INFORMATIONAL_STRING_VERSION_STRINGS,

    DWRITE_INFORMATIONAL_STRING_TRADEMARK,

    DWRITE_INFORMATIONAL_STRING_MANUFACTURER,

    DWRITE_INFORMATIONAL_STRING_DESIGNER,

    DWRITE_INFORMATIONAL_STRING_DESIGNER_URL,

    DWRITE_INFORMATIONAL_STRING_DESCRIPTION,

    DWRITE_INFORMATIONAL_STRING_FONT_VENDOR_URL,

    DWRITE_INFORMATIONAL_STRING_LICENSE_DESCRIPTION,

    DWRITE_INFORMATIONAL_STRING_LICENSE_INFO_URL,

    DWRITE_INFORMATIONAL_STRING_WIN32_FAMILY_NAMES,

    DWRITE_INFORMATIONAL_STRING_WIN32_SUBFAMILY_NAMES,

    DWRITE_INFORMATIONAL_STRING_TYPOGRAPHIC_FAMILY_NAMES,

    DWRITE_INFORMATIONAL_STRING_TYPOGRAPHIC_SUBFAMILY_NAMES,

    DWRITE_INFORMATIONAL_STRING_SAMPLE_TEXT,

    DWRITE_INFORMATIONAL_STRING_FULL_NAME,

    DWRITE_INFORMATIONAL_STRING_POSTSCRIPT_NAME,

    DWRITE_INFORMATIONAL_STRING_POSTSCRIPT_CID_NAME,

    DWRITE_INFORMATIONAL_STRING_WEIGHT_STRETCH_STYLE_FAMILY_NAME,

    DWRITE_INFORMATIONAL_STRING_DESIGN_SCRIPT_LANGUAGE_TAG,

    DWRITE_INFORMATIONAL_STRING_SUPPORTED_SCRIPT_LANGUAGE_TAG,

    // Obsolete aliases kept to avoid breaking existing code.
    DWRITE_INFORMATIONAL_STRING_PREFERRED_FAMILY_NAMES = DWRITE_INFORMATIONAL_STRING_TYPOGRAPHIC_FAMILY_NAMES,
    DWRITE_INFORMATIONAL_STRING_PREFERRED_SUBFAMILY_NAMES = DWRITE_INFORMATIONAL_STRING_TYPOGRAPHIC_SUBFAMILY_NAMES,
    DWRITE_INFORMATIONAL_STRING_WWS_FAMILY_NAME = DWRITE_INFORMATIONAL_STRING_WEIGHT_STRETCH_STYLE_FAMILY_NAME,
};


struct DWRITE_FONT_METRICS
{
    UINT16 designUnitsPerEm;

    UINT16 ascent;

    UINT16 descent;

    INT16 lineGap;

    UINT16 capHeight;

    UINT16 xHeight;

    INT16 underlinePosition;

    UINT16 underlineThickness;

    INT16 strikethroughPosition;

    UINT16 strikethroughThickness;
};

struct DWRITE_GLYPH_METRICS
{
    INT32 leftSideBearing;

    UINT32 advanceWidth;

    INT32 rightSideBearing;

    INT32 topSideBearing;

    UINT32 advanceHeight;

    INT32 bottomSideBearing;

    INT32 verticalOriginY;
};

struct DWRITE_GLYPH_OFFSET
{
    FLOAT advanceOffset;

    FLOAT ascenderOffset;
};

enum DWRITE_FACTORY_TYPE
{
    DWRITE_FACTORY_TYPE_SHARED,

    DWRITE_FACTORY_TYPE_ISOLATED
};

#define DWRITE_MAKE_OPENTYPE_TAG(a,b,c,d) ( \
    (static_cast<UINT32>(static_cast<UINT8>(d)) << 24) | \
    (static_cast<UINT32>(static_cast<UINT8>(c)) << 16) | \
    (static_cast<UINT32>(static_cast<UINT8>(b)) << 8)  | \
     static_cast<UINT32>(static_cast<UINT8>(a)))

#define DWRITE_MAKE_FONT_FEATURE_TAG(a,b,c,d) (static_cast<DWRITE_FONT_FEATURE_TAG>(DWRITE_MAKE_OPENTYPE_TAG(a,b,c,d)))

interface IDWriteFontFileStream;

interface DWRITE_DECLARE_INTERFACE("727cad4e-d6af-4c9e-8a08-d695b11caa49") IDWriteFontFileLoader : public IUnknown
{
    STDMETHOD(CreateStreamFromKey)(
        _In_reads_bytes_(fontFileReferenceKeySize) void const* fontFileReferenceKey,
        UINT32 fontFileReferenceKeySize,
        _COM_Outptr_ IDWriteFontFileStream** fontFileStream
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("b2d9f3ec-c9fe-4a11-a2ec-d86208f7c0a2") IDWriteLocalFontFileLoader : public IDWriteFontFileLoader
{
    STDMETHOD(GetFilePathLengthFromKey)(
        _In_reads_bytes_(fontFileReferenceKeySize) void const* fontFileReferenceKey,
        UINT32 fontFileReferenceKeySize,
        _Out_ UINT32* filePathLength
        ) PURE;

    STDMETHOD(GetFilePathFromKey)(
        _In_reads_bytes_(fontFileReferenceKeySize) void const* fontFileReferenceKey,
        UINT32 fontFileReferenceKeySize,
        _Out_writes_z_(filePathSize) WCHAR* filePath,
        UINT32 filePathSize
        ) PURE;

    STDMETHOD(GetLastWriteTimeFromKey)(
        _In_reads_bytes_(fontFileReferenceKeySize) void const* fontFileReferenceKey,
        UINT32 fontFileReferenceKeySize,
        _Out_ FILETIME* lastWriteTime
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("6d4865fe-0ab8-4d91-8f62-5dd6be34a3e0") IDWriteFontFileStream : public IUnknown
{
    STDMETHOD(ReadFileFragment)(
        _Outptr_result_bytebuffer_(fragmentSize) void const** fragmentStart,
        UINT64 fileOffset,
        UINT64 fragmentSize,
        _Out_ void** fragmentContext
        ) PURE;

    STDMETHOD_(void, ReleaseFileFragment)(
        void* fragmentContext
        ) PURE;

    STDMETHOD(GetFileSize)(
        _Out_ UINT64* fileSize
        ) PURE;

    STDMETHOD(GetLastWriteTime)(
        _Out_ UINT64* lastWriteTime
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("739d886a-cef5-47dc-8769-1a8b41bebbb0") IDWriteFontFile : public IUnknown
{
    STDMETHOD(GetReferenceKey)(
        _Outptr_result_bytebuffer_(*fontFileReferenceKeySize) void const** fontFileReferenceKey,
        _Out_ UINT32* fontFileReferenceKeySize
        ) PURE;

    STDMETHOD(GetLoader)(
        _COM_Outptr_ IDWriteFontFileLoader** fontFileLoader
        ) PURE;

    STDMETHOD(Analyze)(
        _Out_ BOOL* isSupportedFontType,
        _Out_ DWRITE_FONT_FILE_TYPE* fontFileType,
        _Out_opt_ DWRITE_FONT_FACE_TYPE* fontFaceType,
        _Out_ UINT32* numberOfFaces
        ) PURE;
};

#ifndef DWRITE_PIXEL_GEOMETRY_DEFINED
enum DWRITE_PIXEL_GEOMETRY
{
    DWRITE_PIXEL_GEOMETRY_FLAT,

    DWRITE_PIXEL_GEOMETRY_RGB,

    DWRITE_PIXEL_GEOMETRY_BGR
};
#define DWRITE_PIXEL_GEOMETRY_DEFINED
#endif

enum DWRITE_RENDERING_MODE
{
    DWRITE_RENDERING_MODE_DEFAULT,

    DWRITE_RENDERING_MODE_ALIASED,

    DWRITE_RENDERING_MODE_GDI_CLASSIC,

    DWRITE_RENDERING_MODE_GDI_NATURAL,

    DWRITE_RENDERING_MODE_NATURAL,

    DWRITE_RENDERING_MODE_NATURAL_SYMMETRIC,

    DWRITE_RENDERING_MODE_OUTLINE,

    // The following names are obsolete, but are kept as aliases to avoid breaking existing code.
    // Each of these rendering modes may result in either ClearType or grayscale antialiasing 
    // depending on the DWRITE_TEXT_ANTIALIASING_MODE.
    DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC         = DWRITE_RENDERING_MODE_GDI_CLASSIC,
    DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURAL         = DWRITE_RENDERING_MODE_GDI_NATURAL,
    DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL             = DWRITE_RENDERING_MODE_NATURAL,
    DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL_SYMMETRIC   = DWRITE_RENDERING_MODE_NATURAL_SYMMETRIC
};

struct DWRITE_MATRIX
{
    FLOAT m11;

    FLOAT m12;

    FLOAT m21;

    FLOAT m22;

    FLOAT dx;

    FLOAT dy;
};

interface DWRITE_DECLARE_INTERFACE("2f0da53a-2add-47cd-82ee-d9ec34688e75") IDWriteRenderingParams : public IUnknown
{
    STDMETHOD_(FLOAT, GetGamma)() PURE;

    STDMETHOD_(FLOAT, GetEnhancedContrast)() PURE;

    STDMETHOD_(FLOAT, GetClearTypeLevel)() PURE;

    STDMETHOD_(DWRITE_PIXEL_GEOMETRY, GetPixelGeometry)() PURE;

    STDMETHOD_(DWRITE_RENDERING_MODE, GetRenderingMode)() PURE;
};

// Forward declarations of D2D types
interface ID2D1SimplifiedGeometrySink;

typedef ID2D1SimplifiedGeometrySink IDWriteGeometrySink;

interface DWRITE_DECLARE_INTERFACE("5f49804d-7024-4d43-bfa9-d25984f53849") IDWriteFontFace : public IUnknown
{
    STDMETHOD_(DWRITE_FONT_FACE_TYPE, GetType)() PURE;

    STDMETHOD(GetFiles)(
        _Inout_ UINT32* numberOfFiles,
        _Out_writes_opt_(*numberOfFiles) IDWriteFontFile** fontFiles
        ) PURE;

    STDMETHOD_(UINT32, GetIndex)() PURE;

    STDMETHOD_(DWRITE_FONT_SIMULATIONS, GetSimulations)() PURE;

    STDMETHOD_(BOOL, IsSymbolFont)() PURE;

    STDMETHOD_(void, GetMetrics)(
        _Out_ DWRITE_FONT_METRICS* fontFaceMetrics
        ) PURE;

    STDMETHOD_(UINT16, GetGlyphCount)() PURE;

    STDMETHOD(GetDesignGlyphMetrics)(
        _In_reads_(glyphCount) UINT16 const* glyphIndices,
        UINT32 glyphCount,
        _Out_writes_(glyphCount) DWRITE_GLYPH_METRICS* glyphMetrics,
        BOOL isSideways = FALSE
        ) PURE;

    STDMETHOD(GetGlyphIndices)(
        _In_reads_(codePointCount) UINT32 const* codePoints,
        UINT32 codePointCount,
        _Out_writes_(codePointCount) UINT16* glyphIndices
        ) PURE;
 
    STDMETHOD(TryGetFontTable)(
        _In_ UINT32 openTypeTableTag,
        _Outptr_result_bytebuffer_(*tableSize) const void** tableData,
        _Out_ UINT32* tableSize,
        _Out_ void** tableContext,
        _Out_ BOOL* exists
        ) PURE;

    STDMETHOD_(void, ReleaseFontTable)(
        _In_ void* tableContext
        ) PURE;

    STDMETHOD(GetGlyphRunOutline)(
        FLOAT emSize,
        _In_reads_(glyphCount) UINT16 const* glyphIndices,
        _In_reads_opt_(glyphCount) FLOAT const* glyphAdvances,
        _In_reads_opt_(glyphCount) DWRITE_GLYPH_OFFSET const* glyphOffsets,
        UINT32 glyphCount,
        BOOL isSideways,
        BOOL isRightToLeft,
        _In_ IDWriteGeometrySink* geometrySink
        ) PURE;

    STDMETHOD(GetRecommendedRenderingMode)(
        FLOAT emSize,
        FLOAT pixelsPerDip,
        DWRITE_MEASURING_MODE measuringMode,
        IDWriteRenderingParams* renderingParams,
        _Out_ DWRITE_RENDERING_MODE* renderingMode
        ) PURE;

    STDMETHOD(GetGdiCompatibleMetrics)(
        FLOAT emSize,
        FLOAT pixelsPerDip,
        _In_opt_ DWRITE_MATRIX const* transform,
        _Out_ DWRITE_FONT_METRICS* fontFaceMetrics
        ) PURE;

    STDMETHOD(GetGdiCompatibleGlyphMetrics)(
        FLOAT emSize,
        FLOAT pixelsPerDip,
        _In_opt_ DWRITE_MATRIX const* transform,
        BOOL useGdiNatural,
        _In_reads_(glyphCount) UINT16 const* glyphIndices,
        UINT32 glyphCount,
        _Out_writes_(glyphCount) DWRITE_GLYPH_METRICS* glyphMetrics,
        BOOL isSideways = FALSE
        ) PURE;
};


interface IDWriteFactory;
interface IDWriteFontFileEnumerator;

interface DWRITE_DECLARE_INTERFACE("cca920e4-52f0-492b-bfa8-29c72ee0a468") IDWriteFontCollectionLoader : public IUnknown
{
    STDMETHOD(CreateEnumeratorFromKey)(
        _In_ IDWriteFactory* factory,
        _In_reads_bytes_(collectionKeySize) void const* collectionKey,
        UINT32 collectionKeySize,
        _COM_Outptr_ IDWriteFontFileEnumerator** fontFileEnumerator
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("72755049-5ff7-435d-8348-4be97cfa6c7c") IDWriteFontFileEnumerator : public IUnknown
{
    STDMETHOD(MoveNext)(
        _Out_ BOOL* hasCurrentFile
        ) PURE;

    STDMETHOD(GetCurrentFontFile)(
        _COM_Outptr_ IDWriteFontFile** fontFile
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("08256209-099a-4b34-b86d-c22b110e7771") IDWriteLocalizedStrings : public IUnknown
{
    STDMETHOD_(UINT32, GetCount)() PURE;

    STDMETHOD(FindLocaleName)(
        _In_z_ WCHAR const* localeName,
        _Out_ UINT32* index,
        _Out_ BOOL* exists
        ) PURE;

    STDMETHOD(GetLocaleNameLength)(
        UINT32 index,
        _Out_ UINT32* length
        ) PURE;

    STDMETHOD(GetLocaleName)(
        UINT32 index,
        _Out_writes_z_(size) WCHAR* localeName,
        UINT32 size
        ) PURE;

    STDMETHOD(GetStringLength)(
        UINT32 index,
        _Out_ UINT32* length
        ) PURE;

    STDMETHOD(GetString)(
        UINT32 index,
        _Out_writes_z_(size) WCHAR* stringBuffer,
        UINT32 size
        ) PURE;
};

interface IDWriteFontFamily;
interface IDWriteFont;

interface DWRITE_DECLARE_INTERFACE("a84cee02-3eea-4eee-a827-87c1a02a0fcc") IDWriteFontCollection : public IUnknown
{
    STDMETHOD_(UINT32, GetFontFamilyCount)() PURE;

    STDMETHOD(GetFontFamily)(
        UINT32 index,
        _COM_Outptr_ IDWriteFontFamily** fontFamily
        ) PURE;

    STDMETHOD(FindFamilyName)(
        _In_z_ WCHAR const* familyName,
        _Out_ UINT32* index,
        _Out_ BOOL* exists
        ) PURE;

    STDMETHOD(GetFontFromFontFace)(
        _In_ IDWriteFontFace* fontFace,
        _COM_Outptr_ IDWriteFont** font
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("1a0d8438-1d97-4ec1-aef9-a2fb86ed6acb") IDWriteFontList : public IUnknown
{
    STDMETHOD(GetFontCollection)(
        _COM_Outptr_ IDWriteFontCollection** fontCollection
        ) PURE;

    STDMETHOD_(UINT32, GetFontCount)() PURE;

    STDMETHOD(GetFont)(
        UINT32 index, 
        _COM_Outptr_ IDWriteFont** font
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("da20d8ef-812a-4c43-9802-62ec4abd7add") IDWriteFontFamily : public IDWriteFontList
{
    STDMETHOD(GetFamilyNames)(
        _COM_Outptr_ IDWriteLocalizedStrings** names
        ) PURE;

    STDMETHOD(GetFirstMatchingFont)(
        DWRITE_FONT_WEIGHT  weight,
        DWRITE_FONT_STRETCH stretch,
        DWRITE_FONT_STYLE   style,
        _COM_Outptr_ IDWriteFont** matchingFont
        ) PURE;

    STDMETHOD(GetMatchingFonts)(
        DWRITE_FONT_WEIGHT      weight,
        DWRITE_FONT_STRETCH     stretch,
        DWRITE_FONT_STYLE       style,
        _COM_Outptr_ IDWriteFontList** matchingFonts
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("acd16696-8c14-4f5d-877e-fe3fc1d32737") IDWriteFont : public IUnknown
{
    STDMETHOD(GetFontFamily)(
        _COM_Outptr_ IDWriteFontFamily** fontFamily
        ) PURE;

    STDMETHOD_(DWRITE_FONT_WEIGHT, GetWeight)() PURE;

    STDMETHOD_(DWRITE_FONT_STRETCH, GetStretch)() PURE;

    STDMETHOD_(DWRITE_FONT_STYLE, GetStyle)() PURE;

    STDMETHOD_(BOOL, IsSymbolFont)() PURE;

    STDMETHOD(GetFaceNames)(
        _COM_Outptr_ IDWriteLocalizedStrings** names
        ) PURE;

    STDMETHOD(GetInformationalStrings)(
        DWRITE_INFORMATIONAL_STRING_ID informationalStringID,
        _COM_Outptr_result_maybenull_ IDWriteLocalizedStrings** informationalStrings,
        _Out_ BOOL* exists
        ) PURE;

    STDMETHOD_(DWRITE_FONT_SIMULATIONS, GetSimulations)() PURE;

    STDMETHOD_(void, GetMetrics)(
        _Out_ DWRITE_FONT_METRICS* fontMetrics
        ) PURE;

    STDMETHOD(HasCharacter)(
        UINT32 unicodeValue,
        _Out_ BOOL* exists
        ) PURE;

    STDMETHOD(CreateFontFace)(
        _COM_Outptr_ IDWriteFontFace** fontFace
        ) PURE;
};

enum DWRITE_READING_DIRECTION
{
    DWRITE_READING_DIRECTION_LEFT_TO_RIGHT = 0,

    DWRITE_READING_DIRECTION_RIGHT_TO_LEFT = 1,

    DWRITE_READING_DIRECTION_TOP_TO_BOTTOM = 2,

    DWRITE_READING_DIRECTION_BOTTOM_TO_TOP = 3,
};

enum DWRITE_FLOW_DIRECTION
{
    DWRITE_FLOW_DIRECTION_TOP_TO_BOTTOM = 0,

    DWRITE_FLOW_DIRECTION_BOTTOM_TO_TOP = 1,

    DWRITE_FLOW_DIRECTION_LEFT_TO_RIGHT = 2,

    DWRITE_FLOW_DIRECTION_RIGHT_TO_LEFT = 3,
};

enum DWRITE_TEXT_ALIGNMENT
{
    DWRITE_TEXT_ALIGNMENT_LEADING,

    DWRITE_TEXT_ALIGNMENT_TRAILING,

    DWRITE_TEXT_ALIGNMENT_CENTER,

    DWRITE_TEXT_ALIGNMENT_JUSTIFIED
};

enum DWRITE_PARAGRAPH_ALIGNMENT
{
    DWRITE_PARAGRAPH_ALIGNMENT_NEAR,

    DWRITE_PARAGRAPH_ALIGNMENT_FAR,

    DWRITE_PARAGRAPH_ALIGNMENT_CENTER
};

enum DWRITE_WORD_WRAPPING
{
    DWRITE_WORD_WRAPPING_WRAP = 0,

    DWRITE_WORD_WRAPPING_NO_WRAP = 1,

    DWRITE_WORD_WRAPPING_EMERGENCY_BREAK = 2,

    DWRITE_WORD_WRAPPING_WHOLE_WORD = 3,

    DWRITE_WORD_WRAPPING_CHARACTER = 4,
};

enum DWRITE_LINE_SPACING_METHOD
{
    DWRITE_LINE_SPACING_METHOD_DEFAULT,

    DWRITE_LINE_SPACING_METHOD_UNIFORM,

    DWRITE_LINE_SPACING_METHOD_PROPORTIONAL
};

enum DWRITE_TRIMMING_GRANULARITY
{
    DWRITE_TRIMMING_GRANULARITY_NONE,

    DWRITE_TRIMMING_GRANULARITY_CHARACTER,
    
    DWRITE_TRIMMING_GRANULARITY_WORD    
};

enum DWRITE_FONT_FEATURE_TAG
{
    DWRITE_FONT_FEATURE_TAG_ALTERNATIVE_FRACTIONS               = DWRITE_MAKE_OPENTYPE_TAG('a','f','r','c'),
    DWRITE_FONT_FEATURE_TAG_PETITE_CAPITALS_FROM_CAPITALS       = DWRITE_MAKE_OPENTYPE_TAG('c','2','p','c'),
    DWRITE_FONT_FEATURE_TAG_SMALL_CAPITALS_FROM_CAPITALS        = DWRITE_MAKE_OPENTYPE_TAG('c','2','s','c'),
    DWRITE_FONT_FEATURE_TAG_CONTEXTUAL_ALTERNATES               = DWRITE_MAKE_OPENTYPE_TAG('c','a','l','t'),
    DWRITE_FONT_FEATURE_TAG_CASE_SENSITIVE_FORMS                = DWRITE_MAKE_OPENTYPE_TAG('c','a','s','e'),
    DWRITE_FONT_FEATURE_TAG_GLYPH_COMPOSITION_DECOMPOSITION     = DWRITE_MAKE_OPENTYPE_TAG('c','c','m','p'),
    DWRITE_FONT_FEATURE_TAG_CONTEXTUAL_LIGATURES                = DWRITE_MAKE_OPENTYPE_TAG('c','l','i','g'),
    DWRITE_FONT_FEATURE_TAG_CAPITAL_SPACING                     = DWRITE_MAKE_OPENTYPE_TAG('c','p','s','p'),
    DWRITE_FONT_FEATURE_TAG_CONTEXTUAL_SWASH                    = DWRITE_MAKE_OPENTYPE_TAG('c','s','w','h'),
    DWRITE_FONT_FEATURE_TAG_CURSIVE_POSITIONING                 = DWRITE_MAKE_OPENTYPE_TAG('c','u','r','s'),
    DWRITE_FONT_FEATURE_TAG_DEFAULT                             = DWRITE_MAKE_OPENTYPE_TAG('d','f','l','t'),
    DWRITE_FONT_FEATURE_TAG_DISCRETIONARY_LIGATURES             = DWRITE_MAKE_OPENTYPE_TAG('d','l','i','g'),
    DWRITE_FONT_FEATURE_TAG_EXPERT_FORMS                        = DWRITE_MAKE_OPENTYPE_TAG('e','x','p','t'),
    DWRITE_FONT_FEATURE_TAG_FRACTIONS                           = DWRITE_MAKE_OPENTYPE_TAG('f','r','a','c'),
    DWRITE_FONT_FEATURE_TAG_FULL_WIDTH                          = DWRITE_MAKE_OPENTYPE_TAG('f','w','i','d'),
    DWRITE_FONT_FEATURE_TAG_HALF_FORMS                          = DWRITE_MAKE_OPENTYPE_TAG('h','a','l','f'),
    DWRITE_FONT_FEATURE_TAG_HALANT_FORMS                        = DWRITE_MAKE_OPENTYPE_TAG('h','a','l','n'),
    DWRITE_FONT_FEATURE_TAG_ALTERNATE_HALF_WIDTH                = DWRITE_MAKE_OPENTYPE_TAG('h','a','l','t'),
    DWRITE_FONT_FEATURE_TAG_HISTORICAL_FORMS                    = DWRITE_MAKE_OPENTYPE_TAG('h','i','s','t'),
    DWRITE_FONT_FEATURE_TAG_HORIZONTAL_KANA_ALTERNATES          = DWRITE_MAKE_OPENTYPE_TAG('h','k','n','a'),
    DWRITE_FONT_FEATURE_TAG_HISTORICAL_LIGATURES                = DWRITE_MAKE_OPENTYPE_TAG('h','l','i','g'),
    DWRITE_FONT_FEATURE_TAG_HALF_WIDTH                          = DWRITE_MAKE_OPENTYPE_TAG('h','w','i','d'),
    DWRITE_FONT_FEATURE_TAG_HOJO_KANJI_FORMS                    = DWRITE_MAKE_OPENTYPE_TAG('h','o','j','o'),
    DWRITE_FONT_FEATURE_TAG_JIS04_FORMS                         = DWRITE_MAKE_OPENTYPE_TAG('j','p','0','4'),
    DWRITE_FONT_FEATURE_TAG_JIS78_FORMS                         = DWRITE_MAKE_OPENTYPE_TAG('j','p','7','8'),
    DWRITE_FONT_FEATURE_TAG_JIS83_FORMS                         = DWRITE_MAKE_OPENTYPE_TAG('j','p','8','3'),
    DWRITE_FONT_FEATURE_TAG_JIS90_FORMS                         = DWRITE_MAKE_OPENTYPE_TAG('j','p','9','0'),
    DWRITE_FONT_FEATURE_TAG_KERNING                             = DWRITE_MAKE_OPENTYPE_TAG('k','e','r','n'),
    DWRITE_FONT_FEATURE_TAG_STANDARD_LIGATURES                  = DWRITE_MAKE_OPENTYPE_TAG('l','i','g','a'),
    DWRITE_FONT_FEATURE_TAG_LINING_FIGURES                      = DWRITE_MAKE_OPENTYPE_TAG('l','n','u','m'),
    DWRITE_FONT_FEATURE_TAG_LOCALIZED_FORMS                     = DWRITE_MAKE_OPENTYPE_TAG('l','o','c','l'),
    DWRITE_FONT_FEATURE_TAG_MARK_POSITIONING                    = DWRITE_MAKE_OPENTYPE_TAG('m','a','r','k'),
    DWRITE_FONT_FEATURE_TAG_MATHEMATICAL_GREEK                  = DWRITE_MAKE_OPENTYPE_TAG('m','g','r','k'),
    DWRITE_FONT_FEATURE_TAG_MARK_TO_MARK_POSITIONING            = DWRITE_MAKE_OPENTYPE_TAG('m','k','m','k'),
    DWRITE_FONT_FEATURE_TAG_ALTERNATE_ANNOTATION_FORMS          = DWRITE_MAKE_OPENTYPE_TAG('n','a','l','t'),
    DWRITE_FONT_FEATURE_TAG_NLC_KANJI_FORMS                     = DWRITE_MAKE_OPENTYPE_TAG('n','l','c','k'),
    DWRITE_FONT_FEATURE_TAG_OLD_STYLE_FIGURES                   = DWRITE_MAKE_OPENTYPE_TAG('o','n','u','m'),
    DWRITE_FONT_FEATURE_TAG_ORDINALS                            = DWRITE_MAKE_OPENTYPE_TAG('o','r','d','n'),
    DWRITE_FONT_FEATURE_TAG_PROPORTIONAL_ALTERNATE_WIDTH        = DWRITE_MAKE_OPENTYPE_TAG('p','a','l','t'),
    DWRITE_FONT_FEATURE_TAG_PETITE_CAPITALS                     = DWRITE_MAKE_OPENTYPE_TAG('p','c','a','p'),
    DWRITE_FONT_FEATURE_TAG_PROPORTIONAL_FIGURES                = DWRITE_MAKE_OPENTYPE_TAG('p','n','u','m'),
    DWRITE_FONT_FEATURE_TAG_PROPORTIONAL_WIDTHS                 = DWRITE_MAKE_OPENTYPE_TAG('p','w','i','d'),
    DWRITE_FONT_FEATURE_TAG_QUARTER_WIDTHS                      = DWRITE_MAKE_OPENTYPE_TAG('q','w','i','d'),
    DWRITE_FONT_FEATURE_TAG_REQUIRED_LIGATURES                  = DWRITE_MAKE_OPENTYPE_TAG('r','l','i','g'),
    DWRITE_FONT_FEATURE_TAG_RUBY_NOTATION_FORMS                 = DWRITE_MAKE_OPENTYPE_TAG('r','u','b','y'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_ALTERNATES                = DWRITE_MAKE_OPENTYPE_TAG('s','a','l','t'),
    DWRITE_FONT_FEATURE_TAG_SCIENTIFIC_INFERIORS                = DWRITE_MAKE_OPENTYPE_TAG('s','i','n','f'),
    DWRITE_FONT_FEATURE_TAG_SMALL_CAPITALS                      = DWRITE_MAKE_OPENTYPE_TAG('s','m','c','p'),
    DWRITE_FONT_FEATURE_TAG_SIMPLIFIED_FORMS                    = DWRITE_MAKE_OPENTYPE_TAG('s','m','p','l'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_1                     = DWRITE_MAKE_OPENTYPE_TAG('s','s','0','1'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_2                     = DWRITE_MAKE_OPENTYPE_TAG('s','s','0','2'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_3                     = DWRITE_MAKE_OPENTYPE_TAG('s','s','0','3'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_4                     = DWRITE_MAKE_OPENTYPE_TAG('s','s','0','4'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_5                     = DWRITE_MAKE_OPENTYPE_TAG('s','s','0','5'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_6                     = DWRITE_MAKE_OPENTYPE_TAG('s','s','0','6'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_7                     = DWRITE_MAKE_OPENTYPE_TAG('s','s','0','7'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_8                     = DWRITE_MAKE_OPENTYPE_TAG('s','s','0','8'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_9                     = DWRITE_MAKE_OPENTYPE_TAG('s','s','0','9'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_10                    = DWRITE_MAKE_OPENTYPE_TAG('s','s','1','0'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_11                    = DWRITE_MAKE_OPENTYPE_TAG('s','s','1','1'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_12                    = DWRITE_MAKE_OPENTYPE_TAG('s','s','1','2'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_13                    = DWRITE_MAKE_OPENTYPE_TAG('s','s','1','3'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_14                    = DWRITE_MAKE_OPENTYPE_TAG('s','s','1','4'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_15                    = DWRITE_MAKE_OPENTYPE_TAG('s','s','1','5'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_16                    = DWRITE_MAKE_OPENTYPE_TAG('s','s','1','6'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_17                    = DWRITE_MAKE_OPENTYPE_TAG('s','s','1','7'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_18                    = DWRITE_MAKE_OPENTYPE_TAG('s','s','1','8'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_19                    = DWRITE_MAKE_OPENTYPE_TAG('s','s','1','9'),
    DWRITE_FONT_FEATURE_TAG_STYLISTIC_SET_20                    = DWRITE_MAKE_OPENTYPE_TAG('s','s','2','0'),
    DWRITE_FONT_FEATURE_TAG_SUBSCRIPT                           = DWRITE_MAKE_OPENTYPE_TAG('s','u','b','s'),
    DWRITE_FONT_FEATURE_TAG_SUPERSCRIPT                         = DWRITE_MAKE_OPENTYPE_TAG('s','u','p','s'),
    DWRITE_FONT_FEATURE_TAG_SWASH                               = DWRITE_MAKE_OPENTYPE_TAG('s','w','s','h'),
    DWRITE_FONT_FEATURE_TAG_TITLING                             = DWRITE_MAKE_OPENTYPE_TAG('t','i','t','l'),
    DWRITE_FONT_FEATURE_TAG_TRADITIONAL_NAME_FORMS              = DWRITE_MAKE_OPENTYPE_TAG('t','n','a','m'),
    DWRITE_FONT_FEATURE_TAG_TABULAR_FIGURES                     = DWRITE_MAKE_OPENTYPE_TAG('t','n','u','m'),
    DWRITE_FONT_FEATURE_TAG_TRADITIONAL_FORMS                   = DWRITE_MAKE_OPENTYPE_TAG('t','r','a','d'),
    DWRITE_FONT_FEATURE_TAG_THIRD_WIDTHS                        = DWRITE_MAKE_OPENTYPE_TAG('t','w','i','d'),
    DWRITE_FONT_FEATURE_TAG_UNICASE                             = DWRITE_MAKE_OPENTYPE_TAG('u','n','i','c'),
    DWRITE_FONT_FEATURE_TAG_VERTICAL_WRITING                    = DWRITE_MAKE_OPENTYPE_TAG('v','e','r','t'),
    DWRITE_FONT_FEATURE_TAG_VERTICAL_ALTERNATES_AND_ROTATION    = DWRITE_MAKE_OPENTYPE_TAG('v','r','t','2'),
    DWRITE_FONT_FEATURE_TAG_SLASHED_ZERO                        = DWRITE_MAKE_OPENTYPE_TAG('z','e','r','o'),
};

struct DWRITE_TEXT_RANGE
{
    UINT32 startPosition;

    UINT32 length;
};

struct DWRITE_FONT_FEATURE
{
    DWRITE_FONT_FEATURE_TAG nameTag;

    UINT32 parameter;
};

struct DWRITE_TYPOGRAPHIC_FEATURES
{
    _Field_size_(featureCount) DWRITE_FONT_FEATURE* features;

    UINT32 featureCount;
};

struct DWRITE_TRIMMING
{
    DWRITE_TRIMMING_GRANULARITY granularity;

    UINT32 delimiter;

    UINT32 delimiterCount;
};


interface IDWriteTypography;
interface IDWriteInlineObject;

interface DWRITE_DECLARE_INTERFACE("9c906818-31d7-4fd3-a151-7c5e225db55a") IDWriteTextFormat : public IUnknown
{
    STDMETHOD(SetTextAlignment)(
        DWRITE_TEXT_ALIGNMENT textAlignment
        ) PURE;

    STDMETHOD(SetParagraphAlignment)(
        DWRITE_PARAGRAPH_ALIGNMENT paragraphAlignment
        ) PURE;

    STDMETHOD(SetWordWrapping)(
        DWRITE_WORD_WRAPPING wordWrapping
        ) PURE;

    STDMETHOD(SetReadingDirection)(
        DWRITE_READING_DIRECTION readingDirection
        ) PURE;

    STDMETHOD(SetFlowDirection)(
        DWRITE_FLOW_DIRECTION flowDirection
        ) PURE;

    STDMETHOD(SetIncrementalTabStop)(
        FLOAT incrementalTabStop
        ) PURE;

    STDMETHOD(SetTrimming)(
        _In_ DWRITE_TRIMMING const* trimmingOptions,
        _In_opt_ IDWriteInlineObject* trimmingSign
        ) PURE;

    STDMETHOD(SetLineSpacing)(
        DWRITE_LINE_SPACING_METHOD lineSpacingMethod,
        FLOAT lineSpacing,
        FLOAT baseline
        ) PURE;

    STDMETHOD_(DWRITE_TEXT_ALIGNMENT, GetTextAlignment)() PURE;

    STDMETHOD_(DWRITE_PARAGRAPH_ALIGNMENT, GetParagraphAlignment)() PURE;

    STDMETHOD_(DWRITE_WORD_WRAPPING, GetWordWrapping)() PURE;

    STDMETHOD_(DWRITE_READING_DIRECTION, GetReadingDirection)() PURE;

    STDMETHOD_(DWRITE_FLOW_DIRECTION, GetFlowDirection)() PURE;

    STDMETHOD_(FLOAT, GetIncrementalTabStop)() PURE;

    STDMETHOD(GetTrimming)(
        _Out_ DWRITE_TRIMMING* trimmingOptions,
        _COM_Outptr_ IDWriteInlineObject** trimmingSign
        ) PURE;

    STDMETHOD(GetLineSpacing)(
        _Out_ DWRITE_LINE_SPACING_METHOD* lineSpacingMethod,
        _Out_ FLOAT* lineSpacing,
        _Out_ FLOAT* baseline
        ) PURE;

    STDMETHOD(GetFontCollection)(
        _COM_Outptr_ IDWriteFontCollection** fontCollection
        ) PURE;

    STDMETHOD_(UINT32, GetFontFamilyNameLength)() PURE;

    STDMETHOD(GetFontFamilyName)(
        _Out_writes_z_(nameSize) WCHAR* fontFamilyName,
        UINT32 nameSize
        ) PURE;

    STDMETHOD_(DWRITE_FONT_WEIGHT, GetFontWeight)() PURE;

    STDMETHOD_(DWRITE_FONT_STYLE, GetFontStyle)() PURE;

    STDMETHOD_(DWRITE_FONT_STRETCH, GetFontStretch)() PURE;

    STDMETHOD_(FLOAT, GetFontSize)() PURE;

    STDMETHOD_(UINT32, GetLocaleNameLength)() PURE;

    STDMETHOD(GetLocaleName)(
        _Out_writes_z_(nameSize) WCHAR* localeName,
        UINT32 nameSize
        ) PURE;
};


interface DWRITE_DECLARE_INTERFACE("55f1112b-1dc2-4b3c-9541-f46894ed85b6") IDWriteTypography : public IUnknown
{
    STDMETHOD(AddFontFeature)(
        DWRITE_FONT_FEATURE fontFeature
        ) PURE;

    STDMETHOD_(UINT32, GetFontFeatureCount)() PURE;

    STDMETHOD(GetFontFeature)(
        UINT32 fontFeatureIndex,
        _Out_ DWRITE_FONT_FEATURE* fontFeature
        ) PURE;
};

enum DWRITE_SCRIPT_SHAPES
{
    DWRITE_SCRIPT_SHAPES_DEFAULT = 0,

    DWRITE_SCRIPT_SHAPES_NO_VISUAL = 1
};

#ifdef DEFINE_ENUM_FLAG_OPERATORS
DEFINE_ENUM_FLAG_OPERATORS(DWRITE_SCRIPT_SHAPES);
#endif

struct DWRITE_SCRIPT_ANALYSIS
{
    UINT16 script;

    DWRITE_SCRIPT_SHAPES shapes;
};

enum DWRITE_BREAK_CONDITION
{
    DWRITE_BREAK_CONDITION_NEUTRAL,

    DWRITE_BREAK_CONDITION_CAN_BREAK,

    DWRITE_BREAK_CONDITION_MAY_NOT_BREAK,

    DWRITE_BREAK_CONDITION_MUST_BREAK
};

struct DWRITE_LINE_BREAKPOINT
{
    UINT8 breakConditionBefore  : 2;

    UINT8 breakConditionAfter   : 2;

    UINT8 isWhitespace          : 1;

    UINT8 isSoftHyphen          : 1;

    UINT8 padding               : 2;
};

enum DWRITE_NUMBER_SUBSTITUTION_METHOD
{
    DWRITE_NUMBER_SUBSTITUTION_METHOD_FROM_CULTURE,

    DWRITE_NUMBER_SUBSTITUTION_METHOD_CONTEXTUAL,

    DWRITE_NUMBER_SUBSTITUTION_METHOD_NONE,

    DWRITE_NUMBER_SUBSTITUTION_METHOD_NATIONAL,

    DWRITE_NUMBER_SUBSTITUTION_METHOD_TRADITIONAL
};

interface DWRITE_DECLARE_INTERFACE("14885CC9-BAB0-4f90-B6ED-5C366A2CD03D") IDWriteNumberSubstitution : public IUnknown
{
};

struct DWRITE_SHAPING_TEXT_PROPERTIES
{
    UINT16  isShapedAlone       : 1;

    UINT16  reserved            : 15;
};

struct DWRITE_SHAPING_GLYPH_PROPERTIES
{
    UINT16  justification       : 4;

    UINT16  isClusterStart      : 1;

    UINT16  isDiacritic         : 1;

    UINT16  isZeroWidthSpace    : 1;

    UINT16  reserved            : 9;
};

interface DWRITE_DECLARE_INTERFACE("688e1a58-5094-47c8-adc8-fbcea60ae92b") IDWriteTextAnalysisSource : public IUnknown
{
    STDMETHOD(GetTextAtPosition)(
        UINT32 textPosition,
        _Outptr_result_buffer_(*textLength) WCHAR const** textString,
        _Out_ UINT32* textLength
        ) PURE;

    STDMETHOD(GetTextBeforePosition)(
        UINT32 textPosition,
        _Outptr_result_buffer_(*textLength) WCHAR const** textString,
        _Out_ UINT32* textLength
        ) PURE;

    STDMETHOD_(DWRITE_READING_DIRECTION, GetParagraphReadingDirection)() PURE;

    STDMETHOD(GetLocaleName)(
        UINT32 textPosition,
        _Out_ UINT32* textLength,
        _Outptr_result_z_ WCHAR const** localeName
        ) PURE;

    STDMETHOD(GetNumberSubstitution)(
        UINT32 textPosition,
        _Out_ UINT32* textLength,
        _COM_Outptr_ IDWriteNumberSubstitution** numberSubstitution
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("5810cd44-0ca0-4701-b3fa-bec5182ae4f6") IDWriteTextAnalysisSink : public IUnknown
{
    STDMETHOD(SetScriptAnalysis)(
        UINT32 textPosition,
        UINT32 textLength,
        _In_ DWRITE_SCRIPT_ANALYSIS const* scriptAnalysis
        ) PURE;

    STDMETHOD(SetLineBreakpoints)(
        UINT32 textPosition,
        UINT32 textLength,
        _In_reads_(textLength) DWRITE_LINE_BREAKPOINT const* lineBreakpoints
        ) PURE;

    STDMETHOD(SetBidiLevel)(
        UINT32 textPosition,
        UINT32 textLength,
        UINT8 explicitLevel,
        UINT8 resolvedLevel
        ) PURE;

    STDMETHOD(SetNumberSubstitution)(
        UINT32 textPosition,
        UINT32 textLength,
        _In_ IDWriteNumberSubstitution* numberSubstitution
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("b7e6163e-7f46-43b4-84b3-e4e6249c365d") IDWriteTextAnalyzer : public IUnknown
{
    STDMETHOD(AnalyzeScript)(
        _In_ IDWriteTextAnalysisSource* analysisSource,
        UINT32 textPosition,
        UINT32 textLength,
        _In_ IDWriteTextAnalysisSink* analysisSink
        ) PURE;

    STDMETHOD(AnalyzeBidi)(
        _In_ IDWriteTextAnalysisSource* analysisSource,
        UINT32 textPosition,
        UINT32 textLength,
        _In_ IDWriteTextAnalysisSink* analysisSink
        ) PURE;

    STDMETHOD(AnalyzeNumberSubstitution)(
        _In_ IDWriteTextAnalysisSource* analysisSource,
        UINT32 textPosition,
        UINT32 textLength,
        _In_ IDWriteTextAnalysisSink* analysisSink
        ) PURE;

    STDMETHOD(AnalyzeLineBreakpoints)(
        _In_ IDWriteTextAnalysisSource* analysisSource,
        UINT32 textPosition,
        UINT32 textLength,
        _In_ IDWriteTextAnalysisSink* analysisSink
        ) PURE;

    STDMETHOD(GetGlyphs)(
        _In_reads_(textLength) WCHAR const* textString,
        UINT32 textLength,
        _In_ IDWriteFontFace* fontFace,
        BOOL isSideways,
        BOOL isRightToLeft,
        _In_ DWRITE_SCRIPT_ANALYSIS const* scriptAnalysis,
        _In_opt_z_ WCHAR const* localeName,
        _In_opt_ IDWriteNumberSubstitution* numberSubstitution,
        _In_reads_opt_(featureRanges) DWRITE_TYPOGRAPHIC_FEATURES const** features,
        _In_reads_opt_(featureRanges) UINT32 const* featureRangeLengths,
        UINT32 featureRanges,
        UINT32 maxGlyphCount,
        _Out_writes_(textLength) UINT16* clusterMap,
        _Out_writes_(textLength) DWRITE_SHAPING_TEXT_PROPERTIES* textProps,
        _Out_writes_(maxGlyphCount) UINT16* glyphIndices,
        _Out_writes_(maxGlyphCount) DWRITE_SHAPING_GLYPH_PROPERTIES* glyphProps,
        _Out_ UINT32* actualGlyphCount
        ) PURE;

    STDMETHOD(GetGlyphPlacements)(
        _In_reads_(textLength) WCHAR const* textString,
        _In_reads_(textLength) UINT16 const* clusterMap,
        _In_reads_(textLength) DWRITE_SHAPING_TEXT_PROPERTIES* textProps,
        UINT32 textLength,
        _In_reads_(glyphCount) UINT16 const* glyphIndices,
        _In_reads_(glyphCount) DWRITE_SHAPING_GLYPH_PROPERTIES const* glyphProps,
        UINT32 glyphCount,
        _In_ IDWriteFontFace* fontFace,
        FLOAT fontEmSize,
        BOOL isSideways,
        BOOL isRightToLeft,
        _In_ DWRITE_SCRIPT_ANALYSIS const* scriptAnalysis,
        _In_opt_z_ WCHAR const* localeName,
        _In_reads_opt_(featureRanges) DWRITE_TYPOGRAPHIC_FEATURES const** features,
        _In_reads_opt_(featureRanges) UINT32 const* featureRangeLengths,
        UINT32 featureRanges,
        _Out_writes_(glyphCount) FLOAT* glyphAdvances,
        _Out_writes_(glyphCount) DWRITE_GLYPH_OFFSET* glyphOffsets
        ) PURE;

    STDMETHOD(GetGdiCompatibleGlyphPlacements)(
        _In_reads_(textLength) WCHAR const* textString,
        _In_reads_(textLength) UINT16 const* clusterMap,
        _In_reads_(textLength) DWRITE_SHAPING_TEXT_PROPERTIES* textProps,
        UINT32 textLength,
        _In_reads_(glyphCount) UINT16 const* glyphIndices,
        _In_reads_(glyphCount) DWRITE_SHAPING_GLYPH_PROPERTIES const* glyphProps,
        UINT32 glyphCount,
        _In_ IDWriteFontFace * fontFace,
        FLOAT fontEmSize,
        FLOAT pixelsPerDip,
        _In_opt_ DWRITE_MATRIX const* transform,
        BOOL useGdiNatural,
        BOOL isSideways,
        BOOL isRightToLeft,
        _In_ DWRITE_SCRIPT_ANALYSIS const* scriptAnalysis,
        _In_opt_z_ WCHAR const* localeName,
        _In_reads_opt_(featureRanges) DWRITE_TYPOGRAPHIC_FEATURES const** features,
        _In_reads_opt_(featureRanges) UINT32 const* featureRangeLengths,
        UINT32 featureRanges,
        _Out_writes_(glyphCount) FLOAT* glyphAdvances,
        _Out_writes_(glyphCount) DWRITE_GLYPH_OFFSET* glyphOffsets
        ) PURE;
};

struct DWRITE_GLYPH_RUN
{
    _Notnull_ IDWriteFontFace* fontFace;

    FLOAT fontEmSize;

    UINT32 glyphCount;

    _Field_size_(glyphCount) UINT16 const* glyphIndices;

    _Field_size_opt_(glyphCount) FLOAT const* glyphAdvances;

    _Field_size_opt_(glyphCount) DWRITE_GLYPH_OFFSET const* glyphOffsets;

    BOOL isSideways;

    UINT32 bidiLevel;
};

struct DWRITE_GLYPH_RUN_DESCRIPTION
{
    _Field_z_ WCHAR const* localeName;

    _Field_size_(stringLength) WCHAR const* string;

    UINT32 stringLength;

    _Field_size_opt_(stringLength) UINT16 const* clusterMap;

    UINT32 textPosition;
};

struct DWRITE_UNDERLINE
{
    FLOAT width;

    FLOAT thickness;

    FLOAT offset;

    FLOAT runHeight;

    DWRITE_READING_DIRECTION readingDirection;

    DWRITE_FLOW_DIRECTION flowDirection;

    _Field_z_ WCHAR const* localeName;

    DWRITE_MEASURING_MODE measuringMode;
};

struct DWRITE_STRIKETHROUGH
{
    FLOAT width;

    FLOAT thickness;

    FLOAT offset;

    DWRITE_READING_DIRECTION readingDirection;

    DWRITE_FLOW_DIRECTION flowDirection;

    _Field_z_ WCHAR const* localeName;

    DWRITE_MEASURING_MODE measuringMode;
};

struct DWRITE_LINE_METRICS
{
    UINT32 length;

    UINT32 trailingWhitespaceLength;

    UINT32 newlineLength;

    FLOAT height;

    FLOAT baseline;

    BOOL isTrimmed;
};


struct DWRITE_CLUSTER_METRICS
{
    FLOAT width;

    UINT16 length;

    UINT16 canWrapLineAfter : 1;

    UINT16 isWhitespace : 1;

    UINT16 isNewline : 1;

    UINT16 isSoftHyphen : 1;

    UINT16 isRightToLeft : 1;

    UINT16 padding : 11;
};


struct DWRITE_TEXT_METRICS
{
    FLOAT left;

    FLOAT top;

    FLOAT width;

    FLOAT widthIncludingTrailingWhitespace;

    FLOAT height;

    FLOAT layoutWidth;

    FLOAT layoutHeight;

    UINT32 maxBidiReorderingDepth;

    UINT32 lineCount;
};


struct DWRITE_INLINE_OBJECT_METRICS
{
    FLOAT width;

    FLOAT height;

    FLOAT baseline;

    BOOL  supportsSideways;
};


struct DWRITE_OVERHANG_METRICS
{
    FLOAT left;

    FLOAT top;

    FLOAT right;

    FLOAT bottom;
};


struct DWRITE_HIT_TEST_METRICS
{
    UINT32 textPosition;

    UINT32 length;

    FLOAT left;

    FLOAT top;

    FLOAT width;

    FLOAT height;

    UINT32 bidiLevel;

    BOOL isText;

    BOOL isTrimmed;
};


interface IDWriteTextRenderer;


interface DWRITE_DECLARE_INTERFACE("8339FDE3-106F-47ab-8373-1C6295EB10B3") IDWriteInlineObject : public IUnknown
{
    STDMETHOD(Draw)(
        _In_opt_ void* clientDrawingContext,
        _In_ IDWriteTextRenderer* renderer,
        FLOAT originX,
        FLOAT originY,
        BOOL isSideways,
        BOOL isRightToLeft,
        _In_opt_ IUnknown* clientDrawingEffect
        ) PURE;

    STDMETHOD(GetMetrics)(
        _Out_ DWRITE_INLINE_OBJECT_METRICS* metrics
        ) PURE;

    STDMETHOD(GetOverhangMetrics)(
        _Out_ DWRITE_OVERHANG_METRICS* overhangs
        ) PURE;

    STDMETHOD(GetBreakConditions)(
        _Out_ DWRITE_BREAK_CONDITION* breakConditionBefore,
        _Out_ DWRITE_BREAK_CONDITION* breakConditionAfter
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("eaf3a2da-ecf4-4d24-b644-b34f6842024b") IDWritePixelSnapping : public IUnknown
{
    STDMETHOD(IsPixelSnappingDisabled)(
        _In_opt_ void* clientDrawingContext,
        _Out_ BOOL* isDisabled
        ) PURE;

    STDMETHOD(GetCurrentTransform)(
        _In_opt_ void* clientDrawingContext,
        _Out_ DWRITE_MATRIX* transform
        ) PURE;

    STDMETHOD(GetPixelsPerDip)(
        _In_opt_ void* clientDrawingContext,
        _Out_ FLOAT* pixelsPerDip
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("ef8a8135-5cc6-45fe-8825-c5a0724eb819") IDWriteTextRenderer : public IDWritePixelSnapping
{
    STDMETHOD(DrawGlyphRun)(
        _In_opt_ void* clientDrawingContext,
        FLOAT baselineOriginX,
        FLOAT baselineOriginY,
        DWRITE_MEASURING_MODE measuringMode,
        _In_ DWRITE_GLYPH_RUN const* glyphRun,
        _In_ DWRITE_GLYPH_RUN_DESCRIPTION const* glyphRunDescription,
        _In_opt_ IUnknown* clientDrawingEffect
        ) PURE;

    STDMETHOD(DrawUnderline)(
        _In_opt_ void* clientDrawingContext,
        FLOAT baselineOriginX,
        FLOAT baselineOriginY,
        _In_ DWRITE_UNDERLINE const* underline,
        _In_opt_ IUnknown* clientDrawingEffect
        ) PURE;

    STDMETHOD(DrawStrikethrough)(
        _In_opt_ void* clientDrawingContext,
        FLOAT baselineOriginX,
        FLOAT baselineOriginY,
        _In_ DWRITE_STRIKETHROUGH const* strikethrough,
        _In_opt_ IUnknown* clientDrawingEffect
        ) PURE;

    STDMETHOD(DrawInlineObject)(
        _In_opt_ void* clientDrawingContext,
        FLOAT originX,
        FLOAT originY,
        _In_ IDWriteInlineObject* inlineObject,
        BOOL isSideways,
        BOOL isRightToLeft,
        _In_opt_ IUnknown* clientDrawingEffect
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("53737037-6d14-410b-9bfe-0b182bb70961") IDWriteTextLayout : public IDWriteTextFormat
{
    STDMETHOD(SetMaxWidth)(
        FLOAT maxWidth
        ) PURE;

    STDMETHOD(SetMaxHeight)(
        FLOAT maxHeight
        ) PURE;

    STDMETHOD(SetFontCollection)(
        _In_ IDWriteFontCollection* fontCollection,
        DWRITE_TEXT_RANGE textRange
        ) PURE;

    STDMETHOD(SetFontFamilyName)(
        _In_z_ WCHAR const* fontFamilyName,
        DWRITE_TEXT_RANGE textRange
        ) PURE;

    STDMETHOD(SetFontWeight)(
        DWRITE_FONT_WEIGHT fontWeight,
        DWRITE_TEXT_RANGE textRange
        ) PURE;

    STDMETHOD(SetFontStyle)(
        DWRITE_FONT_STYLE fontStyle,
        DWRITE_TEXT_RANGE textRange
        ) PURE;

    STDMETHOD(SetFontStretch)(
        DWRITE_FONT_STRETCH fontStretch,
        DWRITE_TEXT_RANGE textRange
        ) PURE;

    STDMETHOD(SetFontSize)(
        FLOAT fontSize,
        DWRITE_TEXT_RANGE textRange
        ) PURE;

    STDMETHOD(SetUnderline)(
        BOOL hasUnderline,
        DWRITE_TEXT_RANGE textRange
        ) PURE;

    STDMETHOD(SetStrikethrough)(
        BOOL hasStrikethrough,
        DWRITE_TEXT_RANGE textRange
        ) PURE;

    STDMETHOD(SetDrawingEffect)(
        IUnknown* drawingEffect,
        DWRITE_TEXT_RANGE textRange
        ) PURE;

    STDMETHOD(SetInlineObject)(
        _In_ IDWriteInlineObject* inlineObject,
        DWRITE_TEXT_RANGE textRange
        ) PURE;

    STDMETHOD(SetTypography)(
        _In_ IDWriteTypography* typography,
        DWRITE_TEXT_RANGE textRange
        ) PURE;

    STDMETHOD(SetLocaleName)(
        _In_z_ WCHAR const* localeName,
        DWRITE_TEXT_RANGE textRange
        ) PURE;

    STDMETHOD_(FLOAT, GetMaxWidth)() PURE;

    STDMETHOD_(FLOAT, GetMaxHeight)() PURE;

    STDMETHOD(GetFontCollection)(
        UINT32 currentPosition,
        _COM_Outptr_ IDWriteFontCollection** fontCollection,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(GetFontFamilyNameLength)(
        UINT32 currentPosition,
        _Out_ UINT32* nameLength,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(GetFontFamilyName)(
        UINT32 currentPosition,
        _Out_writes_z_(nameSize) WCHAR* fontFamilyName,
        UINT32 nameSize,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(GetFontWeight)(
        UINT32 currentPosition,
        _Out_ DWRITE_FONT_WEIGHT* fontWeight,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(GetFontStyle)(
        UINT32 currentPosition,
        _Out_ DWRITE_FONT_STYLE* fontStyle,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(GetFontStretch)(
        UINT32 currentPosition,
        _Out_ DWRITE_FONT_STRETCH* fontStretch,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(GetFontSize)(
        UINT32 currentPosition,
        _Out_ FLOAT* fontSize,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(GetUnderline)(
        UINT32 currentPosition,
        _Out_ BOOL* hasUnderline,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(GetStrikethrough)(
        UINT32 currentPosition,
        _Out_ BOOL* hasStrikethrough,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(GetDrawingEffect)(
        UINT32 currentPosition,
        _COM_Outptr_ IUnknown** drawingEffect,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(GetInlineObject)(
        UINT32 currentPosition,
        _COM_Outptr_ IDWriteInlineObject** inlineObject,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(GetTypography)(
        UINT32 currentPosition,
        _COM_Outptr_ IDWriteTypography** typography,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(GetLocaleNameLength)(
        UINT32 currentPosition,
        _Out_ UINT32* nameLength,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(GetLocaleName)(
        UINT32 currentPosition,
        _Out_writes_z_(nameSize) WCHAR* localeName,
        UINT32 nameSize,
        _Out_opt_ DWRITE_TEXT_RANGE* textRange = NULL
        ) PURE;

    STDMETHOD(Draw)(
        _In_opt_ void* clientDrawingContext,
        _In_ IDWriteTextRenderer* renderer,
        FLOAT originX,
        FLOAT originY
        ) PURE;

    STDMETHOD(GetLineMetrics)(
        _Out_writes_opt_(maxLineCount) DWRITE_LINE_METRICS* lineMetrics,
        UINT32 maxLineCount,
        _Out_ UINT32* actualLineCount
        ) PURE;

    STDMETHOD(GetMetrics)(
        _Out_ DWRITE_TEXT_METRICS* textMetrics
        ) PURE;

    STDMETHOD(GetOverhangMetrics)(
        _Out_ DWRITE_OVERHANG_METRICS* overhangs
        ) PURE;

    STDMETHOD(GetClusterMetrics)(
        _Out_writes_opt_(maxClusterCount) DWRITE_CLUSTER_METRICS* clusterMetrics,
        UINT32 maxClusterCount,
        _Out_ UINT32* actualClusterCount
        ) PURE;

    STDMETHOD(DetermineMinWidth)(
        _Out_ FLOAT* minWidth
        ) PURE;

    STDMETHOD(HitTestPoint)(
        FLOAT pointX,
        FLOAT pointY,
        _Out_ BOOL* isTrailingHit,
        _Out_ BOOL* isInside,
        _Out_ DWRITE_HIT_TEST_METRICS* hitTestMetrics
        ) PURE;

    STDMETHOD(HitTestTextPosition)(
        UINT32 textPosition,
        BOOL isTrailingHit,
        _Out_ FLOAT* pointX,
        _Out_ FLOAT* pointY,
        _Out_ DWRITE_HIT_TEST_METRICS* hitTestMetrics
        ) PURE;

    STDMETHOD(HitTestTextRange)(
        UINT32 textPosition,
        UINT32 textLength,
        FLOAT originX,
        FLOAT originY,
        _Out_writes_opt_(maxHitTestMetricsCount) DWRITE_HIT_TEST_METRICS* hitTestMetrics,
        UINT32 maxHitTestMetricsCount,
        _Out_ UINT32* actualHitTestMetricsCount
        ) PURE;

    using IDWriteTextFormat::GetFontCollection;
    using IDWriteTextFormat::GetFontFamilyNameLength;
    using IDWriteTextFormat::GetFontFamilyName;
    using IDWriteTextFormat::GetFontWeight;
    using IDWriteTextFormat::GetFontStyle;
    using IDWriteTextFormat::GetFontStretch;
    using IDWriteTextFormat::GetFontSize;
    using IDWriteTextFormat::GetLocaleNameLength;
    using IDWriteTextFormat::GetLocaleName;
};


interface DWRITE_DECLARE_INTERFACE("5e5a32a3-8dff-4773-9ff6-0696eab77267") IDWriteBitmapRenderTarget : public IUnknown
{
    STDMETHOD(DrawGlyphRun)(
        FLOAT baselineOriginX,
        FLOAT baselineOriginY,
        DWRITE_MEASURING_MODE measuringMode,
        _In_ DWRITE_GLYPH_RUN const* glyphRun,
        _In_ IDWriteRenderingParams* renderingParams,
        COLORREF textColor,
        _Out_opt_ RECT* blackBoxRect = NULL
        ) PURE;

    STDMETHOD_(HDC, GetMemoryDC)() PURE;

    STDMETHOD_(FLOAT, GetPixelsPerDip)() PURE;

    STDMETHOD(SetPixelsPerDip)(
        FLOAT pixelsPerDip
        ) PURE;

    STDMETHOD(GetCurrentTransform)(
        _Out_ DWRITE_MATRIX* transform
        ) PURE;

    STDMETHOD(SetCurrentTransform)(
        _In_opt_ DWRITE_MATRIX const* transform
        ) PURE;

    STDMETHOD(GetSize)(
        _Out_ SIZE* size
        ) PURE;

    STDMETHOD(Resize)(
        UINT32 width,
        UINT32 height
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("1edd9491-9853-4299-898f-6432983b6f3a") IDWriteGdiInterop : public IUnknown
{
    STDMETHOD(CreateFontFromLOGFONT)(
        _In_ LOGFONTW const* logFont,
        _COM_Outptr_ IDWriteFont** font
        ) PURE;

    STDMETHOD(ConvertFontToLOGFONT)(
        _In_ IDWriteFont* font,
        _Out_ LOGFONTW* logFont,
        _Out_ BOOL* isSystemFont
        ) PURE;

    STDMETHOD(ConvertFontFaceToLOGFONT)(
        _In_ IDWriteFontFace* font,
        _Out_ LOGFONTW* logFont
        ) PURE;

    STDMETHOD(CreateFontFaceFromHdc)(
        HDC hdc,
        _COM_Outptr_ IDWriteFontFace** fontFace
        ) PURE;

    STDMETHOD(CreateBitmapRenderTarget)(
        _In_opt_ HDC hdc,
        UINT32 width,
        UINT32 height,
        _COM_Outptr_ IDWriteBitmapRenderTarget** renderTarget
        ) PURE;
};

enum DWRITE_TEXTURE_TYPE
{
    DWRITE_TEXTURE_ALIASED_1x1,

    DWRITE_TEXTURE_CLEARTYPE_3x1
};

#define DWRITE_ALPHA_MAX 255

interface DWRITE_DECLARE_INTERFACE("7d97dbf7-e085-42d4-81e3-6a883bded118") IDWriteGlyphRunAnalysis : public IUnknown
{
    STDMETHOD(GetAlphaTextureBounds)(
        DWRITE_TEXTURE_TYPE textureType,
        _Out_ RECT* textureBounds
        ) PURE;

    STDMETHOD(CreateAlphaTexture)(
        DWRITE_TEXTURE_TYPE textureType,
        _In_ RECT const* textureBounds,
        _Out_writes_bytes_(bufferSize) BYTE* alphaValues,
        UINT32 bufferSize
        ) PURE;

    STDMETHOD(GetAlphaBlendParams)(
        _In_ IDWriteRenderingParams* renderingParams,
        _Out_ FLOAT* blendGamma,
        _Out_ FLOAT* blendEnhancedContrast,
        _Out_ FLOAT* blendClearTypeLevel
        ) PURE;
};

interface DWRITE_DECLARE_INTERFACE("b859ee5a-d838-4b5b-a2e8-1adc7d93db48") IDWriteFactory : public IUnknown
{
    STDMETHOD(GetSystemFontCollection)(
        _COM_Outptr_ IDWriteFontCollection** fontCollection,
        BOOL checkForUpdates = FALSE
        ) PURE;

    STDMETHOD(CreateCustomFontCollection)(
        _In_ IDWriteFontCollectionLoader* collectionLoader,
        _In_reads_bytes_(collectionKeySize) void const* collectionKey,
        UINT32 collectionKeySize,
        _COM_Outptr_ IDWriteFontCollection** fontCollection
        ) PURE;

    STDMETHOD(RegisterFontCollectionLoader)(
        _In_ IDWriteFontCollectionLoader* fontCollectionLoader
        ) PURE;

    STDMETHOD(UnregisterFontCollectionLoader)(
        _In_ IDWriteFontCollectionLoader* fontCollectionLoader
        ) PURE;

    STDMETHOD(CreateFontFileReference)(
        _In_z_ WCHAR const* filePath,
        _In_opt_ FILETIME const* lastWriteTime,
        _COM_Outptr_ IDWriteFontFile** fontFile
        ) PURE;

    STDMETHOD(CreateCustomFontFileReference)(
        _In_reads_bytes_(fontFileReferenceKeySize) void const* fontFileReferenceKey,
        UINT32 fontFileReferenceKeySize,
        _In_ IDWriteFontFileLoader* fontFileLoader,
        _COM_Outptr_ IDWriteFontFile** fontFile
        ) PURE;

    STDMETHOD(CreateFontFace)(
        DWRITE_FONT_FACE_TYPE fontFaceType,
        UINT32 numberOfFiles,
        _In_reads_(numberOfFiles) IDWriteFontFile* const* fontFiles,
        UINT32 faceIndex,
        DWRITE_FONT_SIMULATIONS fontFaceSimulationFlags,
        _COM_Outptr_ IDWriteFontFace** fontFace
        ) PURE;

    STDMETHOD(CreateRenderingParams)(
        _COM_Outptr_ IDWriteRenderingParams** renderingParams
        ) PURE;

    STDMETHOD(CreateMonitorRenderingParams)(
        HMONITOR monitor,
        _COM_Outptr_ IDWriteRenderingParams** renderingParams
        ) PURE;

    STDMETHOD(CreateCustomRenderingParams)(
        FLOAT gamma,
        FLOAT enhancedContrast,
        FLOAT clearTypeLevel,
        DWRITE_PIXEL_GEOMETRY pixelGeometry,
        DWRITE_RENDERING_MODE renderingMode,
        _COM_Outptr_ IDWriteRenderingParams** renderingParams
        ) PURE;

    STDMETHOD(RegisterFontFileLoader)(
        _In_ IDWriteFontFileLoader* fontFileLoader
        ) PURE;

    STDMETHOD(UnregisterFontFileLoader)(
        _In_ IDWriteFontFileLoader* fontFileLoader
        ) PURE;

    STDMETHOD(CreateTextFormat)(
        _In_z_ WCHAR const* fontFamilyName,
        _In_opt_ IDWriteFontCollection* fontCollection,
        DWRITE_FONT_WEIGHT fontWeight,
        DWRITE_FONT_STYLE fontStyle,
        DWRITE_FONT_STRETCH fontStretch,
        FLOAT fontSize,
        _In_z_ WCHAR const* localeName,
        _COM_Outptr_ IDWriteTextFormat** textFormat
        ) PURE;

    STDMETHOD(CreateTypography)(
        _COM_Outptr_ IDWriteTypography** typography
        ) PURE;

    STDMETHOD(GetGdiInterop)(
        _COM_Outptr_ IDWriteGdiInterop** gdiInterop
        ) PURE;

    STDMETHOD(CreateTextLayout)(
        _In_reads_(stringLength) WCHAR const* string,
        UINT32 stringLength,
        _In_ IDWriteTextFormat* textFormat,
        FLOAT maxWidth,
        FLOAT maxHeight,
        _COM_Outptr_ IDWriteTextLayout** textLayout
        ) PURE;

    STDMETHOD(CreateGdiCompatibleTextLayout)(
        _In_reads_(stringLength) WCHAR const* string,
        UINT32 stringLength,
        _In_ IDWriteTextFormat* textFormat,
        FLOAT layoutWidth,
        FLOAT layoutHeight,
        FLOAT pixelsPerDip,
        _In_opt_ DWRITE_MATRIX const* transform,
        BOOL useGdiNatural,
        _COM_Outptr_ IDWriteTextLayout** textLayout
        ) PURE;

    STDMETHOD(CreateEllipsisTrimmingSign)(
        _In_ IDWriteTextFormat* textFormat,
        _COM_Outptr_ IDWriteInlineObject** trimmingSign
        ) PURE;

    STDMETHOD(CreateTextAnalyzer)(
        _COM_Outptr_ IDWriteTextAnalyzer** textAnalyzer
        ) PURE;

    STDMETHOD(CreateNumberSubstitution)(
        _In_ DWRITE_NUMBER_SUBSTITUTION_METHOD substitutionMethod,
        _In_z_ WCHAR const* localeName,
        _In_ BOOL ignoreUserOverride,
        _COM_Outptr_ IDWriteNumberSubstitution** numberSubstitution
        ) PURE;

    STDMETHOD(CreateGlyphRunAnalysis)(
        _In_ DWRITE_GLYPH_RUN const* glyphRun,
        FLOAT pixelsPerDip,
        _In_opt_ DWRITE_MATRIX const* transform,
        DWRITE_RENDERING_MODE renderingMode,
        DWRITE_MEASURING_MODE measuringMode,
        FLOAT baselineOriginX,
        FLOAT baselineOriginY,
        _COM_Outptr_ IDWriteGlyphRunAnalysis** glyphRunAnalysis
        ) PURE;

}; // interface IDWriteFactory


EXTERN_C HRESULT DWRITE_EXPORT DWriteCreateFactory(
    _In_ DWRITE_FACTORY_TYPE factoryType,
    _In_ REFIID iid,
    _COM_Outptr_ IUnknown **factory
    );

// Macros used to define DirectWrite error codes.
#define FACILITY_DWRITE 0x898
#define DWRITE_ERR_BASE 0x5000
#define MAKE_DWRITE_HR(severity, code) MAKE_HRESULT(severity, FACILITY_DWRITE, (DWRITE_ERR_BASE + code))
#define MAKE_DWRITE_HR_ERR(code) MAKE_DWRITE_HR(SEVERITY_ERROR, code)

// DWrite errors have moved to winerror.h


#endif /* DWRITE_H_INCLUDED */