Supported by ...


Currently supported by the PL-D752, PL-D755, PL-D759, PL-D7512, PL-D795, 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

PxLGetFeaturePxLSetFeature


Feature
Number of
Params
Parameters
Units
Restrictions
FEATURE_SPECIAL_CAMERA_MODE places the camera in a special mode of operation.
1
fValue
Mode
(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


Camera
Presence
Read Only
Auto
Manual
One-time Auto
Off
Settable While Streaming
Persistable
CID
All USB3
cameras
Yes
No
No
Yes
No
Yes
No
Yes
No


Special Camera Modes

Value
Description
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.