Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
en:docs:fapi:viosetfont [2021/09/05 03:14] – created prokushev | en:docs:fapi:viosetfont [2021/11/04 12:36] (current) – prokushev | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | {{page> | ||
+ | |||
+ | ====== VioSetFont ====== | ||
+ | |||
This call downloads a display font. The font being set must be compatible with the current mode. | This call downloads a display font. The font being set must be compatible with the current mode. | ||
- | ==Syntax== | + | ===== Syntax ===== |
+ | <code c> | ||
| | ||
+ | </ | ||
+ | ===== Parameters ===== | ||
+ | |||
+ | * RequestBlock ([[PVIOFONTINFO]]) - input: Address of the font structure containing the request. | ||
+ | * VioHandle ([[HVIO]]) - input: Reserved word of 0s. | ||
+ | |||
+ | ===== Return Code ===== | ||
+ | |||
+ | rc (USHORT) - return: | ||
- | ===Parameters=== | + | *0 NO_ERROR |
- | ; | + | *355 ERROR_VIO_MODE |
- | ;VioHandle ([[HVIO]]) - input: Reserved word of 0s. | + | *421 ERROR_VIO_INVALID_PARMS |
+ | *436 ERROR_VIO_INVALID_HANDLE | ||
+ | *438 ERROR_VIO_INVALID_LENGTH | ||
+ | *465 ERROR_VIO_DETACHED | ||
+ | *467 ERROR_VIO_FONT | ||
+ | *468 ERROR_VIO_USER_FONT | ||
+ | *494 ERROR_VIO_EXTENDED_SG | ||
- | ==Return Code== | + | ===== Remarks ===== |
- | ;rc (USHORT) - return: | + | |
- | *0 NO_ERROR | + | |
- | *355 ERROR_VIO_MODE | + | |
- | *421 ERROR_VIO_INVALID_PARMS | + | |
- | *436 ERROR_VIO_INVALID_HANDLE | + | |
- | *438 ERROR_VIO_INVALID_LENGTH | + | |
- | *465 ERROR_VIO_DETACHED | + | |
- | *467 ERROR_VIO_FONT | + | |
- | *468 ERROR_VIO_USER_FONT | + | |
- | *494 ERROR_VIO_EXTENDED_SG | + | |
- | ==Remarks== | ||
VioSetFont is applicable only for the enhanced graphics adapter, VGA or IBM Personal System/2 Display Adapter. | VioSetFont is applicable only for the enhanced graphics adapter, VGA or IBM Personal System/2 Display Adapter. | ||
- | ;Note: Although graphics mode support is provided in VioSetFont, this support is not provided by the Base Video Handlers provided with OS/2. | + | Note: Although graphics mode support is provided in VioSetFont, this support is not provided by the Base Video Handlers provided with OS/2. |
When VioSetFont is issued, the current code page is reset. If [[VioGetCp]] is subsequently issued, the error code ERROR_VIO_USER_FONT is returned. Return code, ERROR_VIO_USER_FONT represents a warning. It indicates that although the font could not be loaded into the adapter using the current mode, the font was saved as part of a special user font code page for use with a later [[VioSetMode]]. Successfully setting a user font sets the special user font code page, just as if a code page of -1 was specified using [[VioSetCp]]. | When VioSetFont is issued, the current code page is reset. If [[VioGetCp]] is subsequently issued, the error code ERROR_VIO_USER_FONT is returned. Return code, ERROR_VIO_USER_FONT represents a warning. It indicates that although the font could not be loaded into the adapter using the current mode, the font was saved as part of a special user font code page for use with a later [[VioSetMode]]. Successfully setting a user font sets the special user font code page, just as if a code page of -1 was specified using [[VioSetCp]]. | ||
Line 31: | Line 40: | ||
The special code page is used in the same way as those code pages specified on the CODEPAGE = statement in CONFIG.SYS. | The special code page is used in the same way as those code pages specified on the CODEPAGE = statement in CONFIG.SYS. | ||
- | ==Bindings== | + | ===== Bindings |
- | ===C=== | + | |
- | <PRE> | + | ====C==== |
+ | <code c> | ||
typedef struct _VIOFONTINFO{ /* viofi */ | typedef struct _VIOFONTINFO{ /* viofi */ | ||
USHORT | USHORT | ||
Line 51: | Line 61: | ||
USHORT | USHORT | ||
- | </PRE> | + | </code> |
- | ===MASM=== | + | ====MASM==== |
- | <PRE> | + | <code asm> |
VIOFONTINFO struc | VIOFONTINFO struc | ||
viofi_cb | viofi_cb | ||
Line 72: | Line 82: | ||
Returns WORD | Returns WORD | ||
- | </PRE> | + | </code> |
- | ==Related Functions== | + | ===== Related Functions ===== |
- | *[[VioGetFont]] | + | |
+ | [[VioGetFont]] | ||
[[http:// | [[http:// | ||
+ | |||
+ | {{page> | ||