Name

psample_stroke3 − Returns the 3D coordinates of the points in a stroke from the stroke-class logical input device specified. 

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

Syntax

void psample_stroke3 (
  Pint           wsid,        /∗ (I) Workstation identifier ∗/
  Pint           dev_num,     /∗ (I) Stroke device number ∗/
  Pint          ∗view_index,  /∗ (O) View index ∗/
  Ppoint_list3  ∗stroke       /∗ (O) Points in the stroke ∗/
)

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

psample_stroke3 takes the current measure of the stroke-class logical input device specified by the device number and the workstation identifier, and 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 normalized projection coordinate points.  See Getting Started with DEC PHIGS for more information about view indexes. 

If you generate a stroke that contains more points than the number of components in the stroke buffer, you can obtain the additional input through repeated calls to psample_stroke3.  To establish a stroke buffer size, call the pinit_stroke3 function. 

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

See Also

pget_stroke3
pinit_stroke3
pinq_stroke_st3
preq_stroke3
psample_stroke
pset_stroke_mode
pset_view_tran_in_pri