怎样编写一个Photoshop滤镜（2）

            在上一篇文章中，我们讲解了怎样创建一个Photoshop滤镜的项目，以及如何为滤镜嵌入PIPL资源使滤镜可以被PS识别和加载。并且我们已经建立了一个最简单最基本的滤镜框架。在这篇文章中，我们将细化滤镜和PS之间的调用流程，我们将为滤镜引入一个对话框资源，使用户可以对滤镜进行自定义参数的配置。并且我们将看到当用户从不同菜单位置发起滤镜调用时的流程区别，然后我们还将为我们的滤镜参数引入PS脚本描述系统的读写支持，将我们的参数存入PS的脚本系统中，并在以后的调用中读取出这些参数。

            （1）设计我们的滤镜参数。

            我们的滤镜完成的是一个最基本的任务，仅仅是“填充”，因此我们可以对填充的颜色进行配置，此外，我们还可以设置填充颜色的不透明度。因此我们引入下面的参数，把它定义为一个struct，包括一个RGB填充色，和一个不透明度（0~100）：

 

//======================================
//        定义我们的参数
//======================================
typedef struct _MYPARAMS
{
    COLORREF fillColor; //填充颜色
    int      opacity;    //百分比（0~100）
} MYPARAMS;

 

            （2） 现在我们添加一个对话框资源。编辑对话框模块如下所示。然后我们对主要控件设置控件ID。

            【注意】编辑资源文件后，由于VC将会重写rc文件，因此在编译项目前，我们还需要手工打开rc文件，自己重新添加#include "FillRed.pipl"。

                        否则编译好的滤镜将无法被PS正确识别和加载到滤镜菜单。

            

            （3）下面我们为该对话框添加窗口过程。为此我们为项目添加 ParamDlg.h 和 ParamDlg.cpp文件。

            【注意】由于窗口过程位于我们的DLL中，因此我们必须把窗口过程声明为DLL导出函数，以便让系统知道该函数的地址。

            关于窗口过程的编写则完全属于 windows 编程领域的内容（这方面的知识可以参考相关书籍），这里我们不详细介绍怎样写窗口过程。但值得一提的是，我在这里引入了一个PS中的UI特性，即PS中例如它的字体设置对话框，当鼠标悬停在控件前面的Lable（Static标签）上方时，光标形状可以改变为特殊光标，按下并左右拖动鼠标，则相关控件的值就会根据鼠标移动方向自动增加或减小，类似slider控件的效果。因此我在窗口过程中为它加入了这个特性，这会使得窗口过程的代码看起来稍显复杂一些，不过这个功能（可能是PS发明的？）很有趣也很新颖。为此我还引入了一个自定义的光标文件。具体代码不贴出了，请参考项目源代码中的 ParamDlg.cpp文件中的代码。 

            （4）在第一篇文章的基础上，我们需要改写FillRed.cpp中的一些代码。

            因为现在我们引入了不透明度参数，不透明度的算法是：(opacity = 0~ 100)

            结果值 = 输入值 * (1- opacity*0.01) + 填充颜色 * opacity*0.01;

            （a）对DoStart 和 DoContinue：我们需要知道原图中原来的颜色，因此我们的 inRect 和 inHiPlane 将不在为空矩形。这体现在 DoStart 和 DoContinue 函数中，我们对inRect 和 inHiPlane 修改为和 outRect ， outHiPlane 一致，这样PS就会把原图数据通过 inData 发送给我们。

            （b）当用户点击滤镜菜单时，将从 parameter 调用开始，这样我们就在这里设置一个标记，表示需要显示对话框。

            （c）当用户点击“最近滤镜”菜单时，将从 prepare 调用开始，这样表示我们不需要显示对话框，而是直接取此前的缓存参数。为此我们引入 ReadParams 和 WriteParams 函数。即使用PS提供的回调函数集使我们的参数和PS Scripting System进行交换数据。

             下面我们主要看一下DoContinue函数发生的变化。主要是对算法进行了改动，对 inRect ， inHiPlane 这两个数据进行了变动，以请求PS发送数据。在DoStart（）函数中设置了第一个贴片，对inRect 和 inHiPlane 的改动是同样的。同时，在DoStart函数中， 根据事先设置过的标志，来决定是否显示对话框。

 

