Visible to Intel only — GUID: GUID-FCCAF52D-7A73-453A-91EA-B3808680D856
Visible to Intel only — GUID: GUID-FCCAF52D-7A73-453A-91EA-B3808680D856
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 |