13. Tool Introduction

eVarious types of tools can be added to cameras to perform visual detection.
Tools Supported by SC2000E(Mini) Series Cameras

Tools Supported by SC2000E Series Cameras

Table 13-1

Tools Supported by SC3000 Series Cameras

Tools Supported by SC5000 Series Cameras

Tools Supported by SC7000 Pro Series Cameras

13.1 Measuring Tool

Measuring tools analyzes images via measurement.

13.1.1 Color Size

The Color Size tool calculates the area size with qualified colors in the detection area

Before You Start
● Make sure that the connected camera is the color camera and the Greyscale Image Output function is disabled.
● Make sure that you have configured the camera parameters and base image, and added the Color Size tool.
● This function is available only when the Greyscale Image Output function of color device is disabled. Only color camera supports this tool.
● If you enable the Greyscale Image Output function for a color camera, the color size tool can still be configured but the output result will be NG.
Steps
1. Set the Detection Area as needed. It it set to analyze the whole base image by default.
Click or or to draw on the base image; click to set the whole base image
as the detection area.
Note
Refer to How to draw an ROI? for ROI drawing details.
2. Optional: If you need to shield areas in the detection area, click Edit on the right of Shield Area, and then click to draw polygons on the base image.
3. Optional: You can enable or disable Independent Fixture as needed. When enabled, target offset can be adjusted according to the parameter settings of the chosen fixture configuration. This function is enabled by default and automatically subscribes to the fixture configuration of the base image.
Make sure you have enabled Fixture when configuring the base image. Refer to Configure Base Image for details.
4. Set recognition-related parameters.

Figure 13-1 Recognition-Related Parameters

Color Eyedropper
Set the color value range to be recognized or not need to be recognized. Click and move the cursor on the base image to select the area to be recognized. The pixels with the same color value will turn to green. You can click and select an area that does not need to be recognized.
Recognition Range
Click and move the cursor on the area defined by the color dropper to enlarge or narrow down the to-be-recognized area.
Note
Click to clear the recognition range you set.

5. In Judge Method, set Upper Limit and Lower Limit. If the detection result is within the configured range, the result is OK. Otherwise, the result is NG.
Note
The Judge Method parameters vary according to the camera type. For some cameras, the Judge Method parameter is the similarity range, which is from 0% to 200%. If the value cannot satisfy your need, you can switch 200% to 900%. The maximum similarity range is 900%. If the actual value is higher than 900%, the camera will respond based on 900%.
6. Optional: Set extra parameters in Extend Parameter if the result is not what you have expected.

Figure 13-2 Extend Parameter

Color Value Range
The color value of the to-be recognized area. It will change in a real time when you edit the parameters in recognition settings.
Saturation Range
Only pixels with a saturation in this range will be recognized.
Brightness Range
Only pixels with a brightness in this range will be recognized.
7. Click Test Running to test the detection according to settings.
Note
Click Stop Running to stop the test.

13.1.2 L2L Angle

Find straight lines in two ROIs and calculate the angle between the two straight lines. You can configure range settings, recognition settings, judge method, and extend parameter for the tool.
● Range Settings: You can set area-related parameters.
○ Detection Area: Click and click on a position on the two lines respectively.

Note
Click beside the Detection Area to display the tutorial video on the top left of the live view image.
○ Shielded Area: The shielded area will not be analyzed by the tool. Click Edit → and
draw the shielded area on the base image in the live view image.
○ Independent Fixture: When enabled, target offset can be adjusted according to the parameter settings of the chosen fixture configuration. This function is enabled by default and automatically subscribes to the fixture configuration of the base image.
Note
Make sure you have enabled Fixture when configuring the base image. Refer to Configure Base Image for details.
● In Recognition Settings, you can set recognition-related parameters. Line 1/2 Sensitivity Adjustment: Adjust the sensitivity when measuring line 1 and line 2. When adjusting the parameter, the result will be displayed on the map located on the top right. Red indicates the sensitivity range.
● In Judge Method, set the Upper Limit and the Lower Limit. If the detection result is within the range you set, the tool will output OK, otherwise the tool will output NG.

