Einführung in die Photoshop-Filterentwicklung – Photoshop-Rückruffunktion-PS-Tutorial-php.cn

Im vorherigen Artikel haben wir einige der grundlegendsten Konzepte und Grundlagen für die Entwicklung von Photoshop-Filter-Plug-Ins vorgestellt. Ps: Um die Anwendungsanforderungen des Plug-Ins zu erfüllen, werden auch zahlreiche Rückruffunktionen (oder Dienste) für das Plug-In bereitgestellt. Beispielsweise kann ein Filter die vom letzten Benutzer nach einem Anruf eingestellten Parameter speichern und beim nächsten Aufruf oder der nächsten Anzeige der Benutzeroberfläche anwenden. Dies geschieht über die Callback-Funktion von Ps. In diesem Artikel erklären wir einige der wichtigsten PS-Callback-Funktionen. Nachdem wir diesen Artikel verstanden haben, werden wir in der Lage sein, Rückruffunktionen zu verwenden, um die notwendigen Arbeiten abzuschließen, wie zum Beispiel das Speichern unserer Filterparameter. Dieser Artikel wird viel komplexer und ausführlicher sein als der erste, aber gleichzeitig können wir durch diesen Artikel auch einen Einblick in die internen Geheimnisse von PS erhalten: sorgfältiges Systemdesign, perfekte Benutzeroberfläche und komplexe Arbeitsmechanismen.

(1) Klassifizierung von Rückruffunktionen:
Ps-Rückruffunktionen können entsprechend ihrer Position in zwei Typen unterteilt werden:
(1) Direkter Rückruf: (kann Direkt aufgerufen werden Rückruffunktionen)
Diese Rückruffunktionen sind direkte Mitglieder von FilterRecord und können direkt aus den FilterRecord-Parametern abgerufen werden. In diese Kategorie fallen beispielsweise AdvanceStateProc (Daten aktualisieren), TestAbortProc (Testbenutzerabbruch) usw.
(2) Callback Suite: (Callback-Funktionssatz)
Der Callback-Funktionssatz, der durch die Klassifizierung von Callback-Funktionen nach ihren Funktionen bereitgestellt wird, ist ein Satz von Callback-Funktionen. Es handelt sich um einen Zeiger, der auf einen Satz von Callback-Funktionen zeigt. Mit der Struktur (Struktur) der Rückruffunktion können wir einen bestimmten Rückruffunktionssatz von FilterRecord abrufen und dann die darin enthaltene Funktion aufrufen.

Die wichtigsten derzeit bereitgestellten Callback-Funktionssätze sind:
Buffer Suite: Cache-Speicherverwaltung (Anwendung und Freigabe von Cache-Speicherplatz).
UI Hook Suite: Eine Reihe von Funktionen im Zusammenhang mit UI-Operationen.
Channel Ports Suite: Lesen und Schreiben von Channel-Ports, zum Lesen und Schreiben der echten Auswahldaten in PS! Anstelle einer Kopiekopie.
. Color Space Suite: Farbraumdienst (Farbkonvertierung usw.).
Handle Suite: Handle-Verwaltung (PS-gekapselte Handle- und Speicherverwaltung, ähnlich der Buffer Suite).
Error Suite: Fehlermeldungen empfangen und den Benutzern anzeigen (empfängt verschiedene Arten von Fehlermeldungszeichenfolgen).
GetFileList Suite: Rufen Sie eine Dateiliste ab (Dateien abrufen, Browser aufrufen, um im Internet zu surfen usw.).
GetPath Suite: Holen Sie sich den Pfad.
ZString Suite: Kapselt die String-Verarbeitung.

Beispielsweise bietet die UI Hook Suite eine Reihe von Rückruffunktionen im Zusammenhang mit der Benutzeroberfläche. Die erste Version wurde wie folgt definiert:

UI Hooks Suite Version1

Bitte beachten Sie, dass einige Rückruffunktionen direkte Rückrufe sind und in einer Suite gespeichert sind. wie testAbout und displayPixels. Ich vermute, dass diese Funktionszeiger in den frühen Tagen zu FilterRecord hinzugefügt wurden, aber mit dem Upgrade wurden immer mehr Rückruffunktionen hinzugefügt, was dazu führte, dass FilterRecord kontinuierlich aktualisiert und Mitglieder hinzugefügt wurde, was die Wartung erschwerte, sodass Adobe begann, Rückruffunktionen hinzuzufügen Die Klassifizierung ist in mehrere Suiten unterteilt, und nur die Suite wird in FilterRecord platziert. Auf diese Weise müssen Sie beim Hinzufügen einer Funktion diese nur der entsprechenden Suite hinzufügen und die Suite aktualisieren, ohne dass sich dies auf FilterRecord auswirkt. Auf diese Weise befinden sich einige frühe Rückruffunktionen gleichzeitig an zwei Orten: FilterRecord und der Suite, zu der sie gehören, sodass sie direkt oder über die entsprechende Suite aufgerufen werden können.

