Category: VisionGauge®

Program Toolbox – Error Options

The Program Toolbox now contains new Error Options in the Options setup, with the ability to set variables on error or jump to specific steps on error.

Absolute Value of Deviation from Nominal

We have added the ability to output the absolute value of the control sections’ deviations from nominal to a Data Group. This also modifies the tolerances accordingly, when applicable. The new option to output the absolute value is defined when setting up each control section. Note that the displayed deviation from nominal on the image will still be the actual value as computed, and only the value output to the Data Group will be modified.

This update further enhances the robustness of the Threads measurements ROI selection. To be able to carry out proper measurements with the pitch, the minimum required number of full thread crests and roots is now 2.

This update also adds support for horizontal thread measurements (for vertically position screws), including all the previous measurement capabilities for threads. The orientation of the threads is selected in both the manual measurement mode and the Program Toolbox Measurement step in the the Threads Measurement tab.

A new “Print” option has been added to Data Groups under the “File” menu to allow printing the currently shown data in the Data Group (across multiple pages, as needed).

In this update, additional support has been added when setting up computer controlled illumination to skip over/offset a module’s channel. This permits our technicians to setup the new octant-based illumination with other illumination channels in a more familiar configuration, with backlight set as the first channel.

On systems with DirectX compliant video acquisition devices, when opening the “Settings – DirectX Video Properties” menu to adjust camera settings, live video will now activate to display live feedback of the changes being made.

Improved Counting and Sizing operations when using dilation adjustments to ‘merge’ close objects.

Addition of a “Smallest Object Equivalent Diameter” measurement with tolerances for Counting and Sizing operations.

Counting and Sizing “Largest object..” results now factor in user limits when returning the largest object in the ROI.

VisionGauge OnLine’s DDE Server capabilities have been updated with the following topics:

A new “Quicksave” Topic was added to our DDE server support to activate the QuickSave feature with its current configuration (in the Settings – General Preferences). When the image has been saved, the filepath is returned to the DDE client.

Also a new “Measure” Topic was added to start a measurement and return the result from the DDE client (e.g. Excel). The Item string serves as a description of the measurement being taken.

Ethernet Motion Control Drive support:

Improved timeout scenarios when awaiting a response from an ethernet motor drive before disabling the drive.

---

Multilingual/Localisation Support:

This updates adds further multilingual support. The following windows have been updated with localisation support:

Annotation Label for measurements
Configure Measurement Toolbox Label
Allow User to Confirm Measurement
Area/Pathline Measurement windows
Measurement Additional Settings window
Measurement Toolbox + Set dialogs
Snap Mode window
Units dialog + Advanced
String/Numerical Variables Setup

Support has been added for Unicode characters in Automatic DDE to Excel filepaths and in the Program Toolbox “Step” label.

All String Variables can now be Unicode strings.

This update adds the ability to bypass requiring a password for operators when accessing the Live Image Overlay Settings menu, if the Security Manager has been setup with password protection. This grants operators access to specific overlay settings. However, further access to DXF Overlay calibration and alignment-specific settings are still password protected.

The following fixes have also been made:

• This update corrects an issue in the Program Toolbox where ROI’s for the Threads or Trace Width measurement tools may need to be reset when loading programs with previously saved ROI’S.
• Fixed an issue in Remote Program Communications when receiving multiple commands at once that may contain errors or that may repeat the same command. Previously commands received simultaneously during the same input window would only execute the first command.
• An issue was also fixed that may cause a crash during Digital Input Monitoring or Remote Program Communications if a program was running in the Program Toolbox but the toolbox itself was closed.
• This update includes a fix that can prevent a designated program channel from properly saving the selected program in the Input Monitoring window.
• Fixed an issue that might occur when shutting down VisionGauge OnLine that could crash the software if the Status Box is in a certain state.
• A potential crash has been fixed when opening the Measurement Mode window when a Marker to Marker tab is already active, or when changing to the the Marker to Marker tab on some systems due to Datum/Lines data being selected and updating.
• This update includes a fix for a crash that can occur when opening the CAD Navigator window multiple times in a row.
• This update adds improved handling for warning/error notifications, particularly when errors are reported from various threads, preventing crashing in various cases – mostly relating to live video display. This improves stability of the software in the event of various errors which could present as random software crashes.
• This update fixes a bug when inserting or deleting Program Toolbox steps where some parameters in Data File steps later in the program than this insertion/deletion point would not transfer to the new step position.

