Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
WORD EngineGetGlyphBmp(lpFont, ch, wQueryType, lpBits, dwSizeBmp, lpbmm)
LPFONTINFO lpFont;
WORD ch;
WORD wQueryType;
LPSTR lpBits;
DWORD dwSizeBmp;
LPBITMAPMETRICS lpbmm;
 
The EngineGetGlyphBmp function retrieves a bitmap for the glyph specified by
the given character and font. The given font (specified by lpFont) must be
the current engine font, that is it must have been previously set using the
EngineSetFontContext function.
 
Import Module.Ordinal: GDI.305.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
lpFont      Points to a FONTINFO structure specifying the font containing
            the glyph. This structure must have been previously filled using
            the EngineRealizeFont function.
 
ch          Specifies the character value of the glyph to retrieve.
 
wQueryType  Specifies whether to retrieve the glyph as a bitmap. This
            parameter can be one of the following values:
 
            Value                            Meaning
            ────────────────────────────────────────────────────────────────
            FD_QUERY_CHARIMAGE (0x0001)      Retrieve bitmap. The bitmap is
                                             a monochrome bitmap with
                                             scanlines aligned on 32-bit
                                             boundaries. If the glyph bitmap
                                             is greater than 64k bytes, the
                                             scanlines may straddle segment
                                             boundaries (that is, this
                                             function does not attempt to
                                             align scanlines on segment
                                             boundaries). The width of the
                                             glyph may be less than the
                                             bitmap itself. If this is the
                                             case, any extra bits at the end
                                             of each scanline are
                                             undefined.
 
            FD_QUERY_BITMAPMETRICS (0x0004)  Retrieve bitmap metrics.
 
lpBits      Points to the buffer to receive the glyph bitmap.
 
dwSizeBmp   Specifies the size (in bytes) of the buffer to receive the glyph
            bitmap. If the bitmap is larger than the buffer, the function
            returns an error.
 
lpbmm       Points to a BITMAPMETRICS structure that receives the width,
            height, and position of the bitmap relative to the character
            origin.
 
Return Value
 
The function returns the actual number of bytes copied to the buffer. If an
error occurs or the buffer is too small, the function returns 0.
 
See Also
 
EngineRealizeFont, EngineSetFontContext, BITMAPMETRICS
 
 
                                      ♦