VRESULT real-valued function code. It continues up the chain until it finds a tool that supports the code. If no valid tool is found, an invalid vision result error is generated. For example, suppose an Arc Finder tool is placed relative to a Blob Analyzer tool. In the application, the Blob Analyzer tool locates many blobs and adds an Arc Finder tool at each instance. If you ask for the blob area associated with an arc finder instance, VRESULT will recognize that the Arc Finder tool does not support that code, so it moves to the parent tool (the Blob Analyzer tool) and finds the blob instance associated with the specified arc result.
It validates that the blob result supports the VRESULT code, and so it returns the data. Some vision tools are considered Frame Sources .The Blob Analyzer and Locator tool are the most commonly used Frame Sources. When these tools execute, it will mark each results as a separate frame or grouping. Any vision tools relative to a Frame Source will associacte each of it's results with the frame it is relative to. In this case, you may want to use the frame_id parameter to extract the results. For example, going back to the Arc Finder tool relative to the Blob Analyzer tool.
If the Blob Analyzer locates 5 different results, then the Arc Finder tool will execute 5 different Arc Finder operations, one relative to each result returned by the Blob Analyzer. The Arc Finder will associate each result with a frame number that correlates with the index of the result returned by the Blob Analyzer. So, if you want to get an Arc Fider result associated with the 4th result of the Blob Analyzer, you would reference index_id =1 in frame_id = 4. You are requesting the first instance in result frame 4. In this situation, you can still access all the Arc Finder results using frame_id = -1.
But note, some child vision tools may have multiple results within each frame and sometimes might have no results within a frame. Example The following illustrates how to retrieve a specific tool result. ; Get the number of instances found by a Locator. ; instance count = 1310 instance_count = VRESULT($ip, 1, 2, 1, 1310) ACE Reference Guide, 18317-000 Rev A Page 44