\vspace{2ex}
\begin{tabular}{lll}
+ \hline
Path: & output media file path & \\
Start time: & weekday/time of day & to begin capture\\
\multirow{2}*{Mode:} & timed & use start time/duration \\
- & untimed & use transport controls\\
+ & untimed & use transport controls\\
+ \hline
\end{tabular}
\vspace{2ex}
\label{sec:record_web_media_rt}
\index{recording!web media in real time}
-Below describes the necessary steps for recording freely available media from the internet for your own personal use. You have to be on a system using pulseaudio, such as ubuntu, fedora, centos.
+Below describes the necessary steps for recording freely available media from the internet for your own personal use. You have to be on a system using pulseaudio, such as ubuntu, fedora, or centos.
\begin{enumerate}
\item Start \CGG{} and select \texttt{Settings $\rightarrow$ Preferences $\rightarrow$ Recording} From a terminal (with a wide text window) run: \texttt{pactl list}. You will see all of the audio sources and sinks on your system. Identify the source associated with the normal output your system uses. Example: \textit{Source $\#1$}. Locate the source which monitors your normal audio output. For example: \textit{front stereo}.
\paragraph{Transport controls} these control buttons mimic the functions of tape recorders from the old days.
\begin{itemize}
- \item \textit{Reverse button/left arrow} --remnant from the past; does the same as the Start button really.
- \item \textit{Red round button} --this is the Start button to start recording.
- \item \textit{White square} --this is the Stop button to stop recording.
- \item \textit{Red round button with white line} --start recording in single frame mode. The way this works is to just \textit{take a picture now, take a picture now\dots} The reason to use this mode is to get a still shot like you would with a camera. Sometimes input is continuous, for example looking at stars with a telescope -- surveillance goes on for hours, but you just want to take a picture now when something of significance interest comes up
+ \item \textit{Reverse button/left arrow} -- remnant from the past; does the same as the Start button really.
+ \item \textit{Red round button} -- this is the Start button to start recording.
+ \item \textit{White square} -- this is the Stop button to stop recording.
+ \item \textit{Red round button with white line} -- start recording in single frame mode. The way this works is to just \textit{take a picture now, take a picture now\dots} The reason to use this mode is to get a still shot like you would with a camera. Sometimes input is continuous, for example looking at stars with a telescope -- surveillance goes on for hours, but you just want to take a picture now when something of significance interest comes up
\end{itemize}
\paragraph{Cron} The batch recording watcher, cron, is either \textit{Idle} or \textit{Active}. When you start or stop batch recording at specific times, there is a cron thread watching timers to perform the timed action. Idle/Active indicates whether the timers are running.
\paragraph{Position} this is a timebase which tracks frames/samples when obeying frame/sample rate. When a recording starts, it resets to 0. Timing is against audio (when available). Audio time and video time are based on position.
\noindent Possible choices for time base are:
\begin{itemize}
- \item \textit{Presentation Timestamps} --use time code which is in both the audio and video media input stream. Uses these timestamps to sync the 2 streams.
- \item \textit{Device Position} --this is the device hardware position of where you are. It is usually only on the audio side.
- \item \textit{Sample Position} --Sample $\#$ or frame $\#$ divided by frame rate tells you where you are.
- \item \textit{Software Timing} --usually used for things like YouTube; it just will \textit{take a picture now} \dots \textit{take a picture now} \dots over and over again until you tell it to stop.
+ \item \textit{Presentation Timestamps} -- use time code which is in both the audio and video media input stream. Uses these timestamps to sync the 2 streams.
+ \item \textit{Device Position} -- this is the device hardware position of where you are. It is usually only on the audio side.
+ \item \textit{Sample Position} -- Sample $\#$ or frame $\#$ divided by frame rate tells you where you are.
+ \item \textit{Software Timing} -- usually used for things like YouTube; it just will \textit{take a picture now} \dots \textit{take a picture now} \dots over and over again until you tell it to stop.
\end{itemize}
Positioning \& Timing needs more detailed explanation for complete understanding and application. The overall goal is to maintain media stream timeline synchronization. The reason for providing different \textit{Positioning} options is that different input media may have different timebase standards. Additionally, the input may be damaged. Damaged data can skew the timeline during presentation. The timebase standards make it possible to correctly resynchronize the media presentation to the original time position. For example, the transport layer may have timestamps provided in it. These timestamps record \textit{audio time} and \textit{video time} and are called \textit{presentation timestamps}.
\label{fig:recording02}
\end{figure}
+Some notes for usage on slower CPUs are outlined at appendix \nameref{sec:using_screencapture}
+as discovered in actual usage.
+
\section{Digital Video Broadcasting (DVB)}%
\label{sec:digital_video_broadcasting}
\index{capture!digital broadcasting}
The main menu pulldown, \texttt{Settings $\rightarrow$ Preferences $\rightarrow$ Playback A} and \texttt{B} Tabs, must be properly configured in order to take advantage of the Dual Screen Mode capability.
-In the main menu \textit{Window} pulldown there are \textit{Tile left} and \textit{Tile right} options for the 2 monitors. If you have only 1 monitor, you will see no change upon activating these options. Tiling is possible due to the existence of one long horizontal screen display buffer. Tile left takes \CGG{} and moves all of its windows to the $2^{nd}$ monitor/TV and Tile right puts it back to the $1^{st}$ monitor. The left and right monitors are the left part or right part of a Playback A/B Xwindow host referenced in the Video Config Playback A/B for separate X screens. Shortcuts for Tile left and Tile rights are the letters \texttt{a} and \texttt{b} on the keyboard once you have set \textit{Remote Control mode}. Below is a summary of the configuration letters:
+In the main menu \textit{Window} pulldown there are \textit{Tile left} and \textit{Tile right} options for the 2 monitors. If you have only 1 monitor, you will see no change upon activating these options. Tiling is possible due to the existence of one long horizontal screen display buffer. Tile left takes \CGG{} and moves all of its windows to the $2^{nd}$ monitor/TV and Tile right puts it back to the $1^{st}$ monitor. The left and right monitors are the left part or right part of a Playback A/B Xwindow host referenced in the Video Config Playback A/B for separate X screens. Shortcuts for Tile left and Tile rights are the letters \texttt{a} and \texttt{b} on the keyboard once you have set \textit{Remote Control mode}. Below is a summary of the configuration letters (only when in Remote Control mode):
\begin{description}
\item[a] select \textit{playback a} and tile windows left (all on monitor or laptop)
\item[c] select \textit{playback c} and tile windows left, but composer right (TV mode) This option has the effect of taking the Compositor window and moving it to the $2^{nd}$ monitor/TV without the surrounding borders interfering with the video.
\end{description}
-Since Dual Screen Mode is most widely used for either a demonstration or watching TV, you will want to take advantage of Remote Control mode as described in a following section. In the camera shots below, note the square red box that shows up in the upper left hand corner of the Viewer window (arrow pointing to it but it looks more orange than red) which denotes that the Application/Menu key was used to get into Remote Control mode.
+Since Dual Screen Mode is most widely used for either a demonstration or watching TV, you will want to take advantage of Remote Control mode as described in a following section. In the camera shots below, note the square red box that shows up in the upper left hand corner above the Viewer window, when visible, which denotes that the Application/Menu key was used to get into Remote Control mode.
-Figure~\ref{fig:two-monitors01} shows 2 monitors (could just as well be a big-screen TV for the second monitor) with Tile left where all of the \CGG{} windows are on the left most monitor. The big red arrow points to the little red square box indicating that Remote Control mode is in effect.
+Figure~\ref{fig:two-monitors01} shows 2 monitors (could just as well be a big screen TV for the second monitor) with Tile left where all of the \CGG{} windows are on the left most monitor. Note the little red square box in the far upper left corner indicating that Remote Control mode is in effect.
\begin{figure}[htpb]
\centering
\includegraphics[width=0.85\linewidth]{two-monitors01.png}
- \caption{Dual screen - initial}
+ \caption{Dual screen - initial view on the left monitor and showing part of the right monitor with 2 terminal windows}
\label{fig:two-monitors01}
\end{figure}
-Figure~\ref{fig:two-monitors02} shows 2 monitors with Tile right (b key) where all of the \CGG{} windows are on the right monitor. The left monitor shows the Suse distro logo and a couple of xterm type windows.
+Figure~\ref{fig:two-monitors02} shows 2 monitors with Tile right (b key) where all of the \CGG{} windows are on the right monitor. The partial view of the left monitor shows 2 xterm windows with landscape wallpaper background.
\begin{figure}[htpb]
\centering
\begin{figure}[htpb]
\centering
\includegraphics[width=0.85\linewidth]{two-monitors03.png}
- \caption{Dual screen - \CGG{} compositor on own screen windowed}
+ \caption{Dual screen - \CGG{} compositor on second monitor}
\label{fig:two-monitors03}
\end{figure}
-Figure~\ref{fig:two-monitors04} shows 2 monitors with Compositor window on the 2nd monitor in Fullscreen mode so that no \CGG{} borders are visible to distract from the picture. The big red arrow points to the little red square box indicating that Remote Control mode is in effect.
+Figure~\ref{fig:two-monitors04} shows 2 monitors with Compositor window on the 2nd monitor in Fullscreen mode so that no \CGG{} borders are visible to distract from the picture.
\begin{figure}[htpb]
\centering
\includegraphics[width=0.85\linewidth]{two-monitors04.png}
- \caption{Dual screen - \CGG{} compositor on own screen full screen}
+ \caption{Dual screen - \CGG{} compositor on second monitor in full screen mode}
\label{fig:two-monitors04}
\end{figure}
\label{sub:remote_control_dvb}
\index{capture!remote control for DVB}
-\CGG{} DVB recording/playback can now easily be done in \textit{couch potato} mode using a remote control. This comes in handy when you want to playback on a big TV screen for multiple person viewing. You can use the Application/Menu key on the keyboard to toggle between standard \CGG{} usage or a Dispatcher methodology through use of a remote control, an Android programmed device such as a tablet, or keyboard. The Application/Menu key on most keyboards is between the Alt and Ctrl keys on the right hand side bottom and depicts a menu on it either with or without a pointer (see image below). An ati-x10 Remote Control device (figure~\ref{fig:remote01}) is currently working with \CGG{} and other remote controls may work but have never been tried. The red/orange box on the top left main screen of \CGG{} indicates Dispatcher Method access is activated which allows for keyboard grab which routes all key strokes until toggled off. Below are the currently defined operations.
+\CGG{} DVB recording/playback can now easily be done in \textit{couch potato} mode using a remote control. This comes in handy when you want to playback on a big TV screen for multiple person viewing. You can use the Application/Menu key on the keyboard to toggle between standard \CGG{} usage or a Dispatcher methodology through use of a remote control, an Android programmed device such as a tablet, or keyboard. The Application/Menu key on most keyboards is between the Alt and Ctrl keys on the right hand side bottom and depicts a menu on it either with or without a pointer (see image below). THe Menu key is keycode 135. An ati-x10 Remote Control device (figure~\ref{fig:remote01}) is currently working with \CGG{} and other remote controls may work but have never been tried. The red box on the top left main screen of \CGG{} indicates Dispatcher Method access is activated which allows for keyboard grab which routes all key strokes until toggled off. Below are the currently defined operations.
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.7\linewidth]{remote01.png}
+ \includegraphics[width=0.9\linewidth]{remote01.png}
\caption{Ati-x10 Remote}
\label{fig:remote01}
\end{figure}
Remote Control Keys (Application/Menu key toggle for ati-x10 remote)
% Should find something so that the last column width automatically adapts to margin/font/pagesize.
-\begin{tabular}{lc p{12cm}}
- \toprule
+\begin{tabular}{lcp{12cm}}
+ \hline
up arrow&=&forward 1 minute\\
down arrow&=&forward single frame\\
book key&=&toggles channel scan (always available)\\
hand key&=&terminates \CGG{} (always available)\\
- \bottomrule
+ \hline
\end{tabular}
\noindent Plus usual Transport keys:
\begin{tabular}{lcl}
- \toprule
+ \hline
e&=&??\\
f&=&toggle full screen\\
square&=&stop\\
2 lines&=&fast reverse\\
- \bottomrule
+ \hline
\end{tabular}
The Application/Menu key \quad
\item After you install the new phone/tablet app in step 1, start it up from your apps menu.
\end{enumerate}
-Before you can use it, the Android device must have the ip address of your computer entered into the configuration menu. The PC you are running \CGG{} on and the Android device have to be on the same network. You can tell it is in communication by tapping the \texttt{Power} (menu) button. When the remote is operated with the \textit{Power} (menu) button, there is a little orange box on the upper left corner of the display to indicate the remote state is active. If you do not see the little orange box when the menu key is tapped, the communication is broken and must be fixed before proceeding. Follow the directions in the paragraph below.
+Before you can use it, the Android device must have the ip address of your computer entered into the configuration menu. The PC you are running \CGG{} on and the Android device have to be on the same network. You can tell it is in communication by tapping the \texttt{Power} (menu) button. When the remote is operated with the \textit{Power} (menu) button, there is a little red box on the upper left corner of the display to indicate the remote state is active. If you do not see the little red box when the menu key is tapped, the communication is broken and must be fixed before proceeding. Follow the directions in the paragraph below.
BIG NOTICE: the firewalls in your computer and wifi router can stop this thing dead. Re-configuring a firewall is tricky and varies from distro to distro. If possible, during setup it is suggested that you disable the firewall temporarily. For those with advanced skills, use tcpdump or wireshark to look for udp messages from the IP address of the device.
[ 4007.420828] hid-generic 0003:534D:0021.0009: hiddev97,hidraw0: USB HID v1.10 Device [MACROSILICON AV TO USB2.0] on usb-0000:16:00.3-1.2/input4
\end{lstlisting}
-\newpage
-
\subsection{Use Case \#2 – Hauppauge WinTV-HVR}
\label{sub:use_case_wintv}
\index{capture!Hauppage WinTV}
projects / goodguy / cin-manual-latex.git / blobdiff