Program Toolbox – “Wait” Settings

The Wait Program Toolbox step has been updated with a new option that would disallow empty input from a Wait – “Wait for user input” step. When selected, the dialog prompt to enter input will continue to be displayed until non-blank input is entered.

Parallelism and Perpendicularity Alternate Mode

An option for an alternative method to measure Parallelism and Perpendicularity has been introduced when performing these measurements either manually or through the Program Toolbox. This alternate method specifies the first two points to define the initial reference line, as before. However, the third point establishes a single point on the comparison line, while the 4th point establishes a direction for the comparison line to extend. An extra parameter is required to specify how far away on the comparison line to project the point to be measured. The returned measurement is the projected point to the 2nd reference line (still defined as a line parallel to the 1st reference line passing through the 3rd point).
A new “Additional Setup” dialog allows enabling this alternate method during measurement selection.

We have added support for new Thread measurement and inspection tools in the manual and automated measurement modes. When selected, this measurement mode allows multiple measurements to be returned from the result of drawing a single ROI around the top and bottom threads. A minimum of 4 threads is required to complete all measurement options.

Thread feature measurements currently able to be reported include:

• Average minor diameter
• Average major diameter
• Average pitch diameter
• Minimum pitch diameter
• Maximum pitch diameter
• Average pitch

Specific points calculated from the measurements can also be saved as Datums for re-use in further measurements.

For more information and an overview video, visit the Thread inspection and measurement page.

---

The top-bottom thread edge profile detection has been improved with regards to filtering stray contaminants above/below threads.

This update introduces template Excel files that are used to automatically create specific Excel files when outputting data from the Data Groups, without having to pre-create the target Excel file. Currently supported templates are Excel files with the extensions .xlsx, .xls, .xlsm.
The new, blank template files provided in the C:/vgOnLine/Reports/Templates directory can also be customized, or replaced with your own standard templates in this directory renamed the target extension as ‘template’.

---

Writing Data Groups to file with string variables used into the filename will now replace the ‘:’ populated by a date/time string with dashes, for Windows file naming compatibility.

We have added support for up to 12 light sources in VisionGauge® OnLine, including the ability to ‘lock’ sequential channels together so their illumination levels all increase/decrease together. Locked illumination channels can be unlocked to control the channels individually. This can be useful for fine illumination control with specific modules that have multiple LEDs.

This update supports our newly released Octant-based Reflected Illumination module.

---

We have also enhanced general performance for manually controlling computer controlled illumination channels to reduce lag when adjusting the values.

The log file has been updated to include Program Toolbox steps as well as status box messages when enabled.

---

A camera rotation configuration has been added to the Image Capture Settings. This configuration is useful in specific system builds and camera selections when it fits the application.

---

We have added expanded support to read analog input with new devices. These new devices also have the option during configuration to convert the analog input result to voltage.

• We’ve carried various performance enhancements and user interface quality improvements.

The following fixes have also been made:

• Fixed various potential crash conditions when executing and loading programs
• Outputting data as whole numbers to a Data Group that has existing real values may temporarily modify the number of significant digits of the entire Data Group. This has been resolved.
• Fixed a crash condition when reading in overlays after an overlay with Tooth Checker settings enabled has been read in.
• Fixed an issue when the first instance of displaying live video in some scenarios may result in the software appearing to freeze up.