Code_DoStart_And_DoContinue
//DLLMain
BOOL APIENTRY DllMain( HMODULE hModule,
                       DWORD  ul_reason_for_call,
                       LPVOID lpReserved
                     )
{
    dllInstance = static_cast<HINSTANCE>(hModule);

    if (ul_reason_for_call == DLL_PROCESS_ATTACH || ul_reason_for_call == DLL_THREAD_ATTACH)
    {
        //在DLL被加载时，初始化我们的参数！
        gParams.fillColor = RGB(0, 0, 255);
        gParams.opacity = 100;
    }
    return TRUE;
}

#ifdef _MANAGED
#pragma managed(pop)
#endif

//===================================================================================================
//------------------------------------ 滤镜被ps调用的函数 -------------------------------------------
//===================================================================================================
DLLExport void PluginMain(const int16 selector,    void * filterRecord, int32 *data, int16 *result)
{
    gData = data;
    gResult = result;
    gFilterRecord = (FilterRecordPtr)filterRecord;

    if (selector == filterSelectorAbout)
        sSPBasic = ((AboutRecord*)gFilterRecord)->sSPBasic;
    else
        sSPBasic = gFilterRecord->sSPBasic;

    switch (selector)
    {
        case filterSelectorAbout:
            DoAbout();
            break;
        case filterSelectorParameters:
            DoParameters();
            break;
        case filterSelectorPrepare:
            DoPrepare();
            break;
        case filterSelectorStart:
            DoStart();
            break;
        case filterSelectorContinue:
            DoContinue();
            break;
        case filterSelectorFinish:
            DoFinish();
            break;
        default:
            *gResult = filterBadParameters;
            break;
    }
}

//显示关于对话框
void DoAbout()
{
    AboutRecord    *aboutPtr = (AboutRecord*)gFilterRecord;
    PlatformData *platform = (PlatformData*)(aboutPtr->platformData);
    HWND hwnd = (HWND)platform->hwnd;
    MessageBox(hwnd, "FillRed Filter: 填充颜色 -- by hoodlum1980", "关于 FillRed", MB_OK);
}

//这里准备参数，就这个滤镜例子来说，我们暂时不需要做任何事
void DoParameters()
{
    //parameter调用说明，用户点击的是原始菜单，要求显示对话框
    m_ShowUI = TRUE;

    //设置参数地址
    if(gFilterRecord->parameters == NULL)
        gFilterRecord->parameters = (Handle)(&gParams);
}

//在此时告诉PS（宿主）滤镜需要的内存大小
void DoPrepare()
{
    if(gFilterRecord != NULL)
    {
        gFilterRecord->bufferSpace = 0;
        gFilterRecord->maxSpace = 0;

        //设置参数地址
        if(gFilterRecord->parameters == NULL)
            gFilterRecord->parameters = (Handle)(&gParams);
    }
}

//inRect     : 滤镜请求PS发送的矩形区域。
//outRect    : 滤镜通知PS接收的矩形区域。
//filterRect : PS通知滤镜需要处理的矩形区域。

