curs() [2/2]

int pgplot::device::curs ( float &  x, float &  y, char &  ch  )

inline

read cursor position, with anchor.

• If mode=0, the anchor point is ignored and the routine behaves like PGCURS.
• If mode=1, a straight line is drawn joining the anchor point and the cursor position.
• If mode=2, a hollow rectangle is extended as the cursor is moved, with one vertex at the anchor point and the opposite vertex at the current cursor position; the edges of the rectangle are horizontal and vertical.
• If mode=3, two horizontal lines are extended across the width of the display, one drawn through the anchor point and the other through the moving cursor position. This could be used to select a Y-axis range when one end of the range is known.
• If mode=4, two vertical lines are extended over the height of the display, one drawn through the anchor point and the other through the moving cursor position. This could be used to select an X-axis range when one end of the range is known.
• If mode=5, a horizontal line is extended through the cursor position over the width of the display. This could be used to select an X-axis value such as the start of an X-axis range. The anchor point is ignored.
• If mode=6, a vertical line is extended through the cursor position over the height of the display. This could be used to select a Y-axis value such as the start of a Y-axis range. The anchor point is ignored.
• If mode=7, a cross-hair, centered on the cursor, is extended over the width and height of the display. The anchor point is ignored.

Returns

1 if the call was successful; 0 if the device has no cursor or some other error occurs.

Parameters

mode	(input): display mode (0, 1, ..7: see above).
posn	(input): if posn=1, PGBAND attempts to place the cursor at point (x,y); if posn=0, it leaves the cursor at its current position. (On some devices this request may be ignored.)
xref	(input): the world x-coordinate of the anchor point.
yref	(input): the world y-coordinate of the anchor point.
x	(in/out): the world x-coordinate of the cursor.
y	(in/out): the world y-coordinate of the cursor.
ch	(output): the character typed by the user; if the device has no cursor or if some other error occurs, the value CHAR(0) [ASCII NUL character] is returned.

Definition at line 118 of file device.h.

References curs().

    { return(this->curs(&x, &y, &ch)); }

Here is the call graph for this function: