2022-02-11 03:56:03 +00:00
|
|
|
/* SPDX-License-Identifier: GPL-2.0-or-later */
|
2011-02-25 10:34:04 +00:00
|
|
|
|
2011-02-25 13:14:27 +00:00
|
|
|
/** \defgroup render Rendering
|
|
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
2012-02-27 20:27:19 +00:00
|
|
|
/** \defgroup bmesh BMesh
|
|
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
2021-12-14 07:35:31 +00:00
|
|
|
/** \defgroup compositor Compositing
|
|
|
|
|
* \ingroup blender */
|
2011-02-25 10:34:04 +00:00
|
|
|
|
|
|
|
|
/** \defgroup python Python
|
2012-02-27 20:27:19 +00:00
|
|
|
* \ingroup blender
|
2011-02-25 10:34:04 +00:00
|
|
|
*/
|
|
|
|
|
|
2011-02-27 20:44:37 +00:00
|
|
|
/** \defgroup pygen Python Generic
|
|
|
|
|
* \ingroup python
|
|
|
|
|
*/
|
|
|
|
|
|
2011-11-05 01:48:10 +00:00
|
|
|
/** \defgroup pymathutils Python Mathutils
|
|
|
|
|
* \ingroup python
|
|
|
|
|
*/
|
|
|
|
|
|
2011-02-27 20:44:37 +00:00
|
|
|
/** \defgroup pythonintern Python RNA and Operators
|
|
|
|
|
* \ingroup python
|
|
|
|
|
*/
|
|
|
|
|
|
2011-02-25 10:34:04 +00:00
|
|
|
/* ================================ */
|
|
|
|
|
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup blender Blender */
|
2011-02-25 10:34:04 +00:00
|
|
|
|
2019-02-18 00:23:17 +00:00
|
|
|
/** \defgroup balembic BlenderAlembic
|
|
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
|
|
|
|
|
2015-08-17 21:10:01 +00:00
|
|
|
/** \defgroup blt BlenTranslation
|
|
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
|
|
|
|
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup blf BlenFont
|
2011-02-27 20:44:37 +00:00
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
|
|
|
|
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup bke BlenKernel
|
2011-02-25 10:34:04 +00:00
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
|
|
|
|
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup bli BlenLib
|
2011-02-25 10:34:04 +00:00
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
|
|
|
|
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup depsgraph Dependency Graph
|
2011-02-25 10:34:04 +00:00
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
|
|
|
|
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup bph Physics
|
|
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup nodes Nodes
|
|
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup cmpnodes Nodes (Compositor)
|
2011-02-27 20:44:37 +00:00
|
|
|
* \ingroup nodes
|
|
|
|
|
*/
|
|
|
|
|
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup shdnodes Nodes (Shader)
|
2011-02-27 20:44:37 +00:00
|
|
|
* \ingroup nodes
|
|
|
|
|
*/
|
|
|
|
|
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup texnodes Nodes (Texture)
|
2011-02-27 20:44:37 +00:00
|
|
|
* \ingroup nodes
|
|
|
|
|
*/
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup modifiers Object Modifiers
|
2011-02-25 10:34:04 +00:00
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
|
|
|
|
|
2019-02-18 00:23:17 +00:00
|
|
|
/** \defgroup shader_fx Shader Effects
|
|
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
|
|
|
|
|
2021-12-14 07:35:31 +00:00
|
|
|
/** \defgroup data DNA, RNA and .blend access
|
|
|
|
|
* \ingroup blender */
|
2011-02-25 10:34:04 +00:00
|
|
|
|
2011-02-25 13:14:27 +00:00
|
|
|
/** \defgroup gpu GPU
|
|
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
|
|
|
|
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup ikplugin IK Plugin
|
2011-02-25 13:14:27 +00:00
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
2011-02-25 10:34:04 +00:00
|
|
|
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup DNA Struct DNA (File Format)
|
2011-02-25 13:14:27 +00:00
|
|
|
* \ingroup blender data
|
2011-02-25 10:34:04 +00:00
|
|
|
*/
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup RNA RNA (Data API)
|
2011-02-25 13:14:27 +00:00
|
|
|
* \ingroup blender data
|
2011-02-25 10:34:04 +00:00
|
|
|
*/
|
|
|
|
|
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup blenloader Blend file IO
|
2011-02-25 13:14:27 +00:00
|
|
|
* \ingroup blender data
|
2011-02-27 20:44:37 +00:00
|
|
|
* \todo check if \ref blo and \ref blenloader groups can be
|
|
|
|
|
* merged in docs.
|
2011-02-25 10:34:04 +00:00
|
|
|
*/
|
|
|
|
|
|
2021-12-14 07:35:31 +00:00
|
|
|
/**
|
|
|
|
|
* \defgroup gui GUI
|
|
|
|
|
* \ingroup blender */
|
2011-02-25 10:34:04 +00:00
|
|
|
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup wm Window Manager
|
2021-12-14 07:35:31 +00:00
|
|
|
* \ingroup gui */
|
2011-02-25 10:34:04 +00:00
|
|
|
|
2011-02-25 13:14:27 +00:00
|
|
|
/* ================================ */
|
|
|
|
|
|
2011-02-25 10:34:04 +00:00
|
|
|
/** \defgroup editors Editors
|
|
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
|
|
|
|
|
2011-02-25 13:14:27 +00:00
|
|
|
/** \defgroup edanimation animation
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup edarmature armature
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
2020-12-11 22:16:29 +00:00
|
|
|
/** \defgroup edasset asset
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
2011-02-25 13:14:27 +00:00
|
|
|
/** \defgroup edcurve curve
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup eddatafiles datafiles
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
2018-09-12 22:33:21 +00:00
|
|
|
/** \defgroup edgizmolib gizmo library
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
2011-02-25 13:14:27 +00:00
|
|
|
/** \defgroup edgpencil gpencil
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup edinterface interface
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
2018-03-19 13:49:59 +00:00
|
|
|
/** \defgroup edlattice lattice
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
2011-02-25 13:14:27 +00:00
|
|
|
/** \defgroup edmesh mesh
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup edmeta metaball
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup edobj object
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup edphys physics
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup edrend render
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup edscr screen
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
Main Workspace Integration
This commit does the main integration of workspaces, which is a design we agreed on during the 2.8 UI workshop (see https://wiki.blender.org/index.php/Dev:2.8/UI/Workshop_Writeup)
Workspaces should generally be stable, I'm not aware of any remaining bugs (or I've forgotten them :) ). If you find any, let me know!
(Exception: mode switching button might get out of sync with actual mode in some cases, would consider that a limitation/ToDo. Needs to be resolved at some point.)
== Main Changes/Features
* Introduces the new Workspaces as data-blocks.
* Allow storing a number of custom workspaces as part of the user configuration. Needs further work to allow adding and deleting individual workspaces.
* Bundle a default workspace configuration with Blender (current screen-layouts converted to workspaces).
* Pressing button to add a workspace spawns a menu to select between "Duplicate Current" and the workspaces from the user configuration. If no workspaces are stored in the user configuration, the default workspaces are listed instead.
* Store screen-layouts (`bScreen`) per workspace.
* Store an active screen-layout per workspace. Changing the workspace will enable this layout.
* Store active mode in workspace. Changing the workspace will also enter the mode of the new workspace. (Note that we still store the active mode in the object, moving this completely to workspaces is a separate project.)
* Store an active render layer per workspace.
* Moved mode switch from 3D View header to Info Editor header.
* Store active scene in window (not directly workspace related, but overlaps quite a bit).
* Removed 'Use Global Scene' User Preference option.
* Compatibility with old files - a new workspace is created for every screen-layout of old files. Old Blender versions should be able to read files saved with workspace support as well.
* Default .blend only contains one workspace ("General").
* Support appending workspaces.
Opening files without UI and commandline rendering should work fine.
Note that the UI is temporary! We plan to introduce a new global topbar
that contains the workspace options and tabs for switching workspaces.
== Technical Notes
* Workspaces are data-blocks.
* Adding and removing `bScreen`s should be done through `ED_workspace_layout` API now.
* A workspace can be active in multiple windows at the same time.
* The mode menu (which is now in the Info Editor header) doesn't display "Grease Pencil Edit" mode anymore since its availability depends on the active editor. Will be fixed by making Grease Pencil an own object type (as planned).
* The button to change the active workspace object mode may get out of sync with the mode of the active object. Will either be resolved by moving mode out of object data, or we'll disable workspace modes again (there's a `#define USE_WORKSPACE_MODE` for that).
* Screen-layouts (`bScreen`) are IDs and thus stored in a main list-base. Had to add a wrapper `WorkSpaceLayout` so we can store them in a list-base within workspaces, too. On the long run we could completely replace `bScreen` by workspace structs.
* `WorkSpace` types use some special compiler trickery to allow marking structs and struct members as private. BKE_workspace API should be used for accessing those.
* Added scene operators `SCENE_OT_`. Was previously done through screen operators.
== BPY API Changes
* Removed `Screen.scene`, added `Window.scene`
* Removed `UserPreferencesView.use_global_scene`
* Added `Context.workspace`, `Window.workspace` and `BlendData.workspaces`
* Added `bpy.types.WorkSpace` containing `screens`, `object_mode` and `render_layer`
* Added Screen.layout_name for the layout name that'll be displayed in the UI (may differ from internal name)
== What's left?
* There are a few open design questions (T50521). We should find the needed answers and implement them.
* Allow adding and removing individual workspaces from workspace configuration (needs UI design).
* Get the override system ready and support overrides per workspace.
* Support custom UI setups as part of workspaces (hidden panels, hidden buttons, customizable toolbars, etc).
* Allow enabling add-ons per workspace.
* Support custom workspace keymaps.
* Remove special exception for workspaces in linking code (so they're always appended, never linked). Depends on a few things, so best to solve later.
* Get the topbar done.
* Workspaces need a proper icon, current one is just a placeholder :)
Reviewed By: campbellbarton, mont29
Tags: #user_interface, #bf_blender_2.8
Maniphest Tasks: T50521
Differential Revision: https://developer.blender.org/D2451
2017-06-01 17:56:58 +00:00
|
|
|
/** \defgroup edscene scene
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
2011-02-25 13:14:27 +00:00
|
|
|
/** \defgroup edsculpt sculpt and paint
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup edsnd sound
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spaction action space
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spapi space API
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spbuttons buttons space
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spconsole console space
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spfile fileselector
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spgraph graph editor
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spimage image and UV editor
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spinfo info space
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spnla NLA editor
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spnode node editor
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spoutliner outliner space
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spscript script space
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spseq sequencer
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spsnd sound space
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup sptext text editor
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup sptime time line
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spuserpref user preferences
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup spview3d 3D view
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup edtransform transform
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup edutil editor utilities
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
2018-04-02 13:02:08 +00:00
|
|
|
/** \defgroup edundo undo utilities
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
2011-02-25 13:14:27 +00:00
|
|
|
/** \defgroup spuv UV editing
|
|
|
|
|
* \ingroup editors
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/* ================================ */
|
|
|
|
|
|
2011-02-25 10:34:04 +00:00
|
|
|
/** \defgroup editorui Interface and Widgets
|
|
|
|
|
* \ingroup gui
|
|
|
|
|
*/
|
|
|
|
|
|
2021-12-14 07:35:31 +00:00
|
|
|
/** \defgroup externformats External Formats
|
|
|
|
|
* \ingroup blender */
|
2011-02-25 10:34:04 +00:00
|
|
|
|
|
|
|
|
/** \defgroup collada COLLADA
|
|
|
|
|
* \ingroup externformats
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup avi AVI
|
|
|
|
|
* \ingroup externformats
|
|
|
|
|
*/
|
|
|
|
|
|
2015-05-20 02:54:45 +00:00
|
|
|
/** \defgroup imbuf Image Buffer (ImBuf)
|
2011-02-25 13:14:27 +00:00
|
|
|
* \ingroup blender
|
|
|
|
|
*/
|
2011-02-25 10:34:04 +00:00
|
|
|
|
2011-02-27 20:44:37 +00:00
|
|
|
/** \defgroup imbcineon Cineon
|
|
|
|
|
* \ingroup imbuf
|
|
|
|
|
*/
|
|
|
|
|
|
2012-02-27 20:27:19 +00:00
|
|
|
/** \defgroup imbdds DDS
|
2011-02-27 20:44:37 +00:00
|
|
|
* \ingroup imbuf
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** \defgroup openexr OpenEXR
|
|
|
|
|
* \ingroup imbuf
|
|
|
|
|
*/
|
|
|
|
|
|
2011-02-25 13:28:22 +00:00
|
|
|
/* ================================ */
|
|
|
|
|
|
2011-02-25 10:34:04 +00:00
|
|
|
/** \defgroup undoc Undocumented
|
2021-12-14 07:35:31 +00:00
|
|
|
*
|
|
|
|
|
* \brief Modules and libraries that are still undocumented,
|
|
|
|
|
* or lacking proper integration into the doxygen system, are marked in this group.
|
|
|
|
|
*/
|
