Index

C/C++ Functions

dtFontGetCounter

DT_SWORD dtFontGetCounter(DT_DTENGINE engine)

Short Description: Get count of font slots in Font Catalog

This function returns the current number (count) of font slots in the Font Catalog of the specified Standard Engine instance.

Parameters

ParameterDescription

engine

Handle of the previously created Standard Engine instance.

Return Value

The return value is the number of currently utilized (allocated) font slots in the Font Catalog of the specified Standard Engine instance. Each font slot serves as a container for one font index (font or font instance). However, the number of font slots in the Font Catalog can be larger than the number of valid font indexes (fonts and font instances). This is because some font slots may be empty (i.e. may not hold any font indexes). You can use the dtFontTest function to determine if a specified font slot contains a valid font of font instance and, if so, retrieve its font index.

Comment

Applications can use dtFontGetCounter in conjunction with dtFontTest and/or dtFontGetSysStatus to enumerate all fonts and font instances in the Font Catalog.

 

Index