Supported by ...
PL-B770, PL-B780, PL-D726 and PL-D775 machine vision and board-level cameras.
Description
Trigger with Controlled Lighting allows control over the manner in which rolling shutter or fast-reset shutter cameras function when using a trigger. In normal operation, a rolling shutter camera is resetting, exposing and reading out information concurrently. This results in consistent exposure times and faster frame rates. However, since the rolling shutter is only exposing a portion of the sensor at a time, this mode is not effective at stop motion imaging.
To capture stop motion with a rolling shutter camera requires controlled lighting using a strobe, shutter or both. The sensor must be fully reset prior to the exposure beginning. Then, once the exposure is complete, the sensor starts readout. During the readout, the sensor remains sensitive to incident illumination - hence the need for controlled lighting.
There are applications where the camera does not need to stop motion. In these cases, Trigger with Controlled Lighting can be turned off (0) and the sensor will use a full rolling shutter to capture images. The rolling shutter will start when the trigger event occurs.
Cameras that support global shutter operation do not support this feature.
API Control
Feature ID | Number of Params | Parameters | Units | Restrictions |
FEATURE_TRIGGER_WITH_CONTROLLED_LIGHT Controls the manner of rolling shutter operation with a trigger. | 1 | fValue | N/A | 1 or 0 |
Note: The stream state must be off (STREAM_OFF) to modify this feature. See PxLSetStreamState. Any change to FEATURE_TRIGGER_WITH_CONTROLLED_LIGHTI does not take effect until the triggering has been enabled. i.e. First set FEATURE_TRIGGER_WITH_CONTROLLED_LIGHT, then set FEATURE_TRIGGER.
Feature Flags
Camera | Presence | Read Only | Auto | Manual | One-time Auto | Off | CiD |
All Cameras | Yes | No | No | Yes | No | No | No |
Parameters
Camera | Parameter | Unit | Type | Min | Max | Default | Step Size |
All Cameras | Value | N/A | Absolute | 0 | 1 | 1 | 1 |