pset_param_surf_chars(3g) — Subroutines

Name

pset_param_surf_chars − Sets the value of the current parametric surface characteristics entry in the traversal state list.

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

Syntax

void pset_param_surf_chars (
const Pparam_surf_chars    ∗data   /∗ (I) Data record containing
                                            parametric surface
                                            characteristics ∗/
)

Data Structures

typedef struct {
    Pint     type;   /∗ parametric surface characteristics type ∗/
    union Pparam_surf_chars_data {
        struct Pparam_surf_isoparam {
            Pplacement   placement;      /∗ curve placement ∗/
            Pint         num_u_curves;   /∗ curve count in u direction ∗/
            Pint         num_v_curves;   /∗ curve count in v direction ∗/
        } isoparam;
        struct Pparam_surf_level_mc {
            Ppoint3        origin;    /∗ origin point ∗/
            Pvec3          dir;       /∗ direction vector ∗/
            Pfloat_list    params;    /∗ parameter list ∗/
        } level_mc;
        struct Pparam_surf_level_wc {
            Ppoint3        origin;    /∗ origin point ∗/
            Pvec3          dir;       /∗ direction vector ∗/
            Pfloat_list    params;    /∗ parameter list ∗/
        } level_wc;
        Pdata     unsupp;   /∗ unsupported parametric surface
                               characteristics data ∗/
    } data;
} Pparam_surf_chars;
    typedef enum {
        PPLACE_UNIFORM_OVER_SURF,      /∗ uniform over surface ∗/
        PPLACE_UNIFORM_BETWEEN_KNOTS   /∗ uniform between knots ∗/
    } Pplacement;
    typedef struct {
        Pfloat   x;    /∗ x coordinate ∗/
        Pfloat   y;    /∗ y coordinate ∗/
        Pfloat   z;    /∗ z coordinate ∗/
    } Ppoint3;
    typedef struct {
        Pfloat   delta_x;    /∗ delta x value ∗/
        Pfloat   delta_y;    /∗ delta y value ∗/
        Pfloat   delta_z;    /∗ delta z value ∗/
    } Pvec3;
    typedef struct {
        Pint     num_floats;   /∗ number of floats in list ∗/
        Pfloat ∗floats;       /∗ list of floats ∗/
    } Pfloat_list;

Constants

Data Structure Constants   Constant                      Description
---------------------------------------------------------------------------
Parametric surface         PPARAM_SURF_CHARS_NONE        None
characteristic types
                           PPARAM_SURF_CHARS_WS_DEP      Workstation
                                                         dependent
                           PPARAM_SURF_CHARS_ISOPARAM    Isoparametric
                                                         curves
                           PPARAM_SURF_CHARS_LEVEL_MC    Level curves, in
                                                         modeling
                                                         coordinates
                           PPARAM_SURF_CHARS_LEVEL_WC    Level curves, in
                                                         world coordinates
---------------------------------------------------------------------------

Description

pset_param_surf_chars sets the current parametric surface characteristics entry in the traversal state list to the values associated with the element. If the specified parametric surface characteristics type is not available, or if the data record contents are invalid, Digital PHIGS uses type 1.

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 parametric surface characteristics element.

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element.

Digital PHIGS Version 4.1 does not support this function.