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, PL-D7912, and PL-X9512.
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
| 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 and PL-X | 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. |