minor MatN changes; Andrea Cuda info; Phyllis Windows.tex small fixes
authorGood Guy <good1.2guy@gmail.com>
Sat, 22 Feb 2020 22:49:06 +0000 (15:49 -0700)
committerGood Guy <good1.2guy@gmail.com>
Sat, 22 Feb 2020 22:49:06 +0000 (15:49 -0700)
CinelerraGG_Manual.tex
images/autocolor-assets.png [deleted file]
images/autocolor-assets_alpha0.png
images/autocolor-assets_alpha1.png
images/window_layout2.png
parts/Glossary.tex
parts/Tips.tex
parts/Windows.tex

index cc6fa705270bbf33148f0610e0a05e707cbefecf..202c437f8d3b02773fac68357ab53848bac52f17 100644 (file)
@@ -35,10 +35,8 @@ svgnames
 \include{parts/Editing}
 \include{parts/Rendering}
 \include{parts/Keyframes}
-%\settocdepth{subsection}
 \include{parts/FFmpeg}
 \include{parts/Plugins}
-%\settocdepth{section}
 \include{parts/Transition}
 \include{parts/Overlays}
 \include{parts/Recording}
diff --git a/images/autocolor-assets.png b/images/autocolor-assets.png
deleted file mode 100644 (file)
index 5f2f666..0000000
Binary files a/images/autocolor-assets.png and /dev/null differ
index d29e5c7f7432afcff367b4a84508b6d7686c98d0..dd5c14d70186633c55cdecfcf7ca595d26aa4abc 100644 (file)
Binary files a/images/autocolor-assets_alpha0.png and b/images/autocolor-assets_alpha0.png differ
index 206826b580e2d138f5b5ca280979ab92724ecf82..6fd6d9c70a09c9c5a1572bf170ae3b39ddb03945 100644 (file)
Binary files a/images/autocolor-assets_alpha1.png and b/images/autocolor-assets_alpha1.png differ
index 9ac1b639971ec4cc4bf8fd14a5153bbec835606f..5dd69422cd2cb0a6b32521acdda6b4e8575d37f1 100644 (file)
Binary files a/images/window_layout2.png and b/images/window_layout2.png differ
index 3a8d918587ebb3b0f4af29ca8fdc7fe21c43ad00..930e25f0ca40f52c25c1d69a6dc119c1617c4ca7 100644 (file)
 
 \nomenclature{\textbf{I-beam mode}}{formally known as Cut and Paste editing mode where a lot of the operations performed on your video are with various copy commands.  See Cut and Paste editing definition.}
 
-\nomenclature{\textbf{Index file}}{an .idx, .mkr or .toc file built by Cinelerra in the .bcast5 directory of your home folder in order to quickly, and with less cpu involved, seek into big media files, for skipping, faster playback and drawing waveforms and picons. Index files are not human readable.  If an index file for an asset is already built, it is not recreated – this saves a lot of time. However if you switch from a native format to using ffmpeg, or vice versa, you should always rebuild the index. The number of index files to keep can be set by the user and you can easily delete all of them at once from the SettingsPreferences, Interface menu.}
+\nomenclature{\textbf{Index file}}{an .idx, .mkr or .toc file built by Cinelerra in the .bcast5 directory of your home folder in order to quickly, and with less cpu involved, seek into big media files, for skipping, faster playback and drawing waveforms and picons. Index files are not human readable.  If an index file for an asset is already built, it is not recreated – this saves a lot of time. However if you switch from a native format to using ffmpeg, or vice versa, you should always rebuild the index. The number of index files to keep can be set by the user and you can easily delete all of them at once from the Settings$\rightarrow$Preferences, Interface menu.}
 
 \nomenclature{\textbf{Insertion point}}{a flashing hairline mark that vertically spans the timeline. It marks the starting place of the next operation to be performed.}
 
