Fonts

Types

A3DFontKeyData

A3DFontData

A3DECharSet

Fields

kA3DCharsetUnknown

kA3DCharsetRoman

kA3DCharsetJapanese

kA3DCharsetTraditionalChinese

kA3DCharsetKorean

kA3DCharsetArabic

kA3DCharsetHebrew

kA3DCharsetGreek

kA3DCharsetCyrillic

kA3DCharsetRightLeft

kA3DCharsetDevanagari

kA3DCharsetGurmukhi

kA3DCharsetGujarati

kA3DCharsetOriya

kA3DCharsetBengali

kA3DCharsetTamil

kA3DCharsetTelugu

kA3DCharsetKannada

kA3DCharsetMalayalam

kA3DCharsetSinhalese

kA3DCharsetBurmese

kA3DCharsetKhmer

kA3DCharsetThai

kA3DCharsetLaotian

kA3DCharsetGeorgian

kA3DCharsetArmenian

kA3DCharsetSimplifiedChinese

kA3DCharsetTibetan

kA3DCharsetMongolian

kA3DCharsetGeez

kA3DCharsetEastEuropeanRoman

kA3DCharsetVietnamese

kA3DCharsetExtendedArabic

Functions

A3DStatus

A3DGlobalFontKeyGet

A3DStatus

A3DGlobalFontTextBoxGet

A3DStatus

A3DGlobalFontTextBoxAndScaleGet

A3DStatus

A3DGlobalFontKeyCreate

A3DStatus

A3DGlobalFontTextTessellationGet

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).

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