(Engine-Level Function)
| Description: | Returns a font value. |
| Returns: | Font |
Usage:  |
Steady State only. |
| Function Groups: | Graphics |
| Related to: | FontDialog | GUIText | ZText |
| Format: |
Font(Name, CharSet, Height, Rotation, Weight, Decoration, Fixed) |
| Parameters: |
| Name | ||||||
| Required. Any text expression that gives the name of the font. This must be the same as the Microsoft Windows™ name for the font. For example, "ARIAL". | ||||||
| CharSet (Deprecated) | ||||||
|
Deprecated. Use DEFAULT_CHARSET in all cases. Other values, used by legacy applications, are now ignored. |
||||||
| Height | ||||||
| Required. Any numeric expression giving the height of the font in points. | ||||||
| Rotation | ||||||
| Required. Any numeric expression giving the rotation of each character in degrees. | ||||||
| Weight | ||||||
| Required. Any numeric expression giving the weight of the font. Larger numbers give a more bold appearance. The range is 0 to 9. | ||||||
| Decoration | ||||||
|
Required bit-wise flag (See: Bitwise Parameters & Operations)
|
||||||
| charFixed | ||||||
| Required. Any logical expression. If true (non-0), all of the characters used by the font will be the same width and height, that of the largest character. If false (0), and the font is a proportional or a true type font, then the characters may have different sizes. |
| Comments: |
This function is for use in layered graphics statements that display text. A good idea is to use variables for font parameters in the layered graphics statements. If it is desired to change the font later, it need only be changed at one place - where the assignment is made to the variable. This also promotes a consistent use of fonts. Parameters are suggestions. Substitutions will be made if the parameters describe a font that cannot be found. |
Example:
InputFont = Font("ARIAL" { Font name },
0 { Character set },
14 { Height in points },
0 { Rotation },
5 { Weight - somewhat bold },
0 { Not italic },
0 { Non-fixed });