//由于我们是使用固定的红色进行填充，实际上我们不需要请求PS发送数据
//所以这里可以把inRect设置为NULL，则PS不向滤镜传递数据。
void DoStart()
{
    BOOL showDialog;

    if(gFilterRecord == NULL)
        return;
     //从Scripting System 中读取参数值到gParams中。
    OSErr err = ReadParams(&showDialog);
    //是否需要显示对话框
    if(!err && showDialog)
    {
        PlatformData* platform = (PlatformData*)(gFilterRecord->platformData);
        
        HWND hWndParent = (HWND)platform->hwnd;

        //显示对话框
        int nResult = DialogBoxParam(dllInstance, MAKEINTRESOURCE(IDD_PARAMDLG),hWndParent,(DLGPROC)ParamDlgProc, 0);
        
        if(nResult == IDCANCEL)
        {
            //选择了取消
            ZeroPsRect(&gFilterRecord->inRect);
            ZeroPsRect(&gFilterRecord->outRect);
            ZeroPsRect(&gFilterRecord->maskRect);

            WriteParams();

            //注意: （1）如果通知 PS 用户选择了取消，将使PS不会发起 Finish调用！
            //      （2）只要 start 调用成功，则PS保证一定发起 Finish 调用。
            *gResult = userCanceledErr;
            return;
        }
    }

    //我们初始化第一个Tile，然后开始进行调用
    m_Tile.left = gFilterRecord->filterRect.left;
    m_Tile.top = gFilterRecord->filterRect.top;
    m_Tile.right = min(m_Tile.left + TILESIZE, gFilterRecord->filterRect.right);
    m_Tile.bottom = min(m_Tile.top + TILESIZE, gFilterRecord->filterRect.bottom);

    //设置inRect, outRect
    //ZeroPsRect(&gFilterRecord->inRect); //我们不需要PS告诉我们原图上是什么颜色，因为我们只是填充
    CopyPsRect(&m_Tile, &gFilterRecord->inRect);//现在我们需要请求和outRect一样的区域
    CopyPsRect(&m_Tile, &gFilterRecord->outRect);

    //请求全部通道（则数据为interleave分布）
    gFilterRecord->inLoPlane = 0;
    gFilterRecord->inHiPlane = (gFilterRecord->planes -1);;
    gFilterRecord->outLoPlane = 0;
    gFilterRecord->outHiPlane = (gFilterRecord->planes -1);
}

//这里对当前贴片进行处理，注意如果用户按了Esc，下一次调用将是Finish
void DoContinue()
{
    int index;    //像素索引

    if(gFilterRecord == NULL)
        return;

    //定位像素
    int planes = gFilterRecord->outHiPlane - gFilterRecord->outLoPlane + 1; //通道数量

    //填充颜色
    uint8 r = GetRValue(gParams.fillColor);
    uint8 g = GetGValue(gParams.fillColor);
    uint8 b = GetBValue(gParams.fillColor);
    int opacity = gParams.opacity;
    
    uint8 *pDataIn  = (uint8*)gFilterRecord->inData;
    uint8 *pDataOut = (uint8*)gFilterRecord->outData;
    
    //扫描行宽度（字节）
    int stride = gFilterRecord->outRowBytes;

    //我们把输出矩形拷贝到 m_Tile
    CopyPsRect(&gFilterRecord->outRect, &m_Tile);
    for(int j = 0; j< (m_Tile.bottom - m_Tile.top); j++)
    {
        for(int i = 0; i< (m_Tile.right - m_Tile.left); i++)
        {
            index = i*planes + j*stride;
            //为了简单明了，我们默认把图像当作RGB格式（实际上不应这样做）
            pDataOut[ index   ] = 
              (uint8)((pDataIn[ index   ]*(100-opacity) + r*opacity)/100);    //Red  
            pDataOut[ index+1 ] = 
              (uint8)((pDataIn[ index+1 ]*(100-opacity) + g*opacity)/100);    //Green 
            pDataOut[ index+2 ] = 
              (uint8)((pDataIn[ index+2 ]*(100-opacity) + b*opacity)/100);    //Blue
        }
    }

    //判断是否已经处理完毕
    if(m_Tile.right >= gFilterRecord->filterRect.right && m_Tile.bottom >= gFilterRecord->filterRect.bottom)
    {
        //处理结束
        ZeroPsRect(&gFilterRecord->inRect);
        ZeroPsRect(&gFilterRecord->outRect);
        ZeroPsRect(&gFilterRecord->maskRect);
        return;
    }
    //设置下一个tile
    if(m_Tile.right < gFilterRecord->filterRect.right)
    {
        //向右移动一格
        m_Tile.left = m_Tile.right;
        m_Tile.right = min(m_Tile.right + TILESIZE, gFilterRecord->filterRect.right);
        
    }
    else
    {
        //向下换行并回到行首处
        m_Tile.left = gFilterRecord->filterRect.left;
        m_Tile.right = min(m_Tile.left + TILESIZE, gFilterRecord->filterRect.right);
        m_Tile.top = m_Tile.bottom;
        m_Tile.bottom = min(m_Tile.bottom + TILESIZE, gFilterRecord->filterRect.bottom);
    }

    //ZeroPsRect(&gFilterRecord->inRect);
    CopyPsRect(&m_Tile, &gFilterRecord->inRect);//现在我们需要请求和outRect一样的区域
    CopyPsRect(&m_Tile, &gFilterRecord->outRect);
    //请求全部通道（则数据为interleave分布）
    gFilterRecord->inLoPlane = 0;
    gFilterRecord->inHiPlane = (gFilterRecord->planes -1);;
    gFilterRecord->outLoPlane = 0;
    gFilterRecord->outHiPlane = (gFilterRecord->planes -1);
}

