[Bf-docboard-svn] bf-manual: [7745] branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip: UI: Update Clip Tracking menus
Aaron Carlisle
noreply at blender.org
Tue Feb 9 06:15:05 CET 2021
Revision: 7745
https://developer.blender.org/rBM7745
Author: Blendify
Date: 2021-02-09 06:15:05 +0100 (Tue, 09 Feb 2021)
Log Message:
-----------
UI: Update Clip Tracking menus
rB6c15b702796e192359b54053564e88515880e356
Modified Paths:
--------------
branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/editing/clip.rst
branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/editing/reconstruction.rst
branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/editing/track.rst
branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/sidebar/track/camera.rst
branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/toolbar/solve.rst
branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/toolbar/track.rst
Modified: branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/editing/clip.rst
===================================================================
--- branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/editing/clip.rst 2021-02-09 02:54:34 UTC (rev 7744)
+++ branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/editing/clip.rst 2021-02-09 05:15:05 UTC (rev 7745)
@@ -18,6 +18,34 @@
Todo.
+.. _bpy.ops.clip.set_scene_frames:
+
+Set Scene Frames
+================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Clip --> Set Scene Frames`
+
+Sets end scene frame to match current clip duration.
+
+
+.. _bpy.ops.clip.set_center_principal:
+
+Set Prinipal to Center
+=======================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Clip --> Set Prinipal to Center`
+
+Changes the :ref:`Optical Center <bpy.types.MovieTrackingCamera.principal>` values to the center of image.
+
+
.. _bpy.ops.clip.prefetch:
Prefetch
@@ -54,3 +82,35 @@
=====
Todo.
+
+
+.. _bpy.ops.clip.set_viewport_background:
+
+Set as Background
+=================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Clip --> Set as Background`
+
+Sets the clip currently being edited as the camera background for all visible 3D Viewports.
+If there is no visible 3D Viewports or the Clip Editor is open in full screen, nothing will happen.
+
+
+.. _bpy.ops.clip.setup_tracking_scene:
+
+Setup Tracking Scene
+====================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Clip --> Setup Tracking Scene`
+
+Performs all usual steps to set up a VFX scene:
+
+- Create reference objects for floor and test object.
+- Create node set up for combining CG with an actual clip.
Modified: branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/editing/reconstruction.rst
===================================================================
--- branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/editing/reconstruction.rst 2021-02-09 02:54:34 UTC (rev 7744)
+++ branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/editing/reconstruction.rst 2021-02-09 05:15:05 UTC (rev 7745)
@@ -78,6 +78,20 @@
between two selected tracks match the given value in *Distance*.
+.. _bpy.ops.clip.apply_solution_scale:
+
+Apply Solution Scale
+====================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Reconstruction --> Apply Solution Scale`
+
+Similar to :ref:`bpy.ops.clip.set_scale`, but actually modifies the tracking data.
+
+
.. _bpy.ops.clip.track_to_empty:
Link Empty to Track
Modified: branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/editing/track.rst
===================================================================
--- branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/editing/track.rst 2021-02-09 02:54:34 UTC (rev 7744)
+++ branches/blender-2.92-release/blender_docs/manual/movie_clip/tracking/clip/editing/track.rst 2021-02-09 05:15:05 UTC (rev 7745)
@@ -3,17 +3,299 @@
Track
*****
+Transform
+=========
+
+Todo.
+
+
+.. _bpy.ops.clip.track_markers:
+
+Track Motion
+============
+
+The Track Motion menu is used to perform tracking of selected tracks
+(i.e. following the selected feature from frame to frame).
+
+This operator depends on settings from the Tracking Settings panel.
+If during sequence tracking the algorithm fails to track some markers,
+they will be disabled and tracking will continue for the rest of the markers.
+If the algorithm fails when tracking frame-by-frame, the marker is not disabled,
+and the most likely position of the feature on the next frame is used.
+
+
+Backwards
+---------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Track --> Track Motion --> Backwards`
+ :Hotkey: :kbd:`Shift-Ctrl-T`
+
+Tracks the motion backward along the sequence.
+
+
+Frame Backwards
+---------------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Track --> Track Motion --> Frame Backwards`
+ :Hotkey: kbd:`Alt-Left`
+
+Tracks the motion backward by one frame.
+
+
+Forwards
+--------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Track --> Track Motion --> Forwards`
+ :Hotkey: :kbd:`Ctrl-T`
+
+Tracks the motion forward along the whole sequence.
+
+
+Frame Forwards
+--------------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Track --> Track Motion --> Frame Forwards`
+ :Hotkey: :kbd:`Alt-Right`
+
+Tracks the motion forward one frame.
+
+
+Clear
+=====
+
+.. _bpy.ops.clip.clear_track_path:
+
+Before
+------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Track --> Clear --> Before`
+ :Hotkey: :kbd:`Shift-T`
+
+Deletes all tracked and keyframed markers after the current frame for all selected tracks.
+
+Clear Active
+ Limits clear action to only active track (as opposite to all selected ones).
+
+
+After
+-----
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Track --> Clear --> After`
+ :Hotkey: :kbd:`Alt-T`
+
+Deletes all tracked and keyframed markers before the current frame for all selected tracks.
+
+Clear Active
+ Limits clear action to only active track (as opposite to all selected ones).
+
+
+Track Path
+----------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Track --> Clear --> Track Path`
+ :Hotkey: :kbd:`Shift-Alt-T`
+
+Clears all markers except the current one from all selected tracks.
+
+Clear Active
+ Limits clear action to only active track (as opposite to all selected ones).
+
+
Clear Solution
-==============
+--------------
Todo.
+.. _bpy.ops.clip.refine_markers:
+
+Refine
+======
+
+This operator will run a tracker from previous keyframe to current frame for all selected markers.
+Current markers positions are considering initial position guess
+which could be updated by a tracker for better match.
+
+Useful in cases when feature disappears from the frame and then appears again. Usage in this case is the following:
+
+- When feature point re-appeared on frame, manually place marker on it.
+- Use Refine Markers operation to allow tracker to find a better match.
+
+Depending on direction of tracking use either Forwards or Backwards refining.
+It's easy: if tracking happens forwards, use Refine Forwards, otherwise use Refine Backwards.
+
+
+Backwards
+---------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Track --> Refine --> Backwards`
+
+Refine the track backwards.
+
+
+Forwards
+--------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Track --> Refine --> Forwards`
+
+Refine the track forwards.
+
+
+.. _bpy.ops.clip.add_marker_move:
+
+Add Marker
+==========
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Track --> Add Marker`
+
+Places a new marker at the position of the mouse
+(which is under the button in this case, not ideal but it is just how things work)
+and then it can be moved to the needed location. When it is moved to the desired position,
+:kbd:`LMB` can be used to finish placing the new marker.
+Also, :kbd:`Return` and :kbd:`Spacebar` can be used to finish placing the marker.
+But it is faster to use :kbd:`Ctrl-LMB` to place markers directly on the footage.
+This shortcut will place the marker in the place you have clicked.
+One more feature here: until you have released the mouse button,
+you can adjust the marker position by moving the mouse and
+using the track preview widget to control how accurately the marker is placed.
+
+
+.. _bpy.ops.clip.detect_features:
+
+Detect Features
+===============
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Track --> Detect Features`
+
+Detects all possible features on the current frame and places markers at these features.
+This operator does not take other frames into account,
+so it might place markers on features which belong to moving objects.
+If the camera is turning away from this shot,
+no markers could be present within the frames after the camera moved away.
+
+There are several properties for this operator:
+
+Placement
+ Controls where to place markers.
+
+ Whole Frame
+ Places markers throughout the whole frame.
+ Inside Annotated Area
+ Places markers inside the area outlined with the :ref:`tool-annotate`.
+ This can be used to outline some areas with interesting features
+ and place markers only inside the outlined area.
+ Outside Annotated Area
+ Places markers outside the area outlined with the :ref:`tool-annotate`.
+ This can be used to outline areas of no interest (like trees, humans, etc.)
+ and place markers outside of these areas.
+Margin
+ Controls the distance from the image boundary for created markers.
+ If markers are placed too close to the image boundary,
+ they will fail to track really quickly and they should be deleted manually.
+ To reduce the amount of manual clean-up, this parameter can be used.
+Threshold
+ Limits minimal threshold for placing markers.
+ This value comes from the feature detection algorithm and it means:
+ low values means most probably this feature would fail to track very soon,
+ high value means it is not much such track.
+ Amount of markers to be added can be controlled with this value.
+Distance
+ Defines the minimal distance between placed markers.
+ It is needed to prevent markers from being placed too close to each other
+ (such placement can confuse the camera solver).
+
+
+.. _clip-tracking-plane:
+.. _bpy.ops.clip.create_plane_track:
+
+Create Plane Track
+==================
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Tracking
+ :Menu: :menuselection:`Track --> Create Plane Track`
+
+The *Create Plane Track* operator creates a new plane track.
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list