===== getmodename =====


====Syntax of getmodename ==== 
 <code c>
#include <graphics.h>
char *getmodename(int mode_number);
  </code>


==== Description of getmodename ==== 
<code c>
getmodename accepts a graphics mode number as input and returns a string
containing the name of the corresponding graphics mode. The mode names
are embedded in each driver. The return values ("320*200 CGA P1,"
"640*200 CGA", and so on) are useful for building menus or displaying
status.
</code>


==== Example of getmodename ====
<code c>
/* getmodename example */

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

int main(void)
{
   /* request autodetection */
   int gdriver = DETECT, gmode, errorcode;
   int midx, midy, mode;
   char numname[80], modename[80];

   /* initialize graphics and local variables */
   initgraph(&gdriver, &gmode, "");

   /* read result of initialization */
   errorcode = graphresult();
   if (errorcode != grOk) {  /* an error occurred */
printf("Graphics error: %s\n", grapherrormsg(errorcode));

printf("Press any key to halt:");
getch();
exit(1);   /* terminate with an error code */
   }
   midx = getmaxx() / 2;
   midy = getmaxy() / 2;

   /* get mode number and name strings */
   mode = getgraphmode();
   sprintf(numname, "%d is the current mode number.", mode);
   sprintf(modename, "%s is the current graphics mode.",getmodename
(mode));

   /* display the information */
   settextjustify(CENTER_TEXT, CENTER_TEXT);
   outtextxy(midx, midy, numname);

   outtextxy(midx, midy+2*textheight("W"), modename);

   /* clean up */
   getch();
   closegraph();
   return 0;
}
</code>


==== See also ====
[[getmaxmode]]
[[getmoderange]]


===== output of getmodename example ===== 

    no output of example at the moment
    do not hesitate and add it...