Генератор предупредительных записок Persona 5

Генератор предупредительных записок Persona 5 (Persona 5 Calling Card Generator, P5CCG) — это инструмент, который помогает пользователям легко создавать предупредительные записки в стиле Persona 5. Независимо от того, используется ли он для личных проектов или фанатских работ, всего за несколько минут можно создать уникальную предупредительную записку.

Объявление: P5CCG может использоваться только для разумных целей, не связанных с коммерцией. Persona 5 принадлежит ATLUS. Использование P5CCG означает, что пользователь несет ответственность за использование изображений.

Основные функции

• Генерация предупредительных записок в стиле Persona 5 — двухсторонняя!
• Пользовательский интерфейс для настройки фона, содержимого и стиля текста
• Легкий в использовании графический пользовательский интерфейс (GUI)

Примеры сгенерированных записок:

Пользовательский гайд для GUI

Этот раздел предназначен для пользователей, не знакомых с Python.> Графический пользовательский интерфейс P5CCG основан на Avalonia и требует установки .NET Runtime. Если вы не уверены, что у вас уже установлена эта среда, вы можете перейти к следующему шагу для установки, загрузки и запуска P5CCG. Если среда установлена, программа запустится; если нет, система предложит вам скачать .NET Runtime с официального сайта Microsoft.Предупреждающие записки Persona 5 известны благодаря использованию множества шрифтов, что создает впечатляющий визуальный эффект. P5CCG использует по умолчанию шрифты Noto Sans CJK и Noto Serif CJK для создания предупреждающих записок; для наилучшего визуального эффекта рекомендуется создать отдельную папку для шрифтов, в которую будут загружены нужные вам шрифты, и указать эту папку как шрифтную папку при запуске.

Получение и запуск P5CCG

Перейдите на страницу релизов этого репозитория и загрузите последнюю версию архива (в настоящее время доступна только версия для Windows). Распаковав архив, дважды щелкните по файлу P5CCG.exe в корневой папке.

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

1. Настройки формата

   1. Пропорции страницы: P5CCG предлагает множество вариантов пропорций для предупредительных писем, подходящих для печати и отображения.
   2. Цветовая схема: По умолчанию P5CCG использует оригинальную красно-черную цветовую схему из серии Persona 5 в качестве фона. Пользователи, желающие настроить цвета, могут включить "персонализацию цвета" и выбрать свои собственные.
   3. Наклейки чернил: Управление появлением чернильных наклеек как декоративного элемента.
   4. Односторонний/двухсторонний: Создание только передней части предупредительного письма или одновременное создание передней и задней частей с символом банды воров.

2. Шрифты: P5CCG по умолчанию использует шрифты Noto Sans CJK и Noto Serif CJK для предупредительных писем. Для достижения наилучшего качества пользователи могут выбрать свои собственные шрифты и указать папку шрифтов.

3. Текстовое содержимое: Текст предупредительного письма, разделенный на абзацы. Каждый абзац можно настроить по отдельности для размера шрифта и выравнивания. Нажмите кнопку "Сгенерировать", чтобы случайным образом сгенерировать предупреждающее письмо.После удовлетворения результата используйте опцию "Экспортировать", чтобы сохранить сгенерированное предупреждающее письмо на локальном устройстве.## Пользовательское руководство для продвинутых пользователей

Функция генерации изображений в P5CCG реализована с помощью Python-скриптов. Для пользователей, знакомых с Python или желающих изучить код, достаточно прочитать и внести изменения в параметры функции main() в файле demo.py. Для запуска этого скрипта необходимо установить библиотеки Pillow (PIL) и FontTools. Подробнее о настройке среды можно узнать из файла environment.yml. При использовании исходного кода P5CCG вы можете более гибко настроить и генерировать предупреждающие письма в соответствии с вашими потребностями.

Классы и параметры

Класс CallingCard

