AutoLISP

提供：ギズモ・ラボ・ウィキ

目次 1 概要 2 AutoLisp 関数の構文 3 AutoLISP のデータ タイプ 4 関数の機能別一覧 5 AutoLISP プログラムの作成 6 AutoLISP プログラムの使用 7 IJCAD で自動ロードする場合の注意点 8 AutoLISP が使えるCADソフト 9 特殊フォーム 10 AutoLisp のエラーコード 11 関連書籍

概要

AutoLisp は、AutoCAD や IJCAD など一部のAutoCAD互換ソフトで利用できるインタープリタ型プログラミング言語。 AutoCAD や IJCAD でコマンドやシステム変数、ダイアログ ボックス（DCL）を呼び出すことができる。 AutoCAD LT においては利用できない。(AutoCAD LT で AutoLisp の機能を利用可能にするソフトウェアも存在したが、LT2002 以降のバージョンに対応したものはなくなっている。)

IJCAD における AutoLisp は、AutoCAD の互換機能として存在し、一部の関数や外部定義関数を除けば、ほぼ同様に利用することが出来る。 （利用可能な関数などの情報については、AutoLisp関数互換表 を参照。）

一番長くサポートされている API (バージョン履歴とサポートAPI参照) であり、他に利用可能なAPIに比べCADのバージョンアップに伴う影響を受けにくい API といえる。 開発環境として AutoCAD には、Visual LISP という 対話型の開発環境が搭載されているが、IJCAD では特定の開発環境はないため、一般的なテキストエディタによる開発となる。 LISP に最適なエディタとしては括弧の補完機能や字下げ機能があると便利で、以下のようなものがある。

• Notepad ++
• xyzzy や emacs など

以下は、市販エディタ。

• 秀丸 ･･･ ファイル:Acad hilights.zip
• EmEditor
• MIFES など

• ちなみに、AutoLISP は XLISP1.0 からの派生と言われている。>> バージョン履歴とサポートAPI
• AutoCAD の 2.18 より搭載された。
• VisualLISP は、Basis Software, Inc. の Vital LISP を買収したものがベースになっている。

AutoLisp 関数の構文

AutoLisp の構文は非常にシンプルである。以下に例を示す。

解説
上の例では、foo 関数には 1 つの必須引数 string と、1 つの省略可能な引数 number があり、引数 number は追加で指定することができる。一般に、引数の名前は予期されるデータ タイプを表している。 この foo 関数で有効な呼び出しと無効な呼び出しの例をを示す。

• 有効な呼び出し例
  • (foo "catch")
  • (foo "catch" 22)
  • (foo "catch" 22 31)

• 無効な呼び出し例
  • (foo 44 13) ; <- 引数 string が無い
  • (foo "fi" "foe" 44 13)  ; <-引数 number に文字が指定されている
  • (foo)  ; <- 引数が無い。

無効な呼び出しを行うとエラーになり、処理が中断される。

AutoLISP のデータ タイプ

AutoLISP には以下のデータタイプがある。AutoLISPをフル活用するには、データタイプの使い方を理解する事は必須と言っていい。

関数の機能別一覧

以下は関数を分類分けしたもの。他に、目次からのアクセスも便利です。

AutoLISP プログラムの作成

AutoLISP のプログラムは、以下の 3つのファイル形式のうちのいずれかで作成する。

• LSP ファイル(.lsp) ･･･ AutoLISP プログラム コードが記述された ASCII テキスト ファイル。
• FAS ファイル(.fas) ･･･ 1 つの LSP プログラム ファイルのコンパイル済みバイナリ ファイル。
• VLX ファイル(.vlx) ･･･ 1 つ以上の LSP ファイルとダイアログ コントロール言語(DCL)ファイルの両方または一方をコンパイルしたファイル。

• IJCAD では、LSPのみ対応。FASファイルとVLXファイルは利用できない。（2009年10月. IJCAD7 現在）
• IJCAD において、LISPプログラムを秘匿化したい場合は、AutoCAD に搭載されている、PROTECT.EXE か ebatch社（IntelliJAPANの前身）からでていた IJPROLSP.EXE を利用して暗号化する。

AutoCAD では、AutoCAD 2000 以降 Visual LISP (VLISP) 環境が備わりコンパイラ、デバッガ、などを備えた統合開発環境(IDE)を備えているため、その上で AutoLISP プログラムを記述していくことが出来る。

IJCAD では、IDEは備わっていないため、テキストエディタにより記述していく。

また、AutoCAD・IJCAD どちらの環境でも、短い構文は次のようにコマンドプロンプトに直接記述して実行することが出来る。

コマンド: (+ 1 2 3 4 5 )
15   <- 実行結果

AutoLISP プログラムの使用

AutoLISP のプログラム（.lsp のファイル）は、まずそのプログラムをCADへロードする必要がある。

