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

<root>
  <func>


    <title>cnc_wrmultitldt</title>



    <declare>
      <vc>
        <include>#include "fwlib32.h"</include>
        <prottype>
            FWLIBAPI short WINAPI cnc_wrmultitldt(unsigned short FlibHndl, short s_no, short *number, IODBMLTTL *mlttl);
        </prottype>
      </vc>
    </declare>



    <doc>
        <cmn>
            Writes the tool data for the multiple tool.
        </cmn>
    </doc>



    <argument>
        <common>
            <vc>
                <item>
                    <name>FlibHndl</name>
                    <type>in</type>
                    <content>
                        <p>
                            Specify the library handle.<br/>
                            See "<a href="handle.htm" target="_parent">Library handle</a>" for details.
                        </p>
                    </content>
                </item>
                <item>
                    <name>s_no</name>
                    <type>in</type>
                    <content>
                        <p>
                            Specify the start tool registration number.
                        </p>
                        <p class="dd">
                            1,..,(maximum tool registration number)
                        </p>
                    </content>
                </item>
                <item>
                    <name>number</name>
                    <type>in/out</type>
                    <content>
                        <p>
                            Pointer to the number of multiple tool data.<br/>
                            Specify the number of multiple tool data to be written before function call,
                             and the number of multiple tool data being written actually is stored after the function call.
                        </p>
                    </content>
                </item>
                <item>
                    <name>mlttl</name>
                    <type>in</type>
                    <content>
                        <p>
                            Pointer to the IODBMLTTL structure including the multiple tool data.<br/>
                            The IODBMLTTL structure is as follows.
                        </p>
