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.

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 default and automatically subscribes to the fixture configuration of the base image

Note
› 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.

● In Recognition Settings, you can set recognition-related parameters. ○ Sensitivity: the sensitivity of circle detection. When setting this parameter, the greyscale layout map in the upper-right corner of the live view panel will display the effect, and the red area represents the sensitivity range.
● In Judge Method, you can set parameters related to result judgment by selecting "Exist OK" or "Not Exist OK". For Not Exist OK, if there are no circles that meets the configured parameter requirements, the result will be "OK".
● In Extend Parameter, you can set extra parameters 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, defines the direction to look for the edges in a detection area. Here the center of the circle is the starting point, it stretches from the inside to the outside of the circle, and the edge is the line between two areas with different greyscales.
› Black to White: The tool recognizes edges from the area with higher greyscale to the area with lower greyscale.
› White to Black: The tool recognizes edges from the area with lower greyscale to the area with higher greyscale.
› All: The tool recognizes edges from the area with higher greyscale to the area with lower greyscale and from the area with lower greyscale to the area with higher greyscale.
○ 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 circles.
› 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 circle-existence tool.
The data can be transmitted are as follows: module status, circle center X, circle center Y, circle radius, detection area center X, detection area center Y, detection area width, detection area height, and detection area angle.

13.2.2 Line Existence

The line-existence tool can find points with specific features to fit them into straight lines. The parameter settings for the line-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 , and then click two different positions on the base image to draw a detection area.
Note
› On the top left of the live view window, click next to Base Image to view descriptions of the coordinate axes.

› Click beside Detection Area, and the animated tutorial will pop up in the upper-left corner of the preview window.
○ 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 default and automatically subscribes to the fixture configuration of the base image.
Note
› 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.
● In Recognition Settings, you can set recognition-related parameters.
○ Line Sensitivity Adjustment: Here you can adjust the sensitivity of line detection. When adjusting this parameter, the greyscale layout map in the upper-right corner of the preview window will display the effect of adjustment, and the red area represents the sensitivity range.
● In Judge Method, you can set the parameters related to result judgment by selecting Exist OK or .
● In Extend Parameter, you can set extra parameters if the result is not what you have expected.
○ Line Rate: 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, and defines the direction to look for the edges in a detection area. Here the edge is the line between two areas with different greyscales.
› Black to White: The tool recognizes edges from the area with higher greyscale to the area with lower greyscale.
› White to Black: The tool recognizes edges from the area with lower greyscale to the area with higher greyscale.
› All: The tool recognizes edges from the area with higher greyscale to the area with lower greyscale and from the area with lower greyscale to the area with higher greyscale.
○ 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 circle-existence tool. The data can be transmitted are as follows: module status, line start point X, line start point Y, line end point X, line end point Y, line angle, detection area center X, detection area center Y, detection area width, detection area height, detection area angle.

13.2.3 Spot Existence

Spot Existence tool is used for analyzing whether there are areas with qualified greyscale in the analyzed area.
Before You Start
Make sure that you have configured the camera parameters and base image, and added the Spot Count tool.

Steps
1. Set the Detection Area as needed. It it set to analyze the whole base image by default. Clickor 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 Shield Area, and then click to draw polygons on the base image.

3. Optional: Enable or disable Independent Fixture as needed. When enabled, target offset can be adjusted according to the parameter settings of the chosen fixture configuration.
Note
● 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 in Recognition Settings.
Greyscale Threshold
Set the greyscale range for detection area. The area with greyscale in the range will be recognized.
Reverse Range
The area with greyscale not in the range will be recognized.
5. Set the result judgment parameters in Judge Method.
Exist OK
The result is OK if the area, which meets the configured requirement is detected.
Reverse Range
The result is OK if the area, which meets the configured requirement is not detected.
6. Optional: Set extra parameters in Extend Parameter if the result is not what you have expected.
Area Range
Set the area of recognized area. The unit is pixel.
7. Click Test Running to test the detection according to settings.
Note
Click Stop Running to stop the test.

13.2.4 Edge Existence

The tool will detect edges with qualified sensitivity in the detection area.
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 two positions on the detected edge.

Note
› On the top left of the live view window, click next to Base Image to view descriptions of the coordinate axes.
› 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
› 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.
● In Recognition Settings, you can set recognition-related parameters.
○ Sensitivity Adjustment: Adjust the sensitivity of the tool. When adjusting, a greyscale map will be displayed on the top right of the live view image showing the adjusting result, while the red area showing the sensitivity range.
● In Judge Method, you can set the parameters related to result judgment by selecting Exist OK or Not Exist OK.
● In Extend Parameter, you can set extra parameters if the result is not what you have expected.
○ Edge Polarity: It represents the excessive change of color, defines the direction to look for the edges in a detection area. Here the edge is the line between two areas with different greyscales.
› Black to White: The tool recognizes edges from the area with higher greyscale to the area with lower greyscale.
› White to Black: The tool recognizes edges from the area with lower greyscale to the area with higher greyscale.
› All: The tool recognizes edges from the area with higher greyscale to the area with lower greyscale and from the area with lower greyscale to the area with higher greyscale.
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, edge point X, edge point Y, edge point quantity, line start point X, line start point Y, line end point X, line end point Y, line angle.

