MOVE(3G)

NAME

move2d, move3d, dcmove, intmove2d − update current pen position and move physical pen to that location

SYNOPSIS

C Syntax:

void move2d(fildes,x,y);
int fildes;
float x,y;

void move3d(fildes,x,y,z);
int fildes;
float x,y,z;

void dcmove(fildes,dcx,dcy);
int fildes,dcx,dcy;

void intmove2d(fildes,x,y);
int fildes,x,y;

FORTRAN77 Syntax:

subroutine move2d(fildes,x,y)
integer*4 fildes
real x,y

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

subroutine dcmove(fildes,dcx,dcy)
integer*4 fildes,dcx,dcy

subroutine intmove2d(fildes,x,y)
integer*4 fildes,x,y

Pascal Syntax:

procedure move2d(fildes:integer;x,y:real);

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

procedure dcmove(fildes,dcx,dcy:integer);

procedure intmove2d(fildes,x,y:integer);

DESCRIPTION

Input Parameters

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

x,y,z Defines the position to which the current pen position is moved (updated) in world coordinate values.

dcx,dcy Defines the position to which the current pen position is moved (updated) in device coordinate values.

Discussion

Move2d, intmove2d, and move3d update the current pen position in world coordinates to the specified position. If the device identified by fildes has a physical pen, the physical pen is also relocated to the current pen position.

Dcmove performs an equivalent operation in device coordinates, but does not perform any transformation or clipping steps.

World coordinate current pen position is completely independent from device coordinate pen position. If you are switching between the two coordinate systems, be sure to do a move as the first procedure after changing coordinate systems before doing any other work with the new coordinates.

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

For increased performance for move2dand move3d, macros can be used to generate in-line code for C. See "Move and Draw Macros" in Starbase Graphics Techniques − HP-UX Concepts and Tutorials.

Museum