Mastercam-to-Vericut Interface (McamV)¶

Overview McamV is a licensed software tool that facilitates the seamless transfer of manufacturing data from Mastercam to Vericut.

Software Requirements: Mastercam Interface¶

Licensing Requirements

CGTech Licensing:
Mastercam Interface

Installation & Configuration: Mastercam Interface¶

Using an Installer
¶

To install the Mastercam-to-Vericut Interface (McamV), download the latest Vericut Software Release and run the mastercam_interface_install.exe, then follow the step-by-step prompts to complete the installation.

You can download the installer from the Vericut website:
Request Latest Vericut Software Release

Environment variables: Mastercam Interface
¶

To enable the Mastercam Interface to locate the necessary Vericut files, the following environment variables must be defined:

Environment Variables: Description & Example
CGTECH_INSTALL
Purpose: Defines the Vericut installation folder.
Example: For Vericut 9.7, set to: C:\Program Files\CGTech\Vericut 9.7

CGTECH_PRODUCTS
Purpose: Specifies the folder for the operating system running Vericut (windows64).
Example: For Vericut 9.7, set to:
C:\Program Files\CGTech\Vericut 9.7\windows64

LSHOST
Purpose: Defines the name of the license server computer.
Example: localhost

CGTECH_SINGLE_PLATFORM (Optional)
Purpose: Specifies if Vericut is running on a single platform.
Example: CGTECH_SINGLE_PLATFORM=YES

CGTECH_DEFAULT_PROJECT (Optional)
Purpose: A default Project Template file can be specified using the CGTECH_DEFAULT_PROJECT variable in the batch file that you use to start Mastercam.
Example:
CGTECH_DEFAULT_PROJECT=C:\Temp\McamV_Template.vcproject

Set up a Vericut icon: Mastercam Interface¶

To quickly access McamV from within Mastercam, you can add the Vericut icon to the ribbon interface.

Steps to add the Vericut icon to the Mastercam Ribbon

1. From the Mastercam Quick Access Toolbar, select More Commands...
   

2. Select Customize Ribbon

3. Add a New Group to the Machine tab

4. Rename to Vericut

5. Add the Run Vericut icon
   

6. Select OK
   

Microsoft Redistributables: Mastercam Interface¶

The Mastercam-to-Vericut Interface (McamV) may require the installation of Microsoft Redistributables, specifically the Windows C++ run-time libraries. These libraries ensure compatibility and proper functioning of the interface, allowing seamless data transfer between Mastercam and Vericut for manufacturing simulation.

Note: A runtime library is a collection of low-level compiler support routines and functions that are used by virtually all programs compiled with GCC (GNU Compiler Collection) and can be downloaded here.

Documentation: Mastercam Interface¶

Overview: The Mastercam interface exports manufacturing data from Mastercam to Vericut, ensuring a seamless transition for simulation. It automatically configures the necessary Vericut setup requirements and launches the simulation, ready to play.

Vericut Simulation Setup Requirements: To run a successful simulation in Vericut, the following steps must be completed:

1. Select a VMC (Vericut Machine Configuration) – Define the machine setup for simulation.

2. Select and Orient Stock, Fixture, and Design Models – Ensure correct positioning of components.

3. Select NC Programs & Subroutines – Load the necessary machining programs.

4. Define Cutting Tools – Specify the tools used in the machining process.

5. Define Work Offsets Tables – Configure coordinate systems for accurate machining.

Accessing the Mastercam-to-Vericut Interface¶

To connect Mastercam with Vericut, follow these steps:
The Interface is activated by clicking Vericut icon

Important Note: The Mastercam interface requires an active NC Manufacturing file to function properly with Vericut.

When you trigger McamV, you should see a window similar to this:

License Handling
- The interface checks out a license when opened.
- The interface checks in the license when closed.

Files¶

Working Directory: Enter the path to the directory where you want the Vericut files output. Use the (Browse) icon to display a directory selection window and use it to specify the path.

