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


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



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



        <!-- 解説 -->
        <doc>
            <cmn>
                <p>
                    CNCのオペレータメッセージの内容を読み出します。
                    オペレータメッセージはOPMSG内のdataに格納されます。
                </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>type</name>
                        <type>in</type>
                        <content>
                                <p>
                                    オペレータメッセージの種類を指定します。
                                </p>
                                <li>
                                    Series 150/150i
                                </li>
                                <table class="dd">
                                    <colgroup align="right">
                                        <tr>
                                            <td>&#160;0</td>
                                            <td>:</td>
                                            <td>第1メッセージ</td>
                                        </tr>
                                        <tr>
                                            <td>&#160;1</td>
                                            <td>:</td>
                                            <td>第2メッセージ</td>
                                        </tr>
                                        <tr>
                                            <td>&#160;2</td>
                                            <td>:</td>
                                            <td>第3メッセージ</td>
                                        </tr>
                                        <tr>
                                            <td>&#160;3</td>
                                            <td>:</td>
                                            <td>第4メッセージ</td>
                                        </tr>
                                        <tr>
                                            <td>&#160;4</td>
                                            <td>:</td>
                                            <td>マクロメッセージ</td>
                                        </tr>
                                        <tr>
                                            <td>-1</td>
                                            <td>:</td>
                                            <td>全メッセージ</td>
                                        </tr>
                                    </colgroup>
                                </table>
                                <br/>
                                <li>
                                    Series 160/180/210, 160i/180i/210i, 0i, 300i, Power Mate i
                                </li>
                                <table class="dd">
                                    <colgroup align="right">
                                        <tr>
                                            <td>&#160;0</td>
                                            <td>:</td>
                                            <td>第1メッセージ</td>
                                        </tr>
                                    </colgroup>
                                </table>
                                <br/>
                                <li>
                                    Series 160i/180i-W
                                </li>
                                <table class="dd">
                                    <colgroup align="right">
                                        <tr><td>&#160;0</td> <td>:</td> <td>第１メッセージ</td>    </tr>
                                        <tr><td>&#160;1</td> <td>:</td> <td>第２メッセージ</td>    </tr>
                                        <tr><td>&#160;2</td> <td>:</td> <td>第３メッセージ</td>    </tr>
                                        <tr><td>&#160;3</td> <td>:</td> <td>第４メッセージ</td>    </tr>
                                        <tr><td>-1</td>      <td>:</td> <td>全メッセージ</td>      </tr>
                                    </colgroup>
                                </table>
                        </content>
                    </item>
                    <item>
                        <name>length</name>
                        <type>in</type>
                        <content>
                                <p>
                                    データブロック長(OPMSG構造体のサイズ)を指定します。
                                </p>
                                <li>
                                    Series 150/150i
                                </li>
                                    <p class="dd"><b>単一メッセージ(第1〜4メッセージ)</b></p>
                                    <p class="dd"><img src="misc/opm15.gif"></img></p>
                                    <p class="dd"><b>マクロメッセージ</b></p>
                                    <p class="dd"><img src="misc/opm15m.gif"></img></p>
                                    <p class="dd"><b>全メッセージ</b></p>
                                    <p class="dd"><img src="misc/opm15all.gif"></img></p>
                                <br/>
                                <li>
                                    Series 160/180/210, 160i/180i/210i, 0i, 300i, Power Mate i
                                </li>
                                    <p class="dd"><img src="misc/opm16.gif"></img></p>
                                <br/>
                                <li>
                                    Series 160i/180i-W
                                </li>
                                    <p class="dd"><b>単一メッセージ(第1〜4メッセージ)</b></p>
                                    <p class="dd"><img src="misc/opm16.gif"></img></p>
                                    <p class="dd"><b>全メッセージ</b></p>
                                    <p class="dd"><img src="misc/opm16wal.gif"></img></p>
                        </content>
                    </item>
                    <item>
                        <name>opmsg</name>
                        <type>out</type>
                        <content>
                                <p>
                                    オペレータメッセージを返すOPMSG構造体へのポインタです。OPMSG構造体は次の通りです。
                                </p>
