UI: Add themes preferences preset management section #104820

Merged
Aaron Carlisle merged 4 commits from dupoxy/blender-manual:themes-pref into blender-v4.2-release 2024-06-26 00:05:17 +02:00
Showing only changes of commit 6693cd6f88 - Show all commits

View File

@ -1,5 +1,3 @@
.. _bpy.ops.preferences.theme_install:
.. _bpy.ops.preferences.reset_default_theme:
.. _bpy.types.Theme:
******
@ -15,12 +13,39 @@ change in the multi-choice list at the left, and adjusting colors as required.
Notice that changes appear in real-time on your screen. In addition, details such as the dot size
in the *3D Viewport* or the *Graph Editor* can also be changed.
Themes use Blender's preset system to save a theme.
Preset Management
=================
Theme Presets
Select the Theme from a list of predefined Themes.
.. _bpy.ops.wm.interface_theme_preset_add:
You add a custom theme to the preset list by ``LMB`` on the *Add* button ``+``.
.. _bpy.ops.wm.interface_theme_preset_remove:
You remove a custom theme from the preset list by ``LMB`` on the *Remove* button ``-``.
.. _bpy.ops.wm.interface_theme_preset_save:
You save a custom theme in the preset list by ``LMB`` on the *Save* button.
This will save the theme to an XML file in the ``./scripts/presets/interface_theme/`` subdirectory of one of
the :doc:`configuration directories </advanced/blender_directory_layout>`.
.. figure:: /images/editors_preferences_themes_example.png
.. _bpy.ops.preferences.theme_install:
Install
Load and apply a Blender XML theme file and add it to the list of theme presets.
.. _bpy.ops.preferences.reset_default_theme:
Reset
Reset to the default theme colors.
Blender comes bundled with a small selection of themes.
.. figure:: /images/editors_preferences_themes_example.png
This is an example of the theme *Blender Light*.