SET PATTERN REPRESENTATION(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

SET PATTERN REPRESENTATION − set a pattern attribute bundle on a specified workstation

SYNOPSIS

C Syntax

void
pset_pat_rep ( ws, index, rep )
Pintws;workstation identifier
Pintindex;pattern bundle index
Ppat_rep∗rep;pattern representation pointer

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

SET PATTERN REPRESENTATION sets a pattern attribute bundle on a workstation.

Purpose

SET PATTERN REPRESENTATION sets a pattern attribute bundle on a workstation.

C Input Parameters

wsThe identifier of the workstation.

indexThis is an index to the workstation pattern bundle table.

repA pointer to a Ppat_rep structure. Ppat_rep is defined as:

typedef struct {
Pint_sizedims;/∗ pattern’s dimensions ∗/
Pint∗colr_array;/∗ array of colours ∗/
} Ppat_rep;

Pint_size is defined as:

typedef struct {
Pintsize_x;/∗ dimension (number of divisions) along X ∗/
Pintsize_y;/∗ dimension (number of divisions) along Y ∗/
} Pint_size;

Execution

In the pattern table of the workstation state list, the given index is associated with the specified parameters.

A grid of DX by DY cells is specified with DX being horizontal and DY being vertical. The colour is given individually for each cell by the colour index, which is an index into the colour table of the workstation.

If the workstation supports interior style PATTERN, the pattern table in the workstation state list has predefined entries taken from the workstation description table. A number of these entries are predefined for every workstation of category OUTPUT and OUTIN supporting interior style PATTERN. Any table entry, including the predefined entries, may be redefined with this function.

When area-defining primitives are displayed during structure traversal, if the currently selected interior style is PATTERN, the current or back interior style index in the PHIGS state list refers to an entry in the pattern table. The selection is made either via the interior bundle or individually, depending on the corresponding Aspect Source Flags(ASFs). If the current or back interior style index is not present in the pattern table, then interior style index one is used. If interior style index one is not present, the result is workstation dependent and the interior style PATTERN is not supported for this workstation. The setting of the corresponding ASFs determines which aspects in the entry are used.

During structure traversal, if a pattern colour index specified in the pattern colour array is not available on the workstation, then colour index one is used.

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

059Ignoring function, the specified workstation does not have output capability (in other words, the workstation category is neither OUTPUT, OUTIN, nor MO)

103Ignoring function, setting this bundle table entry would exceed the maximum number of entries allowed in the workstation bundle table

112Ignoring function, the pattern index value is less than one

113Ignoring function, the colour index value is less than zero

116Ignoring function, one of the dimensions of pattern colour array is less than one

Museum