Blits character pixels from font data area into memory buffer.
int32 BlitFontChar(FontDescriptor *fDesc,uint32 theChar, void *blitInfo, void *dstBuf,int32 dstX,int32 dstY,int32 dstBPR,int32 dstColorIndex,int32 dstBPP)
Blits character pixels from the font data area into a memory buffer, performing any font format specific data decompression as needed.
BlitFontChar()
supports the internals of the text library; it should never be necessary to call this function directly from an application program. If you are implementing your own replacement text library, use BlitFontChar()
to render the font character pixels into your own memory buffer. You can use the standard text library source code as a guide in creating your own text library.
BlitFontChar()
currently supports only 8-bit-per-pixel destination format, and always creates pixels suitable for an 8-bit coded cel with AMV (alternate multiplier value) used to scale pixels already in the cell for anti-aliasing.
GetFontCharInfo()
via its **blitInfo parameter, or NULL. If you pass NULL, an internal call to GetFontCharInfo()
is made. If you are already calling GetFontCharInfo()
before blitting each character, you can eliminate this potentially expensive internal call by saving the blitInfo from your call and passing it to this function.Width of the character, in pixels. Zero indicates no pixels were placed in the destination buffer because the character is not within the range of characters stored in the font.
lib3do.lib, fontlib.h
GetFontCharInfo