splf Subroutine

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

splf Subroutine

Purpose

Draws a shaded filled polygon.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void splf
(Int32 n,
Coord parray[ ][3],
Colorindex iarray[ ])

void splfi
(Int32 n,
Icoord parray[ ][3],
Colorindex iarray[ ])

void splfs
(Int32 n,
Scoord parray[ ][3],
Colorindex iarray[ ])

void splf2
(Int32 n,
Coord parray[ ][2],
Colorindex iarray[ ])

void splf2i
(Int32 n,
Icoord parray[ ][2],
Colorindex iarray[ ])

void splf2s
(Int32 n,
Scoord parray[ ][2],
Colorindex iarray[ ])

FORTRAN Syntax

SUBROUTINE SPLF(n, parray, iarray)
INTEGER*4 n
REAL parray(3,n)
INTEGER*2 iarray(n)

SUBROUTINE SPLFI(n, parray, iarray)
INTEGER*4 n
INTEGER*4 parray(3,n)
INTEGER*2 iarray(n)

SUBROUTINE SPLFS(n, parray, iarray)
INTEGER*4 n
INTEGER*2 parray(3,n)
INTEGER*2 iarray(n)

SUBROUTINE SPLF2(n, parray, iarray)
INTEGER*4 n
REAL parray(2,n)
INTEGER*2 iarray(n)

SUBROUTINE SPLF2I(n, parray, iarray)
INTEGER*4 n
INTEGER*4 parray(2,n)
INTEGER*2 iarray(n)

SUBROUTINE SPLF2S(n, parray, iarray)
INTEGER*4 n
INTEGER*2 parray(2,n)
INTEGER*2 iarray(n)

All of the preceding routines are functionally the same. They differ only in the type declarations of their parameters and in whether they assume a two- or three-dimensional screen.

Description

The splf subroutine draws Gouraud-shaded polygons using the current pattern and writemask. Polygons are represented as arrays of points. The first and last points automatically connect to close a polygon. After the polygon is drawn, the current graphics position is set to the first point in the array.

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

	2-D	3-D
Int16	splf2s	splfs
Int32	splf2i	splfi
float	splf2	splf

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

This subroutine must be used in color map mode.
This subroutine cannot be used to add to a display list.

Parameters

n	Specifies the number of vertices in the polygon. There can be no more than 256 vertices in a single polygon.
parray	Specifies an array containing the vertices of a polygon.
iarray	Specifies an array containing the color map indexes that determine the intensities of the vertices 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

Setting color map mode as the current mode with the cmode subroutine.

Allowing the system to draw concave polygons with the concave 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 polygon with the poly subroutine.

Drawing a filled rectangle with the rectf subroutine.

Drawing a relative polygon with the rpdr subroutine.

Moving the current graphics position to a starting point for a filled polygon relative to the current point with the rpmv subroutine.

AIX Graphics Library Overview, Setting Drawing Attributes, Drawing Rectangles, Circles, Arcs, and Polygons.