WebPShop Photoshop插件安装与使用指南

项目概述

WebPShop是一个用于Adobe Photoshop的开源插件，支持打开和保存WebP格式图像，包括动画功能。该项目基于Apache-2.0许可证，使用C++语言开发，并集成了Google的WebP图像编码技术。

安装准备

系统要求

• Adobe Photoshop CC 2018或更高版本
• Windows系统需要Visual Studio 2019+，Mac系统需要Xcode
• 下载WebPShop插件源代码

获取源代码

使用以下命令克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/we/WebPShop

安装步骤

Windows安装

1. 进入项目目录下的win文件夹
2. 打开WebPShop.sln解决方案文件
3. 在Visual Studio中选择与Photoshop匹配的架构（通常为x64）
4. 构建解决方案，生成WebPShop.8bi插件文件

macOS安装

1. 进入项目目录下的mac文件夹
2. 使用Xcode打开WebPShop.xcodeproj
3. 设置目标架构为系统对应选项（x64或arm64）
4. 编译项目生成插件文件

插件配置

1. 将编译生成的插件文件复制到Photoshop插件目录：

   • Windows: C:\Program Files\Common Files\Adobe\Plug-Ins\CC
   • macOS: /Library/Application Support/Adobe/Plug-Ins/CC

2. macOS权限处理（如遇开发者验证问题）：

sudo xattr -r -d com.apple.quarantine "/Library/Application Support/Adobe/Plug-Ins/CC/WebPShop.plugin"

3. 重启Photoshop加载插件

功能特性

文件操作

• 支持通过"打开"和"打开为"菜单命令读取.webp文件
• 支持通过"另存为副本"菜单命令保存.webp文件
• 可通过UI界面调整编码参数

编码设置

质量滑块对应以下WebP内部设置：

质量滑块值	WebP编码设置	对应参数
0-97	有损压缩	质量0-100
98-99	近无损压缩	质量60-80
100	无损压缩	-

压缩级别选项：

标签	WebP速度设置	锐利YUV	WebP质量设置
最快	1	否	0
默认	4	否	75
最慢	6	是	100

动画支持

通过特定图层命名模式支持动画：

• Frame1 (2000 ms) - 第一帧，显示2秒
• Frame2 (321 ms) - 第二帧，显示0.321秒
• Frame3 (1111 ms) - 第三帧，显示1.111秒

使用限制

• 仅支持英语界面
• 仅支持RGB色彩模式
• 16位和32位通道会降级为8位
• WebP图像最大尺寸不超过16383×16383像素
• 时间轴数据不被使用，动画依赖图层定义帧
• 不支持"导出为"和"存储为Web所用格式"

故障排除

如果插件未被检测到或行为异常：

1. 更新Photoshop到最新版本
2. 确认插件二进制文件与操作系统和架构匹配
3. 检查插件是否在"帮助 > 关于插件"子菜单中列出
4. 禁用防病毒程序或允许插件执行
5. 尝试不同的插件目录路径

项目结构

项目包含以下主要目录和文件：

• common/ - 核心功能代码
  • WebPShop.h - 主要头文件
  • WebPShop.cpp - 插件入口点
  • WebPShop*Utils.cpp - 辅助功能函数
• win/ - Windows平台相关文件
  • WebPShop.sln - Visual Studio解决方案
  • WebPShop.vcxproj - 项目文件
• mac/ - macOS平台相关文件
  • webpshop.xcodeproj - Xcode项目
  • WebPShopUI_mac.mm - 窗口事件处理

构建说明

当前使用的libwebp版本：WebP 1.2.2

构建要求：

• Windows: Microsoft Visual Studio 2019+
• macOS: Xcode
• Adobe Photoshop Plug-In and Connection SDK
• WebP二进制文件或源代码

通过正确配置包含目录和库依赖，可以构建出适用于对应平台的Photoshop插件文件。

WebPShop插件为Photoshop用户提供了完整的WebP格式支持，包括高级编码选项和动画功能，是处理WebP图像的专业工具。