SortCircles MastercamX5addon

Whatdoesitdo?
Itsortsallthefullcirclesinthepartfile,firstbysizeandthenbyview.
Originallevelslayout

Page1of9

 SortCircles MastercamX5addon

Afterprocessing
Allthefullcircles(originaland/orcreated)inthefilehavebeenmovedtoindividuallevelsbasedon
theirsizeandview.SeeConfigurationforprocessingoptions.

Page2of9

 SortCircles MastercamX5addon

Configuration

Page3of9

 SortCircles MastercamX5addon

Configurationdetails

Arcattributechangesgroupboxoptions:
o Level
StartingLevel
DeleteNamedLevelsthatareempty
Levelnaming
RenameLevels
Trailingdigits
Stringtrailingzeros
ReportValuesin
o Radius
o Diameter
LevelSetnaming
RenameLevelSets
Allowarccombineviews
o Color
StartingColor
Arcprocessingoptions
o Combinearcsegmentsintofillcircles
o Restricttocombiningonly2segments(seenote!)

ShowCircleCountmessage

CreateReport
o Reportfilename
o Reporttype

Page4of9

 SortCircles MastercamX5addon

StartingLevel
Thissettingspecifiestheinitiallevel#tostartplacingthesortedarcon.

DeleteNamedLevelsthatareempty
Itispossiblethatwhenrelocatingcirclesontothenewlevelsthatalltheentitiescouldbemovedfrom
theoriginallevel.IftheoriginallevelwasaNamedLevel,itwillnotbeautodeletedbyMastercamwhen
youclosetheLevelManager.(Emptylevelswithoutanameareautomaticallyremovedfromthe
levellistbyMastercam).
Whenthisoptionisenabled,allemptyNamedLevelwillbepurgedfromtheLevellist.
*Note:Tohaveaccesstothisfunctionalityyoumusthavetheadditionaladdon
DeleteEmptyNamedLevels.dllinthesamefolderasSortCircles.dllIftheDeleteEmptyNamedLevels.dll
isnotfoundthisoptionwillbedisabled.

RenameLevels
Thisenables/disablesLevelnamingofthelevelsthatthesortedcirclesareplacedon.
ThenamewillbetheRadius/DiameteroftheCirclesthatareplacedonthelevel.
Thereareseveralsuboptionsthatareselfexplanatory...
Trailingdigits
Stringtrailingzeros
ReportValuesin
o Radius
o Diameter

LevelSetnaming
RenameLevelSets
Thisenables/disablesLevelSetnamingofthelevelsthatthesortedcirclesareplacedon.
Ifenabled,theLevelSetnamesofthelevelsthatsortedcirclesareplaceonwillthesetwiththe
nameoftheNamedViewthatcorrespondstotheView#thecirclesarein.
Allowarccombineviews
Ifenabled,itallowstheaddontodoacombineviewoperationonallcirclesbeingprocessed
thatarenotinastdview.ThisissimilartotheMastercamfunctionScreen Combine Views,
theonlydifferencebeingthattheaddondoesnotcombineviewsallarcentitiesinthefile,
butjustthe(full)circlesitisprocessing.
Seeexample

StartingColor
Thissettingspecifiestheinitialcolor#tomarkthesortedcircles.Thecolorisincrementedforeachnew
circlesizethatisprocessed.

Page5of9

 SortCircles MastercamX5addon

Combinearcsegmentsintofullcircles
Whenenabled,theaddonwillattempttojoinarcsegmentsintoacircle.Ifitcanassemblea
fullcirclefromasetofarcsegmentsitwillreplacetheoriginalarcsegmentswillone(full
circle)arcinthedatabase.
Restricttocombiningonly2segments
Whenenabled,whenattemptingtojoinarcsegmentsintoacircle,thisrestrictsthe
processingtoonlycreateacircleifitcanbedonewithonly2arcsegments(Acirclethathad
beenbrokenintwo).
Note:Atthetimeofthispublication,theRestricttocombiningonly2segmentsfunctionalityisnot
available.
ShowCircleCountmessage
Whentheaddonhascompletesallprocessing,itreportsthenumberofcircles.Thisoptionallowsthe
usertoskipthedisplayofthatmessage.

CreateReport
Thisoptionenables/disablesthegenerationofareportfile
Reportfilename
Thepath\nameofthereportfile.

Reporttype
Thetypeofthereport;eitherinCSV(commaseparatedvalues)orinXMLformat.
CSVexample
Diameter,Count
6.800000,8
8.000000,23
8.332785,1
8.336207,1
8.600000,3
10.000000,20
*Atthetimeofthispublication,thereportingfeaturesareadmittedlyrudimentary.

Page6of9

 SortCircles MastercamX5addon

Afterprocessing(withouttheAllowArcCombineViewoptionenabled)

NotethatsomeoftheLevelSetnamesarenumbers.
Thesearcs(circles)arenotinaNamedView,butinsystemcreatedviews.
IfyouchecktheAllowArcCombineViewoption,SortCircleswilldoaCombineViewprocesson
thesecircles,whichmaybeabletoreorientthemintoastd.NamedView,whichisparalleltothe
originalsystemgeneratedview.
Seethenextpage...

Page7of9

 SortCircles MastercamX5addon

Afterprocessing(withtheAllowArcCombineViewoptionenabled)

Page8of9

 SortCircles MastercamX5addon

Installation(SeetheRevisionNotes!)
SimplyinstallusingtheSortCircles.exeinstallerwhichextractstherequiredfilestoyourMastercam
X5installation.

AfteryourestartMastercam,therewillbetwonewiconsintheSettings,Customize,Category:
MastercamCHooks

Theoneontheleft(withoutthe!)istheSortCirclescommand
andtheoneontheright(withthe!)displaystheSortCirclesConfiguration.
*Note:Ifyouwish,youonlyhavetousetheSortCirclescommandbutton,asyoucanaccessthe
configurationviaarightclickontheSortCirclesicon.

RevisionHistory:
25Feb2008(Version:11.0.0.1)
Initialversion(X2MR2)
14Aug2009(Version:13.0.0.4)
UpdatedforusewithMastercamX4.

05Jan2010(Version:13.0.1.4)
NowusesaseparateResourcesDLLtofacilitatelanguagetranslation.
UpdatedinstallersothatitcanbeinstalledforeitherX4MU1orMU2orMU3.

12Nov2010(Version:14.1.1.4)
RebuiltforusewithMastercamX5.

CNCSoftware,Inc.
671OldPostRd.
Tolland,CT06084
www.mastercam.com

[email protected]

Page9of9