Скрипты Photoshop: первый скрипт и лучшие практики

Файловая система и скрипты Photoshop

Введение

Photoshop — мощный инструмент для обработки изображений. После освоения ручных приёмов логичный следующий шаг — автоматизация повторяющихся задач. Если вы уже знакомы с Actions (действиями), скрипты дадут больше гибкости: их можно адаптировать на лету, добавлять условия и работать с объектной моделью приложения.

Скрипты для Photoshop пишутся на JavaScript (ExtendScript — диалект, поставляемый с Adobe), поэтому если вы знакомы с основами JS, старт будет быстрым.

Кому это полезно: дизайнеры, ретушёры, разработчики инструментов для контента, менеджеры медиа-библиотек.

Ключевые термины (1 строка):

ExtendScript — версия JavaScript от Adobe для автоматизации приложений Creative Cloud.
ResampleMethod — перечисление методов ресэмплинга в API Photoshop.

Что вам понадобится

Установленный Photoshop (любая версия, поддерживающая скрипты через ExtendScript).
ExtendScript Toolkit (входит в комплект Creative Cloud в некоторых версиях) или любой текстовый редактор.
Открытый документ в Photoshop для тестирования.

Важно: в новых версиях Photoshop развивается платформа UXP (плагины), которая дополняет и постепенно заменяет старые рабочие процессы. Многие примеры в этой статье основаны на ExtendScript, который продолжает работать в большинстве сред, но для полного перехода на UXP потребуется другая модель разработки.

Ваш первый скрипт: изменить ширину изображения

Откройте ExtendScript Toolkit или редактор кода и вставьте следующий код в основной файл скрипта:

// Получаем активный документ
var current_document = app.activeDocument;
// Новая ширина в пикселях
var new_width = 670;

current_document.resizeImage(
  UnitValue(new_width, 'px'),
  null,
  null,
  ResampleMethod.BICUBIC
);

Пояснение по шагам:

app.activeDocument возвращает объект текущего документа Photoshop. Если документа нет — будет исключение.
UnitValue(new_width, ‘px’) переводит число в единицу измерения Photoshop (пиксели).
ResampleMethod.BICUBIC указывает способ ресэмплинга.

Если вы запустите этот код при закрытом документе, скрипт прервётся с ошибкой — следующий раздел поможет с отладкой.

Методы ресэмплинга — краткая справка

Методы ресэмплинга влияют на скорость и качество при изменении размера. Описание в упрощённом виде:

NearestNeighbor — очень быстрый, низкое качество (пикселизированный результат).
Bilinear — лучше, чем NearestNeighbor, но медленнее.
Bicubic — хорошее качество для большинства задач, но медленнее.
BicubicSmoother — улучшенный Bicubic для увеличения (upscaling).
BicubicSharper — улучшенный Bicubic для уменьшения (downscaling).

Важно: используйте BicubicSharper при уменьшении размеров, чтобы сохранить чёткость; при увеличении — BicubicSmoother.

Запуск и отладка в ExtendScript Toolkit

Откройте ExtendScript Toolkit.
В верхнем левом выпадающем меню «target» выберите вашу версию Photoshop (например, Adobe Photoshop CC 2017 или более позднюю, если доступно).
Нажмите кнопку “Play” (выполнить) в правой верхней части окна.

Консоль JavaScript в тулките покажет результат выполнения. Если возникла ошибка, инструмент подсветит примерную строку и покажет сообщение — используйте это для исправления опечаток или логики.

Проверяйте перед запуском:

открыт ли документ в Photoshop;
по возможности добавьте обработку ошибок (см. раздел «Отладка и устойчивость»);
сохраняйте прогресс и тестируйте на копиях файлов.

Интерфейс ExtendScript Toolkit

Отладка и устойчивость: простая обработка ошибок

Чтобы избежать падений скрипта, хорошая практика — проверять наличие документа и оборачивать критичные операции в try/catch:

try {
  if (!app.documents.length) {
    throw new Error('Нет открытого документа. Откройте файл и запустите скрипт снова.');
  }
  var doc = app.activeDocument;
  // Остальной код
} catch (e) {
  alert('Ошибка: ' + e.message);
}

Это даст понятное сообщение пользователю вместо необработанного исключения.

