Text API

Fonts & Text support.

Classes

struct BLFontCore

class BLFont

struct BLFontTable

struct BLFontDataCore

class BLFontData

struct BLGlyphInfo

struct BLGlyphPlacement

struct BLGlyphMappingState

struct BLGlyphOutlineSinkInfo

struct BLFontUnicodeCoverage

struct BLFontPanose

struct BLFontMatrix

struct BLFontMetrics

struct BLFontDesignMetrics

struct BLTextMetrics

struct BLFontFaceInfo

struct BLFontFaceCore

class BLFontFace

struct BLFontFeatureItem

struct BLFontFeatureSettingsView

struct BLFontFeatureSettingsCore

class BLFontFeatureSettings

struct BLFontQueryProperties

struct BLFontManagerCore

class BLFontManager

struct BLFontVariationItem

struct BLFontVariationSettingsView

struct BLFontVariationSettingsCore

class BLFontVariationSettings

struct BLGlyphBufferImpl

struct BLGlyphBufferCore

class BLGlyphBuffer

struct BLGlyphRun

class BLGlyphRunIterator

Enumerations

enum BLTextEncoding : uint32_t

BLFontData - Constants

enum BLFontDataFlags : uint32_t

BLFont Related Constants

enum BLOrientation : uint32_t

enum BLFontFaceType : uint32_t

enum BLFontStretch : uint32_t

enum BLFontStyle : uint32_t

enum BLFontWeight : uint32_t

enum BLFontStringId : uint32_t

enum BLFontUnicodeCoverageIndex : uint32_t

enum BLTextDirection : uint32_t

BLFontFace - Constants

enum BLFontFaceFlags : uint32_t

enum BLFontFaceDiagFlags : uint32_t

enum BLFontOutlineType : uint32_t

BLGlyphRun - Constants

enum BLGlyphRunFlags : uint32_t

enum BLGlyphPlacementType : uint32_t

BLFont Related Types

typedef uint32_t BLGlyphId

BLFontFeatureSettings - Constants

static constexpr uint32_t BL_FONT_FEATURE_INVALID_VALUE = 0xFFFFFFFFu

BLFont - C API

BLResult blFontInit(BLFontCore* self)

BLResult blFontInitMove(BLFontCore* self, BLFontCore* other)

BLResult blFontInitWeak(BLFontCore* self, const BLFontCore* other)

BLResult blFontDestroy(BLFontCore* self)

BLResult blFontReset(BLFontCore* self)

BLResult blFontAssignMove(BLFontCore* self, BLFontCore* other)

BLResult blFontAssignWeak(BLFontCore* self, const BLFontCore* other)

bool blFontEquals(const BLFontCore* a, const BLFontCore* b)

BLResult blFontCreateFromFace(BLFontCore* self, const BLFontFaceCore* face, float size)

BLResult blFontCreateFromFaceWithSettings(BLFontCore* self, const BLFontFaceCore* face, float size, const BLFontFeatureSettingsCore* featureSettings, const BLFontVariationSettingsCore* variationSettings)

BLResult blFontGetFace(const BLFontCore* self, BLFontFaceCore* out)

float blFontGetSize(const BLFontCore* self)

BLResult blFontSetSize(BLFontCore* self, float size)

BLResult blFontGetMetrics(const BLFontCore* self, BLFontMetrics* out)

BLResult blFontGetMatrix(const BLFontCore* self, BLFontMatrix* out)

BLResult blFontGetDesignMetrics(const BLFontCore* self, BLFontDesignMetrics* out)

BLResult blFontGetFeatureSettings(const BLFontCore* self, BLFontFeatureSettingsCore* out)

BLResult blFontSetFeatureSettings(BLFontCore* self, const BLFontFeatureSettingsCore* featureSettings)

BLResult blFontResetFeatureSettings(BLFontCore* self)

BLResult blFontGetVariationSettings(const BLFontCore* self, BLFontVariationSettingsCore* out)

BLResult blFontSetVariationSettings(BLFontCore* self, const BLFontVariationSettingsCore* variationSettings)

BLResult blFontResetVariationSettings(BLFontCore* self)

BLResult blFontShape(const BLFontCore* self, BLGlyphBufferCore* gb)

BLResult blFontMapTextToGlyphs(const BLFontCore* self, BLGlyphBufferCore* gb, BLGlyphMappingState* stateOut)

BLResult blFontPositionGlyphs(const BLFontCore* self, BLGlyphBufferCore* gb)

BLResult blFontApplyKerning(const BLFontCore* self, BLGlyphBufferCore* gb)

BLResult blFontApplyGSub(const BLFontCore* self, BLGlyphBufferCore* gb, const BLBitArrayCore* lookups)

BLResult blFontApplyGPos(const BLFontCore* self, BLGlyphBufferCore* gb, const BLBitArrayCore* lookups)

BLResult blFontGetTextMetrics(const BLFontCore* self, BLGlyphBufferCore* gb, BLTextMetrics* out)

BLResult blFontGetGlyphBounds(const BLFontCore* self, const uint32_t* glyphData, intptr_t glyphAdvance, BLBoxI* out, size_t count)

BLResult blFontGetGlyphAdvances(const BLFontCore* self, const uint32_t* glyphData, intptr_t glyphAdvance, BLGlyphPlacement* out, size_t count)

BLResult blFontGetGlyphOutlines(const BLFontCore* self, BLGlyphId glyphId, const BLMatrix2D* userTransform, BLPathCore* out, BLPathSinkFunc sink, void* userData)

BLResult blFontGetGlyphRunOutlines(const BLFontCore* self, const BLGlyphRun* glyphRun, const BLMatrix2D* userTransform, BLPathCore* out, BLPathSinkFunc sink, void* userData)

BLFontData - C API

BLResult blFontDataInit(BLFontDataCore* self)

BLResult blFontDataInitMove(BLFontDataCore* self, BLFontDataCore* other)

