[Bf-docboard-svn] bf-manual: [8120] trunk/blender_docs/manual: Cleanup: Split image/movie strips
Aaron Carlisle
noreply at blender.org
Sat Jun 5 04:17:45 CEST 2021
Revision: 8120
https://developer.blender.org/rBM8120
Author: Blendify
Date: 2021-06-05 04:17:45 +0200 (Sat, 05 Jun 2021)
Log Message:
-----------
Cleanup: Split image/movie strips
To prepare for upcoming changes
Modified Paths:
--------------
trunk/blender_docs/manual/addons/import_export/images_as_planes.rst
trunk/blender_docs/manual/render/output/properties/output.rst
trunk/blender_docs/manual/video_editing/sequencer/strips/index.rst
Added Paths:
-----------
trunk/blender_docs/manual/video_editing/sequencer/strips/image.rst
trunk/blender_docs/manual/video_editing/sequencer/strips/movie.rst
Removed Paths:
-------------
trunk/blender_docs/manual/video_editing/sequencer/strips/movie_image.rst
Modified: trunk/blender_docs/manual/addons/import_export/images_as_planes.rst
===================================================================
--- trunk/blender_docs/manual/addons/import_export/images_as_planes.rst 2021-06-05 02:16:48 UTC (rev 8119)
+++ trunk/blender_docs/manual/addons/import_export/images_as_planes.rst 2021-06-05 02:17:45 UTC (rev 8120)
@@ -44,7 +44,7 @@
Animate Image Sequences
Import sequentially numbers images as
- an animated :doc:`image sequence </video_editing/sequencer/strips/movie_image>` instead of separate planes.
+ an animated :doc:`image sequence </video_editing/sequencer/strips/image>` instead of separate planes.
They will be imported as a *Clip* texture on a single plane.
The frame range will automatically be set but can be changed later.
Modified: trunk/blender_docs/manual/render/output/properties/output.rst
===================================================================
--- trunk/blender_docs/manual/render/output/properties/output.rst 2021-06-05 02:16:48 UTC (rev 8119)
+++ trunk/blender_docs/manual/render/output/properties/output.rst 2021-06-05 02:17:45 UTC (rev 8120)
@@ -199,7 +199,7 @@
have to re-render all frames from the beginning. If you first render out a set
of static images such as the default PNG format or the higher-quality OpenEXR
(which can retain HDR pixel data), you can combine them as
- an :doc:`Image Strip </video_editing/sequencer/strips/movie_image>`
+ an :doc:`Image Strip </video_editing/sequencer/strips/image>`
in the Video Sequence Editor (VSE). This way, you can easily:
- Restart the rendering from the place (the frame) where any problem occurred.
@@ -206,7 +206,7 @@
- Try out different video encoding options in seconds,
rather than minutes or hours as encoding is usually much faster than rendering the 3D scene.
- Enjoy the rest of the features of the VSE, such as adding
- :doc:`Image Strips </video_editing/sequencer/strips/movie_image>`
+ :doc:`Image Strips </video_editing/sequencer/strips/image>`
from previous renders, audio, video clips, etc.
.. tip::
Added: trunk/blender_docs/manual/video_editing/sequencer/strips/image.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/sequencer/strips/image.rst (rev 0)
+++ trunk/blender_docs/manual/video_editing/sequencer/strips/image.rst 2021-06-05 02:17:45 UTC (rev 8120)
@@ -0,0 +1,111 @@
+.. _bpy.types.ImageSequence:
+
+*********************
+Image/Sequence Strips
+*********************
+
+Single Image
+============
+
+When you add a single still image (``*.jpg``, ``*.png``, etc.),
+Blender creates a 25 frames long strip which will show this image along the strips range.
+
+
+Image Sequence
+==============
+
+In the case of (numbered) image sequences
+(e.g. ``*-0001.jpg``, ``*-0002.jpg``, ``*-0003.jpg``, etc, of any image format), you have a choice:
+
+Range
+ Navigate into the directory and :kbd:`LMB` click and drag over a range of names to highlight multiple files.
+ You can page down and continue :kbd:`Shift-LMB` click-dragging to add more to the selection.
+Batch
+ :kbd:`Shift-LMB` click selected non-related stills for batch processing; each image will be one frame,
+ in sort order, and can be a mix of file types (``jpg``, ``png``, ``exr``, etc.).
+All
+ Press :kbd:`A` to select/deselect all files in the directory.
+
+.. tip:: Dealing with Different Sizes
+
+ Dealing with different sized images and different sized outputs is tricky.
+ If you have a mismatch between the size of the input image and the render output size,
+ the VSE will try to auto-scale the image to fit it entirely in the output.
+ This may result in clipping. If you do not want that, use *Crop* and/or *Offset* in the Input
+ panel to move and select a region of the image within the output. When you use *Crop* or *Offset*,
+ the auto-scaling will be disabled and you can manually re-scale by adding the Transform effect.
+
+
+.. _bpy.ops.sequencer.image_strip_add:
+
+Add Image Strip
+===============
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Menu: :menuselection:`Add --> Image/Sequence`
+
+Relative Path
+ Store the location of the image file relative to the blend-file.
+
+Start Frame
+ The :ref:`Start Frame <bpy.types.Sequence.frame_start>` to place the left handle of the strip.
+
+End Frame
+ The end frame to place the right handle of the strip.
+
+ .. tip::
+
+ Subtract the *Start Frame* from the *End Frame* to get the strip's duration.
+
+Channel
+ The :ref:`Channel <bpy.types.Sequence.channel>` to place the strip.
+
+Replace Selection
+ Replaces the currently selected strips with the new strip.
+
+Fit Method
+ Determines how images with an aspect ratio different than
+ 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.
+
+Set View Transform
+ Automatically sets an appropriate :ref:`View Transform <bpy.types.ColorManagedViewSettings.view_transform>`
+ based on the :term:`Color Space` of the imported media. In most cases, the *Standard* should be used;
+ using the wrong transform could result in inaccurate colors or degraded rendering performance.
+
+Use Placeholders
+ Image sequences can use placeholder files.
+ This works by enabling *Use placeholders* checkbox when adding an image strip.
+ The option detects the frame range of opened images using Blender's frame naming scheme
+ (``filename + frame number + .extension``) and makes an image sequence
+ with all files in between even if they are missing.
+ This allows you to render an image sequence with a few frames missing and
+ still the image strip will have the correct range to account for the missing frames displayed as black.
+
+ When the missing frames are rendered or placed in the same folder,
+ you can :ref:`refresh <bpy.ops.sequencer.refresh_all>`
+ the Sequencer and get the missing frames in the strip.
+ The option is also available when using the *Change Data/File* operator and
+ allows you to add more images to the range.
Property changes on: trunk/blender_docs/manual/video_editing/sequencer/strips/image.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/video_editing/sequencer/strips/index.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/sequencer/strips/index.rst 2021-06-05 02:16:48 UTC (rev 8119)
+++ trunk/blender_docs/manual/video_editing/sequencer/strips/index.rst 2021-06-05 02:17:45 UTC (rev 8120)
@@ -18,7 +18,8 @@
scene.rst
clip_mask.rst
- movie_image.rst
+ movie.rst
+ image.rst
sound.rst
color.rst
text.rst
Added: trunk/blender_docs/manual/video_editing/sequencer/strips/movie.rst
===================================================================
--- trunk/blender_docs/manual/video_editing/sequencer/strips/movie.rst (rev 0)
+++ trunk/blender_docs/manual/video_editing/sequencer/strips/movie.rst 2021-06-05 02:17:45 UTC (rev 8120)
@@ -0,0 +1,84 @@
+.. _bpy.types.MovieSequence:
+
+************
+Movie Strips
+************
+
+To add a movie (with or without audio) select a movie file(s) in the File Browser
+e.g. in the Audio-Video Interleaved format (``*.avi`` file).
+
+.. note:: Clips can be Huge
+
+ A three minute Quicktime ``.mov`` file can be 140MB.
+ Loading it, even over a high-speed LAN can take some time.
+ Do not assume your computer or Blender has locked up if nothing happens for awhile.
+
+
+.. _bpy.ops.sequencer.movie_strip_add:
+
+Add Movie Strip
+===============
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Menu: :menuselection:`Add --> Movie`
+
+Relative Path
+ Store the location of the image file relative to the blend-file.
+
+Start Frame
+ The :ref:`Start Frame <bpy.types.Sequence.frame_start>` to place the left handle of the strip.
+
+Channel
+ The :ref:`Channel <bpy.types.Sequence.channel>` to place the strip.
+
+Replace Selection
+ Replaces the currently selected strips with the new strip.
+
+Fit Method
+ Determines how images with an aspect ratio different than
+ 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.
+
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list