index 6c9492e2cfa02793e14e65f3c5eaf827a3a1387a..f80ceb31d6e9eea3758d05bd715df43d3e147a3f 100644 (file)
@@ -372,9 +372,27 @@ but it will not affect anything unless you have Cuda installed on your system an
        \item Also, install the Fusion repo, although it is unknown if necessary or not.
 \end{enumerate}
 
-There is a very good set of directions on the website to just follow.  Once you have installed the Cuda software on your computer, you must build Cinelerra yourself -- the default build in the configure script for cuda is \textit{auto}.  For Arch, be sure to first key in:     \texttt{setenv CUDA\_PATH=/opt/cuda} 
+There is a very good set of directions on the website to just follow.  Once you have installed the Cuda software on your computer, you must build Cinelerra yourself -- 
+the default flag for a build in the configure script for cuda is \textit{auto}.  For Arch, and possibly
+other distros, you may have to supply the CUDA\_PATH if it is not in the standard place.  This would be
+something like:
 
-There are currently 4 available plugins for \textit{show and tell} that take advantage of the hardware acceleration of Cuda -- \textit{N\_Body} and \textit{Mandelbrot} as shown next (figure~\ref{fig:cuda-effects}), \textit{F\_scale\_cuda} and \textit{F\_yadiff\_cuda}.
+
+\begin{lstlisting}[numbers=none]
+       env CUDA_PATH=/opt/cuda
+OR if using the bash shell: 
+       export CUDA_PATH=/opt/cuda
+\end{lstlisting}
+For all distros you will need to add to the ./configure line in your build script, the following:
+
+
+\begin{lstlisting}[numbers=none]
+       --with-cuda
+so your configure line will look something like this:
+       ./configure --with-single-user --with-booby --with-cuda
+\end{lstlisting}
+
+There are currently 4 available plugins for \textit{show and tell} that take advantage of the hardware acceleration of Cuda -- \textit{N\_Body} and \textit{Mandelbrot} as shown next (figure~\ref{fig:cuda-effects}), \textit{F\_scale\_cuda} and \textit{F\_yadif\_cuda}.
 
 \begin{figure}[htpb]
        \centering
index 4aa6e616ce70fe50e5f4b928fbca6f1d154448e7..1038b476f06b5243b64d433c699884455944c2d7 100644 (file)
@@ -240,11 +240,13 @@ If you set the insertion point in another place when In/Out points are already s
 repositioned when you click the In/Out icon or keyboard equivalent. 
 If you click on In/Out points while a region is highlighted, the insertion point will be ignored and In/Out points will be set at the beginning and at the end of the highlighted area.
 
-When you select either the In or Out point on the timebar, the insertion point will move to that location. 
-If the In point is set, when you click the In point icon the In point will be deleted. 
-If the Out point is set, when you click the Out point icon the Out point will be deleted. 
+When you select either the In or Out point on the timebar, the insertion point will move to that location.Note that when the insertion point is at the exact position of an In or Out point, the bracket will change
+color making it easy to see that you are exactly at that spot.
+If only the In point is set, when you click the In point icon the In point will be deleted. 
+If only the Out point is set, when you click the Out point icon the Out point will be deleted. 
 Holding the Shift key while clicking on an In/Out point, the area between the insertion point and that
