Docs / 03
Controls
Every row of the panel, top to bottom: the Inspector in DaVinci Resolve, Effect Controls in Premiere Pro. Open a row for the full detail.
Written for Ball Tracer 0.2.4 What changed
On this page
Select the clip that has Ball Tracer on it and open the Inspector. All 101 rows below are in the panel, in the order the Inspector shows them.
Select the clip that has Ball Tracer on it and open Effect Controls. The groups, their order and the starting values below hold in Premiere Pro too, with these differences.
- Rows Premiere Pro does not show. Licence Key (the key goes in the window that Activate opens). Ball At Impact, Landing and Ball Mark (you set them on the Program Monitor instead). The path handles Close, Mid 1 … Far (you drag them on the Program Monitor). Track On System Memory and Track On Graphics Card (Premiere Pro has no such switch). They are left out of the list below, and Premiere Pro has no Holdout input either.
- Renamed rows. Start Frame and End Frame read Start (File Frame) and End (File Frame): they count frames of the camera file, not of the timeline. Clip Frame Rate starts at Auto (as Premiere reports). Use Recorded Impact and Use Landing Marker rename themselves to show the marker: Impact: frame N (set) or Impact: not set, and the same for Landing.
- Messages. Status, Licence Status and Support Status show their message as the name of a greyed tick box, cut to 31 characters with three dots. A press that stops also opens a message box with the whole sentence.
- The Program Monitor is the viewer. Where a row says the viewer, Premiere Pro's Program Monitor is meant. The markers, path handles, track points and mask corners are drawn there, and only while the effect is selected. Set a marker by double-clicking it: a drag only moves it.
- Stopping a pass. Trace Ball, Trace With Marks As Help, Draw Path From Marks and Track Camera run outside Premiere Pro, in a small window with a Cancel button. Press Cancel to stop one, where Resolve uses Esc. Esc, Enter and Space press it too.
- Keyframes. Wipe Length, Trail Length and Dissolve Time can be keyframed with their stopwatch. The facts of the shot cannot: Link Path to Camera, the marks and the path handles.
Status
The first row, above every group.

StatusWhat the last button press did.
When something needs your attention, a message box gives the longer explanation.
Starts at “No tracking yet.”
Licence
Buy is greyed once Ball Tracer is activated, and Deactivate is greyed until it is.

Licence StatusWhat the licence is doing.
The troubleshooting page lists every message it can show.
Starts at “Trial unless activated.”
Licence KeyPaste your key here and press Enter, then press Activate.Starts at Empty
The key is never saved in the project, and the field is cleared after every press.
ActivateActivates Ball Tracer on this computer and removes the TRIAL mark from new frames.
Needs an internet connection once.
ActivateOpens a small window: paste your key into it and press Activate there.
Activating removes the TRIAL mark from new frames. Needs an internet connection once.
DeactivateReleases this computer's activation so the key can be used on another computer.
The TRIAL mark comes back on this one. Greyed until Ball Tracer is activated.
Buy Ball TracerOpens balltracerplugin.com/buy in your web browser.
Greyed once Ball Tracer is activated.
Shot
Which frames get tracked.

Start FrameThe first frame of the range that gets tracked.Starts at Auto
With End Frame at 0, Trace Ball and Track Camera use the clip's whole cut and fill both numbers in.
Starts at 0 (Auto, with End Frame at 0)
Start (File Frame)The first frame of the range that gets tracked, counted in the camera file's frames, not the timeline's.Starts at Auto
With End (File Frame) at 0, Trace Ball and Track Camera use the clip's cut and fill both numbers in.
Starts at 0 (Auto, with End (File Frame) at 0)
End FrameThe last frame of the range, included in it. 0 means Auto: the whole cut.Starts at Auto
Trace Ball and Track Camera fill in the real frames when pressed.
Starts at 0 (Auto)
End (File Frame)The last frame of the range, included in it, counted in the camera file's frames. 0 means Auto: the clip's cut.Starts at Auto
Trace Ball and Track Camera fill in the real frames when pressed.
Starts at 0 (Auto)
- Set Start to PlayheadUses the frame you are parked on as the start of the range.
- Set End to PlayheadUses the frame you are parked on as the end of the range.
Camera
How the trail sticks to a moving shot.

