From: Good Guy <good1.2guy@gmail.com>
Date: Thu, 14 May 2020 01:05:18 +0000 (-0600)
Subject: add missing Viewer audio file usage
X-Git-Tag: 2021-05~82
X-Git-Url: https://git.cinelerra-gg.org/git/?p=goodguy%2Fcin-manual-latex.git;a=commitdiff_plain;h=1ff88405adc467cf5a30ca100f90219f9b28d8fe;ds=sidebyside

add missing Viewer audio file usage
---

diff --git a/images/viewer_audio.png b/images/viewer_audio.png
new file mode 100644
index 0000000..f0cb45f
Binary files /dev/null and b/images/viewer_audio.png differ
diff --git a/parts/Windows.tex b/parts/Windows.tex
index 8bd6808..baa495a 100644
--- a/parts/Windows.tex
+++ b/parts/Windows.tex
@@ -1215,6 +1215,26 @@ accidentally closed you can open it again by using the pulldown \texttt{Window $
 Viewer} to bring it back up.  More details for editing in the Viewer window with the Two Screen
 Editing method is explained in~\ref{sec:two_screen_editing}.
 
+
+\begin{figure}[htpb]
+    \centering
+    \includegraphics[width=1.0\linewidth]{viewer_audio.png}
+    \caption{Viewer window at the top displaying same 5 seconds as seen in the Resources window thumbnail. At the bottom of the screen is the audio loaded on the timeline.}
+    \label{fig:vieweraudio}
+\end{figure}
+
+You can also use the Viewer to listen to media that consists only of Audio.  This is a quick way
+to listen to the audio to see if it is what you would like to add to a timeline audio track for
+your project.  To do this, you simply drag the audio file from the Resources window in the same
+manner as a video file. The viewer was designed to "view" images rather than play audio so in order
+to make it obvious that audio media is loaded to the viewer, a waveform is displayed that is the
+same waveform as shown in the Resources window thumbnail when in the \textit{Display Icons} mode.
+This waveform only represents the first 5 seconds of the media and will not change or move while
+playing in the Viewer window.  But you can play the entire piece of media in the window
+and as you do so, you see the play cursor line move along and the timestamp reflect the actual
+position of the audio. The entire waveform can only be seen on an actual audio track on the
+timeline. An example of what this looks like is shown in figure~\ref{fig:vieweraudio}.
+
 \section{Options in both the Compositor and Viewer Windows}%
 \label{sec:options_in_both_the_compositor_and_viewer_windows}