Program Toolbox – “Pause” Settings

A new option has been added to the “Program Toolbox – Pause” step settings to allow saving the current image in the program before pausing and restoring that image when the program resumes. This option is enabled by default. Disabling this option would use the current image at the time the program is resumed (if the image changes while the image is paused…)

Program Toolbox – Image Overlay Settings

Additional Settings have been added to the “Program Toolbox – Image Overlay” step for an Auto-Align operation. These settings only apply to certain systems that have been setup with axes for part rotation. In this configuration, users can now choose to follow-up an Auto-Align step by rotating the axis controlling part rotation by the amount of the offset of the Auto-Align step result.

 

We have also added an option in the “Program Toolbox – Image Overlay” step to allow output to CSV file of the X,Y position of the located edges from the Auto-Pass/Fail operation on Entity cross sections. All Entity cross section edges located in the current field-of-view are output to the CSV file. The output file name is able to be configured by the user manually or by using a stored string variable. It is also possible to add a time/date string to the end of the filename at the time of output.

Expanded support for defining measurements using Line datums

We have expanded support for Line measurements in manual and automated measurements in the latest version of VisionGauge® OnLine. These enhancements allow operators to use the “Line Finder” and “Edge Break” measurement tools to save a located line as a Line datum (similar to our Datums), and then re-use these “Lines” in future measurements. As with Datums, these Lines travel with a part as the stage moves, such that a Line defined on the edge of a part still references the same edge as the part moves along the stage. For some measurements, previously only a single Line was able to be defined for measurements, and now we allow multiple lines to be defined to support more complex measurements.

Setup of these measurements can now select Define Using Lines to enable options to define which Lines to use. Measurements supporting definition using these Line datums include:

 

General Measurements:

• “2-point” angles measuring from horizontal or vertical – requiring 1 Line
• “4-point” angles measuring between two lines – requiring 2 Lines

 

Marker-to-Marker Measurements:

• Intersection of 2 Lines – requiring 2 Lines
• Orthogonal to a Line (or Closest Point on a Line) – requiring 1 Line
• Orthogonal to a Line Bisecting an Angle – requiring 2 Lines. This measurement can now also be defined with standard Datums, too.

 

Miscellaneous Measurements:

• Roll Pin Distance – requiring 4 Lines (2 Lines per Roll Pin). An additional point is required to select approximately the center of each of the Roll Pins and determine between which line segments the Roll Pin is located: In a manual measurement, the operator must use the mouse to select where the Roll Pin is located, while in an automated measurement, a Datum must be defined before that is located in the appropriate segment.

 

We have also included an option when using the Line Finder and Edge Break tools to apply iterative sub-pixel refinement which can greatly improve the resulting Line along imperfect edges.

---

Intersection of a Circle and a Line Projection & Orthogonal to a Line Tangent to a Circle Measurements

This update adds 2 more automated measurements to the Program Toolbox – Measurement step. The Marker-to-Marker measurements now include “Intersection of a Circle and a Line Projection” and “Orthogonal to a Line Tangent to a Circle”, which were previously introduced to the manual measurement mode.

---

RS-232 COM Measurement Device Support Added

Support has been added to allow measurements from RS-232/COM devices (or those with USB adapters that create a COM port in Windows). When starting VisionGauge® OnLine with this update, the user will be prompted if they want to support any of these devices.

During configuration, the RS232/COM device parameters must be entered for each device, including bit rate, data bits, parity, stop bits, a device description, and the command to request a measurement from the device.

A new option for RS-232/COM Port Measurement has been added to the “Miscellaneous” tab of the manual measurement mode, as well as the Program Toolbox – Measurement step. During this setup, users need only select the number of the device they setup.

During manual measurement mode, simply pressing the Measure button will obtain the reading from the device and send it to a Data Group accordingly.

---

Roll Pin Distance Returned Value update

