GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  LOAD_FONT (3)

NAME

load_font - Loads a font from a file. Allegro game programming library.

CONTENTS

Synopsis
Description
See Also

SYNOPSIS

#include <allegro.h>

FONT *load_font(const char *filename, RGB *pal, void *param);

DESCRIPTION

Loads a font from a file. At present, this supports loading fonts from a GRX format .fnt file, a 8x8 or 8x16 BIOS format .fnt file, a datafile or any bitmap format that can be loaded by load_bitmap().

If the font contains palette information, then the palette is returned in the second parameter, which should be an array of 256 RGB structures (a PALETTE). The pal argument may be NULL. In this case, the palette data, if present, is simply not returned.

The third parameter can be used to pass specific information to a custom loader routine. Normally, you can just leave this as NULL. Note that another way of loading fonts is embedding them into a datafile and using the datafile related functions.

Example:

   FONT *myfont;
   PALETTE palette;
   ...
   myfont = load_font("my_font.pcx", palette, NULL);
   if (!myfont)
      abort_on_error("Couldn’t load font!");
   ...
   textout_centre_ex(screen, myfont, "This is my own pretty font!",
                     SCREEN_W / 2, SCREEN_H / 2, white, black);
   ...
   destroy_font(myfont);

RETURN VALUE

Returns a pointer to the font or NULL on error. Remember that you are responsible for destroying the font when you are finished with it to avoid memory leaks.

SEE ALSO

register_font_file_type(3), load_bitmap(3), load_dat_font(3), load_bios_font(3), load_grx_font(3), load_grx_or_bios_font(3), load_bitmap_font(3), load_txt_font(3), destroy_font(3), exfont(3)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro LOAD_FONT (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.