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

pclos Subroutine

Purpose

Closes a filled polygon.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void pclos( )

FORTRAN Syntax

SUBROUTINE PCLOS

Description

The pclos subroutine closes a filled polygon that has been created by using the pmv subroutine and a sequence of calls to the pdr, rpmv, or rpdr subroutines. It is not needed when using the poly or polf subroutines because these procedures close the polygon within their own routines.

The pclos subroutine closes the polygon by connecting the last point with the first. The polygon so defined is filled using the current fill area attributes: pattern, current color, and writemask.

There can be no more than 256 vertices in a polygon. Therefore, there can be no more than 255 calls to the pdr subroutine between calls to the pmv and pclos subroutines.

Note: Be careful not to confuse pclos with the AIX subroutine pclose, which closes an AIX pipe, in the libc.a library.

Example

The example C language program zbuffer1.c uses the pclos subroutine to specify the end of a filled polygon definition.

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

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

Drawing a filled polygon with the polf subroutine.

Drawing a polygon with the poly 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.

Drawing a shaded filled polygon with the splf subroutine.

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


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