47 lines
2.3 KiB
Plaintext
47 lines
2.3 KiB
Plaintext
SDL_bdf version 1.2
|
|
|
|
http://www.geocities.com/andre_leiradella/
|
|
|
|
For copyright information see the source files.
|
|
|
|
SDL_bdf is a small library that renders BDF fonts. As of version 1.2, SDL_bdf
|
|
doesn't depend on SDL anymore, you can use it with any graphics library throgh
|
|
it's API, but the bundled exampled uses SDL to show a text with a BDF font on
|
|
the screen.
|
|
|
|
The library has been tested with SDL under Windows but should work on any
|
|
platform/graphics library. The functions provided are:
|
|
|
|
. BDF_Font *BDF_OpenFont(BDF_ReadByte getbyte, void *info, int *error): Opens a
|
|
BDF font, it receives the function that will produce the stream of bytes, the
|
|
user defined void pointer that will be passed to getbyte and a pointer to an
|
|
int that will receive the error code. Returns the BDF font.
|
|
. void BDF_CloseFont(BDF_Font *font): Closes the font and frees all associated
|
|
memory.
|
|
. void BDF_SizeH(BDF_Font *font, char *text, int *x0, int *y0, int *width,
|
|
int *height): Determines the size of the horizontal text, returns the width
|
|
and height of the smallest rectangle that can acomodate the rendered text and
|
|
the start position in x0 and y0 on where the text must be rendered to exactly
|
|
fit the rectangle. This is because the render functions take the y parameter
|
|
as the baseline of the text to allow different fonts (e.g. normal and italic)
|
|
to be mixed in the same line. It handles NULL pointers for pieces of
|
|
information you don't want.
|
|
. void BDF_SizeEntitiesH(BDF_Font *font, char *text, int *x0, int *y0,
|
|
int *width, int *height): Same as above but accepts entities in the
|
|
form &...; (e.g. André)
|
|
. int BDF_DrawH(void *surface, BDF_PutPixel putpixel, BDF_Font *font,
|
|
char *text, int x, int y, unsigned int color): Draws the text at the given
|
|
surface starting at position (x, y). It calls putpixel with the surface,
|
|
coordinates and color to draw the pixel (doesn't clip). Returns the next x
|
|
coordinate to continue to render more text. Only accepts characters in the
|
|
range [0..255].
|
|
. int BDF_DrawEntitiesH(void *, BDF_PutPixel, BDF_Font *, char *, int, int,
|
|
unsigned int): Same as above but accepts entities in the form &...;
|
|
|
|
TODO:
|
|
|
|
. Handle vertical writing.
|
|
. Use a hash table instead of an ordered array to access the glyphs by name.
|
|
. What else? Tell me: leiradella@bigfoot.com
|
|
|