BLResult blFontDataInitWeak(BLFontDataCore* self, const BLFontDataCore* other)

BLResult blFontDataDestroy(BLFontDataCore* self)

BLResult blFontDataReset(BLFontDataCore* self)

BLResult blFontDataAssignMove(BLFontDataCore* self, BLFontDataCore* other)

BLResult blFontDataAssignWeak(BLFontDataCore* self, const BLFontDataCore* other)

BLResult blFontDataCreateFromFile(BLFontDataCore* self, const char* fileName, BLFileReadFlags readFlags)

BLResult blFontDataCreateFromDataArray(BLFontDataCore* self, const BLArrayCore* dataArray)

BLResult blFontDataCreateFromData(BLFontDataCore* self, const void* data, size_t dataSize, BLDestroyExternalDataFunc destroyFunc, void* userData)

bool blFontDataEquals(const BLFontDataCore* a, const BLFontDataCore* b)

uint32_t blFontDataGetFaceCount(const BLFontDataCore* self)

BLFontFaceType blFontDataGetFaceType(const BLFontDataCore* self)

BLFontDataFlags blFontDataGetFlags(const BLFontDataCore* self)

BLResult blFontDataGetTableTags(const BLFontDataCore* self, uint32_t faceIndex, BLArrayCore* dst)

size_t blFontDataGetTables(const BLFontDataCore* self, uint32_t faceIndex, BLFontTable* dst, const BLTag* tags, size_t count)

BLFontFace - C API

BLResult blFontFaceInit(BLFontFaceCore* self)

BLResult blFontFaceInitMove(BLFontFaceCore* self, BLFontFaceCore* other)

BLResult blFontFaceInitWeak(BLFontFaceCore* self, const BLFontFaceCore* other)

BLResult blFontFaceDestroy(BLFontFaceCore* self)

BLResult blFontFaceReset(BLFontFaceCore* self)

BLResult blFontFaceAssignMove(BLFontFaceCore* self, BLFontFaceCore* other)

BLResult blFontFaceAssignWeak(BLFontFaceCore* self, const BLFontFaceCore* other)

bool blFontFaceEquals(const BLFontFaceCore* a, const BLFontFaceCore* b)

BLResult blFontFaceCreateFromFile(BLFontFaceCore* self, const char* fileName, BLFileReadFlags readFlags)

BLResult blFontFaceCreateFromData(BLFontFaceCore* self, const BLFontDataCore* fontData, uint32_t faceIndex)

BLResult blFontFaceGetFullName(const BLFontFaceCore* self, BLStringCore* out)

BLResult blFontFaceGetFamilyName(const BLFontFaceCore* self, BLStringCore* out)

BLResult blFontFaceGetSubfamilyName(const BLFontFaceCore* self, BLStringCore* out)

BLResult blFontFaceGetPostScriptName(const BLFontFaceCore* self, BLStringCore* out)

BLResult blFontFaceGetFaceInfo(const BLFontFaceCore* self, BLFontFaceInfo* out)

BLResult blFontFaceGetDesignMetrics(const BLFontFaceCore* self, BLFontDesignMetrics* out)

BLResult blFontFaceGetUnicodeCoverage(const BLFontFaceCore* self, BLFontUnicodeCoverage* out)

BLResult blFontFaceGetCharacterCoverage(const BLFontFaceCore* self, BLBitSetCore* out)

bool blFontFaceHasScriptTag(const BLFontFaceCore* self, BLTag scriptTag)

bool blFontFaceHasFeatureTag(const BLFontFaceCore* self, BLTag featureTag)

bool blFontFaceHasVariationTag(const BLFontFaceCore* self, BLTag variationTag)

BLResult blFontFaceGetScriptTags(const BLFontFaceCore* self, BLArrayCore* out)

BLResult blFontFaceGetFeatureTags(const BLFontFaceCore* self, BLArrayCore* out)

BLResult blFontFaceGetVariationTags(const BLFontFaceCore* self, BLArrayCore* out)

BLFontFeatureSettings - C API

BLResult blFontFeatureSettingsInit(BLFontFeatureSettingsCore* self)

BLResult blFontFeatureSettingsInitMove(BLFontFeatureSettingsCore* self, BLFontFeatureSettingsCore* other)

BLResult blFontFeatureSettingsInitWeak(BLFontFeatureSettingsCore* self, const BLFontFeatureSettingsCore* other)

BLResult blFontFeatureSettingsDestroy(BLFontFeatureSettingsCore* self)

BLResult blFontFeatureSettingsReset(BLFontFeatureSettingsCore* self)

BLResult blFontFeatureSettingsClear(BLFontFeatureSettingsCore* self)

BLResult blFontFeatureSettingsShrink(BLFontFeatureSettingsCore* self)

BLResult blFontFeatureSettingsAssignMove(BLFontFeatureSettingsCore* self, BLFontFeatureSettingsCore* other)

BLResult blFontFeatureSettingsAssignWeak(BLFontFeatureSettingsCore* self, const BLFontFeatureSettingsCore* other)

size_t blFontFeatureSettingsGetSize(const BLFontFeatureSettingsCore* self)

size_t blFontFeatureSettingsGetCapacity(const BLFontFeatureSettingsCore* self)

BLResult blFontFeatureSettingsGetView(const BLFontFeatureSettingsCore* self, BLFontFeatureSettingsView* out)

bool blFontFeatureSettingsHasValue(const BLFontFeatureSettingsCore* self, BLTag featureTag)

uint32_t blFontFeatureSettingsGetValue(const BLFontFeatureSettingsCore* self, BLTag featureTag)

BLResult blFontFeatureSettingsSetValue(BLFontFeatureSettingsCore* self, BLTag featureTag, uint32_t value)

BLResult blFontFeatureSettingsRemoveValue(BLFontFeatureSettingsCore* self, BLTag featureTag)

