pinq_light_source_facs(3g) — Subroutines

Name

pinq_light_source_facs − Returns light source information.

Operating States: PHOP, ∗, ∗, ∗
PHIGS PLUS function

Syntax

void pinq_light_source_facs (

Pint         wstype,               /∗ (I) Workstation type ∗/
Pint         num_elems_appl_list, /∗ (I) Number of elements in the
                                            application list ∗/
Pint         start,                /∗ (I) Starting position within the
                                            Digital PHIGS list of light
                                            sources ∗/
Pint        ∗error_ind,            /∗ (O) Error indicator ∗/
Pint_list   ∗types,                /∗ (O) List of available light source
                                            types ∗/
Pint        ∗num_elems_impl_list, /∗ (O) Total number of elements in
                                            the Digital PHIGS list ∗/
Pint        ∗max_lights,           /∗ (O) Maximum number of simulta-
                                            neously active nonambient
                                            lights ∗/
Pint        ∗num_indices           /∗ (O) Number of predefined light
                                            source indexes ∗/
)

Data Structures

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

Constants

Data Structure             Constant                 Description
Constants
---------------------------------------------------------------------------
Light source types         PLIGHT_SOURCE_AMB        Ambient lighting
                           PLIGHT_SOURCE_DIR        Infinite (directional)
                                                    lighting
                           PLIGHT_SOURCE_POS        Positional lighting
                           PLIGHT_SOURCE_SPOT       Spot lighting
---------------------------------------------------------------------------

Description

pinq_light_source_facs returns values for the following:

•Maximum number of light source table entries

•Number of predefined light source indexes

•List of light source types supported

•Maximum number of simultaneously active nonambient light source table entries

•Total number of light source types supported

The application must provide the space for the list. The application passes the address of the list of light source types to Digital PHIGS in the ints field of the types argument. The application passes the list size to Digital PHIGS in the num_elems_appl_list argument.