PhotoShop 插件开发之选区(Selection)

作者：耿海增   blog：http://genghz.spaces.live.com 

         我们的程序里用到的图都是放在一张大图里的，所以就有一个文件记录每个小图是放在这张大图的什么地方，类似这个样子：<name="button" left="10" top="30" right="24" bottom="70"/>.图要是少了还好，多到几十、几百个这样的记录，每次要更新一个图都要找半天，尤其是界面大变的时候，几乎所有的小图的位置都变了，这样就要在PhotoShop里找到每一个小图，记下它的坐标，然后在写到配置文件中。要是偶尔做做也就忍了，可是这种不幸的事情经常发生，忍无可忍，觉得这种事情计算机应该可以胜任，它能干的事情，我们坚决不能替它干。仔细研究了几天，总算研究明白了PS的插件机制，可以实现先Ctrl+C一些坐标位置，然后在PS中选中这些区域。
  
         还是Adobe比较牛，我们辛辛苦苦帮它开发插件，它还要收费。现在的PS插件开发的SDK已经不免费下载了，还好在免费的互联网上还能找到早期版本的免费SDK，我找到的是6.0的，开发的插件可以在最新的PS CS2中使用。
 
         据官方文档声明，PS大概支持9种插件，比较常见的是Filter，俗称滤镜，一般用来实现一些特殊的图像处理算法，如边缘提取等，我感兴趣的是Select插件，看名字就像是和选区有关。插件的使用很简单，放到PS安装目录下的Plug-Ins目录下的相应类别下即可，比如滤镜就放在Plug-Ins/Filters下，扩展名是.8BF，选择插件放在Plug-Ins/Select下，扩展名为.8BS.PS启动时会搜索这个目录。
 PS的SDK带了很多插件的例子，你可以找你感兴趣的那个类别的插件例子看看，然后改改就可以了。我们先看看PS 6.0 SDK 带的Selection目录下的Selectorama这个例子。它演示了如何在当前的文档上选中感兴趣的区域，不过例子似乎稍微复杂了点儿。
 PS的Windows下的插件一般是一个标准的dll，入口函数为PluginMain，原型是
 void PluginMain (const short selector,PISelectionParams *selectionParamBlock,long *data,short *result);
 其中，selector是一个类型参数，说明本次调用的目的是什么，如果是常量"selectionSelectorAbout",说明需要显示一个关于对话框。在滤镜插件中，PluginMain会被调用多次，可以根据selector来决定具体做什么操作。

selectionParamBlock  是指向一个庞大的结构的指针，里面几乎有所有你需要的东西。比如，当前文档的大小可以通过 selectionParamBlock->documentInfo->bounds 获取，如果想知道现在用户是否选择了一块区域，可以通过 selectionParamBlock->documentInfo->selection->bounds 来获取。
 剩下的两个都是输出参数，可以用来存储句柄，返回错误等，暂时可以不用理会。

在PluginMain函数中，会间接调用DoExecute这个函数，传递的参数叫globals，其实是把输入参数 selectionParamBlock 包装了一下，真正有用的还是globals->selectionParamBlock.
 在插件中，如果想从PS里读数据，需要一个叫做read port的东西，例子中使用了ReadFromWritePort这个宏来获取一个read port，这个我们暂时可以不用管它，接着向下看，会看到分配了三块缓冲区：sBuffer,dBuffer,rBuffer,如果transparency不空的话，还会分配一个mBuffer的缓冲区。我实际用到的只是sBuffer和dBuffer,其它两个高级的东东还没用到。接下来是调用 AccountChannel 计算需要处理的通道，一般会有R G B 三个通道。然后就是关键的 ApplyChannel 函数来完成实际的工作。

这个函数的参数很多，不过你只要记住刚才提到的sBuffer和dBuffer就够了。sBuffer用来保存从当前的图像中读来的图像数据，dBuffer用来保存你的选区信息，和sBuffer一一对应，如果某个象素需要选中，直接赋值为255即可。原例中需要选择的部分赋值是原来图像的内容，经过实践发现这样会造成魔棒选区的特效，我用不着这个高级功能，所以就直接赋成255了，可以精确的按我的要求工作。在这个函数里，考虑到图像可能会比较大，一次读过来可能受不了，所以先用了两个循环，按64×64的块大小循环读取处理，我们就可以再来一次循环，对每个64×64块的每个象素处理，根据剪贴板里设定的选区信息，判断当前象素的位置是否在这个选区内，如果是，就把dBuffer中的相应位置置为255，否则就是0。详情请参阅代码，为了使程序流程清楚，代码做了适当的整理。

//=============================PluginMain Start======================
DLLExport MACPASCAL void PluginMain (const short selector,PISelectionParams *selectionParamBlock, long *data,short *result) {  //显示About对话框  if (selector == selectionSelectorAbout)  {   DoAbout((AboutRecordPtr)selectionParamBlock);  }  else  {    static const FProc routineForSelector [] =   {    /* selectionSelectorAbout    DoAbout, */    /* selectionSelectorExecute */ DoExecute   };

   Ptr globalPtr = NULL;  // Pointer for global structure   GPtr globals = NULL;   // actual globals

   //包装selectionParamBlock到globals中，真正有用的还是globals->selectionParamBlock   globalPtr = AllocateGlobals ((uint32)result,    (uint32)selectionParamBlock,    selectionParamBlock->handleProcs,    sizeof(Globals),    data,    InitGlobals);

   if (globalPtr == NULL)   {        *result = memFullErr;return;   }

   globals = (GPtr)globalPtr;

   //调用 DoExecute 函数   if (selector > selectionSelectorAbout && selector <= selectionSelectorExecute)    (routineForSelector[selector-1])(globals);   else    gResult = selectionBadParameters;

   if ((Handle)*data != NULL)    PIUnlockHandle((Handle)*data);

   } // about selector special  

 } //=============================PluginMain End=================================

//=============================DoExecute Start================================= void DoExecute (GPtr globals) {  //一些变量声明，省略...  //...  //

  //从剪贴板中读取自己定义格式的选区信息，保存到全局变量中，我加的