Synchronizing your video and telemetry.
Use this tab to synchronize your video and telemetry, possibly accounting for any video edits.
Note: if you are using map-only mode then you may have nothing to do here.

Single Cut
In the simplest case your video has not been edited and contains a single continuous cut. To align the video and
telemetry you must find the telemetry timestamp that corresponds to the start of your video. If you have an
estimate of this value (e.g., you know you started recording video 45 minutes into the ride), then you can enter
this estimate directly and then nudge the alignment using the arrow buttons. The single arrows add or subtract 1
second, while the double arrows add or subtract 15 seconds.

To make sure you've got the alignment right, check how it looks at moments in the video that are identifiable in the
telemetry:

If the activity has GPS data, look for corners or other landmarks like road or bridge crossings that are
visible on the map.

If the activity has power or cadence data, look for features like sprints at the end of a race, or times when
pedaling starts/stops in corners or at the top of climbs.

If the activity has elevation data, look for hillcrests.

If you don't have a great estimate of the alignment to start with, then find a major landmark in the video and search
around for it by entering timestamps directly in the text box. This is easiest if you have GPS data.

Multiple Cuts
If your video has been edited and contains multiple cuts (with temporal discontinuity) you will have to identify them
for SUFFERvision so they can be separately synchronized with the telemetry. If you've done the editing yourself
you may already know where they are, but otherwise you'll have to watch the video and look out for them (sometimes
tricky if there aren't obvious transitions).

For each cut requiring separate syncronization, click the "New Cut" button the moment it occurs. This will add a new
row showing the video timestamp of the cut, the currently synchronized telemetry timestamp, as well as buttons for making adjustments,
deleting the cut, or seeking to its start. As you watch the video the green highlighting will follow the currently active cut.
To avoid confusion you'll probably want to confine yourself to making adjustments on the active row.

Hiding Telemetry
If you would like telemetry to be shown for most of your video, but not shown for a specific cut (e.g., if the cut
corresponds to an instant replay in TV coverage, or to time after the race is over), enter -1:00:00 and all data will be
hidden for the duration of the cut.

Finish Line and Lap Counting
The last thing to do on this tab (and the only thing that's useful in map mode) is to mark the finish line (assuming your
activity is a race and there is a finsih line). Once you have syncronized your telemetry, find the moment in the video
where the finish line is crossed and press "Mark Line". Once the line is marked the "Line" display field will show distance
to this point (rather than distance to the end of the activity).

If your activity was a criterium or circuit race you may also enter how many laps remained at the moment you marked
the finish line (probably zero, but maybe not if you didn't finish the race). This enables SUFFERvision to compute and
display a lap counter (soon anyway ... I still need to port the lap counting logic from the desktop version of SUFFERvision).

Athlete

Display As

Color

Nudge

Kg

Find

Adding and tweaking activities
If your activity was a race or group ride then you may be able to find data for other participants on Strava,
Garmin Connect, or Training Peaks. If so, you can add them here, and, if everyone's clocks are accurate, the
other participants will be displayed as properly synchronized dots on the map.

The first activity shown in the list to the left is the primary activity used for setup and synchronization of data.
This activity can not be deleted and it is the only one (at the moment) for which SUFFERvision displays detailed data.

If your primary activity comes from Strava then you may click the "+" button to search Strava for related activities and
automatically add them. You can also manually enter the URLs of related activities in the text field at the bottom
of this tab.

Additionally on this tab you may:

Override an athlete's display name.

Choose the color of an athlete's map dot (e.g., to make all teammates the same color).

Nudge an athlete's time series forwards or backwards by a given number of seconds (for cases where the
device clock is off by a little, or maybe by some multiple of hours due to a timezone issue).

Enter an athlete's weight for use in Watts/Kg calculations (currently only of use for the primary activity).

Displayed Fields

{{ getFieldDisplayName(field) }}

Available Fields

{{ getFieldDisplayName(field) }}

Power Scale:

Chart Height:

Colors (video mode)

Colors (map mode)

Display Options
Here you can choose a number of mostly self-explanatory options for how data is displayed.

Drag fields between lists to choose which are displayed and in what order.

Two sets of three colors are provided, one for video mode and one for map mode (since what is legible
over the video may not be legible over the map). The first color is used for primary data display,
the second is used for displaying maximum power, and the third is used for the power thermometer.

Enter captions in SubRip format

Edit Captions
On this tab you can enter a set of captions with timing information. Currently captions are
displayed in the center of the screen and there is no control over positioning or font, though
this will likely be coming soon. The format is timing, followed by the caption, followed by
a newline, e.g.:

Save and Share your SUFFERvision
Enter a title and description and click "Save" to save your SUFFERvision and generate a permanent URL for sharing.
This will also provide an alternate URL with a security token to establish your ownership (SUFFERvisions are
not currently associated with any login).

Hang onto this alternate URL if you think you might want to come back
and edit your SUFFERvision later (Note: anyone can edit your SUFFERvision and save with a new URL. The security token
allows you to update the configuration behind an existing URL).

Once your SUFFERvision has a permanent URL you can click "Embed" to get HTML code for embedding it on a website.

Select embedded player size:
{{s.desc}}
Allow full screen

Where is the video?

By default the iPhone does not allow videos to play inline in a web page, but rather will pop them out to
play full screen, thereby preventing SUFFERvision from drawing on top. To view this SUFFERvision you'll
have to use another device, or wait until I get around to writing a native iPhone app. Sorry.