Name

PINSK3 − Sets the stroke device to application-specific values. 

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

Old Syntax

PINSK3 (WKID, SKDNR, IVIEWI, N, IPX, IPY, IPZ, PET, EVOL,
BUFLEN, LDR, DATREC)

Argument     Data Type      Access    Description
---------------------------------------------------------------------------
WKID         Integer        Read      Workstation identifier.
SKDNR        Integer        Read      Stroke device number.
IVIEWI       Integer        Read      Initial view index.
N            Integer        Read      Number of points in the initial stroke.
IPX(∗),      Real           Read      Points in the initial stroke, in world
IPY(∗)                                coordinates.  The actual arguments are
IPZ(∗)                                dimensioned by at least MAX(1, N).
PET          Integer        Read      Prompt and echo type.
EVOL(6)      Array of       Read      Echo volume, in device coordinates
             reals                    (XMIN, XMAX, YMIN, YMAX, ZMIN, ZMAX).
BUFLEN       Integer        Read      Input buffer size.
LDR          Integer        Read      Dimension of the data record array.
DATREC(LDR)  Character ∗80  Read      Data record.
---------------------------------------------------------------------------

New Syntax

PINSK3 (WKID, SKDNR, IVIEWI, N, IPX, IPY, IPZ, PET, EVOL,
LDR, DATREC)

Argument     Data Type      Access    Description
---------------------------------------------------------------------------
WKID         Integer        Read      Workstation identifier.
SKDNR        Integer        Read      Stroke device number.
IVIEWI       Integer        Read      Initial view index.
N            Integer        Read      Number of points in the initial stroke.
IPX(∗),      Real           Read      Points in the initial stroke, in world
IPY(∗)                                coordinates.  The actual arguments are
IPZ(∗)                                dimensioned by at least MAX(1, N).
PET          Integer        Read      Prompt and echo type.
EVOL(6)      Array of       Read      Echo volume, in device coordinates
             reals                    (XMIN, XMAX, YMIN, YMAX, ZMIN, ZMAX).
LDR          Integer        Read      Dimension of the data record array.
DATREC(LDR)  Character ∗80  Read      Data record.
---------------------------------------------------------------------------

Description

PINSK3 sets the stroke device to application-specific values.  You specify the coordinates of the initial stroke (in world coordinate values), and the initial view index of the view transformation Digital PHIGS uses to translate the device coordinate points to normalized projection coordinate points. 

This function accepts the echo volume in a 6-component list of x-, y-, and z-coordinates, in device coordinates. The order of the list components is XMIN < XMAX, YMIN < YMAX, ZMIN < ZMAX. 

  When an application calls PINSK3, the workstation surface cannot contain the stroke device’s prompt.  To remove an existing prompt from the surface, call the PSSKM function and place the device in request mode. 

The size and contents of the data record depend on the prompt and echo type you specify.  If the size or contents of the data record does not match the requirements of your chosen prompt and echo type, Digital PHIGS generates an error. 

See Stroke-Class PET for information on stroke-class prompt and echo types. 

See Also

PGTSK3
PINSK
PQDSK3
PQSKS3
PRQSK
PSMSK
PSSKM
PSVTIP