[Bf-docboard-svn] bf-manual: [7230] trunk/blender_docs/manual: Cleanup: editors sidebars

Aaron Carlisle noreply at blender.org
Tue Oct 13 23:18:49 CEST 2020 

Revision: 7230
          https://developer.blender.org/rBM7230
Author:   Blendify
Date:     2020-10-13 23:18:49 +0200 (Tue, 13 Oct 2020)
Log Message:
-----------
Cleanup: editors sidebars

This commit creates one sidebar page for the editor.
More editors can be refactored later.
Later we might decide to split this page up and create a sidebar directory.

Modified Paths:
--------------
    trunk/blender_docs/manual/editors/3dview/index.rst
    trunk/blender_docs/manual/editors/3dview/introduction.rst
    trunk/blender_docs/manual/editors/3dview/navigate/camera_view.rst
    trunk/blender_docs/manual/editors/3dview/navigate/introduction.rst
    trunk/blender_docs/manual/editors/3dview/navigate/navigation.rst
    trunk/blender_docs/manual/editors/image/index.rst
    trunk/blender_docs/manual/editors/image/introduction.rst
    trunk/blender_docs/manual/editors/uv/index.rst
    trunk/blender_docs/manual/editors/uv/introduction.rst
    trunk/blender_docs/manual/render/cameras.rst

Added Paths:
-----------
    trunk/blender_docs/manual/editors/3dview/sidebar.rst
    trunk/blender_docs/manual/editors/image/sidebar.rst
    trunk/blender_docs/manual/editors/uv/sidebar.rst

Removed Paths:
-------------
    trunk/blender_docs/manual/editors/3dview/properties/
    trunk/blender_docs/manual/editors/image/scopes.rst
    trunk/blender_docs/manual/editors/image/view_tab.rst
    trunk/blender_docs/manual/editors/uv/display_panel.rst

Modified: trunk/blender_docs/manual/editors/3dview/index.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/index.rst	2020-10-13 20:37:45 UTC (rev 7229)
+++ trunk/blender_docs/manual/editors/3dview/index.rst	2020-10-13 21:18:49 UTC (rev 7230)
@@ -18,5 +18,5 @@
    controls/index.rst
    display/index.rst
    toolbar/index.rst
-   properties/index.rst
+   sidebar.rst
    viewport_render.rst

Modified: trunk/blender_docs/manual/editors/3dview/introduction.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/introduction.rst	2020-10-13 20:37:45 UTC (rev 7229)
+++ trunk/blender_docs/manual/editors/3dview/introduction.rst	2020-10-13 21:18:49 UTC (rev 7230)
@@ -92,4 +92,4 @@
 The Sidebar region contains properties of the active object and selected objects (such as their locations),
 as well as properties of the editor itself.
 
-See :doc:`Sidebar Panels </editors/3dview/properties/sidebar>` for more information.
+See :doc:`Sidebar Panels </editors/3dview/sidebar>` for more information.

Modified: trunk/blender_docs/manual/editors/3dview/navigate/camera_view.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/navigate/camera_view.rst	2020-10-13 20:37:45 UTC (rev 7229)
+++ trunk/blender_docs/manual/editors/3dview/navigate/camera_view.rst	2020-10-13 21:18:49 UTC (rev 7230)
@@ -61,7 +61,7 @@
 
    The active camera, as well as the layers, can be specific to a given view,
    or global (locked) to the whole scene.
-   See :doc:`Local Camera </editors/3dview/properties/sidebar>`.
+   See :doc:`Local Camera </editors/3dview/sidebar>`.
 
 
 Animated Camera Switching

Modified: trunk/blender_docs/manual/editors/3dview/navigate/introduction.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/navigate/introduction.rst	2020-10-13 20:37:45 UTC (rev 7229)
+++ trunk/blender_docs/manual/editors/3dview/navigate/introduction.rst	2020-10-13 21:18:49 UTC (rev 7230)
@@ -30,12 +30,12 @@
 The navigation gizmo can be found in the top right of the editor.
 The four buttons (listed from top to bottom) do the following:
 
