PXL_RETURN_CODE PxLSetActions ( U32 actionType, double scheduledTimestamp );
This function will trigger a specific action in the camera.
actionType identifies the specific type of action. Click here to review all possible action types.
scheduledTimestamp is the time at which the camera is to trigger the specified action. A scheduledTimestamp of 0 cause the camera to trigger the action immediately. A scheduledTimestamp > 0, cause the camera to trigger the action at the specified time (note, an application can get the camera’s current time, via the PxLGetCurrentTimestamp function).
Previously scheduled actions can be cancelled using PxLSetFeature; either turning the FEATURE_OFF, or changing the feature to no longer be of an Action type.
It’s important to note that the action commands generated by calling this function, are not sent to a specific camera – they are multicasted to all cameras connected to the system. However, only cameras whose associated action is enabled, will take action on the command. For instance, if a PxLSetActions (ACTION_FRAME_TRIGGER, 0) is called – only those cameras who have their trigger enabled as TRIGER_TYPE_ACTION will act on the command (and capture an image and send it to the host).
Recommended method of using PxLGetFeature:
Call the function with pParams set to NULL. If the return code indicates success, the required number of array entries is returned in the U32 pointed to by pNumParams.
Allocate the required number of bytes of memory to hold the parameters, that is, *pNumParams × sizeof(float).
Call the function with pFlags and pParams set to point to their own areas of allocated memory.
Comments, Restrictions and Limitations
All scheduled action requests, are lost on a camera reset (as the camera’s timebase changes)