Photoshop滤镜开发简介(3)--回调函数集(Callback Suites)

简介: ------------------------------------------------------------------------------------------------          声明:本文性质不属于我的原创,文中主体属于我对PS SKD文档的翻译,包含自己的整理。

        ------------------------------------------------------------------------------------------------

         声明:本文性质不属于我的原创,文中主体属于我对PS SKD文档的翻译,包含自己的整理。

        -------------------------------------------------------------------------------------------------

        在上一篇文章中我们讲解了PS提供的CallBack函数分为两类,即(1)直接可以从参数中获得的一些CallBack函数,称为Direct CallBacks,比如AdvanceStateProc(要求PS立即更新参数中的数据),DisplayPixelsProc(在某HDC表面绘制像素),TestAbortProc(测试用户是否取消,例如按下Esc)等等。(2)被分类封装的回调函数集(CallBack Suites)。由于回调函数增长的越来越多,因此为了有效的组织和管理它们,PS把他们按照功能分类成多组,每一组称为一个Suit(包含一组回调函数)。在前文中我们讲解了和PS脚本系统相关的Suit。下面我们就将继续讲解其他的重要Suit。

        在这里,我们再一次强调CallBack的含义,所谓“back”,只得是我们编好的插件,将会被PS主动调用(这种调用即常规的正向调用)。而我们在被PS调用的过程中可以调用PS中的一些函数(“被调用模块”反向调用“调用模块”中的函数),这些函数的地址我们通过PS传递给我们的参数获取,因此这个调用过程称为回调。

         Callback Suites:指的是PS 4.0以及早期版本的回调函数。

        (1)PS 4.0及早期版本的Buffer suite:(缓冲相关函数集) 

        由于插件是以DLL导出函数的形式存在着。而内存管理的重任则是宿主(PS)进行管理和协调。因此我们的插件在进行处理前通常需要与PS进行内存需求的“谈判”。Buffer suit提供了一种取代以往版本的内存管理函数,使PS为我们分配和释放内存。

        在早期版本中,PS插件用一种非常简单的机制和PS就内存需求进行交流:即让插件自己指定要预留的内存大小,然后PS将为该插件保留一块内存。

        这种方法有两个问题。第一,这块内存在插件的整个执行周期内都被保留。第二,插件仍然可能遇到来自PS的内存限制。例如,PS 2.5,在大内存配置下,将在启动时使用NewPtr调用来分配大部分内存,并且这些内存只能使用Buffer suit才能获取。

        如果一个插件使用GlobalAlloc(windows)或者NewPtr(Mac OS)分配大部分内存,该企图会失败并且导致PS开始双向交换,从而降低性能。Buffer Suite可以避免一些内存计算,简化Acquire,滤镜,Format插件的准备过程。

        对大多数类型插件来说,内存分配可以延迟到他们实际需要的时刻。不幸的是,对于导出(Export)插件来说虽然内存是PS来申请的,但插件必须保持对它的使用跟踪。也就是说对Buffer Suite对Export插件提供的帮助不大。

       下面我开始介绍Buffer Suite中的函数:

        ◆BufferSpaceProc():

        函数声明:

        MACPASCAL int32 (*BufferSpaceProc) (void);

        该方法返回可以获得的内存空间大小。这些空间可能是一些碎片组成,因此一次性的申请该大小可能会失败。

        ◆AllocateBufferProc()

        函数声明:

        MACPASCAL OSErr (*AllocateBufferProc) (int32 size, BufferID *buffer);

        未知数据的内存指针称为BufferID。

       这个方法将Buffer设置为指定大小的一块内存。如果成功,返回noErr。否则返回一个错误码表明失败。在其他内存被插件锁定(例如滤镜和导出插件的continue调用)期间,内存请求容易失败。

        ◆FreeBufferProc()

        MACPASCAL void (*FreeBufferProc) (BufferID buffer);

        释放内存。如果释放后继续使用该内存指针可能导致华丽的崩溃!

        ◆LockBufferProc()

        MACPASCAL Ptr (*LockBufferProc) (BufferID buffer, Boolean moveHigh);

        这个函数将会锁定一块内存(防止在内存中被移动),然后返回内存的起始处地址。在Mac OS系统下,moveHigh标志指示是否希望内存块被移动到内存的高端以避免碎片,该标记对Windows无效。

        ◆UnlockBufferProc()

         MACPASCAL void (*UnlockBufferProc) (BufferID buffer);

         解锁内存。锁定和解锁使用的是引用计数机制,即一内存允许lock多次,必须unlock相应次数才能实际解锁。

         好,有关Buffer Suite就介绍到这里。

 

         (2)Suite PEA CallBacks:在PS 5.0版本中的回调函数集合。      

         Suite PEA是Adobe的软件使用的插件架构。在上一篇文章中已经有所介绍。这里再复习一下。他实际上是一个PS API的一种“暴露”方式,即通过suites提供给插件。一个suite是一个数据结构的指针,在该数据结构中含有一组函数指针。插件同样可以通过提供自定义的suites来扩展宿主API。

         在调用之前,我们先获取一个suite,当不再需要时,则需要释放他。这种做法将保证函数对插件是可用的。得到suite的指针以后,调用它里面的函数的方式是:

         sSuite->function();

         所以做这件事的一种固定模式如下:

         ADMBasicSuite *sADMBasic;
         filterParamBlock->sSPBasic->AcquireSuite(
                      kADMBasicSuite,
                      kADMBasicSuiteVersion,
                      &sADMBasic );
         sADMBasic->Beep( );
         filterParamBlock->sSPBasic->ReleaseSuite(
                      kADMBasicSuite,
                      kADMBasicSuiteVersion );

        

         Suite PEA Buffer suite:(描述和前文一致)

         BufferNewProc( )
         SPAIP Ptr (*BufferNewProc) (size_t *pRequestedSize, size_t minimumSize);

         申请新的内存,内存大小由第一个参数指向的数据指定。如果不能分配这么多内存,那么该参数被设置为实际获得的最大的内存大小。如果第一个参数为NULL,那么将分配minimumSIze大小的内存,如果分配失败,该函数将失败并返回NULL。

         BufferDisposeProc( )
         SPAPI void (*BufferDisposeProc) (Ptr *ppBuffer);

         这个方法释放内存,并把其指针设置为NULL。如果参数已经为NULL,则什么也不做。

         BufferGetSizeProc( )
         SPAPI size_t (*BufferGetSizeProc) (Ptr pBuffer);

         这个方法获取指定的内存的尺寸,如果指针有效。

         BufferGetSpaceProc( )
         SPAPI size_t (*BufferGetSpaceProc) (void);
         这个方法获取剩余内存空间的大小,注意可能是不连续的。 

        (To Be Continued)。--hoodlum1980

       