(2) Suite PEA (Plug-in-Funktionssatz-Verwaltungsmodul (Ebene), der von mir übersetzte Name unterliegt der Diskussion)
Suite PEA ist ein verwendetes Plug-in-System von einigen Programmen der Adobe-Serie bereitgestellt. Es bietet eine gemeinsame Plug-In-Verwaltungskernschicht für das Host-Programm und eine Standardschnittstelle für Plug-Ins.
Der kleine Unterschied zum Direktaufruf besteht darin, dass der Funktionssatz vor der Verwendung erworben (Acquired) und die Suite nach der Verwendung freigegeben (Release) werden sollte.
Ein erhaltener Funktionssatz ist im Wesentlichen ein Strukturzeiger, der auf eine Struktur zeigt, die einen Satz von Funktionszeigern enthält. Wenn wir also eine Funktion aufrufen, sieht die Form wie folgt aus:
sSuite->function( );
Daher erfolgt der Aufruf einer Funktion im Callback-Funktionssatz wie folgt:

Suite的获取和释放

(3) Einführung in einige der wichtigeren Rückruffunktionen

Als Nächstes stellen wir einige Rückruffunktionen vor, die meiner Meinung nach wichtiger sind Filter-Plugins. Stellen Sie kurz den Speicherort und die Verwendung dieser Rückruffunktionen vor.
3.1 DisplayPixelsProc( )
Funktion: Pixeldaten ausgeben (ein Bild zeichnen) an der angegebenen Position auf dem angegebenen DC. (Natürlich können wir diese Funktion tatsächlich selbst ausführen.)
Ort: Direct Callback, UI Hook Suite;
Definition:
OSErr (*DisplayPixelsProc) (const PSPixelMap *source ,
const VRect *srcRect, int32 dstRow, int32 dstCol,
unsigned32 platformContext); Zeiger, der wie folgt definiert ist:

PSPixelMap Struct Define

PIDescriptorParameters Struct Define

Get the „read“ and „write“ sub-suite

Nachdem wir zwei Unterfunktionssätze erhalten haben, können wir die Funktionen unter den entsprechenden Unterfunktionssätzen aufrufen, um unsere Parameter zu „lesen“ und „zu schreiben“. Die Verwendung der beiden Unterfunktionssätze ähnelt der Registrierungsoperation. Vor dem Lesen und Schreiben müssen wir zunächst den entsprechenden Deskriptor öffnen. Deshalb stellen wir zunächst die öffnenden und schließenden Deskriptoroperationen vor.
                                                                       , wir werden es verwenden, um Daten in nachfolgenden Vorgängen zu lesen und zu schreiben, ähnlich dem Schlüssel der Registrierung. DescriptorKeyIDArray: uint32-Array, das die Schlüsselsammlung speichert, die abgefragt werden muss. Die zugehörige Definition lautet: orKeyIDArray[];

Die Elemente im Array sind die Schlüsselnamen, die Sie benötigen, also die Parameternamen, die Sie abfragen möchten, also welche Schlüssel Sie abfragen möchten. Beachten Sie, dass jeder Schlüssel einen ASCII-Code enthalten kann, der durch 4 Zeichen dargestellt wird, da es sich um einen int32-Typ handelt. Wenn er weniger als 4 Bytes lang ist, kann er mit Leerzeichen gefüllt werden. Durch Festlegen dieser Parameterzuweisung kann beispielsweise {'Pam1','Pam2',NULL} festgelegt werden, was bedeutet, dass Sie zwei Parameter abfragen müssen, 'Pam1' und 'Pam2'. Im Skriptsystem lautet der Schlüssel des Gaußschen Weichzeichnungsfilters (
GaussianBlur
) beispielsweise „
GsnB“.
Jeder Schlüsselwert wird durch den Aufruf von GetKeyProc() abgerufen. Jedes Mal, wenn ein Wert zurückgegeben wird, wird der entsprechende Schlüssel in diesem String-Array auf leer gesetzt ('.Diese Funktion schließt einen Schreibdeskriptor und erstellt ein neues Deskriptorhandle. Sie müssen den neuen Deskriptor auf PIDescriptorParameteres setzen, um ihn an das Hostprogramm zurückzugeben. Das Verhalten der Funktion ähnelt hier in gewisser Weise dem von SelectObject in GDI-Vorgängen. Wenn Sie bei einem GDI-Vorgang neue Eigenschaften für den Gerätekontext festlegen, werden die vorhandenen Eigenschaften an Sie zurückgegeben und es wird erwartet, dass Sie eine Sicherung erstellen.

                                                                                                                                                                                      Ich werde sie einzeln erläutern. Hier stelle ich nur die allgemeine Form vor und erkläre sie bei Bedarf separat. Die meisten von ihnen haben relativ standardisierte Eigenschaften (einige Funktionen haben Ausnahmeformen, die wir später separat vorstellen werden), dh das Lesen beginnt mit Get und das Schreiben beginnt mit Put. Der erste Parameter ist der entsprechende Deskriptor und der zweite Parameter ist der entsprechende Datenzeigertyp, der zum Empfangen von Abfrageergebnissen (oder zum Speichern geschriebener Daten) verwendet wird. Angenommen, der Datentyp, den wir abfragen müssen, ist TypeName, dann lautet er wie folgt: 🎜>TypeName *
dest); //Read
OSErr (*
Put
TypeNameProc) (PIWriteDescriptor descriptor, DescriptorKeyID, TypeName *dest); //Write:    >DescriptorKeyID ,

