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

## rpmv Subroutine

### Purpose

Performs a relative move to the starting point of a filled polygon.

### Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

### C Syntax

```void rpmv
(Coord dx, Coord dy, Coord dz)```
```void rpmvi
(Icoord dx, Icoord dy, Icoord dz)```
```void rpmvs
(Scoord dx, Scoord dy, Scoord dz)```
```void rpmv2
(Coord dx, Coord dy)```
```void rpmv2i
(Icoord dx, Icoord dy)```
```void rpmv2s
(Scoord dx, Scoord dy)```

### FORTRAN Syntax

```SUBROUTINE RPMV(dx, dy, dz)
REAL dx, dy, dz```
```SUBROUTINE RPMVI(dx, dy, dz)
INTEGER*4 dx, dy, dz```
```SUBROUTINE RPMVS(dx, dy, dz)
INTEGER*2 dx, dy, dz```
```SUBROUTINE RPMV2(dx, dy)
REAL dx, dy```
```SUBROUTINE RPMV2I(dx, dy)
INTEGER*4 dx, dy```
```SUBROUTINE RPMV2S(dx, dy)
INTEGER*2 dx, dy```
Note: For FORTRAN users, the INTEGER*2 versions of this subroutine, RPMVS and RPMV2S, 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 rpmv subroutine is the relative version of the pmv subroutine. It specifies a relative move to the starting point in a filled polygon, using the current graphics position as the origin. The rpmv subroutine updates the current graphics position to the new point.

Between calls to the rpmv and pclos subroutines, you can issue calls to the following Graphics Library subroutines only:

Use the lmdef and lmbind subroutines to respecify only materials and their properties.

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

 2-D 3-D Int16 rpmv2s rpmvs Int32 rpmv2i rpmvi float rpmv2 rpmv

The syntax for each of the subroutine forms is the same except for the parameter type. They differ only in that rpmv expects real coordinates, rpmvi expects integer coordinates, and rpmvs expects short integer coordinates. In addition, the rpmv2 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 first corner of the polygon. dy Specifies the distance from the y coordinate of the current graphics position to the y coordinate of the first corner of the polygon. dz Specifies the distance from the z coordinate of the current graphics position to the z coordinate of the first corner of the polygon.

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

Allowing the system to draw concave polygons with the concave subroutine.

Closing a filled polygon with the pclos subroutine.

Specifying the next point in a polygon with the pdr subroutine.

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

Drawing a relative polygon with the rpdr subroutine.

Selecting the shading model used to draw a polygon with the shademodel subroutine.

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

[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]