//处理结束，这里我们暂时什么也不需要做
void DoFinish()
{
    //清除需要显示UI的标志
    m_ShowUI = FALSE;
    //记录参数
    WriteParams();
}

 

 

            （5）从PS Scripting System中读写我们的参数，我们为项目添加 ParamsScripting.h 和 ParamsScripting.cpp，代码如下。引入ReadParams 和 WriteParams 方法，该节主要涉及 PS 的描述符回调函数集，比较复杂，但在这里限于精力原因，我也不做更多解释了。具体可以参考我以前发布的相关随笔中有关讲解PS回调函数集的一篇文章以及代码注释。其相关代码如下：

 

 

Code_ParamsScripting.cpp
#include "stdafx.h"
#include "ParamsScripting.h"
#include <stdio.h>

OSErr ReadParams(BOOL* showDialog)
{
    OSErr                err   = noErr;
    PIReadDescriptor    token = NULL;   //读操作符
    DescriptorKeyID        key   = NULL;    //uint32，即char*，键名
    DescriptorTypeID    type  = NULL;
    int32                flags = 0;
    int32                intValue;        //接收返回值
    char                text[128];

    //需要读取的keys
    DescriptorKeyIDArray keys = { KEY_FILLCOLOR, KEY_OPACITY, NULL };

    if (showDialog != NULL)
        *showDialog = m_ShowUI;

    // For recording and playback 用于录制和播放动作
    PIDescriptorParameters* descParams = gFilterRecord->descriptorParameters;

    if (descParams == NULL) 
        return err;
    
    ReadDescriptorProcs* readProcs = gFilterRecord->descriptorParameters->readDescriptorProcs;

    if (readProcs == NULL) 
        return err;
    
    if (descParams->descriptor != NULL)
    {
        //打开描述符token
        token = readProcs->openReadDescriptorProc(descParams->descriptor, keys);

        if (token != NULL)
        {
            while(readProcs->getKeyProc(token, &key, &type, &flags) && !err)
            {
                switch (key)
                {
                    case KEY_FILLCOLOR: //读取填充颜色
                        err = readProcs->getIntegerProc(token, &intValue);
                        if (!err) gParams.fillColor = intValue;
                        break;

                    case KEY_OPACITY:    //读取不透明度
                        err = readProcs->getIntegerProc(token, &intValue);
                        if (!err) gParams.opacity = intValue;
                        break;

                    default:
                        err = readErr;
                        break;
                }
            }

            //关闭描述符token
            err = readProcs->closeReadDescriptorProc(token);
            //释放描述符
            gFilterRecord->handleProcs->disposeProc(descParams->descriptor);

            descParams->descriptor = NULL;
        }

        //播放动作时的选项，是否需要显示对话框
        *showDialog = descParams->playInfo == plugInDialogDisplay;
    }
    return err;
}

