Target Tap API module

Reference
- Functions

These functions detect when the target touches the physical screen. You can set a threshold for how long the target must touch to be detected.

Functions

auto zcIsTargetTapPressed(ZCHandle targetHandle, ZSBool* isTapPressed) -> ZCError
auto zcSetTargetTapHoldThreshold(ZCHandle targetHandle, ZSFloat seconds) -> ZCError
auto zcGetTargetTapHoldThreshold(ZCHandle targetHandle, ZSFloat* seconds) -> ZCError

Function documentation

ZCError zcIsTargetTapPressed(ZCHandle targetHandle, ZSBool* isTapPressed)

Parameters
targetHandle in	A handle to the tracker target.
isTapPressed out	True if the tracker target is touching, false if otherwise.

Checks whether the target is tapping or pressing the display's surface.

Example:

// Assume the ZCContext has been properly initialized by zcInitialize().
ZCContext context = ...;

ZCHandle stylusHandle = NULL;
zcGetTargetByType(context, ZC_TARGET_TYPE_PRIMARY, 0, &stylusHandle);

// Check if the target is currently pressed against the zSpace display.
ZSBool currentTapState = 0;
zcIsTargetTapPressed(stylusHandle, &currentTapState);

ZCError zcSetTargetTapHoldThreshold(ZCHandle targetHandle, ZSFloat seconds)

Parameters
targetHandle in	A handle to the tracker target.
seconds in	The number of seconds the tracker target must touch.

Sets the threshold for how long the tracker target must touch the surface zSpace display before the ZC_TRACKER_EVENT_TAP_HOLD event is generated.

ZCError zcGetTargetTapHoldThreshold(ZCHandle targetHandle, ZSFloat* seconds)

Parameters
targetHandle in	A handle to the tracker target.
seconds out	The number of seconds the tracker target must touch.

Gets the threshold for how long the tracker target must touch the surface zSpace display before the ZC_TRACKER_EVENT_TAP_HOLD event is generated.