Командная строка


С помощью командной строки можно создавать изображения Вашего продукта в автоматическом режиме без участия пользователя. Составить команду можно используя справку или инструмент Пакетная обработка.

Для запуска Cover Commander в режиме командной строки:

  1. Нажмите кнопку Пуск на рабочем столе и выберите в меню пункт Выполнить....

  2. В окне Запуск программы нажмите кнопку Обзор..., перейдите в папку программы Cover Commander и выберите исполняемый файл CoverCommander.exe.

  3. Дополните команду нужными опциями и нажмите OK.

Пакетный режим


Произвести обработку больших объёмов данных - множество проектов или проект для множества обложек - можно используя маску в имени файла. Ниже Вы можете найти примеры использования разных вариантов пакетной обработки из командной строки.

Опции командной строки


CoverCommander.exe -b файл_проекта [-r] [-result файл_обложки] [-front[_N] файл_обложки] [-left[_N] файл_обложки] [-top[_N] файл_обложки] [-right[_N] файл_обложки] [-back[_N] файл_обложки] [-bottom[_N] файл_обложки] [-screen[_N] файл_обложки] [-disc[_N] файл_обложки] [-color[_N] значение] [-text[_N] текст] [-find[_N] текст_для_замены] [-zoom значение] [-shadow on|off] [-reflection on|off] [-background значение] [-imagesizeincludemargin] [-imagekeepprop on|off] [-imagewidth значение] [-imageheight значение] [-imagemargin значение] [-imagemarginx значение] [-imagemarginy значение] [-imagemarginx1 значение] [-imagemarginx2 значение] [-imagemarginy1 значение] [-imagemarginy2 значение] [-imagedpi значение] [-imageformat значение]

где:

Параметр Сокр. вариант Описание
файл_проекта имя файла проекта или маска для нескольких файлов (например, *.cpj)
-r обработка всех подкаталогов при использовании маски в имени файла проекта или обложки
-result файл_обложки -res файл_обложки имя файла генерируемого изображения
-front[_N] файл_обложки -s0[_N] файл_обложки имя файла обложки для фронтальной стороны (для N-го объекта, если необходимо) или маска при обработке нескольких обложек для одного проекта (например, *.png)
-top[_N] файл_обложки -s1[_N] файл_обложки имя файла обложки для верхней стороны или маска
-left[_N] файл_обложки -s2[_N] файл_обложки имя файла обложки для левой стороны или маска
-right[_N] файл_обложки -s3[_N] файл_обложки имя файла обложки для правой стороны или маска
-back[_N] файл_обложки -s4[_N] файл_обложки имя файла обложки для задней стороны или маска
-bottom[_N] файл_обложки -s5[_N] файл_обложки имя файла обложки для нижней стороны или маска
-screen[_N] файл_обложки -s6[_N] файл_обложки имя файла обложки для экрана (смартфон, планшет и т.д.) или маска
-disc[_N] файл_обложки -s7[_N] файл_обложки имя файла обложки для диска (коробка с диском, dvd с диском и т.д.) или маска
-color[_N] значение -c[_N] значение основной цвет объекта (hex-формат RRGGBB или auto)
-text[_N] текст -t[_N] текст текст для рендеринга (для 3D текста). Если Вы хотите заменить в проекте не весь текст, а только часть, используйте -find
-find[_N] текст_для_замены -f[_N] текст_для_замены текст, который будет заменён текстом -text. Если Вы хотите произвести несколько замен, используйте разделитель || (см. примеры)
-zoom значение -z значение изменение масштаба сцены
-shadow on|off -sh on|off включить/выключить тень
-reflection on|off -rf on|off включить/выключить отражение
-background значение -bg значение цвет фона (hex-формат RRGGBB)
-imagesizeincludemargin
-imagekeepprop on|off
-imagewidth значение
-imageheight значение
-imagemargin значение
-imagemarginx значение
-imagemarginy значение
-imagemarginx1 значение
-imagemarginx2 значение
-imagemarginy1 значение
-imagemarginy2 значение
-imagedpi значение
-imageformat значение
-is
-ikp on|off
-iw значение
-ih значение
-im значение
-imx значение
-imy значение
-imx1 значение
-imx2 значение
-imy1 значение
-imy2 значение
-id значение
-if значение
настройки генерируемого изображения

Вы можете использовать маску только в одном месте. Например, Вы не можете использовать маску и в имени файла проекта и в имени файла обложки или в двух разных обложках

В именах файлов могут быть использованы следующие замены (макросы):

  • {PROJECT_PATH} - путь к файлу проекта;
  • {PROJECT_FILE} - имя файла проекта (без расширения);
  • {PROJECT_PATH_FILE} - путь/имя файла проекта;
  • {PROJECT_WILDCARD} - подстановочная часть имени файла (часть под звёздочкой, если в имени файла используется маска для обработки множества проектов);
  • {PROJECT_PATH_WILDCARD} - путь/подстановочная часть имени файла проекта.

Если Вы используете маску в имени файла какой-либо обложки, Вы можете использовать замены в именах файлов других обложек:

  • {IMAGE_PATH} - путь к файлу обложки;
  • {IMAGE_FILE} - имя файла обложки (без расширения);
  • {IMAGE_EXT} - расширение файла обложки;
  • {IMAGE_PATH_FILE} - путь/имя файла обложки;
  • {IMAGE_WILDCARD} - подстановочная часть имени файла (часть под звёздочкой);
  • {IMAGE_PATH_WILDCARD} - путь/подстановочная часть имени файла обложки.

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

  • Путь к CoverCommander.exe:

    "C:\Program Files (x86)\Insofta Cover Commander\CoverCommander.exe"

  • "_Путь_\CoverCommander.exe" -b c:\work\screenshot.cpj

  • "_Путь_\CoverCommander.exe" -b c:\work\screenshot.cpj -front c:\work\*.png -result {IMAGE_FILE}_res.png

  • "_Путь_\CoverCommander.exe" -b c:\work\two_screenshots.cpj -front c:\work\first_ss\*.png -front_2 c:\work\second_ss\{IMAGE_FILE}.png -result c:\work\result_ss\{IMAGE_FILE}.png

  • "_Путь_\CoverCommander.exe" -b c:\work\*.cpj

  • В этом примере будут заменены строки "Год" на "Новый год" и "2020" на "2021":

    "_Путь_\CoverCommander.exe" -b c:\work\menu.cpj -find "Год||2020" -text "Новый год||2021"

  • В последнем примере, имя результирующего файла "{PROJECT_PATH}{PROJECT_FILE}_res.png" после замены преобразуется в "c:\work\books\book1_res.png" для проекта "c:\work\books\book1.cpj":

    "_Путь_\CoverCommander.exe" -b c:\work\*.cpj -r -result {PROJECT_PATH}{PROJECT_FILE}_res.png

Связанные темы