SAMPLE PICK
CALL SEQUENCE
void psample_pick (ws_id, pick_dev, depth, status, pick)
INPUT PARAMETERS
Pint ws_id,
Pint pick_dev,
Pint depth,
OUTPUT PARAMETERS
Pin_status *status,
Pick_path *pick
ARGUMENTS
- ws_id,
- Workstation identifier
- pick_dev,
- Pick device number
- depth,
- Max depth of returned path
- status,
Pick status
- pick
Pick path
TYPES
typedef enum {
PIN_STATUS_NONE,
PIN_STATUS_OK,
PIN_STATUS_NO_IN
} Pin_status;
typedef struct {
Pint depth; /* pick path depth */
Ppick_path_elem *path_list; /* pick path list */
} Ppick_path;
typedef struct {
Pint struct_id; /* structure identifier */
Pint pick_id; /* pick identifier */
Pint elem_pos; /* element position */
} Ppick_path_elem;
PHIGS STATE
(PHOP, WSOP, *, *).
EFFECT
Returns the structure intersecting the pick aperture of the active device,
pick_dev.
Example:
/* Sample pick on workstation number 1 using device number 1 */
Pint ws_id,pick_dev,depth;
Pin_status status;
Ppick_path_elem elem[5] ;
Ppick_path pick_path;
.....
ws_id = 1;
pick_dev = 1;
depth = 5;
pick_path.path_list = elem;
psample_pick(ws_id,pick_dev,depth,&status,&pick_path);
......
ERRORS
- 3
Ignoring function, function requires state (PHOP, WSOP,*,*)
- 54
- Ignoring function, the specified workstation is not open
- 60
- Ignoring function, specified workstation is not of category OUTIN
- 250
- Ignoring function, the specified device is not available on the specified
workstation
- 252
- Ignoring function, the function requires the input device to be in SAMPLE
mode
SEE ALSO
set pick mode, initialize pick 3, request pick , get pick , await event,
inquire pick device state 3, inquire default pick device state 3, pick without
interaction (ext)
