Name

pinq_int_facs − Returns interior and hatch information. 

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

Syntax

void pinq_int_facs (
  Pint         wstype,      /∗ (I) Workstation type ∗/
  Pint         num_elem,    /∗ (I) Number of elements in the application’s
                                   list of hatch styles ∗/
  Pint         start,       /∗ (I) Starting position within the Digital
                                   PHIGS list of hatch styles ∗/
  Pint        ∗error_ind,   /∗ (O) Error indicator ∗/
  Pint_facs   ∗facilities,  /∗ (O) Interior facilities ∗/
  Pint        ∗act_num      /∗ (O) Total number of elements in the list of
                                   hatch styles in Digital PHIGS ∗/
)

Data Structures

typedef struct {
    Pint         num_int_styles;     /∗ number of interior styles ∗/
    Pint_style   int_styles[5];      /∗ list of available interior
                                        styles ∗/
    Pint_list    hatch_styles;       /∗ list of available hatch styles ∗/
    Pint         num_pred_inds;      /∗ number of predefined bundle
                                        indexes ∗/
} Pint_facs;
    typedef enum {
        PSTYLE_HOLLOW,    /∗ hollow interior ∗/
        PSTYLE_SOLID,     /∗ solid interior ∗/
        PSTYLE_PAT,       /∗ patterned interior ∗/
        PSTYLE_HATCH,     /∗ hatched interior ∗/
        PSTYLE_EMPTY      /∗ empty interior ∗/
    } Pint_style;
    typedef struct {
        Pint    num_ints;   /∗ number of Pints in the list ∗/
        Pint   ∗ints;       /∗ list of integers ∗/
    } Pint_list;

Description

pinq_int_facs queries the workstation description table and returns values for the following:

•List of available interior styles

•Total number of available hatch styles

•List of available hatch styles

•Total number of available hatch styles

•Number of predefined interior indexes

The value of the number of available hatch styles has the following interpretations:

Value      Result
------------------------------------------------------------------------
Positive   The list of available hatch styles contains all
           registered hatch styles.
Negative   Two conditions apply:
 
           - Digital PHIGS derives the implementation-specific hatch styles
             directly from the value and the hatch style aspect.
           - The list of available hatch styles contains the registered
             hatch styles supported, the number of which is the absolute
             value of the number of available hatch styles.
------------------------------------------------------------------------

The application must provide the space for the list of hatch styles.  The application passes the address of the list, an array of integers, in the ints field of the hatch_styles field of the facilities argument, and passes the size of the list in the num_elem argument.  Digital PHIGS returns the number of elements written in the list in the num_ints field of the hatch_styles field of the facilities argument. 

See Also

pinq_int_facs_plus
pinq_pred_int_rep
pinq_pred_int_rep_plus
pset_int_style
pset_int_style_ind