0 | SF-IMAGE |
画像依存のスクリプト関数では、この記述が必須です。現在のアクティブなイメージを示します。
パラメータは文字列、数値を書きますが、意味は無いようです。次のように書きます。
SF-IMAGE "Image" 0
|
1 | SF-DRAWABLE |
画像依存のスクリプト関数では、この記述が必須です。現在のアクティブなドローワブルを示します。
ドローワブルは、レイヤーやチャンネルなど描画対象のことです。
パラメータは文字列、数値を書きますが、意味は無いようです。次のように書きます。
SF-DRAWABLE "Drawable" 0
|
5 | SF-COLOR |
ダイアログにカラーボタンを作成します。関数の相当する引数には、カラーの値が与えられます。
パラメータは、ダイアログに表示するラベル文字列、カラーの初期値を与えます。
次のように書きます
SF-COLOR _"Start Color:" '(255 0 255)
Label |
ダイアログに表示するラベル文字列。先頭にアンダーラインをつけて書かれます。
例:
_"Background Color"
|
Initial Value |
カラーボタンの初期値です。三つの要素(R G B) からなるリストを与えます。値の範囲は 0-255 です。
例:
'(255 128 100)
|
|
6 | SF-TOGGLE |
二値スイッチ(チェックボックス)をダイアログに表示し、その結果を関数の相当する引数に与えます。
パラメータは、ダイアログに表示するラベル文字列、スイッチの初期値(0/1)を与えます。
関数に与えられる値は、 0: オフ、1: オン です。
次のように書きます
SF-TOGGLE _"Use Table" TRUE
Label |
ダイアログに表示するラベル文字列。先頭にアンダーラインをつけて書かれます。
例:
_"Power Switch"
|
Initial Value |
スイッチの初期値です。1か、0 の数値を与えます。TRUE(=1)、FALSE(=0)が定義済みなのでこれを使うとわかりやすいでしょう。
例:
TRUE
FALSE
|
|
7 | SF-VALUE |
Schemeの式を入力する項目をダイアログに追加し、その評価値を関数の相当する引数に与えます。
入力した値がSchemeの式として評価されるので、リストなど入力できて便利ですが、一般のユーザーはSchemeを知らないはずなので、公開目的ならば使用しない方が良いと思います。
パラメータは、ラベル文字列、初期値文字列の順で次のように書きます。
SF-VALUE _"Scheme:" "150"
ここで、(list 1 2 3)と入力すると、スクリプト関数には、'(1 2 3) が与えられる。
Label |
ダイアログに表示するラベル文字列。先頭にアンダーラインをつけて書かれます。
例:
_"Eval Expr:"
|
Initial Value |
入力項目の初期値です。この文字列の値が初期値として表示されます。
"123" ← 「123」(数値)が初期値
"abc" ← 「abc」(シンボル)が初期値
"\x22start\x22" ← 「"abc"」(文字列)が初期値。
|
|
8 | SF-STRING |
文字列入力ボックスをダイアログに追加し、その値を関数の引数に与えます。
入力した値がそのまま文字列の値となるので、文字列入力が必要な場合は、通常はこの処理を利用します。
パラメータはラベル文字列と、初期値文字列です。次のように書きます。
SF-STRING "YourName:" "algo sampodo"
Label |
ダイアログに表示するラベル文字列。先頭にアンダーラインをつけて書かれます。
例:
_"YourName"
|
Initial Value |
入力項目の初期値です。この文字列の値が初期値として表示されます。
"123" ← "123"(文字列)が初期値
"abc" ← "abc"(文字列)が初期値
|
|
9 | SF-ADJUSTMENT |
数値入力項目をダイアログに追加し、その数値をスクリプト関数の相当する引数に与えます。
入力項目は、スライダーとスピンボックスの二つの形状を選べます。
パラメータの第一項目がラベル文字列、第二項目に細かいパラメータ数値をリストにして与えます。
次のように書きます。
SF-ADJUSTMENT _"Length" '(30 0 256 1 10 1 1)
Label |
ダイアログに表示するラベル文字列。先頭にアンダーラインをつけて書かれます。
例:
_"YourName"
|
Param |
各パラメータをリスト形式で指定します。すべて数値で7項目あります。
value | 初期値 |
lower | 最小値 |
upper | 最大値 |
step-inc | 最小増分 |
page-inc | PageUp/PageDownなど大きく動かすときの増分 |
digit | 小数点以下の桁数 |
type | 形状:スライダーは 0、スピンボックスは 1を指定する。 |
|
|
10 | SF-FONT |
フォントを選択する項目をダイアログに追加して、その値をスクリプト関数の相当する引数に返します。
返される値はフォント名を表す文字列です。
パラメータは、ラベル、フォント名の初期値(文字列)で次のように書きます。
SF-FONT _"Select Font:" "Sans"
Label |
ダイアログに表示するラベル文字列。先頭にアンダーラインをつけて書かれます。
例:
_"Font:"
|
Fontname |
デフォルトで与えるフォント名です。文字列です。
|
|
11 | SF-PATTERN |
パターンを選択する項目をダイアログに追加し、スクリプト関数の相当する引数にパターン名称を割り当てます。
パラメータは、ラベル文字列、パターン名の初期値の順で次のように書きます。
SF-Pattern: _"Pattern:" "Electric Blue"
Label |
ダイアログに表示するラベル文字列。先頭にアンダーラインをつけて書かれます。
例:
_"Font:"
|
Pattern-name |
デフォルトで与えるパターン名です。文字列です。
最初に組み込まれているパターンの名称は次のとおりです。
"3D Green" | "Amethyst" | "Big Blue" | "Blue Grid" |
"Blue Squares" | "Blue Web" | "Bricks" | "Burlap" |
"Burlwood" | "Chocolate Swirl" | "Cork board" | "Crack" |
"Craters" | "Crinkled Paper" | "Dried mud" | "Electric Blue" |
"Fibers" | "Granite #1" | "Ice" | "Java" |
"Leather" | "Leopard" | "Lightning" | "Maple Leaves" |
"Marble #1" | "Marble #2" | "Marble #3" | "Nops" |
"One Small Step..." | "Paper" | "Parque #1" | "Parque #2" |
"Parque #3" | "Pastel Stuff" | "Pine" | "Pine?" |
"Pink Marble" | "Pool Bottom" | "Qbert" | "Rain" |
"recessed" | "Red Cubes" | "Rocks" | "Sky" |
"Slate" | "Small Squares" | "Starfield" | "Stone" |
"Stripes" | "Stripes Fine" | "Terra" | "Tree Bark" |
"Walnut" | "Warning!" | "Wood" | "Wood #1" |
"Wood #2" | "Wood of some sort" |
|
|
12 | SF-BRUSH |
ブラシ選択をダイアログに追加し、選択の結果をスクリプト関数の相当する引数に返します。
パラメータはラベル文字列、ブラシの初期値の順で書きます。
引数に返される値、および、初期値は、リストの形式(ブラシ名 opacity interval mode)になっています。
SF-BRUSH _"Brush" '("Circle (01)" 1.0 1.0 0)
Label |
ダイアログに表示するラベル文字列。先頭にアンダーラインをつけて書かれます。
例:
_"Font:"
|
Param |
ブラシ記述です。関数に返されるのもこの形式です。 <
リストの形で、ブラシ名 opacity interval mode の順に並びます。
brush | string | ブラシの名称。デフォルトで組み込まれているブラシは次のとおり。
"animated Confetti" | "Calligraphic Brush" |
"Calligraphic Brush#1" | "Calligraphic Brush#2" |
"Calligraphic Brush#3" | "Circle (01)" |
"Circle (03)" | "Circle (05)" |
"Circle (07)" | "Circle (09)" |
"Circle (11)" | "Circle (13)" |
"Circle (15)" | "Circle (17)" |
"Circle (19)" | "Circle Fuzzy (03)" |
"Circle Fuzzy (05)" | "Circle Fuzzy (07)" |
"Circle Fuzzy (09)" | "Circle Fuzzy (11)" |
"Circle Fuzzy (13)" | "Circle Fuzzy (15)" |
"Circle Fuzzy (17)" | "Circle Fuzzy (19)" |
"Confetti" | "Diagonal Star (11)" |
"Diagonal Star (17)" | "Diagonal Star (25)" |
"Felt Pen" "Galaxy (AP)" | "Galaxy, Big" |
"Galaxy, Small (AP)" | "Pencil Sketch" |
"Pencil Sketch#1" | "Pencil Sketch#2" |
"Pepper" | "pixel (1x1 square)" |
"Sand Dunes (AP)" | "Sparks" |
"square (10x10)" | "square (10x10) blur" |
"square (20x20)" | "square (20x20) blur" |
"square (5x5)" | "square (5x5) blur" |
"Vine" |
|
opacity | number | 不透明率(0.0〜100.0) |
interval | number | ブラシ間隔。ブラシの高さに対する%。(1.0〜200.0) |
mode | number | 描画モードを指定します。
0 | NORMAL-MODE | 標準 |
1 | DISSOLVE-MODE | ディザ合成 |
2 | BEHIND-MODE | 後ろ |
3 | MULTIPLY-MODE | 乗算 |
4 | SCREEN-MODE | スクリーン |
5 | OVERLAY-MODE | オーバーレイ |
6 | DIFFERENCE-MODE | 差の絶対値 |
7 | ADDITION-MODE | 加算 |
8 | SUBTRACT-MODE | 減算 |
9 | DARKEN-ONLY-MODE | 比較(暗) |
10 | LIGHTEN-ONLY-MODE | 比較(明) |
11 | HUE-MODE | 色相 |
12 | SATURATION-MODE | 彩度 |
13 | COLOR-MODE | 色 |
14 | VALUE-MODE | 明度 |
15 | DIVIDE-MODE | 除算 |
16 | DODGE-MODE | 覆い焼き |
17 | BURN-MODE | 焼き込み |
18 | HARDLIGHT-MODE | ハードライト |
19 | SOFTLIGHT-MODE | ソフトライト |
20 | GRAIN-EXTRACT-MODE | 微粒取り出し |
21 | GRAIN-MERGE-MODE | 微粒結合 |
22 | COLOR-ERASE-MODE | 色消しゴム |
|
|
|
13 | SF-GRADIENT |
グラデーション選択項目をダイアログに追加し、スクリプト関数の相当する引数にグラデーション名(文字列)割り当てます。
パラメータは、ラベル文字列、初期グラデーション名の順で、次のように書きます。
SF-GRADIENT _"Gradient:" "Browns"
Label |
ダイアログに表示するラベル文字列。先頭にアンダーラインをつけて書かれます。
例:
_"Gradient:"
|
Gradient-name |
デフォルトで与えるグラデーション名です。文字列です。
最初に組み込まれているグラデーションの名称は次のとおりです。
"描画色から透明" |
"描画色から背景色 (HSV 時計回り)" |
"描画色から背景色 (HSV 反時計回り)" | "描画色から背景色 (RGB)" |
"Abstract 1" | "Abstract 2" | "Abstract 3" |
"Aneurism" | "Blinds" | "Blue Green" |
"Browns" | "Brushed Aluminium" | "Burning Paper" |
"Burning Transparency" | "Caribbean Blues" | "CD" |
"CD Half" | "Coffee" | "Cold Steel" |
"Cold Steel 2" | "Crown molding" | "Dark 1" |
"Deep Sea" | "Default" | "Flare Glow Angular 1" |
"Flare Glow Radial 1" | "Flare Glow Radial 2" | "Flare Glow Radial 3" |
"Flare Glow Radial 4" | "Flare Radial 101" | "Flare Radial 102" |
"Flare Radial 103" | "Flare Rays Radial 1" | "Flare Rays Radial 2" |
"Flare Rays Size 1" | "Flare Sizefac 101" | "Four bars" |
"French flag" | "French flag smooth" | "Full saturation spectrum CCW" |
"Full saturation spectrum CW" | "German flag" | "German flag smooth" |
"Golden" | "Greens" | "Horizon 1" |
"Horizon 2" | "Incandescent" | "Land 1" |
"Land and Sea" | "Metallic Something" | "Mexican flag" |
"Mexican flag smooth" | "Nauseating Headache" | "Neon Cyan" |
"Neon Green" | "Neon Yellow" | "Pastel Rainbow" |
"Pastels" "Purples" | "Radial Eyeball Blue" | "Radial Eyeball Brown" |
"Radial Eyeball Green" | "Radial Glow 1" | "Radial Rainbow Hoop" |
"Romanian flag" | "Romanian flag smooth" | "Rounded edge" |
"Shadows 1" | "Shadows 2" | "Shadows 3" |
"Skyline" | "Skyline polluted" | "Square Wood Frame" |
"Sunrise" | "Three bars sin" | "Tropical Colors" |
"Tube Red" | "Wood 1" | "Wood 2" |
"Yellow Contrast" | "Yellow Orange" |
|
|
14 | SF-FILENAME |
ファイル名入力項目をダイアログに追加し、ファイル名をスクリプト関数の対応する引数に割り当てます。
パラメータは、ラベル文字列、初期ファイル名の順で次のように書きます。
SF-FILENAME _"SrcFilename" "e:\\00temp\\test.jpg"
Label |
ダイアログに表示するラベル文字列。先頭にアンダーラインをつけて書かれます。
例:
_"SrcFileName"
|
filename |
ファイル名の初期値です。
|
|
15 | SF-DIRNAME |
ディレクトリ名入力項目をダイアログに追加し、ディレクトリ名をスクリプト関数の対応する引数に割り当てます。
パラメータは、ラベル文字列、初期ディレクトリ名の順で次のように書きます。
SF-FILENAME _"SrcDirectory" "e:\\00temp\\mydata"
Label |
ダイアログに表示するラベル文字列。先頭にアンダーラインをつけて書かれます。
例:
_"DirName"
|
dirname |
ディレクトリ名の初期値です
|
|
16 | SF-OPTION |
複数の選択肢からひとつを選ぶ項目をダイアログに追加して、選択結果をスクリプト関数の対応する引数に渡します。
選択結果は、選ばれたオプションの番号です(先頭が0)。
パラメータは、ラベル文字列、オプションのリスト(各要素は文字列)の順で次のように書きます。
SF-OPTION _"City" '("Tokyo" "Ohsaka" "Nagoya")
この例で、Ohsaka を選ぶと数値 1 が引数に与えられます。
Label |
ダイアログに表示するラベル文字列。先頭にアンダーラインをつけて書かれます。
例:
_"SelectIt:"
|
options |
選択肢を表す文字列からなるリストです。要素の数は2つ以上、任意に書けます。
|
|
17 | SF-PALETTE |
パレット選択をする項目をダイアログに追加し、選択結果をスクリプト関数の対応する引数に渡します。
引数に渡されるのは、パレット名を表す文字列です。
パラメータは、ラベル文字列、パレット名初期値文字列の順で次のように書きます。
SF-PALETTE _"Palette" "Default"
Label |
ダイアログに表示するラベル文字列。先頭にアンダーラインをつけて書かれます。
例:
_"New Palette:"
|
palette-name |
文字列。パレットの名称です。
デフォルトで組み込まれているのパレットは次のとおりです。
"Bears" | "Bgold" | "Blues" | "Borders" |
"Browns And Yellows" | "Caramel" | "Cascade" | "China" |
"Coldfire" | "Cool Colors" | "Cranes" |
"Dark pastels" |
"Default" | "Ega" | "Firecode" | "Gold" |
"Grayblue" | "Grays" | "GrayViolet" | "Greens" |
"Hilite" | "Khaki" | "Lights" | "Muted" |
"Named Colors" | "News3" | "Op2" | "Paintjet" |
"Pastels" | "Plasma" | "Reds" | "Reds And Purples" |
"Royal" | "Tango Icon Theme" | "Topographic" | "Visibone" |
"Visibone 2" | "Volcano" | "Warm Colors" | "Web" |
|
|
19 | SF-ENUM |
ダイアログに列挙型リストの選択項目をダイアログに追加し、スクリプト関数の引数にに選択した番号を割り当てます。
列挙型は登録済のものに限られ、その名前の先頭の「Gimp」を取り除いた文字列で指定します。
パラメータは、文字列ラベルと、列挙型名文字列、初期値文字列のリストで次のように書きます。
(SF-ENUM _"IntePolation" '("InterpolationType" "linear")
現状では上記のInterpolationType以外の登録がわからないので、使えないでいます。
type of interpolation
INTERPOLATION-NONE (0)
INTERPOLATION-LINEAR (1)
INTERPOLATION-CUBIC (2)
INTERPOLATION-LANCZOS (3) }
|