Previous Next Up Title Contents General Index Functions Index Bookshelf

SET PICK FILTER

PSPKFT


CALL SEQUENCE

PSPKFT (WKID, PKDNR, ISN, IS, ESN, ES)

INPUT PARAMETERS

INTEGER	WKID
INTEGER	PKDNR
INTEGER	ISN
INTEGER	IS(ISN)
INTEGER	ESN
INTEGER	ES(ESN)

ARGUMENTS

WKID
Workstation identifier.
PKDNR
Selected pick device identifier. A SET PICK FILTER (pick filter set) is associated with each pick device.
ISN
Number of names in inclusion set.
IS(ISN)
Inclusion set.
ESN
Number of names in exclusion set.
ES(ESN)
Exclusion set.

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

The pick filter entry of the workstation state list associated with PKDNR and with workstation WKID is set to filter defined by ISN,IS,ESN and ES parameters.

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

During a traversal, the current name set is associated with a primitive as being one of its attributes. A primitive is then detectable by PKDNR 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

SEE ALSO

add name to set, remove name from set, inquire pick device state 3, inquire pick device state


Previous Next Up Title Contents General Index Functions Index Bookshelf