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

## rmv Subroutine

### Purpose

Moves the graphics position relative to the current point.

### Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

### C Syntax

```void rmv
(Coord dx, Coord dy, Coord dz)```
```void rmvi
(Icoord dx, Icoord dy, Icoord dz)```
```void rmvs
(Scoord dx, Scoord dy, Scoord dz)```
```void rmv2
(Coord dx, Coord dy)```
```void rmv2i
(Icoord dx, Icoord dy)```
```void rmv2s
(Scoord dx, Scoord dy)```

### FORTRAN Syntax

```SUBROUTINE RMV(dx, dy, dz)
REAL dx, dy, dz```
```SUBROUTINE RMVI(dx, dy, dz)
INTEGER*4 dx, dy, dz```
```SUBROUTINE RMVS(dx, dy, dz)
INTEGER*2 dx, dy, dz```
```SUBROUTINE RMV2(dx, dy)
REAL dx, dy```
```SUBROUTINE RMV2I(dx, dy)
INTEGER*4 dx, dy```
```SUBROUTINE RMV2S(dx, dy)
INTEGER*2 dx, dy```

### Description

The rmv subroutine is the relative version of the move subroutine. It moves the graphics position (without drawing) the specified amount relative to its current value. The value of rmv2(x, y) is equivalent to rmv(x, y, 0.0).

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

 2-D 3-D Int16 rmv2s rmvs Int32 rmv2i rmvi float rmv2 rmv

The syntax for each of the subroutine forms is the same except for the parameter type. They differ only in that rmv expects real coordinates, rmvi expects integer coordinates, and rmvs expects short integer coordinates. In addition, the rmv2* routines assume a 2-D point instead of a 3-D point.

### Parameters

 dx Specifies the distance from the x coordinate of the current graphics position to the x coordinate of the new point. dy Specifies the distance from the y coordinate of the current graphics position to the y coordinate of the new point. dz Specifies the distance from the z coordinate of the current graphics position to the z coordinate of the new point.

### 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.

Moving the current graphics position to a specified point with the move subroutine.

Drawing a relative line with the rdr subroutine.

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

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