ExternalLightControl

Allows the user to configure light settings for an external strobe or continuous lighting device connected to the In-Sight 76xx - 79xx or 9912 vision system's LIGHT connector. For more information, see Light Settings.

Note:

An external light must be connected to the vision system's LIGHT connector and External must be selected within the Light Settings dialog or the function will return #ERR.
If the ExternalLightControl function is inserted into the spreadsheet and you attempt to modify settings in the Light Settings dialog, the settings specified in the dialog will be overwritten by the spreadsheet function.
If multiple instances of the ExternalLightControl function exist within a job, the external light will use the settings specified by the most recently executed instance of the function.
The In-Sight 76xx - 79xx series vision system supports connecting an integrated illumination accessory to the vision system's faceplate and connecting an external light to the vision system's LIGHT connector, but does not support using both lighting devices simultaneously. For a complete list of supported accessories, refer to the In-Sight® 7000 Gen2 Series Vision System Reference Guide.

ExternalLightControl Inputs

Syntax: ExternalLightControl(Event,External Light Polarity,External Light Strobe Source,Intensity)

Parameter	Description
Event	Specifies the event that forces an update.This parameter must be a reference to one of the following: The Image data structure in cell A0, containing the AcquireImage function. For more information, see AcquireImage. A cell containing an Event function. For more information, see Event. A cell containing a Button function. For more information, see Button. A numeric value.
External Light Polarity	Specifies the type of strobe or continuous lighting device connected to the vision system. 0 = PNP (Sourcing) (default) 1 = NPN (Sinking)
Strobe Start Position	Specifies when the strobe should pulse. 0 = Acquisition Start (default) 1 = Camera Trigger
Intensity	Specifies the effective light intensity of the connected strobe device as a percentage. (0 to 100; default = 100)

ExternalLightControl Outputs

Returns

An ExternalLightControl data structure, or #ERR if any of the input parameters are invalid, an external light is not connected to the vision system or External is not selected in the Light Settings dialog.