Note
For some cameras, the Similarity Range will be displayed here. When the similarity between the detected angle and that of the base image is within the range, the result will be OK, or the result will be NG. By default, the similarity range is from 0% to 200%. If the value cannot satisfy your need, you can switch 200% to 900%. The maximum similarity range is 900%. If the actual value is higher than 900%, the camera will respond based on 900%.
● In Extend Parameter, you can set extra parameters for line1 and line 2 if the result is not what you have expected.
○ Straightness Accuracy: the minimum ratio of the number of points used to make up lines to the total number of points. When a line's line rate is higher than the configured rate, it will be recognized as a line, otherwise it will not. The more points selected, the more accurate the line will be.
○ Edge Polarity：It represents the excessive change of color.
› Black to White: The tool recognizes edges from area with higher grey scale to the area with lower grey scale.
› White to Black: The tool recognizes edges from the area with lower grey scale to the area with higher grey scale.
› All: The tool recognizes edges from area with higher grey scale to area with lower grey scale and from area with lower grey scale to area with higher grey scale.
○ Edge Type: You can select "The Best", "The First", "The Last", and "Manual".
› The Best: The tool will find the most suitable points to make up lines.
› The First: The tool will find the points nearest to the start point to make up lines.
› The Last: The tool will find the point nearest to the end points to make up lines.
› Manual: Based on the green lines in the greyscale layout map, you can manually select points to make up lines.

Note
If the edge type is set to "Manual", the edge polarity is set to "All" automatically and it cannot be changed.
After setting the above parameters, you can go to Output → Tool Results to set which data to transmit to the communication tool by the tool. The data can be transmitted are as follows: module status, point measure intersection point angle, point measure intersection point angle X, point measure intersection point angle Y, point measure distance, point measure line 1 start point X, point measure line 1 start point Y, point measure line 1 end point X, point measure line 1 end point Y, point measure line 1 angle, point measure line 2 start point X, point measure line 2 start point Y, point measure line 2 end point X, point measure line 2 end point Y, point measure line 2 angle, result similarity, detection area center X, detection area center Y, detection area width, detection area height, detection area angle, result quantity, and base value.

13.1.3 Diameter Measurement

In the detection area range, measure the diameter of the circle. You can configure range settings, recognition settings, judge method, and extend parameter for the tool.
● Range Settings: You can set area-related parameters.
○ Detection Area: Click and click the base image to draw a circle on the base image.
Note
Click beside the Detection Area to display the tutorial video on the top left of the live view image.
○ Shielded Area: The shielded area will not be analyzed by the tool. Click Edit → and draw the shielded area on the base image in the live view image.
○ Independent Fixture: When enabled, target offset can be adjusted according to the parameter settings of the chosen fixture configuration. This function is enabled by default and automatically subscribes to the fixture configuration of the base image.
Note
Make sure you have enabled Fixture when configuring the base image. Refer to Configure Base Image for details.
● In Recognition Settings, you can set recognition-related parameters. Sensitivity Adjustment: Adjust the sensitivity when measuring the circle. When adjusting the parameter, the result will be displayed on the map located on the top right. Red indicates the sensitivity range.
● In Judge Method, set the Upper Limit and the Lower Limit. If the detection result is within the range you set, the tool will output OK, otherwise the tool will output NG.

