Name

pe_map_dc_to_wc − Converts device coordinate points to world coordinate values. 

Operating States: PHOP, WSOP, ∗, ∗
Digital PHIGS extension function

Syntax

void pe_map_dc_to_wc (
  Pint           wsid,           /∗ (I) Workstation identifier ∗/
  Ppoint_list3  ∗point_list_dc,  /∗ (I) List of points, in device
                                        coordinate points ∗/
  Pint          ∗error_ind,      /∗ (O) Error indicator ∗/
  Pint          ∗view_ind,       /∗ (O) View index ∗/
  Ppoint_list3  ∗point_list_wc   /∗ (O) List of points, in world
                                        coordinates ∗/
)

Data Structures

typedef struct {
    Pint      num_points;   /∗ number of Ppoint3s in the list ∗/
    Ppoint3  ∗points;       /∗ list of points ∗/
} Ppoint_list3;
    typedef struct {
        Pfloat    x;    /∗ x coordinate ∗/
        Pfloat    y;    /∗ y coordinate ∗/
        Pfloat    z;    /∗ z coordinate ∗/
    } Ppoint3;

Description

pe_map_dc_to_wc converts the specified list of device coordinate points to world coordinate values and returns them in mapped points.  Digital PHIGS uses the same procedure for stroke input devices for this conversion.  Digital PHIGS transforms the points to normalized projection coordinates by the inverse of the workstation transformation.  To transform the points to world coordinate values, Digital PHIGS searches the workstation’s view table for the highest priority view that contains all the specified points, and uses the inverse view mapping and orientation transformations of that view.  The function returns the view index of the view used for the transformation. 

Digital PHIGS Version 4.1 does not support this function.

See Also

pe_map_dc_to_wsc
pe_map_wsc_to_dc