We have added a “Returned Value” option in the Program Toolbox for “Roll Pin Distance” measurements. As with other measurements that support it, this permits the user to determine if the straight-line distance is returned between the measurement points or only the horizontal or vertical component of this distance.

We have also added clarification to the measurement string returned about which value is selected. The same adjustments have been made to the manual measurement mode for Roll Pin Distance, referred to as “Primary Measurement”.

We have added the ability to edit the Motion Control Toolbox’s list of System Coordinate names. By default these are named “Coordinate System #X” for each label, up to 20 coordinate systems. At the bottom of the System Coordinate menu, users can now access a dialog box to edit these names. The names will carryover from session to session of the software.

---

We have enhanced the software to accommodate recent hardware changes to our newer ethernet motion control drives. Existing system with drives in this configuration will remain unchanged, except the software will startup faster than before.

---

We have added a 1-second wait after a stage has been instructed to home to allow the motion control system to settle after the last movement before setting the position to zero for greater positional accuracy when applying 2D XY Stage Corrections.

To protect against lost software settings when Windows is shutdown or restarted while VisionGauge® OnLine is still running, VisionGauge® OnLine will now signal that it is still running and object to shutting down Windows before the software is properly closed. If a Windows shutdown event forces VisionGauge® OnLine to close without saving the current settings, the user will be notified about the event upon startup of the following session and the last properly saved settings will attempt to be used. Examples of such shutdown events are Windows automatic updates, users logging off, and other manual or automatic restarts. As a reminder, it is highly recommended to shut down VisionGauge® OnLine properly before initiating a Windows reboot, shutdown, or user log-off operation.

---

We have added a notification for users when attempting to read in a newer version of Control Section or Entity-Based Auto-Pass/Fail files. The same notification is also now available for setup files. This may prevent certain crashes users experience when reading in unsupported files, particularly when sharing files between systems that do not have the same software revision.

---

We have expanded support for input/output of rotary stage coordinates in the Degree/Minutes/Seconds format. These units can be selected as usual from the “Settings – Units” menu. Various locations in the Motion Control Toolbox, Program Toolbox, and output have been updated with this support.

• We’ve carried various performance enhancements and user interface quality improvements.

The following fixes have also been made:

• We have corrected an issue where the manual measurement mode could be switched during an active measurement operation, which could cause a software crash with certain measurement types.
• We have corrected an issue where the software used the wrong value when outputting the overlay’s rotation position to a Data Group from the “Program Toolbox – Image Overlay” step.
• We have corrected an issue when recalling an overlay through a Data Group may change the units to ‘pixels’ if images are being collected in the Data Group. Also recalling an overlay through a Data Group previous might not have properly displayed edge search ranges for Auto-Pass/Fail entities.
• We’ve corrected an issue where certain .dxf files may appear to read properly, but would display no entities or only text entities overlapping each other.
• We’ve corrected an issue that may happen intermittently when manually starting an Auto-Align operation in the Overlay Translation/Rotation window. In those instances, the Auto-Align may appear to start but finishes immediately without actually moving the overlay: Pressing the button additional times results in the Auto-Align operation starting and completing as intended. This has been resolved and operates as intended on the first button press.
• Previously Data Groups that had the option to restore overlays and offsets enabled were unable to properly restore the overlay when a result was populated by an automated program. This has been resolved and overlays are restore no matter how the result was populated.

Overlay Toolbox Pinned buttons

The Overlay Toolbox has been enhanced to allow ‘pinned buttons’ at the top of the list. These pinned buttons will not be cycled down the list of quick recall overlay buttons when reading in a new overlay, and the information loaded into them will persist session after session. These buttons are outlined at the top of the Overlay Toolbox. New overlays loaded through typical actions (Program Toolbox steps, barcode scanning, Overlay Toolbox “Browse” button, etc.) will be loaded into the non-pinned section as usual after these pinned buttons.

