◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
 
                    The Resource Compiler FONT Statement
 
FONT font-id [load-option] [mem-option] filename
 
The FONT statement defines a font resource for an application. A font
resource, typically created by using the Microsoft Operating System/2 Font
Editor, is a bitmap defining the shape of the individual characters in a
character set. The FONT statement copies the font resource from the file
specified in the filename field and adds it to the application's other
resources. A font resource can be loaded from the executable file when
needed by using the GpiLoadFonts function.
 
You can provide any number of FONT statements in a resource-definition file,
but each statement must specify a unique font-id value.
 
Field        Description
────────────────────────────────────────────────────────────────────────────
 
font-id      Specifies the font-resource identifier. This value must be an
             integer in the range 0 through 65,535, or a simple expression
             that evaluates to a value in that range.
 
load-option  Specifies when the system loads the resource from the
             executable file into memory. This value must be one of the
             following:
 
             Value       Meaning
             ───────────────────────────────────────────────────────────────
             PRELOAD     System loads the resource when the application
                         starts.
 
             LOADONCALL  System loads the resource when the application
                         calls the GpiLoadFonts function. This is the
                         default value.
 
mem-option   Specifies how the system manages the resource when it is in
             memory. This value must be one or more of the following:
 
             Value        Meaning
             ───────────────────────────────────────────────────────────────
             FIXED        System keeps the resource at a fixed memory
                          location.
 
             MOVEABLE     System moves the resource as necessary to compact
                          memory.
 
             DISCARDABLE  System discards the resource if it is no longer
                          needed.
 
             The default setting is MOVEABLE and DISCARDABLE.
 
filename     Specifies the name of the file containing the font resource. If
             the file is not in the current directory, filename must be
             preceded by a full path.
 
Example
 
This example defines a font whose font identifier is 5. The font resource is
copied from the file cmroman.fon.
 
FONT 5 cmroman.fon
 
See Also
 
GpiLoadFonts
 
                                      ♦