File Name: Enter the "base" name for Vericut files that will be created. By default the name of the Mastercam .MCX file is used.

Project Template: Enter the /path/filename of the "template" .VcProject file that you want loaded in the text field. Use the (Browse) icon to display a file selection window and use it to specify the /path/filename. A "template" .VcProject file is a previously defined Vericut project file. A default Project Template file can be specified using the CGTECH_DEFAULT_PROJECT variable in the batch file that you use to start Mastercam. Example:

set CGTECH_DEFAULT_PROJECT=C:\MCamV_working\McamV_Template.vcproject

Retain Setups: When toggled "on" (checked), MCAMV will append the operations in the Mastercam part file, to the setups that are already defined in your Project Template file, and setups from both files will be contained in the generated project file. Otherwise, and more typically, the imported Mastercam part operations will be the only setups in the generated project file.

Put operations into a single Vericut setup: When toggled “on” (checked), MCAMV will combine all the Mastercam operations into a single Vericut setup.

ToolPath Groups¶

All of the Mastercam ToolPath Groups shown in the Operations Manager are available in this list. Use the list to select the operation that you want selected settings to be applied to.

Transfer Toolpath Groups: Use to specify the toolpath groups to process. All Process all toolpath groups in the list. Selected Only Process only selected toolpath groups in the list.

When an operation is selected from the list, the Settings for Toolpath Groups field is updated so you can see at a glance which operation you are selecting settings for.

You can create/change setting for all of the Mastercam Toolpath Groups (Operations) shown in the Toolpath Groups List. Use the list to select the toolpath group (operation) that you want selected settings to be applied to. When an operation is selected from the list, the Settings for Toolpath Group field is updated so you can see at a glance which toolpath group (operation) you are selecting settings for.

Models¶

Stock: By default, MCAMV will create STL Stock models based on the information in the Mastercam Machine Group Setup function panel information.

If the Mastercam Machine Group Setup function panel information is not present, then MCAMV will create STL Stock models based on the Mastercam Level > Name/Number set in the Options > Modeling Tab.

Alternately, you can select the geometry to use in the simulation.

Use the (Refresh) icon to clear the Stock STL File list, and re-read Stock models from the Mastercam Machine Group Setup function panel information

Use the Stock text box on top of the list to specify the Stock component name, which is “Stock” by default.

Use the (Remove) icon to remove the selected STL File(s) from the Stock STL File(s) list.

Use the (Select Level) icon to select Stock models from a Mastercam level.

Use the (Pick) to select Stock model(s) in the Mastercam graphics area. Note: multiple selection is available.

Design: By default, MCAMV will create STL Design models based on the information in the Mastercam Machine Group Setup function panel information.

If the Mastercam Machine Group Setup function panel information is not present, then MCAMV will create STL Design models based on the Mastercam Level > Name/Number set in the Options > Modeling Tab.

If the Mastercam Level is set to Not Visible at the time of export, the Vericut models will be set to Translucent.

Alternately, you can select the geometry to use in the simulation.

Use the (Remove) icon to clear the Design STL File list, and re-read Design models from the Mastercam Machine Group Setup function panel information

Use the Design text box on top of the list to specify the Design component name, which is “Design” by default.

Use the (Remove) icon to remove the selected STL File(s) from the Design STL File(s) list.

Use the (Select Level) to select Design models from a Mastercam level.

Use the (Pick) to select Design model(s) in the Mastercam graphics area. Note: multiple selection is available.

Fixture: By default, MCAMV will create STL Fixture models based on the information in the Mastercam Machine Group Setup function panel information.

If the Mastercam Machine Group Setup function panel information is not present, then MCAMV will create STL Fixture models based on the Mastercam Level > Name/Number set in the Options > Modeling Tab.

Alternately, you can select the geometry to use in the simulation.