目录
相关文章
|
7月前
|
存储 搜索推荐 人机交互
Qt鼠标事件全面解析:从基础到实战
Qt鼠标事件全面解析:从基础到实战
1235 0
|
4月前
|
编解码 前端开发 vr&ar
从零开始的PICO教程(4)--- UI界面绘制与响应事件
这篇文章是PICO开发系列教程的第四部分,主要介绍了如何在PICO 4 VR环境中创建UI界面,包括Canvas和Panel的配置、UI元素的绘制、以及Button和Slider的事件响应绑定,并通过示例展示了数字增减和滑块功能的具体实现。
从零开始的PICO教程(4)--- UI界面绘制与响应事件
|
6月前
|
安全 图形学
【unity实战】事件(Event)的基本实战使用
【unity实战】事件(Event)的基本实战使用
202 1
|
7月前
|
存储 Swift
大师学SwiftUI第18章Part3 - 自定义视频播放器
录制和播放视频对用户来说和拍照、显示图片一样重要。和图片一样,Apple框架中内置了播放视频和创建自定义播放器的工具。
335 0
|
7月前
|
移动开发 小程序 API
uniapp中组件库Mask 遮罩层 的使用方法
uniapp中组件库Mask 遮罩层 的使用方法
600 1
|
图形学 开发者
Unity——各种特效的基本使用方法
Unity——各种特效的基本使用方法
367 0
|
7月前
|
测试技术 数据库 C++
Qt C++拖放事件探索之旅:多方法深入解析
Qt C++拖放事件探索之旅:多方法深入解析
530 1
|
7月前
|
iOS开发
iOS设备功能和框架: 如何使用 Core Animation 创建动画效果?
iOS设备功能和框架: 如何使用 Core Animation 创建动画效果?
138 0
|
7月前
|
数据可视化 安全 定位技术
【Unity 3D】常用插件DOTween、Haste、Exploder、KGFMapSystem介绍(图文解释)
【Unity 3D】常用插件DOTween、Haste、Exploder、KGFMapSystem介绍(图文解释)
388 0
Threejs入门进阶实战案例(4):addEventListener() 方法自适应窗口显示的方案
Threejs入门进阶实战案例(4):addEventListener() 方法自适应窗口显示的方案
126 0