Track CameraFollows the whole scene automatically.
When it finishes, the tracked points appear on the picture and the trail rides the solved camera.
Use as CloseMakes the highlighted track point the anchor for the trail's Close end.
Click one of the track points in the viewer first. Greyed until Track Camera has produced a usable track.
Use as CloseMakes the highlighted track point the anchor for the trail's Close end.
Click one of the track points, the crosses on the Program Monitor, first.
Use as FarMakes the highlighted track point the anchor for the trail's Far end.
Click one of the track points in the viewer first. Greyed until Track Camera has produced a usable track.
Use as FarMakes the highlighted track point the anchor for the trail's Far end.
Click one of the track points, the crosses on the Program Monitor, first.
Camera Is Locked OffTick it for a locked-off tripod shot.Starts at Off
Use the clip as filmed: a stabilised clip is not supported yet. Trace Ball then skips the camera step and needs no tracking. Leave it off for any shot that pans, tilts or zooms.
Trace
Finds the real ball and fits its flight.

Impact FrameThe frame the ball was struck on.Starts at Playhead
Correct it here instead of parking again. A recorded impact (Use Recorded Impact) or a Mark Is Impact mark takes its place when either is on.
Starts at Taken from the playhead when you press Trace Ball
Ball At ImpactWhere the ball sits on the impact frame.Starts at Not set
Drag the amber ring onto the ball; unset, it waits hollow at the centre of the frame. Optional, and the most useful thing to set: a flight that does not come back to this point is thrown out.
Starts at 0, 0 (not set)
Landing In ShotTick it when the ball is seen coming down and landing in the picture, such as a short shot, a chip or a camera at the green.Starts at Off
Unticked, the trace looks for the ball only until it fades, about 1.5 s after the impact, and the physics carries the flight to its landing.
AI Ball Finder (experimental)Lets the AI ball finder look for the ball on every frame.Starts at On
It runs on the graphics card and works best on a ball in the air against the sky. The classic finder is still used where the AI finds nothing. Windows only, and experimental.
Trace BallFinds the ball and draws its flight.
Press it while parked on the frame the club meets the ball. If the camera has not been tracked yet, it tracks the camera first and then carries on.
Fix With Ball Marks
Mark the ball by hand, frame by frame, where the tracer cannot find it.

Mark Ball ModeA clean viewer for marking the ball by hand: the trail and every other handle are hidden, and a click puts a Ball Mark on the ball on this frame (click again, or drag, to move it).Starts at Off
Step a frame with the arrow key and click the ball again, for as long as you can see it. Then press Trace Ball, with this on or off, and the flight is fitted through your marks and carried on to its landing.
Mark Ball ModeA clean Program Monitor for marking the ball by hand: the trail and every other handle are hidden.Starts at Off
Click the ball to put a Ball Mark on this frame; a click elsewhere moves this frame's mark, and a drag moves any mark. Double-click a mark, or press Delete, to remove it. The arrow keys stay Premiere's, so step a frame as usual and click the ball again, for as long as you can see it. Then press Trace Ball, with this on or off, and the flight is fitted through your marks and carried on to its landing. Ctrl+Z does not undo a mark.
Trace With Marks As HelpRuns the automatic trace with your Ball Marks as help.
Where its path misses a mark, such as a failed or difficult shot or a ball it lost, the flight is refitted to your marks and the ball it saw along them, and the tracer works out the rest. Needs at least one mark.
Draw Path From MarksDraws the path through your Ball Marks on every frame, smoothed, with no automatic tracing, like tracing it frame by frame by hand.
Needs at least two marks. Mark more frames where it should bend.
Mark Is ImpactMarks the Ball Mark on this frame as the ball at impact: every trace starts from this frame and this point, even over a recorded impact, and marks before it are not used.
With Mark Is Landing set too, the flight runs from this mark to the landing mark. Press again on the same frame to unmark it. Greyed until Mark Ball Mode is on.
Mark Is LandingMarks the Ball Mark on this frame as where the ball lands: Trace Ball fits the flight to your marks up to it and ends the arc exactly there, on that frame.
Marks after it are drawn as the bounce and roll. Press again on the same frame to unmark it. Greyed until Mark Ball Mode is on.
Delete Mark On This FrameRemoves the Ball Mark on the playhead's frame.
Greyed until Mark Ball Mode is on.
Clear All MarksRemoves every Ball Mark on this effect.
Greyed until Mark Ball Mode is on.
Style
What the trail is made of, how it appears, its colour and width, and what hides it.

