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

       

目录
相关文章
|
9天前
|
人工智能 JSON API
全网刷屏的 Jev 模型正式开放!一手实战测评 + 保姆级教程
全网爆火的 Jev 模型是什么?有什么用?怎么使用?怎么接入 AI 编程工具?效果真的好么?傻子可懂的 Jev 保姆级实战教程 + 项目实战测评来啦
7684 13
|
7天前
|
人工智能 测试技术 API
最近全网爆火的 Jev 到底是什么?适合干什么、怎么用,一篇讲透!
Jev是TypeSafe AI推出的“系统一模型”,不生成文本,专做毫秒级结构化决策:Choice(多选)、Score(打分)、Noul(是非概率)。响应快193倍、成本低444倍,适合工单路由、内容审核、测试定级等高频判断场景。
1642 4
最近全网爆火的 Jev 到底是什么?适合干什么、怎么用,一篇讲透!
|
4天前
|
人工智能 JavaScript 芯片
DeepSeek 官方偷偷上传 Harness 桌面端安装包,我已经用上了。。附最新下载地址
DeepSeek Harness 官方的桌面端安装包被网友扒出来了,2 分钟讲明白如何使用,体验如何,适合作为 AI 编程工具么?附最新 Windows 和 Mac 双端的下载地址
1407 1
|
8天前
|
人工智能 并行计算 PyTorch
秋叶 ComfyUI 2026 整合包 v3.2 完整部署教程:Python 3.13 + Torch 2.13 全栈升级
秋叶aaaki ComfyUI 2026年8月整合包v3.2正式发布!全面升级Python 3.13.11、PyTorch 2.13.0+cu130及ComfyUI v0.30.2,原生支持MiniMax H3、Wan 2.2、Qwen-Image-2.1等2026主流音视频/图像模型,解压即用,无需环境配置。
1187 9
|
21天前
|
人工智能 自然语言处理 安全
阿里云千问办公 QwenWork详细介绍:产品核心能力、典型场景、价格及常见问题解答
千问办公是阿里云推出的一站式AI办公平台,主打"不止于对话,更注重交付",依托通义千问旗舰大模型,用户一句话即可完成数据分析、PPT生成、视频剪辑等复杂任务,直接输出可用成果。产品深度打通钉钉生态与企业OA,覆盖桌面端、网页端,提供企业标准版198元/人/月等多档订阅方案,新用户注册即赠2000积分,适配工程师、HR、财务等多职业办公场景,成为能动手干活的"全能AI同事"。
3670 10
|
5天前
|
编解码 缓存 PyTorch
16G 显卡能跑 Qwen-Image 2.1 吗?
9月20日,阿里Qwen开源Qwen-Image-2.1:7B DiT图像模型+8B文本编码器+VAE,单模型支持文生图与图像编辑,原生输出2K PNG(含Alpha通道),支持10张参考图。在自建Qwen-Image-Bench达60.28分(开源模型第一),GenAI Showdown文生图排名7/15。16G显存可跑1024×1024(需INT8量化+ComfyUI优化),但2K需24G以上。注意其Qwen Research License限非商业用途。
609 1
|
6天前
|
人工智能 编解码 并行计算
MiniMax-H3 一键整合包技术文档:8G 显存运行 AI 漫剧制作 —— 角色替换 / 动作迁移 / 文图生视频部署与调参指南
MiniMax H3 是 MiniMax 开源的全模态视频生成模型,支持文/图/音/视多条件输入,输出最高2K、15秒带双声道音频视频。本文档详述其Int8量化版在8GB显存下的本地一键部署、三段式工作流(EDIT/REPLACE/CONTINUE)、参数调优及常见问题排查。(239字)
|
16天前
|
缓存 IDE Java
【保姆级】Android Studio下载、安装和汉化教程(2026最新)
Android Studio 是 Google 官方推出的免费 Android 应用开发集成环境,基于 IntelliJ IDEA,内置模拟器、调试器、性能分析及 Compose 界面工具,功能全面,文档丰富,是安卓开发首选工具。(239字)
1720 1

热门文章

最新文章