[Bf-docboard-svn] bf-manual: [9370] branches/blender-3.2-release/blender_docs/manual/interface/window_system: Improve "Window System" section
Aaron Carlisle
noreply at blender.org
Sat Jun 18 00:26:41 CEST 2022
Revision: 9370
https://developer.blender.org/rBM9370
Author: Blendify
Date: 2022-06-18 00:26:41 +0200 (Sat, 18 Jun 2022)
Log Message:
-----------
Improve "Window System" section
Author: D15208
Differential Revision: https://developer.blender.org/D15208
Modified Paths:
--------------
branches/blender-3.2-release/blender_docs/manual/interface/window_system/areas.rst
branches/blender-3.2-release/blender_docs/manual/interface/window_system/introduction.rst
branches/blender-3.2-release/blender_docs/manual/interface/window_system/regions.rst
branches/blender-3.2-release/blender_docs/manual/interface/window_system/splash.rst
branches/blender-3.2-release/blender_docs/manual/interface/window_system/status_bar.rst
branches/blender-3.2-release/blender_docs/manual/interface/window_system/tabs_panels.rst
branches/blender-3.2-release/blender_docs/manual/interface/window_system/topbar.rst
branches/blender-3.2-release/blender_docs/manual/interface/window_system/workspaces.rst
Modified: branches/blender-3.2-release/blender_docs/manual/interface/window_system/areas.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/interface/window_system/areas.rst 2022-06-17 20:42:32 UTC (rev 9369)
+++ branches/blender-3.2-release/blender_docs/manual/interface/window_system/areas.rst 2022-06-17 22:26:41 UTC (rev 9370)
@@ -12,17 +12,26 @@
Area boundaries are indicated by rounded corners (yellow highlights).
-The Blender window is divided up into a number of rectangles called Areas.
-Areas reserve screen space for :doc:`/editors/index`, such as the 3D Viewport, or the Outliner.
-In general an Editor provides a way to view and modify your work through a specific part of Blender.
-All hotkeys you press will affect the contents of the Editor in the Area the mouse pointer is located.
-Area boundaries are indicated by rounded (beveled) corners.
+The Blender window is divided into a number of rectangles called Areas.
+Areas reserve screen space for :doc:`/editors/index`, such as the
+:doc:`3D Viewport </editors/3dview/introduction>` or the
+:doc:`Outliner </editors/outliner/introduction>`.
+Each editor offers a specific piece of functionality.
-Areas can be customized to match specific tasks called
-:doc:`Workspaces </interface/window_system/workspaces>`,
-which can then be named and saved for later use.
+Areas are grouped into :doc:`Workspaces </interface/window_system/workspaces>`,
+which are geared towards particular tasks (modeling, animating and so on).
+.. note::
+ While some keyboard shortcuts in Blender are global (such as :kbd:`Ctrl-S`
+ for saving), many depend on which editor the mouse cursor is hovering over.
+ As an example, say you just selected two objects in the Outliner and want
+ to join them. If you pressed the shortcut for this (:kbd:`Ctrl-J`)
+ while the cursor is still in the Outliner, nothing would happen as the
+ shortcut isn't valid there; you first need to move your cursor
+ to the 3D Viewport.
+
+
Resizing
========
@@ -46,8 +55,8 @@
Splitting an area will create a new area. Placing the mouse cursor
in an area corner will change the cursor to a cross (+) to indicate that
-pressing down :kbd:`LMB` will activate splitting or joining operator.
-Dragging from area corner **inward** will *split* the area.
+pressing down :kbd:`LMB` will activate splitting or joining.
+Dragging from an area corner **inward** will *split* the area.
You define the split direction by dragging either horizontally or vertically.
@@ -63,12 +72,19 @@
Dragging from an area corner **outward** will *join* two areas.
The area that will be closed shows a dark overlay.
-You can select which area will be closed by moving the mouse over areas.
+You can select which area will be closed by moving the mouse over it.
Release the :kbd:`LMB` to complete the join.
If you press :kbd:`Esc` or :kbd:`RMB` before releasing the mouse,
the operation will be canceled.
+.. tip::
+ The cursor will also turn into a cross when hovering over either
+ end of the border between two areas. When splitting or joining,
+ it's best not to start dragging from this border, but from a
+ corner inside one of the areas.
+
+
Area Options
^^^^^^^^^^^^
@@ -86,7 +102,7 @@
Swapping Contents
-----------------
-You can swap the contents between two areas with :kbd:`Ctrl-LMB`
+You can swap the contents of two areas by pressing :kbd:`Ctrl-LMB`
on one of the corners of the initial area, dragging towards the target area,
and releasing the mouse there. The two areas do not need to be side-by-side,
though they must be inside the same window.
@@ -107,12 +123,10 @@
The new window is a fully functional window, which is part of the same instance of Blender.
This can be useful, e.g. if you have multiple monitors.
-You can also create a new window from an existing area by :kbd:`Shift-LMB`
-on the area corner, then drag outward slightly.
+You can also create a new window from an existing area by pressing :kbd:`Shift-LMB`
+on an area corner, then dragging outward slightly.
-The window can be closed with the OS *Close Window* button.
-
.. _bpy.ops.screen.screen_full_area:
Toggle Maximize Area
@@ -123,16 +137,10 @@
:Menu: :menuselection:`View --> Area --> Toggle Maximize Area`
:Shortcut: :kbd:`Ctrl-Spacebar`
-The maximized area fill the whole application window. You can maximize an area
-with :menuselection:`View --> Area --> Toggle Maximize Area` menu entry or keyboard shortcut.
-To return to normal size, use the keyboard shortcut again or the *Back to Previous* button on the Topbar.
+Expands the Area so it fills the whole window (while keeping the Topbar and Status Bar visible).
+To return to normal size, use the keyboard shortcut again or click the *Back to Previous* button in the Topbar.
-.. note::
- The area your mouse is currently hovering over is the one
- that will be maximized using the keyboard shortcuts.
-
-
Toggle Fullscreen Area
======================
@@ -141,6 +149,7 @@
:Menu: :menuselection:`View --> Area --> Toggle Fullscreen Area`
:Shortcut: :kbd:`Ctrl-Alt-Spacebar`
-The fullscreen area contains only the main region of the editor.
-To exit fullscreen use the keyboard shortcut or move the mouse to the top right corner
-of the area to reveal the return icon.
+Expands the Area so it fills the whole window, hiding the Topbar, Status Bar, and even the
+secondary :doc:`regions </interface/window_system/regions>` (toolbars etc.) of the Area's own editor.
+To return to normal size, use the keyboard shortcut again or click the icon in the Area's top right corner
+(only becomes visible when hovering).
Modified: branches/blender-3.2-release/blender_docs/manual/interface/window_system/introduction.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/interface/window_system/introduction.rst 2022-06-17 20:42:32 UTC (rev 9369)
+++ branches/blender-3.2-release/blender_docs/manual/interface/window_system/introduction.rst 2022-06-17 22:26:41 UTC (rev 9370)
@@ -3,9 +3,8 @@
Window System Introduction
**************************
-After starting Blender and closing the :ref:`Splash Screen <splash>`
-the Blender window should look something similar to the image below;
-as Blender's user interface is consistent across all platforms.
+After starting Blender and closing the :ref:`Splash Screen <splash>`,
+the Blender window should look similar to the image below.
.. figure:: /images/interface_window-system_introduction_default-startup.png
:align: center
@@ -32,8 +31,8 @@
.. rubric:: Theme colors
-Blender allows for most of its interface color settings to be changed to suit the needs of the user.
-If you find that the colors you see on screen do not match those mentioned
-in the Manual then it could be that your default theme has been altered.
-Creating a new theme or selecting/altering a pre-existing one can be done by selecting
-the :doc:`Preferences </editors/preferences/index>` editor and clicking on the *Themes* tab.
+Blender allows for most of its interface colors to be changed to suit the needs of the user.
+If you find that the colors you see on screen do not match those
+in the Manual, it could be that your default theme has been altered.
+Creating a new theme or selecting/altering a pre-existing one can be done by opening
+the :doc:`Preferences </editors/preferences/index>` and clicking on the *Themes* tab.
Modified: branches/blender-3.2-release/blender_docs/manual/interface/window_system/regions.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/interface/window_system/regions.rst 2022-06-17 20:42:32 UTC (rev 9369)
+++ branches/blender-3.2-release/blender_docs/manual/interface/window_system/regions.rst 2022-06-17 22:26:41 UTC (rev 9370)
@@ -58,7 +58,7 @@
Show Header
Toggles the visibility of the header.
- If a header is hidden it can be made visible again by dragging
+ If a header is hidden, it can be made visible again by clicking or dragging
the small arrow that appears at the top/bottom right of the editor.
Show Tool Settings
Toggles the visibility of the `Tool Settings`_.
@@ -80,29 +80,26 @@
Toolbar
=======
-The *Toolbar* (on the left side of the editor area) contains a set of interactive tools.
-:kbd:`T` toggles the visibility of the Toolbar.
+The :ref:`Toolbar <ui-region-toolbar>` (on the left side of the editor area)
+contains a set of interactive tools. :kbd:`T` toggles the visibility of the Toolbar.
-This is further documented here: :ref:`Toolbar <ui-region-toolbar>`.
-
Tool Settings
=============
-The *Tool Settings* (at the top/bottom of the editor area)
-contains as its name suggests the settings of the active tool.
-It's visibility can be toggled with the header's context menu just as its position
-with the *Flip to Bottom/Top* operator.
+A horizontal strip at the top or bottom of the editor (similar to the header)
+containing settings for the currently selected tool. Just like the header,
+it can be hidden and moved through its context menu.
Adjust Last Operation
=====================
-The *Adjust Last Operation* is a region that shows options when operators are run.
+:ref:`Adjust Last Operation <bpy.ops.screen.redo_last>` is a region that allows
+tweaking an operator after running it. For example, if you just added a cube,
+you can use this region to tweak its size.
-This is further documented here: :ref:`Adjust Last Operation <bpy.ops.screen.redo_last>`.
-
.. _ui-region-sidebar:
Sidebar
@@ -128,12 +125,12 @@
---------
A region can be scrolled vertically and/or horizontally by dragging it with the :kbd:`MMB`.
-If the region has no zoom level, it can be scrolled by using the :kbd:`Wheel`,
+If the region has no zoom level, it can also be scrolled by using the :kbd:`Wheel`
while the mouse hovers over it.
.. _interface_window-system_regions_scroll_range:
-Some regions, in particular animation timelines have scrollbars with added control points
+Some regions, in particular animation timelines, have scrollbars with added control points
to adjust the vertical or horizontal range of the region.
These special scrollbars will have added widgets at the ends, as shown in the following image:
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list