フィルタープラグイン
最初のステップ チュートリアルには procedure プラグインを使用しました。これらのタイプのプラグインは、入力として画像やドローアブルを必要とせずに動作します。通常、画像とそのドローアブルを変更するにはプラグインを使用します。このようなプラグインは、filter プラグインと呼ばれます。
Drawable とは何ですか?
Lumi の 描画可能 は、レイヤーやチャンネルなど、描画できる画像要素を指します。フィルター プラグインは通常、これらの要素に対して動作します。
単純なフィルター プラグインの例
# !/usr/bin/env lumi-scheme-interpreter-0.1
(define (scheme-simple-filter-plug-in image drawables)
;; Use a let statement to define a message variable and core code
(let ((message "hello, world"))
;; Display the message in Lumi's error console
(lumi-message message)
;; Invert the colors of the first selected drawable
(lumi-drawable-invert (vector-ref drawables 0) 1)))
;; Register the plug-in
(scheme-register-filter
"scheme-simple-filter-plug-in" ;; Main procedure name
"Simple Filter Plug-in Demo" ;; The name as it appears in the Lumi menu
"Tests a basic Scheme filter plug-in" ;; Tool-tip description
"Author Name" ;; Give yourself some credit
"License" ;; License
"Date written" ;; Date written
"*" ;; Indicates this plug-in requires an image
SF-ONE-OR-MORE-DRAWABLE) ;; Requires one or more selected drawables
;; Specify the menu location for the plug-in
(scheme-menu-register
"scheme-simple-filter-plug-in"
"<Image>/Plug-in")テキストをコピーし、Lumi のプラグイン フォルダの 1 つにある simple-filter-plug-in という名前のフォルダに simple-filter-plug-in.scm として保存します。 Lumi プラグイン フォルダーは、以下にリストされている_任意の_ フォルダーです。
Lumi > 編集 > 環境設定 > フォルダ > プラグイン
Linux では、simple-filter-plug-in.scm ファイルを右クリックし、プロパティ > アクセス許可 に移動し、ファイルのプログラムとしての実行を許可する にチェックを入れます。ファイルが正しい場所に配置され、実行可能で構文エラーがなければ、Lumi を再起動すると、上部のメニューヘッダーバーの プラグイン というメニュー内にファイルが表示されます。
プラグインの実行
- 画像を開きます (このフィルター プラグインを機能させるには画像が必要です)。
- [Windows] > [ドッキング可能なダイアログ] > [エラー コンソール] を開き、メッセージを確認します。
- プラグイン メニューから シンプル フィルター プラグイン デモ を選択します。
- 選択したレイヤーの 1 つが色反転され、エラー コンソールにメッセージが出力されます。
プラグインの編集
プラグインをカスタマイズするには、.scm ファイルを編集します。たとえば、表示されるメッセージを変更するには、次のようにします。
- ファイルを開き、
messageを定義する行を見つけます。 "hello, world"をカスタム テキストに置き換えます。- ファイルを保存します。
Lumi バージョン 3 では、保存された変更を有効にするためにプラグインを更新する必要はありません。プラグインを再実行するだけで、更新されたメッセージが表示されます。
プラグインの検査
シバンライン
最初の行は、スクリプトが Lumi 3 のプラグインとして動作することを確認します。
# !/usr/bin/env lumi-scheme-interpreter-0.1プロシージャ定義
このプロシージャは、アクティブなイメージと選択されたドローアブルの 2 つの引数を受け入れます。
(define (scheme-simple-filter-plug-in image drawables)コアロジック
let ステートメントは変数を定義し、ドローアブルに対して操作を実行します。
(let ((message "hello, world"))
(lumi-message message) ;; Displays a message in Lumi's error console
(lumi-drawable-invert (vector-ref drawables 0) 1)) ;; Inverts the colors of the first selected drawableプラグインの登録
プラグインはフィルター プラグインとして Lumi に登録されます。
(scheme-register-filter
"scheme-simple-filter-plug-in" ;; Register the main procedure
"Simple Filter Plug-in Demo" ;; The name as it appears in the Lumi menu
"Tests a basic Scheme filter plug-in" ;; Tool-tip description
"Author Name" ;; Author's name
"License" ;; License type
"Date written" ;; Date written
"*" ;; Indicates the plug-in requires an image
SF-ONE-OR-MORE-DRAWABLE) ;; Requires one or more selected drawablesメニュー登録
この行は、プラグインのメニューの場所を指定します。
(scheme-menu-register
"scheme-simple-filter-plug-in"
"<Image>/Plug-in")トラブルシューティング
プラグインが表示されない場合は、その場所、名前、および実行可能プロパティを確認してください。
場所はプラグイン検索パス内にある必要があります。 ファイル名は、ファイルが含まれるフォルダーの名前と一致する必要があります。 ファイルは実行可能ファイルとして設定する必要があります。
エラー コンソールは、カスタム プラグインのトラブルシューティングに役立つツールです。プラグインが期待どおりに動作しない場合は、ここでエラー メッセージまたはログを確認してください。 ターミナル ウィンドウでは、デバッグ情報や読み込みの問題のレポートも提供できます。