Синтаксис найменування для генератора ресурсів зображень

Синтаксис найменування шарів керує форматом виведення, якістю, розмірами та масштабуванням ресурсів, що автоматично створюються з ваших шарів PSD і груп шарів. Розуміння цих правил синтаксису дає змогу створити кілька варіацій ресурсу з одного шару, закодувавши всі параметри безпосередньо в імені шару.

Параметри якості для конкретного формату

Синтаксис JPEG

Суфікс якості

• Від .jpg1 до .jpg10 (шкала 1–10)
• Від .jpg1% до .jpg100% (шкала у відсотках)

За умовчанням: якість 90 % за відсутності суфікса

Приклади

• Logo.jpg5 — JPEG із рівнем якості 5
• Hero.jpg80% — JPEG із якістю 80 %
• Banner.jpg — JPEG зі стандартною якістю 90 %

Синтаксис PNG

Суфікс бітової глибини

• .png8 - 8-бітний PNG
• .png24 - 24-бітний PNG
• .png32 - 32-бітний PNG

За умовчанням: 32-бітний за відсутності суфікса

Приклади

• Icon.png8 - 8-бітний PNG із 256 кольорами
• Photo.png24 - 24-бітний PNG без прозорості
• Button.png32 - 32-бітний PNG із повним альфа-каналом
• Logo.png - 32-бітний PNG (за умовчанням)

Синтаксис GIF

Формат

• .gif - базова альфа-прозорість

Параметр якості: недоступний для формату GIF

Приклад

• Animation.gif — GIF із базовою прозорістю

Синтаксис SVG

Формат

• .svg - векторний формат

Параметри якості та розміру: не застосовуються

Приклад

• Shape.svg - масштабована векторна графіка

Параметри розміру та масштабування

Префікси розміру розташовуються перед назвою ресурсу й відокремлюються пробілом. Якщо вказуєте розміри в пікселях, одиницю вимірювання можна не зазначати.

Відносне масштабування

Синтаксис:[percentage]% [назва-ресурсу]

Приклади:

• 200% Logo.jpg — масштабовано на 200 %
• 50% Icon.png — масштабовано на 50 %
• 42% Button.gif — масштабовано на 42 %

Абсолютні розміри

Синтаксис:[ширина] x [висота] [назва-ресурсу] або [ширина][одиниця] x [висота][одиниця] [назва-ресурсу]

Підтримувані одиниці вимірювання: px, in, cm, mm (пікселі можна не зазначати)

Приклади:

• 300 x 200 Hero.jpg - 300px × 200px
• 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?[назва-ресурсу] — вказує ширину, висота масштабується пропорційно
• ?x[висота] [назва-ресурсу] — вказує висоту, ширина масштабується пропорційно

Приклади:

• 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 – JPEG із якістю 90 % та фіксованим розміром 100×100 пікселів
• Delicious.gif – GIF, масштабовано на 250 %

Організація підпапок

Щоб упорядкувати вихідні файли, додайте шлях до підпапки перед назвою ресурсу:

Синтаксис:[subfolder]/[asset-name].[format]

Приклади:

• icons/Logo.png – збережено в підпапці icons
• @2x/Hero.jpg – збережено в підпапці @2x
• thumbnails/50% Photo.png – масштабовано на 50 % у підпапці thumbnails

Перевірка абсолютного масштабування

Дійсний синтаксис абсолютного масштабування

Неприпустимий синтаксис абсолютного масштабування

Обмеження на назви шарів

Непідтримувані символи:: (двокрапка) та * (зірочка) не можна використовувати в назвах шарів для генерування ресурсів.

Ігноровані рядки: Будь-який рядок без розширення файлу ігнорується в назвах шарів із кількома ресурсами. Наприклад, у рядку 100 % Delicious, 42 % Layer 1.png рядок 100 % Delicious ігнорується, оскільки він не має розширення файлу.