13.2.5 Pattern Existence

With pattern existence tool, the Software can tell you whether the specific pattern exists in the detection area.
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: The area analyzed by the tool on the image. By default, the tool analyzes the whole image. Click to draw the detection area on the base image on the right, you can change its position and size manually. Click to set the whole base image as the detection area.
○ Shielded Area: The shielded area will not be analyzed by the tool. Click Edit → to draw the shielded area on the base image on the right.
○ 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
› 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.
● In Search Settings, you can set search-related parameters.
○ Template Area: The same with the template area in the step of configuring base image.
Note
After drawing an area, you can click → Select similar patterns to manually set the match point. Click Reset to restore to default if needed.
○ Shielded Area: The same with the shielded area in the step of configuring base image.
○ Template Sensitivity:
› Auto: Set the sensitivity by setting the degree. The higher the sensitivity, the better the fixture quality.
› Manual: Set the sensitivity by setting the Coarse Granularity and the Greyscale Threshold.
● In Judge Method, you can set the parameters related to result judgment by selecting Exist OK or Not Exist OK.
● In Extend Parameter, you can set extra parameters if the result is not what you have expected.
○ Min. Score: The minimum similarity between the template area and the analyzed area in the image. Only when the similarity is higher than the Min. Score, the target can be recognized. The Min. Score ranges from 0 to 1, and 1 indicates that the analyzed area in the image is completely the same with the template area.
○ Match Polarity: When the polarity of the analyzed area's edge is different from that of the template area, set the Match Polarity as Ignored to make sure the target can be found. If it is not necessary to find the target, you can set the Match Polarity as Considered for a quick search.
○ Angle Range: If the analyzed object is turned and the turned angle is smaller than the value you set, the object can be recognized, otherwise it cannot be recognized.

13.2.6 Contour Existence

You can use this tool to verify the presence of a contour through contour matching

Before You Start
Make sure that you have configured the camera parameters and the base image, and added the Contour Existence tool.
Steps
1. Set the Detection Area as needed. It is set to analyze the whole base image by default.
Click or to draw on the base image, the position and size of the area can be adjusted manually.
Note
● By default, the whole base image is set to the detection area.
● 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: If you need to adjust the target offset, enable Independent Fixture. When enabled, target offset can be adjusted according to the parameter settings of the chosen fixture configuration.
Note
● 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 the scale mode, threshold mode, and chain mode.
Note
By default, Auto is selected as the scale mode. For the manual mode, configure the following parameters.
Velocity Scale
The higher this value, the higher the characteristic scale, and the less the picked points from the contour. But the feature matching will be faster.
Characteristic Scale
The fineness of picking points from the contour.
Note
This value should be lower than the velocity scale. The lower the value, the finer the point-picking.
Threshold Mode
Used for setting the greyscale threshold of contour edges. The area with greyscale within the threshold will be detected.
Note
The higher this value, the less qualified number of contour edges, and the points on edges may be filtered out.
Chain Mode
During control detections, only the chain length of a contour is higher than the minimum chain, can it be identified as a valid contour.
5. Set the result judgment parameters in Judge Method.
Exist OK
If the area that meets the configured requirement is detected, the result is OK.
Reverse Range
If the area that meets the configured requirement is not detected, the result is OK.
6. Optional: Set extra parameters in Extend Parameter if the result is not what you have expected.
Minimum Score
The threshold of similarity between the feature template and the detected target. A higher score indicates a greater similarity. When the similarity score reaches or exceeds the threshold, the target can be found.
Match Polarity
The color change from detected target to its background. When the target's polarity is different from that of the feature template, select Ignored to make sure the target can be found. Otherwise, select Considered to shorten the finding time.
Angle Range
If the target's angle changes and the change is within this range, the target can still be recognized; or it cannot be recognized.
Algorithm Timeout
The maximum duration for running the algorithm.
● If the algorithm is still working when the working time reaches the value you set, the detection will stop and the Software will output NG.
● If you set this parameter to 0, there will be no limitation for the algorithm's working duration.
7. Click Test Running to test the detection according to settings.

Note
Click Stop Running to stop the test

13.3 Counting Tools

Counting tools are as follows:the spot-counting tool, edge-counting tool, pattern-counting tool, profile-counting tool, and color-counting tool.
13.3.1 Spot Count
The spot-counting tool uses the Blob method to recognize and count multiple spots whose greyscales are within the configured greyscale range.
Note
● Blob analysis refers to the process of detecting, locating, and analyzing an target object by measuring its greyscale value. It can output the information about some of the object's features, such as existence, number, location, shape, direction, and the topological relationship among Blobs.
● Make sure that you have configured the camera parameters and base image, and added the Spot Count tool.
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 Shield Area, and then click to draw polygons on the base image.
3. Optional: Enable or disable Independent Fixture as needed. When enabled, target offset can be adjusted according to the parameter settings of the chosen fixture configuration.
Note
● 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 in Recognition Settings.

