Syntax
PXL_RETURN_CODE PxLSetFrameBufferPolicy ( HANDLE hCamera, U32 uNonTriggeredFrames, U32 uTriggeredFrames, U32 uTotalFrameBufferSizeInMs );
Description
This function will return information about the video stream coming from the camera.
- hCamera is the camera handle. This value is returned by PxLInitializeEx.
- uNonTriggeredFrames is the requested frame buffer policy to be used for non-hardware triggered frames. Possible policy values are:
- FBP_NEXT_AVAILABLE — PxLGetNextFrame will return the next frame to arrive at the host (from the camera). This is the default behavior of the API.
- FBP_OLDEST_AVAILABLE — PxLGetNextFrame will return the oldest available undelivered frame.
These values are defined in the file PixeLINKTypes.h.
- uTriggeredFrames is the requested frame buffer policy to be used for hardware triggered frames. This parameter has the same possible values as uNonTriggeredFrames.
- uTotalFrameBufferSizeInMs is used to request the API to allocate a sufficient number of frame buffers, so that API / driver will be able to buffer up sufficiently such that frame buffer re-use does not happen too quicky. The units for this parameter are milliseconds, so that the amount of frame buffering (in real time) remains a constant as other streaming parameters (such as frame size or frame rate) may vary. Specifying a 0 value indicates that the API should choose an appropriate time value.
Comments, Restrictions and Limitations
Currently, the only frame buffer policy supported for non-Hardware triggered frames, is FBP_NEXT_AVAILABLE. For convenience, FBP_NEXT_AVAILABLE value is aliased to FBP_DEFAULT. See also PxLGetStreamState.