bool blFontFeatureSettingsEquals(const BLFontFeatureSettingsCore* a, const BLFontFeatureSettingsCore* b)

BLFontManager - C API

BLResult blFontManagerInit(BLFontManagerCore* self)

BLResult blFontManagerInitMove(BLFontManagerCore* self, BLFontManagerCore* other)

BLResult blFontManagerInitWeak(BLFontManagerCore* self, const BLFontManagerCore* other)

BLResult blFontManagerInitNew(BLFontManagerCore* self)

BLResult blFontManagerDestroy(BLFontManagerCore* self)

BLResult blFontManagerReset(BLFontManagerCore* self)

BLResult blFontManagerAssignMove(BLFontManagerCore* self, BLFontManagerCore* other)

BLResult blFontManagerAssignWeak(BLFontManagerCore* self, const BLFontManagerCore* other)

BLResult blFontManagerCreate(BLFontManagerCore* self)

size_t blFontManagerGetFaceCount(const BLFontManagerCore* self)

size_t blFontManagerGetFamilyCount(const BLFontManagerCore* self)

bool blFontManagerHasFace(const BLFontManagerCore* self, const BLFontFaceCore* face)

BLResult blFontManagerAddFace(BLFontManagerCore* self, const BLFontFaceCore* face)

BLResult blFontManagerQueryFace(const BLFontManagerCore* self, const char* name, size_t nameSize, const BLFontQueryProperties* properties, BLFontFaceCore* out)

BLResult blFontManagerQueryFacesByFamilyName(const BLFontManagerCore* self, const char* name, size_t nameSize, BLArrayCore* out)

bool blFontManagerEquals(const BLFontManagerCore* a, const BLFontManagerCore* b)

BLFontVariationSettings - C API

BLResult blFontVariationSettingsInit(BLFontVariationSettingsCore* self)

BLResult blFontVariationSettingsInitMove(BLFontVariationSettingsCore* self, BLFontVariationSettingsCore* other)

BLResult blFontVariationSettingsInitWeak(BLFontVariationSettingsCore* self, const BLFontVariationSettingsCore* other)

BLResult blFontVariationSettingsDestroy(BLFontVariationSettingsCore* self)

BLResult blFontVariationSettingsReset(BLFontVariationSettingsCore* self)

BLResult blFontVariationSettingsClear(BLFontVariationSettingsCore* self)

BLResult blFontVariationSettingsShrink(BLFontVariationSettingsCore* self)

BLResult blFontVariationSettingsAssignMove(BLFontVariationSettingsCore* self, BLFontVariationSettingsCore* other)

BLResult blFontVariationSettingsAssignWeak(BLFontVariationSettingsCore* self, const BLFontVariationSettingsCore* other)

size_t blFontVariationSettingsGetSize(const BLFontVariationSettingsCore* self)

size_t blFontVariationSettingsGetCapacity(const BLFontVariationSettingsCore* self)

BLResult blFontVariationSettingsGetView(const BLFontVariationSettingsCore* self, BLFontVariationSettingsView* out)

bool blFontVariationSettingsHasValue(const BLFontVariationSettingsCore* self, BLTag variationTag)

float blFontVariationSettingsGetValue(const BLFontVariationSettingsCore* self, BLTag variationTag)

BLResult blFontVariationSettingsSetValue(BLFontVariationSettingsCore* self, BLTag variationTag, float value)

BLResult blFontVariationSettingsRemoveValue(BLFontVariationSettingsCore* self, BLTag variationTag)

bool blFontVariationSettingsEquals(const BLFontVariationSettingsCore* a, const BLFontVariationSettingsCore* b)

BLGlyphBuffer - C API

BLResult blGlyphBufferInit(BLGlyphBufferCore* self)

BLResult blGlyphBufferInitMove(BLGlyphBufferCore* self, BLGlyphBufferCore* other)

BLResult blGlyphBufferDestroy(BLGlyphBufferCore* self)

BLResult blGlyphBufferReset(BLGlyphBufferCore* self)

BLResult blGlyphBufferClear(BLGlyphBufferCore* self)

size_t blGlyphBufferGetSize(const BLGlyphBufferCore* self)

uint32_t blGlyphBufferGetFlags(const BLGlyphBufferCore* self)

const BLGlyphRun* blGlyphBufferGetGlyphRun(const BLGlyphBufferCore* self)

const uint32_t* blGlyphBufferGetContent(const BLGlyphBufferCore* self)

const BLGlyphInfo* blGlyphBufferGetInfoData(const BLGlyphBufferCore* self)

const BLGlyphPlacement* blGlyphBufferGetPlacementData(const BLGlyphBufferCore* self)

BLResult blGlyphBufferSetText(BLGlyphBufferCore* self, const void* textData, size_t size, BLTextEncoding encoding)

BLResult blGlyphBufferSetGlyphs(BLGlyphBufferCore* self, const uint32_t* glyphData, size_t size)

BLResult blGlyphBufferSetGlyphsFromStruct(BLGlyphBufferCore* self, const void* glyphData, size_t size, size_t glyphIdSize, intptr_t glyphIdAdvance)

BLResult blGlyphBufferSetDebugSink(BLGlyphBufferCore* self, BLDebugMessageSinkFunc sink, void* userData)

BLResult blGlyphBufferResetDebugSink(BLGlyphBufferCore* self)

Typedef Documentation

typedef uint32_t BLGlyphId

Glyph id - a 32-bit unsigned integer.

Enumeration Type Documentation

BLTextEncoding : uint32_tenum

Text encoding.

Constant	Description
BL_TEXT_ENCODING_UTF8	UTF-8 encoding.
BL_TEXT_ENCODING_UTF16	UTF-16 encoding (native endian).
BL_TEXT_ENCODING_UTF32	UTF-32 encoding (native endian).
BL_TEXT_ENCODING_LATIN1	LATIN1 encoding (one byte per character).
BL_TEXT_ENCODING_WCHAR	Platform native wchar_t (or Windows WCHAR) encoding, alias to either UTF-32, UTF-16, or UTF-8 depending on sizeof(wchar_t).
BL_TEXT_ENCODING_MAX_VALUE	Maximum value of BLTextEncoding.

