포토샵 필터 작성 방법 (2)-PS 튜토리얼-php.cn

이전 글에서는 PS에서 필터를 인식하고 로드할 수 있도록 Photoshop 필터 프로젝트를 만드는 방법과 필터에 PIPL 리소스를 삽입하는 방법을 설명했습니다. 그리고 가장 간단하고 기본적인 필터 프레임워크를 구축했습니다. 이 기사에서는 필터와 PS 간의 호출 프로세스를 개선하여 사용자가 필터에 대한 사용자 정의 매개변수를 구성할 수 있도록 필터에 대한 대화 상자 리소스를 소개합니다. 그리고 사용자가 다양한 메뉴 위치에서 필터 호출을 시작할 때 프로세스의 차이점을 살펴보겠습니다. 그런 다음 필터 매개변수에 대한 PS 스크립트 설명 시스템의 읽기 및 쓰기 지원을 소개하고 매개변수를 PS 스크립트에 저장합니다. system. , 후속 호출에서 이러한 매개변수를 읽습니다.

(1) 필터 매개변수를 디자인합니다.

필터는 가장 기본적인 작업인 "채우기"를 완료하므로 채우기 색상을 구성할 수 있습니다. 또한 채우기 색상의 불투명도도 설정할 수 있습니다. 따라서 다음 매개변수를 도입하고 이를 RGB 채우기 색상 및 불투명도(0~100)를 포함하는 구조체로 정의합니다.

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

로그인 후 복사

(2) 이제 대화 상자 리소스를 추가합니다. 편집 대화 상자 모듈은 아래와 같습니다. 그런 다음 주 컨트롤의 컨트롤 ID를 설정합니다.

[참고] 리소스 파일을 편집한 후 VC는 rc 파일을 다시 작성하므로 프로젝트를 컴파일하기 전에 수동으로 rc 파일을 열고 #include "FillRed.pipl"을 직접 다시 추가해야 합니다.

그렇지 않으면 컴파일된 필터가 PS에서 올바르게 인식되지 않고 필터 메뉴에 로드되지 않습니다.

포토샵 필터 작성 방법 (2)

(3) 다음으로 대화 상자에 창 프로시저를 추가합니다. 이를 위해 ParamDlg.h 및 ParamDlg.cpp 파일을 프로젝트에 추가합니다.

【참고】 윈도우 프로시저가 우리 DLL에 있으므로 시스템이 함수의 주소를 알 수 있도록 윈도우 프로시저를 DLL 내보내기 함수로 선언해야 합니다.

윈도우 프로시저 작성에 관해서는 전적으로 윈도우 프로그래밍 분야에 속합니다. (이 지식은 관련 서적을 참조할 수 있습니다.) 여기서는 윈도우 프로시저 작성 방법을 자세히 소개하지 않습니다. 그러나 여기서 PS에 UI 기능을 도입했다는 점은 언급할 가치가 있습니다. 즉, PS에서는 컨트롤 앞의 레이블(정적 레이블) 위에 마우스를 올리면 글꼴 설정 대화 상자가 나타납니다. 커서 모양은 변경 가능 특수 커서로서 마우스를 왼쪽이나 오른쪽으로 누르고 드래그하면 슬라이더 컨트롤의 효과와 유사하게 마우스 이동 방향에 따라 관련 컨트롤의 값이 자동으로 증가하거나 감소합니다. 그래서 이 기능을 윈도우 프로시저에 추가했는데, 이로 인해 윈도우 프로시저 코드가 좀 더 복잡해 보이지만 이 기능(어쩌면 PS에서 발명한 것인지?)은 매우 흥미롭고 참신합니다. 또한 이 목적을 위해 사용자 정의 커서 파일도 도입했습니다. 특정 코드는 게시되어 있지 않습니다. 프로젝트 소스 코드의 ParamDlg.cpp 파일에 있는 코드를 참조하세요.

(4) 첫 번째 기사를 바탕으로 FillRed.cpp의 일부 코드를 다시 작성해야 합니다.

이제 불투명도 매개변수를 도입했기 때문에 불투명도 알고리즘은 다음과 같습니다. (불투명도 = 0~ 100)

결과 값 = 입력 값 * (1- 불투명도*0.01) + 채우기 색상 * opacity*0.01;

(a) DoStart 및 DoContinue의 경우: 원본 이미지의 원래 색상을 알아야 하므로 inRect 및 inHiPlane은 더 이상 빈 직사각형이 아닙니다. 이는 DoStart 및 DoContinue 함수에 반영됩니다. inRect 및 inHiPlane을 outRect 및 outHiPlane과 일치하도록 수정하여 PS가 inData를 통해 원본 이미지 데이터를 우리에게 보냅니다.

(b) 사용자가 필터 메뉴를 클릭하면 매개변수 호출부터 시작되므로 여기에 대화 상자를 표시해야 함을 나타내는 표시를 설정합니다.

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

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

//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回调函数集的一篇文章以及代码注释。其相关代码如下：

#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脚本系统，下次调用时会自动从脚本系统中读取上一次的参数值，并使用读取出的值初始化对话框。而当我们点击“最近滤镜”命令时，滤镜将会采用脚本系统中的参数，并且不显示对话框。

포토샵 필터 작성 방법 (2)