Hi,
I totally agree that the wording is confusing. I have struggled since the begining to find something appropriate.
Here is a proposition to simplify the save dialog:
1 - Remove the first option of saving the video "naked". (If you want to save the video without any drawings on, just don't add drawings in the first place).
2 - Change the wording of the next options to:
A - Save video while keeping tools modifiable
B - Save video with tools applied on images
Let me know if these seem more straightforward.
The wording issue came from the fact that the set of things that can be painted on the video is heterogenous. There are the drawings like arrows or labels which are attached to a key image, there are grids or magnifier that are not attached to a key image, there are tracks and chrono, etc. The internal name is "Metadata" but that's not telling much to the user.
The caveat with the new wording is that it does not necessarily convey the fact that option A will save the key image comments (the block of formatted text). Also, you still have to "guess" that when saved with option A, the drawings will not show up in regular players or in YouTube, Vimeo, etc.
But overall I think it's clearer.
Technically, option A use a special stream to save the meta data. A multimedia file can contain for example a video stream, an audio stream, several subtitle streams, all packed in a single container. This technique is used to embed the metadata inside a single file. The format is specific to Kinovea, so the extra data is only visible when reopening the file in Kinovea, not in other multimedia players. The option of saving the data in a external file is also provided as the last option of the same dialog.
Let me know what you think of the new wording.