Класс CallingCard используется для прямого создания предупреждающего письма. Ниже приведены параметры, используемые при создании этого класса.- set_width: Ширина изображения в пикселях (px).

• set_height: Высота изображения в пикселях (px). Если значение равно 0, высота будет автоматически подстраиваться под содержимое.
• padding: Внутренний отступ изображения. Это может быть целое число, представляющее отступ по всем четырем сторонам, или список из 1, 2 или 4 целых чисел, представляющих отступ по сторонам [четыре стороны], [левая и правая стороны, верхняя и нижняя стороны] или [левая, верхняя, правая, нижняя].
• background: Экземпляр класса CardBackground. См. ниже.
• paragraphs: Список экземпляров класса Paragraph. См. ниже.
• font_directory: Папка со шрифтами, содержащая файлы шрифтов формата .ttf/.otf и т. д. Для пользователей Windows скрипт по умолчанию указывает на папку пользовательских шрифтов. Внимание: из-за того, что в системной папке шрифтов могут присутствовать специальные шрифты, а также из-за того, что случайное выбор шрифта может привести к использованию шрифтов с неполным набором символов, рекомендуется использовать другую папку для хранения всех используемых шрифтов.
• antialias: Целое число, используемое для сглаживания. P5CCG сначала создает изображение размером в antialias раз больше, а затем использует алгоритм Lanczos для уменьшения изображения до нужного размера, что позволяет получить более гладкое изображение. Если значение равно 1, сглаживание отключено.- watermark: Логическое значение, которое управляет созданием цифрового водяного знака. Если значение True, будет создан почти невидимый цифровой водяной знак, который содержит информацию о времени, платформе и т. д., чтобы избежать риска нарушения авторских прав.
• font_format_check: Логическое значение, которое проверяет наличие специфических символов в шрифте. Если значение True, это предотвратит вывод нечитаемого текста, но значительно замедлит выполнение.#### Класс CardBackground

Класс CardBackground используется для создания фона карты с同心圆样式。该类有两个列表形式的参数，这两个列表的длины должны быть одинаковыми.

• radii: От внутреннего к внешнему радиус увеличения для концентрических окружностей.
• colors: Цвета для концентрических окружностей от внутреннего к внешнему. Можно использовать шестнадцатеричные значения цвета (например: "#FFF" или "#FF0000").

В файле default_styles.py определен константный объект PERSONA5_BACKGROUND, представляющий собой стандартный стиль чередующихся красного и черного цветов.

Класс Paragraph

Конструктор каждого объекта Paragraph имеет два параметра.

• text: Текстовое содержимое.
• style: Объект класса ParagraphStyle, указывающий стиль данного абзаца.

Класс ParagraphStyle определяет стиль для класса Paragraph. Каждый объект Paragraph имеет собственный стиль. Конструктор стиля требует передачи следующих параметров:

• align: Выравнивание, должно быть "L" или "Left", "C" или "Center" или "Centre", "R" или "Right". Значения нечувствительны к регистру.
• float: Уникальное вертикальное смещение, измеряется в пикселях (px). Программа центрирует изображение всех символов по вертикали, а затем смещает каждый символ в диапазоне [-float, float].
• shift: Горизонтальное смещение символов, измеряется в пикселях (px). Может быть целым числом, представляющим фиксированное горизонтальное расстояние между символами, или списком из двух целых чисел, представляющим случайное смещение символов в диапазоне shift. Значение справа должно быть больше или равно значению слева.
• character_style: Стиль символов внутри абзаца. См. ниже.

Файл default_styles.py задает несколько стандартных стилей, таких как TITLE_PARAGRAPH и CONTENT_PARAGRAPH.

Класс Character

Класс Character обычно не вызывается вручную. Конструктор класса требует передачи следующих параметров:

• character: Одиночный символ для рендеринга.

• style: Объект класса CharacterStyle, определяющий стиль рендеринга.

• pattern: Объект класса Pattern, представляющий текстуру для одного символа.Важные параметры конструктора класса CharacterStyle включают:

