Intel® Fortran Compiler Classic and Intel® Fortran Compiler Developer Guide and Reference
A newer version of this document is available. Customers should click here to go to the newest version.
GRSTATUS
Graphics Function: Returns the status of the most recently used graphics routine. This routine is only available for Windows.
Module
USE IFQWIN
result = GRSTATUS( )
Results
The result type is INTEGER(2). The result is the status of the most recently used graphics function.
Use GRSTATUS immediately following a call to a graphics routine to determine if errors or warnings were generated. Return values less than 0 are errors, and values greater than 0 are warnings.
The following symbolic constants are defined in the IFQWIN.F90 module file for use with GRSTATUS:
Constant  |  
        Meaning  |  
       
|---|---|
$GRFILEWRITEERROR  |  
        Error writing bitmap file  |  
       
$GRFILEOPENERROR  |  
        Error opening bitmap file  |  
       
$GRIMAGEREADERROR  |  
        Error reading image  |  
       
$GRBITMAPDISPLAYERROR  |  
        Error displaying bitmap  |  
       
$GRBITMAPTOOLARGE  |  
        Bitmap too large  |  
       
$GRIMPROPERBITMAPFORMAT  |  
        Improper format for bitmap file  |  
       
$GRFILEREADERROR  |  
        Error reading file  |  
       
$GRNOBITMAPFILE  |  
        No bitmap file  |  
       
$GRINVALIDIMAGEBUFFER  |  
        Image buffer data inconsistent  |  
       
$GRINSUFFICIENTMEMORY  |  
        Not enough memory to allocate buffer or to complete a fill operation  |  
       
$GRINVALIDPARAMETER  |  
        One or more parameters invalid  |  
       
$GRMODENOTSUPPORTED  |  
        Requested video mode not supported  |  
       
$GRERROR  |  
        Graphics error  |  
       
$GROK  |  
        Success  |  
       
$GRNOOUTPUT  |  
        No action taken  |  
       
$GRCLIPPED  |  
        Output was clipped to viewport  |  
       
$GRPARAMETERALTERED  |  
        One or more input parameters was altered to be within range, or pairs of parameters were interchanged to be in the proper order  |  
       
After a graphics call, compare the return value of GRSTATUS to $GROK. to determine if an error has occurred. For example:
IF ( GRSTATUS .LT. $GROK ) THEN
! Code to handle graphics error goes here
ENDIF
The following routines cannot give errors, and they all set GRSTATUS to $GROK:
DISPLAYCURSOR  |  
        GETCOLORRGB  |  
        GETTEXTWINDOW  |  
       
GETBKCOLOR  |  
        GETTEXTCOLOR  |  
        OUTTEXT  |  
       
GETBKCOLORRGB  |  
        GETTEXTCOLORRGB  |  
        WRAPON  |  
       
GETCOLOR  |  
        GETTEXTPOSITION  |  
        
The following table lists some other routines with the error or warning messages they produce for GRSTATUS:
Function  |  
        Possible GRSTATUS error codes  |  
        Possible GRSTATUS warning codes  |  
       
|---|---|---|
ARC, ARC_W  |  
        $GRINVALIDPARAMETER  |  
        $GRNOOUTPUT  |  
       
CLEARSCREEN  |  
        $GRINVALIDPARAMETER  |  
        |
ELLIPSE, ELLIPSE_W  |  
        $GRINVALIDPARAMETER, $GRINSUFFICIENTMEMORY  |  
        $GRNOOUTPUT  |  
       
FLOODFILLRGB  |  
        $GRINVALIDPARAMETER, $GRINSUFFICIENTMEMORY  |  
        $GRNOOUTPUT  |  
       
GETARCINFO  |  
        $GRERROR  |  
        |
GETFILLMASK  |  
        $GRERROR, $GRINVALIDPARAMETER  |  
        |
GETFONTINFO  |  
        $GRERROR  |  
        |
GETGTEXTEXTENT  |  
        $GRERROR  |  
        |
GETIMAGE  |  
        $GRINSUFFICIENTMEMORY  |  
        $GRPARAMETERALTERED  |  
       
GETPIXEL  |  
        $GRBITMAPTOOLARGE  |  
        |
GETPIXELRGB  |  
        $GRBITMAPTOOLARGE  |  
        |
LINETO, LINETO_W  |  
        $GRNOOUTPUT, $GRCLIPPED  |  
       |
LOADIMAGE  |  
        $GRFILEOPENERROR, $GRNOBITMAPFILE, $GRALEREADERROR, $GRIMPROPERBITMAPFORMAT, $GRBITMAPTOOLARGE, $GRIMAGEREADERROR  |  
        |
OUTGTEXT  |  
        $GRNOOUTPUT, $GRCLIPPED  |  
       |
PIE, PIE_W  |  
        $GRINVALIDPARAMETER, $GRINSUFFICIENTMEMORY  |  
        $GRNOOUTPUT  |  
       
POLYGON, POLYGON_W  |  
        $GRINVALIDPARAMETER, $GRINSUFFICIENTMEMORY  |  
        $GRNOOUTPUT, $GRCLIPPED  |  
       
PUTIMAGE, PUTIMAGE_W  |  
        $GRERROR, $GRINVALIDPARAMETER, $GRINVALIDIMAGEBUFFER $GRBITMAPDISPLAYERROR  |  
        $GRPARAMETERALTERED, $GRNOOUTPUT  |  
       
RECTANGLE, RECTANGLE_W  |  
        $GRINVALIDPARAMETER, $GRINSUFFICIENTMEMORY  |  
        $GRNOOUTPUT, $GRCLIPPED  |  
       
REMAPPALETTERGB  |  
        $GRERROR, $GRINVALIDPARAMETER  |  
        |
REMAPALLPALETTERGB  |  
        $GRERROR, $GRINVALIDPARAMETER  |  
        |
SAVEIMAGE  |  
        $GRFILEOPENERROR  |  
        |
SCROLLTEXTWINDOW  |  
        $GRNOOUTPUT  |  
       |
SETBKCOLOR  |  
        $GRINVALIDPARAMETER  |  
        $GRPARAMETERALTERED  |  
       
SETBKCOLORRGB  |  
        $GRINVALIDPARAMETER  |  
        $GRPARAMETERALTERED  |  
       
SETCLIPRGN  |  
        $GRPARAMETERALTERED  |  
       |
SETCOLOR  |  
        $GRPARAMETERALTERED  |  
       |
SETFONT  |  
        $GRERROR, $GRINSUFFICIENTMEMORY  |  
        $GRPARAMETERALTERED  |  
       
SETPIXEL, SETPIXEL_W  |  
        $GRNOOUTPUT  |  
       |
SETPIXELRGB, SETPIXELRGB_W  |  
        $GRNOOUTPUT  |  
       |
SETTEXTCOLOR  |  
        $GRPARAMETERALTERED  |  
       |
SETTEXTCOLORRGB  |  
        $GRPARAMETERALTERED  |  
       |
SETTEXTPOSITION  |  
        $GRPARAMETERALTERED  |  
       |
SETTEXTWINDOW  |  
        $GRPARAMETERALTERED  |  
       |
SETVIEWPORT  |  
        $GRPARAMETERALTERED  |  
       |
SETWINDOW  |  
        $GRINVALIDPARAMETER  |  
        $GRPARAMETERALTERED  |  
       
SETWRITEMODE  |  
        $GRINVALIDPARAMETER  |