A new item in the Overlay Toolbox “Options” menu allows users to configure how many buttons are currently pinned. It is possible to pin the full toolbox set (currently updated to 40 buttons).

Loading a pinned button is possible by two methods:

You may right-click on the pinned button you want to load and select the “Load Pinned Button” menu option. You can then browse to a file to load as usual.

You may-right-click on an already loaded Overlay Toolbox button and select “Pin Button Contents”, then select to which pinned button number you want to copy this overlay.

It is now also possible to remove the contents of an Overlay Toolbox button by right-clicking the button and selecting “Remove button contents”.

These new options are capable of password protection through the Security Manager. We have also added options in the Operator Mode to disable/enable access to these options.

Also, a new “Options” menu item in the Overlay Toolbox allows the user to specify “40 buttons”. When this option is selected, two tabs will appear at the bottom of the Overlay Toolbox. The left tab will display Buttons 1-20 and the right tab will display Buttons 21-40.

The last open tab will carryover between sessions of the software. Also the current number of pinned buttons will be taken into consideration across both tabs, allowing for a total of 40 pinned buttons, if required.
Note, loading a new overlay with the Browse option, by the Quick Load, or through the Program Toolbox will add the overlay to the first ‘unpinned’ button, as usual. If the first unpinned button is located on the non-active tab, the tabs will automatically change to display the last opened overlay.

Auto-Pass/Fail Entities Cross Section Analysis/Report

This update adds support for an Analysis and Report mode for Auto-Pass/Fail Entities. This feature works for entities setup either manually or automatically read in from a nominal/minimum/maximum set of DXF files.

These Auto-Pass/Fail Entity Cross Section Analysis and Report modes are accessible through the Overlay Translation/Rotation dialog when live video is activated with an overlay configured with Auto-Pass/Fail Entities.

Users may disable/enable access to the Analysis and Report options in “Overlay Toolbox – Auto-Pass/Fail Settings – Entities” section. The option is immediately accessible when loading the Entities settings for a file setup by reading in .dxf files with the minimum and maximum tolerances in addition to the nominal .dxf file. If Auto Pass/Fail Entities have been manually setup on a .dxf file, the option to access these Analysis/Report settings is available in the Entities General Settings menu.

Auto-Pass/Fail Across Multiple FOV’s in Automated Programs

We’ve added support for CAD Auto-Pass/Fail across multiple field-of-view in the Program Toolbox – Image Overlay settings. This feature can now use the multiple image buffers that were previously setup to run these multi-FOV operations and obtain Pass/Fail value across the different FOV’s.

Read more about our enhanced CAD Auto-Align™ beyond the field-of-view.

Auto Pass/Fail Entities – Output Settings

The Auto Pass/Fail Entities feature to Output Settings (Outputting Edge Points) to file has been enhanced with additional columns of data for each edge point.

This report now includes all of the following information:

Nominal X & Y coordinate

Negative direction tolerance band X & Y coordinate

Positive direction tolerance band X & Y coordinate

Edge X & Y coordinate

Deviation from nominal

Pass/Fail

VisionGauge®’s new “CAD Fitting™” tool

The new CAD Auto-Align™ feature “CAD Fitting™” has been added to the Overlay Translation/Rotation window for manual operation and the Program Toolbox – Image Overlay step for automated programs. This alternate mode of the CAD Auto-Align tool can help obtain Pass results in trickier conditions. Learn more about the CAD Fitting™ tool.

CAD Auto-Align™ beyond the field-of-view and depth-of-field

Our enhanced CAD Auto-Align™ capabilities across multiple fields-of-view and depth-of-field have been added to various places in the Program Toolbox. In the Auto Pass/Fail Control Sections Setup for a CAD file, a control section can now be associated with a particular image buffer. Image buffers are also setup in the Program Toolbox – Image Capture step to associate a location with an image buffer. The Program Toolbox – Image Overlay step “Auto-Align/Fit” and “Auto Pass/Fail” operations can now use the multiple image buffers that were previously setup to run these multi-FOV operations.

