<?xml version="1.0" encoding="Shift_JIS"?>
<?xml-stylesheet type="text/xsl" href="../Fmethod_xsl/fmethod_he_c.xsl"?>

<root>
  <func>


    <!-- 関数名 -->
    <title>cnc_rdbtofsr</title>



    <!-- 関数宣言 -->
    <declare>
      <!-- Visual C++の宣言 -->
      <vc>
        <include>#include "fwlib32.h"</include>
        <prottype>FWLIBAPI short WINAPI cnc_rdbtofsr(unsigned short FlibHndl, short s_number, short type, short e_number, short length, IODBBTO *btofsr);</prottype>
      </vc>
    </declare>



    <!-- 解説 -->
    <doc>
        <cmn>
            <p>s_number, e_number, typeで指定された範囲のB軸工具オフセット量を読み出します。オフセット量は符号付のバイナリ形式でIODBBTO内に格納されます。</p>

            <p>オフセット量の単位は<a href="ncdata/cnc_rdtofs.htm" target="_parent">cnc_rdtofs</a>と同じです。同関数の解説を参照して下さい。</p>
        </cmn>
    </doc>



    <!-- 引数 -->
    <argument>
        <common>
            <vc>
                <item>
                    <name>FlibHndl</name>
                    <type>in</type>
                    <content>
                        <p>
                            ライブラリハンドルです。詳細は、「<a href="handle.htm" target="_parent">ライブラリハンドル</a>」を参照して下さい。
                        </p>
                    </content>
                </item>
                <item>
                    <name>s_number</name>
                    <type>in</type>
                    <content>
                        <p>リードを開始するオフセット番号を指定します。1〜9が指定できます。</p>
                        <p>なお、NC指令や表示で使用されるB軸の工具オフセット番号は、ここで指定する番号に <a href="ncdata/cnc_rdbtofsinfo.htm" target="_parent">cnc_rdbtofsinfo</a>関数で取得できる補助機能番号+1を加えたものになります。</p>
                    </content>
                </item>
                <item>
                    <name>e_number</name>
                    <type>in</type>
                    <content>
                        <p>リードを終了するオフセット番号を指定します。1〜9が指定できます。</p>
                    </content>
                </item>
                <item>
                    <name>type</name>
                    <type>in</type>
                    <content>
                        <p>リードするオフセットのタイプを指定します( 以下の length の説明を参照)。</p>
                    </content>
                </item>
                <item>
                    <name>length</name>
                    <type>in</type>
                    <content>
                        <p>データブロック長を指定します。</p>

                        <p>typeに指定する値、及びデータブロック長(length)の指定、読み出される補正量の種類と格納される場所は以下の通りです。</p>

                        <ul>
                            <li>工具補正量メモリA</li>
                            <table border="1" valign="top">
                                <colgroup width="10%">
                                <colgroup width="15%">
                                <colgroup width="10%">
                                <colgroup width="30%">
                                <colgroup width="35%">
                                <tr>
                                    <th>type</th>
                                    <th>length</th>
                                    <th>属性</th>
                                    <th>補正量の種類</th>
                                    <th>格納される場所</th>
                                </tr>
                                <tr>
                                    <td>0</td>
                                    <td>8+4*N</td>
                                    <td>個別</td>
                                    <td>工具補正量</td>
                                    <td>btofsr.ofs[i]</td>
                                </tr>
                                <tr>
                                    <td>-1</td>
                                    <td>8+4*N</td>
                                    <td>全体</td>
                                    <td>工具補正量</td>
                                    <td>btofsr.ofs[i]</td>
                                </tr>
                                </colgroup>
                                </colgroup>
                                </colgroup>
                                </colgroup>
                                </colgroup>
                            </table>
                            <br/>
                            <li>工具補正量メモリB</li>
                            <table border="1" valign="top">
                                <colgroup width="10%">
                                <colgroup width="15%">
                                <colgroup width="10%">
                                <colgroup width="30%">
                                <colgroup width="35%">
                                <tr>
                                    <th>type</th>
                                    <th>length</th>
                                    <th>属性</th>
                                    <th>補正量の種類</th>
                                    <th>格納される場所</th>
                                </tr>
                                <tr>
                                    <td>0</td>
                                    <td>8+4*N</td>
                                    <td>個別</td>
                                    <td>工具形状補正量</td>
                                    <td>btofsr.ofs[i]</td>
                                </tr>
                                <tr>
                                    <td>1</td>
                                    <td>8+4*N</td>
                                    <td>個別</td>
                                    <td>工具摩耗補正量</td>
                                    <td>btofsr.ofs[i]</td>
                                </tr>
                                <tr>
                                    <td rowspan="2">-2</td>
                                    <td rowspan="2">8+8*N</td>
                                    <td rowspan="2">全体</td>
                                    <td>工具形状補正量</td>
                                    <td>btofsr.ofs[8*i+0]</td>
                                </tr>
                                <tr>
                                    <td>工具摩耗補正量</td>
                                    <td>btofsr.ofs[8*i+4]</td>
                                </tr>
                                </colgroup>
                                </colgroup>
                                </colgroup>
                                </colgroup>
                                </colgroup>
                            </table>
                            <br/>
                            Nは読み出すオフセットの個数、i=0〜(N-1) です。
                        </ul>

                    </content>
                </item>
                <item>
                    <name>btofsr</name>
                    <type>out</type>
                    <content>
                        <p>工具オフセット量を返すIODBBTO構造体へのポインタです。IODBBTO構造体は次の通りです。</p>

<pre>
typedef struct iodbbto {
    short datano_s;             /* 開始オフセット番号 */
    short type;                 /* オフセットのタイプ */
    short datano_e;             /* 終了オフセット番号 */
    long  ofs[M];               /* オフセット量 */
} IODBBTO ; /* M : 読み出すオフセット量の個数(個別,メモリA全体)
                   読み出すオフセット量の個数×2(メモリB全体)*/
</pre>
                    </content>
                </item>
            </vc>
        </common>
    </argument>



    <!-- 戻り値 -->
    <errcode>
        <item>
            <name>EW_FUNC</name>
            <content>使用不可<br/>M系では使用できません。</content>
        </item>
        <item>
            <name>EW_LENGTH</name>
            <content>データブロック長の誤り<br/>IODBBTO構造体のサイズ(length)が不正です。</content>
        </item>
        <item>
            <name>EW_NUMBER</name>
            <content>データ番号の誤り<br/>オフセット番号( s_number, e_number )の指定が不適切です。</content>
        </item>
        <item>
            <name>EW_ATTRIB</name>
            <content>データ属性の誤り<br/>オフセットのタイプ(type)の指定が不適切です。</content>
        </item>
        <item>
            <name>EW_NOOPT</name>
            <content>オプションなし<br/>B軸制御機能、及び拡張ドライバ/ライブラリ機能が必要です。</content>
        </item>
    </errcode>



    <!-- CNCオプション -->
    <option>
        <hssb>拡張ドライバ/ライブラリ機能が必要です。</hssb>
        <ethr><p>イーサネット機能と拡張ドライバ/ライブラリ機能が必要です。</p>
              <p>但し、Series 160i/180i/210i/0i MODEL Bに関しては次のようになります。</p>
              <p>組込みイーサネットを使用のとき、</p>
              <p><ul>上記２つの機能は必要ありません。</ul></p>
              <p>イーサネットボードを使用のとき、</p>
              <p><ul>イーサネット機能のみ必要です。</ul></p>
        </ethr>

        <need>
            <p>B軸制御機能が必要です。</p>
        </need>

        <type>
            <li>Series 160/180, 160i/180i/210i</li><br/>
            工具形状補正と摩耗補正
        </type>
    </option>



    <!-- CNCパラメータ -->
    <parameter>

        <type>
            <ul>
                <li>Series 160/180, 160i/180i/210i</li><br/>
                1004#1
            </ul>
        </type>
    </parameter>



    <!-- CNCモード -->
    <mode>
    </mode>



    <!-- 対応機種 -->
    <support>
        <!-- M（ミリング） -->
        <m>
            <fs0ia>X</fs0ia>
            <fs0ib>X</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>X</fs16>
            <fs18>X</fs18>
            <fs21>X</fs21>
            <fs16ia>X</fs16ia>
            <fs18ia>X</fs18ia>
            <fs21ia>X</fs21ia>
            <fs16ib>X</fs16ib>
            <fs18ib>X</fs18ib>
            <fs21ib>X</fs21ib>
            <fs30i>X</fs30i>
        </m>
        <!-- T（旋盤） -->
        <t>
            <fs0ia>X</fs0ia>
            <fs0ib>X</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>H</fs16>
            <fs18>H</fs18>
            <fs21>H</fs21>
            <fs16ia>O</fs16ia>
            <fs18ia>O</fs18ia>
            <fs21ia>O</fs21ia>
            <fs16ib>O</fs16ib>
            <fs18ib>O</fs18ib>
            <fs21ib>O</fs21ib>
            <fs30i>X</fs30i>
        </t>
        <!-- LC（ローダ制御） -->
        <lc>
            <fs0ia>X</fs0ia>
            <fs0ib>X</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>X</fs16>
            <fs18>X</fs18>
            <fs21>X</fs21>
            <fs16ia>X</fs16ia>
            <fs18ia>X</fs18ia>
            <fs21ia>X</fs21ia>
            <fs16ib>X</fs16ib>
            <fs18ib>X</fs18ib>
            <fs21ib>X</fs21ib>
            <fs30i>X</fs30i>
        </lc>
        <!-- P（パンチプレス） -->
        <p>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </p>
        <!-- L（レーザ） -->
        <l>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </l>
        <!-- W（ワイヤカット） -->
        <w>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </w>
        <!-- PM（パワーメート） -->
        <pw>
            <d>X</d>
            <h>X</h>
        </pw>
    </support>



    <!-- 参照 -->
    <reference>
        <item>
            <name>cnc_wrbtofsr</name>
            <file>ncdata/cnc_wrbtofsr.htm</file>
        </item>
        <item>
            <name>cnc_rdbtofsinfo</name>
            <file>ncdata/cnc_rdbtofsinfo.htm</file>
        </item>
    </reference>



    <!-- プログラム例 -->
    <example>
    </example>



  </func>
</root>