-- `Zooms the 3D Viewport <Zoom>`_
-- `Pans the 3D Viewport <Pan>`_
+- :ref:`Zooms the 3D Viewport <editors_3dview_navigation_zoom>`
+- :ref:`Pans the 3D Viewport <bpy.ops.view3d.view_pan>`
 - :doc:`Toggles the Camera View </editors/3dview/navigate/camera_view>`
 - :doc:`Toggles the Projection </editors/3dview/navigate/projections>`
 
-The `Orbit`_ gizmo at the top can be used to rotate around the 3D Viewport.
+The :ref:`Orbit <bpy.ops.view3d.view_orbit>` gizmo at the top can be used to rotate around the 3D Viewport.
 Hovering over the gizmo and dragging with :kbd:`LMB` will orbit the view.
 Clicking any of the axis labels will :doc:`Align </editors/3dview/navigate/align>` to that view.
 Clicking the same axis again switches to the opposite side of that same axis.

Modified: trunk/blender_docs/manual/editors/3dview/navigate/navigation.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/navigate/navigation.rst	2020-10-13 20:37:45 UTC (rev 7229)
+++ trunk/blender_docs/manual/editors/3dview/navigate/navigation.rst	2020-10-13 21:18:49 UTC (rev 7230)
@@ -51,6 +51,8 @@
 Rotate the viewport camera around its local Z axis in 15° discrete steps.
 
 
+.. _bpy.ops.view3d.view_pan:
+
 Pan
 ===
 
@@ -71,6 +73,7 @@
 If your input device has no middle button, you can hold :kbd:`Shift-Alt` while dragging with :kbd:`LMB`.
 
 
+.. _bpy.ops.view3d.zoom:
 .. _editors_3dview_navigation_zoom:
 
 Zoom In/Out

Added: trunk/blender_docs/manual/editors/3dview/sidebar.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/sidebar.rst	                        (rev 0)
+++ trunk/blender_docs/manual/editors/3dview/sidebar.rst	2020-10-13 21:18:49 UTC (rev 7230)
@@ -0,0 +1,135 @@
+
+*******
+Sidebar
+*******
+
+Item
+====
+
+Shows :doc:`Transform </scene_layout/object/editing/transform/introduction>` settings
+of the active objects.
+
+
+Tool
+====
+
+Show settings of the active tool and Workspace.
+
+
+View
+====
+
+View Panel
+----------
+
+The *View* panel lets you set other settings regarding the 3D Viewport.
+You can show it with the :menuselection:`View --> View Properties...` menu entry.
+
+Focal Length
+   Control the focal length of the 3D Viewport camera in millimeters,
+   unlike a :doc:`rendering camera </render/cameras>`.
+
+.. _3dview-view-clip:
+
+Clip Start/End
+   Adjust the minimum and maximum distances range to limit the visible range to the area
+   between two planes that are orthogonal to the viewing direction of the viewport camera.
+   Objects outside the range will not be shown.
+
+   .. note::
+
+      The definition of the two planes depends on the kind of view:
+
+      - Perspective view: The planes with distance of start and end from viewport camera.
+
+      - Orthographic view: The planes with distance of negative end and positive end from the focus point,
+        in this case the *Start* is ignored.
+
+   .. warning::
+
+      A large clipping range will allow you to see both near and far objects,
+      but reduces the depth precision resulting in artifacts.
+
+      In some cases, a very large range may cause operations that depend on the depth buffer to become unreliable
+      although this depends on the graphics card and drivers.
+
+      See :ref:`Troubleshooting Depth Buffer Glitches <troubleshooting-depth>` for more information.
+
+Local Camera
+   Use a local camera in this view, selected from the object selector,
+   rather than the scene's (global) active camera.
+
+Render Region
+   Use a Render Region when not looking through a camera.
+   Using :kbd:`Ctrl-B` to draw a region will automatically enable this option.
+
+
+.. _bpy.types.SpaceView3D.lock:
+
+View Lock
+^^^^^^^^^
+
+Lock to Object
+   A :ref:`ui-data-id` that defines an object as the center of the view.
+   In this case, the view can be rotated around or zoomed towards that central object,
+   but not while you move the object itself
+   (this option is not available in a camera view).
+
+.. _3dview-lock-camera-to-view:
+
+Lock
+   To 3D Cursor
+      Lock the center of the view to the position of the 3D cursor.
+      It is only available when *Lock to Object* is not active.
+   Camera to View
+      When in camera view, all changes in the view (pans, rotations, zooms) will affect the active camera.
+      The camera frame will be outlined with a red dashed line.
+
+.. hint::
+
+   This will move the camera's parent which can be useful with camera rigs.
+   Use the :ref:`Camera Parent Lock <prefs-camera-parent-lock>` preference to change this behavior.
+
+
+3D Cursor
+---------
+
+Location
+   The location of the 3D Cursor.
+
+Rotation
+   The rotation of the 3D Cursor.
+
+Rotation Mode
+   The Rotation mode of the 3D Cursor.
+
+
+.. _bpy.types.SpaceView3D.use_local_collections:
+
+Collections
+-----------
+
+The *Collections* panel shows a list of collections
+and can be used to control the visibility of collections in the viewport.
+If a collection contains objects, there is a circle to the left of the collection name.
+If a collection is empty, there is no circle to the left of the collection name.
+
+Local Collections
+   Allows the list of visible collections to be controlled per viewport rather than globally.
+
+Hide in Viewport (eye icon)
+   Collections can be hidden in the viewport by clicking on the eye icon.
+
+By clicking directly on the collection names,
+it "isolates" the collection by hiding all other collections,
+and showing the direct parents and all the children of the selected collection.
+
+.. seealso::
+
+   Read more about :doc:`Collections </scene_layout/collections/index>`.
+
+
+Annotations
+-----------
+
+See :doc:`Annotations </interface/annotate_tool>` for more information.