LookWhat the trail is made of.Starts at Simple
Simple is a flat line. Paper Ribbon is a narrow paper strip folded down the middle that turns slowly as it flies, with a lit edge and a shaded edge. Broadcast Tube is a glossy tube with a dark outline and a white streak. Flow Dash is capsules flowing from the tee to the landing over a thin guide line. Picking one sets its starting colours; change them freely after.
AnimationHow the path appears and leaves, on top of the reveal.Starts at Chase Ball
Chase Ball grows behind the ball and stays. Peak Wipe wipes the start away up to the peak once the ball passes the top, so the landing half is the one you see. Comet Trail flies only a long trimmed piece with the ball and brings it down with it. Overlap Dissolve dissolves the rising part where the falling half crosses back over it, as the ball passes.
- ColourThe trail's colour at the close end.Starts at Red
WidthThe trail's thickness at the close end, in pixels.Starts at 20 px
Range 0.1 to 500
Hide Behind ObjectsHides the trail where a tree, a player or anything else nearer than the ball stands in front of it.Starts at Off
Things farther away, like a treeline behind the landing, never hide it. Hidden takes the trail out completely there; White leaves a pale white ghost of it. White Opacity, Sky Only and the mask rows are in Hide and Masks.
AutoZoom
Zooms the picture in on the ball as it lands, following the landing the trace found; Flight Time moves it.

AutoZoomZooms the picture in on the ball as it lands.Starts at Off
The zoom follows the landing the trace found, and Flight Time moves it.
Zoom AmountHow much closer the picture gets when the ball lands. 30 is about a third bigger, 50 half again, 100 doubles it.Starts at 50
The trail comes with it. Past about 150 the picture starts to look soft.
Range 0 to 900
Zoom LengthHow many frames the zoom takes. 12 is a hard snap, 60 a slow push in.Starts at 40 frames
Changing it only moves where the zoom starts: it always finishes where Offset says.
Range 1 to 600
OffsetMoves the whole zoom earlier or later without changing its length, counted from the landing. 0 is fully in as the ball lands; 6 is six frames after; -6 is fully in six frames before.Starts at 0
Range -600 to 600
Offset to PlayheadPark on the frame the picture should be fully in and press it.
It fills in Offset for you.
Trace Settings
Starts closedTuning, checks and hand fixes for the camera and the trace, plus where tracking keeps its frames (a setting for the whole computer, not the project).

