SET PICK FILTER

pset_pick_filter

CALL SEQUENCE

void pset_pick_filter (ws_id, pick_dev, filter)

INPUT PARAMETERS

Pint	ws_id,
Pint	pick_dev,
const Pfilter	*filter

ARGUMENTS

ws_id,

Workstation identifier

pick_dev,

Pick device number

filter

Pick filter

TYPES

typedef struct {
	Pint_list	incl_set;	/* inclusion set 	*/
	Pint_list	excl_set;	/* exclusion set 	*/
} Pfilter;

typedef struct {
	Pint	num_ints;	/* number of Pints in list 	*/
	Pint	*ints;	/* list of integers	*/
} Pint_list;

PHIGS STATE

EFFECT

The pick filter entry of the workstation state list associated with pick_dev and with workstation ws_id is set to filter.

The new pick filter takes effect from the next interaction of pick device pick_dev.

During a traversal, the current name set is associated with a primitive as being one of its attributes. A primitive is then detectable by pick_dev if:

• - at least one name set element is included in the pick filter inclusion set.
• - no name set element is included in the pick filter exclusion set.

• - Exclusion takes priority over inclusion.
• - The two sets are empty by default.
• - The primitives are undetectable by default.
• - The invisibility filter is applied before the pick filter, taking into account that a primitive must be visible to be detectable.

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

SEE ALSO