[Bf-docboard-svn] bf-manual: [7582] trunk/blender_docs/manual: VSE: Hide cache settings and adjust defaults
Aaron Carlisle
noreply at blender.org
Tue Jan 12 23:24:17 CET 2021
Revision: 7582
https://developer.blender.org/rBM7582
Author: Blendify
Date: 2021-01-12 23:24:17 +0100 (Tue, 12 Jan 2021)
Log Message:
-----------
VSE: Hide cache settings and adjust defaults
rBf448ff2afe7a77279fe96282447912a6f7773ed3
Modified Paths:
--------------
trunk/blender_docs/manual/editors/preferences/interface.rst
trunk/blender_docs/manual/editors/preferences/system.rst
trunk/blender_docs/manual/video_editing/sequencer/navigating.rst
trunk/blender_docs/manual/video_editing/sequencer/sidebar/index.rst
Added Paths:
-----------
trunk/blender_docs/manual/video_editing/sequencer/sidebar/cache.rst
trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy.rst
Removed Paths:
-------------
trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy_cache.rst
Modified: trunk/blender_docs/manual/editors/preferences/interface.rst
===================================================================
--- trunk/blender_docs/manual/editors/preferences/interface.rst 2021-01-12 21:58:12 UTC (rev 7581)
+++ trunk/blender_docs/manual/editors/preferences/interface.rst 2021-01-12 22:24:17 UTC (rev 7582)
@@ -29,8 +29,9 @@
Developer Extras
Show settings and menu items which are intended to help developers, this includes:
- Operator Search
- See :doc:`Interface Searching </interface/controls/templates/operator_search>`.
+ - :doc:`Operator Search </interface/controls/templates/operator_search>`
+ - :doc:`Sequencer Cache Settings </video_editing/sequencer/sidebar/cache>`
+
Button Context Menu
Online Python Reference
To open the Python reference manual.
Modified: trunk/blender_docs/manual/editors/preferences/system.rst
===================================================================
--- trunk/blender_docs/manual/editors/preferences/system.rst 2021-01-12 21:58:12 UTC (rev 7581)
+++ trunk/blender_docs/manual/editors/preferences/system.rst 2021-01-12 22:24:17 UTC (rev 7582)
@@ -110,7 +110,7 @@
.. seealso::
- :doc:`Strip Proxy and Cache properties </video_editing/sequencer/sidebar/proxy_cache>`.
+ :doc:`Sequencer Cache Properties </video_editing/sequencer/sidebar/cache>`
.. _prefs-system-sound:
Modified: trunk/blender_docs/manual/video_editing/sequencer/navigating.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/sequencer/navigating.rst 2021-01-12 21:58:12 UTC (rev 7581)
+++ trunk/blender_docs/manual/video_editing/sequencer/navigating.rst 2021-01-12 22:24:17 UTC (rev 7582)
@@ -90,10 +90,16 @@
Show Markers
Shows the markers region. When disabled, the `Markers Menu`_ is also hidden
and markers operators are not available in this editor.
+
+.. _bpy.types.SequenceEditor.show_cache:
+
Show Cache
- Show :doc:`Cache </video_editing/sequencer/sidebar/proxy_cache>`
+ Show which frames are :doc:`Cached </video_editing/sequencer/sidebar/cache>`
Show all enabled types;
Final Images, Raw Images, Preprocessed Images, Composite Images
+
+ In order for this property to be visible, enable :ref:`Developer Extras <prefs-interface-dev-extras>`.
+
Show Waveforms
Global option to either display the waveform, or the strip info,
or use the individual :ref:`strip option <sequencer-sound-waveform>`.
Added: trunk/blender_docs/manual/video_editing/sequencer/sidebar/cache.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/sequencer/sidebar/cache.rst (rev 0)
+++ trunk/blender_docs/manual/video_editing/sequencer/sidebar/cache.rst 2021-01-12 22:24:17 UTC (rev 7582)
@@ -0,0 +1,55 @@
+
+*****
+Cache
+*****
+
+The Cache is used to save frames in memory for preview,
+so they can be later displayed much faster than rendered from scratch.
+Cache capacity can be set in :doc:`System tab </editors/preferences/system>` of the Preferences.
+
+In order for this tab to be visible, enable :ref:`Developer Extras <prefs-interface-dev-extras>`.
+
+.. seealso::
+
+ Which frames are cached can be visualized by enabling :ref:`Show Cache <bpy.types.SequenceEditor.show_cache>`.
+
+
+Cache Settings
+==============
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Panel: :menuselection:`Sidebar --> Cache --> Cache Settings`
+
+In this panel you can set up types of images that will be cached for all strips.
+
+Cache
+ Raw
+ Cache raw images read from drive, for faster tweaking of strip parameters at the cost of memory usage.
+ Pre-processed
+ Cache preprocessed images, for faster tweaking of effects at the cost of memory usage.
+ Composite
+ Cache intermediate composited images, for faster tweaking of stacked strips at the cost of memory usage.
+ Final
+ Cache final image for each frame.
+
+
+Strip Cache
+===========
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Panel: :menuselection:`Sidebar --> Cache --> Cache Settings`
+
+This panel sets the types of images that will be cached for the active strip.
+Enable overriding the cache defaults, when disabled, `Cache Settings`_ will be used.
+
+Cache
+ Raw
+ Cache raw images read from drive, for faster tweaking of strip parameters at the cost of memory usage.
+ Pre-Processed
+ Cache preprocessed images, for faster tweaking of effects at the cost of memory usage.
+ Composite
+ Cache intermediate composited images, for faster tweaking of stacked strips at the cost of memory usage.
Property changes on: trunk/blender_docs/manual/video_editing/sequencer/sidebar/cache.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/video_editing/sequencer/sidebar/index.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/sequencer/sidebar/index.rst 2021-01-12 21:58:12 UTC (rev 7581)
+++ trunk/blender_docs/manual/video_editing/sequencer/sidebar/index.rst 2021-01-12 22:24:17 UTC (rev 7582)
@@ -8,4 +8,5 @@
strip.rst
modifiers.rst
- proxy_cache.rst
+ cache.rst
+ proxy.rst
Added: trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy.rst (rev 0)
+++ trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy.rst 2021-01-12 22:24:17 UTC (rev 7582)
@@ -0,0 +1,94 @@
+
+*****
+Proxy
+*****
+
+Proxy Settings
+==============
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Panel: :menuselection:`Sidebar region --> Proxy & Timecode --> Proxy Settings`
+
+Storage
+ Defines whether the proxies are for individual strips or the entire sequence.
+
+ Per Strip
+ Proxies are stored in the directory of the input.
+ Project
+ All proxies are stored in one directory.
+
+ Proxy Directory
+ The location to store the proxies for the project.
+
+Set Selected Strip Proxies
+ Set proxy size and overwrite flag for all selected strips.
+
+Rebuild Proxy and Timecode Indices
+ Generates Proxies and Timecodes for all selected strips,
+ same as doing :menuselection:`Strip --> Rebuild Proxy and Timecode indices`.
+
+
+.. _bpy.types.SequenceProxy:
+
+Strip Proxy & Timecode
+======================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Panel: :menuselection:`Sidebar region --> Proxy & Timecode --> Strip Proxy & Timecode`
+
+.. figure:: /images/video-editing_sequencer_properties_proxy-cache_panel.png
+ :align: right
+
+
+Once you have chosen the :term:`Proxy`/:term:`Timecode` parameters,
+you need to select all strips for which you want proxies to be built.
+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 Sequencer preview Sidebar panel.
+
+Custom Proxy
+ Directory
+ By default, all generated proxy images are storing to
+ the ``<path of original footage>/BL_proxy/<clip name>`` folder,
+ but this location can be set by hand using this option.
+ File
+ Allows you to use pre-existing proxies.
+
+Resolutions
+ Buttons to control how big the proxies are.
+ The available options are 25%, 50%, 75%, 100 percent of original strip size.
+
+Overwrite
+ Saves over any existing proxies in the proxy storage directory.
+
+Build JPEG Quality
+ Defines the quality of the JPEG images used for proxies.
+
+Timecode Index
+ When you are working with footage directly copied from a camera without pre-processing it,
+ there might be bunch of artifacts, mostly due to seeking a given frame in sequence.
+ This happens because such footage usually does not have correct frame rate values in their headers.
+ This issue can still arise when the source clip has the same frame rate as the scene settings.
+ In order for Blender to correctly calculate frames and frame rate there are two possible solutions:
+
+ #. Preprocess your video with e.g. MEncoder to repair the file header and insert the correct keyframes.
+ #. Use Proxy/Timecode option in Blender.
+
+ The following timecodes are supported:
+
+ - No TC in use -- do not use any timecode
+ - Record Run
+ - Free Run
+ - Free Run (rec date)
+ - Record Run No Gaps
+
+ .. note::
+
+ Record Run is the timecode which usually is best to use, but if the clip's file is totally damaged,
+ *Record Run No Gaps* will be the only chance of getting acceptable result.
Property changes on: trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Deleted: trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy_cache.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy_cache.rst 2021-01-12 21:58:12 UTC (rev 7581)
+++ trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy_cache.rst 2021-01-12 22:24:17 UTC (rev 7582)
@@ -1,144 +0,0 @@
-
-**********************
-Proxy & Cache Settings
-**********************
-
-Cache Settings
-==============
-
-.. admonition:: Reference
- :class: refbox
-
- :Panel: :menuselection:`Sidebar region --> Proxy & Timecode --> Cache Settings`
-
-The Cache is used to save frames in memory for preview,
-so they can be later displayed much faster than rendered from scratch.
-Cache capacity can be set in :doc:`System tab </editors/preferences/system>` of the Preferences.
-
-In this panel you can set up types of images that will be cached for all strips.
-
-Cache
- Raw
- Cache raw images read from drive, for faster tweaking of strip parameters at the cost of memory usage.
- Pre-processed
- Cache preprocessed images, for faster tweaking of effects at the cost of memory usage.
- Composite
- Cache intermediate composited images, for faster tweaking of stacked strips at the cost of memory usage.
- Final
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list