GPHIGS C FUNCTIONS - SET PICK FILTER

SET PICK FILTER

PSET_PICK_FILTER

CALL SEQUENCE

void pset_pick_filter(

Pint	ws_id,	/* workstation identifier	*/
Pint	pick_dev,	/* pick device number	*/
const Pfilter	*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

(PHOP, WSOP, *, *).

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.

Note:

- 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