フィルタの書式 のバックアップソース(No.3)

• バックアップ一覧
• 差分 を表示
• 現在との差分 を表示
• フィルタの書式 へ行く。
  • 1 (2004-11-14 (日) 01:33:50)
  • 2 (2004-11-14 (日) 04:08:13)
  • 3 (2004-11-15 (月) 00:40:07)
  • 4 (2004-11-16 (火) 01:15:31)
  • 5 (2004-11-17 (水) 03:00:03)
  • 6 (2004-11-17 (水) 23:58:21)
  • 7 (2005-06-07 (火) 23:29:23)

#contents

**AviSynthのマニュアル [#b5a3942a]
AviSynthのフィルタのマニュアルは、たいていの場合、以下のような順番で書かれています。

 書式
 
 説明
 
 使用例（ない場合もある）

まず、フィルタ（関数）の書式（フォーマット）、そして、そのフィルタの説明、最後にフィルタの使用例があります。フィルタによっては、使用例がない場合もあります。

たとえば、MessageClipフィルタのマニュアル((http://www.avisynth.org/MessageClipから転載。))を見てみると、次のように書かれています。

>MessageClip(string message, int width, int height, bool shrink, int text_color, int halo_color, int bg_color)~
~
MessageClip produces a clip containing a text message; used internally for error reporting. Arial font is used, size between 24 points and 9 points chosen to fit, if possible, in the width by height clip.~
~
If shrink is true, the clip resolution is then reduced, if necessary, to fit the text.~

1行目のMessageClip(string message, ...)までがMessageClipフィルタの書式です。それ以降は、同フィルタの説明です。MessageClipフィルタの場合、使用例はありません。

**フィルタの書式 [#ccbc90c4]
フィルタの書式は、
 フィルタ名(引数リスト)
という形で表されます。

たとえば、MessageClipフィルタの場合は、次のように記されていました。
 MessageClip(string message, int width, int height, bool shrink, int text_color, int halo_color, int bg_color)
このとき、MessageClipがフィルタ名、括弧の中に書かれているのが引数リストということになります。

 引数型 引数名
引数リストは、このように、引数型と引数名が、対の形で記述されています。((例外的に、clip型の引数clipがある場合に、一方を省略して、単にclipと書かれていることもあります。))引数型は、その引数がどのようなタイプのものであるかを示すものであり、引数名はその引数の名前を表します。

 string message
MessageClipの1つ目の引数の場合、stringが引数の型で、messageが引数の名前です。言い換えると、1つ目の引数は、messageという名前で、その引数型はstring型である、ということになります。

 フィルタ名(引数型1 引数名1, 引数型2 引数名2, 引数型3 引数名3, ...)

引数が複数ある場合は、コンマ区切りで、つづけて書きます。引数の数は、フィルタによって異なります。

つまり、MessageClipフィルタの場合、message、width、height、shrink、text_color、halo_color、bg_colorという7つの引数があり、引数messageはstring型、引数shrinkはbool型で、それ以外の引数はint型であるというわけです。

**引数型 [#y6f1ed10]
AviSynthで使用される引数型は、以下の通りです。

|~clip型|クリップ。省略した場合、最後に処理したクリップ（last）が適用される。|
|~int型|整数。integer（整数）の略。フィルタによって指定できる範囲が異なる。頭に$を付けることで16進数で指定することも可能。（例）$ff = 255。|
|~float型|小数。floating-point number（浮動小数点数）の略。 フィルタによって指定できる範囲が異なる。|
|~bool型|論理型（boolean）。true（真）、または、false（偽）のいずれかを指定する。|
|~string型|文字列。二重引用符（"）で囲む形で記述する。|

**フィルタの記述例 [#sfef351e]
MessageClipフィルタを例に、フィルタを記述する方法を紹介します。ここでは、「Hello World!」というメッセージつきのビデオクリップを作成します。

//***すべての引数を指定したとき
// MessageClip("Hello World!", 240, 135, true, $0000ff, $ff0000, $00ff00)

***引数を省略したとき [#g2fbd023]
 MessageClip("Hello World!")
message以外の引数は省略されています。引数が省略された場合は、デフォルト値が適用されます。~
~
&ref{hello001_hello_world.png};~
そのため、上のスクリプトをプレビューすると、このような画像が表示されます。

//***名前付き引数で指定したとき
// MessageClip("Hello World!", text_color=$0000ff, halo_color=$ff0000, bg_color=$00ff00)