minor corrections

diff --git a/parts/Configuration.tex b/parts/Configuration.tex
index 1c35b2fd54698689920ad95029d6f73345a75b38..f92c6c22575adefaf54ff0a0b8cf61a91e53175a 100644 (file)
--- a/parts/Configuration.tex
+++ b/parts/Configuration.tex
@@ -168,14 +168,15 @@ The parameters here expedite the \texttt{File $\rightarrow$ Record}\dots functio
 \subsection{Performance section}%
 \label{sub:performance_section}
 
 \subsection{Performance section}%
 \label{sub:performance_section}
 

-The main focus of the performance section is rendering parameters not available in the rendering dialog with the obvious gain of perhaps better performance.
+The main focus of the performance section is rendering parameters not available in the rendering dialog with the obvious gain of perhaps better performance. For more details about using GPU hardware acceleration for both decoding and encoding see \nameref{sec:hardware_video_acceleration}.

 
 \begin{description}
 
 \begin{description}

-    \item[Cache size] \index{cache size} to speed up rendering, several assets are kept open simultaneously. This determines how     many are kept open. A number too large may exhaust your memory rapidly. A number too small may result in slow playback as assets need to be reopened more frequently.
+    \item[Cache size] \index{cache size} to speed up rendering, several assets are kept open simultaneously. This determines how many are kept open. A number too large may exhaust your memory rapidly. A number too small may result in slow playback as assets need to be reopened more frequently.
+    \item[Cache Transition] transitions can be slow on timeline playback. With this parameter (active by default) a cache is used to smooth the transition. You might see a slight hesitation at the beginning of a transition when memory is being loaded then quite often it will play at full speed.

     \item[Seconds to preroll renders] \index{pre-roll} some effects need a certain amount of time to settle in. Checking this option sets a number of seconds to render without writing to disk before the selected region is rendered. When using the render farm, you will sometimes need to preroll to get seamless transitions between the     jobs. Every job in a render farm is prerolled by this value. This does not affect background rendering because background rendering uses a different preroll value.
     \item[Force single processor use] \index{force single processor} \CGG{} tries to use all processors on the system by default, but sometimes you will only want to use one processor, like in a render farm client. This forces only one processor to be used.  The operating system usually uses the second processor for disk access. The value of this parameter is used in render farm clients.
     \item[Seconds to preroll renders] \index{pre-roll} some effects need a certain amount of time to settle in. Checking this option sets a number of seconds to render without writing to disk before the selected region is rendered. When using the render farm, you will sometimes need to preroll to get seamless transitions between the     jobs. Every job in a render farm is prerolled by this value. This does not affect background rendering because background rendering uses a different preroll value.
     \item[Force single processor use] \index{force single processor} \CGG{} tries to use all processors on the system by default, but sometimes you will only want to use one processor, like in a render farm client. This forces only one processor to be used.  The operating system usually uses the second processor for disk access. The value of this parameter is used in render farm clients.

-    \item[Project SMP cpus ] \index{entry}SMP cpus to restrict the number of processors utilized, change the count number.  This number will be used for the plugin per load balance operation cpu limit, which uses smp-cpus to stripe your data. It does not affect the number of cpus used in any other \CGG{} operation besides plugins. On large cpu systems, it can come in handy to downgrade the number of cpus used for some plugins; otherwise it uses all of the processors and splits up the program into too many pieces which may add
-    considerable overhead in high cpu count systems.
+    \item[Project SMP cpus] \index{SMP cpus} to restrict the number of processors utilized, change the count number.  This number will be used for the plugin per load balance operation cpu limit, which uses smp-cpus to stripe your data. It does not affect the number of cpus used in any other \CGG{} operation besides plugins. On large cpu systems, it can come in handy to downgrade the number of cpus used for some plugins; otherwise it uses all of the processors and splits up the program into too many pieces which may add considerable overhead in high cpu count systems.
+    \item[Use HW Device] \index{HW Device} \CGG{} can use hardware timeline acceleration (decoding) via GPUs thanks to the \textit{OpenGL} video driver. By default the \textit{X11} video driver is used, which works only with the CPU. See \nameref{sub:video_out_section}. For h264, h265 (HEVC) and VP9 codecs you can use libraries specific to AMD, Nvidia and Intel graphics cards. For AMD and Intel set \textbf{vaapi}; for Nvidia set \textbf{vdpau} (also works with AMD thanks to a wrapper). \textbf{Cuda} does not accelerate decoding with Nvidia, but it does allow some plugins to run that are not available otherwise. \textbf{None} (default) uses the video driver set in the \texttt{Playback A/B} tab.

 \end{description}
 
 \subsection{Background Rendering section}%
 \end{description}
 
 \subsection{Background Rendering section}%

