Bdf load
Jump to navigation
Jump to search
Definition
INT bdf_load ( <STRING filename>, [ <POINTER id>] )
Loads a BDF font file into memory as a font.
The previous name load_bdf() is deprecated.
Parameters
| STRING filename | - The filename of the bdf file that you wish to load (including extension and possible path). |
| POINTER id | - Optional parameter, for loading a font in the background. |
Returns
INT : graphID
| -2 | - Waiting for the file to be loaded, see notes. |
| -1 | - There was an error loading the file. |
| >=0 | - The graphID of the newly created font. |
the following applies for versions prior rc282:
INT : FontID
| -1 | - Error: file does not exist. |
| 0 | - Filename could not be obtained from the specified string (doesn't happen usually). |
| >0 | - The FontID. |
Errors
| Format not recognized | - The format of the specified file could not be recognized. |
Notes
The optional parameter id was introduced in version rc282 and allows you to load resources in the background. It used with the Offset operator. See example below:
load_bdf("archivo_gordo.bdf", &idbdf);
while(idbdf==-2)
say("Big File Loading ....");
frame;
end
if(idbdf==-1)
say("Something went wrong!!");
exit(); // o return
end
say("Big file loaded ok!!");