SceneCorrection
The SceneCorrection function helps to correct images that contain uneven lighting or shading, to produce an output image that appears to contain uniform lighting. The function produces a greyscale output image where every pixel is the result of a "local" image-enhancement technique - "mean intensity"- applied to a set of adjacent pixels ("neighbors") within the region of interest (ROI). The set of pixels is called the "processing neighborhood" and is rectangular in shape, with its height and width defined by the Number of Rows and Number of Columns parameters, respectively.
- This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.
- For In-Sight vision systems running In-Sight firmware 5.1.0 and later, this function is consolidated into the Filter function (High Pass Filter Type). For more information, see Filter.
SceneCorrection Inputs
Syntax: SceneCorrection(Image,Fixture.Row,Fixture.Column,Fixture.Theta,Region.X,Region.Y,Region.High,Region.Wide,Region.Angle,Operation,Number of Rows,Number of Columns,Timeout,Show)
Parameter | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
This parameter must reference a spreadsheet cell that contains an Image data structure. By default, this parameter references A0, the cell containing the AcquireImage Image data structure. This parameter can also reference other Image data structures, such as those returned by the Vision Tool Image functions. For more information, see AcquireImage and Image. |
|||||||||||
Defines the Region of Interest (ROI) relative to a Fixture input or the output of a Vision Tool function's image coordinate system. Setting the ROI relative to a Fixture ensures that if the Fixture is rotated or translated, the ROI will be rotated or translated in relation to the Fixture. For more information, see Fixture and Vision Tools. Note: The default setting is (0,0,0), the top leftmost
corner of the image.
|
|||||||||||
Also known as the Region of Interest (ROI), specifies the region of the image that undergoes analysis and creates a rectangular image region that can be transformed and rotated. For more information, see Interactive Graphics Mode. Tip: With this parameter
selected, you can press the Maximize
Region button on the property sheet's toolbar to maximize the region and cover the entire image.
|
|||||||||||
Specifies the operation to perform on the processing neighborhood; the result is displayed in a greyscale output image.
|
|||||||||||
Specifies the height (1–Max Image Height; default = 11) of the processing neighborhood. This value must be set as an odd number. Note:
|
|||||||||||
Specifies the width (1–Max Image Width; default = 11) of the processing neighborhood. This value must be set as an odd number. Note:
|
|||||||||||
Specifies the amount of time, in milliseconds (0 to 30000; default = 0), that the function will attempt to calculate the correct filter before execution is halted and an #ERR is returned. Set the parameter to 0 to specify no timeout. |
|||||||||||
Specifies which graphical overlays are displayed on top of the image.
|
SceneCorrection Outputs
Returns |
An Image data structure containing the processed image, or #ERR if any of the input parameters are invalid. Note: The contents
of the processed image region in the Image data structure are not saved with the job.
|