Добавление скрипта в меню Photoshop и автоматический запуск

Сохраните скрипт в файл с расширением .jsx. По умолчанию папка скриптов находится в Presets > Scripts в папке установки Photoshop. После копирования файла перезапустите Photoshop — скрипт появится в File > Scripts.

Если вы хотите запускать скрипт по событию (например, при открытии документа), используйте Script Events Manager в Photoshop:

File > Scripts > Script Events Manager
Включите Enable Events To Run Scripts/Actions
Выберите событие (Photoshop Event), затем ваш скрипт (Script) и нажмите Add

Script Events Manager

Альтернативный быстрый запуск: File > Scripts > Browse и выбрать файл — он выполнится немедленно.

Улучшение скрипта: не увеличивать маленькие изображения и применять корректный ресэмплинг

Если исходное изображение уже меньше целевой ширины, обычно нежелательно масштабировать его вверх — это ухудшит качество. Добавим условие и сменим метод ресэмплинга при уменьшении:

// Получаем активный документ
var current_document = app.activeDocument;  // активный документ
var new_width = 670; // желаемая ширина в пикселях

// Если документ шире, уменьшаем; если уже меньше — не меняем
if (current_document.width > UnitValue(new_width, 'px')) {
  current_document.resizeImage(
    UnitValue(new_width, 'px'),
    null,
    null,
    ResampleMethod.BICUBICSHARPER
  );
}

// Применяем автоконтраст и фильтр резкости к активному слою
current_document.activeLayer.autoContrast();
current_document.activeLayer.applySharpen();

Примечание: в исходном примере была опечатка: использовался current_doc для одного вызова — это приведёт к ошибке. Убедитесь, что используете единообразные имена переменных.

Когда скрипт не подойдёт (примеры и ограничения)

Смарт-объекты: если слой — смарт-объект, прямое применение некоторых фильтров может работать иначе; сначала распакуйте или примените преобразование.
CMYK и цветовые профили: операции с пикселями могут давать отличия при разных профилях; при пакетной обработке убедитесь в согласованности профилей.
Несоответствие единиц измерения: документы в дюймах/см потребуют конвертации или использования UnitValue.
Большие файлы и память: массовая обработка очень больших изображений может приводить к нехватке памяти и долгому времени выполнения.

Альтернативные подходы к автоматизации

Actions (Действия): хорошо для простых последовательностей GUI-операций. Быстро создавать и запускать, но не могут содержать логические ветвления.
Image Processor (File > Scripts > Image Processor): удобен для пакетной обработки целых папок, с сохранением в разных форматах.
Photoshop + Bridge: автоматизация через Bridge в сочетании со скриптами.
UXP-плагины: современный путь создания расширений с GUI, безопаснее и более масштабируемый для новых версий Photoshop.

Чеклист ролей (кто за что отвечает)

Designer:

Подготовить требования: целевая ширина, метод ресэмплинга, требования к качеству.
Проверить примеры изображений для тестирования.

Developer/Automation Engineer:

Написать скрипт, добавить обработку ошибок и логирование.
Тестировать на выборке изображений разного размера и форматов.
Развернуть в Presets > Scripts и документировать использование.

Ops / Контент-менеджер:

Создать резервные копии исходных файлов перед массовой обработкой.
Запустить скрипт на тестовой папке и проверить результаты вручную.

Быстрая шпаргалка (cheat sheet) по API/методам

app.activeDocument — текущий документ.
app.documents.length — число открытых документов.
Document.resizeImage(width, height, resolution, resampleMethod) — изменить размер.
UnitValue(value, ‘px’) — преобразовать в пиксели.
activeLayer.autoContrast() — автоконтраст для активного слоя.
activeLayer.applySharpen() — применить Sharpen к активному слою.

Мини-методология: как внедрить скрипт надежно (4 шага)

Планирование: определить требования и критерии приёмки (см. ниже).
Реализация: написать простой и понятный код с комментариями и обработкой ошибок.
Тестирование: прогон на контрольной выборке (малые, средние, большие файлы; разные профили).
Развёртывание: копирование в папку Presets > Scripts и документирование для команды.

Критерии приёмки

