图像资源生成器命名语法

图层命名语法用于控制从 PSD 图层和图层组自动生成的资源的输出格式、质量、尺寸和缩放比例。了解这些语法规则后，您可以通过直接在图层名称中编码所有参数，从单个图层创建多个资源变体。

特定格式的质量参数

JPEG 语法

质量后缀

• .jpg1 至 .jpg10（1 到 10 级）
• .jpg1% 至 .jpg100%（百分比刻度）

默认：未指定后缀时质量为 90%

示例

• Logo.jpg5，质量级别为 5 的 JPEG
• Hero.jpg80%，质量为 80% 的 JPEG
• Banner.jpg，默认质量为 90% 的 JPEG

PNG 语法

位深度后缀

• .png8：8 位 PNG
• .png24：24 位 PNG
• .png32：32 位 PNG

默认：未指定后缀时为 32 位

示例

• Icon.png8：8 位 PNG，具有 256 种颜色
• Photo.png24：24 位 PNG，不含透明度
• Button.png32：32 位 PNG，具有完整 Alpha 通道
• Logo.png：32 位 PNG（默认）

GIF 语法

格式

• .gif：基本 Alpha 透明度

质量参数：不适用于 GIF 格式

示例

• Animation.gif：具有基本透明度的 GIF

SVG 语法

格式

• .svg：矢量格式

质量和大小参数：不适用

示例

• Shape.svg：可缩放矢量图形

大小和缩放参数

大小前缀显示在资源名称之前，并用空格分隔。如果以像素指定尺寸，则可以省略单位。

相对缩放

语法：[percentage]% [asset-name]

示例：

• 200% Logo.jpg：缩放为 200%
• 50% Icon.png：缩放为 50%
• 42% Button.gif：缩放为 42%

绝对尺寸

语法：[width] x [height] [asset-name] 或 [width][unit] x [height][unit] [asset-name]

支持的单位：px、in、cm、mm（像素可省略）

示例：

• 300 x 200 Hero.jpg：300 像素 × 200 像素
• 100x100 Thumb.png：100 像素 × 100 像素（无空格）
• 4in x 3in Photo.jpg：4 英寸 × 3 英寸
• 10cm x 5cm Card.png：10 厘米 × 5 厘米

混合单位

您可以在宽度和高度规范中组合使用不同的单位。

示例

• 4in x 100 Banner.jpg，宽 4 英寸，高 100 像素
• 200mm x 6in Poster.png，宽 200 毫米，高 6 英寸
• 10in x 50cm Flyer.jpg，宽 10 英寸，高 50 厘米

通配符尺寸

使用 ? 作为通配符，在仅指定一个尺寸的情况下按比例缩放。

语法:

• [width]x? [asset-name]，指定宽度，高度按比例缩放
• ?x[height] [asset-name]，指定高度，宽度按比例缩放

示例：

• 100x? Logo.png，宽 100 像素，高度自动计算
• ?x60in Banner.jpg，高 60 英寸，宽度自动计算

从单个图层生成多个资源

通过使用逗号或加号分隔资源名称，生成多个资源变体。

分隔符：

• ,，逗号
• ,，逗号后跟空格
• +，加号
• +，加号后跟空格

示例：

• Icon.png,Icon.jpg，PNG 和 JPEG 版本
• 200% Logo.jpg, 100% Logo.jpg，两种尺寸
• Icon.png8 + Icon.png24 + Icon.jpg90%，三种格式变体
• 100x100 Thumb.jpg90%, 50x50 Thumb.jpg80%，两种缩放版本

复杂图层命名示例

组合语法

完整语法可以结合格式、质量和缩放参数：

[size] [asset-name].[format][quality], [size] [asset-name].[format][quality]

示例：120% Delicious.jpg, 42% Delicious.png24, 100x100 Delicious_2.jpg90%, 250% Delicious.gif

这将生成四个资源：

• Delicious.jpg：默认质量的 JPEG，缩放为 120%
• Delicious.png：24 位 PNG，缩放为 42%
• Delicious_2.jpg：绝对尺寸为 100×100 像素的 90% 质量 JPEG
• Delicious.gif：缩放为 250% 的 GIF

子文件夹组织

在资源名称前添加子文件夹路径，以组织输出内容：

语法：[subfolder]/[asset-name].[format]

示例：

• icons/Logo.png：保存在 icons 子文件夹中
• @2x/Hero.jpg：保存在 @2x 子文件夹中
• thumbnails/50% Photo.png：在 thumbnails 子文件夹中缩放为 50%

绝对缩放验证

有效的绝对缩放语法

绝对缩放语法无效

图层名称限制

不支持的字符：:（冒号）和 *（星号）不能用于资源生成的图层名称中。

忽略的字符串：在多资源图层名称中，没有扩展名的任何字符串都会被忽略。例如，在 100% Delicious, 42% Layer 1.png 中，字符串 100% Delicious 会被忽略，因为它缺少扩展名。