[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

INITIALIZE PICK (PHOP,WSOP,*,*)

Purpose

Use Initialize Pick to initialize the specified pick device.

The Initialize Pick subroutine stores the prompt/echo type, echo area, initial pick path depth, initial pick path, pick data record and pick path order in the workstation state list for the specified device. The z coordinates of the echo volume remain unchanged.

The pick status may be initialized to OK or NOPICK. The pick path order is the order in which the graPHIGS API returns the elements of the pick path. If you specify the pick path order as TOP FIRST, then the structure specified in any pick path element is a parent of the structure specified in the subsequent pick path element. If you specify the pick path order as BOTTOM FIRST, then the structure specified in any pick path element is a child of the structure specified in the subsequent pick path element. Each pick path element consists of a structure identifier, a pick identifier, and an element position.

This function supports the following prompt/echo types:

  • Type One uses a workstation-dependent technique that highlights the picked primitive. The graPHIGS API does not require a data record.

    Note:

    The pick device must be in Request Mode.

    Language Bindings

    • C

    pinit_pick (ws_id, pick_num, init_status, init_pick, pet, echo_area, pick_data, order)

    Input Parameters

    Pint ws_id
    Workstation identifier.

    Pint pick_num
    Pick device number (>=1).

    Pint init_status
    Initial pick status (1=PIN_STATUS_OK, 2=PIN_STATUS_NO_IN).

    const Ppick_path *init_pick
    Initial pick path.

    Pint pet
    Prompt and echo type.

    const Plimit *echo_area
    Echo area in DC.

    const Ppick_data *pick_data
    Data record.

    Ppath_order order
    Pick path order (0=PORDER_TOP_FIRST, 1=PORDER_BOTTOM_FIRST).

    FORTRAN

    PINPK (wkid, pkdnr, istat, ippd, pp, pet, xmin, xmax, ymin, ymax, ldr, datrec, ppordr)

    Input Parameters

    integer wkid
    Workstation identifier.

    integer pkdnr
    Pick device number (>=1).

    integer istat
    Initial pick status (1=POK, 2=PNPICK).

    integer ippd
    Depth of initial pick path.

    integer pp(3,ippd)
    Initial pick path.

    integer pet
    Prompt and echo type.

    real xmin
    Minimum x coordinate determining echo area in DC.

    real xmax
    Maximum x coordinate determining echo area in DC.

    real ymin
    Minimum y coordinate determining echo area in DC.

    real ymax
    Maximum y coordinate determining echo area in DC.

    integer ldr
    Dimension of the data record array.

    character*80 datrec(ldr)
    Data record.

    integer ppordr
    Pick path order (0=PPOTOP, 1=PPOBOT).

    Errors

    3
    Function Requires State (PHOP,WSOP,*,*)
    54
    Specified Workstation Is Not Open
    60
    Specified Workstation Is Not Of Category Input Or Outin
    250
    Specified Device Not Available On Workstation
    251
    Function Requires Input Device To Be In Request Mode
    254
    Invalid Echo Area/Volume: XMIN>=XMAX, YMIN>=YMAX OR ZMIN>ZMAX
    255
    Echo Area/Volume Boundary Point(s) Outside Device Range
    253
    Prompt/Echo Type Not Available On Specified Workstation
    260
    Input Device Data Record Field Is In Error
    261
    Initial Value Is Invalid

    Related Subroutines

  • Add Names To Set

  • Inquire Pick Device State

  • Inquire Default Pick Device Data

  • Inquire Display Space Size

  • Inquire Number Of Available Logical Input Devices

  • Pack Data Record

  • Remove Names From Set

  • Set Pick Filter

  • Set Pick Identifier

  • Set Pick Mode

    • [ Previous | Next | Contents | Glossary | Home | Search ]