Proxyshop — это приложение для автоматизации Photoshop, которое генерирует высококачественные рендеры карточек Magic the Gathering. Вдохновлен оригинальными сценариями автоматизации Photoshop от Chilli-Axe. Если вам нужна помощь с этим приложением или вы хотите устранить проблему, присоединяйтесь к нашему дискорду!
Требования
- Photoshop (поддерживается 2017–2024 гг.)
- Windows (в настоящее время несовместима с Mac/Linux)
- Шаблоны Photoshop (можно скачать в приложении)
- Требуемые шрифты (включены в
fonts/
):- Прокси Белерен, жирный шрифт — для имени карты, типа, силы/выносливости.
- Проксиглиф — для символов маны, форк шрифта NDPMTG от Chilli.
- Plantin MT Pro — для текста правил установите все включенные варианты.
- Beleren Smallcaps — Кредитная линия для художников и прочее
- Gotham Medium — Для коллекционного текста
- Необязательные (но рекомендуемые) шрифты:
- Magic The Gathering — Требуется для классического шаблона
- Матрица полужирным шрифтом — требуется для шаблона Colorshifted.
- Мана — для различных дополнительных карточных символов.
Руководство по установке
- Загрузите последнюю версию и извлеките ее в папку по вашему выбору.
- Установите шрифты, включенные в папку
fonts/
. Обратите внимание, что Proxyglyph
, возможно, потребуется обновить в будущих выпусках. - Поместите изображения карт, которые вы хотите отобразить, в папку
art/
. Эти арты должны быть названы в соответствии с картой (дополнительную информацию см. в разделе «Именование арт-файлов»). - Запустите
Proxyshop.exe
. Нажмите кнопку «Обновить» . Proxyshop загрузит шаблоны, доступные для скачивания, возьмите то, что хотите. - Нажмите «Рендеринг всех» , чтобы отобразить каждую иллюстрацию карты в папке
art/
. Нажмите «Render Target» , чтобы отобразить одно или несколько определенных изображений карт. - Вы также можете перетащить художественные изображения или папки, содержащие художественные изображения, в приложение Proxyshop, Proxyshop автоматически начнет рендеринг этих карточек.
- Во время процесса рендеринга консоль внизу будет отображать текущий прогресс и сообщать вам, если возникнут какие-либо сбои.
? Именование художественных файлов
- В настоящее время поддерживаются следующие типы художественных файлов:
jpg
, jpeg
, jpf
, png
, tif
и webp
. ПРИМЕЧАНИЕ . Для webp
требуется Photoshop 2022+. - Файлы иллюстраций должны быть названы в честь настоящих карт Magic the Gathering и названы как можно более точно, например
Damnation.jpg
. - Proxyshop поддерживает несколько дополнительных тегов при именовании ваших художественных файлов, чтобы дать вам больше контроля над отображением карты!
- Установить
[SET]
— заставляет Photoshop визуализировать версию этой карты из определенного расширения MTG, соответствующую заданному коду набора . Этот тег не чувствителен к регистру, поэтому будут работать как «set», так и «SET».
- Номер коллекционера
{num}
— работает только в том случае, если также был предоставлен тег Set , отображает версию этой карты с точным кодом набора и комбинацией чисел . Это особенно полезно в тех случаях, когда в наборе есть несколько версий одной и той же карты, например, в Secret Lair (SLD) есть 3 разные версии Brainstorm .
Brainstorm [SLD] {175}.jpg
- Имя исполнителя
(Artist Name)
— при заполнении имени исполнителя Proxyshop заменит имя, присутствующее в данных Scryfall, на указанное вами имя. Это изменение носит чисто косметический характер и не влияет на получение карты и не конфликтует с другими тегами.
Brainstorm [SLD] {175} (Rusty Shackleford).jpg
- Имя создателя
$Creator Name
— этот тег не поддерживается широко стандартными шаблонами Proxyshop. Этот тег позволяет вам вставить предпочитаемое имя пользователя/дизайнера/создателя, и если шаблон поддерживает функцию имени создателя, этот текст будет помещен на указанный текстовый слой. Может использоваться как своеобразная подпись к вашей работе. ПРИМЕЧАНИЕ . Этот тег ДОЛЖЕН быть помещен в САМЫЙ КОНЕЦ имени художественного файла.
Brainstorm [SLD] {175}$My Creator Name.jpg
Использование графического интерфейса Proxyshop
Вкладка «Рендеринг карт»
- Основная вкладка для рендеринга подлинных карт Magic the Gathering.
- Render All : отображает изображение карты, используя каждое изображение, найденное в папке
art/
. - Render Target : открывает выбор файла в Photoshop, визуализирует изображение карты, используя каждое выбранное вами художественное изображение.
- Глобальные настройки : открывает панель настроек, используемую для изменения параметров всего приложения для:
- Основные настройки : влияют на поведение шаблона, могут быть изменены для отдельных шаблонов. Когда вы щелкаете значок рядом с шаблоном, для этого шаблона создается файл конфигурации, который переопределяет эти настройки.
- Системные настройки : влияют на все приложение и не могут быть изменены для отдельных шаблонов.
- Набор вкладок под этими кнопками представляет типы шаблонов , например «Обычный», MDFC, «Преобразование» и т. д.
- Типы шаблонов представляют собой разные типы шаблонов, для которых требуются разные элементы кадра или разные методы рендеринга.
- Если вкладка «Обычный» активна и вы нажимаете кнопку шаблона, этот шаблон становится выбранным для типа шаблона «Обычный» . Карты, соответствующие типу «Обычный» , теперь будут отображаться с использованием этого шаблона.
- Этот шаблон НЕ выбирается для других типов. Например, если на вкладке «Обычный» выбрано «Без границ» , а на вкладке MDFC выбрано «Обычный» . Карты, соответствующие типу MDFC, будут отображаться с использованием Normal MDFC .
- Рядом с каждым шаблоном в списке шаблонов есть две иконки:
- Позволяет изменить основные настройки для этого шаблона. Некоторые шаблоны также имеют свои собственные, специально разработанные настройки, которые вы также можете изменить.
- ? Удаляет отдельный файл конфигурации, созданный для этого шаблона, фактически возвращая этот шаблон к настройкам по умолчанию. Гарантирует, что основные настройки для этого шаблона управляются панелью «Глобальные настройки» .
- Темно-серая область под селектором шаблонов — это консоль , здесь будут отображаться сообщения о состоянии, отслеживающие ход рендеринга и другие действия пользователя.
- Справа от консоли есть несколько полезных кнопок:
- ? Закрепляет окно Proxyshop, чтобы оно оставалось над всеми другими запущенными программами.
- ? Делает снимок экрана окна Proxyshop, сохраняет его в:
out/screenshots/
- ? Открывает веб-браузер по умолчанию и переходит на страницу Proxyshop на GitHub.
- ❔ Открывает веб-браузер по умолчанию и переходит на сервер Discord нашего сообщества.
- Продолжить : становится активным, когда приложение ожидает ответа пользователя, когда включено ручное редактирование или произошла ошибка.
- Отмена : становится активной во время рендеринга карточек, позволяет отменить операцию рендеринга в любое время или в случае возникновения ошибки.
- Обновить : открывает панель средства обновления , которая позволяет загружать новые шаблоны и обновлять существующие.
Пользовательская вкладка «Создатель»
- Эта вкладка управляет создателем пользовательской карты.
- Эта функция в настоящее время считается экспериментальной бета-версией и может иметь проблемы.
- В настоящее время вы можете визуализировать карты Normal , Planeswalker или Saga , просто заполните соответствующие данные и нажмите Render Custom .
- В ближайшем будущем будут добавлены дополнительные функции и типы карт.
Вкладка «Инструменты»
- Эта вкладка содержит растущий список полезных инструментов и утилит.
- Render All Showcases : генерирует изображение витрины с рамкой для каждого изображения карточки в папке
out/
, витрины будут помещены в out/showcase/
. - Render Target Showcase : открывает выбранный файл в Photoshop, создает изображение витрины с рамкой для каждого выбранного вами изображения карты.
- Сжать изображения : этот инструмент уменьшает размер изображений карточек, хранящихся в папке
out/
. Настройки:- Качество : качество сжатия сжатого изображения в формате JPEG, поддерживается число от 1 до 100. ( Рекомендуется : 95–99)
- Оптимизировать : включает автоматический флаг оптимизации Pillow. Уменьшает размер файла с небольшим отрывом без видимых недостатков. ( Рекомендуется : Вкл.)
- 800 DPI : уменьшение изображения карточек с разрешением выше 800 DPI до максимального значения 800 DPI. Большинство шаблонов Proxyshop имеют разрешение 1200 DPI, что намного выше, чем кому-либо действительно нужно. Большинство полиграфических услуг не печатают с разрешением выше 800 DPI. ( Рекомендуется : Вкл.)
? Руководство по установке (среда Python)
Настройка среды Python для Proxyshop предназначена для опытных пользователей, участников и всех, кто хочет испачкать руки, создавая плагин или собственный шаблон для приложения! В этом руководстве предполагается, что у вас уже установлен Python. См. значок выше для поддерживаемых версий Python.
- Установите Poetry с помощью pipx.
# Install pipx and poetry
python -m pip install --user pipx
python -m pipx ensurepath
pipx install poetry
- Клонируйте Proxyshop где-нибудь в вашей системе, мы назовем его корневым каталогом .
git clone https://github.com/MrTeferi/Proxyshop.git
- Перейдите в корневой каталог и установите среду проекта.
cd proxyshop
poetry install
- Установите шрифты, включенные в папку
fonts/
. Не удаляйте их после установки, некоторые из них используются графическим интерфейсом. - Создайте папку с именем
art
в корневом каталоге. Здесь вы размещаете художественные изображения карточек, которые хотите визуализировать. - Запустите приложение.
# OPTION 1) Execute via poetry
poetry run main.py
# OPTION 2) Enter the poetry environment, then execute with cli
poetry shell
proxyshop gui
- Обратитесь к руководству по использованию для навигации по графическому интерфейсу.
? Загрузка шаблонов вручную
Если вы хотите загрузить шаблоны вручную, перейдите по этой ссылке. Эти архивы необходимо распаковать в каталог /templates
. Архивы, находящиеся в папках дисков Investigamer и SilvanMTG, необходимо распаковать в /plugins/Investigamer/templates
и /plugins/SilvanMTG/templates
соответственно.
? Как я могу поддержать Proxyshop?
Не стесняйтесь присоединяться к нашему дискорду и участвовать в канале #Proxyshop
, где мы постоянно проводим мозговой штурм и тестируем новые функции, выпускаем бета-версии и делимся новыми плагинами и шаблонами. Кроме того, рассмотрите возможность поддержки нашего Patreon, который оплачивает хостинг шаблонов Proxyshop на S3 + Cloudfront и дает нам свободу работать над приложением, а также над другими приложениями, такими как MPC Autofill, MTG Art Downloader и другими! Если вам не нравится Patreon, вы также можете купить мне кофе через Paypal. Огромное спасибо нашим замечательным сторонникам!
❓ Часто задаваемые вопросы
Как изменить установленный символ на что-то другое?
В настройках измените «Символ по умолчанию» на установленный код нужного символа и включите «Принудительно использовать символ по умолчанию». Если вы хотите добавить полностью собственный символ, вот процесс:
- Перейдите в
src/img/symbols/
и создайте папку с именем в соответствии с новым пользовательским кодом. - Добавьте свои собственные символы SVG в созданную папку, назовите каждый файл по первой букве его редкости (с заглавной буквы).
- Установите этот символ как «Символ по умолчанию» и включите «Принудительно использовать символ по умолчанию». Вы готовы идти!
Как полностью скрыть установленный символ?
В глобальных настройках или настройках конкретного шаблона измените «Режим отрисовки символов» на «Нет». Это полностью отключает символ расширения.
Как скрыть слой в шаблоне Proxyshop, чтобы он не отображался на отображаемых карточках?
В выбранном вами шаблоне Photoshop измените непрозрачность на 0 на слое, который вы хотите скрыть. Вы можете использовать этот метод, чтобы скрыть что угодно. Это безопаснее, чем просто отключить видимость слоя, поскольку слои могут быть принудительно включены и отключены приложением. Это также безопаснее, чем удаление слоя, поскольку это может вызвать ошибки в некоторых шаблонах.
Где можно найти высококачественное искусство MTG?
Вашим лучшим ресурсом будет MTG Pics. Чтобы еще больше улучшить качество графики, вы можете воспользоваться масштабированием с помощью Topaz/Chainner/ESRGAN. На нашем дискорде мы предоставляем множество ресурсов, позволяющих научиться легко и эффективно повышать качество искусства. Для массовой загрузки произведений искусства посетите мой другой проект: MTG Art Downloader.
Приложение останавливается при попытке ввести текст, и Photoshop перестает отвечать на запросы!
Существует известная ошибка, из-за которой Photoshop аварийно завершает работу при попытке ввести слишком много текста в текстовое поле. Ее следует исправить, но теоретически это может произойти в некоторых шаблонах плагинов, которые не делают текстовое поле достаточно большим. Лучший способ исправить это — открыть шаблон в Photoshop и расширить нижний край текстовых полей «Правила» (существа и несущества).
Требуемое значение отсутствует или сервер RPC не отвечает.
Иногда это может быть одной из наиболее редких, но неприятных ошибок, возникающих в некоторых системах. Иногда основная причина неизвестна, но обычно ее можно устранить. Попробуйте эти варианты по порядку, пока что-то не заработает:
- Убедитесь, что на вашем компьютере установлена ТОЛЬКО ОДНА установка Photoshop. Одновременная установка двух версий Photoshop может помешать установлению соединения с приложением. Если у вас установлено более одной версии, удалите все версии Photoshop и переустановите одну версию. Сначала вам необходимо удалить их все, простое удаление одного, скорее всего, не решит проблему.
- Убедитесь, что ваше приложение Photoshop было установлено с помощью настоящего установщика. Портативные установки Photoshop не работают с Proxyshop, поскольку Windows должна знать, где он находится.
- Закройте Photoshop и Proxyshop, затем запустите Photoshop и Proxyshop от имени администратора и попробуйте что-нибудь отрендерить.
- Закройте оба, затем удерживайте ALT + CTRL + SHIFT при запуске Photoshop, затем запустите Proxyshop и повторите попытку.
- Перезагрузите компьютер, затем запустите оба и повторите попытку.
- Если у вас работает антивирусное программное обеспечение с чрезмерной защитой, которое может мешать подключению Proxyshop к Photoshop, например Avast, Norton и т. д., закройте антивирусное программное обеспечение, перезапустите оба и повторите попытку. Вы также можете попробовать отключить Защитник Windows.
- Если есть вероятность, что ваша установка Photoshop может быть повреждена, повреждена или иным образом испорчена, рекомендуется полностью удалить Photoshop и установить последнюю версию, к которой у вас есть доступ. Как правило, Proxyshop лучше всего работает с новыми версиями Photoshop. Если вы используете неаутентичную версию Photoshop, убедитесь, что она высокого качества и использует настоящий установщик.
- Если все это не помогло решить проблему, присоединяйтесь к нашему Discord (ссылка вверху) и предоставьте журнал ошибок из
logs/error.txt
в каталоге Proxyshop, чтобы мы могли помочь найти причину :)
Стоимость маны, правила или другой текст огромны и не уменьшаются?
- В Photoshop перейдите в «Редактирование» > «Настройки» > «Единицы измерения и линейки» .
- Установите линейки на пиксели
- Установите тип «Точки»
- Проблема должна быть решена.
Фотошоп занят!
Эта ошибка возникает, когда Photoshop не отвечает на команды, поскольку занят. Чтобы предотвратить эту ошибку, вы должны убедиться, что Photoshop находится в нейтральном состоянии, когда вы запускаете Proxyshop или визуализируете карту:
- В Photoshop не должно быть открытых диалоговых окон или меню настроек. Обычные панели инструментов подходят.
- Не должно быть инструментов, выполняющих задачи, например выделения текста для редактирования с помощью инструмента «Текст».
- В идеале Photoshop следует запускать заново, без открытых документов.
Я получаю другую ошибку!
В каталоге вашего proxyshop найдите папку с именем logs
, внутри этой папки вы должны увидеть error.txt
, проверьте последний журнал ошибок в этом файле. Если ошибка не очевидна, присоединяйтесь к нашему Discord и смело обращайтесь за помощью на канале #Proxyshop.
Кредиты
- Наших замечательных сторонников на Patreon, которые буквально поддерживают этот проект.
- Chilli Axe за выдающийся проект MTG Photoshop Automation, вдохновленный Proxyshop, а также за создание множества базовых PSD-шаблонов, модифицированных для работы с Proxyshop.
- Дополнительная поддержка шаблонов и ресурсов от:
- СильванMTG
- Нелинес
- Трикс за Скута
- FeuerAmeise
- Михайггдрасиль
- Варпданди
- МалеМПК
- Витторио Масиа
- iDerp
- Тупинамба (Педро Невеш)
- Эндрю Джоя за различные проекты шрифтов, которые в прошлом использовались для Proxyshop.
- Джону Прайму, Хейвену Кингу и членам CCGHQ за предоставление символов расширения SVG.
- Хэл и другие участники из Photoshop Python API.
- Wizards of the Coast и все талантливые художники, которые делают Magic the Gathering реальностью.
- Бесчисленное множество других, кто предоставил помощь и другие ресурсы сообществу, которые сделали возможными различные функции.
- Все участники базы кода.