● In Extend Parameter, you can set extra parameters for line1 and line 2 if the result is not what you have expected.
○ Circle Rate: The minimum ratio of the number of points used to make up circles to the total number of points. When a circle's circle rate is higher than the configured rate, it will be recognized as a circle, otherwise it will not. The more points selected, the more accurate the circle will be.
○ Edge Polarity：It represents the excessive change of color.
› Black to White: The tool recognizes edges from area with higher grey scale to the area with lower grey scale.
› White to Black: The tool recognizes edges from the area with lower grey scale to the area with higher grey scale.
› All: The tool recognizes edges from area with higher grey scale to area with lower grey scale and from area with lower grey scale to area with higher grey scale.
○ Edge Type: You can select "The Best", "The Biggest", "The Smallest", or "Manual".
› The Best: The tool will find the most suitable points to make up lines.
› The Biggest: The tool will find the points that are the most distant from the center to make up circles.
› The Smallest: The tool will find the points nearest to the center to make up circles.
› Manual: Based on the green lines in the greyscale layout map, you can manually select points to make up circles.
Note
If the edge type is set to "Manual", the edge polarity is set to "All" automatically and it cannot be changed.
After setting the above parameters, you can go to Output → Tool Results to set which data to transmit to the communication tool by the tool. The data can be transmitted are as follows: module status, detection area center X, detection area center Y, detection area width, detection area height, detection area angle, circle diameter, circle center X, circle center Y, circle radius, result quantity, and base value.

13.1.4 Brightness Analysis

The Brightness Average Value tool can measure the brightness of an ROI and then calculate the mean value.
Before You Start
Make sure that you have configured the camera parameters and base image, and added the Brightness Average Value tool.
Steps
1. Set the Detection Area as needed. It it set to analyze the whole base image by default.
Click or or to draw on the base image, the position and size of the area can be adjusted manually; click to set the whole base image as the detection area.

Note
Refer to How to draw an ROI? for ROI drawing details

2. Optional: If you need to shield areas in the detection area, click Edit on the right of Shielded Area, and then click to draw polygons on the base image.
3. Optional: You can enable or disable Independent Fixture as needed. When enabled, target offset can be adjusted according to the parameter settings of the chosen fixture configuration. This function is enabled by default and automatically subscribes to the fixture configuration of the base image. Make sure you have enabled Fixture when configuring the base image. Refer to Configure Base Image for details.
4. In Judge Method, set Upper Limit and Lower Limit. If the detection result is within the configured range, the result is OK. Otherwise, the result is NG.
Note
The Judge Method parameters vary according to the camera type. For some cameras, the Judge Method parameter is the similarity range, which is from 0% to 200%. If the value cannot satisfy your need, you can switch 200% to 900%. The maximum similarity range is 900%. If the actual value is higher than 900%, the camera will respond based on 900%.
5. Click Test Running to test the detection according to settings.
Note
Click Stop Running to stop the test.

13.1.5 Contrast Measurement
The Contrast Measurement tool can measure the contrast of the detection area.
Before You Start
Make sure that you have configured the camera parameters and base image, and added the Contrast Measurement tool.
Contrast is a relative value, representing the ratio of brightest to the darkest of the detection area.
Steps
1. Set the Detection Area as needed. It it set to analyze the whole base image by default.
Click or or to draw on the base image; click to set the whole base image
as the detection area.
Note
Refer to How to draw an ROI? for ROI drawing details.
2. Optional: If you need to shield areas in the detection area, click Edit on the right of Shielded Area, and then click to draw polygons on the base image.
3. Optional: You can enable or disable Independent Fixture as needed. When enabled, target offset can be adjusted according to the parameter settings of the chosen fixture configuration. This function is enabled by default and automatically subscribes to the fixture configuration of the base image.
Make sure you have enabled Fixture when configuring the base image. Refer to Configure Base Image for details.
4. In Judge Method, set Upper Limit and Lower Limit. If the detection result is within the configured range, the result is OK. Otherwise, the result is NG.
Note
The Judge Method parameters vary according to the camera type. For some cameras, the Judge Method parameter is the similarity range, which is from 0% to 200%. If the value cannot satisfy your need, you can switch 200% to 900%. The maximum similarity range is 900%. If the actual value is higher than 900%, the camera will respond based on 900%.
5. Click Test Running to test the detection according to settings.
Note
Click Stop Running to stop the test.

