IntegratedLightControl

Allows the user to configure light settings for the integrated illumination accessory connected to the front of the In-Sight 7000 Gen2 series vision system's faceplate. The available function inputs vary depending on the type of lighting device connected to the vision system: the In-Sight illumination accessory, DataMan standard illumination accessory or DataMan high-powered illumination accessory.

Note:

An illumination accessory must be connected to the front of the vision system's faceplate and Integrated must be selected within the Light Settings dialog or the function will return #ERR. For more information, see Light Settings.
If the IntegratedLightControl 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 IntegratedLightControl function exist within a job, the illumination accessory will use the settings specified by the most recently executed instance of the function.
The In-Sight 7000 Gen2 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.

In-Sight Illumination Inputs

Syntax: IntegratedLightControl(Event,North Bank,East Bank,West Bank,South Bank,Unused,Unused,Unused,Unused,Intensity,Always On)

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.

North Bank

The In-Sight illumination accessory includes 8 LEDs that are separated into 4 LED banks.

0 = The LED bank is off.
1 = The LED bank is on. (default)

East Bank

West Bank

South Bank

Unused

Not supported. Set to 1 by default.

Unused

Intensity

Specifies the effective intensity of the illumination accessory LED banks as a percentage. All LED banks share a common intensity value and the intensity is limited to 50% - 100% to ensure it is evenly distributed across all LED banks. (50% to 100%; default = 100%)

The In-Sight illumination accessory has a maximum strobe pulse width that is dependent on the Intensity, LED ring light color, vision system resolution and number of rows acquired. Up to a certain Exposure time, the illumination accessory will illuminate for the specified Exposure time. If the Exposure time exceeds the maximum strobe pulse width, the LED ring light will only illuminate for the maximum strobe pulse width. For example:

LED Ring Light Color	Intensity	Maximum Strobe Pulse Width (ms)
LED Ring Light Color	Intensity	In-Sight 7500, 7600, 7800, 7900 800 x 600	In-Sight 7500, 7600, 7800, 7900 640 x 480	In-Sight 7501, 7801, 7901 1280 x 1024	In-Sight 7802, 7902 1600 x 1200	In-Sight 7802, 7902 800 x 600 (Low Light Mode)	In-Sight 7902P 1920 x 1200	In-Sight 7905 2448 x 2048
White	100%	0.314	0.232	0.704	1.022	1.022	0.744	1.599
White	50%	0.779	0.574	1.744	2.531	2.531	1.842	3.961
Red	100%	0.375	0.277	0.841	1.220	1.220	0.888	1.847
Red	50%	1.083	0.799	2.426	3.519	3.519	2.561	5.508
IR	100%	0.351	0.259	0.786	1.140	1.140	0.830	1.785
IR	50%	0.857	0.632	1.921	2.787	2.787	2.028	4.361
Blue	100%	0.314	0.232	0.704	1.022	1.022	0.744	1.599
Blue	50%	0.765	0.564	1.713	2.485	2.485	1.808	3.889

LED Ring Light Color

Intensity

Maximum Strobe Pulse Width (ms)

In-Sight 7600C, 7800C, 7900C

800 x 600

In-Sight 7600C, 7800C, 7900C

640 x 480

In-Sight 7801C, 7901C

1280 x 1024

In-Sight 7802C, 7902C

1600 x 1200

In-Sight 7802C, 7902C

800 x 600 (Low Light Mode)

In-Sight 7905C

2448 x 2048

White

100%

0.314

0.232

0.704

1.022

1.599

50%

0.779

0.574

1.744

2.531

3.961

Note:

At Exposure times greater than the maximum strobe pulse width, a lower Intensity may result in brighter images, due to increased LED efficiency at a lower current.
For the following vision systems/sensors, the resolution can be configured in the Image Settings dialog: In-Sight Micro 1500, In-Sight 2000-130, 2000-130C, 2000-230, 2000-230C, 2000-23M, 2001-230, 2001-230C, In-Sight 7500, 7600, 7600C, 7800, 7800C, 7900, 7900C, 7802, 7802C, 7902, 7902C.

Always On

The selected LED banks are always on to provide consistent light levels between acquisitions.

0 = OFF
1 = ON (default)

DataMan Standard Illumination Inputs

Note: DataMan Standard Illumination and DataMan High-Powered Illumination accessories are not supported with the In-Sight 7905.

Syntax: IntegratedLightControl(Event,West Inside Bank,West Outside Bank,North Inside Bank,North Outside Bank,East Inside Bank,East Outside Bank,South Inside Bank,South Outside Bank,Intensity,Always On)

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.
West Inside Bank	The DataMan standard illumination accessories includes 36 LEDs that are separated into 8 LED banks. 0 = The LED bank is off. 1 = The LED bank is on. (default)
West Outside Bank
North Inside Bank
North Outside Bank
East Inside Bank
East Outside Bank
South Inside Bank
South Outside Bank
Intensity	Specifies the effective intensity of the illumination accessory LED banks as a percentage. All LED banks share a common intensity value. (0% to 100%; default = 100%)
Always On	Not supported. Set to 0 by default.

DataMan High-Powered Illumination Inputs

Note: DataMan Standard Illumination and DataMan High-Powered Illumination accessories are not supported with the In-Sight 7905.

Syntax: IntegratedLightControl(Event,West 1 Bank,West 2 Bank,North 1 Bank,North 2 Bank,East 1 Bank,East 2 Bank,South 1 Bank,South 2 Bank,Intensity,Always On)

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.
West 1 Bank	The DataMan high-powered illumination accessories include 8 LEDs, all of which are individually addressable as their own LED bank. 0 = The LED bank is off. 1 = The LED bank is on. (default)
West 2 Bank
North 1 Bank
North 2 Bank
East 1 Bank
East 2 Bank
South 1 Bank
South 2 Bank
Intensity	Not supported. Set to 100 by default.
Always On	Not supported. Set to 0 by default.

IntegratedLightControl Outputs

Returns

An IntegratedLightControl data structure, or #ERR if any of the input parameters are invalid.