• base_size: базовый размер шрифта для содержимого. Фактический размер текста определяется как произведение этого значения на коэффициент, распределенный по нормальному закону $N(1,0.1)$, с ограничением в диапазоне $[75%, 125%]$.

• rotate_sigma: стандартное отклонение для поворота шрифта. Фактический текст будет поворачиваться по нормальному закону $N(0,\verb|rotate_sigma|)$, где единица измерения — градусы (deg).

• stretch: максимальное значение отступа (Margin), представленное списком из двух float, которые определяют горизонтальное и вертикальное расширение текста в содержимом. Скрипт выбирает значения из этого диапазона для создания преувеличенных прямоугольников в качестве фона для каждого символа.

• swapcase_rate: вероятность изменения регистра букв в тексте, должна быть числом в диапазоне $[0,1]$. Эффективно работает только для латинских букв ASCII.

Pattern в настоящее время не имеет настраиваемых параметров. Однако можно изменить следующие глобальные параметры для настройки:- SCHEME: два варианта цветовой схемы текста: светлый фон с темным текстом ("light") или темный фон с светлым текстом ("dark").

• SCHEME_WEIGHT: вес появления цветовой схемы, по умолчанию равен [1, 1], что означает равновероятное появление. Можно настроить по своему усмотрению, например, чтобы всегда был темный фон с светлым текстом, установить [0, 1].
• PATTERN: четыре варианта текстовых фонов: однотонный, вертикальная полоска, горизонтальная полоска или сетка.
• PATTERN_WEIGHT: вес появления текстовых фонов, по умолчанию равен [15, 2, 2, 1]. Можно настроить по своему усмотрению, например, чтобы всегда был фон в виде сетки, установить [0, 0, 0, 1].

Лицензия

P5CCG (этот репозиторий)

Лицензия MIT

Авторское право (c) 2024 Horiz21

Указанное программное обеспечение и связанные с ним документы (Программное обеспечение) могут быть использованы, копированы, изменены, объединены, опубликованы, распространены, переданы в сублицензию и/или проданы, а также могут быть предоставлены лицам, которым это программное обеспечение передано, под следующими условиями:

Вышеупомянутые уведомления об авторском праве и данная лицензия должны быть включены во все копии или значительные части Программного обеспечения.
```ПРЕДСТАВЛЯЕМОЕ ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ "КАК ЕСТЬ", БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ВЫРАЖЕННЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ, ГАРАНТИЯМИ ТОРГОВЛЕНИЯ, ПРИГОДНОСТИ ДЛЯ КОНКРЕТНЫХ ЦЕЛЕЙ И НЕНАРУШЕНИЯ ПРАВ. В НИКАКОМ СЛУЧАЕ АВТОРЫ И ДОЛЖНИКИ ПО АВТОРСКИМ ПРАВАМ НЕ МОГУТ БЫТЬ ОТВЕТСТВЕННЫМИ ЗА КАКИЕ-ЛИБО ПОТЕРИ, УЩЕРБЫ ИЛИ ДРУГИЕ ОТВЕТСТВЕННОСТИ, ВОЗНИКШИЕ ПО ДЕЙСТВИЮ КОНТРАКТА, ДЕЛИКТА ИЛИ ИНЫХ ДЕЙСТВИЙ, ВОЗНИКШИХ ИЗ, В СВЯЗИ С ИЛИ В СВЯЗИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ ИЛИ ИСПОЛЬЗОВАНИЕМ ИЛИ ДРУГИМИ ДЕЙСТВИЯМИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ.
```### Шрифты

1. **Source Han Sans**: SIL Open Font License, Version 1.1. Подробнее [здесь](https://github.com/adobe-fonts/source-han-sans).
2. **Source Han Serif**: SIL Open Font License, Version 1.1. Подробнее [здесь](https://github.com/adobe-fonts/source-han-serif).