installuserfont

Syntax

#include <graphics.h>

int installuserfont(char *name);

Description

name is a file name in the current directory (pathname is not supported) of 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.

Windows Notes

installuserfont is not available in the winbgim implementation.

See also

settextstyle

Example

/* installuserfont 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 */

   getch();

   closegraph();

   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(1);

   }

}