BLFontDataFlags : uint32_tenum

Flags used by BLFontData (or BLFontDataCore).

Constant	Description
BL_FONT_DATA_NO_FLAGS	No flags. Font data references a font-collection.

BLOrientation : uint32_tenum

Orientation.

Constant	Description
BL_ORIENTATION_HORIZONTAL	Horizontal orientation.
BL_ORIENTATION_VERTICAL	Vertical orientation.
BL_ORIENTATION_MAX_VALUE	Maximum value of BLOrientation.

BLFontFaceType : uint32_tenum

Type of a font or font face, see BLFontFace (or BLFontFaceCore).

Constant	Description
BL_FONT_FACE_TYPE_NONE	None or unknown font type.
BL_FONT_FACE_TYPE_OPENTYPE	TrueType/OpenType font type (.ttf/.otf files and font collections).
BL_FONT_FACE_TYPE_MAX_VALUE	Maximum value of BLFontFaceType.

BLFontStretch : uint32_tenum

Font stretch.

Constant	Description
BL_FONT_STRETCH_ULTRA_CONDENSED	Ultra condensed stretch.
BL_FONT_STRETCH_EXTRA_CONDENSED	Extra condensed stretch.
BL_FONT_STRETCH_CONDENSED	Condensed stretch.
BL_FONT_STRETCH_SEMI_CONDENSED	Semi condensed stretch.
BL_FONT_STRETCH_NORMAL	Normal stretch.
BL_FONT_STRETCH_SEMI_EXPANDED	Semi expanded stretch.
BL_FONT_STRETCH_EXPANDED	Expanded stretch.
BL_FONT_STRETCH_EXTRA_EXPANDED	Extra expanded stretch.
BL_FONT_STRETCH_ULTRA_EXPANDED	Ultra expanded stretch.
BL_FONT_STRETCH_MAX_VALUE	Maximum value of BLFontStretch.

BLFontStyle : uint32_tenum

Font style.

Constant	Description
BL_FONT_STYLE_NORMAL	Normal style.
BL_FONT_STYLE_OBLIQUE	Oblique.
BL_FONT_STYLE_ITALIC	Italic.
BL_FONT_STYLE_MAX_VALUE	Maximum value of BLFontStyle.

BLFontWeight : uint32_tenum

Font weight.

Constant	Description
BL_FONT_WEIGHT_THIN	Thin weight (100).
BL_FONT_WEIGHT_EXTRA_LIGHT	Extra light weight (200).
BL_FONT_WEIGHT_LIGHT	Light weight (300).
BL_FONT_WEIGHT_SEMI_LIGHT	Semi light weight (350).
BL_FONT_WEIGHT_NORMAL	Normal weight (400).
BL_FONT_WEIGHT_MEDIUM	Medium weight (500).
BL_FONT_WEIGHT_SEMI_BOLD	Semi bold weight (600).
BL_FONT_WEIGHT_BOLD	Bold weight (700).
BL_FONT_WEIGHT_EXTRA_BOLD	Extra bold weight (800).
BL_FONT_WEIGHT_BLACK	Black weight (900).
BL_FONT_WEIGHT_EXTRA_BLACK	Extra black weight (950).

BLFontStringId : uint32_tenum

Font string identifiers used by OpenType 'name' table.

Constant	Description
BL_FONT_STRING_ID_COPYRIGHT_NOTICE	Copyright notice.
BL_FONT_STRING_ID_FAMILY_NAME	Font family name.
BL_FONT_STRING_ID_SUBFAMILY_NAME	Font subfamily name.
BL_FONT_STRING_ID_UNIQUE_IDENTIFIER	Unique font identifier.
BL_FONT_STRING_ID_FULL_NAME	Full font name that reflects all family and relevant subfamily descriptors.
BL_FONT_STRING_ID_VERSION_STRING	Version string. Should begin with the synta Version <number>.<number>.
BL_FONT_STRING_ID_POST_SCRIPT_NAME	PostScript name for the font.
BL_FONT_STRING_ID_TRADEMARK	Trademark notice/information for this font.
BL_FONT_STRING_ID_MANUFACTURER_NAME	Manufacturer name.
BL_FONT_STRING_ID_DESIGNER_NAME	Name of the designer of the typeface.
BL_FONT_STRING_ID_DESCRIPTION	Description of the typeface.
BL_FONT_STRING_ID_VENDOR_URL	URL of font vendor.
BL_FONT_STRING_ID_DESIGNER_URL	URL of typeface designer.
BL_FONT_STRING_ID_LICENSE_DESCRIPTION	Description of how the font may be legally used.
BL_FONT_STRING_ID_LICENSE_INFO_URL	URL where additional licensing information can be found.
BL_FONT_STRING_ID_RESERVED	Reserved.
BL_FONT_STRING_ID_TYPOGRAPHIC_FAMILY_NAME	Typographic family name.
BL_FONT_STRING_ID_TYPOGRAPHIC_SUBFAMILY_NAME	Typographic subfamily name.
BL_FONT_STRING_ID_COMPATIBLE_FULL_NAME	Compatible full name (MAC only).
BL_FONT_STRING_ID_SAMPLE_TEXT	Sample text - font name or any other text from the designer.
BL_FONT_STRING_ID_POST_SCRIPT_CID_NAME	PostScript CID findfont name.
BL_FONT_STRING_ID_WWS_FAMILY_NAME	WWS family name.
BL_FONT_STRING_ID_WWS_SUBFAMILY_NAME	WWS subfamily name.
BL_FONT_STRING_ID_LIGHT_BACKGROUND_PALETTE	Light background palette.
BL_FONT_STRING_ID_DARK_BACKGROUND_PALETTE	Dark background palette.
BL_FONT_STRING_ID_VARIATIONS_POST_SCRIPT_PREFIX	Variations PostScript name prefix.
BL_FONT_STRING_ID_COMMON_MAX_VALUE	Count of common font string ids.
BL_FONT_STRING_ID_CUSTOM_START_INDEX	Start of custom font string ids.

