|
|
|
@ -285,11 +285,12 @@ the rendering area. A plane can be moved off-screen entirely, in which case
|
|
|
|
|
it will not be visible following rasterization; it can also be partially
|
|
|
|
|
off-screen.
|
|
|
|
|
|
|
|
|
|
A plane has a virtual cursor; move it with **ncplane_cursor_move_yx**.
|
|
|
|
|
Specifying -1 as either coordinate will hold that axis constant. Unless
|
|
|
|
|
coordinates are specified for a call, action takes place at the plane's
|
|
|
|
|
virtual cursor, which automatically moves along with output. The current
|
|
|
|
|
virtual cursor location can be acquired with **ncplane_cursor_yx**.
|
|
|
|
|
A plane has a virtual cursor; Set its new position with **ncplane_cursor_move_yx**.
|
|
|
|
|
Specifying -1 as one or both coordinates will hold that axis constant. You may
|
|
|
|
|
move a cursor relatively to its current position with **ncplane_cursor_move_rel**.
|
|
|
|
|
Unless coordinates are specified for a call, action takes place at the plane's
|
|
|
|
|
virtual cursor, which automatically moves along with output. The current virtual
|
|
|
|
|
cursor location can be acquired with **ncplane_cursor_yx**.
|
|
|
|
|
|
|
|
|
|
**ncplane_yx** returns the coordinates of the specified plane's origin, relative
|
|
|
|
|
to the plane to which it is bound. Either or both of ***y*** and ***x*** may
|
|
|
|
@ -440,6 +441,9 @@ if they specify any area beyond the plane.
|
|
|
|
|
**ncplane_cursor_move_yx** returns -1 if the coordinates are beyond the
|
|
|
|
|
dimensions of the specified plane (except for the special value -1).
|
|
|
|
|
|
|
|
|
|
**ncplane_cursor_move_rel** returns -1 if the coordinates are beyond the
|
|
|
|
|
dimensions of the specified plane.
|
|
|
|
|
|
|
|
|
|
Functions returning **int** return 0 on success, and non-zero on error.
|
|
|
|
|
|
|
|
|
|
All other functions cannot fail (and return **void**).
|
|
|
|
|