| Tutorials |
| Documentation |
|
Font commands
Detailed DescriptionCommands to create, manage and destroy fonts. A font is a stylistically consistent set of glyphs that can be used to render some set of characters. Each font has a family name (for example Palatino) and a state variable that selects one of the faces (for example Regular, Bold, Italic, BoldItalic) that the font contains. A typeface is the combination of a family and a face (for example Palatino Bold). A font is an instantiation of a master for a given face. Every font has an associated character map. A character map is a table of entries that maps integer values to the name string that identifies the characters. The character maps are used by GLC, for instance, to determine that the character code 65 corresponds to A. The character map of a font can be modified by either adding new entries or changing the mapping of the characters (see glcFontMap()). GLC maintains two lists of fonts : GLC_FONT_LIST and GLC_CURRENT_FONT_LIST. The former contains every font that have been created with the commands glcNewFontFromFamily() and glcNewFontFromMaster() and the later contains the fonts that GLC can use when it renders a character (notice however that if GLC_AUTO_FONT is enabled, GLC may automatically add new fonts from GLC_FONT_LIST to the GLC_CURRENT_FONT_LIST ). Finally, it must be stressed that the order in which the fonts are stored in the GLC_CURRENT_FONT_LIST matters : the first font of the list should be considered as the main font with which strings are rendered, while other fonts of this list should be seen as fallback fonts (i.e. fonts that are used when the first font of GLC_CURRENT_FONT_LIST does not map the character to render). Most of the commands in this category have a parameter inFont. Unless otherwise specified, these commands raise GLC_PARAMETER_ERROR if inFont is less than zero or is greater than or equal to the value of the variable GLC_FONT_COUNT. Function Documentation◆ glcAppendFont()
This command appends inFont to the list GLC_CURRENT_FONT_LIST. The command raises GLC_PARAMETER_ERROR if inFont is not an element of the list GLC_FONT_LIST or if inFont is an element in the list GLC_CURRENT_FONT_LIST at the beginning of command execution.
◆ glcDeleteFont()
This command deletes the font identified by inFont. If inFont is an element in the list GLC_CURRENT_FONT_LIST, the command removes that element from the list. All information about the font is lost, and the indice inFont become unused. The command raises GLC_PARAMETER_ERROR if inFont is not an element of the list GLC_FONT_LIST and if inFont has not been generated by glcGenFontID().
◆ glcFont()
This command begins by removing all elements from the list GLC_CURRENT_FONT_LIST. If inFont is nonzero, the command then appends inFont to the list. Otherwise, the command does not raise an error and the list remains empty. The command raises GLC_PARAMETER_ERROR if inFont is nonzero and is not an element of the list GLC_FONT_LIST.
◆ glcFontFace()
This command attempts to set the current face of the font identified by inFont to the face identified by the string inFace. Examples for font faces are strings like "Normal", "Bold" or "Bold Italic". In contrast to some systems that have a different font for each face, GLC allows you to have the face be an attribute of the font. If inFace is not an element of the font's string list attribute GLC_FACE_LIST, the command leaves the font's current face unchanged and returns GL_FALSE. If the command succeeds, it returns GL_TRUE. If inFont is zero, the command iterates over the GLC_CURRENT_FONT_LIST. For each of the fonts named therein, the command attempts to set the font's current face to the face in that font that is identified by inFace. In this case, the command returns GL_TRUE if GLC_CURRENT_FONT_LIST contains one or more elements and the command successfully sets the current face of each of the fonts named in the list. The command raises GLC_PARAMETER_ERROR if inFont is not an element in the list GLC_FONT_LIST.
◆ glcFontMap()
This command modifies the character map of the font identified by inFont such that the font maps inCode to the character whose name is the string inCharName. If inCharName is GLC_NONE, inCode is removed from the character map. The command raises GLC_PARAMETER_ERROR if inCharName is not GLC_NONE or an element of the font string's list attribute GLC_CHAR_LIST.
◆ glcGenFontID()
This command returns a font ID that is not an element of the list GLC_FONT_LIST. This command has also the effect of creating an empty font for the returned ID so that this ID become used.
◆ glcGetFontFace()
This command returns the string name of the current face of the font identified by inFont.
◆ glcGetFontListc()
This command returns an attribute of the font identified by inFont that is a string from a string list identified by inAttrib. The command returns the string at offset inIndex from the first element in inAttrib. For example, if inFont has a face list ( Every GLC state variable that is a list has an associated integer element count whose value is the number of elements in the list. Below are the string list attributes associated with each GLC master and font and their element count attributes :
◆ glcGetFontMap()
This command returns the string name of the character that the font identified by inFont maps inCode to. To change the map, that is, associate a different name string with the integer ID of a font, use glcFontMap(). If inCode cannot be mapped in the font, the command returns GLC_NONE. The command raises GLC_PARAMETER_ERROR if inFont is not an element of the list GLC_FONT_LIST
◆ glcGetFontc()
This command returns a string attribute of the font identified by inFont. The table below lists the string attributes that are associated with each GLC master and font.
◆ glcGetFonti()
This command returns an integer attribute of the font identified by inFont. The attribute is identified by inAttrib. The table below lists the integer attributes that are associated with each GLC master and font.
◆ glcIsFont()
This command returns GL_TRUE if inFont is the ID of a font. If inFont is not the ID of a font, the command does not raise an error.
◆ glcNewFontFromMaster()
This command creates a new font from the master identified by inMaster. The ID of the new font is inFont. If the command succeeds, it returns inFont. If inFont is the ID of a font at the beginning of command execution, the command executes the command
◆ glcNewFontFromFamily()
This command performs a sequential search beginning with the first element of the GLC master list, looking for the first master whose string attribute GLC_FAMILY equals inFamily. If there is no such master the command returns zero. Otherwise, the command creates a new font from the master. The ID of the new font is inFont. If the command succeeds, it returns inFont. If inFont is the ID of a font at the beginning of command execution, the command executes the command
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Generated for QuesoGLC by  1.17.0 written by Dimitri van Heesch © 1997-2005
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||