Name

pset_light_source_st − Specifies the values for the light source activation and light source deactivation lists. 

Operating States: PHOP, ∗, STOP, ∗
PHIGS PLUS function
Creates a structure element

Syntax

void pset_light_source_st (
  const Pint_list    ∗act_list,     /∗ Activation list ∗/
  const Pint_list    ∗deact_list    /∗ Deactivation list ∗/
)

Data Structures

typedef struct {
    Pint      num_ints;  /∗ number of Pints in the list ∗/
    Pint     ∗ints;      /∗ list of integers ∗/
} Pint_list;

Description

pset_light_source_st specifies the light source activation list and the light source deactivation list values.  When Digital PHIGS interprets an element of this type, it modifies the current light source state entry in the traversal state list according to the two lists associated with the element:

•Digital PHIGS adds the entries in the activation list to the current light source state entry if they are not already in the specified state. 

•Digital PHIGS removes the entries in the deactivation list from the current light source state entry if they are in the specified state. 

The current light source state entry determines the set of active light sources Digital PHIGS uses to display subsequent output primitives.  Each entry is an index of an active light source in the light source table of a workstation. 

Depending on the current edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer.  The pointer then points to the new set light source state element. 

The set light source state element enables and disables light sources specified by the pset_light_source_rep function.  The set light source state element controls a set of light source indexes that Digital PHIGS pushes and pops along with other traversal attributes. 

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element. 

See Also

pinq_light_source_facs
pset_light_source_rep