Photoshop フィルター開発入門 -- Photoshop コールバック関数

前回の記事では、Photoshop フィルター プラグインを開発するための最も基本的な概念と基礎をいくつか紹介しました。 Ps プラグインのアプリケーションのニーズを満たすために、プラグイン用の多数のコールバック関数 (またはサービス) も提供されます。たとえば、フィルターは、通話後に最新のユーザーが設定したパラメーターを保存し、次の通話または UI の表示に適用できます。これは、Ps のコールバック関数を通じて行われます。この記事では、最も重要な PS コールバック関数のいくつかについて説明します。この記事を理解すると、コールバック関数を使用して、フィルター パラメーターの保存などの必要な作業を完了できるようになります。この記事は最初の記事よりもはるかに複雑で詳細なものになりますが、同時に、この記事からは、慎重なシステム設計、完璧なインターフェイス、複雑な動作メカニズムなど、PS の内部秘密を垣間見ることもできます。

(1) コールバック関数の分類:
Ps のコールバック関数は、取得場所により 2 種類に分けられます:
(1) Direct Callback: (直接呼び出せるコールバック関数)
これらのコールバック関数は FilterRecord Direct メンバーであり、FilterRecord パラメーターから直接取得できます。たとえば、AdvanceStateProc (データの更新)、TestAbortProc (テスト ユーザーのキャンセル) などがこのカテゴリに分類されます。
（2）コールバックスイート：（コールバック関数セット）
- ボディ（struct）、filterRecordから特定のコールバック関数セットを取得し、その中の関数を呼び出すことができます。 MP OutCemp OutMP Out Out Out oftototototototototomp Outforce Outforce Part Universityアカウント大学クエスト
UI Hook Suite: UI 操作に関する機能群。
チャネル ポート スイート: チャネル ポートの読み取りと書き込み。PS 内の実際の選択データの読み取りと書き込みに使用されます。コピーコピーの代わりに。
記述子スイート: スクリプト記録システムに使用される記述子操作セット。これ自体に「読み取り」と「書き込み」の 2 つのサブスイート (サブ機能セット) が含まれています。

Color Space Suite: カラースペースサービス (カラー変換など)。
ハンドル スイート: ハンドル管理 (PS カプセル化されたハンドルとメモリ管理、バッファ スイートと同様)。 エラー スイート: エラー メッセージを受信して​​ユーザーに表示します (さまざまな種類のエラー メッセージ文字列を受信します)。 GetFileList スイート: ファイル リストを取得します (ファイルを取得する、ブラウザーを呼び出して Web を閲覧するなど)。
GetPath Suite: パスを取得します。
ZString Suite: 文字列処理をカプセル化します。 O たとえば、UI HOOK Suite は、UI に関連する一連のコールバック関数を提供します。最初のバージョンは次のように定義されました:

UI Hooks Suite Version1
#define kPSUIHooksSuiteVersion1 1 // スイートバージョン eTypeDef Struct
{ processeventProc processevent; ProgressProc プログレスバー MAINAPPWINDOWIWPROC MAINAPPWINDOW; HosttickCountProc TickCo; unt;
PluginnamePluginname;




いくつかのコールバックに注意してください。関数は直接コールバックであり、testAbout や displayPixels などのスイートに保存されます。初期の頃は、これらの関数ポインターが FilterRecord に追加されていたと推測しますが、アップグレードとともにコールバック関数がどんどん追加され、FilterRecord が継続的にアップグレードしてメンバーを追加することになり、メンテナンスが困難になるため、Adobe はコールバック関数を追加し始めました。分類はいくつかのスイートに分割され、そのスイートのみが FilterRecord に配置されます。このように、関数を追加するときは、それを対応するスイートに追加し、FilterRecord に影響を与えることなくスイートをアップグレードするだけで済みます。このように、一部の初期コールバック関数は、FilterRecord とそれらが属するスイートの 2 つの場所に同時に配置され、直接呼び出すことも、対応するスイートを通じて呼び出すこともできます。


(2) Suite PEA (プラグイン関数セット管理モジュール(レイヤー)、私の翻訳名、検討中)
Suite PEA は、一部の Adob​​e シリーズのソフトウェアで使用されるプラグイン システムです。ホスト プログラムの管理 コア層は、プラグインの標準インターフェイスを提供します。有 直接呼び出しは少し異なります。使用前に関数セットを使用してリクエストを取得し、使用後にスイートを解放する必要があります。したがって、次の形式でコールバック関数セット内の関数を呼び出します:

スイートの取得とリリース
ADMBasicSuite *sADMBasic;

/ /ADMBasic Suite を取得:
filterParamBlock->sSPBasic->AcquireSuite( ,
kA DMBasicSuiteVersion、
//
電話

sADMBasic- ＆gt;beep（）;

（3）より重要なコールバック関数のいくつかの紹介これらのコールバック関数の場所と使用法を簡単に紹介します。

3.1
DisplayPixelsProc( ) 機能: 指定されたDC上の指定された位置のピクセルデータを出力(絵を描く)します。 (もちろん、この関数は実際に自分で完成させることもできます。) 場所: ダイレクト コールバック、UI フック スイート; 定義:

OSERr (*DisplayPixelsProc) (const PSPixelMap *source,
const VRect *srcRect、int32 dstRow、int32 dstCol、 ️次のように定義されるポインター:
PSPixelMap Struct Define



Actipro CodeHighlighter (フリーウェア) によって生成されたコードの強調表示
//m.sbmmt.com/

-->typedef
struct //記述子パラメータ構造を取得します:
PIDescriptorParameters* descParams =gFilterRecord - >descriptorパラメータ;
if (descParams == NULL) return err;

// "read" サブ関数セットを取得します:
Read DescriptorProcs * readProcs =gFilterRecord->descriptorParameters->readDescriptorProcs;
if(readProcs == NULL) return err;

/ /「書き込み」サブ関数セットを取得します:
WriteDescriptorProcs* writeProcs = gFilterRecord-> descriptorParameters -> writeDescriptorProcs;
if (writeProcs == NULL) return err;

structReadDescriptorProcs
{//Write サブ関数セット メンバー, 形式は前の関数と似ていますが、どちらも追加のキーが必要です
typedef struct WriteDescriptorProcs
{
int16 writeDescriptorProcsVersion;
int16 numWriteDescriptorProcs;
OpenWriteDescriptorProc openWriteDescriptorProc;
CloseWriteDescriptorProc closeWriteDescriptorProc;
PutIntegerProc putIntegerProc;
PutFloatProc putFloatProc;
PutUnitFloatProc putUnitFloatProc;
PutBooleanProc putBooleanProc;
PutTextProc putTextProc;
PutAliasProc putAliasProc;
PutEnumeratedProc putEnumeratedProc;
Put ClassProc putClassProc;
PutSimpleReferenceProc putSimpleReferenceProc ;
PutObjectProc putObjectProc;
PutCountProc putCountProc;

/* Scoped クラスは Photoshop 4.0 のプラグインでは使用できません */ PutScopedClassProc putScopedClassProc;
PutScopedObjectProc putScopedObjectProc
} WriteDescriptorProcs;
️パラメータのデモ コードを読む