パラメータ指定子

スクリプトの先頭などにコメント形式の指定子を書くと、パラメータパネルのトラックバーや チェックボックス、色の名前・範囲・既定値を定義できます。指定子は -- で始まる コメント行なので、Lua の実行には影響しません。

指定子は必須ではありません。-- の行を書かなくても、 トラックバーの値は obj.track0obj.track3 で読めます。 チェックボックスの obj.check0obj.check3color も、 スクリプト中で参照すればパネルに現れて使えます。指定子は、名前や範囲・既定値を整えたいときに使います。
エンジンを選ぶ --!native などの指定子は別物です。先頭が --! で始まります。 エンジンの指定はエンジンと高速化を参照してください。

トラックバー

--track0:--track3: で、各トラックバーの名前・範囲・既定値・増分を指定します。 書式はカンマ区切りです。

--track0:振幅,0,200,50
--track1:周波数,0,10,1,0.1
項目位置省略時
名前1 番目
最小値2 番目0
最大値3 番目100
既定値4 番目最小値
増分5 番目0

最大値が最小値より小さい場合は自動で入れ替わり、既定値は範囲内にクランプされます。 値はスクリプトから obj.track0obj.track3 で読めます。

チェックボックス

--check0:--check3: で、名前と既定値(0 で off、0 以外で on)を指定します。 値は obj.check0obj.check3 で読めます。

--check0:反転を有効にする,0
項目位置省略時
名前1 番目
既定値2 番目0(off)

--color: で Color パラメータの既定色を指定します。 0xRRGGBB 形式または 10 進整数で書けます。値はグローバルの color で読めます。

--color:0xFF8800

表示条件

パラメータの表示・非表示は次のルールで決まります。

セクション(@)

行頭が @ の行はセクションの区切りです。セクションを使う場合、 指定子と本文は最初のセクションから読み取られます。通常のスクリプトでは @ を使わず、 指定子をスクリプト先頭にコメントとして並べれば十分です。

AviUtl 互換の宣言(dialog / param)

--dialog:--param: は、AviUtl のダイアログ変数に近い書き方で、 本文の先頭に Lua の宣言を差し込みます。差し込まれた行は本体より前に実行されます。

指定子説明
--param:宣言指定した宣言を本文の先頭に追加する
--dialog:ラベル,宣言; ...; 区切りの各項目について、最初の , の後ろを宣言として先頭に追加する
--param:local speed = 90
obj.rz = time * speed

AviUtl 互換マップの対象エンジン

obj.effect が参照する互換マップの対象エンジンを切り替えます。 指定子 --!aviutl または --!aviutl2 を書くと、 そのエンジンに対応するエフェクトだけを解決します。 指定子を書かないときは --!aviutl として扱います。詳細は obj の関数を参照してください。

--!aviutl2
obj.effect("ぼかし", "範囲", 20)
← エンジンと高速化 サンプル集 →