Read more about our enhanced CAD Auto-Align™ beyond the field-of-view.

Program Toolbox “Numerical and String Variables” settings

We have added a new “Increment” sub-option for the “Set Value” operation in the Program Toolbox – Numerical and String Variables program step. This “Increment” option is only valid for Numerical Variables. When activated for a Numerical Variable, the selected Numerical Variable will have +1 added to its value. With this, the program can increment a numerical variable under various circumstances during the program flow, and the modified variable can be re-used as needed.

We have also added an option to append a Numerical Variable to an existing String Variable. This may be useful when building label strings for output or creating messages for operators.

Program Toolbox – “Pause” Settings

This update enhances the Program Toolbox “Pause” operation with new options.

The option to “Activate the current measurement” will pause the program and immediately start the currently loaded Manual Measurement (as selected from a previous “Measurement Toolbox” program step in the program, for example). This will let an operator immediately start pre-loaded manual measurements, if required as part of an inspection process.

When the “Automatically resume program after a user-defined number of completed measurements” option is enabled, the paused program will resume operation after the user-indicated number of manual measurement/output operations have been completed. Actions that count as a completed measurements are 1) a standard manual measurement with normal termination, and 2) pressing the “Output” button in the “DXF Overlay Translation / Rotation” window if there is a successful output to the Data Group.

Additionally, the Pause Settings can save the number of the currently active measurements being counted as a Numerical Variable. This could be useful when building label strings for Data Group output.

These new Pause Settings options can help streamline any manual operator interactions that may need to occur during an automated program, depending on your application.

Program Toolbox – Image Overlay – Modify Auto-Pass/Fail Settings

Support has been added to allow modifying additional Auto-Pass/Fail Settings during an automated program. These changes are found in the Program Toolbox – Image Overlay step.

Programs that already use the “Set Auto Pass/Fail Edge Threshold” operation will now find their existing settings included in the new “Modify Auto Pass/Fail Settings” operation button. The option to modify the “Edge Search Range” is also now included.

This new setting may be useful when a single inspection program requires changing the edge search range for different types of measurements or part requirements.

Data Group Entry Timestamps

A timestamp string has been included for each entry that is added into a Data Group. This timestamp string will be accessible for request from DDE commands with the “EntryTimeStamp” keyword and returns the timestamp in the format “Month/Day/Year Hour:Minute:Second.Millisecond”

An example of the formula is: “=VisionGaugeOnLine|DataGroup!’1 EntryTimeStamp 1′”

This command in the “DataGroup” topic requires 3 pieces of information to properly complete in the single quotes:

The number of the Data Group to target

EntryTimeStamp – to obtain the timestamp data for this entry

The entry number in the Data Group to return the timestamp.

The Excel Report example in the C:/vgOnLine/Reports/Excel_Examples/ directory has also been updated (and renamed) with an example of this command transferring the timestamp for the first value in Data Group #1 of VisionGauge OnLine, using the formula shown above.

Operator Mode – Measurement Mode

This update adds a new option to the Operator Mode for the “Measurement Mode”. In this setting, an Administrator can select if the ‘edit box’ for manual measurements is disabled when the option to “Allow user to confirm measurements” is selected. If this option is disabled (as it is by default) the user can input any value into this text box and this is the result that would populate the Data Group. By disabling this edit box, the user is still allowed to ‘re-do’ the measurement if they choose, but they cannot manually edit what the measurement result is.

Note that this setting affects the measurement value that is inserted into the Data Group – the annotations created by the user are unaffected.

Operator Mode – Data Group Additional Settings

This update includes a new “Special Permissions” option for Data Groups in Operator Mode as “Additional Settings”. This option will allow an Administrator to allow/deny operator access to the “Clear” or “Remove” buttons across all Data Groups, as well as to disable editing the label in Data Groups, if present. As usual, Operator Mode must be turned on to be able to deny access.

