Fonts

Detailed Description

group a3d_fonts

When creating a markup tessellation that uses specific fonts, store fonts with font keys (A3DFontKeyData) by invoking the A3DGlobalFontKeyCreate function.

When parsing a markup tessellation that uses specific fonts, use the A3DGlobalFontKeyGet function to obtain fonts information from font keys (A3DFontKeyData).

See also

Tessellation for Markups

Type Documentation

enum A3DECharSet

Font key CharSet.

Version
2.0

Values:

enumerator kA3DCharsetUnknown

Unknown charset ;.

enumerator kA3DCharsetRoman

Roman charset.

enumerator kA3DCharsetJapanese

Japanese charset.

enumerator kA3DCharsetTraditionalChinese

Traditional chinese charset.

enumerator kA3DCharsetKorean

Korean charset.

enumerator kA3DCharsetArabic

Arabic charset.

enumerator kA3DCharsetHebrew

Hebrew charset.

enumerator kA3DCharsetGreek

Greek charset.

enumerator kA3DCharsetCyrillic

Cyrillic charset.

enumerator kA3DCharsetRightLeft

Right left charset.

enumerator kA3DCharsetDevanagari

Devanagari charset.

enumerator kA3DCharsetGurmukhi

Gurmukhi charset.

enumerator kA3DCharsetGujarati

Gujarati charset.

enumerator kA3DCharsetOriya

Oriya charset.

enumerator kA3DCharsetBengali

Bengali charset.

enumerator kA3DCharsetTamil

Tamil charset.

enumerator kA3DCharsetTelugu

Telugu charset.

enumerator kA3DCharsetKannada

Kannada charset.

enumerator kA3DCharsetMalayalam

Malayalam charset.

enumerator kA3DCharsetSinhalese

Sinhalese charset.

enumerator kA3DCharsetBurmese

Burmese charset.

enumerator kA3DCharsetKhmer

Khmer charset.

enumerator kA3DCharsetThai

Thai charset.

enumerator kA3DCharsetLaotian

Laotian charset.

enumerator kA3DCharsetGeorgian

Georgian charset.

enumerator kA3DCharsetArmenian

Armenian charset.

enumerator kA3DCharsetSimplifiedChinese

Simplified chinese charset.

enumerator kA3DCharsetTibetan

Tibetan charset.

enumerator kA3DCharsetMongolian

Mongolian charset.

enumerator kA3DCharsetGeez

Geez charset.

enumerator kA3DCharsetEastEuropeanRoman

East european roman charset.

enumerator kA3DCharsetVietnamese

Vietnamese charset.

enumerator kA3DCharsetExtendedArabic

Extended arabic charset.

Function Documentation

A3DStatus A3DGlobalFontKeyGet(const A3DFontKeyData *pFontKeyData, A3DFontData *pFontData)

Retrieves font information (A3DFontData) from the A3DFontKeyData structure.

This function is useful when reading markup tessellation.

Version
2.0

Return values:
  • A3D_INITIALIZE_NOT_CALLED –
  • A3D_INVALID_DATA_STRUCT_SIZE –
  • A3D_INVALID_DATA_STRUCT_NULL –
  • A3D_INVALID_ENTITY_NULL –
  • A3D_INVALID_ENTITY_TYPE –
  • A3D_MARKUP_CANNOT_ACCESS_FONT –
  • A3D_MARKUP_INVALID_FONTKEY –
  • A3D_SUCCESS –
Returns:

A3D_SUCCESS on success, or an error code on failure
A3DStatus A3DGlobalFontTextBoxGet(const A3DFontKeyData *psFontKeyData, A3DUTF8Char *pcText, A3DDouble *pdLength, A3DDouble *pdHeight)

Gets text bounding box according to the font.

Version
5.2

Return values:
  • A3D_INITIALIZE_NOT_CALLED –
  • A3D_INVALID_ENTITY_NULL –
  • A3D_INVALID_ENTITY_TYPE –
  • A3D_MARKUP_CANNOT_ACCESS_FONT –
  • A3D_MARKUP_INVALID_FONTKEY –
  • A3D_SUCCESS –
Returns:

A3D_SUCCESS on success, or an error code on failure
A3DStatus A3DGlobalFontTextBoxAndScaleGet(const A3DFontKeyData *psFontKeyData, A3DUTF8Char *pcText, A3DDouble *pdLength, A3DDouble *pdHeight, A3DDouble *pdScale)

Gets text bounding box and scale according to the font.

Version
7.2

Return values:
  • A3D_INITIALIZE_NOT_CALLED –
  • A3D_INVALID_ENTITY_NULL –
  • A3D_INVALID_ENTITY_TYPE –
  • A3D_MARKUP_CANNOT_ACCESS_FONT –
  • A3D_MARKUP_INVALID_FONTKEY –
  • A3D_SUCCESS –
Returns:

A3D_SUCCESS on success, or an error code on failure
A3DStatus A3DGlobalFontKeyCreate(const A3DFontData *pFontData, A3DFontKeyData *pFontKeyData)

Creates the A3DFontKeyData structure from the A3DFontData structure.

Version
2.0

Return values:
  • A3D_INVALID_DATA_STRUCT_SIZE –
  • A3D_INVALID_DATA_STRUCT_NULL –
  • A3D_MARKUP_CANNOT_CREATE_FONTKEY –
  • A3D_MARKUP_INVALID_FONTKEY –
  • A3D_SUCCESS –
Returns:

A3D_SUCCESS on success, or an error code on failure
A3DStatus A3DGlobalFontTextTessellationGet(const A3DFontKeyData *psFontKeyData, const A3DUTF8Char *pcOneChar, A3DRiSet **ppset, A3DDouble *pdCharWidth)

Gets text tessellation as wireframe.

Version
6.1

Return values:
  • A3D_INITIALIZE_NOT_CALLED –
  • A3D_INVALID_ENTITY_NULL –
  • A3D_INVALID_ENTITY_TYPE –
  • A3D_MARKUP_CANNOT_ACCESS_FONT –
  • A3D_MARKUP_INVALID_FONTKEY –
  • A3D_SUCCESS –
Returns:

A3D_SUCCESS on success, or an error code on failure