TypeName *dest h): Deskriptor-Untersuite lesen Code-Hervorhebung erstellt mit Actipro CodeHighlighter (Freeware)
http:// m.sbmmt.com/

-->//

Beispiel für das Lesen und Schreiben von Parametern:
Parameter aus dem Skriptsystem lesen: Angenommen, der Schlüssel unseres Parameters ist „Pam1“, wir verwenden eine temporäre Variable param1, um ihn zu empfangen:

Einen Parameter-Democode lesen            err = readProcs->closeReadDescriptorProc(token);
             //释放描述符
            gFilterRecord->handleProcs- >disposeProc(descParams->descriptor);
            descParams->descriptor = NULL;
        }
   }

Parameter in das Skriptsystem schreiben: Wie im obigen Beispiel:

Deskriptor-Democode schreiben
3.3 DescriptorRegistry suite: (Deskriptorregistrierungsfunktionssatz)
Der Deskriptorregistrierungsfunktionssatz wird hauptsächlich für die Registrierung und Erfassung von Deskriptoren verwendet. Dadurch kann ps damit beauftragt werden, unsere Parameter zu speichern, während der Filter mehrmals aufgerufen wird. Es enthält mehrere Schlüsselfunktionen zur Registrierung, Entfernung und Schlüsselbeschaffung.
Register()
Beschreibung: Einen Schlüssel registrieren.
Definition:
OSErr (*Register) (
/* IN */ const char* key, // Eindeutige Zeichenfolge oder ID
/* IN */ PIActionDescriptor Descriptor, // Beschreibung Satzhandle
/ * in */Boolean Ispersisistent // Ob die PS-Wartung mit der Speicherung und Wiederherstellung betraut werden soll
);

Erase ()
Beschreibung: Einen Schlüssel entfernen Definition:
OSErr (*Erase)
(
/* IN */ const char* key // Eindeutige Zeichenfolge oder ID
🎜>Get()

Beschreibung: Gibt einen Schlüssel zurück. Der zurückgegebene Deskriptor ist eine Kopie, daher müssen Sie ihn nach der Verwendung aktiv freigeben. Definition:
OSErr (*Get) (
/* IN */ const char* key, // Eindeutige Zeichenfolge oder ID
/ Ihn nach Gebrauch freigeben
);

3.4 ActionDescriptor-Suite: (Aktionsdeskriptor-Funktionssatz)
Aktionsdeskriptor-Funktionssatz, wird zum Speichern von Schlüsseln verwendet ( oder Objekte) in Deskriptoren umwandeln, aus Deskriptoren lesen und andere Deskriptoren verwalten. Dieser Funktionssatz enthält sowohl Lese- als auch Schreibfunktionen und die Verwendungsmethode ähnelt dem Deskriptor im vorherigen Abschnitt. Es ist wie folgt definiert:

PSActionDescriptorProcs Struct

Beispiel für das Schreiben unserer Parameter in den Deskriptor und dessen Registrierung: Zuvor müssen wir eine eindeutige ID für die Parameter unseres Plug-Ins angeben, um den zu uns gehörenden Deskriptor zu registrieren und zu extrahieren, zum Beispiel:
define plugInUniqueID "d9543b0c-3c91-11d4-97bc-00b0d0204936"

Schreiben Sie unsere Parameter