Supported by ...


PL-B770, PL-B780, PL-D726 and PL-D775 Machine Vision cameras and board-level imagers.


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


PxLGetFeaturePxLSetFeature


Feature IDNumber of ParamsParametersUnitsRestrictions
FEATURE_TRIGGER_WITH_
CONTROLLED_LIGHT


Controls the manner of rolling 

shutter operation with a trigger.

1
fValue
N/A1 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


CameraPresenceRead OnlyAutoManualOne-time AutoOffCiD
All Cameras
Yes
No
No
Yes
No
No
No


Parameters


CameraParameterUnitTypeMinMaxDefaultStep Size
All Cameras
Value
N/A
Absolute
0
1
1
1