//写参数
OSErr WriteParams()
{
    OSErr                err = noErr;
    PIWriteDescriptor    token = NULL;
    PIDescriptorHandle    h;

    PIDescriptorParameters*    descParams = gFilterRecord->descriptorParameters;

    if (descParams == NULL) 
        return err;
    
    WriteDescriptorProcs* writeProcs = gFilterRecord->descriptorParameters->writeDescriptorProcs;

    if (writeProcs == NULL) 
        return err;

    //打开写描述符token
    token = writeProcs->openWriteDescriptorProc();

    if (token != NULL)
    {
        //写入填充颜色
        writeProcs->putIntegerProc(token, KEY_FILLCOLOR, (int32)gParams.fillColor);
        //写入不透明度
        writeProcs->putIntegerProc(token, KEY_OPACITY,   (int32)gParams.opacity);

        //释放描述符
        gFilterRecord->handleProcs->disposeProc(descParams->descriptor);

        //关闭token
        writeProcs->closeWriteDescriptorProc(token, &h);

        //恢复描述符
        descParams->descriptor = h;

        //录制选项
        descParams->recordInfo = plugInDialogOptional;
    }
    else
    {
        return errMissingParameter;
    }
    return err;
}

 

 

            （6）这样我们就完整支持了参数读写，我们可以在执行滤镜时，点击“好”按钮，即可将参数更新到PS脚本系统，下次调用时会自动从脚本系统中读取上一次的参数值，并使用读取出的值初始化对话框。而当我们点击“最近滤镜”命令时，滤镜将会采用脚本系统中的参数，并且不显示对话框。

                  

 

            （7）下面是源代码的下载链接：

                 http://files.cnblogs.com/hoodlum1980/FillRed.rar 

                 【注意】为了节省空间，提供源码时，我将覆盖以前的项目版本，也就是说在原有基础上增量更新而不再保留历史版本。

            （8）总结：

            这一节主要讲解为滤镜引入自定义参数以及相关的对话框资源，然后为参数增加PS脚本系统的读写支持。

            到目前为止，这个滤镜已经具有比较完整的框架了，也能够被动作录制和回放。

            （a）但美中不足的是，对“动作录制和回放”的支持还不够完备，我们将看到当把滤镜录制为动作时，其对话框选项的勾选框是没有的，也就是我们没法设置对话框显示的“显示”，“不显示”，“安静”三种模式，这是因为我们还没有为滤镜引入必须的事件，描述符键等相关的“术语”（aete）资源。

            （b）我们还希望为滤镜的对话框引入“预览”机制，即我们希望在对话框上显示一小块图片供用户预览效果，这样用户就可以根据视觉反馈方便的调节滤镜参数。

            在此后，我们将有可能进一步讲解PS的回调函数集，例如如何让PS为我们申请内存，如何更新PS的进度条，如何更完善的处理用户交互，以及引入“预览”支持，引入aete资源等相关内容。

            （9）最后更新：把RGB三个通道共用一个不透明度参数，调整为可以单独每个通道的合成不透明度。因此对话框做了相应修改。

 

            我的相关文章：

            《怎样编写一个Photoshop滤镜（1）》

时间： 2024-09-12 00:51:31

怎样编写一个Photoshop滤镜（2）的相关文章

怎样编写一个Photoshop滤镜（3）-- Scripting Plug-ins

            在第一篇文章中我们建立了一个没有UI的基本滤镜框架,并且引入PIPL资源使之能被PS加载到菜单.在第二篇文章中我们又引入了滤镜参数和相应的对话框资源,并且讲解了对话框在滤镜调用流程中的显示时机.这一篇文章我们将使滤镜支持动作记录和回放,也就是通过添加"术语资源",使我们的滤镜参数被PS的脚本系统所获知(scripting-aware),并能够记录和回放.             从Photoshop 4.0开始引入了一个新的面板以及相应的命令和回调函数:动作面板

怎样编写一个Photoshop滤镜（4） -- 在对话框上增加缩略图

            在上一篇文章里,我们讲解了为滤镜添加术语资源,从而使我们的滤镜可以被PS的scripting system感知和描述,这样即友好支持了PS的"动作"面板.在这一篇文章中,我们将对此前的DEMO进行进一步的细化,例如在参数对话框上增加实时预览的小缩略图等.对话框的引入主要是给用户一个机会和接口,设置或调节滤镜使用的图像处理算法.通常作为UI的友好性,在对话框上应该提供预览图,这样可以直观的把参数对结果产生的影响反馈给用户,指导他们调整参数.而不是要用户必须反复执行

怎样编写一个Photoshop滤镜（1）

            在很久前我曾经写过一篇文章简要讲述了 Photoshop 的滤镜开发的基本概念,并描述了滤镜和 PS之间的协作关系,也提供了一个雨滴效果滤镜的 Demo.但是缺少源代码.而且我们将要产生疑问,我们如何从头开始编写一个 Photoshop 滤镜呢?我们如何建立一个最简单的 PS 滤镜插件的基本框架,然后在这个基础上继续添加我们想要的功能呢?这里,我就以回答一个网友向我提出的问题为例,从最基本的建立项目开始讲起.这个例子(也是这个网友的问题)是,他想做一个最简单的滤镜,也就是

