home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 1997 March / VPR9703A.ISO / VPR_DATA / DOGA / SOURCES / POLYEDIT.LZH / ML.DOC < prev    next >
Text File  |  1996-06-21  |  21KB  |  520 lines
  1. ****************************************************************************
  2. *
  3. *      マクロ言語
  4. *
  5. *    Copyright T.Kobayashi    1995.7.1
  6. *
  7. ****************************************************************************
  8.  
  9. １．はじめに
  10.  
  11.   　'ml'はインタープリンタ形式で実行するマクロ言語である。モデラ( model.exe,
  12.   model.x )のユーザインターフェースの記述に用いられている。
  13.  
  14.  
  15. ２．予約語と定数
  16.  
  17.   　予約語は以下の通り。
  18.     if, else, while, do, for, break, continue, return, var,
  19.     function, private, const
  20.  
  21.   　定義済み定数（システム定数）は以下の通り。
  22.     TRUE        真
  23.     FALSE        偽
  24.     ON        ON
  25.     OFF        OFF
  26.     NOASSIGN    値が代入されていない変数
  27.     BOOLEAN        論理型
  28.     INT        整数型
  29.     REAL        実数型
  30.     ARRAY        配列型
  31.     FUNC        関数への参照型
  32.     TYPE        「型を示す」型
  33.     OBJECT        オブジェクト型
  34.  
  35.  
  36. ３．文法定義
  37.  
  38.   　文法の定義に用いる記号を示す。
  39.       ::=        左辺は右辺で定義される
  40.       ( ... )+    カッコ内の1回以上の繰り返し
  41.       ( ... )*    カッコ内の0回以上の繰り返し
  42.       [ ... ]        カッコ内は省略可能
  43.       " ... "        クオートで囲まれた文字列そのもの
  44.       < ... >        文法上の概念
  45.       |        左右のいずれか
  46.  
  47.   　以下に言語の文法定義を示す。
  48.     <プログラム>    ::=    ( <文> )*
  49.     <文>        ::=    <宣言> | <実行文> | <複文>
  50.     <複文>        ::=    "{" <文>* "}"
  51.     <宣言>        ::=    <変数宣言> | <関数宣言>
  52.     <変数宣言>    ::=    var [ <変数修飾子> ] <変数定義> ( , <変数定義> )* ;
  53.     <変数修飾子>    ::=    ( private | const )+
  54.     <変数定義>    ::=    <変数> [ = <式> ]
  55.     <関数宣言>    ::=    function <識別子> "(" [ <変数列> ] ")" <文>
  56.     <変数列>    ::=    <変数> ( , <変数> )*
  57.     <変数>        ::=    <識別子> ( "[" <式> "]" )*
  58.     <実行文>    ::=    <if文> | <while文> | <do文> | <for文>
  59.                 <break文> | <continue文> | <return文> |
  60.                 <代入文> | <インクリメント文> | <手続き文>
  61.     <if文>        ::=    if "(" <式> ")" <文> [ else <文> ]
  62.     <while文>    ::=    while "(" <式> ")" <文>
  63.     <do文>        ::=    do <文> while "(" <式> ")" ;
  64.     <for文>        ::=    for "(" <文> <式> ; <文> ")" <文>
  65.     <break文>    ::=    break ;
  66.     <continue文>    ::=    continue ;
  67.     <return文>    ::=    return [ <式> ] ;
  68.     <代入文>    ::=    <変数> 代入演算子> <式> ;
  69.     <代入演算子>    ::=    = | += | ｰ= | *= | /= | &= | "|="
  70.     <インクリメント文> ::=    <変数> <インクリメント演算子> ;
  71.     <インクリメント演算子> ::= ++ | --
  72.     <手続き文>    ::=    <識別子> "(" [ <引数列> ] ")" ;
  73.     <引数列>    ::=    <式> ( , <式> )*
  74.      <式>        ::=    <論理積式> ( <論理和演算子> <論理積式> )*
  75.      <論理積式>    ::=    <比較式> ( <論理積演算子> <比較式> )*
  76.      <比較式>    ::=    <単純式> ( <比較演算子> <単純式> )*
  77.      <単純式>    ::=    <積和式> ( <シフト演算子> <積和式> )*
  78.      <積和式>    ::=    <項> ( <加法演算子> <項> )*
  79.      <項>        ::=    <因子> ( <乗法演算子> <因子> )*
  80.      <因子>        ::=    <単純因子> ( <参照演算子> <単純因子> )*
  81.      <単純因子>    ::=    [ <単項演算子> ]
  82.                 ( <変数> | <定数> | <関数> | "(" <式> ")" ) |
  83.                 "{" <式> (, <式> )* "}"
  84.      <関数>        ::=    <識別子> "(" [ <引数列> ] ")"
  85.      <定数>        ::=    <数値定数> | <文字列定数> | <システム定数>
  86.     <論理和演算子>    ::=    "|" | ^
  87.     <論理積演算子>    ::=    &
  88.     <比較演算子>    ::=    == | != | < | > | <= | >=
  89.     <シフト演算子>    ::=    "<<" | ">>"
  90.     <加法演算子>    ::=    + | -
  91.     <乗法演算子>    ::=    * | / | %
  92.     <参照演算子>    ::=    . | "->"
  93.  
  94.   （注意）
  95.         <識別子>はアルファベットまたは数字または'_'の文字を組み合わせた文字列
  96.         （ただし、最初の文字は数字以外）である。
  97.         <数値定数>は0～9と'.'を組み合わせた文字列またはシングルクオートで囲ま
  98.         れた文字（その文字のアスキーコードを示す）。
  99.         <文字列定数>はダブルクオート'"'で囲まれた文字列である。
  100.         <システム定数>は前節で定義した。
  101.         <手続き文>と<関数>で参照されている<識別子>は<関数宣言>で宣言した<識別
  102.         子>でなければならない。
  103.         <単純因子>と<代入文>、<インクリメント>文で参照されている<識別子>は<変
  104.         数定義>で宣言した<識別子>でなければならない。
  105.  
  106.  
  107. ４．意味定義
  108.  
  109.   プログラム
  110.     <プログラム>は複数の<文>から構成される。<プログラム>を複数のファイルに分
  111.     割しても良いが、分割は<文>単位でされなければならない。
  112.     実行はファイルの先頭からなされる。分割した場合は別途ファイルの実行順を指
  113.     定する手段が用意される（はずである）。
  114.   文
  115.     <文>はフリーフォーマットである。改行はスペース文字と同様の意味しか持たな
  116.     い。Ｃと同様に{}で囲まれた1個以上の文は1個の文と同じものとみなされる（複
  117.     文）。
  118.   宣言文
  119.     <宣言文>は実行されない。
  120.   関数宣言
  121.     <関数宣言>中の文も宣言時には実行されない。他の<文>から参照された時に実行
  122.     される。宣言は参照の前になされなければならない。<関数宣言>中で<関数宣言>
  123.     することはできない。従って、手続きと関数は常に大域である。
  124.   変数宣言
  125.     トップレベルで宣言された<変数>は大域変数となる。<関数宣言>の中で宣言され
  126.     た<変数>はローカル変数となる。<変数宣言>は必ずしも<関数宣言>の先頭でする
  127.     必要はないが、使用する前には宣言しなければならない。同様に大域変数もファ
  128.     イルの先頭で宣言する必要はないが、使用する前に宣言しなければならない。
  129.     ローカル変数名は関数中で（複文中ではない）ユニークな名前であり、大域変数
  130.     名とは重なってもよい。
  131.     宣言時にその値を代入することも可能である。
  132.     変数修飾子privateを付加するとそのモジュールのみで参照可能な変数になる。
  133.     変数修飾子constを付加すると定数となる（宣言時以外で代入不可能）。
  134.   変数と型
  135.     変数には型はない。数値には型がある。従って数値はその値と型を持ち、変数は
  136.     型と値の両方を保持する。型は以下の通り。
  137.     BOOLEAN    論理型
  138.     INT    整数型
  139.     REAL    実数型
  140.     ARRAY    配列型
  141.     FUNC    関数への参照型
  142.     TYPE    「型を示す」型
  143.     OBJECT    オブジェクト型
  144.     組み込み関数typeofで数値からその型を得ることができる。
  145.     BOOLEANは論理演算と一致、不一致比較( ==, != )のみ演算可能。INTは参照演算
  146.     を除くすべての演算が可能。REALは論理演算、シフト演算、参照演算以外のすべ
  147.     ての演算が可能。ARRAY, FUNC, TYPEは一致、不一致比較のみ演算可能。
  148.     一度も代入されてない変数を参照してはならない。
  149.     OBJECTは拡張型であり、拡張された型をクラスと呼ぶ。
  150.     クラスは応用システムごとに定義される（行列型、ベクトル型、複素型等）。文
  151.     字列クラスはデフォルトで定義されている。クラスごとに演算子の動作を定義で
  152.     き、関数もオーバロードできる。
  153.   配列変数
  154.     配列変数はＣと同様に[]を用いる。多次元配列も使用可能。
  155.     変数に型はないので配列変数の各メンバに別々の型の数値を代入してもよい。
  156.     1次元の配列変数を識別子だけで参照するとARRAY型とみなされる。同様に2次元の
  157.     配列変数を識別子だけまたは1次元配列として参照してもARRAYとみなされる。
  158.   制御文
  159.     if, while, fo, for, break, continue, returnの動作はＣと同様である。
  160.  
  161.  
  162. ５．組み込み関数
  163.  
  164. function    print( ... )
  165. ----------------------------------------------------------------------------
  166. 引数を表示する。引数は任意の型が許される。拡張クラスの場合もtostring関数が
  167. 定義されていれば表示可能である。
  168. 戻り値なし。
  169. ----------------------------------------------------------------------------
  170.  
  171. function    fprint( fname, ... )
  172. ----------------------------------------------------------------------------
  173. 引数をファイル fname に追加書き込みする。引数は任意の型が許される。拡張クラ
  174. スの場合もtostring関数が定義されていれば表示可能である。
  175. 戻り値なし。
  176. ----------------------------------------------------------------------------
  177.  
  178. function    tostring( arg, cols )
  179. ----------------------------------------------------------------------------
  180. 引数を文字列に変換する。
  181. colsは文字数だが省略可能。
  182. 戻り値は文字列クラス。
  183. ----------------------------------------------------------------------------
  184.  
  185. function    call( func, ... )
  186. ----------------------------------------------------------------------------
  187. 関数を呼び出す。
  188. funcはFUNC型でなければならない。2番目以降の引数にfuncへの引数を設定する。
  189. ［例］    a = call( tostring, "123" );    aに123が代入される。
  190. ----------------------------------------------------------------------------
  191.  
  192. function    typeof( arg )
  193. ----------------------------------------------------------------------------
  194. argの型を返す。argはすべての型で有効。
  195. 戻り値はTYPE型。
  196. ----------------------------------------------------------------------------
  197.  
  198. function    sizeof( ary )
  199. ----------------------------------------------------------------------------
  200. 配列のサイズを返す。aryは配列型。
  201. 戻り値はINT型。
  202. ----------------------------------------------------------------------------
  203.  
  204. function    sqrt( arg )
  205. function    sin( arg )
  206. function    cos( arg )
  207. function    tan( arg )
  208. function    asin( arg )
  209. function    acos( arg )
  210. function    atan( arg )
  211. function    atan2( arg1, arg2 )
  212. function    tan( arg )
  213. function    log( arg )
  214. function    exp( arg )
  215. ----------------------------------------------------------------------------
  216. 数値関数、引数はREAL型で戻り値もREAL型
  217. ----------------------------------------------------------------------------
  218.  
  219. function    abs( arg )
  220. ----------------------------------------------------------------------------
  221. 引数argの絶対値を求める。argはINTまたはREAL型。
  222. 戻り値はargと同じ型。
  223. ----------------------------------------------------------------------------
  224.  
  225. function    ObjectCount()
  226. ----------------------------------------------------------------------------
  227. 現在確保されているオブジェクト数を返す。
  228. デバッグ用
  229. ----------------------------------------------------------------------------
  230.  
  231. function    StackPtr()
  232. ----------------------------------------------------------------------------
  233. 現在のスタックポインタを返す。
  234. デバッグ用
  235. ----------------------------------------------------------------------------
  236.  
  237.  
  238. ６．文字列クラス
  239.  
  240. 演算子    +
  241. ----------------------------------------------------------------------------
  242. 引数の文字列を連結する。
  243. ----------------------------------------------------------------------------
  244.  
  245. 演算子    <, >, <=, >=, ==, !=
  246. ----------------------------------------------------------------------------
  247. 文字列を比較する。
  248. ----------------------------------------------------------------------------
  249.  
  250. 演算子    !
  251. ----------------------------------------------------------------------------
  252. 文字列の長さを得る。
  253. 式の値はINTである。
  254. ----------------------------------------------------------------------------
  255.  
  256. function    strtoasc( str )
  257. ----------------------------------------------------------------------------
  258. 文字列の最初の文字のアスキーコードを得る。
  259. 戻り値はINT型
  260. ----------------------------------------------------------------------------
  261.  
  262. function    asctostr( code )
  263. ----------------------------------------------------------------------------
  264. アスキーコードから１文字の文字列を生成する。
  265. 戻り値は文字列クラス
  266. ----------------------------------------------------------------------------
  267.  
  268. function    substr( str, n )
  269. ----------------------------------------------------------------------------
  270. 部分文字列を得る。
  271. nはINT型で正数の時はstrの最初のn文字を返す。負数の時は最後のn文字を返す。
  272. ----------------------------------------------------------------------------
  273.  
  274. function    search( str, key )
  275. ----------------------------------------------------------------------------
  276. 文字列str中の部分文字列keyを検索する。
  277. 戻り値はINT型でkeyの位置を返す。
  278. 見つからなかった時は-1を返す。
  279. ----------------------------------------------------------------------------
  280.  
  281. function    atoi( str )
  282. function    atof( str )
  283. ----------------------------------------------------------------------------
  284. 文字列をそれぞれINT型とREAL型に変換する。
  285. ----------------------------------------------------------------------------
  286.  
  287. function    sprintf( fmt, [arg, ...] )
  288. ----------------------------------------------------------------------------
  289. fmt に基づいて整形した結果の文字列を返す。使えるフォーマットは、
  290. %s,%d,%x,%c,%f,%e 。詳しくは C 言語の本を見よ。
  291. ----------------------------------------------------------------------------
  292.  
  293.  
  294. function    getenv( str )
  295. ----------------------------------------------------------------------------
  296. 文字列strで指定した環境変数を得る。
  297. 環境変数が設定されていない場合は""を返す。
  298. ----------------------------------------------------------------------------
  299.  
  300. function    access( path, mode )
  301. ----------------------------------------------------------------------------
  302. ファイルがアクセス可能かどうかを調べる。
  303. アクセス可能ならTUREを、そうでなければFALSEを返す。
  304. modeはINTでCのaccessのパラメータと同じ意味。
  305. ----------------------------------------------------------------------------
  306.  
  307. function    fullpath( path )
  308. ----------------------------------------------------------------------------
  309. ファイル名をフルパスに変換する。
  310. ----------------------------------------------------------------------------
  311.  
  312. function    toupper( str )
  313. ----------------------------------------------------------------------------
  314. 文字列中の文字をすべて大文字に変換する
  315. ----------------------------------------------------------------------------
  316.  
  317. function    tolower( str )
  318. ----------------------------------------------------------------------------
  319. 文字列中の文字をすべて小文字に変換する
  320. ----------------------------------------------------------------------------
  321.  
  322. function    delete( fname )
  323. ----------------------------------------------------------------------------
  324. ファイルを削除する。
  325. ----------------------------------------------------------------------------
  326.  
  327. function    dir( [path] )
  328. ----------------------------------------------------------------------------
  329. path無指定時、カレントディレクトリを返す。
  330. path指定時、カレントディレクトリを path に変更する。あ、カレントドライブが変
  331. わらんから使えんなぁ。
  332. ----------------------------------------------------------------------------
  333.  
  334.  
  335. ７．行列クラス
  336.  
  337. 行列クラスはライブラリ matrix.dl と matclass.dl をリンクすると使用できる。
  338.  
  339. 定数
  340. ----------------------------------------------------------------------------
  341. UNIT_MATRIX    単位行列
  342. AXISX        Ｘ軸（axis, rot関数で使用）
  343. AXISY        Ｙ軸（axis, rot関数で使用）
  344. AXISZ        Ｚ軸（axis, rot関数で使用）
  345. ----------------------------------------------------------------------------
  346.  
  347. 演算子    +
  348. ----------------------------------------------------------------------------
  349. 行列の和を求める。
  350. ----------------------------------------------------------------------------
  351.  
  352. 演算子    *
  353. ----------------------------------------------------------------------------
  354. 行列の積を求める。
  355. ----------------------------------------------------------------------------
  356.  
  357. 演算子    /
  358. ----------------------------------------------------------------------------
  359. 被除数と除数の逆行列との積を求める。
  360. ----------------------------------------------------------------------------
  361.  
  362. function    Matrix( a11, a12, a13,
  363.             a21, a22, a23,
  364.             a31, a32, a33,
  365.             a41, a42, a43 )
  366. function    Matrix( v1, v2, v3, v4 )
  367. function    Matrix( v1, v2, v3 )
  368. ----------------------------------------------------------------------------
  369. 行列クラスを生成する。
  370. ----------------------------------------------------------------------------
  371.  
  372. function    vec( mat, xx, xy, xz, zx, zy, zz )
  373. function    vec( mat, vx, vz )
  374. ----------------------------------------------------------------------------
  375. ベクトル指定で行列を生成する。
  376. (xx, xy, xz ),vxはＸ軸が移るベクトル、( zx, zy, zz ),vzはＺ軸が移るベクトル。
  377. ----------------------------------------------------------------------------
  378.  
  379. function    axis( mat, a1, a2 )
  380. ----------------------------------------------------------------------------
  381. 軸変換の行列を生成する。
  382. a1, a2はAXISX, AXISY, AXISZのいずれかで、指定した２軸が入れ替わる。
  383. ----------------------------------------------------------------------------
  384.  
  385. function    move( mat, x, y, z )
  386. function    move( mat, vec )
  387. ----------------------------------------------------------------------------
  388. 平行移動の行列を生成する。
  389. x, y, z はINTまたはREALで平行移動成分を示す。
  390. vec はベクトルで平行移動成分を示す。
  391. ----------------------------------------------------------------------------
  392.  
  393. function    rot( mat, type, deg )
  394. ----------------------------------------------------------------------------
  395. 回転の行列を生成する。
  396. typeはAXISX, AXISY, AXISZのいずれか。
  397. degはINTまたはREALで回転角でdegreeで指定する。
  398. ----------------------------------------------------------------------------
  399.  
  400. function    scale( mat, x, y, z )
  401. function    scale( mat, vec )
  402. ----------------------------------------------------------------------------
  403. 拡大縮小の行列を生成する。
  404. x, y, z はINTまたはREALで拡大率軸ごとにを指定する。
  405. vec はベクトルで拡大率を軸ごとにを指定する。
  406. ----------------------------------------------------------------------------
  407.  
  408. function    getvector( mat, n )
  409. function    getvector( mat, ary )
  410. ----------------------------------------------------------------------------
  411. 行列のn番目(0～3)要素ベクトルを返す。
  412. あるいは、要素数4の配列にベクトルを設定する。
  413. ----------------------------------------------------------------------------
  414.  
  415.  
  416. ８．ベクトルクラス
  417.  
  418. 行列クラスはライブラリ matrix.dl と matclass.dl をリンクすると使用できる。
  419.  
  420. 演算子    +
  421. ----------------------------------------------------------------------------
  422. ベクトルの和を求める。
  423. ----------------------------------------------------------------------------
  424.  
  425. 演算子    -
  426. ----------------------------------------------------------------------------
  427. ベクトルの各成分ごとの差を求める。
  428. ----------------------------------------------------------------------------
  429.  
  430. 演算子    *
  431. ----------------------------------------------------------------------------
  432. ベクトル積を求める。
  433. ----------------------------------------------------------------------------
  434.  
  435. 演算子    .
  436. ----------------------------------------------------------------------------
  437. スカラー積を求める。
  438. 式の値はREAL型になる。
  439. ----------------------------------------------------------------------------
  440.  
  441. function    vector( x, y, z )
  442. function    vector( ary )
  443. ----------------------------------------------------------------------------
  444. ベクトルを生成する。
  445. x, y, z はINTまたはREALで各成分
  446. ary[0]～ary[2] はINTまたはREALで各成分
  447. ----------------------------------------------------------------------------
  448.  
  449. function    unit( vec )
  450. ----------------------------------------------------------------------------
  451. ベクトルを正規化する。
  452. ----------------------------------------------------------------------------
  453.  
  454. function    abs( vec )
  455. ----------------------------------------------------------------------------
  456. ベクトルの大きさを得る。
  457. 戻り値はREAL型
  458. ----------------------------------------------------------------------------
  459.  
  460. function    vx( vec )
  461. ----------------------------------------------------------------------------
  462. ベクトルのX成分を得る
  463. 戻り値はREAL型
  464. ----------------------------------------------------------------------------
  465.  
  466. function    vy( vec )
  467. ----------------------------------------------------------------------------
  468. ベクトルのY成分を得る
  469. 戻り値はREAL型
  470. ----------------------------------------------------------------------------
  471.  
  472. function    vz( vec )
  473. ----------------------------------------------------------------------------
  474. ベクトルのZ成分を得る
  475. 戻り値はREAL型
  476. ---------------------------------------------------------------------------
  477.  
  478. function element( vec, ary )
  479. ---------------------------------------------------------------------------
  480. ベクトルの各成分を得る。
  481. aryにサイズが３以上の配列変数を設定し、(x, y, z)が格納される。
  482. ---------------------------------------------------------------------------
  483.  
  484. ７.     ファイルクラス
  485. function fileopen( filename [, type])
  486. ---------------------------------------------------------------------------
  487. ファイルをオープンする。type 無指定、もしくは type = "r" の時は読み込み、
  488. "w" の時は書き込み、"a" の時は追加。戻り値はファイルクラス。
  489. 失敗したときは FALSE (Boolenan 型)を返す。
  490. ---------------------------------------------------------------------------
  491.  
  492. function fileputs( file, arg1 [, arg2 ...] )
  493. ---------------------------------------------------------------------------
  494. file に文字列を出力する。
  495. 通常は TRUE 、エラー時には FALSE を返す。
  496. ---------------------------------------------------------------------------
  497.  
  498. function filegets( file )
  499. ---------------------------------------------------------------------------
  500. file から 1 行入力する。戻り値は文字列クラス。
  501. ---------------------------------------------------------------------------
  502.  
  503. function fileputc( file, code )
  504. ---------------------------------------------------------------------------
  505. file に文字コード code の文字を出力する。
  506. 通常は TRUE 、エラー時には FALSE を返す。
  507. ---------------------------------------------------------------------------
  508.  
  509. function filegetc( )
  510. ---------------------------------------------------------------------------
  511. file から1文字読み取り、その文字コードを返す。
  512. ---------------------------------------------------------------------------
  513.  
  514. function fileclose( file )
  515. ---------------------------------------------------------------------------
  516. file の読み書きを終了する。
  517. 通常は TRUE 、エラー時には FALSE を返す。
  518. ---------------------------------------------------------------------------
  519.  
  520.