Supported by ...


Currently supported by the PL-D752, PL-D753, PL-D755, PL-D755MU-POL, PL-D757, PL-D759, PL-D7512, PL-D795, PL-D797, PL-D799 and PL-D7912.


Description


This feature can be used to put the camera in to (and out of) a ‘special’ mode of operation. See the chart below for the definition of each of these special modes. This feature may not be set while the camera is streaming images.  Furthermore, if the camera is to be placed in a special mode of operation, it is recommended that this feature be used immediately after the camera is PxLInitialize'ed, as placing the camera in a special mode may have implications of other features (including the limits of those features).


IIDC Name
API Name
Description
N/A


FEATURE_SPECIAL_CAMERA_MODE_NONE

No special camera mode - the camera behaves normally (as described in the PixeLINK documentation)
N/A


FEATURE_SPECIAL_CAMERA_MODE_FIXED_FRAME_RATE

The camera's frame rate is not controllable directly. Rather, the camera will chose a frame rate based on the setting of the  Region of Interest (ROI). This special camera mode can accommodate faster frame rates than can be otherwise achieved while in its normal mode of operation.


API Control


PxLGetFeature, PxLSetFeature


FeatureNumber of ParamsParametersUnitsRestrictions
FEATURE_SPECIAL_CAMERA_MODE places the camera in a special mode of operation.1fValueMode
(Enumeration)
Integer only
(see enumeration above)


Note: 

  • The stream state must be off (STREAM_OFF) to modify this feature. See PxLSetStreamState.

  • Disabling this feature has the same effect as setting this feature to a value of FEATURE_SPECIAL_CAMERA_MODE_NONE


Feature Flags


CameraPresenceRead OnlyAutoManualOne-time AutoOffSettable While StreamingPersistable


CID


All USB3
cameras
YesNoNoYes NoYesNoYesNo



Special Camera Modes

ValueDescription
FEATURE_SPECIAL_CAMERA_MODE_NONE
No special camera mode - the camera behaves normally (as described in the PixeLINK documentation).
FEATURE_SPECIAL_CAMERA_MODE_FIXED_FRAME_RATE


The camera's frame rate is not controllable directly.  Rather, the camera will choose a frame rate based on the setting of the Region of interest (ROI). This special camera mode can accommodate faster frame rates than can be otherwise achieved while in its normal mode of operation.