diff --git a/parts/Shortcuts.tex b/parts/Shortcuts.tex
index 8a1d7532a9d73796000d997ed65c8e01b9efa495..2f6a0c29b3f2b89bd4182453bb1536ff2c68dc34 100644 (file)
--- a/parts/Shortcuts.tex
+++ b/parts/Shortcuts.tex
@@ -59,7 +59,6 @@ The Main window (also called the program window) consists of pulldown menus, but
   & Scan\dots & Ctrl-Alt-s & Open dvb scan window. \\
   & SubTitle\dots & Alt-y & Open subtitle script window. \\
   & Render\dots & Shift-R & Open render window. \\
   & Scan\dots & Ctrl-Alt-s & Open dvb scan window. \\
   & SubTitle\dots & Alt-y & Open subtitle script window. \\
   & Render\dots & Shift-R & Open render window. \\

-  & Export EDL\dots & Shift-E & Open export EDL window. \\

   & Batch Render\dots & Shift-B & Open batch render window. \\
   & BD Render\dots & Ctrl-Shift-D & Open create bluray disk window. \\
   & DVD Render\dots & Alt-D & Open create dvd disk window. \\
   & Batch Render\dots & Shift-B & Open batch render window. \\
   & BD Render\dots & Ctrl-Shift-D & Open create bluray disk window. \\
   & DVD Render\dots & Alt-D & Open create dvd disk window. \\

diff --git a/parts/Trouble.tex b/parts/Trouble.tex
index 2f14a5d24f47de4e5b174222947bcdcf165060f6..59dc614bb294757efcebe34fbbcd297442d0dbbc 100644 (file)
--- a/parts/Trouble.tex
+++ b/parts/Trouble.tex
@@ -293,6 +293,35 @@ You can usually install the required library to fix the problem. A temporary fix
 
 This usually indicates that you are out of Operating System file descriptors.  You can increase the amount easily with the following command line:  \texttt{ulimit -n 4096}   where 4096 is a size suggestion but can be increased.  You can include this command line in your \texttt{.bashrc} or \texttt{.profile} file for the user login which gets run every time you login, or modify the Operating System limit for everyone in the system file, which for Fedora is \texttt{/etc/security/limits.conf}.  Alternatively, you can reduce the number of file descriptors needed by going into \texttt{Settings $\rightarrow$ Preferences, Appearance} tab and unchecking the flag \textit{use thumbnails in resource window}.
 
 
 This usually indicates that you are out of Operating System file descriptors.  You can increase the amount easily with the following command line:  \texttt{ulimit -n 4096}   where 4096 is a size suggestion but can be increased.  You can include this command line in your \texttt{.bashrc} or \texttt{.profile} file for the user login which gets run every time you login, or modify the Operating System limit for everyone in the system file, which for Fedora is \texttt{/etc/security/limits.conf}.  Alternatively, you can reduce the number of file descriptors needed by going into \texttt{Settings $\rightarrow$ Preferences, Appearance} tab and unchecking the flag \textit{use thumbnails in resource window}.
 

+\bigskip
+
+\textit{Using a non-supported locale could cause a failure in starting \CGG{} with the following error.}
+
+\begin{lstlisting}[numbers=none,xleftmargin=10mm]
+
+   BC_WindowBase::init_im: Could not open input method.
+   unjoined tids / owner 1
+     00007f543dffb700 / 00007f54989d5840 12BC_Clipboard
+
+\end{lstlisting}
+
+This is caused by LC\_CTYPE setting you are using, and maybe other Locale settings too. 
+For example, using the following will cause the \textit{unjoined tids} error.
+
+\begin{lstlisting}[numbers=none,xleftmargin=10mm]
+   LC_CTYPE="en_IL" /mnt0/build5/cinelerra-5.1/bin/cin # set LC_CTYPE and start cin 
+\end{lstlisting}
+
+This is an operating system error which is resolved by using the following startup instead:
+
+\begin{lstlisting}[numbers=none,xleftmargin=10mm]
+
+   LC_CTYPE="en_GB.utf8" /mnt0/build5/cinelerra-5.1/bin/cin # set LC_CTYPE and start cin 
+\end{lstlisting}
+
+You can either export the LC\_CTYPE variable before starting \CGG{} or
+add this in your bash startup file or simply run from the command line as shown above.
+

 \bigskip
 \textit{Masking Feather is not working and produces error messages on the startup window similar to:}
 
 \bigskip
 \textit{Masking Feather is not working and produces error messages on the startup window similar to:}