rdr Subroutine

GL3.2 for AIX: Graphics Library (GL) Technical Reference

rdr Subroutine

Purpose

Draws a line relative to the current graphics point.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void rdr
(Coord dx, Coord dy, Coord dz)

void rdri
(Icoord dx, Icoord dy, Icoord dz)

void rdrs
(Scoord dx, Scoord dy, Scoord dz)

void rdr2
(Coord dx, Coord dy)

void rdr2i
(Icoord dx, Icoord dy)

void rdr2s
(Scoord dx, Scoord dy)

FORTRAN Syntax

SUBROUTINE RDR(dx, dy, dz)
REAL dx, dy, dz

SUBROUTINE RDRI(dx, dy, dz)
INTEGER*4 dx, dy, dz

SUBROUTINE RDRS(dx, dy, dz)
INTEGER*2 dx, dy, dz

SUBROUTINE RDR2(dx, dy)
REAL dx, dy

SUBROUTINE RDR2I(dx, dy)
INTEGER*4 dx, dy

SUBROUTINE RDR2S(dx, dy)
INTEGER*2 dx, dy

Description

The rdr subroutine is the relative version of the draw subroutine. It connects the point dx, dy, dz and the current graphics position with a line segment, using the current line attributes: linestyle, linewidth, color (if in depth-cue mode, the depth-cued color is used), and writemask.

The rdr subroutine updates the current graphics position to the specified point.

Note: Do not place routines that invalidate the current graphics position within sequences of moves and draws.

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

	2-D	3-D
Int16	rdr2s	rdrs
Int32	rdr2i	rdri
float	rdr2	rdr

The syntax for each of the subroutine forms is the same except for the parameter type. They differ only in that rdr expects real coordinates, rdri expects integer coordinates, and rdrs expects short integer coordinates. In addition, the rdr2* 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 point with the pnt subroutine.

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

AIX Graphics Library Overview, Drawing with Move-Draw Style Subroutines, Performing Depth-Cueing, Setting Drawing Attributes, and Working with Coordinate Systems.