Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ pinq_line_rep_plus(3g) — PHIGS 5.1

Media Vault

Software Library

Restoration Projects

Artifacts Sought

pinq_line_rep_plus(3g)  —  Subroutines

Name

pinq_line_rep_plus − Returns information on the extended polyline representation. 

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

Syntax

void pinq_line_rep_plus (
  Pint                wsid,         /∗ (I) Workstation identifier ∗/
  Pint                index,        /∗ (I) Polyline index ∗/
  Pinq_type           return_type,  /∗ (I) Type of returned values ∗/
  Pint               ∗error_ind,    /∗ (O) Error indicator ∗/
  Pline_bundle_plus  ∗rep           /∗ (O) Extended polyline
                                           representation ∗/
)

 

Data Structures

typedef enum {
    PINQ_SET,        /∗ Use the exact state list values. ∗/
    PINQ_REALIZED    /∗ Use the values approximated by the graphics
                        handler. ∗/
} Pinq_type;
typedef struct {
    Pint                type;          /∗ line type ∗/
    Pfloat              width;         /∗ line width scale factor ∗/
    Pgcolr              colr;          /∗ polyline color ∗/
    Pint                shad_method;   /∗ polyline shading method ∗/
    Pcurve_approx_crit  approx_crit;   /∗ curve approximation criteria ∗/
} Pline_bundle_plus;
    typedef struct {
        Pint     colr_type;   /∗ color type ∗/
        Pcolrv   colr_value;  /∗ color value ∗/
    } Pgcolr;
        typedef union {
            Pint         colr_ind;    /∗ color index ∗/
            Pcolr_rep    colr_rep;    /∗ color representation ∗/
        } Pcolrv;
            typedef union {
                Prgb        rgb;       /∗ red, green, and blue color
                                          specification ∗/
                Pcieluv     cieluv;    /∗ CIELUV color specification ∗/
                Phls        hls;       /∗ hue, lightness, and saturation
                                          color specification ∗/
                Phsv        hsv;       /∗ hue, saturation, and value color
                                          specification ∗/
                Pdata       unsupp;    /∗ color in an unsupported color
                                          model ∗/
                int         impl_dep;  /∗ implementation-defined ∗/
            } Pcolr_rep;
                typedef struct {
                    Pfloat    red;     /∗ red intensity ∗/
                    Pfloat    green;   /∗ green intensity ∗/
                    Pfloat    blue;    /∗ blue intensity ∗/
                } Prgb;
                typedef struct {
                    Pfloat    cieluv_x;      /∗ x coefficient ∗/
                    Pfloat    cieluv_y;      /∗ y coefficient ∗/
                    Pfloat    cieluv_y_lum;  /∗ y luminance ∗/
                } Pcieluv;
                typedef struct {
                    Pfloat    hue;         /∗ hue ∗/
                    Pfloat    lightness;   /∗ lightness ∗/
                    Pfloat    satur;       /∗ saturation ∗/
                } Phls;
                typedef struct {
                    Pfloat    hue;      /∗ hue ∗/
                    Pfloat    satur;    /∗ saturation ∗/
                    Pfloat    value;    /∗ value ∗/
                } Phsv;
                typedef struct {
                    size_t    size;     /∗ size of data ∗/
                    void     ∗data;     /∗ pointer to the data ∗/
                } Pdata;
    typedef struct {
        Pint   type;   /∗ curve approximation criteria type ∗/
        union Pcurve_approx_crit_data {
            struct Pcurve_approx_const_param_subd {
                Pint   count;  /∗ count ∗/
            } const_param_subd;
            struct Pcurve_approx_chordal_size_wc {
                Pfloat  approx;  /∗ approximation value ∗/
            } chordal_size_wc;
            struct Pcurve_approx_chordal_size_npc {
                Pfloat  approx;  /∗ approximation value ∗/
            } chordal_size_npc;
            struct Pcurve_approx_chordal_size_dc {
                Pfloat  approx;  /∗ approximation value ∗/
            } chordal_size_dc;
            struct Pcurve_approx_chordal_dev_wc {
                Pfloat  approx;  /∗ approximation value ∗/
            } chordal_dev_wc;
            struct Pcurve_approx_chordal_dev_npc {
                Pfloat  approx;  /∗ approximation value ∗/
            } chordal_dev_npc;
            struct Pcurve_approx_chordal_dev_dc {
                Pfloat  approx;  /∗ approximation value ∗/
            } chordal_dev_dc;
            struct Pcurve_approx_rel_wc {
                Pfloat  approx;  /∗ approximation value ∗/
            } rel_wc;
            struct Pcurve_approx_rel_npc {
                Pfloat  approx;  /∗ approximation value ∗/
            } rel_npc;
            struct Pcurve_approx_rel_dc {
                Pfloat  approx;  /∗ approximation value ∗/
            } rel_dc;
            Pdata   unsupp;    /∗ unsupported curve approximation
                                  criteria data ∗/
        } data;
    } Pcurve_approx_crit;

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
Color types                  PCOLR_INDIRECT           Indirect (indexed)
                                                      color
                             PCOLR_RGB                Direct specification
                                                      of red, green, and
                                                      blue
                             PCOLR_CIELUV             Direct specification
                                                      in the format of the
                                                      Commission Inter-
                                                      nationale de
                                                      l’Eclairage
                             PCOLR_HSV                Direct specification
                                                      of hue, saturation,
                                                      and value
                             PCOLR_HLS                Direct specification
                                                      of hue, lightness,
                                                      and saturation
Line shading methods         PLINE_SHAD_METHOD_NONE   No interpolation,
                                                      constant shading
                             PLINE_SHAD_METHOD_COLR   Linear interpolation
                                                      of color
Curve approximation          PCURVE_APPROX_WS_DEP     Workstation-dependent
                                                      method
                             PCURVE_APPROX_CONST_     Constant parametric
                             PARAM_SUBD               subdivision between
                                                      knots
                             PCURVE_APPROX_CHORDAL_   Chordal size, in
                             SIZE_WC                  world coordinate
                                                      units
                             PCURVE_APPROX_CHORDAL_   Chordal size, in
                             SIZE_NPC                 normalized pro-
                                                      jection units
                             PCURVE_APPROX_CHORDAL_   Chordal size, in
                             SIZE_DC                  device coordinate
                                                      units
                             PCURVE_APPROX_CHORDAL_   Chordal deviation,
                             DEV_WC                   in world coordinates
                             PCURVE_APPROX_CHORDAL_   Chordal deviation, in
                             DEV_NPC                  normalized projection
                                                      coordinates
                             PCURVE_APPROX_CHORDAL_   Chordal deviation, in
                             DEV_DC                   device coordinates
                             PCURVE_APPROX_REL_WC     Relative, in world
                                                      coordinate units
                             PCURVE_APPROX_REL_NPC    Relative, in
                                                      normalized projection
                                                      coordinates
                             PCURVE_APPROX_REL_DC     Relative, in device
                                                      coordinate units
---------------------------------------------------------------------------

Description

pinq_line_rep_plus returns information on the extended polyline representation, including the line type, line width, line color, and shading method. 

See Also

pinq_list_line_inds
pinq_line_rep
pinq_pred_line_rep
pinq_pred_line_rep_plus
pset_line_rep
pset_line_rep_plus

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026