[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
_gWriteAt()
Draw graphic text without background
------------------------------------------------------------------------------
C Prototype
#include "llibg.api"
int _gWriteAt(
int iX,
int iY,
DWORD dwFontColor,
int iFontID,
char far * fpString,
int iMode,
int iAttribute
)
Arguments
iX is the pixel-based X coordinate of the starting point.
iY is the pixel-based Y coordinate of the starting point.
dwFontColor is the font color. The range of valid values is limited
to the number of colors available in the selected video mode. For
example, in 16-color modes, valid values are between zero and 15, and in
256-color modes, valid values are between zero and 255.
iFontID is the font handle.
fpString is a pointer to the display text.
iMode is the display mode, which you specify using one of the
following values:
Display Mode Constants
------------------------------------------------------------------------
Constant Display Mode
------------------------------------------------------------------------
LLG_MODE_SET Overwrite existing pixels that are beneath where the
string will be displayed. This is the most common
display mode.
LLG_MODE_AND Perform a logical AND on existing pixels--and on the
display color--that are beneath where the string
will be displayed.
LLG_MODE_OR Perform a logical OR on existing pixels--and on the
display color--that are beneath where the string
will be displayed.
LLG_MODE_XOR Perform a logical XOR on existing pixels--and on the
display color--that are beneath where the string
will be displayed (see Note below).
LLG_MODE_NO_DISPLAY Compute the width of the string without displaying
anything on the screen. Be aware that .FNT fonts
are proportional (e.g., an "m" and an "i" do not use
the same number of pixels).
------------------------------------------------------------------------
Note: LLG_MODE_XOR allows you to move objects around on the screen
without damaging the background. To retrieve the initial background,
simply repeat the function call using the XOR display mode.
iAttribute is the font attribute, which you specify using one or
more of the following values:
Font Attribute Constants
------------------------------------------------------------------------
Constant Font Attribute
------------------------------------------------------------------------
LLG_FONT_BOLD Bold
LLG_FONT_ITALIC Italic
LLG_FONT_UNDERLINE Underline
------------------------------------------------------------------------
To specify more than one attribute, simply add the values together.
Note also that you can specify a value of zero for this parameter if you
do not want to specify any font attributes.
Returns
The length of *fpString in pixels.
Notes
. Restrictions: You cannot use this function unless you have
set the screen to one of the graphic modes using _gModeSet(). This
function respects the screen clipping region as set by _gClipSet().
Files Library is LLIBG.LIB, header file is Llibg.api.
See Also:
_gClipSet()
_gFntLoad()
_gFntSet()
_gModeSet()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson