Name

pget_stroke3 − Returns the 3D coordinates of the points in a stroke. 

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

Syntax

void pget_stroke3 (
  Pint           ∗view_ind,  /∗ (O) View index ∗/
  Ppoint_list3   ∗stroke     /∗ (O) Stroke information ∗/
)

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

pget_stroke3 obtains information contained in the current event report entry.  If the report contains input generated by anything other than a stroke-class input device, a call to this function generates an error.  (See the pawait_event function for more information about input classes and the current event report.) 

The pget_stroke3 function returns the world coordinate points and the view index of the view transformation Digital PHIGS uses to translate the normalized projection coordinate points to the world coordinate points. 

Digital PHIGS uses the current workstation transformation to translate the device coordinate points to the normalized projection coordinate points.  See Getting Started with DEC PHIGS for more information on view indexes. 

The application allocates the memory for the point list returned by this function.  You specify the maximum size of the stroke point list in the call to pinit_stroke3.  To determine the maximum size of a stroke point list supported by Digital PHIGS, call pinq_def_stroke_data3. 

See Also

pawait_event
pflush_events
pget_stroke
pinit_stroke3
preq_stroke3
psample_stroke3
pset_stroke_mode
pset_view_tran_in_pri