13.1.6 Width Measurement
The Width Measurement tool can detect two edges in the detection area and measure the perpendicular distance between the two edges.
The parameters of the tool are divided into four categories: range settings, recognition settings, judge method, and extend parameter.
● Range settings determine the detection area:
Detection Area
Click and click on the two endpoints on the base image to measure the distance between the two edges.

Note
Click to show animated instructions on drawing ROI.

Shielded Area
Specify the shielded area within the detection area. The shielded area will not be analyzed. Click Edit and then click to draw a polygon on then base image.
Independent Fixture
When enabled, target offset can be adjusted according to the parameter settings of the chosen fixture configuration. This function is enabled by default and automatically subscribes to the fixture configuration of the base image.
Note
Make sure you have enabled Fixture when configuring the base image. Refer to Configure Base Image for details.
● Recognition settings determine the pattern recognition conditions: Sensitivity Adjustment Adjust the sensitivity of edge detection. The grayscale graph in the upper-right corner shows the current effect, and the red area is the sensitivity range.
● In Judge Method, set the Upper Limit and the Lower Limit. If the detection result is within the range you set, the tool will output OK, otherwise the tool will output NG.
Note
For some cameras, the Similarity Range will be displayed here. When the similarity between the detected angle and that of the base image is within the range, the result will be OK, or the result will be NG. By default, the similarity range is from 0% to 200%. If the value cannot satisfy your need, you can switch 200% to 900%. The maximum similarity range is 900%. If the actual value is higher than 900%, the camera will respond based on 900%.
● If the parameter settings above cannot achieve the expected outcome, you can adjust the Extend Paramete

Polarity
Color transition direction. Edge polarity is related to the arrow's direction of the ROI

Figure 13-3 Arrow Directions

Black To White
Only detect the edge formed by low grayscale to high grayscale.
White To Black
Only detect the edge formed by high grayscale to low grayscale.
All
Detect any type of edge.
Width Extraction
The Widest
Only detect the edge pair with the longest distance.
The Narrowest
Only detect the edge pair with the shortest distance.
Manual
Drag the green line in the grayscale graph in the upper-right corner to select the set of edge points and fit the edge pair.
Note
If you select Manual, the polarity will be set to All and cannot be changed. After setting the above parameters, you can go to Output → Tool Results to set which data to transmit to the communication tool. The output data items include: module status, detection area center X/Y, detection area width/height/angle, line start point X/Y, line end point X/Y, result similarity, line 0 start point X/Y, line 0 end point X/Y, line 0 angle, line 1 start point X/Y, line 1 end point X/Y, line 1 angle, pixel edge spacing, and base value.

13.1.7 P2L Measurement
The P2L Measurement tool can detect edges and lines, and then measure the perpendicular distance between a point (on a line/edge) and a line/edge.
Before You Start
Make sure that you have configured the camera parameters and base image, and added the P2L Measurement tool.
Steps
1. Click and click on the base image to determine the point and then click twice to
draw on the line so as to measure the distance between the point and the line.
Note
Click to show animated instructions on drawing ROI.

2. Optional: If you need to shield areas in the detection area, click Edit on the right of
Shielded Area, and then click to draw polygons on the base image.
Note
Refer to How to draw an ROI? for ROI drawing details.
3. Optional: You can enable or disable Independent Fixture as needed. When enabled, target offset can be adjusted according to the parameter settings of the chosen fixture configuration. This function is enabled by default and automatically subscribes to the fixture configuration of the base image. Make sure you have enabled Fixture when configuring the base image. Refer to Configure Base Image for details.
4. Set the pattern recognition conditions in Recognition Settings.
Line Sensitivity Adjustment
Adjust the sensitivity of line detection. The grayscale graph in the upper-right corner shows the current effect, and the red area is the sensitivity range.
Point Sensitivity Adjustment
Adjust the sensitivity of point detection. The grayscale graph in the upper-right corner shows the current effect, and the red area is the sensitivity range.
5. In Judge Method, set the Upper Limit and the Lower Limit. If the detection result is within the configured range, the result is OK. Otherwise, the result is NG.
Note
The Judge Method parameters vary according to the camera type. For some cameras, theJudge Method parameter is the similarity range, which is from 0% to 200%. If the value cannot satisfy your need, you can switch 200% to 900%. The maximum similarity range is 900%. If the actual value is higher than 900%, the camera will respond based on 900%.
6. Set extra parameters in Extend Parameter if the result is not what you have expected.
● Line Parameters:
Line Rate
You can set the minimum value of the ratio of the fitting points to the total number of points. When the straightness of the detected line exceeds this value, it is judged as a straight line. Otherwise, it is not judged as a straight line.
Edge Polarity
Color transition direction. Edge polarity is related to the arrow's direction of the ROI.