Operator Mode – Overlay Toolbox Additional Settings

We have also added new “Additional Settings” in the Operator Mode for various DXF Overlay Toolbox features, including the ability to enable/disable removing, loading, and pinning button contents.

DXF Correspondence File Updates for String/Numerical Variables

This update adds two new options at the end of each DXF Correspondence File entry to load String or Numerical Variables with data. These are 2 new comma-separated options allowing the user to choose the variable type (String/Numerical) and number (currently #1-20) to load, in addition to the data to store. Entire sets of String/Numerical Variables can also be loaded at once with pre-saved files. The loaded String/Numerical Variables are then available to the user during future software actions.

Version 1.3 of the DXF Correspondence File guide is available for download.

A “Configure Label” option has been added to the Tooth Checker entities setup dialog, allowing the output from this mode to override the default label sent to the Data Group. Options to build this configurable label are:

User-defined label string

String Variable

Numerical Variable

Current Profile # and Crest/Root #

The order in which these options are selected is also recorded, and the Preview edit box displays the current setup during configuration.

Area and Pathline Measurements

We have added support for Area and Pathline manual measurements in VisionGauge® OnLine. These measurements may be found in Settings – Measurement Mode (or the “Mode” button of the Measurement Toolbox) in the “Miscellaneous” tab.

 

Pathline measurements allow the user to start ‘free-hand’ drawing a path with the cursor, when activated. Click once to start, then move the mouse to trace the path, and click the mouse again to finish. When the measurement is stopped, the total distance traveled along the drawn path is calculated in the current measurement units.

The Area measurement allows the user to outline a closed region on the image and select the region (inside or outside a closed region) for which they want to obtain an area measurement of all pixels included in that region.

Straight-Line and Free-Hand drawing methods are available and can be interchanged during a drawing mode in the dialog box that opens when starting the measurement. After the user has drawn a region, they must select the “Close Area” button which draws a final straight line between the last point selected and the first point. The user must confirm that they accept this closed region before continuing.

After the region is closed, the user must then use the cursor to select the region for which they want to obtain the area measurement:  This can be inside or outside the drawn region. The final value returned is the area in the current measurement units of all pixels included in the selected region.

Intersection of a Circle and a Line & Orthogonal to a Tangent Line to a Circle Manual Measurements

This update adds two new manual measurement tools to the Marker-to-Marker tab Measurement Mode:  Intersection of a Circle and a Line Projection & Orthogonal to a Tangent Line to a Circle

 

Intersection of a Circle and a Line Projection:

This Marker-to-Marker measurement tool can be defined as both Marker 1 and Marker 2. It requires defining first a circle followed by 2 points to define a line. You can also define this tool with datums. If defining the marker with datums, the minimum number of datums is 5 (3 points minimum to define the circle and 2 points to define the line). When selecting a larger number of datums, the number of points to define the circle must always be the number of datums defined – 2.

If you define the measurement with ROI (default), choose the number of points to define the circle as usual. You will then select that number of measurement points + 2 for the line.

The following rules apply when selecting the intersection point, considering the line selected both as a segment and as a projection:

The measurement will fail if the projection of the line does not intersect with the circle at all, in the direction the line is defined.
If the line projection intersects with the circle at a tangent point, that point will be the marker.
If the line segment intersects with/crosses the edge of the circle at one point, that point will be defined as the marker.
If the line segment intersects with the edge of the circle at two points, the point closest to the 2nd line definition point will be selected as the marker.
Finally, if the line segment does not cross the circle, but the line projection in the direction the line is defined does cross the circle, the first point on the edge of the circle along the line projection will be the marker.

In the following example, the measurement is defined with ROIs and 4 points are being used to define the circle. 2 more points define the line in the direction towards the circle. The line segment defined on the 2 lines points does not cross the circle, but the projection of the line does intersect with the circle, so the first intersection point of the line projection on the circle is returned as the marker.

 

Orthogonal to a Tangent Line to a Circle

This Marker-to-Marker tool can only be defined as Marker 2. It requires defining first a circle followed by a single point which draws a tangent line at the closest point to the circle. You can also define this tool with datums. If defining the marker with datums, the minimum number of datums is 4 (3 minimum points to define the circle and 1 point to define the tangent line). When selecting a larger number of datums, the number of points to define the circle must always be the number of datums defined – 1.

If you define the measurement with ROIs (default), choose the number of points to define the circle as usual. You will then select that number of measurement points + 1 for the tangent line.

In the following example, 4 points are used to define the circle, and a tangent line on the circle is defined with the last point using the closest point on the circle. The resulting measurement is the closest point on the tangent line to marker 1.

“Configure Label” option for Measurement Toolbox buttons

This update adds a new option allowing the user to customize the label that will be output to a Data Group when performing a manual measurement stored in the Measurement Toolbox. Previously, only the Measurement Toolbox label for the activated button would be sent to the Data Group. The new customized label may be sent to the “Label” entry of the targeted Data Group at the same time as the measurement.

This label customization option is available in the “Set” option when specifying the content to save into a Measurement Toolbox button. Users can build a customized label string with the following options:

User-defined label string

String Variable

Numerical Variable

Current Measurement Toolbox label string

The order in which these options are selected is also recorded, and the Preview edit box displays the current setup during configuration.

Restoring Measurement Toolbox Snap Radius and Snap Mode

This update also allows the current snap radius and snap mode to be saved with the Measurement Toolbox. This may be useful for applications that require loading multiple Measurement Toolboxes with different snap criteria.

We’ve carried out very significant enhancements to VisionGauge® 6-Point Nest / Reorient Tool, to make it even more widely applicable. Detailed external documentation had been created for this

We’ve added cross-polarity corrections for our center-of-rotation corrections

---

For systems using DirectX-compliant video capture devices, we have added the ability to save and recall DirectX camera properties when shutting down and restarting the software. Examples of these standard properties are exposure, gain, brightness, white balance, etc…

We’ve also added support to allow users to save the currently loaded properties to the Settings Toolbox (for DirectX-supported devices). This is useful to quickly recall device properties without having to manually change these settings.

---

“Distortion Correction” has been added to the list of Factory Locked-out Session items. This is primarily useful for technicians in the field required to carry out distortion correction as part of maintenance.

• We’ve carried out some enhancements to our “Feature Based Pattern Matching” tool, to enhance its speed & robustness.
• This update contains a number of enhancements (including significant speedups, etc…) mostly having to do with the software’s ability to read-in tolerances directly from CAD files.
• We’ve carried out very significant performance enhancements to speedup live video image refresh when working with very (!) large DXF files, especially at high magnification. These new enhancements provide a tremendous speedup in the case of very large files, a medium speedup in the case of medium-size files and very little speedup (if any at all) in the case of very small files (i.e. drawings that fit completely in the field-of-view).

The following fixes have also been made:

• We have corrected an issue in the Program Toolbox  – Wait program step, when the “Wait for User Input” option may save the input result as a String Variable, even if the option to save the result is unchecked.
• In the Program Toolbox – Image Overlay step, the “Auto-Align” operation would apply corrections at the end of the step as if an Auto-Align mode with rotation had been selected. This could cause the overlay to move to unintended locations if XY, X-, or Y- only Auto-Align modes were selected, if a default Auto-Align mode had not been previously selected.
• If a program running in the Program Toolbox was paused, the software could crash when attempting to resume the program if live video was displaying.
• An issue has been resolved where Auto-Focus may not work in an automated program following a “Pause” step.
• In the Program Toolbox, the “Run To” program mode will now properly activate a “Pause” operation in the program.
• We’ve fixed a bug related to carrying over sub-directories from session-to-session.