ScaleColorImage
ScaleColorImage resamples the pixels in an input image or region of interest (ROI) to produce a reduced, enlarged, unrotated or unbent version of a color image. The function displays the resampled image in the upper-left corner of the In-Sight spreadsheet.
ScaleColorImage Inputs
Syntax: ScaleColorImage(Image,Fixture.Row,Fixture.Column,Fixture.Theta,Region.X,Region.Y,Region.High,Region.Wide,Region.Angle,Region.Curve,Sample Type,Sample Ratio.X Ratio,Sample Ratio.Y,Display Row,Display Column,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 pixel-resampling technique.
|
|||||||||||||
|
Specifies the sample ratio in the (X,Y) direction of the region. Note: Values between
100 and 1000
specify upsampling. For example, if both the ratios are specified as 200,
the resampled image will be twice as large as the specified Region.
|
||||||||||||
Specifies the Row coordinate (default = 0) where the rescaled image will be displayed, relative to the upper left-hand corner. Note: Specifying a value of -1 will ensure that the function places the scaled image at the same row coordinate as the input image:
|
|||||||||||||
Specifies the Column coordinate (default = 0) where the rescaled image will be displayed, relative to the upper left-hand corner. | |||||||||||||
Specifies which graphical overlays are displayed on top of the image.
|
ScaleColorImageOutputs
Returns |
An Image data structure containing the processed image, or #ERR if any of the input parameters are invalid. |