Reset TrackingThrows the stored camera track, the traced flight and the detections away.
The handles and the look stay as they are, and the path stops moving with the shot. It asks for a second press first.
Show Track PointsDraws the automatic camera track's points on the picture.Starts at On
They exist only after Track Camera has run, and the row is greyed until then.
Clip Frame RateThe frame rate the clip was filmed at.Starts at Auto
Auto uses the rate Resolve reports. On the Fusion page that is the composition's own rate, which can differ from the clip's, and the flight then comes out wrong. Pick the clip's own rate when they differ. The trace's status says which rate it used.
Starts at Auto (as Resolve reports)
Clip Frame RateThe frame rate the clip was filmed at.Starts at Auto
Auto uses the camera file's own rate, as Premiere reports it. Pick a rate to override it.
Starts at Auto (as Premiere reports)
Flight Time (s)How long the ball is in the air, impact to landing, in seconds (6.250 is 6 s 250 ms).Starts at Auto
Every trace fills it in with the flight it found. Change it and the drawn flight is retimed at once: the arc keeps its shape and lands that long after impact, and the next trace holds the flight's physics to it. 0 lets the trace decide.
Starts at 0 (automatic)Range 0 to 15
Apex Height (%)Raises or lowers the top of the flight.Starts at 0
Drag the slider, or the small handle above the top of the path: they are the same number. Impact and landing stay where they are, and 0 gives the path as traced. Lowering a low shot a long way can make the path dip. It does nothing on a shot with no high point to lift, such as a putt or a shot that leaves the top of the picture, or with Draw Path From Marks; if it is not 0, Ball Tracer says so.
Range -20 to 20
LandingWhere the ball comes down: the amber ring with a bar.Starts at Not set
Set it when the ball leaves the picture, or gets too small to follow, before it starts to fall. Double-click the marker on the frame the ball comes down to record that frame as well. Left at 0, 0 the landing is estimated from the flight.
Starts at 0, 0 (not set)
Use Landing MarkerDouble-click the Landing marker in the viewer on the frame the ball comes down: its place and that frame are recorded and shown above it, and the trace lands there.Starts at On
Double-click again to update it. Untick to keep the marker but let the trace ignore it.
Use Landing MarkerDouble-click the Landing marker in the Program Monitor on the frame the ball comes down: its place and that frame are recorded, and the trace lands there.Starts at On
A drag only moves the marker. Double-click on that frame again to clear it. Untick to keep the marker but let the trace ignore it. The row renames itself to show the marker: Landing: frame N (set), or Landing: not set.
Use Recorded ImpactDouble-click the Ball At Impact marker in the viewer on the frame the ball is struck: that frame is recorded as the impact and shown above the marker.Starts at Off
Trace then starts from it wherever the playhead is. Double-click again on another frame to update it, or drag the marker to move it. Untick to keep the recording but trace from Impact Frame instead.
Use Recorded ImpactDouble-click the Impact marker in the Program Monitor on the frame the ball is struck: that frame and the marker's place are recorded.Starts at Off
Trace then starts from it wherever the playhead is. A drag only moves the marker. Double-click on that frame again to clear it. Untick to keep the recording but trace from Impact Frame instead. The row renames itself to show the marker: Impact: frame N (set), or Impact: not set.
SensitivityHow faint a moving thing may be and still count.Starts at 0
Raise it when no ball was found. It finds more noise too, which the fit is built to survive.
Range -100 to 100
- Show DetectionsDraws the moving blobs the ball finder found, in the viewer only, so you can tell the ball from a bird.Starts at Off
Show MarkersDraws the Ball At Impact and Landing markers.Starts at On
They sit on top of the path's first and last handles and take the click, so untick this to grab the handle underneath. Their values are kept.
Ball MarkWhere you marked the ball, one keyframe a frame.Starts at Not set
Mark Ball Mode sets these by clicking.
Starts at 0, 0 (not set)
Use Marks In TraceWith three or more Ball Marks, Trace Ball takes them as the ball: the impact is the first mark, the flight goes through every mark and the physics carries it on after the last.Starts at On
Off, Trace finds the ball itself and the marks are kept.
Track On System MemoryRuns tracking and tracing from system memory instead of the graphics card.
Use it if passes keep stopping for lack of graphics memory. Playback gets slower: about 58 ms a frame at UHD instead of 1 to 6 ms. Takes effect when Resolve restarts.
Track On Graphics CardGoes back to the graphics card, the normal and fast setting.
Takes effect when Resolve restarts.
Path Handles
Starts closedThe shape of the flight, and how much of it is drawn.

PointsHow many handles shape the path.Starts at 3
Five follow a struck ball's steep climb and its bend over the top; fewer are quicker to drag by hand. Until you set it yourself, a trace picks three handles, or five when the path needs them, and Points shows what it picked.
Range 2 to 6
Close, Mid 1 … FarThe path's handles.
The first is always Close and the last in use is always Far; handles beyond Points show as “(unused n)”. Drag them in the viewer. Click one and the arrow keys nudge it one screen pixel; click empty picture to give the arrows back to Resolve.
Starts at Laid out on the frame when you add the effect
Smoothness0 joins the handles with straight lines. 100 rounds the path off completely.Starts at 100
Range 0 to 100
Reveal FromWhere the drawn trail starts, along its length. 0 draws from the tee.Starts at 0
Raise it to trim the trail from behind, and keyframe it with Reveal to run a span along the flight. The ground shadow is trimmed with it.
Range 0 to 100
RevealHow much of the trail is drawn, along its length.Starts at 100
Follow Ball drives it, so keyframes here are ignored while Follow Ball is on. To animate it by hand, turn Follow Ball off or set Reveal Curve to Manual.
Range 0 to 100
Link Path to CameraLets the tracked camera carry the path, so it stays glued to the scene as the camera moves.Starts at On
Needs Track Camera to have run. If you picked a Close and a Far point, the near end rides the Close point and the far end rides the Far point; otherwise the whole camera track carries it.
Look Details
Starts closedThe finer look: far colour, shape, shadows, and the sliders of the chosen Look and Animation.

