2025-12-05 16:33:37 +08:00

198 lines
9.3 KiB
HTML

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>刀具與智慧刀把設置 | HiAPI-C# 2025 </title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="title" content="刀具與智慧刀把設置 | 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="Cmd-ToolSetup">
<h1 id="刀具與智慧刀把設置">刀具與智慧刀把設置</h1>
<p><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html">RuntimeApi</a><small>(API)</small> 提供了多個方法來設定和查詢刀具安裝參數及智慧刀把觀察位置。</p>
<h2 id="刀具輪廓偏移角度">刀具輪廓偏移角度</h2>
<h3 id="getuniformcontourtrayshiftangle_deg">GetUniformContourTrayShiftAngle_deg</h3>
<p><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_GetUniformContourTrayShiftAngle_deg_">GetUniformContourTrayShiftAngle_deg</a><small>(API)</small> 取得指定刀具的輪廓偏移角度(度)。此角度用於調整刀具安裝時的初始角度位置。</p>
<div class="NOTE">
<h5>Note</h5>
<p><strong>指令格式</strong></p>
<pre><code class="lang-csharp">var angle = GetUniformContourTrayShiftAngle_deg(&lt;刀具ID&gt;);
</code></pre>
</div>
<div class="TIP">
<h5>Tip</h5>
<p><strong>指令範例</strong></p>
<pre><code class="lang-csharp">// 查詢刀具1的輪廓偏移角度
var angle = GetUniformContourTrayShiftAngle_deg(1);
Message($&quot;刀具1的輪廓偏移角度: {angle} 度&quot;);
</code></pre>
</div>
<h3 id="setuniformcontourtrayshiftangle_deg">SetUniformContourTrayShiftAngle_deg</h3>
<p><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_SetUniformContourTrayShiftAngle_deg_">SetUniformContourTrayShiftAngle_deg</a><small>(API)</small> 設定指定刀具的輪廓偏移角度(度)。當刀具安裝角度與預設值不同時,可使用此方法調整。</p>
<div class="NOTE">
<h5>Note</h5>
<p><strong>指令格式</strong></p>
<pre><code class="lang-csharp">SetUniformContourTrayShiftAngle_deg(&lt;刀具ID&gt;, &lt;角度&gt;);
</code></pre>
</div>
<div class="TIP">
<h5>Tip</h5>
<p><strong>指令範例</strong></p>
<pre><code class="lang-csharp">// 設定刀具1的輪廓偏移角度為10度
SetUniformContourTrayShiftAngle_deg(1, 10.0);
PlayNcFile(&quot;NC/file1.nc&quot;);
</code></pre>
</div>
<h2 id="智慧刀把觀察高度">智慧刀把觀察高度</h2>
<h3 id="getstickmachiningtoolobservationheight_mm">GetStickMachiningToolObservationHeight_mm</h3>
<p><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_GetStickMachiningToolObservationHeight_mm_">GetStickMachiningToolObservationHeight_mm</a><small>(API)</small> 取得指定智慧刀把的觀察高度(毫米)。觀察高度是指智慧刀把感測器相對於安裝錨點的高度位置。</p>
<div class="NOTE">
<h5>Note</h5>
<p><strong>指令格式</strong></p>
<pre><code class="lang-csharp">var height = GetStickMachiningToolObservationHeight_mm(&lt;刀具ID&gt;);
</code></pre>
</div>
<div class="TIP">
<h5>Tip</h5>
<p><strong>指令範例</strong></p>
<pre><code class="lang-csharp">// 查詢智慧刀把1的觀察高度
var height = GetStickMachiningToolObservationHeight_mm(1);
Message($&quot;智慧刀把1的觀察高度: {height} 毫米&quot;);
</code></pre>
</div>
<h3 id="setstickmachiningtoolobservationheight_mm">SetStickMachiningToolObservationHeight_mm</h3>
<p><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_SetStickMachiningToolObservationHeight_mm_">SetStickMachiningToolObservationHeight_mm</a><small>(API)</small> 設定指定智慧刀把的觀察高度(毫米)。當智慧刀把安裝位置與預設值不同時,可使用此方法調整觀察高度。</p>
<div class="NOTE">
<h5>Note</h5>
<p><strong>指令格式</strong></p>
<pre><code class="lang-csharp">SetStickMachiningToolObservationHeight_mm(&lt;刀具ID&gt;, &lt;高度&gt;);
</code></pre>
</div>
<div class="TIP">
<h5>Tip</h5>
<p><strong>指令範例</strong></p>
<pre><code class="lang-csharp">// 設定智慧刀把1的觀察高度為50毫米
SetStickMachiningToolObservationHeight_mm(1, 50.0);
PlayNcFile(&quot;NC/file1.nc&quot;);
</code></pre>
</div>
<h2 id="使用說明">使用說明</h2>
<p>這些設置功能用於:</p>
<ul>
<li><strong>刀具安裝角度調整</strong>:當刀具實際安裝角度與刀具檔案中的預設角度不同時,可透過設定輪廓偏移角度來校正</li>
<li><strong>智慧刀把安裝位置調整</strong>:當智慧刀把的感測器安裝高度與預設值不同時,可透過設定觀察高度來校正</li>
<li><strong>動態配置</strong>:在腳本執行過程中根據實際安裝情況動態調整參數</li>
</ul>
<div class="NOTE">
<h5>Note</h5>
<p>這些參數通常應在刀具設定檔案中配置。只有在需要根據實際安裝情況動態調整時,才使用這些腳本指令。</p>
</div>
<div class="WARNING">
<h5>Warning</h5>
<p>如果指定的刀具不存在或不是支援的類型(如非銑刀或非智慧刀把),這些方法會拋出異常。</p>
</div>
</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>