Use the (Remove) icon to clear the Fixture STL File list, and re-read Fixture models from the Mastercam Machine Group Setup function panel information

Use the Fixture text box on top of the list to specify the Fixture component name, which is “Fixture” by default.

Use the (Remove) icon to remove the selected STL File(s) from the Fixture STL File(s) list.

Use the (Select Level) to select Fixture models from a Mastercam level.

Use the (Pick) to select Fixture model(s) in the Mastercam graphics area. Note: multiple selection is available.

Note: When models are selected in the Interface, they are highlited in Mastercam.

Attach Plane: Use this option to select a Mastercam Plane to represent the Vericut Attach component. The name of the currently selected Plane will be displayed after the Attach Plane label or None will be displayed if there is no currently selected Coordinate System.

Use the (Clear) icon to clear a previously selected Coordinate System.

Use the (Browse) icon to display the Mastercam View Selection window and use it to select a Mastercam Plane.

Stock Plane: Use to select a Mastercam Plane that describes how the Cut Stock is to be oriented when transferred from one Vericut setup to the next. The name of the currently selected Coordinate System will be displayed after the Stock Plane label or None will be displayed if there is no currently selected Coordinate System.

Use the (Clear) icon to clear a previously selected Coordinate System.

Use the (Browse) icon to display the Mastercam View Selection window and use it to select a Mastercam Plane.

Attach Component: The Attach Component is the Vericut component in which the coordinate system will be attached to.

Note: By default the Attach Plane and Stock Plane are set if the Plane names include attach and stock

Tools¶

Select one of the following options from the pull-down list:

• Generate Tools from Mastercam: Choose this option to have McamV create a tool library using the tool data in Mastercam.

• Use Tools from the Setup Template: Choose this option to use the tool library file stored in the Setup Template instead of one created by McamV.

• Merge Tools into Setup Template Tool Library: Choose this option to merge the tool library created by McamV, with the tool library file stored in the Setup Template, and use the "merged" tool library rather than one created by McamV.

• Use Selected Tool Library: Choose this option to specify a specific tool library to use. Enter the \path\filename of the tool library file in the text field or use the icon to display a file selection window and use it to specify the /path/filename of the tool library file.

Note: Ghosted Toolpaths - POSTING OFF Tools referenced in a Ghosted Toolpath will export if a Transform Operation is present in the Toolpath Group.

Mastercam Help Center
Type and Methods: Transform Operation Parameters

Use the Type and Methods tabe in the Transform Operation Parameters dialog box to create or edit a transform operation. Here you select the source operations and the type of transform. Your also define how Mastercam creates the transformed operations.

After your select the type of transformations, choose the remaining dialog box tab to complete the operation. For example, if you choose a rotate transformation type, only the Rotate tab is available, the Translate and Mirror tabs do not display.

Note: The Interface takes the Tool Manager > Driven Point / Cutter Compensation > ID values from the Mastercam > Toolpath > Parameters > Tool > Length offset / Diameter offset values.

Note: Custom Cutter and Holder geometry is supported with MCAMV. The custom cutter may be reference in another level or in another Mastercam file.

NC Programs¶

NC Program Type: Use to specify the NC program type. Select either NCI or GCode.

Note: To verify NCI data, all you need to do is click the OK button. By default, the files needed by Vericut will be generated in the same folder as the currently accessed Mastercam file.

NC Program Files: Displays a list of NC Program files that will be passed to Vericut.

NC Subroutines: Displays a list of NC Subroutines that will be passed to Vericut.

(Add): Use to add tool path files to the NC Program Files / NC Subroutines list.

(Remove): Use to remove the highlighted file(s) from the NC Program Files / NC Subroutines list.

Note: G-code data must be previously generated by Mastercam's post-processor.

G-Code Offsets¶

GCode Tables tab enables you to define Vericut GCode tables

Table Name: Select the desired table name from the Table List pull-down list.