<pre>
typedef struct iodbmlttl {
    short   slct;       /* Flag of data selection */
    short   m_tl_no;    /* Sub-tool number */
    long    m_tl_radius;/* Radius of multiple tool */
    long    m_tl_angle; /* Angle of multiple tool */
    long    x_axis_ofs; /* X-axis offset */
    long    y_axis_ofs; /* Y-axis offset */
    char    tl_shape;   /* Tool shape(C) */
    long    tl_size_i;  /* Tool size(I) */
    long    tl_size_j;  /* Tool size(J) */
    long    tl_angle;   /* Tool angle(K) */
    long    reserve[7]; /* (reserve) */
} IODBMLTTL ;
</pre>
                        <dl>
                            <dt>slct</dt>
                                <dd>Flag of data selection must be set.
                                <table class="dd">
                                    <tr><td>bit 0</td><td>:</td><td>Sub-tool number</td></tr>
                                    <tr><td>bit 1</td><td>:</td><td>Radius of multiple tool</td></tr>
                                    <tr><td>bit 2</td><td>:</td><td>Angle of multiple tool</td></tr>
                                    <tr><td>bit 3</td><td>:</td><td>X-axis offset</td></tr>
                                    <tr><td>bit 4</td><td>:</td><td>Y-axis offset</td></tr>
                                    <tr><td>bit 5</td><td>:</td><td>Tool shape(C)</td></tr>
                                    <tr><td>bit 6</td><td>:</td><td>Tool size(I)</td></tr>
                                    <tr><td>bit 7</td><td>:</td><td>Tool size(J)</td></tr>
                                    <tr><td>bit 8</td><td>:</td><td>Tool angle(K)</td></tr>
                                </table>
                                <table class="dd">
                                    <tr><td>bit 9,..,15</td><td>:</td><td>(reserve)</td></tr>
                                </table>
                                * In order to write the data to CNC, turn on the corresponding bit on this data.</dd>
                            <dt>m_tl_no</dt>
                                <dd>Specify Sub-tool number of multiple tool.(0,..)</dd>
                            <dt>m_tl_radius</dt>
                                <dd>Specify Radius of multiple tool.(valid with Tool data setting function)</dd>
                            <dt>m_tl_angle</dt>
                                <dd>Specify Angle of multiple tool.</dd>
                            <dt>x_axis_ofs</dt>
                                <dd>Specify X-axis offset.(valid with Tool data setting function)</dd>
                            <dt>y_axis_ofs</dt>
                                <dd>Specify Y-axis offset.</dd>
                            <dt>tl_shape</dt>
                                <dd>Specify Tool shape(C).(valid with Graphic function)</dd>
                            <dt>tl_size_i</dt>
                                <dd>Specify Tool size(I).(valid with Graphic function)</dd>
                            <dt>tl_size_j</dt>
                                <dd>Specify Tool size(J).(valid with Graphic function)</dd>
                            <dt>tl_angle</dt>
                                <dd>Specify Tool angle(K).(valid with Graphic function)</dd>
                            <dt>reserve</dt>
                                <dd>(reserve)</dd>
                        </dl>
                    </content>
                </item>
            </vc>
        </common>
    </argument>



    <errcode>
        <item>
            <name>EW_FUNC</name>
            <content>
                Unavailable<br/>
                This function cannot be used except 160i/180i-P.
            </content>
        </item>
        <item>
            <name>EW_LENGTH</name>
            <content>
                Data block length error<br/>
                Number of data(number) is wrong.
            </content>
        </item>
        <item>
            <name>EW_NUMBER</name>
            <content>
                Data number error<br/>
                Start number(s_no) is wrong.
            </content>
        </item>
        <item>
            <name>EW_DATA</name>
            <content>
                Data error<br/>
                The multiple tool data is wrong.<br/>
                In order to get more information for this err_no(nErr_no) return value, execute
                <a href="Misc/cnc_getdtailerr.htm" target="_parent">cnc_getdtailerr</a> function.<br/>
                The following detail status will be set onto the member, err_no of ODBERR structure
                (nErr_no of ODBERR user define type.).<br/>
                    <table>
                        <colgroup align="center" valign="top">
                        <colgroup align="center" valign="top">
                        <colgroup valign="top">
                        <tr><td>1</td><td>:</td><td>Error of Sub-tool number</td></tr>
                        <tr><td>2</td><td>:</td><td>Error of Radius of multiple tool</td></tr>
                        <tr><td>3</td><td>:</td><td>Error of Angle of multiple tool</td></tr>
                        <tr><td>4</td><td>:</td><td>Error of X-axis offset</td></tr>
                        <tr><td>5</td><td>:</td><td>Error of Y-axis offset</td></tr>
                        <tr><td>6</td><td>:</td><td>Error of Tool shape(C)</td></tr>
                        <tr><td>7</td><td>:</td><td>Error of Tool size(I)</td></tr>
                        <tr><td>8</td><td>:</td><td>Error of Tool size(J)</td></tr>
                        <tr><td>9</td><td>:</td><td>Error of Tool angle(K)</td></tr>
                        </colgroup>
                        </colgroup>
                        </colgroup>
                    </table>
                    And the tool registration number which an error occurred will be set onto the member,
                    err_dtno( nErr_dtno ) of ODBERR.
            </content>
        </item>
        <item>
            <name>EW_NOOPT</name>
            <content>
                No option<br/>
                The multiple tool function and the extended driver/library function are necessary.
            </content>
        </item>
    </errcode>



    <option>
        <hssb>The extended driver/library function is necessary.</hssb>
        <ethr><p>The Ethernet function and the extended driver/library function are necessary.</p>
              <p>When Embedded Ethernet is used,</p>
              <p><ul>above two optional functions are not required.</ul></p>
              <p>When Ethernet board is used,</p>
              <p><ul>only Ethernet function is required.</ul></p>
        </ethr>
        <type>
                <li>Tool data setting function</li>
                <li>Graphic function</li>
        </type>
    </option>



    <parameter>
        <type>
            <li>Series 160i/180i</li>
            <div class="dd">16282#1,#2,#3,#5,#6</div>
            <div class="dd">16283#1,#2</div>
            <div class="dd">16285, 16286</div>
        </type>
        <add></add>
    </parameter>



    <mode>
    </mode>



    <support>
        <m>
            <fs0ia>-</fs0ia>
            <fs0ib>-</fs0ib>
            <fs15>-</fs15>
            <fs15i>-</fs15i>
            <fs16>-</fs16>
            <fs18>-</fs18>
            <fs21>-</fs21>
            <fs16ia>-</fs16ia>
            <fs18ia>-</fs18ia>
            <fs21ia>-</fs21ia>
            <fs16ib>-</fs16ib>
            <fs18ib>-</fs18ib>
            <fs21ib>-</fs21ib>
            <fs30i>-</fs30i>
        </m>
        <t>
            <fs0ia>-</fs0ia>
            <fs0ib>-</fs0ib>
            <fs15>-</fs15>
            <fs15i>-</fs15i>
            <fs16>-</fs16>
            <fs18>-</fs18>
            <fs21>-</fs21>
            <fs16ia>-</fs16ia>
            <fs18ia>-</fs18ia>
            <fs21ia>-</fs21ia>
            <fs16ib>-</fs16ib>
            <fs18ib>-</fs18ib>
            <fs21ib>-</fs21ib>
            <fs30i>-</fs30i>
        </t>
        <lc>
            <fs0ia>-</fs0ia>
            <fs0ib>-</fs0ib>
            <fs15>-</fs15>
            <fs15i>-</fs15i>
            <fs16>-</fs16>
            <fs18>-</fs18>
            <fs21>-</fs21>
            <fs16ia>-</fs16ia>
            <fs18ia>-</fs18ia>
            <fs21ia>-</fs21ia>
            <fs16ib>-</fs16ib>
            <fs18ib>-</fs18ib>
            <fs21ib>-</fs21ib>
            <fs30i>-</fs30i>
        </lc>
        <p>
            <fs16i>O</fs16i>
            <fs18i>O</fs18i>
        </p>
        <l>
            <fs16i>-</fs16i>
            <fs18i>-</fs18i>
        </l>
        <w>
            <fs16i>-</fs16i>
            <fs18i>-</fs18i>
        </w>
        <pw>
            <d>-</d>
            <h>-</h>
        </pw>
    </support>



    <reference>
        <item>
            <name>cnc_rdtlctldata</name>
            <file>Punch/cnc_rdtlctldata.htm</file>
        </item>
        <item>
            <name>cnc_wrtlctldata</name>
            <file>Punch/cnc_wrtlctldata.htm</file>
        </item>
        <item>
            <name>cnc_rdtooldata</name>
            <file>Punch/cnc_rdtooldata.htm</file>
        </item>
        <item>
            <name>cnc_wrtooldata</name>
            <file>Punch/cnc_wrtooldata.htm</file>
        </item>
        <item>
            <name>cnc_rdmultitldt</name>
            <file>Punch/cnc_rdmultitldt.htm</file>
        </item>
        <item>
            <name>cnc_rdtoolinfo</name>
            <file>Punch/cnc_rdtoolinfo.htm</file>
        </item>
    </reference>



    <example>
    </example>



  </func>
</root>