Photoshop滤镜巧绘五彩羽毛

滤镜 这个羽毛特效主要用了Photoshop滤镜中的风滤镜来表现羽毛边缘的效果,然后用图层模式做成五彩效果. 1. 在Photoshop中新建一个图像文件,色彩模式为RGB. 2.新建一层,选择套索工具绘制一个简单的羽毛形状,如图所示: 图片如下: 2.选择"Filter" > "Stylize" > "Wind"(滤镜-风格化-风),选择方向为 "from the right",如图所示. 3.复制羽毛层,选择&

用Photoshop滤镜轻松制作炫彩背景

滤镜 前面我们介绍过很多用Photoshop滤镜制作炫彩背景的实例,今天我们再来看一个简单几步实现绚丽纹理背景的实例. 完成效果如下: 新建图像800*800 背景为黑色,执行 Filter > Render > Lens Flare 连续N次的移动和添加光晕.效果如下 按CTRL+U执行 Hue/Saturation menu 设Saturation to -100如下 执行 Filter > Pixalate > Mezzotint 类型 = Medium Strokes. 再

Photoshop滤镜的选择技巧

技巧|滤镜 Photoshop的滤镜主要有五个方面的作用:优化印刷图象.优化WEB图象.提高工作效率.提供创意滤镜和创建三维效果.滤镜的出现,极大地增强了Photoshop 的功能,有了滤镜,我们就可以轻易地创造出十分"专业"的艺术效果.但Photoshop滤镜种类繁多,我们该如何选择实用的Photoshop 滤镜呢? 一.文字特效处理滤镜选择 用Photoshop制作的特效字不仅视觉效果一流,而且也非常实用.用Photoshop 的外挂滤镜来制作特效字就更简单了. 1.首选Ulead

Photoshop滤镜打造真实的火焰图

利用photoshop滤镜可轻松打造真实的火焰图片. 1.新建一个500X500,RGB模式,白色背景的图象,将前景色设置为黑色,填充背景层. 接着执行菜单-滤镜-渲染-镜头光晕,亮度为100,竟头类型选50-300毫米变焦,将光晕中心移至图象中心. 2.按CTRL+B将中间值的青色调节至-100兰色调至+100,再按CTRL+M将光晕边缘颜色调厚. 3.执行菜单-滤镜-扭曲-波浪,将生成趋数设置为6.波长最小值为60.最大值为100.波幅最小值为1.最大值为180.比例,水平垂直都为100%,

Photoshop滤镜优化处理照片

最近通过实验发觉有几个Photoshop滤镜对图像颜色的柔化和模糊对调整色彩有些帮助.下面我们一起来看看详细的优化处理步骤. 先打开一张图片,这张图片的色彩很灰暗,缺乏饱和度. 现在我们试图调整它的饱和度,但发觉图片质量不是太好. 建立调整图层,因为这样比直接在图片上修改要好一些. 调整如下,调整后发觉颜色出现一块一块的色斑,没有达到预期的效果,这是由于图片质量和PS的计算导致的. 为了让图像中尽量消除色块的现象,我们可以先对图片做一定的柔化或模糊的作用,使得每一个像素都和周围的像素能够尽量的融

Photoshop滤镜打造黑白城市艺术图片

  Photoshop滤镜打造黑白城市艺术图片           效果图虽然只用了简单的动感模糊滤镜,不过效果就非常有创意,建筑有一种动感效果,画面也简洁了很多.喜欢的同学可以去尝试一下.最终效果 原图 一.打开素材图片,把背景图层复制一层.选择菜单:滤镜 > 模糊 > 动感模糊,角度设置为90度,距离自定,确定后效果如下图. 二.加蒙版,用透明度较低柔边黑色画笔把底部区域擦出来,效果如下图. 三.把背景图层复制一层,按Ctrl + Shift + ] 置顶,然后选择菜单:滤镜 > 模