The Table List pull-down list contains the following Vericut G-Code tables: Program Zero, Work Offsets, and Base Work Offset.

The Program Zero table is used to specify the programmed zero location of a G-Code NC program file taking Tool Length Compensation into consideration.

The Work Offsets table is used to store the work coordinate system offset (fixture offset) values.

The Base Work Offset table is used to specify the location from which work offsets are based.

Subsystem: Use to specify the machine subsystem ID for which the table is being defined. Select the subsystem ID from the pull-down list.

Register: Specify the table register number, example; for a G54 enter 54.

SubRegister: Specify the table sub-register number, example; for a G54 enter 54.

From Component: From the pull-down list select the name of the component that represents the "from" point for determining the program zero offset.

To Csys: From the pull-down list select the name of a CSYS to represent the "to" point for determining the program zero offset. When Program_Zero is selected, MCAMV will use the WCS specified in the Toolpath Group.

Calc Relative to: This feature enables you to have a relational offset recalculated in the machine position where the offset will be used. The new position is immediately calculated and stored and therefore is not dependent on the machine position when the offset is activated.

Use the (Add) icon to add a table. Make the appropriate selections and press the "Add".

Use the (Modify) icon to modify an existing table. Select the table in the current list, make the appropriate changes and press the "Modify".

Use the (Remove) icon to remove a table. Select it in the list and press the "Remove".

Note: The Interface pre-populates the GCode Offsets list based on the information in the Mastercam > Toolpaths > Planes. This feature is intended to gather the required GCode Offsets and present them in a list for the User to review and/or modifiy.

Note: If no table is specified the GCode tables in the VMC will be used:

Setup Template¶

Setup Template: Enter the /path/filename of the Setup "template" file that you want loaded in the text field.

Use the (Clear) icon to set the Setup Template text field equal to the Project Template text field. When the text field is blank, MCAMV will use the Project Template file specified above.

Use the (Browse) icon to display a file selection window and use it to specify the /path/filename. A setup "template" is a previously defined Vericut VcProject file is that containing files and settings required for Vericut simulation.

Use Views from the Setup Template: When toggled "on" (checked), Vericut will use the views stored in the Setup Template rather than the views created by MCAMV. If unchecked Vericut will launch with only 1 Workpiece view and will be orientated the same as the current view in Mastercam.

Options¶

The Options button opens the Options window.

Application¶

Specify options for general application output.

Interface Language: Allows you to change the current language of the interface. This change takes effect immediately.

CGTech Products: Allows you to change the directory used to launch Vericut from the interface.

Process: Controls the processing mode in which Vericut is run.

Interactive: Opens the Vericut window for access to all Vericut functions and capabilities. When the Vericut window opens, all of the required Vericut files are loaded and ready for processing. The stock is displayed in its unprocessed state and you need to press the "Play" icon in Vericut to start the process.

Batch: Runs Vericut unattended in the background. When the Vericut window opens, the toolpath verification process is complete and the part is displayed in its processed state.

Note: In either case, both application windows (Vericut and Mastercam) are available to work in at the same time.

Product Launch: Select to launch the desired application, Vericut or Optimizer

Translate All Coordinate Systems: When toggled "on" (checked), McamV transfers all Mastercam coordinate systems to Vericut.

List Toolpath Subgroups: When toggled "on" (checked), McamV lists every toolpath group in the Toolpaths tree structure as separate entry in the Toolpath Groups list. The default state (when not checked), is when only top-level toolpath groups are listed.

Notes Ignore Notes: When toggled "on" (checked), McamV will not read the interface data stored with the Mastercam part. This setting is supported by a ‘prefs’ file, and will take effect the next time McamV is launched. Notes Level — Allows you to select the Mastercam level where McamV data is stored (as Mastercam note entities). The default level is 3987, however it may be unsuitable for some reason. Generally the ‘Notes’ level is supposed to contain only the McamV data.

