[Bf-docboard-svn] bf-manual: [7627] branches/blender-2.92-release/blender_docs/manual/video_editing/sequencer: VSE: Improve motion-picture workflow

[Aaron Carlisle]

Revision: 7627
          https://developer.blender.org/rBM7627
Author:   Blendify
Date:     2021-01-21 03:06:04 +0100 (Thu, 21 Jan 2021)
Log Message:
-----------
VSE: Improve motion-picture workflow

rB571362642201a743168cdf4c827a59c09c40414b

Modified Paths:
--------------
    branches/blender-2.92-release/blender_docs/manual/video_editing/sequencer/editing.rst
    branches/blender-2.92-release/blender_docs/manual/video_editing/sequencer/sidebar/strip.rst
    branches/blender-2.92-release/blender_docs/manual/video_editing/sequencer/strips/movie_image.rst

Modified: branches/blender-2.92-release/blender_docs/manual/video_editing/sequencer/editing.rst
===================================================================
--- branches/blender-2.92-release/blender_docs/manual/video_editing/sequencer/editing.rst	2021-01-21 01:30:18 UTC (rev 7626)
+++ branches/blender-2.92-release/blender_docs/manual/video_editing/sequencer/editing.rst	2021-01-21 02:06:04 UTC (rev 7627)
@@ -177,6 +177,103 @@
 independent of selection or locked state of strips.
 
 
+Image Transform
+===============
+
+.. _bpy.ops.sequencer.strip_transform_fit:
+
+Scale to Fit
+------------
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Menu:      :menuselection:`Strip --> Image Transform --> Scale to Fit`
+
+Adjusts the strips :ref:`Scale Transforms <bpy.types.SequenceTransform.scale>`
+so the visual contents of the strip to fit exactly within the project's :doc:`/render/output/properties/dimensions`
+while maintaining the original aspect ratio.
+
+This may mean that the transparent areas may be added
+along the content's border to fit the content in the rendered area.
+
+
+Scale to Fill
+-------------
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Menu:      :menuselection:`Strip --> Image Transform --> Scale to Fill`
+
+Adjusts the strips :ref:`Scale Transforms <bpy.types.SequenceTransform.scale>`
+so the visual contents of the strip to span the project's :doc:`/render/output/properties/dimensions`
+while maintaining the original aspect ratio.
+
+This may mean that portions of the original image no longer fit the content inside the rendered area.
+
+
+Stretch to Fill
+---------------
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Menu:      :menuselection:`Strip --> Image Transform --> Stretch to Fill`
+
+Adjusts the strips :ref:`Scale Transforms <bpy.types.SequenceTransform.scale>`
+so the visual contents of the strip to fill the project's :doc:`/render/output/properties/dimensions`.
+Note, unlike the other two methods described above, *Stretch to Fill* does not maintaining the original aspect ratio.
+
+This may mean that the original image becomes distorted to fit the content inside the rendered area.
+
+
+.. _bpy.ops.sequencer.strip_transform_clear:
+
+Clear Position
+--------------
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Menu:      :menuselection:`Strip --> Image Transform --> Clear Position`
+
+Resets the strips :ref:`Position Transforms <bpy.types.SequenceTransform.rotation>` to a value of zero.
+
+
+Clear Scale
+-----------
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Menu:      :menuselection:`Strip --> Image Transform --> Clear Scale`
+
+Resets the strips :ref:`Scale Transforms <bpy.types.SequenceTransform.scale>` to a value of one.
+
+
+Clear Rotation
+--------------
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Menu:      :menuselection:`Strip --> Image Transform --> Clear Rotation`
+
+Resets the strips :ref:`Rotation Transform <bpy.types.SequenceTransform.rotation>` to a value of zero.
+
+
+Clear All
+---------
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Menu:      :menuselection:`Strip --> Image Transform --> Clear All`
+
+Resets the strips position, scale, and rotation :ref:`Transforms <bpy.types.SequenceTransform>` to their default values.
+
+
 .. _bpy.ops.sequencer.split:
 
 Split

