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

lsrepeat Subroutine

Purpose

Sets the repeat factor for the current linestyle.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void lsrepeat(Int32 factor)

FORTRAN Syntax

SUBROUTINE LSREPE(factor)
INTEGER*4 factor

Description

The lsrepeat subroutine sets the repeat factor for the current linestyle.

This subroutine is used to create linestyles that are longer than 16 bits by multiplying each bit in the pattern by the value of the factor parameter.

Each bit in the pattern is multiplied successively. For example, if the line pattern is 0000000111111111  and the factor parameter equals 3 , the resulting linestyle is 27 bits on followed by 21 bits off. Line patterns start from the least significant bit.

When a line is drawn, pixels are turned on if there is a 1 (one) in the corresponding position of the linestyle mask and turned off if there is a 0 (zero) in the corresponding position. The valid range of the repeat factor is from 1 to 255.

Note: The operation of this subroutine for the Supergraphics Processor Subsystem is modified. (See "Hardware Considerations" in GL3.2 Version 4 for AIX: Programming Concepts.)

Parameter

factor Multiplier of the linestyle pattern.

Implementation Specifics

This subroutine is part of GL in the AIXwindows Environment/6000 Version 1, Release 2 with AIXwindows/3D Feature.

On the POWER Gt4 and POWER Gt4x adapters, the valid range for the repeat factor is from 1 to 64.

On the POWERstation 730 and POWERgraphics GTO, linestyle repeat factors must be a multiple of 4. The valid range is from 4 to 252 in multiples of 4 with a lowest possible repeat factor of 4.

On the Supergraphics Processor Subsystem, the valid range for the repeat factor is 4 to 252 in multiples of 4. Any other value specified is rounded to the nearest multiple of 4.

On the POWER GXT1000, the valid range for the repeat factor is 1 to 255.

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

Defining a linestyle with the deflinestyle subroutine.

Returning the linestyle repeat count with the getlsrepeat subroutine.

Selecting a linestyle with the setlinestyle subroutine.

AIX Graphics Library Overview, Drawing with Begin-End Style Subroutines, Drawing with Move-Draw Style Subroutines, Drawing NURBS Curves and Surfaces, Drawing Wire Frame Curves and Surface Patches, Setting Drawing Attributes, Understanding the Hardware Used by GL, and Drawing Rectangles, Circles, Arcs, and Polygons.


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