Figure 13-4 Arrow Directions

Note
If you select Manual, the polarity will be set to All and cannot be changed.
● Point Parameters:
Edge Polarity
Refer to the descriptions in Line Parameters.
7. Click Test Running to test the detection according to settings.
Note
Click Stop Running to stop the test.

13.1.8 Greyscale Size
The Greyscale Size tool can measure the area of pixels with greyscale value that is within the range you set.
Before You Start
Make sure that you have configured the camera parameters and base image, and added the Greyscale Size tool.
Steps
1. Set the Detection Area as needed. It it set to analyze the whole base image by default.
Click or or to draw on the base image, the position and size of the area can be adjusted manually; click to set the whole base image as the detection area.
Note
Refer to How to draw an ROI? for ROI drawing details.
2. Optional: If you need to shield areas in the detection area, click Edit on the right of Shielded Area, and then click to draw polygons on the base image.
3. Optional: You can enable or disable Independent Fixture as needed. When enabled, target offset can be adjusted according to the parameter settings of the chosen fixture configuration. This function is enabled by default and automatically subscribes to the fixture configuration of the base image. Make sure you have enabled Fixture when configuring the base image. Refer to Configure Base Image for details.
4. Set the pattern recognition conditions in Recognition Settings.
Greyscale Threshold
Set the valid greyscale value range. Qualified area will be marked in green.
Reverse Range
When enabled, the unqualified area will be marked in green. It is used to measure the area that is not within the valid greyscale range.

5. In Judge Method, set the Upper Limit and the Lower Limit. If the detection result is within the configured range, the result is OK. Otherwise, the result is NG.
Note
The Judge Method parameters vary according to the camera type. For some cameras, the Judge Method parameter is the similarity range, which is from 0% to 200%. If the value cannot satisfy your need, you can switch 200% to 900%. The maximum similarity range is 900%. If the actual value is higher than 900%, the camera will respond based on 900%.
6. Optional: Set extra parameters in Extend Parameter if the result is not what you have expected.
Area Range
Set the recognition area size. Unit: pixel.
7. Click Test Running to test the detection according to settings.
Note
Click Stop Running to stop the test.

13.1.9 Line Angle
The Line Angle tool can measure the angle between a line and the X-axis. The parameters of the tool are divided into four categories: range settings, recognition settings, judge method, and extend parameter.
● Range settings determine the detection area:
Detection Area
Click and click on two points on a line on the base image to get the starting point coordinates and intersection angle.
Note
○ Click to show animated instructions on drawing ROI.
○ Click on the top of the base image window to view notes about the coordinates image.
Shielded Area
Specify the shielded area within the detection area. The shielded area will not be analyzed. Click Edit and then click to draw a polygon on the base image.

Independent Fixture
When enabled, target offset can be adjusted according to the parameter settings of the chosen fixture configuration. This function is enabled by default and automatically subscribes to the fixture configuration of the base image.

Note
Make sure you have enabled Fixture when configuring the base image. Refer to Configure Base Image for details

