443 lines
12 KiB
ReStructuredText
443 lines
12 KiB
ReStructuredText
|
|
*****
|
|
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
|
|
---------
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Track Motion --> Backwards`
|
|
:Shortcut: :kbd:`Shift-Ctrl-T`
|
|
|
|
Tracks the motion backward along the sequence.
|
|
|
|
|
|
Frame Backwards
|
|
---------------
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Track Motion --> Frame Backwards`
|
|
:Shortcut: :kbd:`Alt-Left`
|
|
|
|
Tracks the motion backward by one frame.
|
|
|
|
|
|
Forwards
|
|
--------
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Track Motion --> Forwards`
|
|
:Shortcut: :kbd:`Ctrl-T`
|
|
|
|
Tracks the motion forward along the whole sequence.
|
|
|
|
|
|
Frame Forwards
|
|
--------------
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Track Motion --> Frame Forwards`
|
|
:Shortcut: :kbd:`Alt-Right`
|
|
|
|
Tracks the motion forward one frame.
|
|
|
|
|
|
Clear
|
|
=====
|
|
|
|
.. _bpy.ops.clip.clear_track_path:
|
|
|
|
Before
|
|
------
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Clear --> Before`
|
|
:Shortcut: :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
|
|
-----
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Clear --> After`
|
|
:Shortcut: :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
|
|
----------
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Clear --> Track Path`
|
|
:Shortcut: :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.
|
|
Accordingly if tracking happens forwards, use *Refine Forwards*, otherwise use *Refine Backwards*.
|
|
|
|
|
|
Backwards
|
|
---------
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Refine --> Backwards`
|
|
|
|
Refine the track backwards.
|
|
|
|
|
|
Forwards
|
|
--------
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Refine --> Forwards`
|
|
|
|
Refine the track forwards.
|
|
|
|
|
|
.. _bpy.ops.clip.add_marker_move:
|
|
|
|
Add Marker
|
|
==========
|
|
|
|
.. reference::
|
|
|
|
: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.
|
|
|
|
In addition to this 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
|
|
===============
|
|
|
|
.. reference::
|
|
|
|
: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
|
|
==================
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Create Plane Track`
|
|
|
|
The *Create Plane Track* operator creates a new plane track.
|
|
Planar tracking takes advantage of the fact that there are often planar surfaces in footage,
|
|
by attaching markers to points on these flat planes.
|
|
It can be used to replace things like billboards and screens on the footage with another image or video.
|
|
It also might be used for masking.
|
|
|
|
This button will create a plane object
|
|
which is deforming in the same way as plane defined by all selected point tracks.
|
|
At least four feature points tracked across the footage which belongs to
|
|
the plane you want to replace are needed. More tracks will give better estimation of plane motion.
|
|
|
|
Feature points used to estimate plane motion could be used from any place on the plane,
|
|
meaning it's not necessarily need to be corners. Corners are not always easy to be tracked,
|
|
they might be occluded. In this case you can position tracked features that lay on the same plane
|
|
far away from the actual plane which should be replaced.
|
|
|
|
This provides more information about the possible deformation of the marker in following frames,
|
|
and such markers can be tracked even if partially occluded (appear and disappear during the time).
|
|
It is only required that two neighbor frames have at least four common tracks.
|
|
|
|
An image can be projected onto the plane with
|
|
the :doc:`/compositing/types/tracking/plane_track_deform` compositing node.
|
|
|
|
|
|
.. _bpy.ops.clip.solve_camera:
|
|
|
|
Solve Solution
|
|
==============
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Solve Solution`
|
|
|
|
The *Camera Motion* operator solves the motion of camera using all tracks placed
|
|
on the footage and two keyframes specified on this panel. There are some requirements:
|
|
|
|
- There should be at least eight common tracks on the both of the selected keyframes.
|
|
- There should be noticeable parallax effects between these two keyframes.
|
|
|
|
If everything goes smoothly during the solve, the average reprojection error is reported to
|
|
the information space and to the Clip editor header. Reprojection error means the average
|
|
distance between reconstructed 3D position of tracks projected back to footage and
|
|
original position of tracks. Basically, reprojection error below 0.3 means accurate reprojection,
|
|
(0.3 - 3.0) means quite nice solving which still can be used.
|
|
Values above 3 means some tracks should be tracked more accurately,
|
|
or that values for focal length or distortion coefficients were set incorrectly.
|
|
|
|
.. (todo 2.62) object solver
|
|
|
|
|
|
.. _bpy.ops.clip.join_tracks:
|
|
|
|
Join Tracks
|
|
===========
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Join Tracks`
|
|
:Shortcut: :kbd:`Ctrl-J`
|
|
|
|
This operator joins all selected tracks into one.
|
|
Selected tracks should not have common tracked or keyframed markers at the same frame.
|
|
|
|
.. (wip)
|
|
Joining two tracks now works better for tracks which have got intersection by frames:
|
|
coordinates of joined track would be interpolated linearly on segments with intersection.
|
|
This is still not perfect from accurate solving point of view,
|
|
but this allows to prevent camera jump which is much more annoying than sight camera slide.
|
|
|
|
|
|
.. _bpy.ops.clip.average_tracks:
|
|
|
|
Average Tracks
|
|
==============
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Average Tracks`
|
|
|
|
The Average Tracks operator creates a new tracking marker by averaging the data from the selected tracks.
|
|
This can be used to improve stability of tracking on blurry or non-very-sharp feature shapes.
|
|
The operator takes into account all :doc:`Marker properties </movie_clip/tracking/clip/sidebar/track/marker>`
|
|
however, disabled markers do not affect the averaging.
|
|
|
|
Gaps in the original tracks will be linearly interpolated, to reduce result track jump.
|
|
Note that this only applies to gaps "in between".
|
|
This means that if a track does not have markers in the beginning or end of it,
|
|
there is nothing to interpolate with and the resulting track will jump.
|
|
|
|
Keep Original
|
|
When enabled, the selected tracks are *not* deleted.
|
|
|
|
|
|
Copy Tracks
|
|
===========
|
|
|
|
Todo.
|
|
|
|
|
|
Paste Tracks
|
|
============
|
|
|
|
Todo.
|
|
|
|
|
|
Animation
|
|
=========
|
|
|
|
Todo.
|
|
|
|
|
|
Show/Hide
|
|
=========
|
|
|
|
Todo.
|
|
|
|
|
|
Clean Up
|
|
========
|
|
|
|
.. _bpy.ops.clip.clean_tracks:
|
|
|
|
Clean Tracks
|
|
------------
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Clean Up --> Clean Tracks`
|
|
|
|
Identifies all tracks which matches settings from above and performs desired action on them.
|
|
|
|
Tracked Frames
|
|
Tracks or tracked segments shorter than this number of frames will be removed.
|
|
Reprojection Error
|
|
Tracks which has reprojection error higher than this value will be removed.
|
|
Action
|
|
Several actions can be performed for bad tracks.
|
|
|
|
Select
|
|
They can simply be selected.
|
|
Delete Track
|
|
The whole track can be deleted.
|
|
Delete Segments
|
|
Bad segments of tracked sequence can be removed.
|
|
|
|
|
|
.. _bpy.ops.clip.filter_tracks:
|
|
|
|
Filter Tracks
|
|
-------------
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Clean Up --> Filter Tracks`
|
|
|
|
This operator deletes obviously bad tracks (for example, the ones which are too short).
|
|
Additionally, it identifies tracks which has suspicious spikes in their motion and selects them.
|
|
|
|
|
|
.. _bpy.ops.clip.delete_track:
|
|
|
|
Delete Track
|
|
============
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Delete Track`
|
|
:Shortcut: :kbd:`X`
|
|
|
|
Delete all selected tracks.
|
|
|
|
|
|
.. _bpy.ops.clip.delete_marker:
|
|
|
|
Delete Marker
|
|
=============
|
|
|
|
.. reference::
|
|
|
|
:Mode: Tracking
|
|
:Menu: :menuselection:`Track --> Delete Marker`
|
|
:Shortcut: :kbd:`Shift-X`
|
|
|
|
Todo.
|