Шаблони Застосунку – Application Templates¶
Використання – Usage¶
Шаблони застосунку – це функція, що дозволяє вам визначати повторно використовувану конфігурацію, яка може бути обрана замість стандартної конфігурації, без потреби окремого іншого установлення Blender’а або перезапису ваших персональних параметрів.
Шаблони застосунку можна вибрати з екрана заставки або підменю «Файл > Нове»
. Коли там жодних шаблонів не знайдено, то це меню не буде показуватися на екрані заставки.Нові шаблони застосунку можуть бути інстальовані з Меню Застосунку – App Menu. Якщо ви бажаєте утримувати поточний шаблон застосунку активним при перезапуску Blender, то збережіть ваші уподобання.
Мотивація – Motivation¶
У деяких випадках не достатньо написати один скрипт або додаток, та очікувати, що хтось замінить його в уподобаннях та запусковому файлі, інсталює скрипти та змінить їх розкладку клавіш.
Метою шаблонів застосунку є підтримка перемикання на кастомізовану конфігурацію без руйнування ваших наявних устав та інсталяції. Це означає, що люди можуть вибудовувати свої власні застосунки поверх Blender’а, що можуть легко поширюватися.
Деталі – Details¶
Шаблон застосунку може бути визначено через:
- Запусковий Файл – Startup File
Стандартний файл для завантаження за допомогою цього шаблону.
- Уподобання – Preferences
З шаблону використовуються лише певні уподобання:
Теми – Themes.
Додатки – Add-ons.
Розкладки клавіш – Keymaps.
Освітлювання оглядвікна – Viewport lighting.
- Екран Заставки – Splash Screen
Шаблони можуть забезпечувати свої власні зображення екрану заставки.
- Скрипти Python – Python Scripts
Коли шаблони мають доступ до такої самої функціональності, як і будь-які інші скрипти, то їх типові операції включають:
Модифікування та замінювання частин інтерфейсу користувача.
Визначання новий меню, розкладок клавіш та засобів.
Визначення кастомного шляху додатків для визначених шаблоном додатків.
Шаблони також мають свою власну конфігурацію користувача, а тому зберігання запускового файлу на основі шаблону не буде перезаписувати ваш стандартний запусковий файл.
Розстава Каталогів – Directory Layout¶
Шаблони можуть бути розміщені в одному з двох місць у межах каталогу scripts
.
- Місця шаблонів:
{BLENDER_USER_SCRIPTS}/startup/bl_app_templates_user
{BLENDER_SYSTEM_SCRIPTS}/startup/bl_app_templates_system
Конфігурація користувача зберігається у підкаталогу:
- Без шаблону:
./config/startup.blend
./config/userpref.blend
- Із шаблоном:
./config/{APP_TEMPLATE_ID}/startup.blend
./config/{APP_TEMPLATE_ID}/userpref.blend
Дивіться Розстава Каталогів Blender’а – Blender’s Directory Layout щодо деталей про розміщення скриптів та конфігурацій.
Доступ до Командного Рядка – Command Line Access¶
Використовуючи аргументи командного рядка – command-line arguments, ви можете установити запускач, що відкриває Blender із конкретним шаблоном застосунку:
blender --app-template my_template
Вміст Шаблону – Template Contents¶
Кожен із наступних файлів може використовуватися шаблонами застосунку, але це необов’язково.
startup.blend
Заводський запусковий файл для використання цим шаблоном.
userpref.blend
Файл заводських уподобань для використання для цього шаблону. Коли пропущені уподобання спільно використовуються зі стандартною конфігурацією Blender’а.
(Як зазначено попередньо, це використовується тільки для піднабору уподобань).
splash.png
,splash_2x.png
Екран заставки для заміщення стандартної ілюстрації Blender’а (не включаючи текст заголовка). Повинен бути
501x250
та1002x500
(використовується для моніторів HiDPI).__init__.py
Скрипт Python, що повинен містити функції
register
таunregister
.
Примітка
Файли startup.blend
і userpref.blend
, що постачаються у пакунку з ним, вважаються Заводськими Уставами – Factory Settings та ніколи не перезаписуються.
Користувач може зберігати свої власні запусковий файл/уподобання, і при використанні такого шаблону це буде збережено в його конфігурації користувача, але лише коли шаблон включає його власний файл userpref.blend
.
Початкові установки шаблону можуть бути завантажені за допомогою команди: «Завантажити Заводські Устави Шаблону» – Load Template Factory Settings з меню «Файл», таким же чином, як відновлюються загальні заводські установки командою «Завантажити Заводські Устави» – Load Factory Settings.
Скрипти Шаблонів – Template Scripts¶
Хоча шаблони застосунків можуть використовувати скрипти Python, вони просто мають доступ до таких же API, доступних для додатків та інших скриптів.
Як зазначалося вище, ви можете факультативно мати __init__.py
у вашому шаблоні застосунку. Це має наступні переваги:
Зміни можуть бути зроблені у запусковому файлі або в уподобаннях без потреби поширенні на blend-файл.
Зміни можуть робитися динамічно.
Ви можете, наприклад, – конфігурувати шаблон для перевірки кількості процесорів, операційної системи та пам’яті, а потім задавати значення на основі цього.
Ви можете вмикати додатки, асоційовані з вашим шаблоном.
При активації функція register
викликається, unregister
викликається, коли інший шаблон вибрано.
Як тільки вони виконані хоч раз, будь-які зміни у стандарти повинні робитися через обробник. Два обробники, що ви, ймовірно, будете використовувати:
bpy.app.handlers.load_factory_preferences_post
bpy.app.handlers.load_factory_startup_post
Вони дозволяють вам визначати ваші власні «заводські устави», які користувач може змінювати, так само як Blender має його власні стандарти, коли запускається уперше.
Це приклад файлу __init__.py
, який визначає стандарти для використання шаблону застосунку.
import bpy
from bpy.app.handlers import persistent
@persistent
def load_handler_for_preferences(_):
print("Changing Preference Defaults!")
from bpy import context
prefs = context.preferences
prefs.use_preferences_save = False
kc = context.window_manager.keyconfigs["blender"]
kc_prefs = kc.preferences
if kc_prefs is not None:
kc_prefs.select_mouse = 'RIGHT'
kc_prefs.spacebar_action = 'SEARCH'
kc_prefs.use_pie_click_drag = True
view = prefs.view
view.header_align = 'BOTTOM'
@persistent
def load_handler_for_startup(_):
print("Changing Startup Defaults!")
# Use smooth faces.
for mesh in bpy.data.meshes:
for poly in mesh.polygons:
poly.use_smooth = True
# Use material preview shading.
for screen in bpy.data.screens:
for area in screen.areas:
for space in area.spaces:
if space.type == 'VIEW_3D':
space.shading.type = 'MATERIAL'
space.shading.use_scene_lights = True
def register():
print("Registering to Change Defaults")
bpy.app.handlers.load_factory_preferences_post.append(load_handler_for_preferences)
bpy.app.handlers.load_factory_startup_post.append(load_handler_for_startup)
def unregister():
print("Unregistering to Change Defaults")
bpy.app.handlers.load_factory_preferences_post.remove(load_handler_for_preferences)
bpy.app.handlers.load_factory_startup_post.remove(load_handler_for_startup)