IntegratedLightControl
Allows the user to configure light settings for the integrated illumination accessory connected to the front of the In-Sight 76xx - 79xx 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.
- 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 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.
In-Sight Illumination Inputs
Syntax: IntegratedLightControl(Event,North Bank,East Bank,West Bank,South Bank,Unused,Unused,Unused,Unused,Intensity,Always On)
Parameter | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Specifies the event that forces an update.This parameter must be a reference to one of the following:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
North Bank |
The In-Sight illumination accessory includes 8 LEDs that are separated into 4 LED banks.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
East Bank | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
West Bank | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
South Bank | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Unused | Not supported. Set to 1 by default. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Unused | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Unused | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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:
Note:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Always On | The selected LED banks are always on to provide consistent light levels between acquisitions.
|
DataMan Standard Illumination Inputs
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 |
---|---|
Specifies the event that forces an update.This parameter must be a reference to one of the following:
|
|
West Inside Bank |
The DataMan standard illumination accessories includes 36 LEDs that are separated into 8 LED banks.
|
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
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 |
---|---|
Specifies the event that forces an update.This parameter must be a reference to one of the following:
|
|
West 1 Bank |
The DataMan high-powered illumination accessories include 8 LEDs, all of which are individually addressable as their own LED bank.
|
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. |