Name

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

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

Old Syntax

DSLSS (NACT, ACTLST, NDACT, DEACTL)

Argument       Data Type      Access     Description
---------------------------------------------------------------------------
NACT           Integer        Read       Length of the activation list
ACTLST(NACT)   Array of       Read       Light activation list
               integers
NDACT          Integer        Read       Length of the deactivation list
DEACTL(NDACT)  Array of       Read       Light deactivation list
               integers
---------------------------------------------------------------------------

New Syntax

PSLSS (NACTI, ACTLST, NDEAI, DEALST)

Argument       Data Type      Access     Description
---------------------------------------------------------------------------
NACTI          Integer        Read       Number of activation indexes
ACTLST(NACTI)  Array of       Read       Light activation list
               integers
NDEAI          Integer        Read       Number of deactivation indexes
DEALST(NDEAI)  Array of       Read       Light deactivation list
               integers
---------------------------------------------------------------------------

Description

PSLSS 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 PSLSR 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. 

The new function syntax conforms to the ISO Fortran standard.  Digital recommends that you code using the new function syntax. 

See Also

PQLSF
PSLSR