## Presentation Device Driver Reference for OS/2

[prev][next][parent][TOC]

### GreRealizeFont Parameter - cmdCommand

cmdCommand (ULONG) - input Command.

Valid commands are:

RF_DEVICE_FONT (1) The graphics engine asks the presentation driver if it is able to realize a device font for the logical font identified by pLogFont. The action taken by the handling routine depends on the match number of the logical font. The match number is the lMatch parameter in the FONTMETRICS structure of the font specified. See Font Matching for further information.

If lMatch is negative, the request is for the device font with the corresponding match number. The handling routine must return the font handle, or 0 if no match was found.

If lMatch is 0, the handling routine must search the device fonts for an exact match to pLogFont and return its handle, or 0 if no match was found.

If lMatch is a positive value, the handling routine must return 0, as if no font was found.

RF_LOAD_ENGINE_FONT (2) The presentation driver is requested to convert an engine font into a device font. The presentation driver must return the font handle, or 0 if it is unable to convert the font.

RF_DELETE_FONT (3) The presentation driver is requested to delete a device font. The 32-bit font handle is passed in the pFont parameter.

RF_DELETE_ENGINE_FONT (4) Informs the presentation driver that a previously loaded engine font is being deleted. If font caching is not supported, the handling routine performs the action.

The font is passed to the presentation driver in the device character bundle during the GreDeviceSetAttribute call. (See Character Attributes.) A bit in the CHARDEFS structure indicates whether this is a pointer to an engine font or the handle to a device font.