[Bf-docboard-svn] bf-manual: [7938] trunk/blender_docs/manual/video_editing: VSE: Simplify proxy settings

Mon Apr 12 23:36:43 CEST 2021

Revision: 7938
          https://developer.blender.org/rBM7938
Author:   Blendify
Date:     2021-04-12 23:36:43 +0200 (Mon, 12 Apr 2021)
Log Message:
-----------
VSE: Simplify proxy settings

rB91561629cd0bd622c9d1722701ab88c9e77be660

Modified Paths:
--------------
    trunk/blender_docs/manual/video_editing/preview/sidebar.rst
    trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy.rst

Modified: trunk/blender_docs/manual/video_editing/preview/sidebar.rst
===================================================================

--- trunk/blender_docs/manual/video_editing/preview/sidebar.rst	2021-04-12 20:18:30 UTC (rev 7937)
+++ trunk/blender_docs/manual/video_editing/preview/sidebar.rst	2021-04-12 21:36:43 UTC (rev 7938)
@@ -3,33 +3,36 @@
 Sidebar
 *******
 
-Metadata
-========
+View Settings
+=============
 
-A list of metadata of the displayed image.
+.. _bpy.types.SpaceSequenceEditor.proxy_render_size:
 
-.. note::
+Proxy Render Size
+   Size to display proxies at in the preview region.
+   Using a smaller preview size will increase speed.
 
-   The metadata will only be displayed for the image, that has not been processed by any effect.
-   By default images are processed by alpha over blending.
+   :No Display: Disables the preview.
+   :Scene Size:
+      Matches proxy size to the final render :ref:`resolution <bpy.types.RenderSettings.resolution_y>`.
+   :25%, 50%, 75%, 100%: Proxies are sized to be the selected percent of the original input.
 
+.. _bpy.types.SpaceSequenceEditor.use_proxies:
 
-Scene Strip Display
-===================
+Use Proxies
+   Use optimized files for faster scrubbing when available.
+   Proxies limit the visual accuracy of the preview by reducing
+   the preview resolution and using compressed copies of the input.
 
-It allows you to control how the images of :doc:`Scene Strips </video_editing/sequencer/strips/scene>`
-are displayed in the preview.
+.. _bpy.types.SequenceEditor.use_prefetch:
 
-Shading
-   Method for rendering the viewport.
-   See the 3D Viewport's :ref:`view3d-viewport-shading` options.
-Override Scene Settings
-   Use the Workbench render settings from the sequencer scene, instead of each individual scene used in the strip.
+Prefetch Frames
+   Automatically fill the cache with frames after the current frame in the background.
+   Use this feature to achieve more consistent playback speed.
+   This feature currently doesn't support rendering scene strips.
 
+.. _bpy.types.SpaceSequenceEditor.display_channel:
 
-View Settings
-=============
-
 Channel
    Selects the channel to show in the preview.
 
@@ -38,46 +41,40 @@
    (channel 1 is at the bottom of the stack). The display of these modes is either the composite
    (channel 0) or the frame from the strip (channels 1 through n).
 
+.. _bpy.types.SpaceSequenceEditor.show_overexposed:
+
 Show Overexposed
    Shows overexposed (bright white) areas using a zebra pattern.
    The threshold can be adjust with the slider.
 
-.. _proxy-render-size:
 
-Proxy Render Size
-   Size to display proxies at in the preview region.
-   Using a smaller preview size will increase speed.
-
-Prefetch Frames
-   Automatically fill the cache with frames after the current frame in the background.
-   Use this feature to achieve more consistent playback speed.
-   This feature currently doesn't support rendering scene strips.
-
-
 .. _bpy.types.SequenceEditor.show_overlay:
-.. _bpy.ops.sequencer.view_ghost_border:
-.. _bpy.types.SequenceEditor.overlay:
-.. _bpy.types.SequenceEditor.use_overlay_lock:
 
 Frame Overlay
 =============
 
-Option to enable the overlay. It can be used for comparing the current frame to a reference frame.
+Option to enable the overlay.
+It can be used for comparing the current frame to a reference frame.
 
+.. _bpy.ops.sequencer.view_ghost_border:
+
 Set Overlay Region
    Selects the rectangular bounds for the overlay region.
    This area can be defined by pressing :kbd:`O` key over the preview.
+
+.. _bpy.types.SequenceEditor.overlay_frame:
+
 Frame Offset
    The slider controls the offset of the reference frame relative to current frame.
+
+.. _bpy.types.SpaceSequenceEditor.overlay_type:
+
 Overlay Type
    It describes the way the reference frame should be displayed.
 
-   Rectangle
-      Which means the rectangle area of reference frame will be displayed on top of current frame.
-   Reference
-      Only the reference frame is displayed in the preview region.
-   Current
-      Only the current frame is displayed in the preview region.
+   :Rectangle: Which means the rectangle area of reference frame will be displayed on top of current frame.
+   :Reference: Only the reference frame is displayed in the preview region.
+   :Current: Only the current frame is displayed in the preview region.
 
    .. tip::
 
@@ -84,6 +81,8 @@
       It is possible to have several Sequence Editors opened and they can use different overlay types.
       So it is possible to have current and reference frames displayed in different editor spaces.
 
+.. _bpy.types.SequenceEditor.use_overlay_lock:
+
 Overlay Lock
    It's still possible to lock the reference frame to its current position.
 
@@ -99,7 +98,33 @@
    See :ref:`Safe Areas <camera-safe-areas>` in the camera docs.
 
 
+Scene Strip Display
+===================
+
+It allows you to control how the images of :doc:`Scene Strips </video_editing/sequencer/strips/scene>`
+are displayed in the preview.
+
+Shading
+   Method for rendering the viewport.
+   See the 3D Viewport's :ref:`view3d-viewport-shading` options.
+
+Override Scene Settings
+   Use the Workbench render settings from the sequencer scene,
+   instead of each individual scene used in the strip.
+
+
 Annotations
 ===========
 
 Allows you to use :doc:`Annotations </interface/annotate_tool>` in the Sequencer.
+
+
+Metadata
+========
+
+A list of metadata of the displayed image.
+
+.. note::
+
+   The metadata will only be displayed for the image, that has not been processed by any effect.
+   By default images are processed by alpha over blending.

Modified: trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy.rst	2021-04-12 20:18:30 UTC (rev 7937)
+++ trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy.rst	2021-04-12 21:36:43 UTC (rev 7938)
@@ -48,7 +48,7 @@
 Then use :menuselection:`Strip --> Rebuild Proxy and Timecode indices`, or button in `Proxy Settings`_ panel.
 Once all proxies are built, they will be ready to use.
 
-In order to use proxies, you have to select matching :ref:`Proxy Render Size <proxy-render-size>`
+In order to use proxies, you have to select matching :ref:`Proxy Render Size <bpy.types.SpaceSequenceEditor.proxy_render_size>`
 in Sequencer preview Sidebar panel.
 
 Custom Proxy

