Name

pset_pat_rep − Defines a pattern table index. 

Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function

Syntax

void pset_pat_rep (
  Pint              wsid,       /∗ (I) Workstation identifier ∗/
  Pint              pat_ind,    /∗ (I) Pattern index ∗/
  const Ppat_rep   ∗pat_bundle  /∗ (I) Pattern representation ∗/
)

Data Structures

typedef struct {
    Pint_size    dims;         /∗ pattern’s dimensions ∗/
    Pint        ∗colr_array;   /∗ color index array ∗/
} Ppat_rep;
    typedef struct {
        Pint     size_x;   /∗ x size ∗/
        Pint     size_y;   /∗ y size ∗/
    } Pint_size;

Description

pset_pat_rep allows you to redefine an existing pattern table index, or to define a new pattern table index.  This is accomplished by specifying the number of cells high, the number of cells wide, and an array containing each cell’s color index fill area, associated with the specified bundle index. 

If the workstation supports the pattern interior style, the pattern table in the workstation state list predefines entries taken from the workstation description table. You can redefine any table entry using this function. 

When fill areas or fill area sets are displayed during structure traversal and the interior style is PATTERN, the current interior style index in the PHIGS traversal state list refers to an entry in the pattern table.  If the current interior style index is unavailable in the pattern table, PHIGS uses interior style index 1.  If interior style index 1 is unavailable (interior style pattern is unsupported), the result is workstation-dependent. 

If the pattern color index specified in the pattern color index array is unavailable on the workstation, PHIGS uses color index 1. 

Attribute values passed to this function must be valid for the specified workstation.  For information, see the appropriate device-specific chapter in the Device Specifics Reference Manual for DEC GKS and DEC PHIGS. 

Digital PHIGS Version 4.1 does not support this function.

See Also

pinq_list_pat_inds
pinq_pat_facs
pinq_pat_rep
pinq_pred_pat_rep
pinq_ws_st_table
pset_indiv_asf
pset_pat_ref_point_vecs
pset_pat_rep_plus
pset_pat_size