Comment écrire un filtre Photoshop - Plug-ins de script

Dans le premier article, nous avons établi un cadre de filtrage de base sans interface utilisateur et introduit les ressources PIPL afin qu'elles puissent être chargées dans le menu par PS. Dans le deuxième article, nous avons présenté les paramètres de filtre et les ressources de dialogue correspondantes, et expliqué le timing d'affichage de la boîte de dialogue dans le processus d'appel de filtre. Dans cet article, nous ferons en sorte que le filtre prenne en charge l'enregistrement et la lecture des actions, c'est-à-dire qu'en ajoutant une "ressource de terme", nos paramètres de filtre seront connus du système de script PS (compatible avec les scripts) et pourront être enregistrés et lus. .

À partir de Photoshop 4.0, un nouveau panneau et les commandes et fonctions de rappel correspondantes ont été introduits : panneau d'action (fenêtre flottante) et ensemble de fonctions de rappel de descripteur. Le panneau d'action est l'interface utilisée par le système de script Photoshop pour interagir avec les utilisateurs, et constitue également son cœur. Photoshop 5.0 étend la structure des actions pour permettre aux plug-ins d'automatisation de prendre en charge les commandes descriptives de Photoshop. ("Guide de l'API Photoshop" Chapitre 11)

À propos du système de script de PS, son origine est l'héritage de PS et la prise en charge du mécanisme d'événements et de script du système Apple. Le développement de PS cible les deux plates-formes de système d'exploitation. Nous expliquons ici comment faire accepter nos filtres par le système de script PS.

Nous devons d'abord ajouter une ressource terminologique au fichier r. Par conséquent, ajoutez d'abord une structure HasTerminology à la ressource pipl, qui est définie comme suit :

//这个属性指明滤镜是否提供了 'aete'资源。

typedef struct HasTerminology

{

int32 classID; // classID from 'aete'

int32 eventID; // eventID from 'aete' or NULL if none

int16 aeteResNum; // number of 'aete' resource

CString uniqueID; // unique ID string (UUID or your own ™/©). If present,

ignores AppleScript and keeps local to Photoshop.

} HasTerminology;

Cette structure sera ajoutée à la ressource pipl du fichier r. Ci-dessous, nous ajoutons la ressource aete après la ressource pipl.

Auparavant, nous avons ajouté quelques définitions nécessaires aux ressources aete dans un fichier d'en-tête commun :

//定义 Scripting Keys
#define KEY_FILLCOLOR        'fiCo'
#define KEY_OPACITY            'opcA'

#define plugInSuiteID        'filR'
#define plugInClassID        'filR'
#define    plugInEventID        'filR'
#define    plugInUniqueID        "18EC4E8F-DB34-4aff-AF99-77C8013BD74F"
#define plugInAETEComment    "FillRed example filter By hoodlum1980"
#define vendorName            "hoodlum1980"

