[ Previous | Next | Contents | Glossary | Home | Search ]
GL3.2 for AIX: Graphics Library (GL) Technical Reference

## move Subroutine

### Purpose

Moves the current graphics position to a specified point.

### Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

### C Syntax

```void move
(Coord x, Coord y, Coord z)```
```void movei
(Icoord x, Icoord y, Icoord z)```
```void moves
(Scoord x, Scoord y, Scoord z)```
```void move2
(Coord x, Coord y)```
```void move2i
(Icoord x, Icoord y)```
```void move2s
(Scoord x, Scoord y)```

### FORTRAN Syntax

```SUBROUTINE MOVE(x, y, z)
REAL x, y, z```
```SUBROUTINE MOVEI(x, y, z)
INTEGER*4 x, y, z```
```SUBROUTINE MOVES(x, y, z)
INTEGER*2 x, y, z```
```SUBROUTINE MOVE2(x, y)
REAL x, y```
```SUBROUTINE MOVE2I(x, y)
INTEGER*4 x, y```
```SUBROUTINE MOVE2S(x, y)
INTEGER*2 x, y```
Note: For FORTRAN users, the INTEGER*2 versions of this subroutine, MOVES and MOVE2S, should not be called with integer constant parameters. For example, 2 is an integer constant; JJ is an integer variable. The XL FORTRAN compiler, invoked by the xlf command, stores all integer constants as long integers (INTEGER*4), not as short integers (INTEGER*2). Invoking one of the short versions of this subroutine with an integer constant will result in unexpected behavior.

### Description

The move subroutine changes (without drawing) the current graphics position to the point specified by the x, y, and z parameters. The graphics position is the point from which the next drawing routine starts drawing.

The value of move2(x, y) is equivalent to move(x, y, 0.0).

The six different forms for the move subroutine are as follows:

 2-D 3-D Int16 move2s moves Int32 move2i movei float move2 move

The syntax for each of the subroutine forms is the same except for the parameter types. They differ only in that move expects real coordinates, movei expects integer coordinates, and moves expects short integer coordinates. In addition, the move2* routines assume a 2-D point instead of a 3-D point.

Note: This subroutine cannot be used to add to a display list.

### Parameters

 x Specifies the new x coordinate for the current graphics position. y Specifies the new y coordinate for the current graphics position. z Specifies the new z coordinate for the current graphics position.

### Example

The example C language program depthcue.c uses the movei subroutine when defining a graphical object to move the graphics position without drawing any lines.

### Implementation Specifics

This subroutine is part of GL in the AIXwindows Environment/6000 Version 1, Release 2 with AIXwindows/3D Feature.

### Files

 /usr/include/gl/gl.h Contains C language constant and variable type definitions for GL. /usr/include/gl/fgl.h Contains FORTRAN constant and variable type definitions for GL.

### Related Information

Drawing a line with the draw subroutine.

Specifying the starting point for a polygon with the pmv subroutine.

Drawing a point with the pnt subroutine.

Drawing a relative line with the rdr subroutine.

Moving the current graphics position to a point relative to the current point with the rmv subroutine.

AIX Graphics Library Overview and Drawing with Move-Draw Style Subroutines.

[ Previous | Next | Contents | Glossary | Home | Search ]