Figure 13-6 Recognition Settings

Greyscale Threshold
Here you can set the greyscale range for the detection area, so that the areas whose greyscale is within the greyscale range will be recognized.
Reverse Range
Once enabled, the greyscale value outside the configured greyscale range will be the valid range, so that the camera will recognize the areas whose greyscales are outside the configured greyscale range.
Identify Num
Here you can set the number of areas (whose greyscale is within the configured greyscale range) to be recognized.
Note
If the number of qualified areas exceeds the configured number, the camera will select the areas to output based on there sizes.
5. Set the result judgment parameters in Judge Method.
● Quantity Range: If the actual number of recognized areas is within the configured quantity range, the result will be OK, otherwise it will be NG.
6. Optional: Set extra parameters if the result is not what you have expected in Extend Parameter.
● Area Range: Defines the size of the detection area (unit: pixel).
7. Click Test Running to test the detection according to settings.
Note
Click Stop Running to stop the test.

13.3.2 Edge Count

The edge-counting tool can recognize and count edges based on the configured edge-counting sensitivity.
The parameter settings for the edge-counting 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 , and then click two different positions on the base image to draw a detection area.
Note
○ On the top left of the live view window, click next to Base Image to view descriptions of the coordinate axes.
○ Click beside Detection Area, and the animated tutorial will pop up in the upper-left corner of the live view panel, as is shown in the figure below.

Figure 13-7 Draw Detection Area

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 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
Here you can set the sensitivity of edge counting.
Identify Num
Here you can set the maximum number of qualified edges to be recognized based on the configured sensitivity.
● In Judge Method, you can set parameters related to result judgment.
Quantity Range
If the actual number of recognized edges is within the configured quantity range, the result will be OK, otherwise it will be NG.
● In Extend Parameter
● , you can set extra parameters if the result is not what you have expected.
Edge Polarity
It represents the excessive change of color, defines the direction to look for the edges in a detection area. Here the edge is the line between two areas with different greyscales.
Black to White
The tool recognizes edges from the area with higher greyscale to the area with lower greyscale.
White to Black
The tool recognizes edges from the area with lower greyscale to the area with higher
greyscale.
All
The tool recognizes edges from the area with higher greyscale to the area with lower greyscale and from the area with lower greyscale to the area with higher greyscale.
After setting the above parameters, you can go to Output → Tool Results to set which data to transmit to the communication tool by the edge-counting 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, edge point X, edge point Y, line start point X, line start point Y, line end point X, line end point Y, and line angle.

13.3.3 Pattern Count

The pattern-counting tool can recognize and count patterns via the template-matching method.
The parameter settings for the pattern-counting tool include range settings, recognition settings, judge method settings, and extend parameter settings.
Range Settings
You can set area-related parameters.
Detection Area
Here you can set the area that the tool analyzes. It it set to analyze the base image by default. Click to draw boxes on the base image, the position and size of the boxes can be adjusted manually. Click to set the whole base image as the detection area.
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 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.
Search Settings
.You can set search-related parameters
Template Area
Click Edit, and then click or to draw boxes or polygons on the base image, the position and size of the graphics can be adjusted manually.
Note
After drawing an area, you can click → Select similar patterns to manually set the match point. Click Reset to restore to default if needed.
Template Shielded Area
Click Edit, and then click or to draw boxes or polygons on the base image, the
position and size of the graphics can be adjusted manually.
Template Sensitivity
It can be set to "Manual" or "Auto".
● Manual: To manually adjust the template's sensitivity by setting Coarse Granularity and Greyscale Threshold.
● Auto: To automatically adjust the template's sensitivity according to the configuredsensitivity range. The higher the sensitivity, the more features of an template areawill be recognized, so the detection result will be better.
Identify Num
Here you can set the maximum number of qualified patterns to be recognized based on the configured sensitivity.
Judge Method
You can set parameters related to result judgment.
Quantity Range
If the actual number of recognized patterns is within the configured quantity range, the result will be OK, otherwise it will be NG.
Extend Parameter
You can set extra parameters if the result is not what you have expected.
Min Score
The degree of the similarity between the template and the target object, i.e., the similarity threshold. Only if the actual similarity is higher than the configured similarity threshold can the object be recognized. The similarity range is between 0 and 1, and 1 indicates completely match.
Polarity
Polarity represents the excessive change of color from the object to the background, it can be considered or ignored during recognition. If the polarity of an object's edges is different from that of the template, to ensure that the object is recognized, you need to set the polarity to Ignored, otherwise you can set it to Considered to accelerate the search.
Angle Range
If the object's angle changes but is still within the configured angle range, it can still be recognized, otherwise it cannot be recognized.
Overlap Rate
The maximum overlap rate allowed when detecting multiple objects of which two objects overlap with each other. The higher the overlap rate, the larger the area of two objects is allowed to be overlapped.
After setting the above parameters, you can go to Output → Tool Results to set which data to transmit to the communication tool by the pattern-counting tool. The data can be transmitted are as follows: module status, the number of matches, match box X, match box Y, match box width, match box height, match box angle, and score.