Default Output Directory Auto Create: When toggled "on" (checked) the Output Directory will be “part_directory\output”, it will be created or used if already exists. (Here “part_directory” is the current Mastercam part location). You can also select a different Output Directory (Browse) in the text box below.

Default Project Template This is the list of Vericut project files that is used to form a selection of project templates. You can add to the list using the (Browse) icon, or remove items using the (Remove) button.

Modeling¶

Specify options for model output.

Stock Deltas: Use to position the stock at the correct location on the Vericut machine. Enter the offset values in the X, Y and Z text fields. The values specified will be applied to the stock in addition to any selected Coordinate System.

Model Output Tolerance: Use to specify tolerance values for Stock, Part, and Fixture models.

Stock Level Name/Number: Specify the Mastercam level that will be used to export Stock component models.

Part Level Name/Number: Specify the Mastercam level that will be used to export Part component models.

Fixture Level Name/Number: Specify the Mastercam level that will be used to export Fixture component models.

Translate All Models as Visible: By default, if the Mastercam Level is set to Not Visible at the time of export, the Vericut models will be set to Translucent. This setting will overwrite this default and export all models without this Translucent setting set.

Use Vericut Component Colors: By default, the model colors exported by the Interface will be the same as in Mastercam. This setting will overwrite this default and export all models with the colors in the Project Template.

Tooling¶

Specify options for tool output.

Use Tool Name for Tool Id: Select if you want to export the Mastercam Tool Name as the Vericut tool ID. A tool list will not be generated if this option is selected.

Shank in Cutter: Select if you wish to have the interface export the Shank as part of the Cutter Component

Use Machine Side Connection: Select if you wish to use logic for 3d lathe tool orientation which uses the orientation set in Mastercam > Machine Side Connection

Length/Diameter Offsets Use Tool Diameter Offset for Cutter Compensation: Choose this option to have McamV create a Cutter Compensation entry for the tools being exported.

Use Tool Length Offset for Driven Point: Choose this option to have McamV create a Driven Point entry table for the tools being exported.

Notes:

• If any Mastercam Toolpath which is using the tool has the Compensation Type set to Control, then the Interface outputs Tool Manager > Cutter Compensation table for that tool with the value of tool radius (½ of tool diameter).

• If any Mastercam Toolpath which is using the tool has the Compensation Type set to Wear or Reverse Wear, then the Interface outputs Tool Manager > Cutter Compensation table for that tool with the value of 0

• If no Mastercam Toolpath which is using the tool has this Compensation Type set to Control or Wear or Reverse Wear entry for the tool, then the Interface does not output Tool Manager > Cutter Compensation table for that tool.

Generate buttons¶

Save Settings: Saves McamV data as note entities in the Mastercam manufactiring file, these entries are known as Custom Data.

Output Files: Outputs all files, for all operations, including the selected models, tool library files, updated project and setup files, and the "operations" file that assembles all of this information into a Vericut "project" file.

Run Vericut: Launches Vericut using the files created by Output Files.

Output and Run: Use Output and Run to output the files needed by Vericut and then launch Vericut in the same step.

Exit McamV: Closes the MCAMV window.

Note: To save McamV settings in the Mastercam part file you have to press the Save Settings button. However the ‘prefs’ file is modified on Exit.

Preferences¶

Preferences File¶

Also known as 'prefs' file, stores all user specified 'global' settings for interface operation. The settings stored are called 'global' because they are responsible for overall look & feel and operational behavior of the interface. They are not tied to any specific Mastercam project. By default, 'Preferences' file is generated at:
C:\Users\username\mcamv_version number_user.prefs.

Custom Data¶

The data in the dialog fields is saved in the Mastercam part file as blanked notes on a specified level so that when you save the part and later load it again, the values in the McamV dialog will be restored. By default, this level is 3987 but you can change it in the Options. You can also choose to ignore this saved data, which is an Options checkbox.