Property changes on: trunk/blender_docs/manual/editors/3dview/sidebar.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/editors/image/index.rst
===================================================================
--- trunk/blender_docs/manual/editors/image/index.rst	2020-10-13 20:37:45 UTC (rev 7229)
+++ trunk/blender_docs/manual/editors/image/index.rst	2020-10-13 21:18:49 UTC (rev 7230)
@@ -9,8 +9,7 @@
 
    introduction.rst
    navigating.rst
-   view_tab.rst
+   sidebar.rst
    overlays.rst
-   scopes.rst
    image_settings.rst
    editing.rst

Modified: trunk/blender_docs/manual/editors/image/introduction.rst
===================================================================
--- trunk/blender_docs/manual/editors/image/introduction.rst	2020-10-13 20:37:45 UTC (rev 7229)
+++ trunk/blender_docs/manual/editors/image/introduction.rst	2020-10-13 21:18:49 UTC (rev 7230)
@@ -93,16 +93,3 @@
 
 When :kbd:`LMB` / :kbd:`RMB` dragging mouse the color under the cursor is shown in the footer as well the cursor
 position and the color values in the RGBA, HSV and Luminance :term:`Color Space`.
-
-
-Sidebar Region
-==============
-
-Tool
-   Displays the settings of the active tool.
-Image
-   Tools for working with images, see :doc:`/editors/image/image_settings`.
-View Tab
-   Controls display options, see :doc:`/editors/image/view_tab`.
-Scopes
-   Displays :doc:`scopes </editors/image/scopes>` visualizing information about the image.

Deleted: trunk/blender_docs/manual/editors/image/scopes.rst
===================================================================
--- trunk/blender_docs/manual/editors/image/scopes.rst	2020-10-13 20:37:45 UTC (rev 7229)
+++ trunk/blender_docs/manual/editors/image/scopes.rst	2020-10-13 21:18:49 UTC (rev 7230)
@@ -1,82 +0,0 @@
-.. (TODO add) images
-
-******
-Scopes
-******
-
-.. figure:: /images/editors_image_scopes_main.png
-   :align: right
-
-   Scopes in the Image editor.
-
-
-Histogram
-=========
-
-.. copied from the Sequencer.
-
-This mode displays a graph showing the distribution of color information in the pixels of
-the currently displayed image. The X axis represents values of pixel, from 0 to 1 (or 0 to 255),
-while the Y axis represents the number of pixels in that tonal range.

@@ Diff output truncated at 10240 characters. @@

More information about the Bf-docboard-svn mailing list