- Colour FarThe trail's colour at the far end, used by Gradient.Starts at White
GradientHow far the trail shifts toward Colour Far along its length. 0 is one flat colour.Starts at 0
Range 0 to 100
OpacityHow solid the trail is, shadow included.Starts at 100
Animate it to fade the whole trail away.
Range 0 to 100
TaperHow much the trail thins toward the far end.Starts at 90
It is what gives a trail depth.
Range 0 to 100
Head SizeThe diameter of a dot at the leading end of the drawn trail, in pixels.Starts at Off
It makes a growing trail read as a ball with a trail behind it.
Starts at 0 (off)Range 0 to 400
Shadow OpacityHow solid the ground shadow is, as a share of Opacity.Starts at 50
The shadow is a straight streak running beneath the flight.
Range 0 to 100
Shadow LengthHow far the shadow runs, as a share of the straight line from the trail's start to its end.Starts at 50
Range 0 to 100
Shadow TaperHow much the shadow thins toward its far end.Starts at 100
Range 0 to 100
Shadow FadeHow much the shadow fades out toward its far end.Starts at 100
This is opacity; Shadow Taper handles width.
Range 0 to 100
Overlap ShadowWhere the trail comes back down over itself, the climb casts a soft shadow on the part behind it, so the two stay apart.Starts at 70
It shows only where they meet. 0 is off.
Starts at 70 on a new effectRange 0 to 100
Overlap SoftnessHow soft the overlap shadow is, as a share of the trail's width.Starts at 20
Range 0 to 100
Paper FoldHow strongly the paper's two halves catch and lose the light.Starts at 60
Greyed unless Look is Paper Ribbon.
Range 0 to 100
Paper TwistHow much the paper narrows as it turns edge-on along the flight.Starts at 50
Greyed unless Look is Paper Ribbon.
Range 0 to 100
Paper ShadowThe shadow the paper casts where the path crosses itself, at least as strong as Overlap Shadow.Starts at 60
Greyed unless Look is Paper Ribbon.
Range 0 to 100
GlossHow bright the white streak along the tube is.Starts at 80
Greyed unless Look is Broadcast Tube.
Range 0 to 100
Dash LengthHow long each dash is, in trail widths.Starts at 2.2
Dashes shrink with the trail as it goes away. Greyed unless Look is Flow Dash.
Range 0.5 to 8
Dash FlowHow fast the dashes flow toward the landing, in trail widths a second. 0 holds them still.Starts at 4
Greyed unless Look is Flow Dash.
Range 0 to 30
Wipe StartsWhen the wipe begins: as the ball passes the peak (At the Peak), or once it has landed (At Landing).Starts at At the Peak
Greyed unless Animation is Peak Wipe.
Wipe LengthHow many frames the wipe takes, eased in and out.Starts at 60 frames
Greyed unless Animation is Peak Wipe.
Range 1 to 240
Wipe EdgeHow soft the wipe's edge is, as a share of the path.Starts at 6
Greyed unless Animation is Peak Wipe.
Range 0 to 100
Trail LengthHow many frames of flight the comet's trail spans behind the ball.Starts at 36 frames
Greyed unless Animation is Comet Trail.
Range 3 to 180
DissolveHow far the overlapped part of the rising path dissolves.Starts at 100
Greyed unless Animation is Overlap Dissolve.
Range 0 to 100
Dissolve TimeHow many frames each part takes to dissolve once the ball has passed over it.Starts at 16 frames
Greyed unless Animation is Overlap Dissolve.
Range 1 to 90
Overlap ReachHow close, as a share of the trail's width, the two halves must come to count as overlapping.Starts at 30
Greyed unless Animation is Overlap Dissolve.
Range 0 to 100
Reveal Timing
Starts closedWhen the trail draws on.
Follow BallDraws the trail on with the ball itself, as the trace measured it.Starts at On
It is switched on again after every trace. Turn it off to pace the trail with a Reveal Curve preset instead, or pick Manual (Reveal Slider) to keyframe it by hand.
Reveal CurveHow the reveal is paced when Follow Ball is off, from Reveal Start Frame for Reveal Duration.Starts at Snap and Drop
Measured Flight keeps the traced flight's own pacing. Soft Landing leaps off, crawls and settles. Smooth Slow-Down spends everything up front. Constant Speed is a steady wipe. Putt Roll bursts off and rolls a long soft tail, like a real putt. Snap and Drop, the default, climbs the way real drives do and drops in. Pitch pops up, hangs and drops in. Chip and Run bursts off and creeps to rest. Manual (Reveal Slider) hands the trail back to the Reveal slider.
Reveal Start FrameThe frame the reveal begins on. 0 uses the flight's own first frame.Starts at Auto
A trace sets it to the impact frame, once; change it to move the whole reveal. Used by the Reveal Curve presets.
Starts at 0 (automatic)
Reveal DurationHow many frames the reveal takes. 0 uses the flight's own length.Starts at Auto
A trace sets it to impact to landing, once, and Flight Time keeps it in step until you change it. Used by the Reveal Curve presets.
Starts at 0 (automatic)
Reveal Mid FrameThe frame the trail reaches the middle of the path: point 2, the apex, on a three-point path. 0 lets Reveal Curve pace the whole reveal; the start and the landing stay where they are, and the curve still shapes the trail either side.Starts at Auto
Used on every Reveal Curve except Manual (Reveal Slider).
Starts at 0 (automatic)
MiddlePark where the ball is at the middle of the path, the apex, and press it: the trail reaches that point on this frame while the reveal still starts and lands where you set them.
Used on every Reveal Curve except Manual (Reveal Slider).
Hide and Masks
Starts closedWhere the trail hides: behind objects, under a mask, or against the sky only.

