installuserfont

Loads a font file (.CHR) that is not built into the BGI system.

Defined in header <graphics.h>

Syntax

#include <graphics.h>
int far installuserfont(char far *name);

Portability

Remarks

name is a path name to a font file containing a stroked font. Up to twenty fonts can be installed at one time.

Return value

installuserfont returns a font ID number that can then be passed to settextstyle to select the corresponding font. If the internal font table is full, a value of -11 (grError) is returned.

See also

• settextstyle

Example

#include <graphics.h>
#include <stdlib.h>
#include <stdio.h>
#include <conio.h>

/* function prototype  */
void checkerrors (void);
int main (void)
{
   /* request autodetection  */
   int gdriver = DETECT,  gmode;
   int userfont;
   int midx, midy;
   /* initialize graphics  and local variables
   initgraph(&gdriver,  &gmode, "");

   midx   getmaxx () / 2;
   midy   getmaxy () / 2;

   /* check for any  initialization errors */
   checkerrors ();
   /* install a user-defined  font file */
   userfont = installuserfont ("USER.CHR");
   /* check for any  installation errors */
   checkerrors ();

   /* select the user  font */
   settextstyle (userfont, HORIZ_DIR, 4);

   /* output some text  */
   outtextxy (midx, midy, "Testing!");

   /* clean up  */
   getchO;
   closegraphO  ;
   return 0;
}
/* check for and report  any graphics errors */
void checkerrors (void)
{
   int errorcode;
   /* read result of  last graphics operation */
   errorcode = graphresult () ;
   if ■(errorcode != grOk) {
      printf ("Graphics error: %s\n", grapherrormsg(errorcode)
      printf ("Press any key to halt:");
      getch ();
exit(l);

Differences from modern implementations

Nothing recorded yet.

Modern references

• Microsoft C runtime (search)

These are search links, not yet checked by hand.

Stable link: /3.1/graphics.h/installuserfont/ · short form /3.1/installuserfont/