HiNC-2025-win-desktop-Deploy/App/wwwroot/HiAPI-docsite/manual/setup/cutter.html

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
      <title>Cutter | HiAPI-C# 2025 </title>
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <meta name="title" content="Cutter | HiAPI-C# 2025 ">
      
      
      <link rel="icon" href="../../img/HiAPI.favicon.ico">
      <link rel="stylesheet" href="../../public/docfx.min.css">
      <link rel="stylesheet" href="../../public/main.css">
      <meta name="docfx:navrel" content="../../toc.html">
      <meta name="docfx:tocrel" content="toc.html">
      
      <meta name="docfx:rel" content="../../">
      
      
      
      <meta name="loc:inThisArticle" content="In this article">
      <meta name="loc:searchResultsCount" content="{count} results for &quot;{query}&quot;">
      <meta name="loc:searchNoResults" content="No results for &quot;{query}&quot;">
      <meta name="loc:tocFilter" content="Filter by title">
      <meta name="loc:nextArticle" content="Next">
      <meta name="loc:prevArticle" content="Previous">
      <meta name="loc:themeLight" content="Light">
      <meta name="loc:themeDark" content="Dark">
      <meta name="loc:themeAuto" content="Auto">
      <meta name="loc:changeTheme" content="Change theme">
      <meta name="loc:copy" content="Copy">
      <meta name="loc:downloadPdf" content="Download PDF">

      <script type="module" src="./../../public/docfx.min.js"></script>

      <script>
        const theme = localStorage.getItem('theme') || 'auto'
        document.documentElement.setAttribute('data-bs-theme', theme === 'auto' ? (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light') : theme)
      </script>

  </head>

  <body class="tex2jax_ignore" data-layout="" data-yaml-mime="">
    <header class="bg-body border-bottom">
      <nav id="autocollapse" class="navbar navbar-expand-md" role="navigation">
        <div class="container-xxl flex-nowrap">
          <a class="navbar-brand" href="../../index.html">
            <img id="logo" class="svg" src="../../img/HiAPI.logo.png" alt="">
            
          </a>
          <button class="btn btn-lg d-md-none border-0" type="button" data-bs-toggle="collapse" data-bs-target="#navpanel" aria-controls="navpanel" aria-expanded="false" aria-label="Toggle navigation">
            <i class="bi bi-three-dots"></i>
          </button>
          <div class="collapse navbar-collapse" id="navpanel">
            <div id="navbar">
              <form class="search" role="search" id="search">
                <i class="bi bi-search"></i>
                <input class="form-control" id="search-query" type="search" disabled placeholder="Search" autocomplete="off" aria-label="Search">
              </form>
            </div>
          </div>
        </div>
      </nav>
    </header>

    <main class="container-xxl">
      <div class="toc-offcanvas">
        <div class="offcanvas-md offcanvas-start" tabindex="-1" id="tocOffcanvas" aria-labelledby="tocOffcanvasLabel">
          <div class="offcanvas-header">
            <h5 class="offcanvas-title" id="tocOffcanvasLabel">Table of Contents</h5>
            <button type="button" class="btn-close" data-bs-dismiss="offcanvas" data-bs-target="#tocOffcanvas" aria-label="Close"></button>
          </div>
          <div class="offcanvas-body">
            <nav class="toc" id="toc"></nav>
          </div>
        </div>
      </div>

      <div class="content">
        <div class="actionbar">
          <button class="btn btn-lg border-0 d-md-none" type="button" data-bs-toggle="offcanvas" data-bs-target="#tocOffcanvas" aria-controls="tocOffcanvas" aria-expanded="false" aria-label="Show table of contents">
            <i class="bi bi-list"></i>
          </button>

          <nav id="breadcrumb"></nav>
        </div>

        <article data-uid="">
          <h1 id="cutter">Cutter</h1>

<p>A tool is one entry in the project's tool house, identified by its T-number, and it is the whole
assembly the spindle turns: a cutter, the holder it sits in, how far it stands out, and the sensor
settings a smart holder needs. All of it is edited on the Tool House page, one tool at a time and one
aspect per tab.</p>
<p>What each quantity means, and how to choose between the two ways of expressing a cutting envelope,
is <a class="xref" href="../../technique/milling-physics/cutter-geometry.html">Cutter Geometry</a>. This page is where they are entered.</p>
<h2 id="where-it-is">Where it is</h2>
<p>The Tool House page, at <code>/tool-house</code>, reached from the menu bar's <strong>Page</strong> dropdown. Three columns:
the tool house and its tool list on the left, the selected tool's tabs in the middle, and a canvas
drawing that tool on the right. Selecting a different tool keeps the tab you were on, so a walk down
the list stays on the same aspect of each tool.</p>
<p>Tool 1 of a fifteen-tool demo house with the <strong>Cutter</strong> tab open, at <code>/tool-house/1/cutter/profile</code>.
The tool list carries one row per tool — its number badge and its note, or the derived abstract note
where no note has been typed. The tab strip above the editor is the tool's five tabs; below the
cutter's own identity fields is a second strip of section tabs, and <strong>Flute Profile</strong> is the one
selected, showing a <strong>Column APT</strong> profile with its diameter, length of cut and round radius.</p>
<p><img src="cutter-img/flute-profile.en.png" alt="The Tool House page: a left column listing fifteen tools with New Tool above them, a middle column showing the General, Cutter, Holder, Clamping and Int. Holder tabs with Cutter selected, a Cutter Type of Milling Cutter over Shank Mass, Hone Radius and Relief Angle, a section tab strip reading Material, Flute Profile, Flute Contours, Upper Beam and Optimization with Flute Profile selected and a Column APT profile below it, and the cutter drawn on the canvas at the right"></p>
<h2 id="the-tool-house-is-a-file-of-its-own">The tool house is a file of its own</h2>
<p>The list on the left is the project's tool house, and the <strong>Object Management</strong> (<code>⋮</code>) button beside
<strong>New Tool</strong> manages <strong>the whole house rather than one tool</strong> — its file extension is
<code>.MachiningToolHouse</code>. That is how a set of tools is reused: <strong>Save As</strong> writes the house out, and
<strong>Load</strong> on another project installs it in place of whatever that project had. A shop that runs the
same twenty tools across every job describes them once.</p>
<p><strong>New Tool</strong> stays disabled until the project has a tool house at all; a project without one shows an
empty-state block naming that button and the <code>.MachiningToolHouse</code> extension instead of the tool
count.</p>
<h2 id="creating-duplicating-and-deleting-a-tool">Creating, duplicating and deleting a tool</h2>
<p>There is no dialog to fill in first — a new tool arrives with default values and is then set up in
the tabs.</p>
<ol>
<li>Press <strong>New Tool</strong>. The tool takes the next number: one past the largest already in the house, or
1 in an empty one.</li>
<li>Open the <strong>General</strong> tab to give it its identity. <strong>Tool ID</strong> is the T-number, and committing a
change there renames the tool. <strong>Note</strong> is yours to write; the read-only <strong>Abstract Note</strong> beneath
it is derived from the cutter you give the tool in the next step, and carries a one-click copy
button.</li>
<li><strong>Duplicate</strong> and <strong>Delete</strong> are icon buttons on the same tab. A duplicate is inserted at the
first free number past both the tool it was copied from and the largest in the house, so it never
lands on top of an existing tool.</li>
</ol>
<p><strong>A tool number cannot be repeated.</strong> Renaming a tool onto a number the house already holds is
refused as a conflict rather than overwriting anything, so the way to swap two numbers is to move one
of them out of the way first.</p>
<p>Tool 1's <strong>General</strong> tab, at <code>/tool-house/1</code>. The <strong>Abstract Note</strong> below the editable note is
derived from the cutter the tool carries rather than typed, which is why a tool with no note of its
own still reads as something recognisable in the list on the left.</p>
<p><img src="cutter-img/tool-house-general.en.png" alt="The General tab of the Tool House page with tool 1 selected out of fifteen, showing the Tool ID and Note fields above a read-only Abstract Note describing the cutter, and the cutter drawn on the canvas at the right"></p>
<h2 id="giving-it-a-cutter">Giving it a cutter</h2>
<p>The <strong>Cutter</strong> tab chooses what kind of cutter the tool carries — <strong>Milling Cutter</strong>, <strong>Freeform
Remover</strong>, or none — and holds the fields every cutter has: <strong>Shank Mass</strong>, <strong>Hone Radius</strong> and
<strong>Relief Angle</strong>. Assigning a milling cutter grows a second strip of section tabs beneath them, and
that is where the description proper is entered:</p>
<table>
<thead>
<tr>
<th>Section tab</th>
<th>What it holds</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Material</strong></td>
<td>The flute, shank and coating materials. It is there only while the <strong>Show Physics Options</strong> preference is on, and when it is there it is the <strong>first</strong> tab in the strip — so on a device with that preference off the strip has four tabs and opens on Flute Profile instead. See <a href="../basics/preferences.html">Preferences</a>, which also covers why flipping that preference does not change a strip already on screen.</td>
</tr>
<tr>
<td><strong>Flute Profile</strong></td>
<td>The cutting-edge envelope, as one of the five APT types: General, Ball, Column, Cone and Taper.</td>
</tr>
<tr>
<td><strong>Flute Contours</strong></td>
<td>The fluting: how many flutes, and each flute's side and bottom contour.</td>
</tr>
<tr>
<td><strong>Upper Beam</strong></td>
<td>The shank above the flute.</td>
</tr>
<tr>
<td><strong>Optimization</strong></td>
<td>The per-cutter limits the optimizer respects.</td>
</tr>
</tbody>
</table>
<h2 id="holding-it-and-how-far-it-stands-out">Holding it, and how far it stands out</h2>
<p>Three more tabs carry the rest of the tool.</p>
<p><strong>Holder</strong> picks the holder kind — none, a <strong>Cylindroid</strong> holder, or a freeform one — and, for a
cylindroid holder, grows <strong>Geometry</strong> and <strong>Resolution</strong> sub-tabs: the holder's Z-against-radius
profile, and how finely it is meshed.</p>
<p><strong>Clamping</strong> is two numbers that are really one. <strong>Exposed Cutter Height</strong> is how far the cutter
stands out; <strong>Preserved Distance</strong> is the gap between the top of the flute and the spindle nose. They
differ by the flute height, so editing either one moves the other, and the panel says so.</p>
<p>Tool 1's <strong>Clamping</strong> tab, at <code>/tool-house/1/clamping</code>. The two fields read 28 mm and 8 mm, and the
line beneath them states the relation the server keeps between them.</p>
<p><img src="cutter-img/clamping.en.png" alt="The Clamping tab of the Tool House page showing an Exposed Cutter Height of 28 mm above a Preserved Distance field labelled flute top to spindle nose reading 8 mm, with a caption stating that ExposedCutterHeight equals PreservedDistance plus FluteHeight and that changing either field updates the other on the server"></p>
<p><strong>Int. Holder</strong> is the smart holder's <strong>Observation Location</strong>: which anchor the sensor reading is
referenced to — none, the tool tip, the holder anchor or the spindle buckle — then the height above
that anchor and the radius of the observation ring. What those settings mean is
<a class="xref" href="../../technique/measurement/smart-tool-holder.html">Smart Tool Holder</a>.</p>
<h2 id="two-kinds-this-screen-cannot-draw-the-numbers-for">Two kinds this screen cannot draw the numbers for</h2>
<p>The <strong>Freeform Remover</strong> cutter and the freeform holder geometry can be selected here, but this page
carries no editor for either. Picking one leaves whatever the tool already holds untouched — nothing
is cleared — and shows a note naming where that shape can be edited instead. The same is true of the
custom spinning profile: the Flute Profile tab offers the five APT types and nothing else.</p>
<h2 id="see-also">See Also</h2>
<ul>
<li><a class="xref" href="../../technique/milling-physics/cutter-geometry.html">Cutter Geometry</a> — what every quantity on these tabs means, and when to prefer an extended cylinder over an explicit shank profile</li>
<li><a class="xref" href="../../technique/measurement/smart-tool-holder.html">Smart Tool Holder</a> — the sensor settings behind the Int. Holder tab</li>
<li><a class="xref" href="../../workflows/project-data-checklist.html">Project Data Checklist</a> — what to collect about a tool before creating it</li>
<li><a href="../../technique/milling-physics/index.html">Milling Physics</a> — the models every quantity entered here feeds</li>
<li><a href="index.html">Setup</a> — the rest of the pre-simulation configuration</li>
</ul>

</article>

        <div class="contribution d-print-none">
        </div>

        <div class="next-article d-print-none border-top" id="nextArticle"></div>

      </div>

      <div class="affix">
        <nav id="affix"></nav>
      </div>
    </main>

    <div class="container-xxl search-results" id="search-results"></div>

    <footer class="border-top text-secondary">
      <div class="container-xxl">
        <div class="flex-fill">
          <span> Copyright © 2025 <a href='https://superhightech.com.tw'>Tech Coordinate</a>. All rights reserved. <a href='https://superhightech.com.tw'>超級高科技股份有限公司</a> © 2025 版權所有 </span>
        </div>
      </div>
    </footer>
  </body>
</html>