pinq_line_facs(3g) — Subroutines

Name

pinq_line_facs − Returns information about line types, line widths, and polyline indexes.

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

Syntax

void pinq_line_facs (
Pint         wstype,      /∗ (I) Workstation type ∗/
Pint         num_elem,    /∗ (I) Number of polyline types in the
                                   application list ∗/
Pint         start,       /∗ (I) Starting position within the Digital
                                   PHIGS list ∗/
Pint        ∗error_ind,   /∗ (O) Error indicator ∗/
Pline_facs ∗fac,         /∗ (O) Number of available line types in
                                   Digital PHIGS ∗/
Pint        ∗act_num      /∗ (O) Total number of available polyline
                                   types in the Digital PHIGS list ∗/
)

Data Structures

typedef struct {
    Pint_list   types;          /∗ list of line types ∗/
    Pint        num_widths;     /∗ number of available line widths ∗/
    Pfloat      nom_width;      /∗ nominal line width ∗/
    Pfloat      min_width;      /∗ minimum line width ∗/
    Pfloat      max_width;      /∗ maximum line width ∗/
    Pint        num_pred_inds; /∗ number of predefined bundle indexes ∗/
} Pline_facs;
    typedef struct {
        Pint     num_ints;   /∗ number of Pints in the list ∗/
        Pint    ∗ints;       /∗ list of integers ∗/
    } Pint_list;

Constants

Data Structure Constants     Constant               Description
---------------------------------------------------------------------------
Line types                   PLINE_SOLID            Solid line
                             PLINE_DASH             Dashed line
                             PLINE_DOT              Dotted line
                             PLINE_DOTDASH          Dashed-dotted line
                             PLINE_DASH_2_DOT       Dash-2-dots line
                             PLINE_DASH_3_DOT       Dash-3-dots line
                             PLINE_LONG_DASH        Long dashed line
                             PLINE_LONG_SHORT_DAS   Long-short dashed line
                             PLINE_SPACED_DASH      Spaced dashed line
                             PLINE_SPACED_DOT       Spaced dotted line
                             PLINE_DOUBLE_DOT       Double-dotted line
                             PLINE_TRIPLE_DOT       Triple-dotted line
                             PLINE_CENTER           Long line, dash, long
                                                    line
                             PLINE_PHANTOM          Long line, two dashes,
                                                    long line
---------------------------------------------------------------------------

Description

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

•Number of available line types

•List of available line types

•Number of available line widths

•Nominal line width, in device coordinates

•Minimum and maximum line widths, in device coordinates

•Number of predefined polyline indexes

The value of the number of available line types has the following interpretations:

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

The application must provide the space used by the list. The application passes the address of the list, an array of integers, in the ints field of the types field of the fac argument, and passes the size in the num_elem argument. Digital PHIGS returns the number of elements written to the list in the num_ints field of the types field of the fac argument.

If Digital PHIGS returns 0 as the number of available line widths, the workstation supports a continuous range of line widths.