//Clés de script de définition> 'opcA' 3bb3ba5d8a8c1e677360c9d603cb067b
plugInClassID « filR »#define
plugInEventID « filR »#
plugInUniqueID "18EC4E8F-DB34-4aff-AF99-77C8013BD74F"
#define plugInAETEComment définir "Exemple de filtre FillRed par hoodlum1980"
#define supplierName "hoodlum1980"
Au dessus de nous Définissez notre filtre et nos paramètres de filtre comme des clés Concernant la définition de la clé, elle doit respecter les principes suivants :
(a) Elle doit être composée de 4 caractères. S'il y a moins de 4 caractères, vous pouvez ajouter des espaces à la fin. (b) Les noms de clés définis par l'utilisateur doivent commencer par une lettre minuscule et contenir au moins une lettre majuscule. (Parce que tous les noms de touches en majuscules et en minuscules appartiennent à la définition d'Apple). L'identifiant unique du filtre peut être le GUID généré par l'outil VC.
                                        

            然后我们对r文件增加aete 资源，aete 资源模板如下：

resource 'aete' (0)

{ // aete version and language specifiers

{ /* suite descriptor */

{ /* filter/selection/color picker descriptor */

{ /* any parameters */

/ * additional parameters */

}

},

{ /* import/export/format descriptors */

{ /* properties. First property defines inheritance. */

/* any properties */

},

{ /* elements. Not supported for plug-ins. */

},

/* class descriptions for other classes used as parameters or properties */

},

{ /* comparison ops. Not currently supported. */

},

{ /* any enumerations */

{

/* additional values for enumeration */

},

/* any additional enumerations */

/* variant types are a special enumeration: */

{

/* additional types for variant */

},

/* any additional variants */

/* class and reference types are a special enumeration: */

{

},

/* any additional class or reference types */

}

}

}

 

            请注意的是这是一个针对PS插件的aete资源模板，也就是说它不仅仅针对滤镜，也包括其他种类的PS插件。关于其具体含义这里我们不做详细讨论，可以参考相关PS SDK文档。

            【注意】即使有的节不需要，也必须提供一个空的花括号占位，而不能有缺失。 

            下面我们给出添加了aete资源后的 FillRed.r 文件，内容如下：

// ADOBE SYSTEMS INCORPORATED
// Copyright  1993 - 2002 Adobe Systems Incorporated
// All Rights Reserved
//
// NOTICE:  Adobe permits you to use, modify, and distribute this 
// file in accordance with the terms of the Adobe license agreement
// accompanying it.  If you have received this file from a source
// other than Adobe, then your use, modification, or distribution
// of it requires the prior written permission of Adobe.
//-------------------------------------------------------------------------------
#define plugInName            "FillRed Filter"
#define    plugInCopyrightYear "2009"
#define plugInDescription \
    "FillRed Filter.\n\t - http:\\www.cnblogs.com\hoodlum1980"

#include "E:\Codes\Adobe Photoshop CS2 SDK\samplecode\common\includes\PIDefines.h"

#ifdef __PIMac__
    #include "Types.r"
    #include "SysTypes.r"
    #include "PIGeneral.r"
    #include "PIUtilities.r"
    #include "DialogUtilities.r"
    #include "CommonDefine.h"        /* 包含了术语定义 */
#elif defined(__PIWin__)
    #define Rez
    #include "PIGeneral.h"
    #include "E:\Codes\Adobe Photoshop CS2 SDK\samplecode\common\resources\PIUtilities.r"
    #include "E:\Codes\Adobe Photoshop CS2 SDK\samplecode\common\resources\WinDialogUtils.r"
    #include "CommonDefine.h"        /* 包含了术语定义 */
#endif

#include "PITerminology.h"
#include "PIActions.h"                /* 包含对 NO_REPLY 的定义 */

resource 'PiPL' ( 16000, "FillRed", purgeable )
{
    {
        Kind { Filter },
        Name { plugInName },
        Category { "Demo By hoodlum1980" },
        Version { (latestFilterVersion << 16) | latestFilterSubVersion },
        #ifdef __PIWin__
            CodeWin32X86 { "PluginMain" },
        #else
            CodeMachOPowerPC { 0, 0, "PluginMain" },
        #endif

        SupportedModes
        {
            noBitmap, doesSupportGrayScale,
            noIndexedColor, doesSupportRGBColor,
            doesSupportCMYKColor, doesSupportHSLColor,
            doesSupportHSBColor, doesSupportMultichannel,
            doesSupportDuotone, doesSupportLABColor
        },
        
        HasTerminology
        {
            plugInClassID,
            plugInEventID,
            16000,                /* int16 aeteResNum;  number of &#39;aete&#39; resource */
            plugInUniqueID
        },
            
        EnableInfo
        {
            "in (PSHOP_ImageMode, RGBMode,"
            "CMYKMode, HSLMode, HSBMode, "
            "DuotoneMode, LabMode)"
        },

        PlugInMaxSize { 2000000, 2000000 },

        FilterCaseInfo {
            {    /* array: 7 elements */
                /* Flat data, no selection */
                inStraightData,
                outStraightData,
                doNotWriteOutsideSelection,
                doesNotFilterLayerMasks,
                doesNotWorkWithBlankData,
                copySourceToDestination,
                /* Flat data with selection */
                inStraightData,
                outStraightData,
                doNotWriteOutsideSelection,
                doesNotFilterLayerMasks,
                doesNotWorkWithBlankData,
                copySourceToDestination,
                /* Floating selection */
                inStraightData,
                outStraightData,
                doNotWriteOutsideSelection,
                doesNotFilterLayerMasks,
                doesNotWorkWithBlankData,
                copySourceToDestination,
                /* Editable transparency, no selection */
                inStraightData,
                outStraightData,
                doNotWriteOutsideSelection,
                doesNotFilterLayerMasks,
                doesNotWorkWithBlankData,
                copySourceToDestination,
                /* Editable transparency, with selection */
                inStraightData,
                outStraightData,
                doNotWriteOutsideSelection,
                doesNotFilterLayerMasks,
                doesNotWorkWithBlankData,
                copySourceToDestination,
                /* Preserved transparency, no selection */
                inStraightData,
                outStraightData,
                doNotWriteOutsideSelection,
                doesNotFilterLayerMasks,
                doesNotWorkWithBlankData,
                copySourceToDestination,
                /* Preserved transparency, with selection */
                inStraightData,
                outStraightData,
                doNotWriteOutsideSelection,
                doesNotFilterLayerMasks,
                doesNotWorkWithBlankData,
                copySourceToDestination
            }
        }
    }
};


resource &#39;aete&#39; (16000, "FillRed dictionary", purgeable)
{
    1, 0, english, roman,                                    /* aete version and language specifiers */
    {
        vendorName,                                            /* vendor suite name */
        "FillRed Demo By hoodlum1980",                        /* optional description */
        plugInSuiteID,                                        /* suite ID */
        1,                                                    /* suite code, must be 1 */
        1,                                                    /* suite level, must be 1 */
        {                                                    /* structure for filters */
            plugInName,                                        /* unique filter name */
            plugInAETEComment,                                /* optional description */
            plugInClassID,                                    /* class ID, must be unique or Suite ID */
            plugInEventID,                                    /* event ID, must be unique to class ID */
            
            NO_REPLY,                                        /* never a reply */
            IMAGE_DIRECT_PARAMETER,                            /* direct parameter, used by Photoshop */
            {                                                /* parameters here, if any */
                "FillColor",                                /* parameter name */
                KEY_FILLCOLOR,                                /* parameter key ID */
                typeInteger,                                /* parameter type ID */
                "Fill color in RGB",                        /* optional description */
                flagsSingleParameter,                        /* parameter flags */
                
                "Opacity",                                    /* optional parameter */
                KEY_OPACITY,                                /* key ID */
                typeInteger,                                /* type */
                "opacity in RGB",                            /* optional desc */
                flagsSingleParameter                        /* parameter flags */
            }
        },
        {                                                    /* non-filter plug-in class here */
        },
        {                                                    /* comparison ops (not supported) */
        },
        {                                                    /* any enumerations */
        }
    }
};

            在上面的文件中，我们可以看到我们的滤镜含有的两个主要参数：填充颜色 和 不透明度。位于 IMAGE_DIRECT_PARAMETER 结构中，typeInteger 指明它们是整数类型。flagsSingleParameter指明它们是基本类型（具有单一值）。此外，还可以把参数定义为枚举类型，同时把枚举的值域定义放在最后一节中，这里我们对此不做介绍了。

 

                  

                  滤镜被重新编译后，我们在PS中对它录制一个动作，命名为“测试 FillRed”，录制完成后，可以看到在动作面板上的左侧，出现了对话框选项的CheckBox，我们可以设置播放时是否弹出对话框。我们把FillRed滤镜命令的下拉列表展开可以看到滤镜参数：

                  FillColor: 10

                  Opacity:90

                  请注意参数的名字就是来自于上面的aete资源中的定义的滤镜参数名字属性，这就是我们需要给它定义一个可读的参数名的原因。需要注意的是，由于我们把对话框上三个参数合成为了一个参数，这就使得上面的参数显示是三个参数的合成值（10进制）。因此这里为了看清楚，我就只设置了 R 和 O1，其他参数都为0，这样我们在动作面板看到的参数值就和滤镜的对话框上的参数值是一致的。否则我们看到的将是三个参数合成后的值。

更多怎样编写一个Photoshop滤镜-- Scripting Plug-ins相关文章请关注PHP中文网！