Modified: branches/blender-2.92-release/blender_docs/manual/video_editing/sequencer/sidebar/strip.rst
===================================================================
--- branches/blender-2.92-release/blender_docs/manual/video_editing/sequencer/sidebar/strip.rst	2021-01-21 01:30:18 UTC (rev 7626)
+++ branches/blender-2.92-release/blender_docs/manual/video_editing/sequencer/sidebar/strip.rst	2021-01-21 02:06:04 UTC (rev 7627)
@@ -30,6 +30,8 @@
    is drawn on the strip as a dark section that follows the animation curve.
 
 
+.. _bpy.types.SequenceTransform:
+
 Transform
 =========
 

Modified: branches/blender-2.92-release/blender_docs/manual/video_editing/sequencer/strips/movie_image.rst
===================================================================
--- branches/blender-2.92-release/blender_docs/manual/video_editing/sequencer/strips/movie_image.rst	2021-01-21 01:30:18 UTC (rev 7626)
+++ branches/blender-2.92-release/blender_docs/manual/video_editing/sequencer/strips/movie_image.rst	2021-01-21 02:06:04 UTC (rev 7627)
@@ -36,6 +36,33 @@
 Replace Selection
    Replaces the currently selected strips with the new strip
 
+Fit Method
+   Determines how images with aspect ratios different then the :doc:`Scene's </render/output/properties/dimensions>`
+   are scaled to fit inside the render area.
+
+   Defininition
+      njkfnk re vk;j kj vkjveh m ejhrdkc elnv jkmc ejhbkc ejsbscje abbwej cjb wvjhc.
+
+   :Scale to Fit:
+      Adjusts the strips :ref:`Scale Transforms <bpy.types.SequenceTransform.scale>`
+      so the visual contents of the strip to fit exactly within the project's :doc:`/render/output/properties/dimensions`
+      while maintaining the original aspect ratio.
+
+      This may mean that the transparent areas may be added
+      along the content's border to fit the content in the rendered area.
+   :Scale to Fill:
+      Adjusts the strips :ref:`Scale Transforms <bpy.types.SequenceTransform.scale>`
+      so the visual contents of the strip to span the project's :doc:`/render/output/properties/dimensions`
+      while maintaining the original aspect ratio.
+
+      This may mean that portions of the original image no longer fit the content inside the rendered area.
+   :Stretch to Fill:
+      Adjusts the strips :ref:`Scale Transforms <bpy.types.SequenceTransform.scale>`
+      so the visual contents of the strip to fill the project's :doc:`/render/output/properties/dimensions`.
+      Note, unlike the other two methods described above, *Stretch to Fill* does not maintaining the original aspect ratio.
+
+      This may mean that the original image becomes distorted to fit the content inside the rendered area.
+
 Sound
    Add a :doc:`Sound Strip </video_editing/sequencer/strips/sound>` that contains the movie's audio track.
 
@@ -121,6 +148,30 @@
 Replace Selection
    Replaces the currently selected strips with the new strip
 
+Fit Method
+   Determines how images with aspect ratios different then the :doc:`Scene's </render/output/properties/dimensions>`
+   are scaled to fit inside the render area.
+
+   :Scale to Fit:
+      Adjusts the strips :ref:`Scale Transforms <bpy.types.SequenceTransform.scale>`
+      so the visual contents of the strip to fit exactly within the project's :doc:`/render/output/properties/dimensions`
+      while maintaining the original aspect ratio.
+
+      This may mean that the transparent areas may be added
+      along the content's border to fit the content in the rendered area.
+   :Scale to Fill:
+      Adjusts the strips :ref:`Scale Transforms <bpy.types.SequenceTransform.scale>`
+      so the visual contents of the strip to span the project's :doc:`/render/output/properties/dimensions`
+      while maintaining the original aspect ratio.
+
+      This may mean that portions of the original image no longer fit the content inside the rendered area.
+   :Stretch to Fill:
+      Adjusts the strips :ref:`Scale Transforms <bpy.types.SequenceTransform.scale>`
+      so the visual contents of the strip to fill the project's :doc:`/render/output/properties/dimensions`.
+      Note, unlike the other two methods described above, *Stretch to Fill* does not maintaining the original aspect ratio.
+
+      This may mean that the original image becomes distorted to fit the content inside the rendered area.
+
 Use placeholders
    Image sequences can use placeholder files.
    This works by enabling *Use placeholders* checkbox when adding an image strip.