● Recognition settings determine the pattern recognition conditions:
Sensitivity
Adjust the sensitivity of edge detection. The grayscale graph in the upper-right corner shows the current effect, and the red area is the sensitivity range.
● In Judge Method, set the Upper Limit and the Lower Limit. If the detection result is within the range you set, the tool will output OK, otherwise the tool will output NG.
Note
For some cameras, the Similarity Range will be displayed here. When the similarity between the detected angle and that of the base image is within the range, the result will be OK, or the result will be NG.By default, the similarity range is from 0% to 200%. If the value cannot satisfy your need, you can switch 200% to 900%. The maximum similarity range is 900%. If the actual value is higher than 900%, the camera will respond based on 900%.
● If the parameter settings above cannot achieve the expected outcome, you can adjust
the Extend Parameter for the line.
Line Rate
You can set the minimum value of the ratio of the fitting points to the total number of
points. When the straightness of the detected line exceeds this value, it is judged as a
straight line. Otherwise, it is not judged as a straight line.
Edge Polarity

Color transition direction. Edge polarity is related to the arrow's direction of the ROI

Figure 13-5 Arrow Directions

Black To White
Only detect the edge formed by low grayscale to high grayscale.
White To Black
Only detect the edge formed by high grayscale to low grayscale.
All
Detect any type of edge.
Edge Type
The Best
Only detect edge points with the largest gradient threshold and fit them into a line.
The First
Only detect edge points that are the nearest to the detection start point and fit them into a line.
The Last
Only detect edge points that are the nearest to the detection end point and fit them into a line.
Manual
Drag the green line in the grayscale graph in the upper-right corner to select the set of edge points and fit them into a line.
Note
If you select Manual, the polarity will be set to All and cannot be changed.
After setting the above parameters, you can go to Output → Tool Results to set which
data to transmit to the communication tool.
The output data items include: module status, line start point X/Y, line end point X/Y, detection area center X/Y, detection area width/height/angle, result similarity, and base value.

13.1.10 Edge Width Measurement
The Edge Width Measurement tool measures the distance between two edges in an ROI.
Before You Start
Make sure that you have configured the camera parameters and base image, and have added the Edge Width Measurement tool.
Steps
1. Click and then draw a detection area on the image.
Note
After drawing the detection area, a histogram will show on the top right of the image displaying the greyscale difference between adjacent pixels.
2. Click Edit to draw a shielded area in the detection area.
Note
See About ROI for details about drawing an ROI.
3. Optional: You can enable or disable Independent Fixture as needed. When enabled,
target offset can be adjusted according to the parameter settings of the chosen fixture
configuration. This function is enabled by default and automatically subscribes to the
fixture configuration of the base image.
Make sure you have enabled Fixture when configuring the base image. Refer to Configure Base Image for details.
4. Select a sensitivity for the tool.
5. Configure the Judge Method, including judge basis, range low, and range high.
6. Set the Extend Parameters.

Width
The width of the object.

Parameter	Description
Brightness Mode	The reference for identifying an object.
Find Measure Mode	The method of measurement.

The distance between two objects.
7. Click Test Running to test the tool.

13.2 Existence Tool
The existence tools are as follows: the circle-existence tool, line-existence tool, spot-existence tool, edge-existence tool, pattern-existence tool, and profile-existence tool.

13.2.1 Circle Existence

The circle-existence tool can find multiple points in a detection area and fit them into circles. It can also detect existing circles in the area.
The parameter settings for the circle-existence tool include range settings, recognition settings, judge method settings, and extend parameter settings.
● In Range Settings, you can set area-related parameters.
○ Detection Area: Click , hover the cursor on the circle, and the click the mouse to display the recognized circle and its center coordinate.

Note
Click beside Detection Area, and the animated tutorial will pop up in the upper-left corner of the live view panel.
○ Shielded Area: Here you can shield some areas for them not to be analyzed. Click Edit, and then click to draw polygons on the base image.
○ Independent Fixture: When enabled, target offset can be adjusted according to the parameter settings of the chosen fixture configuration. This function is enabled by