-In/Out point will be highlighted; or extended to that In/Out point if already highlighted. 
+In/Out point will be highlighted or extended to that In/Out point if already highlighted. 
 
 An easy way to turn off the In/Out points if both are set, is to double click on the [ icon. 
 If you have already set the In and Out points, and then move the insertion point anywhere to the left of
@@ -271,17 +273,20 @@ Some of the useful operations concerning the In/Out pointers are listed next.
 Labels are used in order to set exact locations on the timeline that you want to be able to easily get to. 
 To create a label, position the insertion point at a location and click on the label icon in the Transport
 and Buttons bar. The new label is displayed on the timebar as a down arrow at that location as shown in
-figure~\ref{fig:i-beam}.
+figure~\ref{fig:i-beam}.  Whenever the insertion point is at the same position as a label, it changes
+color to emphasize that it is exactly at that spot.
 Labels make it so you can jump back and forth to exact marked locations on the timeline.
 Use the lower case letter “\texttt{L}” as a shortcut for the label button.
 
 You can use labels to reposition the insertion point when that label is selected. They are also
 especially useful for moving along the timeline to the \textit{Next label} or \textit{Previous label}
 with the buttons on the Transport and Buttons bar to the right of the Labels button.  
-When moving along the timeline with the Next or Previous label buttons, if a label is out of view
-the timeline will automatically be repositioned so that the label is visible. If you do either a Next
-label or Previous label and there are no more, the insertion point will go to either the Home or End
-position.  Keyboard shortcuts for label traversal are:
+When moving along the timeline with the Next or Previous label buttons, if a label is out 
+out of view the timeline will automatically be repositioned so that the label is visible.
+If you perform a \textit{Next label} operation and there are no more, the insertion point
+will go to the End position.  Conversely if you perform a \textit{Previous label} operation
+and there are no more labels, the insertion point will go to the Home position. 
+Keyboard shortcuts for label traversal are:
 
 \begin{description}
     \item[Ctrl-left] moves the insertion point to the previous label.
@@ -308,7 +313,7 @@ With labels you can also select regions:
 \end{description}
 
 If you LMB click the label button when an area is highlighted, labels are created at each end of the
-highlighted area. But if either end already has a label, then the existing label is deleted. 
+highlighted area. 
 When a label is selected, if you click on the label icon, the label will be deleted. 
 To delete multiple labels, highlight that area, then use the \texttt{Edit $\rightarrow$ Clear labels}
 function to delete them all. The same precedence rules apply to this operation as mentioned earlier.  That
@@ -331,45 +336,36 @@ In order to visually aid in locating clips on the timeline that are from the sam
 Use of this feature requires additional memory and cpu on every timeline redraw, therefore it is recommended that smaller computers leave it turned off.
 
 For auto-color the color will be based on a hashed filename so that whenever you load this particular media, it will always have the same color on the title bar even if you use proxy.  
-To enable auto-color (figure~\ref{fig:autocolor_assets}, go to \texttt{Settings $\rightarrow$ Preferences, Appearance tab} and check on \texttt{Autocolor assets}.  
-It is disabled by default.  
+To enable auto-color go to \texttt{Settings $\rightarrow$ Preferences, Appearance tab} and check on \texttt{Autocolor assets}. You will see this in the Flags section
+as shown in Figure~\ref{fig:settings}.  It is disabled by default.  
 Each media will have a random muted color and there could easily be close duplicates as generated by the program algorithm.  There will be no total black, but some dark shades are possible.  
 
-Screencast shows the red colored checkmark to enable Autocolor assets.  
-In the lower left corner is Highlighting Inversion color which can also be set and is discussed elsewhere.
-
-\begin{figure}[htpb]
-    \centering
-    \includegraphics[width=0.8\linewidth]{images/autocolor-assets.png}
-    \caption{Autocolor assets}
-    \label{fig:autocolor_assets}
-\end{figure}
-
 To change a specific clip to your own chosen color, middle mouse button (MMB) over that clip and an Edits popup will be displayed.  
 Choose the option \textit{Bar Color} to bring up the color picker and choose a color.   
-You can also change the alpha value in the color picker and this alpha takes precedence over the current alpha slider bar value unless it was set to 1.0.   
+You can also change the alpha value in the color picker and this alpha takes precedence over the current alpha slider bar value unless the color picker's alpha value is set to 1.0.   
 The color will only change after you click on the checkmark.  
 The \emph{Bar Color} option works in either Drag and Drop or Cut and Paste editing mode and also works if \textit{Autocolor assets} is not set.  
 In Drag and Drop editing mode, if you select several clips and then bring up the Edits popup with the middle mouse button over a track, you can use the \emph{Bar Color} option to change all of those selected to the same color.
 
 To go back to the default colors, uncheck \textit{Autocolor assets} in Preferences, but this does not affect the specially chosen self-colored ones as they are preserved.  
-To change these individually or  selectively use the Edits popup \emph{Bar Color} option and click on \textit{Default} in the color picker window.  Auto-color does not honor armed/disarmed tracks.  
+To change these individually or  selectively, use the Edits popup \emph{Bar Color} option and click on \textit{Default} in the color picker window.  Auto-color does not honor armed/disarmed tracks.  
 Self-color does honor armed/disarmed tracks.
 
 And that’s not all!  
-There is an \emph{alpha fader slider bar} on the bottom of the main window on the right hand side of what is referred to as the Zoom Panel.  
-With this alpha slider, you can colorize your video and audio tracks to either see only the color at 0.0 or see only the image/audio waveform at 1.0.  
+There is an \emph{alpha fader slider bar} on the bottom of the main window on the right hand side of the Zoom Panel.  
+With this alpha slider, you can colorize your video and audio tracks to either see only the color at 0.0 or see only the image at 1.0.  
 This slider bar affects all colored areas of the Autocolor assets and the self-colored ones.  
-In the case when a specifically changed edit alpha value is any value except 1, the slider bar will not affect that.  
+In the case when a specifically changed edit alpha value is set in the color picker
+to any value except 1, the slider bar will not affect that.  
 Once you use the slider bar, it is activated so gets first shot at any keystrokes in the main window.  
 You deactivate this by simply clicking in a different part of the main window.  
 
-As long as we are on the subject of color, just a reminder that you can also change the \textit{Highlighting Inversion color} in \texttt{Settings $\rightarrow$ Preferences, Appearance tab}.  
-This is on right left hand side of the menu more than half the way down and you can see this in the figure~\ref{fig:autocolor_assets}.  
+As long as we are on the subject of color, just a note that you can also change the \textit{Highlighting Inversion color} in \texttt{Settings $\rightarrow$ Preferences, Appearance tab}.  You can see this option in Figure~\ref{fig:settings} in the Color section.  
 That setting defaults to white ($ffffff$) but sometimes this is a little bright so you can put any hex value in that suits you.
 
-Screencast (figure~\ref{fig:autocolor_assets_alpha}a) which shows an example of the Autocolor assets with alpha set to 0.0.
-In this screencast (figure~\ref{fig:autocolor_assets_alpha}b), the alpha is set to show the image as well as the colors.  The pink media file has been self-colored rather than the autocolor to make it easy to see.
+This image (figure~\ref{fig:autocolor_assets_alpha}a) shows an example of the Autocolor assets with alpha set to 0.0 so that you see only the color and no image.
+In this image (figure~\ref{fig:autocolor_assets_alpha}b), the alpha is set to show the image
+and waveforms with transluent colors.  The pink media file has been self-colored rather than the autocolor to make it easy to see.
 
 \begin{figure}[htpb]
     \centering
@@ -396,8 +392,8 @@ The main window pulldowns as pointed out in figure~\ref{fig:insertion-points} ar
     \item[File]  options for loading, saving, and rendering as described in other sections (\ref{cha:load_save_and_the_EDL}).
     \item[Edit]  edit functions; most of which have shortcuts that you will quickly learn (\ref{cha:editing}).
     \item[Keyframes]  keyframe options which are described in the Keyframe section (\ref{cha:keyframes}).
-    \item[Audio]  audio related functions such as \textit{Add track}, \textit{Attach transition/effect}.
-    \item[Video]  video functions such as \textit{Default/Attach transition}.
+    \item[Audio]  audio functions such as \textit{Add track}, \textit{Attach transition/effect}.
+    \item[Video]  video functions such as \textit{Add track, Default/Attach transition, Render effect}.
     \item[Tracks]  move or delete tracks are the most often used.
     \item[Settings]  much of this is described elsewhere with the most frequently used to include
 Preferences (\ref{cha:configuration_settings_preferences}), Format (\ref{cha:project_and_media_attributes}), 
@@ -410,13 +406,14 @@ Proxy and Transcode (\ref{sec:proxy_settings}), as well as the others.
 \subsection{Window Layouts}%
 \label{sub:window_layouts}
 
-If you like to use different window layouts than the default for certain scenarios, you can setup, save, and load 4 options.   
-First position your Cinelerra windows where you want them to be and then use the Window pulldown and choose \emph{Save layout}.  
+If you like to use different window layouts than the default for certain scenarios, you can setup, save, and load 4 variations.   
+First, position your Cinelerra windows where you want them to be and then use the Window pulldown and choose \emph{Save layout}. Note the words \emph{Save layout} highlighted in Figure~\ref{fig:window_layouts}a with 4 names shown to the right and below of that highlight. 
 To use the default name of \textit{Layout \#}, when the popup comes up, just click the green checkmark OK on the Layout popup menu.  
-If you would like a specific name for your layout so you can remember what it is for, keyin 1-8 english characters that are meaningful to you (english characters mean you can not use the German umlaut or the French accent).  
+If you would like a specific name for your layout so you can remember what its best use case is,
+keyin 1-8 english characters that are meaningful to you (english characters mean you can not use the German umlaut or the French accent).  
 Legal characters are a-z, A-Z, 0-9, \_ (the underscore character) and a limit of 8 total.  
 If you keyin more than 8, only the last 8 characters will be used.  
-To rename a currently existing layout, use the Save layout option again on the one to rename, and keyin a different name into the text box or blank for the default name (figure~\ref{fig:window_layouts}).
+To rename a currently existing layout, use the \emph{Save layout} option again on the one to rename, and keyin a different name into the text box or leave blank for the default name (figure~\ref{fig:window_layouts}b).
 
 \begin{figure}[htpb]
     \centering
@@ -435,14 +432,16 @@ To rename a currently existing layout, use the Save layout option again on the o
 
 The files containing the coordinates for your layouts will automatically be saved in the \texttt{\$HOME/.bcast5} directory as \texttt{layout\#\_rc} or \texttt{layout\#\_8chars\_rc}.
 
-To use the desired layout, keyin the shortcut or use the Window pulldown and choose \emph{Load layout} and then make your choice. 
+To use the desired layout, keyin the shortcut or use the Window pulldown and choose \emph{Load layout} and then make your choice. It is very beneficial to learn the shortcuts for your
+layouts because they can be executed from any of the 4 windows instead of just the main
+timeline window.
 
 \subsection{Just Playing!}%
 \label{sub:just_playing_}
 What if you are just using Cinelerra to play media and listen to tunes? 
 After loading your media, just hit the space bar to start playing and then again to stop playing.  
 Other than that, use the transport buttons on the top bar of the Program window.  
-Other ways, not previously mentioned to \textit{play around} are described next. 
+Other ways to \textit{play around} are described next. 
 
 \subsubsection*{Repeat Play / Looping Method}%
 \label{ssub:repeat_play_looping_method}
@@ -502,7 +501,8 @@ Now you can clip/play/expand or edit the previous playback selection.
 
 
 The speed automation causes the playback sampling rate to increase or decrease to a period controlled by the speed automation curve.  
-This can make playback speed-up or slow-down according to the scaled sampling rate, as \textit{time is multiplied by speed} (Speed $\times$ Unit\_rate).
+This can make playback speed-up or slow-down according to the scaled sampling rate, as \textit{time is multiplied by speed} (Speed $\times$ Unit\_rate). For more information on changing
+the speed, read the section on Speed Automation \ref{sec:speed_fade_automation_gang}.
 
 \subsubsection*{Alternative to using Numeric Keypad for Playing}%
 \label{ssub:alternative_to_using_numeric_keypad_for_playing}