inquire_current_position(3G)

NAME

intinquire_current_position2d, inquire_current_position2d, inquire_current_position3d − return the current pen position.

SYNOPSIS

C Syntax:

void intinquire_current_position2d(fildes,x,y);
int fildes,*x,*y;

void inquire_current_position2d(fildes,x,y);
int fildes;
float *x,*y;

void inquire_current_position3d(fildes,x,y,z);
int fildes;
float *x,*y,*z;

FORTRAN77 Syntax:

subroutine intinquire_current_position2d(fildes,x,y);
integer*4 fildes,x,y;

subroutine inquire_current_position2d(fildes,x,y);
integer*4 fildes;
real x,y;

subroutine inquire_current_position3d(fildes,x,y,z);
integer*4 fildes;
real x,y,z;

Pascal Syntax:

procedure intinquire_current_position2d(fildes:integer;var x,y:integer);

procedure inquire_current_position2d(fildes:integer; var x,y:real);

procedure inquire_current_position3d(fildes:integer; var x,y,z:real);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.

Output Parameters

x,y,z The current pen position in modelling coordinates.

Discussion

Intinquire_current_position2d, inquire_current_position2d, and inquire_current_position3d return the current modelling pen position. The current modelling pen position is defined to be the point where the last vector operation ended. The vector operations are move2d, move3d, intmove2d, draw2d, draw3d, intdraw2d, polyline2d, polyline3d, and intpolyline2d. All other commands leave the current position in a device-dependent location.

The current pen position for device coordinate operations is entirely different than that of modelling coordinates. Device coordinate current pen position is only consistent between device coordinate operations. After any modelling coordinate operation, a dcmove should be performed before any other device coordinate operations.

Integer operations are only available using the INT_XFORM gopen mode. When in INT_XFORM mode, floating point operations are not available for that file descriptor. Floating point operations are the default, or can be specified explicitly with FLOAT_XFORM mode. For a list of integer operations, floating point operations, and common operations, see the starbase.3g manual page.

Museum

Related Articles