[Bf-docboard-svn] bf-manual: [9371] trunk/blender_docs: Merge branch 'blender-3.2-release'
Aaron Carlisle
noreply at blender.org
Sat Jun 18 00:29:41 CEST 2022
Revision: 9371
https://developer.blender.org/rBM9371
Author: Blendify
Date: 2022-06-18 00:29:41 +0200 (Sat, 18 Jun 2022)
Log Message:
-----------
Merge branch 'blender-3.2-release'
Modified Paths:
--------------
trunk/blender_docs/manual/interface/window_system/areas.rst
trunk/blender_docs/manual/interface/window_system/introduction.rst
trunk/blender_docs/manual/interface/window_system/regions.rst
trunk/blender_docs/manual/interface/window_system/splash.rst
trunk/blender_docs/manual/interface/window_system/status_bar.rst
trunk/blender_docs/manual/interface/window_system/tabs_panels.rst
trunk/blender_docs/manual/interface/window_system/topbar.rst
trunk/blender_docs/manual/interface/window_system/workspaces.rst
trunk/blender_docs/resources/theme/css/epub_overrides.css
trunk/blender_docs/resources/theme/css/theme_overrides.css
trunk/blender_docs/resources/theme/css/version_switch.css
Property Changed:
----------------
trunk/blender_docs/
Index: trunk/blender_docs
===================================================================
--- trunk/blender_docs 2022-06-17 22:26:41 UTC (rev 9370)
+++ trunk/blender_docs 2022-06-17 22:29:41 UTC (rev 9371)
Property changes on: trunk/blender_docs
___________________________________________________________________
Modified: svn:mergeinfo
## -2,4 +2,4 ##
/branches/blender-2.93-release/blender_docs:7959-8113
/branches/blender-3.0-release/blender_docs:8543-9034
/branches/blender-3.1-release/blender_docs:8904-9230
-/branches/blender-3.2-release/blender_docs:9236-9367
\ No newline at end of property
+/branches/blender-3.2-release/blender_docs:9236-9370
\ No newline at end of property
Modified: trunk/blender_docs/manual/interface/window_system/areas.rst
===================================================================
--- trunk/blender_docs/manual/interface/window_system/areas.rst 2022-06-17 22:26:41 UTC (rev 9370)
+++ trunk/blender_docs/manual/interface/window_system/areas.rst 2022-06-17 22:29:41 UTC (rev 9371)
@@ -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: trunk/blender_docs/manual/interface/window_system/introduction.rst
===================================================================
--- trunk/blender_docs/manual/interface/window_system/introduction.rst 2022-06-17 22:26:41 UTC (rev 9370)
+++ trunk/blender_docs/manual/interface/window_system/introduction.rst 2022-06-17 22:29:41 UTC (rev 9371)
@@ -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: trunk/blender_docs/manual/interface/window_system/regions.rst
===================================================================
--- trunk/blender_docs/manual/interface/window_system/regions.rst 2022-06-17 22:26:41 UTC (rev 9370)
+++ trunk/blender_docs/manual/interface/window_system/regions.rst 2022-06-17 22:29:41 UTC (rev 9371)
@@ -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`,
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list