应用模板

用法

应用模板功能让用户能够定义可重复利用的配置，选中之后即可替代默认配置，无需另外安装 Blender 或者覆盖个人设置。

可以从启动画面或 文件 ‣ 新建 子菜单中选择应用模板。如果未找到模板，则菜单将不会显示在启动画面上。

可以从 Blender 菜单 安装新的应用模板。如果您希望在重新启动 Blender 时保持当前应用进程模板处于活动状态，请保存您的偏好设置。

动机

有些时候，写一个简单的脚本或者插件可能还不足以解决问题，一些用户可能希望有人可以为其替换用户设置和启动文件、安装脚本并修改键位映射。

应用模板的存在意在于帮助用户快速切换到自定义配置，而无需破坏已有的设置和安装环境。这意味着人们可以在 Blender 基础上自行构建易于分发的 应用。

细节

应用模板需要定义其自身以下内容：

启动文件

加载模板后的默认文件。

偏好设置

应用模板中只有某些特定用户设置才会被用到：

  • 主题。

  • 插件。

  • 键位映射。

  • 视窗照明。

启动画面

模板可以使用自定义启动画面图像。

Python脚本

模板可以与其他脚本一样访问功能，典型的操作包括：

  • 修改和替换部分用户界面。

  • 定义新的菜单、键位映射和工具。

  • 自定义模板特有插件路径。

模板也有自己的用户配置，所以使用模板时保存启动文件不会覆盖默认的启动文件。

目录布局

模板文件可以放在 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 目录布局。

Hint

路径问题排查

创建应用程序模板时，可能会遇到找不到路径的问题。要对此进行调查，您可以记录 Blender 所有路径查找的输出。

使用自定义应用程序模板加载Blender的命令行参数示例（使用您自己的模板名称替换 `` my_app_template`` ）：

  1. blender --log "bke.appdir.*" --log-level -1 --app-template my_app_template

然后，您可以检查尝试访问 my_app_template 的路径。

命令行访问

使用命令行参数可以设置 Blender 启动器以指定的应用模板启动：

  1. blender --app-template my_template

模板内容

应用模板可以配置以下文件，不过这是可选的。

startup.blend

用于该模板的初始文件。

userpref.blend

用于该模板的初始设置文件。当被忽略的设置是与默认 Blender 配置共用的。

（如前文所述，这仅仅是用户设置的子集。）

splash.png

初始屏幕，用于覆盖 Blender 的默认图稿（不包括标题文本）。请注意，此图像分辨率必须是 1000x500。

__init__.py

Python脚本必须包含 register 与 unregister 方法。

Note

自带的 blend 文件 startup.blend 和 userpref.blend 视作 初始设置，且不会被覆盖。

用户可以在使用此模板时保存自己的启动文件/偏好设置，该模板将存储在其用户配置中，但仅当模板包含自己的 userpref.blend 文档时。

与 加载初始设置 一样，用户可以从文件菜单使用 加载模板初始设置 来恢复模板的初始设置。

模板脚本

虽然应用进程模板可以使用 Python 脚本，但它们只能访问可用于加载项和任何其他脚本的相同 API。

正如上文所言，可以选择在应用模板中使用 __init__.py。这样做有以下优势：

  • 无需分发 blend 文件即可更改启动文件或偏好设置。

  • 可以动态更改。

    比如，可以配置模板为先检查处理器、操作系统和内存，然后基于此设置参数值。

  • 可以启用与模板关联的插件。

激活时，将调用 register 函数，当选择另一个模板时，将调用 unregister 。

由于这些只运行一次，因此必须通过处理进程对默认值进行任何更改。您可能使用的两个处理进程是：

  • bpy.app.handlers.load_factory_preferences_post

  • bpy.app.handlers.load_factory_startup_post

以上两者用于自定义用户可以更改的“初始设置”，就像 Blender 在首次启动时的默认值一样。

下面是一个 __init__.py 文件范例，定义了应用模板要使用的默认值。

  1. import bpy
  2. from bpy.app.handlers import persistent
  4. @persistent
  5. def load_handler_for_preferences(_):
  6.     print("Changing Preference Defaults!")
  7.     from bpy import context
  9.     prefs = context.preferences
  10.     prefs.use_preferences_save = False
  12.     kc = context.window_manager.keyconfigs["blender"]
  13.     kc_prefs = kc.preferences
  14.     if kc_prefs is not None:
  15.         kc_prefs.select_mouse = 'RIGHT'
  16.         kc_prefs.spacebar_action = 'SEARCH'
  17.         kc_prefs.use_pie_click_drag = True
  19.     view = prefs.view
  20.     view.header_align = 'BOTTOM'
  23. @persistent
  24. def load_handler_for_startup(_):
  25.     print("Changing Startup Defaults!")
  27.     # Use smooth faces.
  28.     for mesh in bpy.data.meshes:
  29.         for poly in mesh.polygons:
  30.             poly.use_smooth = True
  32.     # Use material preview shading.
  33.     for screen in bpy.data.screens:
  34.         for area in screen.areas:
  35.             for space in area.spaces:
  36.                 if space.type == 'VIEW_3D':
  37.                     space.shading.type = 'MATERIAL'
  38.                     space.shading.use_scene_lights = True
  41. def register():
  42.     print("Registering to Change Defaults")
  43.     bpy.app.handlers.load_factory_preferences_post.append(load_handler_for_preferences)
  44.     bpy.app.handlers.load_factory_startup_post.append(load_handler_for_startup)
  46. def unregister():
  47.     print("Unregistering to Change Defaults")
  48.     bpy.app.handlers.load_factory_preferences_post.remove(load_handler_for_preferences)
  49.     bpy.app.handlers.load_factory_startup_post.remove(load_handler_for_startup)