Hello
The timeline refresh issue could be a bug, I will investigate it.
Here are some answers to your questions. Now that you have expressed your final aim, it will be easier to guide you:
- the imagecache directory stores a cache of screenshots, that are taken not only for annotations. For instance, every time you change position in the video, a screenshot is taken too. That is why there are not only the screenshots you expected.
- the "Update annotation" feature is based on best-effort: sometimes, it cannot grab all missing screenshots in one run, and it must be run again. I chose to not make this automatically, since it may become uncontrolable (for instance going into an infinite loop). It is not strictly necessary to run it though: every time an annotation is created, Advene will automatically try to capture screenshots for it. In the lower right hand corner of the application, there is a green square that displays the screenshot capture activity, so that you can monitor what is going on.
- there are many ways in Advene to fix shots (considered as annotations). You can manually edit any (generated or not) annotation: double click on an annotation, use the "e" shortcut... To merge annotations, you can select them (by drawing a rectangle around them) and select "Merge" from the contextual menu. There are some other shortcuts, like control+click on the bounds of an annotation. You can have a look at
http://www.advene.org/wiki/index. ... eShortcuts
for a complete list.
A specialized interface view is dedicated to fixing continuous sequential annotations (i.e. like shots, where the end of an annotation is also the beginning of the new one): right-click on the Annotation type ("Detected shots" here) and select "Update annotation bounds". A new interface will open, displaying the immediate frames around annotation boundaries. To fix a cut position, click on the desired frame. You can also merge annotations. The
http://www.advene.org/screencasts ... dation.ogv
screencast shows how this interface works.
Your aim of generating an HTML file with annotation is right into the sweet spot for Advene: Advene uses a XML-based template language (the Zope Page Templates engine) that can be used to specify any type of rendering using annotations and information from the movie. To get you started, right-click on the annotation type (Detected shots) and select "Create a comment view". A view template will be generated. To see what its rendering looks like, click on the W3 button (in the top toolbar of the view editing interface): it will open the generated document in your browser.
You can adjust this template to your needs: from the (sort-of, unfinished) WYSIWYG editor, you can right-click on the "Rendering Shots as table" to select other templates. And if you need more control, you can click on the <> (Edit HTML source) icon, and adapt the HTML template to your needs (using a plain <table> instead of a <div> grid, etc).
There is definitely a lack of documentation. Do not hesitate to ask questions on the forum, it is meant as a form of "live/on-demand" documentation, in the absence of a better solution. You can also contribute to the user wiki:
http://www.advene.org/wiki/index. ... eUserGuide