Only On The Way DownWith Hide Behind Objects on, the trail is hidden only from the top of the flight on, as the ball comes down behind trees, people or flags; the climb off the tee is never touched.Starts at On
Untick it to hide along the whole path. A putt or a roll, which never climbs, is hidden along all of it either way.
White OpacityWith Hide Behind Objects on White: how strongly the white ghost shows behind an object.Starts at 45
Range 0 to 100
Sky OnlyWith Hide Behind Objects on: above the horizon the trail is seen only against the sky, whether clear, cloudy, hazy or bright midday, and anything else there (trees, poles, buildings) takes it out, near or far.Starts at Off
Below the horizon it is left alone.
Garbage MaskDraws a four-corner shape on the viewer; drag its corners.Starts at Off
Hide Behind Objects then works only inside it, or only outside with Invert Mask, so you choose which tree or player may hide the trail. It moves with the camera track's Far point.
- Invert MaskHide Behind Objects works everywhere except inside the Garbage Mask.Starts at Off
Mask FeatherHow soft the Garbage Mask's edge is, as a share of the picture's height.Starts at 3
Range 0 to 100
Clean SkySmooths the camera's grain out of the sky and the clouds, and nowhere else.Starts at Off
Trees, players and the course are left as they are. 0 is off.
Starts at 0 (off)Range 0 to 100
- TransparentOutputs the trail over transparency instead of over the shot, so it can be composited on its own layer.Starts at Off
Support
The last group, open when the panel opens.
Support StatusWhat the Support rows are doing, and the reference code after a bundle has been sent.
Starts at “Nothing prepared yet.”
Prepare Debug LogWrites a support bundle from this session to your computer.
Nothing is sent yet. Press it straight after something goes wrong; there is nothing to turn on first and no restart.
Open BundleOpens the prepared bundle in your file browser so you can read every line before any of it is sent.
It is plain text.
Send to SupportUploads the prepared bundle and shows a reference code, such as BT-7K3Q-2M.
Your licence key is never included, and your account name in file paths is replaced with %USER%.