BLFontUnicodeCoverageIndex : uint32_tenum

Bit positions in BLFontUnicodeCoverage structure.

Each bit represents a range (or multiple ranges) of unicode characters.

Constant	Description
BL_FONT_UC_INDEX_BASIC_LATIN	[000000-00007F] Basic Latin.
BL_FONT_UC_INDEX_LATIN1_SUPPLEMENT	[000080-0000FF] Latin-1 Supplement.
BL_FONT_UC_INDEX_LATIN_EXTENDED_A	[000100-00017F] Latin Extended-A.
BL_FONT_UC_INDEX_LATIN_EXTENDED_B	[000180-00024F] Latin Extended-B.
BL_FONT_UC_INDEX_IPA_EXTENSIONS	[000250-0002AF] IPA Extensions. [001D00-001D7F] Phonetic Extensions. [001D80-001DBF] Phonetic Extensions Supplement.
BL_FONT_UC_INDEX_SPACING_MODIFIER_LETTERS	[0002B0-0002FF] Spacing Modifier Letters. [00A700-00A71F] Modifier Tone Letters. [001DC0-001DFF] Combining Diacritical Marks Supplement.
BL_FONT_UC_INDEX_COMBINING_DIACRITICAL_MARKS	[000300-00036F] Combining Diacritical Marks.
BL_FONT_UC_INDEX_GREEK_AND_COPTIC	[000370-0003FF] Greek and Coptic.
BL_FONT_UC_INDEX_COPTIC	[002C80-002CFF] Coptic.
BL_FONT_UC_INDEX_CYRILLIC	[000400-0004FF] Cyrillic. [000500-00052F] Cyrillic Supplement. [002DE0-002DFF] Cyrillic Extended-A. [00A640-00A69F] Cyrillic Extended-B.
BL_FONT_UC_INDEX_ARMENIAN	[000530-00058F] Armenian.
BL_FONT_UC_INDEX_HEBREW	[000590-0005FF] Hebrew.
BL_FONT_UC_INDEX_VAI	[00A500-00A63F] Vai.
BL_FONT_UC_INDEX_ARABIC	[000600-0006FF] Arabic. [000750-00077F] Arabic Supplement.
BL_FONT_UC_INDEX_NKO	[0007C0-0007FF] NKo.
BL_FONT_UC_INDEX_DEVANAGARI	[000900-00097F] Devanagari.
BL_FONT_UC_INDEX_BENGALI	[000980-0009FF] Bengali.
BL_FONT_UC_INDEX_GURMUKHI	[000A00-000A7F] Gurmukhi.
BL_FONT_UC_INDEX_GUJARATI	[000A80-000AFF] Gujarati.
BL_FONT_UC_INDEX_ORIYA	[000B00-000B7F] Oriya.
BL_FONT_UC_INDEX_TAMIL	[000B80-000BFF] Tamil.
BL_FONT_UC_INDEX_TELUGU	[000C00-000C7F] Telugu.
BL_FONT_UC_INDEX_KANNADA	[000C80-000CFF] Kannada.
BL_FONT_UC_INDEX_MALAYALAM	[000D00-000D7F] Malayalam.
BL_FONT_UC_INDEX_THAI	[000E00-000E7F] Thai.
BL_FONT_UC_INDEX_LAO	[000E80-000EFF] Lao.
BL_FONT_UC_INDEX_GEORGIAN	[0010A0-0010FF] Georgian. [002D00-002D2F] Georgian Supplement.
BL_FONT_UC_INDEX_BALINESE	[001B00-001B7F] Balinese.
BL_FONT_UC_INDEX_HANGUL_JAMO	[001100-0011FF] Hangul Jamo.
BL_FONT_UC_INDEX_LATIN_EXTENDED_ADDITIONAL	[001E00-001EFF] Latin Extended Additional. [002C60-002C7F] Latin Extended-C. [00A720-00A7FF] Latin Extended-D.
BL_FONT_UC_INDEX_GREEK_EXTENDED	[001F00-001FFF] Greek Extended.
BL_FONT_UC_INDEX_GENERAL_PUNCTUATION	[002000-00206F] General Punctuation. [002E00-002E7F] Supplemental Punctuation.
BL_FONT_UC_INDEX_SUPERSCRIPTS_AND_SUBSCRIPTS	[002070-00209F] Superscripts And Subscripts.
BL_FONT_UC_INDEX_CURRENCY_SYMBOLS	[0020A0-0020CF] Currency Symbols.
BL_FONT_UC_INDEX_COMBINING_DIACRITICAL_MARKS_FOR_SYMBOLS	[0020D0-0020FF] Combining Diacritical Marks For Symbols.
BL_FONT_UC_INDEX_LETTERLIKE_SYMBOLS	[002100-00214F] Letterlike Symbols.
BL_FONT_UC_INDEX_NUMBER_FORMS	[002150-00218F] Number Forms.
BL_FONT_UC_INDEX_ARROWS	[002190-0021FF] Arrows. [0027F0-0027FF] Supplemental Arrows-A. [002900-00297F] Supplemental Arrows-B. [002B00-002BFF] Miscellaneous Symbols and Arrows.
BL_FONT_UC_INDEX_MATHEMATICAL_OPERATORS	[002200-0022FF] Mathematical Operators. [002A00-002AFF] Supplemental Mathematical Operators. [0027C0-0027EF] Miscellaneous Mathematical Symbols-A. [002980-0029FF] Miscellaneous Mathematical Symbols-B.
BL_FONT_UC_INDEX_MISCELLANEOUS_TECHNICAL	[002300-0023FF] Miscellaneous Technical.
BL_FONT_UC_INDEX_CONTROL_PICTURES	[002400-00243F] Control Pictures.
BL_FONT_UC_INDEX_OPTICAL_CHARACTER_RECOGNITION	[002440-00245F] Optical Character Recognition.
BL_FONT_UC_INDEX_ENCLOSED_ALPHANUMERICS	[002460-0024FF] Enclosed Alphanumerics.
BL_FONT_UC_INDEX_BOX_DRAWING	[002500-00257F] Box Drawing.
BL_FONT_UC_INDEX_BLOCK_ELEMENTS	[002580-00259F] Block Elements.
BL_FONT_UC_INDEX_GEOMETRIC_SHAPES	[0025A0-0025FF] Geometric Shapes.
BL_FONT_UC_INDEX_MISCELLANEOUS_SYMBOLS	[002600-0026FF] Miscellaneous Symbols.
BL_FONT_UC_INDEX_DINGBATS	[002700-0027BF] Dingbats.
BL_FONT_UC_INDEX_CJK_SYMBOLS_AND_PUNCTUATION	[003000-00303F] CJK Symbols And Punctuation.
BL_FONT_UC_INDEX_HIRAGANA	[003040-00309F] Hiragana.
BL_FONT_UC_INDEX_KATAKANA	[0030A0-0030FF] Katakana. [0031F0-0031FF] Katakana Phonetic Extensions.
BL_FONT_UC_INDEX_BOPOMOFO	[003100-00312F] Bopomofo. [0031A0-0031BF] Bopomofo Extended.
BL_FONT_UC_INDEX_HANGUL_COMPATIBILITY_JAMO	[003130-00318F] Hangul Compatibility Jamo.
BL_FONT_UC_INDEX_PHAGS_PA	[00A840-00A87F] Phags-pa.
BL_FONT_UC_INDEX_ENCLOSED_CJK_LETTERS_AND_MONTHS	[003200-0032FF] Enclosed CJK Letters And Months.
BL_FONT_UC_INDEX_CJK_COMPATIBILITY	[003300-0033FF] CJK Compatibility.
BL_FONT_UC_INDEX_HANGUL_SYLLABLES	[00AC00-00D7AF] Hangul Syllables.
BL_FONT_UC_INDEX_NON_PLANE	[00D800-00DFFF] Non-Plane 0 *.
BL_FONT_UC_INDEX_PHOENICIAN	[010900-01091F] Phoenician.
BL_FONT_UC_INDEX_CJK_UNIFIED_IDEOGRAPHS	[004E00-009FFF] CJK Unified Ideographs. [002E80-002EFF] CJK Radicals Supplement. [002F00-002FDF] Kangxi Radicals. [002FF0-002FFF] Ideographic Description Characters. [003400-004DBF] CJK Unified Ideographs Extension A. [020000-02A6DF] CJK Unified Ideographs Extension B. [003190-00319F] Kanbun.
BL_FONT_UC_INDEX_PRIVATE_USE_PLANE0	[00E000-00F8FF] Private Use (Plane 0).
BL_FONT_UC_INDEX_CJK_STROKES	[0031C0-0031EF] CJK Strokes. [00F900-00FAFF] CJK Compatibility Ideographs. [02F800-02FA1F] CJK Compatibility Ideographs Supplement.
BL_FONT_UC_INDEX_ALPHABETIC_PRESENTATION_FORMS	[00FB00-00FB4F] Alphabetic Presentation Forms.
BL_FONT_UC_INDEX_ARABIC_PRESENTATION_FORMS_A	[00FB50-00FDFF] Arabic Presentation Forms-A.
BL_FONT_UC_INDEX_COMBINING_HALF_MARKS	[00FE20-00FE2F] Combining Half Marks.
BL_FONT_UC_INDEX_VERTICAL_FORMS	[00FE10-00FE1F] Vertical Forms. [00FE30-00FE4F] CJK Compatibility Forms.
BL_FONT_UC_INDEX_SMALL_FORM_VARIANTS	[00FE50-00FE6F] Small Form Variants.
BL_FONT_UC_INDEX_ARABIC_PRESENTATION_FORMS_B	[00FE70-00FEFF] Arabic Presentation Forms-B.
BL_FONT_UC_INDEX_HALFWIDTH_AND_FULLWIDTH_FORMS	[00FF00-00FFEF] Halfwidth And Fullwidth Forms.
BL_FONT_UC_INDEX_SPECIALS	[00FFF0-00FFFF] Specials.
BL_FONT_UC_INDEX_TIBETAN	[000F00-000FFF] Tibetan.
BL_FONT_UC_INDEX_SYRIAC	[000700-00074F] Syriac.
BL_FONT_UC_INDEX_THAANA	[000780-0007BF] Thaana.
BL_FONT_UC_INDEX_SINHALA	[000D80-000DFF] Sinhala.
BL_FONT_UC_INDEX_MYANMAR	[001000-00109F] Myanmar.
BL_FONT_UC_INDEX_ETHIOPIC	[001200-00137F] Ethiopic. [001380-00139F] Ethiopic Supplement. [002D80-002DDF] Ethiopic Extended.
BL_FONT_UC_INDEX_CHEROKEE	[0013A0-0013FF] Cherokee.
BL_FONT_UC_INDEX_UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS	[001400-00167F] Unified Canadian Aboriginal Syllabics.
BL_FONT_UC_INDEX_OGHAM	[001680-00169F] Ogham.
BL_FONT_UC_INDEX_RUNIC	[0016A0-0016FF] Runic.
BL_FONT_UC_INDEX_KHMER	[001780-0017FF] Khmer. [0019E0-0019FF] Khmer Symbols.
BL_FONT_UC_INDEX_MONGOLIAN	[001800-0018AF] Mongolian.
BL_FONT_UC_INDEX_BRAILLE_PATTERNS	[002800-0028FF] Braille Patterns.
BL_FONT_UC_INDEX_YI_SYLLABLES_AND_RADICALS	[00A000-00A48F] Yi Syllables. [00A490-00A4CF] Yi Radicals.
BL_FONT_UC_INDEX_TAGALOG_HANUNOO_BUHID_TAGBANWA	[001700-00171F] Tagalog. [001720-00173F] Hanunoo. [001740-00175F] Buhid. [001760-00177F] Tagbanwa.
BL_FONT_UC_INDEX_OLD_ITALIC	[010300-01032F] Old Italic.
BL_FONT_UC_INDEX_GOTHIC	[010330-01034F] Gothic.
BL_FONT_UC_INDEX_DESERET	[010400-01044F] Deseret.
BL_FONT_UC_INDEX_MUSICAL_SYMBOLS	[01D000-01D0FF] Byzantine Musical Symbols. [01D100-01D1FF] Musical Symbols. [01D200-01D24F] Ancient Greek Musical Notation.
BL_FONT_UC_INDEX_MATHEMATICAL_ALPHANUMERIC_SYMBOLS	[01D400-01D7FF] Mathematical Alphanumeric Symbols.
BL_FONT_UC_INDEX_PRIVATE_USE_PLANE_15_16	[0F0000-0FFFFD] Private Use (Plane 15). [100000-10FFFD] Private Use (Plane 16).
BL_FONT_UC_INDEX_VARIATION_SELECTORS	[00FE00-00FE0F] Variation Selectors. [0E0100-0E01EF] Variation Selectors Supplement.
BL_FONT_UC_INDEX_TAGS	[0E0000-0E007F] Tags.
BL_FONT_UC_INDEX_LIMBU	[001900-00194F] Limbu.
BL_FONT_UC_INDEX_TAI_LE	[001950-00197F] Tai Le.
BL_FONT_UC_INDEX_NEW_TAI_LUE	[001980-0019DF] New Tai Lue.
BL_FONT_UC_INDEX_BUGINESE	[001A00-001A1F] Buginese.
BL_FONT_UC_INDEX_GLAGOLITIC	[002C00-002C5F] Glagolitic.
BL_FONT_UC_INDEX_TIFINAGH	[002D30-002D7F] Tifinagh.
BL_FONT_UC_INDEX_YIJING_HEXAGRAM_SYMBOLS	[004DC0-004DFF] Yijing Hexagram Symbols.
BL_FONT_UC_INDEX_SYLOTI_NAGRI	[00A800-00A82F] Syloti Nagri.
BL_FONT_UC_INDEX_LINEAR_B_SYLLABARY_AND_IDEOGRAMS	[010000-01007F] Linear B Syllabary. [010080-0100FF] Linear B Ideograms. [010100-01013F] Aegean Numbers.
BL_FONT_UC_INDEX_ANCIENT_GREEK_NUMBERS	[010140-01018F] Ancient Greek Numbers.
BL_FONT_UC_INDEX_UGARITIC	[010380-01039F] Ugaritic.
BL_FONT_UC_INDEX_OLD_PERSIAN	[0103A0-0103DF] Old Persian.
BL_FONT_UC_INDEX_SHAVIAN	[010450-01047F] Shavian.
BL_FONT_UC_INDEX_OSMANYA	[010480-0104AF] Osmanya.
BL_FONT_UC_INDEX_CYPRIOT_SYLLABARY	[010800-01083F] Cypriot Syllabary.
BL_FONT_UC_INDEX_KHAROSHTHI	[010A00-010A5F] Kharoshthi.
BL_FONT_UC_INDEX_TAI_XUAN_JING_SYMBOLS	[01D300-01D35F] Tai Xuan Jing Symbols.
BL_FONT_UC_INDEX_CUNEIFORM	[012000-0123FF] Cuneiform. [012400-01247F] Cuneiform Numbers and Punctuation.
BL_FONT_UC_INDEX_COUNTING_ROD_NUMERALS	[01D360-01D37F] Counting Rod Numerals.
BL_FONT_UC_INDEX_SUNDANESE	[001B80-001BBF] Sundanese.
BL_FONT_UC_INDEX_LEPCHA	[001C00-001C4F] Lepcha.
BL_FONT_UC_INDEX_OL_CHIKI	[001C50-001C7F] Ol Chiki.
BL_FONT_UC_INDEX_SAURASHTRA	[00A880-00A8DF] Saurashtra.
BL_FONT_UC_INDEX_KAYAH_LI	[00A900-00A92F] Kayah Li.
BL_FONT_UC_INDEX_REJANG	[00A930-00A95F] Rejang.
BL_FONT_UC_INDEX_CHAM	[00AA00-00AA5F] Cham.
BL_FONT_UC_INDEX_ANCIENT_SYMBOLS	[010190-0101CF] Ancient Symbols.
BL_FONT_UC_INDEX_PHAISTOS_DISC	[0101D0-0101FF] Phaistos Disc.
BL_FONT_UC_INDEX_CARIAN_LYCIAN_LYDIAN	[0102A0-0102DF] Carian. [010280-01029F] Lycian. [010920-01093F] Lydian.
BL_FONT_UC_INDEX_DOMINO_AND_MAHJONG_TILES	[01F030-01F09F] Domino Tiles. [01F000-01F02F] Mahjong Tiles.
BL_FONT_UC_INDEX_INTERNAL_USAGE_123	Reserved for internal usage (123).
BL_FONT_UC_INDEX_INTERNAL_USAGE_124	Reserved for internal usage (124).
BL_FONT_UC_INDEX_INTERNAL_USAGE_125	Reserved for internal usage (125).
BL_FONT_UC_INDEX_INTERNAL_USAGE_126	Reserved for internal usage (126).
BL_FONT_UC_INDEX_INTERNAL_USAGE_127	Reserved for internal usage (127).
BL_FONT_UC_INDEX_MAX_VALUE	Maximum value of BLFontUnicodeCoverageIndex.