Скрипт успешно выполняется без ошибок на 90% тестовой выборки (реальная команда определяет порог).
Скрипт не увеличивает изображения, меньшие целевой ширины.
Для уменьшения используется ResampleMethod.BICUBICSHARPER.
Логи (или сообщения) информируют пользователя об успехе или ошибке.

Примеры тест-кейсов и приемочные проверки

Исходное изображение 4000×3000: после запуска ширина = 670 px, аспект сохранён.
Исходное изображение 500×400: после запуска изображение не изменилось.
Изображение в CMYK: операция выполняется и не ломает профиль (визуальная проверка).
Без открытого документа: скрипт выводит понятное сообщение и не падает с исключением.

Советы по производительности и безопасности

Обрабатывайте изображения партиями (папками), проверяйте использование памяти.
Для длинных операций добавляйте логирование прогресса (например, записывайте в файл). Это особенно важно для автоматических задач на сервере.
Храните скрипты и резервные копии отдельно от исходных медиа.

Совместимость и миграция: ExtendScript vs UXP

ExtendScript — привычный способ автоматизации для многих версий Photoshop и остаётся поддерживаемым в большинстве рабочих сред. Однако Adobe развивает UXP — современную платформу для плагинов и расширений, которая использует более современный JavaScript и имеет собственную среду исполнения и UI-компоненты.

Если вы разворачиваете долгосрочное решение, спланируйте стратегию миграции: начните с прототипов в ExtendScript для быстрого результата, а для крупного продукта рассмотрите портирование логики в UXP-плагин.

Роль безопасности и приватности

Если ваш скрипт работает с личными данными или автоматизирует массовую обработку изображений пользователей, убедитесь, что:

Файлы обрабатываются локально или в защищённой среде.
Логи не содержат личных данных.
Перед массовым удалением или перезаписью файлов делаются резервные копии.

План действий для развертывания (SOP)

Создать репозиторий с версией скрипта и инструкцией по установке.
Тестировать на контрольной группе изображений и получить одобрение дизайнера.
Копировать скрипт в Presets > Scripts и перезапустить Photoshop.
Провести обучающий мини-brief для команды: как запускать и где хранить резервные копии.

Частые ошибки и способы их исправления

“Undefined” в консоли — означает, что код не возвращал значение; это нормально для процедур.
Опечатки в именах переменных (например, current_doc vs current_document) — используйте единый стиль и проверяйте в редакторе.
Ошибки из-за отсутствия открытого документа — добавьте проверку app.documents.length.

Пример расширенного скрипта с логированием и проверками

// Пример расширенного скрипта
try {
  if (!app.documents.length) {
    throw new Error('Нет открытого документа. Откройте файл и запустите скрипт снова.');
  }
  var doc = app.activeDocument;
  var newWidth = 670; // px

  // Проверка: если документ шире — уменьшаем
  if (doc.width > UnitValue(newWidth, 'px')) {
    doc.resizeImage(UnitValue(newWidth, 'px'), null, null, ResampleMethod.BICUBICSHARPER);
    // Применяем автоконтраст и резкость к активному слою
    doc.activeLayer.autoContrast();
    doc.activeLayer.applySharpen();
    alert('Изображение изменено: ширина ' + newWidth + 'px.');
  } else {
    alert('Изображение меньше целевой ширины — изменений не требуется.');
  }
} catch (e) {
  alert('Ошибка при выполнении скрипта: ' + e.message);
}

Краткое резюме и следующие шаги

Вы научились:

писать простой скрипт для изменения размера в ExtendScript;
добавлять условную логику, обработку ошибок и простое логирование;
добавлять скрипт в меню Photoshop и настраивать автоматический запуск по событиям.

Дальше можно:

автоматизировать пакетную обработку папок (Image Processor + скрипты);
создать UXP-плагин с GUI для управления параметрами обработки;
расширить скрипт для сохранения копий в нескольких форматах и папках.

Важно: начинайте с малого, тестируйте на контрольной выборке и документируйте процесс для команды.

Кнопка запуска в тулките

Image Credit: whiteMocca via Shutterstock.com

КОНЕЦ: Если хотите, я могу:

подготовить UXP-черновик с простым GUI для выбора ширины;
написать пакетный скрипт, который проходит по папке и сохраняет версии в WebP/JPEG/PNG;
создать пошаговую инструкцию для CI/CD (автоматической пакетной обработки на сервере).