<pre><![CDATA[
typedef struct msg {
     short  datano ;         /* オペレータメッセージ番号 */
     short  type ;           /* オペレータメッセージの種類 */
     short  char_num ;       /* メッセージ文字数 */
     char  data[MSG_SIZE] ;  /* オペレータメッセージ文字列 */
} OPMSG ;                    /* MSG_SIZE : メッセージ文字数 */
]]></pre>
                                <dl>
                                    <dt>datano</dt>
                                        <dd>オペレータメッセージ番号がセットされます。</dd>
                                        <ul>
                                        <ul>
                                            <li type="circle">
                                                メッセージあり
                                            </li>
                                                <dl>
                                                    <dt><li>Series 150/150i</li></dt>
                                                    <dd>0〜999</dd>
                                                    <dt><li>Series 160/180/210, 160i/180i/210i, 0i, 300i, Power Mate i</li></dt>
                                                    <dd>番号なしのとき : 0</dd>
                                                    <dd>番号ありのとき : 2000 〜 2099</dd>
                                                </dl>
                                            <li type="circle">
                                                メッセージなし
                                            </li>
                                                <dl>
                                                    <dd>-1</dd>
                                                </dl>
                                        </ul>
                                        </ul>
                                    <dt>type</dt>
                                        <dd>オペレータメッセージの種類がセットされます。</dd>
                                        <ul>
                                            <dd><li type="disc">Series 150/150i</li></dd>
                                            <ul>
                                                <table class="dd">
                                                    <colgroup align="right">
                                                    <tr>
                                                        <td>0〜3</td>
                                                        <td>:</td>
                                                        <td>第1〜4メッセージ</td>
                                                    </tr>
                                                    <tr>
                                                        <td>4</td>
                                                        <td>:</td>
                                                        <td>マクロメッセージ</td>
                                                    </tr>
                                                    </colgroup>
                                                </table>
                                            </ul>
                                            <dd><li type="disc">Series 160/180/210, 160i/180i/210i, 0i, 300i, Power Mate i</li></dd>
                                            <ul>
                                                <table class="dd">
                                                    <colgroup align="right">
                                                    <tr>
                                                        <td>0</td>
                                                        <td>:</td>
                                                        <td>第1メッセージ</td>
                                                    </tr>
                                                    </colgroup>
                                                </table>
                                            </ul>
                                            <dd><li type="disc">Series 160i/180i-W</li></dd>
                                            <ul>
                                                <table class="dd">
                                                    <colgroup align="right">
                                                    <tr> <td>0〜3</td> <td>:</td> <td>第1〜4メッセージ</td> </tr>
                                                    </colgroup>
                                                </table>
                                            </ul>
                                        </ul>
                                    <dt>char_num</dt>
                                        <dd>オペレータメッセージ文字数がセットされます。</dd>
                                            <ul>
                                                <dd><li type="disc">Series 150/150i</li></dd>
                                                <ul>
                                                    <table class="dd">
                                                        <colgroup align="right">
                                                        <tr>
                                                            <td>1〜129</td>
                                                            <td>:</td>
                                                            <td>第1〜4メッセージ</td>
                                                        </tr>
                                                        <tr>
                                                            <td>1〜27</td>
                                                            <td>:</td>
                                                            <td>マクロメッセージ</td>
                                                        </tr>
                                                        </colgroup>
                                                    </table>
                                                </ul>
                                                <dd><li type="disc">Series 160/180/210, 160i/180i/210i, 0i, 300i, Power Mate i</li></dd>
                                                <ul>
                                                    <table class="dd">
                                                        <colgroup align="right">
                                                        <tr>
                                                            <td>1〜256</td>
                                                            <td>:</td>
                                                            <td>オペレータメッセージ</td>
                                                        </tr>
                                                        </colgroup>
                                                    </table>
                                                </ul>
                                            </ul>
                                    <dt>data</dt>
                                        <dd>
                                            オペレータメッセージ文字列がセットされます。ASCII文字列がセットされます。
                                            終端に'\0'がセットされます。
                                        </dd>
                                </dl>
                        </content>
                    </item>
                </vc>
            </common>

            <!-- 300is -->
            <is>
                <hssb>
                    <vc>
                        <item>
                            <name>FlibHndl</name>
                            <type>in</type>
                            <content>
                                <p>
                                    ライブラリハンドルです。
                                    詳細は、「<a href="handle.htm" target="_parent">ライブラリハンドル</a>」を参照して下さい。
                                </p>
                            </content>
                        </item>
                        <item>
                            <name>type</name>
                            <type>in</type>
                            <content>
                                <div class="dd">
                                    <p>
                                        オペレータメッセージの種類を指定します。
                                    </p>
                                    <table class="dd">
                                        <colgroup align="right">
                                            <tr>
                                                <td>&#160;0</td>
                                                <td>:</td>
                                                <td>第1メッセージ</td>
                                            </tr>
                                        </colgroup>
                                    </table>
                                    <br/>
                                </div>
                            </content>
                        </item>
                        <item>
                            <name>length</name>
                            <type>in</type>
                            <content>
                                <div class="dd">
                                    <p>
                                        データブロック長(OPMSG構造体のサイズ)を指定します。
                                    </p>
                                        <p class="dd"><img src="misc/opm16.gif"></img></p>
                                    <br/>
                                </div>
                            </content>
                        </item>
                        <item>
                            <name>opmsg</name>
                            <type>out</type>
                            <content>
                                <div class="dd">
                                    <p>
                                        オペレータメッセージを返すOPMSG構造体へのポインタです。OPMSG構造体は次の通りです。
                                    </p>