BLTextDirection : uint32_tenum

Text direction.

Constant	Description
BL_TEXT_DIRECTION_LTR	Left-to-right direction.
BL_TEXT_DIRECTION_RTL	Right-to-left direction.
BL_TEXT_DIRECTION_MAX_VALUE	Maximum value of BLTextDirection.

BLFontFaceFlags : uint32_tenum

Flags used by BLFontFace (or BLFontFaceCore)

Constant	Description
BL_FONT_FACE_NO_FLAGS	No flags.
BL_FONT_FACE_FLAG_TYPOGRAPHIC_NAMES	Font uses typographic family and subfamily names.
BL_FONT_FACE_FLAG_TYPOGRAPHIC_METRICS	Font uses typographic metrics.
BL_FONT_FACE_FLAG_CHAR_TO_GLYPH_MAPPING	Character to glyph mapping is available.
BL_FONT_FACE_FLAG_HORIZONTAL_METIRCS	Horizontal glyph metrics (advances, side bearings) is available.
BL_FONT_FACE_FLAG_VERTICAL_METRICS	Vertical glyph metrics (advances, side bearings) is available.
BL_FONT_FACE_FLAG_HORIZONTAL_KERNING	Legacy horizontal kerning feature ('kern' table with horizontal kerning data).
BL_FONT_FACE_FLAG_VERTICAL_KERNING	Legacy vertical kerning feature ('kern' table with vertical kerning data).
BL_FONT_FACE_FLAG_OPENTYPE_FEATURES	OpenType features (GDEF, GPOS, GSUB) are available.
BL_FONT_FACE_FLAG_PANOSE_DATA	Panose classification is available.
BL_FONT_FACE_FLAG_UNICODE_COVERAGE	Unicode coverage information is available.
BL_FONT_FACE_FLAG_BASELINE_Y_EQUALS_0	Baseline for font at y equals 0.
BL_FONT_FACE_FLAG_LSB_POINT_X_EQUALS_0	Left sidebearing point at x == 0 (TT only).
BL_FONT_FACE_FLAG_VARIATION_SEQUENCES	Unicode variation sequences feature is available.
BL_FONT_FACE_FLAG_OPENTYPE_VARIATIONS	OpenType Font Variations feature is available.
BL_FONT_FACE_FLAG_SYMBOL_FONT	This is a symbol font.
BL_FONT_FACE_FLAG_LAST_RESORT_FONT	This is a last resort font.

