Custom Vision Object
From the Epson RC+ 8.0 Ver.8.1.3.0 and later versions, custom vision objects are available in PC vision. It can be used by installing the Extension"Custom Vision Object (PV)” from the Extensions Manager.
The object installed in the "Custom Vision Object” on the upper side menu in the vision guide screen will be displayed. Here, you can place objects in sequences just like normal objects.
KEY POINTS
Custom vision objects can only be used in the Epson RC+ Premium Edition and higher.
Custom Vision Object
Overview of Custom Vision Object
The custom vision object converts images and detects models based on each image processing logic. Configure the custom vision object using the following descriptions as a reference.
The displayed properties and operation differs depending on the features and characteristics of each object. Make sure to refer to Chapter 6 “Developing PC Vision Custom Vision Objects” of RC+ Extensions 8.0 and the respective documents of custom objects.
Custom Vision Object Layout
The custom vision object has a search window and a model window, as shown below.
Depending on the custom object, the model window may not be displayed.
Model windows are not displayed for custom vision objects that converts images and custom vision objects that does not require teaching.
| Symbol | Description |
|---|---|
| a | Step Number in Sequence |
| b | Object Name |
| c | Search Window |
| d | Model Window |
Custom Vision Object Properties
The following list is a summary of properties for the custom vision object. For details on each property, refer to the following.
"Vision Guide 8.0 Properties & Result Reference"
The properties displayed will vary depending on the custom object. Only the necessary properties will be displayed depending on the custom object’s characteristics.
| Property | Description |
|---|---|
| AbortSeqOnFail | Allows the user to specify that if the object fails (not passed), then the entire sequence is aborted at that point and no further objects in the sequence are processed. Default: False |
| Accept | Specifies the shape score value to determine that the feature has been detected. It detects objects that scores exceed the set value. If the value is small, it may result in false detection. Default: 700 |
| Caption | Assigns a caption to the custom vision object |
| CurrentResult | Defines which result to display in the Results list (on the Object window) or which result to return data for when the system is requested to find more than one feature within a single search window. |
| Description | Sets a user description Default: Blank |
| Enabled | Specifies whether to execute the object. Default: True |
| FailColor | Selects the color of an object when it is not accepted. |
| Graphics | Specifies which graphics to display. |
| LabelBackColor | Sets the background color for the object's label. |
| ModelWin | Runtime only. Sets or returns the model window left, top, height, width parameters in one call. |
| ModelWinCenterX | Defines the X coordinate value of the center of the model window. |
| ModelWinCenterY | Defines the Y coordinate value of the center of the model window. |
| ModelWinHeight | Defines the height of the model window. |
| ModelWinLeft | Defines the left most position of the model window. |
| ModelWinTop | Defines the top most position of the model window. |
| ModelWinWidth | Defines the width of the model window. |
| Name | Used to assign a unique name to the custom vision object. Default: Geom01 |
| NumberToFind | Defines the number of objects to find in the current search window. (Custom vision objects can find more than one object at once.) |
| PassColor | Selects the color for passed objects. |
| PassType | Selects the rule that determines if the object passed. Default: SomeFound |
| SearchWin | Runtime only. Sets or returns the following parameters in one call. Search window left, top, height, width, X coordinate of the center, Y coordinate of the center, radius size of inner circumference, radius size of outer circumference |
| SearchWinCenterX | Defines the X coordinate value of the center of the area to be searched. |
| SearchWinCenterY | Defines the Y coordinate value of the center of the area to be searched. |
| SearchWinHeight | Defines the height of the area to be searched. (unit: pixel) |
| SearchWinLeft | Defines the left most position of the area to be searched. (unit: pixel) |
| SearchWinTop | Defines the upper most position of the area to be searched. (unit: pixel) |
| SearchWinWidth | Defines the width of the area to be searched. (unit: pixel) |
| Sort | Selects the sort order used for the results of an object. |
| ThresholdHigh | Works with the ThresholdLow property to define the gray level regions that represent the feature (or object), the background, and the edges of the image. Default: 128 |
| ThresholdLow | Works with the ThresholdHigh property to define the gray level regions that represent the feature (or object), the background, and the edges of the image. Default: 0 |
Custom Vision Object Results
The following list is a summary of the custom vision object results with brief descriptions. For details on each result, refer to the following.
"Vision Guide 8.0 Properties & Result Reference"
The results displayed will vary depending on the custom object. Only the necessary results will be displayed depending on the custom object’s characteristics.
| Results | Description |
|---|---|
| Angle | Returns the amount of rotation associated with a part that was found. (i.e. This defines the amount of rotation a part may have in relation to the originally taught orientation. |
| CameraX | Returns the X coordinate position of the found part's position (referenced by model origin) in the camera coordinate system. |
| CameraY | Returns the Y coordinate position of the found part's position (referenced by model origin) in the camera coordinate system. |
| CameraXYU | Runtime only. Returns the CameraX, CameraY, and CameraU coordinates of the found part's position in the camera coordinate system. |
| Found | Returns whether the object was found. (i.e. whether the feature or part have a shape score which is above the Accept property's current setting.) |
| NumberFound | Returns the number of objects found. (The detected number can be from 0 up to the number set with the NumberToFind property.) |
| Passed | Returns whether an object detection result was accepted. |
| PixelX | Returns the X coordinate position of the found part's position (referenced by model origin) in pixels. |
| PixelY | Returns the Y coordinate position of the found part's position (referenced by model origin) in pixels. |
| PixelXYU | Runtime only. Returns the PixelX, PixelY, and PixelU coordinates of the found part's position in pixels. |
| RobotX | Returns the X coordinate position of the found part's position (referenced by model origin) with respect to the Robot's Coordinate System. |
| RobotY | Returns the Y coordinate position of the found part's position (referenced by model origin) with respect to the Robot's Coordinate System. |
| RobotU | Returns the U coordinate of the detected object in the robot coordinate system. |
| RobotXYU | Runtime only. Returns the RobotX, RobotY, and RobotU coordinates of the detected object in the robot coordinate system. |
| Scale | Returns the scale factor. |
| Score | Returns an Integer value which represents the level at which the feature found at runtime matches the model for which custom vision object is searching. |
| ShowAllResults | Displays a dialog box which allows you to see all results for a specified vision object in a table form. This makes it easy to compare results. |
| Time | Returns the amount of time required to process the object (unit: millisecond). |
How to Use Custom Vision Object
It can basically be used in the same way as other objects.
Refer to each individual custom vision object explanation for more details.