Previous Next Up Title Contents Index Functions Index Top Library

INITIALIZE PICK

pinit_pick


CALL SEQUENCE

void pinit_pick (ws_id, pick_dev, init_status, init_pick, pet, echo_area, pick_data_rec, order)

INPUT PARAMETERS

Pint	ws_id,
Pint	pick_dev,
Pin_status	init_status,
const Ppick_path	*init_pick,
Pint 	pet,
const Plimit	*echo_area,
const Ppick_data	*pick_data_rec,
Ppath_order	order

ARGUMENTS

ws_id,
Workstation identifier
pick_dev,
Pick device number
init_status,
Initial pick status
init_pick,
Initial pick path
pet,
Prompt and echo type
echo_area,
Echo area
pick_data_rec,
Data record
order
Pick path order

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 {
	Pfloat	x_min;	/* minimum x 	*/
	Pfloat	x_max;	/* maximum x 	*/
	Pfloat	y_min;	/* minimum y 	*/
	Pfloat	y_max;	/* maximum y 	*/
} Plimit;
typedef struct {
	union Ppick_pets {
		struct Ppick_pet_r1 {
			int	impl_dep;
		} pet_r1;
		int	impl_dep;
	} pets;
} Ppick_data;

typedef enum {
	PORDER_TOP_FIRST, 
	PORDER_BOTTOM_FIRST
} Ppath_order;

typedef struct {
	Pint	struct_id;	/* structure identifier	*/
	Pint	pick_id;	/* pick identifier	*/
	Pint	elem_pos;	/* element position	*/
} Ppick_path_elem;

typedef enum {
	PPR_OFF, 
	PPR_ON
} Ppr_switch;

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

This function restricts the 3D initialize pick function to 2D.

ERRORS

3
Ignoring function, function requires state (PHOP, WSOP,*,*)
54
Ignoring function, the specified workstation is not open
61
Ignoring function, specified workstation is neither of category INPUT nor of category OUTIN
250
Ignoring function, the specified device is not available on the specified workstation
251
Ignoring function, the function requires the input device to be in REQUEST mode
254
Ignoring function, invalid echo area volume: XMIN>>=XMAX, YMIN>>=YMAX or ZMIN>>ZMAX
255
Ignoring function, one of the echo area volume boundary points is outside the range of the device
253
Ignoring function, the specified prompt echo type is not available on the specified workstation
260
Ignoring function, one of the fields within the input device data record is in error
261
Ignoring function, initial value is invalid

SEE ALSO

initialize pick 3, set pick mode, request pick, sample pick, get pick, inquire pick device state, inquire default pick device state, inquire number of available logical input devices


Previous Next Up Title Contents Index Functions Index Top Library