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

<root>
  <func>


    <title>cnc_rdactfixofs</title>



    <declare>
      <vc>
        <include>#include "fwlib32.h"</include>
        <prottype>FWLIBAPI short WINAPI cnc_rdactfixofs(unsigned short FlibHndl, short axis, IODBZOFS *fixofs);</prottype>
      </vc>
    </declare>



    <doc>
        <cmn>
            <p>Reads the active fixture offset number and the active fixture offset value specified by "axis". The offset number is stored in "type" of "IODBZOFS" with binary format, and the offset value is stored in "data" array of "IODBZOFS" with signed binary format.</p>

            <p>The value for all axes can be read at a time by specifying 'ALL_AXES' in 'axis'.</p>

            <p>The place of decimal point can be got by <a href="misc/cnc_getfigure.htm" target="_parent">cnc_getfigure</a> function.</p>

            <p>The unit of active fixture offset value is the same as <a href="ncdata/cnc_rdzofs.htm" target="_parent">cnc_rdzofs</a> function. See the description of <a href="ncdata/cnc_rdzofs.htm" target="_parent">cnc_rdzofs</a> function.</p>

        </cmn>
    </doc>



    <argument>
        <common>
            <vc>
                <item>
                    <name>FlibHndl</name>
                    <type>in</type>
                    <content>
                        <p>
                            Specify the library handle. See "<a href="handle.htm" target="_parent">Library handle</a>" for details.
                        </p>
                    </content>
                </item>
                <item>
                    <name>axis</name>
                    <type>in</type>
                    <content>
                        <p>Specify the axis number.</p>
                        <ul>
                            <table>
                                <colgroup align="left" valign="top">
                                <colgroup align="left" valign="top">
                                <tr>
                                    <td>ALL_AXES</td>
                                    <td>:</td>
                                    <td>assigns all axes(ALL_AXES=-1)</td>
                                </tr>
                                <tr>
                                    <td>1,..,m</td>
                                    <td>:</td>
                                    <td>assigns 1 axis (m=current controlled axes)</td>
                                </tr>
                                </colgroup>
                                </colgroup>
                            </table>
                        </ul>
                    </content>
                </item>
                <item>
                    <name>fixofs</name>
                    <type>out</type>
                    <content>
                        <p>Pointer to the IODBZOFS structure for the active fixture offset value. The IODBZOFS structure is as follows.</p>

<pre>
typedef struct  iodbzofs {
        short   datano;         /* active offset number */
        short   type;           /* axis number          */
        long    data[MAX_AXIS]; /* offset data value    */
} IODBZOFS ;         /* MAX_AXIS : max. controlled axes */
</pre>

                        <p><b>IODBZOFS</b></p>
                        <table>
                            <colgroup align="left" valign="top">
                            <colgroup align="left" valign="top">
                            <colgroup align="left" valign="top">
                            <tr>
                                <th>1 axis</th>
                                <th>all axes</th>
                            </tr>
                            <tr>
                                <td valign="top"><img src="ncdata/axis.gif" /></td>
                                <td valign="top"><img src="ncdata/axisa.gif" /></td>
                            </tr>
                            </colgroup>
                            </colgroup>
                            </colgroup>
                        </table>
                        
                        <p>n = Maximum controlled axes (* The data for current controlled axes are valid.)</p>

                    </content>
                </item>
            </vc>
        </common>
    </argument>



    <errcode>
        <item>
            <name>EW_FUNC</name>
            <content>Unavailable<br/>This function cannot be used at T Series.</content>
        </item>
        <item>
            <name>EW_ATTRIB</name>
            <content>Data attribute error<br/>Axis number(axis) is wrong.</content>
        </item>
        <item>
            <name>EW_NOOPT</name>
            <content>No option<br/>The rotary table dynamic fixture offset option and the extended driver/library function are necessary.<br/>
                     The custom macro B option is necessary(only 160i/180i/210i).
            </content>
        </item>
        <add></add>
    </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>
        </ethr>

        <need>
            The rotary table dynamic fixture offset option.<br/>
            <li>Series 160i/180i/210i</li>
                <div class="dd">Custom macro B</div><br/>
        </need>
        <add></add>
    </option>



    <parameter>
        <type>
            <ul>
                <li>Series 150</li>
                <div class="dd">1004#0,#1,#5, 1009#1 </div><br/>
            </ul>
            <ul>
                <li>Series 150i</li>
                <div class="dd">1012#0,#1,#2,#3 </div><br/> 
            </ul>
        </type>

        <add></add>
    </parameter>



    <mode>
    </mode>



    <support>
        <m>
            <fs0ia>X</fs0ia>
            <fs0ib>X</fs0ib>
            <fs15>H</fs15>
            <fs15i>O</fs15i>
            <fs16>X</fs16>
            <fs18>X</fs18>
            <fs21>X</fs21>
            <fs16ia>H</fs16ia>
            <fs18ia>H</fs18ia>
            <fs21ia>H</fs21ia>
            <fs16ib>H</fs16ib>
            <fs18ib>H</fs18ib>
            <fs21ib>H</fs21ib>
            <fs30i>X</fs30i>
        </m>
        <t>
            <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>
        </t>
        <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>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </p>
        <l>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </l>
        <w>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </w>
        <pw>
            <d>X</d>
            <h>X</h>
        </pw>
        <add><b></b></add>
    </support>



    <reference>
        <item>
            <name>cnc_rdfixofs</name>
            <file>ncdata/cnc_rdfixofs.htm</file>
        </item>
        <item>
            <name>cnc_wrfixofs</name>
            <file>ncdata/cnc_wrfixofs.htm</file>
        </item>
    </reference>



    <example>
    </example>



  </func>
</root>