<pre><![CDATA[
typedef struct msg {
     short  datano ;         /* オペレータメッセージ番号 */
     short  type ;           /* オペレータメッセージの種類 */
     short  char_num ;       /* メッセージ文字数 */
     char  data[MSG_SIZE] ;  /* オペレータメッセージ文字列 */
} OPMSG ;                    /* MSG_SIZE : メッセージ文字数 */
]]></pre>
                                    <dl>
                                        <dt>datano</dt>
                                            <dd>オペレータメッセージ番号がセットされます。</dd>
                                            <ul>
                                                <ul>
                                                    <li type="circle">
                                                        メッセージあり
                                                    </li>
                                                        <dl>
                                                            <dd>番号なしのとき : 0</dd>
                                                            <dd>番号ありのとき : 2000 〜 2099</dd>
                                                        </dl>
                                                    <li type="circle">
                                                        メッセージなし
                                                    </li>
                                                        <dl>
                                                            <dd>-1</dd>
                                                        </dl>
                                                </ul>
                                            </ul>
                                        <dt>type</dt>
                                            <dd>オペレータメッセージの種類がセットされます。</dd>
                                            <ul>
                                                <ul>
                                                    <table class="dd">
                                                        <colgroup align="right">
                                                        <tr>
                                                            <td>0</td>
                                                            <td>:</td>
                                                            <td>第1メッセージ</td>
                                                        </tr>
                                                        </colgroup>
                                                    </table>
                                                </ul>
                                            </ul>
                                        <dt>char_num</dt>
                                            <dd>オペレータメッセージ文字数がセットされます。</dd>
                                                <ul>
                                                    <ul>
                                                        <table class="dd">
                                                            <colgroup align="right">
                                                            <tr>
                                                                <td>1〜256</td>
                                                                <td>:</td>
                                                                <td>オペレータメッセージ</td>
                                                            </tr>
                                                            </colgroup>
                                                        </table>
                                                    </ul>
                                                </ul>
                                        <dt>data</dt>
                                            <dd>
                                                オペレータメッセージ文字列がセットされます。
                                                ASCII文字列がセットされます。終端に'\0'がセットされます。
                                            </dd>
                                    </dl>
                                </div>
                            </content>
                        </item>
                    </vc>
                </hssb>
            </is>
        </argument>



        <!-- 戻り値 -->
        <errcode>
        <item>
            <name>EW_LENGTH</name>
            <content>
                データブロック長の誤り<br/>
                OPMSG構造体のサイズ(length)が不正です
            </content>
        </item>
        <item>
            <name>EW_ATTRIB</name>
            <content>
                データ属性の誤り<br/>
                オペレータメッセージの種類(type)の指定が不適切です  
            </content>
        </item>
        <item>
            <name>EW_NOOPT</name>
            <content>
                オプションなし<br/>
                必要なNCオプションがありません。
            </content>
        </item>
        <item>
            <name>EW_PARAM</name>
            <content>
                ＣＮＣパラメータの誤り<br/>
                <ul style="margin-top:0;margin-bottom:0">
                    <li>Series 300i/310i/320i</li>
                    11931#0=1になっています。
                </ul>
            </content>
        </item>
        </errcode>



        <!-- CNCオプション -->
        <option>
            <hssb>拡張ドライバ/ライブラリ機能が必要です。</hssb>
            <ethr><p>イーサネット機能と拡張ドライバ/ライブラリ機能が必要です。</p>
                  <p>但し、Series 160i/180i/210i/0i MODEL B, 300i に関しては次のようになります。</p>
                  <p>組込みイーサネットを使用のとき、</p>
                     <p class="dd">上記２つの機能は必要ありません。</p>
                  <p>イーサネットボードを使用のとき、</p>
                      <p class="dd">イーサネット機能のみ必要です。</p>
            </ethr>
            <need>
                <li>Series 150/150i</li>
                    外部データ入出力機能<br/>
                <li>Series 160/180/210, 160i/180i/210i, 0i, 300i</li>
                    外部メッセージ<br/>
                    外部データ入力<br/>
            </need>
            <!-- 300is -->
            <is>
                <hssb>拡張ドライバ/ライブラリ機能が必要です。</hssb>
                <need>
                    外部メッセージ<br/>
                    外部データ入力<br/>
                </need>
            </is>
        </option>



        <!-- CNCパラメータ -->
        <parameter>
            <type>
                <ul>
                    <li>Series 300i/310i/320i</li>
                        11931#0=0(必ず設定して下さい)
                </ul>
            </type>
        </parameter>



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



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



        <!-- プログラム例 -->
        <example>
<vc><![CDATA[
以下のプログラムはオペレータメッセージを読みだし、その内容を画面に表示します。

#include "fwlib32.h"

void example( void )
{
        OPMSG buf ;
        cnc_rdopmsg( h, 0, 6+256, &buf ) ;
        if ( buf.datano != -1 ) 
                printf( "#04d %s\n", buf.datano. buf.data ) ;
        else
                printf( "No operator message.\n" ) ;
}]]></vc>
    </example>



    </func>
</root>
