[Bf-docboard-svn] bf-manual: [8347] trunk/blender_docs/manual: Cleanup: Add docs on time code types

[Aaron Carlisle]

Revision: 8347
          https://developer.blender.org/rBM8347
Author:   Blendify
Date:     2021-08-24 07:40:26 +0200 (Tue, 24 Aug 2021)
Log Message:
-----------
Cleanup: Add docs on time code types

Modified Paths:
--------------
    trunk/blender_docs/manual/editors/clip/sidebar.rst
    trunk/blender_docs/manual/render/cameras.rst
    trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy.rst

Modified: trunk/blender_docs/manual/editors/clip/sidebar.rst
===================================================================
--- trunk/blender_docs/manual/editors/clip/sidebar.rst	2021-08-24 05:05:51 UTC (rev 8346)
+++ trunk/blender_docs/manual/editors/clip/sidebar.rst	2021-08-24 05:40:26 UTC (rev 8347)
@@ -6,20 +6,11 @@
 Footage
 =======
 
+.. _bpy.types.MovieClipProxy:
+
 Proxy/Timecode
 --------------
 
-Once you have chosen the Proxy/Timecode parameters,
-you need to use :menuselection:`Clip --> Proxy --> Rebuild Proxy and Timecode indices`
-to generate the proxy clip and it will be available after Blender makes it.
-
-
-.. _bpy.types.MovieClipProxy:
-.. _clip-editor-proxy:
-
-Proxy
-^^^^^
-
 .. figure:: /images/editors_clip_sidebar_proxy-panel.png
    :align: right
 
@@ -29,6 +20,10 @@
 editing functions like scrubbing and scrolling is much faster but gives a low-res result.
 Make sure to disable proxies before final rendering.
 
+Once you have chosen the Proxy/Timecode parameters,
+you need to use :menuselection:`Clip --> Proxy --> Rebuild Proxy and Timecode indices`
+to generate the proxy clip and it will be available after Blender makes it.
+
 Build Original
    Used to define which resolutions of proxy images should be built.
 Build Undistorted
@@ -43,7 +38,28 @@
 Rebuild Proxy
    Regenerates proxy images for all sizes set above and regenerate all timecodes which can be used later.
 Timecode
-   See `Timecode`_.
+   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.
+
+   :No TC in use: do not use any timecode.
+   :Record Run: Use images in the order they are recorded.
+   :Free Run: Use global timestamp written by recording device.
+   :Free Run (rec date):
+      Interpolate a global timestamp using the record date and time written by recording device.
+   :Record Run No Gaps:
+      Record run, but ignore timecode, changes in framerate or dropouts
+
+   .. 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.
+
 Proxy Render Size
    Defines which proxy image resolution is used for display.
    If *Render Undistorted* is set, then images created from undistorted frames are used.
@@ -51,32 +67,6 @@
    and if render undistorted is enabled, undistortion will happen automatically on frame refresh.
 
 
-Timecode
-^^^^^^^^
-
-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.
-
-
 Footage Settings
 ----------------
 

Modified: trunk/blender_docs/manual/render/cameras.rst
===================================================================
--- trunk/blender_docs/manual/render/cameras.rst	2021-08-24 05:05:51 UTC (rev 8346)
+++ trunk/blender_docs/manual/render/cameras.rst	2021-08-24 05:40:26 UTC (rev 8347)
@@ -306,7 +306,7 @@
 
          .. seealso::
 
-            To build a proxy, the :ref:`Movie Clip Editor Proxy settings <clip-editor-proxy>` have to be used.
+            To build a proxy, the :ref:`Movie Clip Editor Proxy settings <bpy.types.MovieClipProxy>` have to be used.
             Otherwise the proxy settings here have no effect.
 
 Opacity

Modified: trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy.rst	2021-08-24 05:05:51 UTC (rev 8346)
+++ trunk/blender_docs/manual/video_editing/sequencer/sidebar/proxy.rst	2021-08-24 05:40:26 UTC (rev 8347)
@@ -78,14 +78,14 @@
    #. 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: Use images in the order they are recorded.
+   :Free Run: Use global timestamp written by recording device.
+   :Free Run (rec date):
+      Interpolate a global timestamp using the record date and time written by recording device.
+   :Record Run No Gaps:
+      Record run, but ignore timecode, changes in framerate or dropouts
 
-   - 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,