BLFontFaceDiagFlags : uint32_tenum

Diagnostic flags offered by BLFontFace (or BLFontFaceCore).

Constant	Description
BL_FONT_FACE_DIAG_NO_FLAGS	No flags.
BL_FONT_FACE_DIAG_WRONG_NAME_DATA	Wrong data in 'name' table.
BL_FONT_FACE_DIAG_FIXED_NAME_DATA	Fixed data read from 'name' table and possibly fixed font family/subfamily name.
BL_FONT_FACE_DIAG_WRONG_KERN_DATA	Wrong data in 'kern' table [kerning disabled].
BL_FONT_FACE_DIAG_FIXED_KERN_DATA	Fixed data read from 'kern' table so it can be used.
BL_FONT_FACE_DIAG_WRONG_CMAP_DATA	Wrong data in 'cmap' table.
BL_FONT_FACE_DIAG_WRONG_CMAP_FORMAT	Wrong format in 'cmap' (sub)table.

BLFontOutlineType : uint32_tenum

Format of an outline stored in a font.

Constant	Description
BL_FONT_OUTLINE_TYPE_NONE	None.
BL_FONT_OUTLINE_TYPE_TRUETYPE	Truetype outlines.
BL_FONT_OUTLINE_TYPE_CFF	OpenType (CFF) outlines.
BL_FONT_OUTLINE_TYPE_CFF2	OpenType (CFF2) outlines with font variations support.
BL_FONT_OUTLINE_TYPE_MAX_VALUE	Maximum value of BLFontOutlineType.

