<div dir="ltr"><div class="gmail_default" style="font-size:small">Fantastic !! Easy to check this out on newer distros with AppImage (so all you have to do is a download, chmod +x, and run).</div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">There is an AppImage for users to test for newer distros (I will create one for older distros tomorrow after I fix my mistake first).  It is at:  <br></div><div class="gmail_default" style="font-size:small">   <a href="https://cinelerra-gg.org/download/images/cin_for_newer_distros.AppImage">https://cinelerra-gg.org/download/images/cin_for_newer_distros.AppImage</a> <br></div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">It is great fun to test -- please report if you find any problems as I have found none so far.</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, May 7, 2021 at 9:34 AM Georgy Salnikov via Cin <<a href="mailto:cin@lists.cinelerra-gg.org">cin@lists.cinelerra-gg.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi all,<br>
<br>
This new implementation of Cinelerra context help can be requested from<br>
almost any Cinelerra window or subwindow by pointing with the mouse cursor<br>
on the GUI element of interest and pressing Alt/h. That HTML manual page<br>
will be shown via the configured web browser, which is assumed as most<br>
relevant to the GUI element being currently under the mouse pointer. For<br>
more information see issue 568 on the bugtracker:<br>
<a href="https://www.cinelerra-gg.org/bugtracker/view.php?id=568" rel="noreferrer" target="_blank">https://www.cinelerra-gg.org/bugtracker/view.php?id=568</a><br>
<br>
How to install, configure and demonstrate the new functionality<br>
---------------------------------------------------------------<br>
<br>
1. Apply the patch (see BT568) to the CinGG source tree:<br>
<a href="https://www.cinelerra-gg.org/bugtracker/file_download.php?file_id=775&type=bug" rel="noreferrer" target="_blank">https://www.cinelerra-gg.org/bugtracker/file_download.php?file_id=775&type=bug</a><br>
<br>
2. After patching one new file appears: doc/ContextManual.pl. This is a perl<br>
script. It must be given exetutable permissions.<br>
<br>
3. Build and install CinGG as usual.<br>
<br>
4. The prerequisite for context help is CinelerraGG HTML manual. After<br>
installation of CinGG itself, place the complete unchanged directory<br>
CinelerraGG_Manual, as it was produced by latex2html from the manual<br>
package, into the 'doc' directory of the installed Cinelerra package. This<br>
will be the directory bin/doc/CinelerraGG_Manual if CinGG was built<br>
--with-single-user. The script ContextManual.pl should appear after<br>
installation also here, in bin/doc.<br>
<br>
5. In principle, this is sufficient. Nevertheless, the<br>
bin/doc/ContextManual.pl script can be configured further. Look in the<br>
script text. You can define your preferable web browser, or redefine it to<br>
'echo' for debug purposes. There are also some predefined HTML pages for<br>
Contents and Index, and several explicitly rewritten keyphrases. However,<br>
there can be hardly a need to redefine anything except the name of the<br>
browser executable.<br>
<br>
6. Start Cinelerra and open a project with some assets, effects, keyframes,<br>
etc. May be, open some additional Cinelerra dialog windows, plugin settings,<br>
etc. Try to point with the mouse on different GUI elements or on empty<br>
spaces in different windows and press Alt/h. You should get different manual<br>
pages in the browser (if browser was not yet started, it should start<br>
automatically).<br>
<br>
How it works, from the user's point of view<br>
-------------------------------------------<br>
<br>
The hotkey to request context help is Alt/h. Why? A simple 'h' does not fit:<br>
in text fields it has to input the letter 'h'. So is Shift/h: it would mean<br>
the capital letter 'H'. Ctrl/h and Ctrl/Shift/h are also not suitable: it is<br>
<Backspace>. Something like <F1> would be also not good, <Fn> are already<br>
utilized in Compositor. Unlike these all, Alt/h seems to be a good hotkey<br>
and, to the best of my knowledge, it is not assigned to anything else<br>
throughout the whole Cinelerra code.<br>
<br>
What particular help page is shown, depends on the mouse cursor location<br>
while Alt/h is pressed. Usually, when the mouse is located in some window or<br>
dialog, the help page related to the functionality of this window or dialog<br>
is shown. In this case the mouse can point either on some widget, or on an<br>
empty area in the window.<br>
<br>
In Cinelerra GUI there are several rich loaded windows, Timeline and<br>
Compositor for example. In such a case different help pages can be requested<br>
depending on the particular GUI element under the mouse. For example,<br>
pressing Alt/h while pointing on the Autos curve in a track would show help<br>
on automation keyframes, pointing on the Overlay mode button in the patchbay<br>
would show help on overlays, pointing on the camera control in Compositor<br>
would show help on camera and projector.<br>
<br>
If no context dependent help page is found, the manual page of Contents<br>
itself is shown. Most probably it means, that either the meaning of this<br>
window is obvious (so is the 'Tip of the day' window, for example), or it is<br>
not (yet) documented.<br>
<br>
Requesting context help for plugins<br>
-----------------------------------<br>
<br>
There are following possibilities to request help page for the particular<br>
plugin of interest.<br>
<br>
1) Pressing Alt/h with mouse in the dialog window of plugin settings<br>
<br>
2) Pressing Alt/h while pointing with the mouse on the plugin bar in a track<br>
(or transition bar, or transition icon)<br>
<br>
3) Pressing Alt/h while pointing on the plugin name (icon) in the Resources<br>
window. If plugin tooltips are on, help for the highlighted (plugin under<br>
mouse) is shown. If plugin tooltips are off, help for the selected plugin is<br>
shown (it is made so, because in the latter case it would be difficult to<br>
figure out, without a visual feedback, which particular item is currently<br>
under mouse).<br>
<br>
4) Pressing Alt/h while pointing on the plugin name in the Attach Effect<br>
dialog<br>
<br>
Requesting context help on Contour Shuttle<br>
------------------------------------------<br>
<br>
Contour Shuttle has no Alt/h, yeh. Nevertheless, its help page can be<br>
requested by simultaneous pressing both Alt keys (left and right) on the<br>
keyboard followed by pressing any button on the Contour Shuttle. Here,<br>
pressing both Alt keys is necessary due to the way of X11 to track the<br>
status of modifiers. To cancel this mode, press any single modifier key<br>
(Alt, Ctrl or Shift) once.<br>
<br>
_______________________________________________________________________________<br>
<br>
Georgy Salnikov<br>
NMR Group<br>
Novosibirsk Institute of Organic Chemistry<br>
Lavrentjeva, 9, 630090 Novosibirsk, Russia<br>
Phone   +7-383-3307864<br>
Email   <a href="mailto:sge@nmr.nioch.nsc.ru" target="_blank">sge@nmr.nioch.nsc.ru</a><br>
_______________________________________________________________________________<br>
<br>
-- <br>
Cin mailing list<br>
<a href="mailto:Cin@lists.cinelerra-gg.org" target="_blank">Cin@lists.cinelerra-gg.org</a><br>
<a href="https://lists.cinelerra-gg.org/mailman/listinfo/cin" rel="noreferrer" target="_blank">https://lists.cinelerra-gg.org/mailman/listinfo/cin</a><br>
</blockquote></div>