INITIALIZE LOCATOR

PINIT_LOC

CALL SEQUENCE

void pinit_loc(

Pint	ws_id,	/* workstation identifier	*/
Pint	loc_dev,	/* locator device number	*/
Pint 	init_view_index,	/* initial view index	*/
const Ppoint	*init_loc_pos,	/* initial locator position	*/
Pint 	pet,	/* prompt and echo type	*/
const Plimit	*echo_area,	/* echo area	*/
const Ploc_data	*loc_data_rec	/* data record	*/

)

TYPES

typedef struct {
	Pfloat 	x;	/* x coordinate	*/
	Pfloat 	y;	/* y coordinate	*/
} Ppoint;

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 Ploc_pets {
		struct Ploc_pet_r1 {
			int	impl_dep;
		} pet_r1;
		struct Ploc_pet_r2 {
			int	impl_dep;
		} pet_r2;
		struct Ploc_pet_r3 {
			int	impl_dep;
		} pet_r3;
		struct Ploc_pet_r4 {
			Pline_attrs	line_attrs;	/* polyline attributes	*/
		} pet_r4;
		struct Ploc_pet_r5 {
			Pline_fill_ctrl_flag line_fill_ctrl_flag;	/* control flag	*/
			union	Ploc_attrs {
				Pline_attrs	line_attrs;	/* polyline attributes	*/
				Pint_attrs	int_attrs;	/* interior attributes	*/
				struct Ploc_fill_set {
					Pint_attrs	int_attrs;	/* interior attributes	*/
					Pedge_attrs	edge_attrs;	/* edge attributes	*/
				} fill_set;
			} attrs;
		} pet_r5;
		struct	Ploc_pet_r6 {
			int	impl_dep;
		} pet_r6;
	} pets;
} Ploc_data;

PHIGS STATE

EFFECT

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

114

Ignoring function, the view index value is less than zero

SEE ALSO