Previous Next Up Title Contents Index Functions Index Top Library

SAMPLE PICK

psample_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)


Previous Next Up Title Contents Index Functions Index Top Library