Sort Circles  Mastercam X4‐MU1/MU2/MU3 add‐on 

What does it do? 
It sorts all the “full” circles in the part file, first by size and then by view. 
Original levels layout Æ 

 
Page 1 of 1 
 
  Sort Circles  Mastercam X4‐MU1/MU2/MU3 add‐on 

After processing Æ 
All the full circles (original and/or “created”) in the file have been moved to individual levels based on 
their size and view.  See Configuration for processing options. 

Page 2 of 2 
 
  Sort Circles  Mastercam X4‐MU1/MU2/MU3 add‐on 

Configuration ‐ 

 
Page 3 of 3 
 
  Sort Circles  Mastercam X4‐MU1/MU2/MU3 add‐on 

Configuration details Æ 

• Arc attribute changes groupbox options: 
o Level 
ƒ Starting Level 
ƒ Delete Named Levels that are “empty” 
ƒ Level naming 
• Rename Levels 
• Trailing digits 
• String trailing zeros 
• Report Values in 
o Radius 
o Diameter 
ƒ LevelSet naming 
• Rename LevelSets 
• Allow arc “combine views” 
o Color 
ƒ Starting Color 
• Arc processing options 
o Combine arc segments into fill circles 
o Restrict to combining only 2 segments (see note!) 

• Show Circle Count message 

• Create Report 
o Report filename 
o Report type 

Page 4 of 4 
 
  Sort Circles  Mastercam X4‐MU1/MU2/MU3 add‐on 

Starting Level 
This setting specifies the initial level # to start placing the sorted arc on. 

Delete Named Levels that are “empty” 
It is possible that when “relocating” circles onto the new levels that all the entities could be moved from 
the original level. If the original level was a Named Level, it will not be auto‐deleted by Mastercam when 
you close the Level Manager.  (‘Empty’ levels without a “name” are automatically removed from the 
level list by Mastercam). 
When this option is enabled, all “empty” Named Level will be purged from the Level list. 
*Note:  To have access to this functionality you must have the additional add‐on 
DeleteEmptyNamedLevels.dll in the same folder as SortCircles.dll   If the DeleteEmptyNamedLevels.dll 
is not found this option will be disabled. 

Rename Levels 
This enables/disables Level “naming” of the levels that the sorted circles are placed on. 
The “name” will be the Radius/Diameter of the Circles that are placed on the level. 
There are several sub‐options that are self explanatory... 
• Trailing digits 
• String trailing zeros 
• Report Values in 
o Radius 
o Diameter 

LevelSet naming 
• Rename LevelSets 
This enables/disables LevelSet “naming” of the levels that the sorted circles are placed on. 
If enabled, the LevelSet names of the levels that sorted circles are place on will the set with the 
name of the Named View that corresponds to the View# the circles are in. 
• Allow arc “combine views” 
If enabled, it allows the add‐on to do a “combine view” operation on all circles being processed 
that are not in a “std” view.  This is similar to the Mastercam function Screen – Combine Views, 
the only difference being that the add on does not “combine views” all arc entities in the file, 
but just the (full) circles it is processing. 
See example 

Starting Color 
This setting specifies the initial color # to mark the sorted circles.  The color is incremented for each new 
circle size that is processed. 

Page 5 of 5 
 
  Sort Circles  Mastercam X4‐MU1/MU2/MU3 add‐on 

Combine arc segments into full circles 
When enabled, the add‐on will attempt to “join” arc segments into a circle.  If it can assemble a 
full circle from a set of arc segments it will replace the original arc segments will one (“full” 
circle) arc in the database. 
Restrict to combining only 2 segments 
When enabled, when attempting to “join” arc segments into a circle, this restricts the 
processing to only create a circle if it can be done with only 2 arc segments (A circle that had 
been broken “in two”).  
Note: At the time of this publication, the ‘Restrict to combining only 2 segments’ functionality is not 
available. 
 Show Circle Count message 
When the add‐on has completes all processing, it reports the number of circles.  This option allows the 
user to skip the display of that message. 

Create Report 
This option enables/disables the generation of a report file 
Report filename 
The path\name of the report file. 

Report type 
The “type” of the report; either in CSV (comma separated values) or in XML format. 
CSV example Æ 
Diameter, Count 
6.800000, 8 
8.000000, 23 
8.332785, 1 
8.336207, 1 
8.600000, 3 
10.000000, 20 
* At the time of this publication, the reporting features are admittedly rudimentary. 
  
Page 6 of 6 
 
  Sort Circles  Mastercam X4‐MU1/MU2/MU3 add‐on 

After processing (without the Allow Arc “Combine View” option enabled) Æ 

Note that some of the Level Set names are numbers. 
These arcs (circles) are not in a Named View, but in “system created” views. 
If you check the Allow Arc “Combine View” option, SortCircles will do a “Combine View” process on 
these circles, which may be able to re‐orient them into a std. Named View, which is parallel to the 
original “system generated” view. 
See the next page... 

Page 7 of 7 
 
  Sort Circles  Mastercam X4‐MU1/MU2/MU3 add‐on 

After processing (with the Allow Arc “Combine View” option enabled) Æ 

Page 8 of 8 
 
  Sort Circles  Mastercam X4‐MU1/MU2/MU3 add‐on 

Installation – (See the Revision Notes!) 
Simply install using the SortCircles.exe installer which extracts the required files to your Mastercam 
 X4‐MU1/MU2/MU3 installation. 
 
After you restart Mastercam, there will be two new icons in the Settings, Customize, Category: 
Mastercam C‐Hooks Æ 

 
The one on the left (without the ‘!’) is the SortCircles command  
and the one on the right (with the “!”) displays the SortCircles Configuration.  
*Note: If you wish, you only have to use the SortCircles command button, as you can access the 
configuration via a right‐click on the SortCircles icon. 
 
Revision History: 
25‐Feb‐2008  (Version: 11.0.0.1) 
Initial version (X2‐MR2) 
14‐Aug‐2009  (Version: 13.0.0.4) 
Updated for use with Mastercam X4. 
 
05‐Jan‐2010  (Version: 13.0.1.4) 
Now uses a separate Resources DLL to facilitate language translation. 
Updated installer so that it can be installed for either X4‐MU1 or MU2 or MU3. 
 
*Note!  
This Add‐On is “version specific”! 
The X4 version will not work properly with X4‐MU1/MU2/MU3 
and the X4‐MU1/MU2/MU3 version will not work properly with X4. 
 
 
CNC Software, Inc. 
671 Old Post Rd. 
Tolland, CT 06084 
www.mastercam.com 

[email protected]
 

Page 9 of 9