ロードは、コマンド プロンプトに対して load 関数を使用して AutoLISP コードを入力する。 load 関数が正常に終了すると、ファイル内の最後の式の値がコマンド プロンプト領域に表示される。これは通常そのファイルで定義されている最後の関数の名前か、新しくロードされた関数の使用説明となる。

load 関数が失敗すると、AutoLISP のエラー メッセージが表示される。 load 関数の失敗は、AutoLISPファイルのコーディング間違いや、コマンド プロンプトに対して間違ったファイル名を入力した場合に起こる。

load 関数の構文は、次のとおり。

(load filename [onfailure]) 

この構文は、load 関数に 2 つの引数があることを示している。 1つ目の filename は、読み込むAutoLISPファイル名（とパス）で必須。 2つ目の onfailure は省略可能で、失敗した場合のメッセージを入力する。 コマンドラインからの入力で AutoLISP ファイルをロードする場合は通常、filename 引数のみを指定する。

次の例は、AutoLisp ファイル newfile.lsp をロードしている。

コマンド: (load "newfile")

拡張子 .lsp は省略可能。この形式は、現在のライブラリ パス上のどの LSP ファイルに対しても動作する。

ライブラリ パス上にない AutoLisp ファイルをロードする場合は、filename 引数として、ファイル名を絶対パスで指定する必要がある。

コマンド: (load "d:/files/morelisp/newfile")
または
コマンド: (load "d:\\files\\morelisp\\newfile")

注 : フォルダ パスを指定する場合、スラッシュ(/)または 2つの円記号(¥¥)を区切り記号として使用する必要がある。通常Windowsで利用される単一の円記号(¥)での指定は、2つの円記号(¥¥)となる。これは、AutoLisp では単一の円記号(¥)には特別な意味があるため。

• 尚、AutoCADとIJCAD共に LISPファイルを CAD のウィンドウに ドラッグ＆ドロップしても読み込まれる。

自動ロード

• AutoCAD では、パスの通っているフォルダにある acad.lsp があると起動時に読み込み・実行される。また、acaddoc.lsp ファイル があるとファイルを開始するたびに読み込み・実行される。
• システム変数：ACADLSPASDOC を1にすると、図面が開かれるたびに acad.lsp をロードする。
• システム変数：LISPINIT を1にすると、図面が開かれるたび、作成されるたびに LISP環境が初期化される。（SDIモード時に変数値を引き継ぎたいなら0にする）
• IJCAD では、パスの通っているフォルダにある icad.lsp があると、ファイルを開始するたびに読み込み・実行される。

自動ロードファイルはファイルの初期化前に実行されるため、command 関数は使ってはいけない。 AutoCAD の場合は、S::STARTUP 関数に記述する事になっている。

IJCAD で自動ロードする場合の注意点

IJCAD は図面毎に名前空間が分かれていないため、自動ロードで何か初期化を行う処理がある場合、別の図面を開いたときにすでに開いている変数値などが上書きされてしまう可能性があるため、特に複数のファイルにまたがる処理をする場合は注意が必要である。

AutoLISP が使えるCADソフト

製品名	LSP対応	DCL対応	FAS/VLX対応
Ares CAD *1	-	△	-
Ares CAD COMed *1	○	△	-
AutoCAD	○	○	○
AutoCAD LT	-	-	-
BricsCAD	○	○	-
IJCAD	○	○	-
IntelliCAD系CAD	○	△*2	-

• *1…ファイル名8文字＋拡張子だけ。パス指定フルパスのみ。
• *2…日本語の扱いが良くないものが多い。

特殊フォーム

特殊フォームは一般的な AutoLISP 関数呼び出しとは異なる方法で引数を評価する。一般的な関数は、関数に渡されたすべての引数を評価してからそれらの引数に基づいて実行するが、特殊フォームは、すべての引数を評価しないか、または特定の条件の下でのみいくつかの引数を評価する。

以下は特殊フォームとみなされる AutoLISP 関数。

AutoLisp のエラーコード

AutoLISP で生成されるエラー コードの値と意味は次のとおり。AutoLISP の関数呼び出しによって発生したエラーを CAD が検出すると、システム変数 ERRNO に次の値のいずれかが設定される。

(getvar "errno") を使用すると、AutoLISP のアプリケーションで現在の ERRNO の値を検査できる。

システム変数 ERRNO は、ゼロにクリアされない場合があるため、AutoLISP の関数がエラーをレポートした直後に検査しないと、その値が示すエラーは誤っている可能性がある。この変数は、図面を新規作成したり図面を開いたときに、必ずクリアされる。

注:ERRNO の値とその意味は、将来変更される可能性があります。

関連書籍

• AutoCAD AutoLISP 実践ガイド 著者： T.ボスフィールド / 出版： (株)星雲社
• AutoLISP 徹底活用ガイド 著者： 落合重紀 / 出版： (株)翔泳社
• AutoLispの初歩 著者： 岡島正夫 / 出版： 東海大学出版会
• AmazonでAutoLISP書籍を見る