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

       

目录
相关文章
|
JavaScript 前端开发 安全
JavaScript DOM 操作:解释一下浏览器的同源策略。
**同源策略**是浏览器安全基石,它阻止脚本跨不同协议、域名或端口访问资源,防止恶意行为。例如,HTTP页面无法直接用JS获取HTTPS页面内容。**CORS**允许跨域请求,但需服务器配合设置,通过`document.domain`属性可配置,但仍受限于服务器配置。
119 4
|
SQL 前端开发 安全
ASP.NET MVC 5 学习教程:创建连接字符串
原文 ASP.NET MVC 5 学习教程:创建连接字符串 起飞网 ASP.NET MVC 5 学习教程目录: 添加控制器 添加视图 修改视图和布局页 控制器传递数据给视图 添加模型 创建连接字符串 通过控制器访问模型的数据 生成的代码详解 使用 SQL Server LocalDB Edit方法和Edit视图详解 添加查询 Entity Framework 数据迁移之添加字段 添加验证 Details 和 Delete 方法详解 在上一节中,我们创建了MovieDBContext 类来连接数据库、处理Movie 对象和数据库记录的映射。
1180 0
|
Oracle 关系型数据库 数据库
【ORACLE】ORA-00245: control file backup operation failed
从oracle 11.2.0.2.0开始,控制文件的快照文件必须能够被所有节点的数据实例访问到,并且必须放在共享的位置。否则,使用RMAN进行备份控制文件的时候会报如下错误: ORA-00245: control file backup operation failed。
903 0
|
3天前
|
存储 弹性计算 人工智能
【2025云栖精华内容】 打造持续领先,全球覆盖的澎湃算力底座——通用计算产品发布与行业实践专场回顾
2025年9月24日,阿里云弹性计算团队多位产品、技术专家及服务器团队技术专家共同在【2025云栖大会】现场带来了《通用计算产品发布与行业实践》的专场论坛,本论坛聚焦弹性计算多款通用算力产品发布。同时,ECS云服务器安全能力、资源售卖模式、计算AI助手等用户体验关键环节也宣布升级,让用云更简单、更智能。海尔三翼鸟云服务负责人刘建锋先生作为特邀嘉宾,莅临现场分享了关于阿里云ECS g9i推动AIoT平台的场景落地实践。
【2025云栖精华内容】 打造持续领先,全球覆盖的澎湃算力底座——通用计算产品发布与行业实践专场回顾
|
1天前
|
云安全 人工智能 自然语言处理
阿里云x硅基流动:AI安全护栏助力构建可信模型生态
阿里云AI安全护栏:大模型的“智能过滤系统”。
|
2天前
|
人工智能 自然语言处理 自动驾驶
关于举办首届全国大学生“启真问智”人工智能模型&智能体大赛决赛的通知
关于举办首届全国大学生“启真问智”人工智能模型&智能体大赛决赛的通知
|
5天前
|
存储 机器学习/深度学习 人工智能
大模型微调技术:LoRA原理与实践
本文深入解析大语言模型微调中的关键技术——低秩自适应(LoRA)。通过分析全参数微调的计算瓶颈,详细阐述LoRA的数学原理、实现机制和优势特点。文章包含完整的PyTorch实现代码、性能对比实验以及实际应用场景,为开发者提供高效微调大模型的实践指南。
555 2
|
3天前
|
Linux 虚拟化 iOS开发
VMware Workstation Pro 25H2 for Windows & Linux - 领先的免费桌面虚拟化软件
VMware Workstation Pro 25H2 for Windows & Linux - 领先的免费桌面虚拟化软件
793 4
VMware Workstation Pro 25H2 for Windows & Linux - 领先的免费桌面虚拟化软件
kde
|
5天前
|
人工智能 关系型数据库 PostgreSQL
n8n Docker 部署手册
n8n是一款开源工作流自动化平台,支持低代码与可编程模式,集成400+服务节点,原生支持AI与API连接,可自托管部署,助力团队构建安全高效的自动化流程。
kde
374 3