BLGlyphRunFlags : uint32_tenum

Flags used by BLGlyphRun.

Constant	Description
BL_GLYPH_RUN_NO_FLAGS	No flags.
BL_GLYPH_RUN_FLAG_UCS4_CONTENT	Glyph-run contains UCS-4 string and not glyphs (glyph-buffer only).
BL_GLYPH_RUN_FLAG_INVALID_TEXT	Glyph-run was created from text that was not a valid unicode.
BL_GLYPH_RUN_FLAG_UNDEFINED_GLYPHS	Not the whole text was mapped to glyphs (contains undefined glyphs).
BL_GLYPH_RUN_FLAG_INVALID_FONT_DATA	Encountered invalid font data during text / glyph processing.

BLGlyphPlacementType : uint32_tenum

Placement of glyphs stored in a BLGlyphRun.

Constant	Description
BL_GLYPH_PLACEMENT_TYPE_NONE	No placement (custom handling by BLPathSinkFunc).
BL_GLYPH_PLACEMENT_TYPE_ADVANCE_OFFSET	Each glyph has a BLGlyphPlacement (advance + offset).
BL_GLYPH_PLACEMENT_TYPE_DESIGN_UNITS	Each glyph has a BLPoint offset in design-space units.
BL_GLYPH_PLACEMENT_TYPE_USER_UNITS	Each glyph has a BLPoint offset in user-space units.
BL_GLYPH_PLACEMENT_TYPE_ABSOLUTE_UNITS	Each glyph has a BLPoint offset in absolute units.
BL_GLYPH_PLACEMENT_TYPE_MAX_VALUE	Maximum value of BLGlyphPlacementType.

Variable Documentation

uint32_t BL_FONT_FEATURE_INVALID_VALUE = 0xFFFFFFFFuconstexprstaticconstexpr

A constant representing an invalid font feature value in font feature tag/value pair.