NAME

VI_QClip, VI_QColor, VI_QDash, VI_QFont, VI_QMerge, VI_QPoint, VI_QWidth − query graphics parameters

SYNOPSIS

VI_QClip(lx,ly,hx,hy)
short ∗lx,∗ly;/∗ top left corner of clipping area ∗/
short ∗hx,∗hy;/∗ bottom right corner ∗/

VI_QColor(color)
short ∗color;/∗ current color, true for white ∗/

VI_QDash(dash,dashlen)
unsigned short ∗dash;/∗ dash pattern ∗/
short ∗dashlen;/∗ length of dash pattern ∗/

VI_QFont(fontid,fontname)
short ∗fontid;/∗ current font ID ∗/
char ∗fontname;/∗ current font name ∗/

VI_QMerge(merge)
short ∗merge;/∗ current merge mode ∗/

VI_QPoint(x,y)
short ∗x,∗y/∗ current point ∗/

VI_QWidth(width)
short ∗width;/∗ line width ∗/

DESCRIPTION

These subroutines return the current values of the graphics parameters.  Each subroutine requires an address in which to store the value to be returned.  All of these subroutines force transmission of graphics data in the current buffer. 

VI_QClipReturns the the current clipping rectangle. 

VI_QColorReturns the current color of the screen: 0 means that bits having the binary value “0” will be black on the screen; 1 means that bits having the binary value “1” will be black on the screen. 

VI_QDashReturns the current line dash pattern in the format described for dash (3G). If dashlen is 0, the lines are currently solid. 

VI_QFontReturns the ID and name of the current font.  The font ID is 0 if no font has been set.  The pointer fontname should point to a block of characters large enough to hold a file name along with a string-termination byte.  If you know beforehand the size of your file name, you may allow only as many bytes as required.  Be aware of the string-terminator byte; there must be room for it. 

VI_QMergeReturns the current merge mode in the format described for merge(3G).

VI_QPointReturns the location of the current point.  This command is especially useful after string(3G) has been issued, since character definitions can change the current point in unpredictable ways.

VI_QWidthReturns the current line width as a number between 1 and 16. 

NOTE

VI_Query applies only to the IBM Academic Information Systems experimental display. 

SEE ALSO

clip(3G), color(3G), dash(3G), merge(3G), move(3G), string(3G), width(3G)
 

PRPQs 5799-WZQ/5799-PFF: IBM/4.3  —  31 Mar 1986