[ Next Article |
Previous Article |
Book Contents |
Library Home |
Legal |
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.

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