Andreas's last index entries; some minor fixes from Phyllis; rename index.png to...
[goodguy/cin-manual-latex.git] / parts / Quickstart.tex
index 93f04f783a3d0b88dabdbc4f9a9395d7580490ef..e81a02c7f9439453139c5411b704a2f38fa273d9 100644 (file)
@@ -1,20 +1,24 @@
 \chapter{QuickStart}%
 \label{cha:Quickstart}
 
-\section{Cinelerra-GG Quick Start Guide}%
+\section{\CGG{} Quick Start Guide}%
 \label{sec:cin_quick_start_guide}
+\index{quickstart guide}
 
-Cinelerra is a software program NLE, Non-Linear Editor, that provides a way to edit, record, and play audio or video media on Linux.   It can also be used to color correction, retouch photos, motion tracking, watch TV, and create DVDs.
+\CGG{} is a software program NLE, Non-Linear Editor, that provides a way to edit, record, and play audio or video media on Linux.   It can also be used to color correction, retouch photos, motion tracking, watch TV, and create DVDs.
 
 \subsection{Install the Software}%
 \label{sub:install_software}
 
-On the internet, click on the Download page at:  \quad {\small \url{https://cinelerra-gg.org/downloads/}}
+On the internet, click on the Download page at:
+\begin{center}
+       {\small \url{https://cinelerra-gg.org/downloads/}}
+\end{center}
 Here you will see several Operating System distro packages that are already built for you to download.  Click on your preference and read the specific instructions for usage.
 
 \begin{figure}[htpb]
        \centering
-       \includegraphics[width=1.0\linewidth]{images/packages.png}              
+       \includegraphics[width=1.0\linewidth]{packages.png}             
 \end{figure}
 
 However, if you want to get going as quickly as possible, just do this so that everything is in 1 place:
@@ -27,7 +31,7 @@ However, if you want to get going as quickly as possible, just do this so that e
        \item Key in:  \texttt{tar -xJf /tmp/cinelerra-5.1-*.txz}   (if you put the tar in \texttt{/tmp} AND replace * with full name)
 \end{itemize}
 
-\subsection{Start Cinelerra GG}%
+\subsection{Start \CGG{}}%
 \label{sub:start_cinelerra_gg}
 
 Depending on how you installed the software, you can log in as root or as a user if you used a package.
@@ -37,17 +41,17 @@ Depending on how you installed the software, you can log in as root or as a user
        \item Or if you installed using the pkg method, click on the \textit{Cin icon}.
 \end{itemize}
 
-You will now see 4 separate windows appear.  The top 2 windows from left to right are the Viewer which is most useful for previewing clips and media and the Compositor which displays the current working frame at the timeline position.  The bottom 2 windows are the Cinelerra Program, also called the timeline, which is where the real work gets done and the Resources window showing a selection of media or effects.
+You will now see 4 separate windows appear.  The top 2 windows from left to right are the Viewer which is most useful for previewing clips and media and the Compositor which displays the current working frame at the timeline position.  The bottom 2 windows are the \CGG{} Program, also called the timeline, which is where the real work gets done and the Resources window showing a selection of media or effects.
 
 \begin{figure}[htpb]
        \centering
-       \includegraphics[width=1.0\linewidth]{images/4windows.png}
+       \includegraphics[width=1.0\linewidth]{4windows.png}
        \caption{Clockwise: Viewer; Compositor; Resources and Main/Program/Timeline}    
 \end{figure}
 
 Any of these windows can be resized to better suit your needs.  Note that if your system’s native language is not English, some of the words you see on the screen will be correctly translated for you, others will be in english, and some will have not very good translations.
 
-It is important to know that Cinelerra does not directly change your media.  It writes all changes to what is called the EDL, Edit Decision List.  This way you original media remains completely intact.
+It is important to know that \CGG{} does not directly change your media.  It writes all changes to what is called the EDL, Edit Decision List.  This way you original media remains completely intact.
 
 \subsection{Load Media}%
 \label{sub:load_media}
@@ -56,25 +60,25 @@ On the main timeline program window are many pulldowns, the first of which is \t
 
 \begin{figure}[htpb]
        \centering
-       \includegraphics[width=1.0\linewidth]{images/load_files.png}
+       \includegraphics[width=1.0\linewidth]{load_files.png}
        \caption{Load media window -- note the icons top right for more options}        
 \end{figure}
 
 \begin{enumerate}
-       \item Click on \texttt{File} for a list of available options and note that in the right hand column are shortcuts for
-       many of the options that will come in handy if you use Cinelerra often.
-       \item Next click on the second one down -- \texttt{Load files$\dots$} -- which brings up the Load menu.
-       \item Below \texttt{Select files to load} on the top left side is a textbox and if you look all the way to the right
+       \item Click on \textit{File} for a list of available options and note that in the right hand column are shortcuts for
+       many of the options that will come in handy if you use \CGG{} often.
+       \item Next click on the second one down -- \textit{Load files$\dots$} -- which brings up the Load menu.
+       \item Below \textit{Select files to load} on the top left side is a textbox and if you look all the way to the right
        side of the textbox, there is a down arrow which you use to navigate your file system.  Highlight the
        desired file system and you will see that directory name appear in the textbox and the files below.
        \item Scroll to the media file you would like to work on and highlight that file.  When you do, you will
        see that filename also appear in the textbox below the listing of files.  You could have directly
        keyed in that file in that textbox instead.
        \item On the bottom of the Load menu, is a box called \textit{Insertion strategy}.  For getting started the
-       default of \texttt{Replace current project} is sufficient.  But you can click on the down arrow to see what
+       default of \textit{Replace current project} is sufficient.  But you can click on the down arrow to see what
        is available for future use.
        \item Now click on the green colored checkmark on the bottom left hand side to actually load the file
-       and see it appear on the timeline in Cinelerra’s main window and a single frame in the Compositor.
+       and see it appear on the timeline in \CGG{}’s main window and a single frame in the Compositor.
        The first track will most likely be video thumbnails and the next tracks may be audio waveforms.
        \item Press the space bar in the main Program window and your video will start playing and press the
        space bar again to stop the play.  While playing, you should see the video in the Compositor
@@ -89,24 +93,24 @@ You can skip this step if you want the format of your output to be the same as y
 
 \begin{enumerate}
        \item On the main timeline, use the \textit{Settings} pulldown (about the $7^{th}$ pulldown from the left side top) and
-       click on \texttt{Format} which is the first option in that list.
+       click on \textit{Format} which is the first option in that list.
        \item A \textit{Set Format} menu will appear that shows what the current format is for your loaded media in an
        Audio and a Video tab.  In the United States, the Video Frame rate is usually expected to be 29.970     and usually the Color model is only changed if you have a personal preference.
-       \item The \texttt{Canvas size} is probably the only thing you will want to change here in order to get to the
+       \item The \textit{Canvas size} is probably the only thing you will want to change here in order to get to the
        most commonly viewable settings.  On the right hand side of the Width parameter is a down arrow. 
        Left click the down arrow to see your options.
+       \item Highlight $1280\times720$ HD for a good common option.
+       \item Click OK to have this option take effect.  When you do, the Compositor window may change to fit
+       this option and may look wrong sized.
 \end{enumerate}
 
 \begin{figure}[htpb]
        \centering
-       \includegraphics[width=0.8\linewidth]{images/format_setting.png}
+       \includegraphics[width=0.7\linewidth]{format_setting.png}
        \caption{Format menu to change settings}        
 \end{figure}
 
-\begin{enumerate}[resume]
-       \item Highlight $1280\times720$ HD for a good common option.
-       \item Click \texttt{OK} to have this option take effect.  When you do, the Compositor window may change to fit
-       this option and may look wrong sized.
+\begin{enumerate}[resume]      
        \item If the video now looks too small or too large in the Compositor, you will want to \textit{autoscale} it to
        look correct when the new media is created.  To do this, mouse over to the Resources window in the
        lower right hand corner and under the word Visibility, highlight \textit{Video Effects} to see some
@@ -117,24 +121,21 @@ You can skip this step if you want the format of your output to be the same as y
        new value.  Click on the magnifying glass icon on the brown colored line beneath the main timeline
        video which opens a new window.  In that window, again use the down arrow to choose $1280\times720$
        HD, then dismiss this window.
+       \item If not needed, to remove the Auto Scale plugin, right mouse on the brown line and choose \textit{Detach}.
 \end{enumerate}
 
 \begin{figure}[htpb]
        \centering
-       \includegraphics[width=0.6\linewidth]{images/magnifier.png}
+       \includegraphics[width=0.5\linewidth]{magnifier.png}
        \caption{Effect brown bar with magnifier}       
 \end{figure}
 
-\begin{enumerate}[resume]
-       \item If not needed, to remove the Auto Scale plugin, right mouse on the brown line and choose \texttt{Detach}.
-\end{enumerate}
-
 \subsection{View and Listen}%
 \label{sub:view_listen}
 
 \begin{figure}[htpb]
        \centering
-       \includegraphics[width=1.0\linewidth]{images/pulldown_button.png}
+       \includegraphics[width=1.0\linewidth]{pulldown_button.png}
        \caption{Menu pulldowns at the top with Transport buttons below.  Note the yellow tooltips too.}        
 \end{figure}
 
@@ -158,7 +159,7 @@ There may be sections of your media that you want to delete, or audio that is ha
 
 \begin{figure}[htpb]
        \centering
-       \includegraphics[width=1.0\linewidth]{images/some_editing.png}
+       \includegraphics[width=1.0\linewidth]{some_editing.png}
        \caption{From left to right:\textit{ Audio 1} is disarmed --  BandSlide transition in \textit{Video 1} -- A highlighted section.}       
 \end{figure}
 
@@ -169,19 +170,19 @@ There may be sections of your media that you want to delete, or audio that is ha
        \item To delete a section of video/audio is described next.  Various ways to do that are available but the
        easiest is to move your mouse and left click at the beginning of the section you want to delete on the
        timeline and while holding down the left mouse button, drag to the end of the section to be deleted. 
-       When you do this, a white colored highlighted section becomes visible.  Use the edit pulldown and
-       choose the \texttt{split/cut} option to cut out the highlighted area (note the shortcut of \texttt{x}).  Remember if you
+       When you do this, a white colored highlighted section becomes visible.  Use the \textit{Edit} pulldown and
+       choose the \textit{split/cut} option to cut out the highlighted area (note the shortcut of "x").  Remember if you
        cut the wrong thing out you can always use the Edit pulldown to Undo that.
        \item To add a transition where there is deleted section which may make your video look disjointed, do
        the following.   Go back to the Resources window in the bottom right hand corner.  Change to
        \textit{Video Transitions} by highlighting that underneath the word \textit{Visibility}.  Highlight a transition like
-       \texttt{BandSlide} with the left button mouse click, hold down and drag to the video track and when you see
+       \textit{BandSlide} with the left button mouse click, hold down and drag to the video track and when you see
        a white colored box around the area that you deleted above, drop the icon.  Right mouse click the
        icon on the track to vary some parameters like length.
        \item  To insert another clip from a different video, first you have to load the other video on another track.
-       Go to \textit{File} pulldown again and choose the \texttt{Load files} option.  Type in a directory at the top again and
+       Go to \textit{File} pulldown again and choose the \textit{Load files} option.  Type in a directory at the top again and
        erase any specific file that you may have chosen previously in the bottom 2 textboxes.  It is very
-       important to now change the Insertion strategy to \texttt{Append in new tracks} or you will write over
+       important to now change the Insertion strategy to \textit{Append in new tracks} or you will write over
        your current work.  But if you make this mistake, you can use the Edit pulldown and Undo that!
        \begin{enumerate}
                \item Once the new video is on the track below your current work, you want to work with only this new 
@@ -194,11 +195,11 @@ There may be sections of your media that you want to delete, or audio that is ha
                window to the right of the transport buttons, are action buttons and as you mouse over them a
                yellow colored tooltip explains its purpose.  Find the one that says \textit{To clip} which is on the right
                hand side of the right bracket symbol.
-               \item Click on \texttt{To clip} and a small window comes up which you can comment in, but you do not have
+               \item Click on \textit{To clip} and a small window comes up which you can comment in, but you do not have
                to, so just click on the green checkmark and now you will have a clip.
                \item Disarm that new track and re-arm your original tracks so you can go back to working on them
                \item Move your cursor to the spot in your original video where you want to insert the clip.   Make a
-               \textit{Split} with the \texttt{Split | Cut} option.
+               \textit{Split} with the \textit{Split | Cut} option.
                \item Go to the Resources window and under the word Visibility, highlight \textit{Clips} so you can see your
                recently created clip in the box to the right.  Highlight that clip and drag it to where you did the
                blade cut and drop it in.
@@ -207,7 +208,7 @@ There may be sections of your media that you want to delete, or audio that is ha
 
 \begin{figure}[htpb]
        \centering
-       \includegraphics[width=1.0\linewidth]{images/title_color.png}
+       \includegraphics[width=1.0\linewidth]{title_color.png}
        \caption{Compositor + Title menu for setting parameters + the Color Picker.}    
 \end{figure}
 
@@ -221,11 +222,11 @@ There may be sections of your media that you want to delete, or audio that is ha
        usual with left mouse click on the timeline and drag to the end of the desired area.
        \begin{enumerate}
                \item Right click on the brown colored bar that appeared below your video track to get to options and
-               then left click on \texttt{Show} to get the Title window to appear.
+               then left click on \textit{Show} to get the Title window to appear.
                \item Now for the fun part.  First type in some words in the bottom large text box just to see what it
                does.  There are so many variable parameters here and they are a lot of fun to play around with.
                \item You can dismiss the Title window when finished BUT be sure to leave the brown colored Title bar
-               on the track.  And if you enabled the “drag” feature, you should disable it so you do not forget.
+               on the track.  And if you enabled the \textit{drag} feature, you should disable it so you do not forget.
                \item Right mouse click on the bottom Text box to see many more interesting parameters.
        \end{enumerate}
 \end{enumerate}
@@ -233,14 +234,14 @@ There may be sections of your media that you want to delete, or audio that is ha
 \subsection{Back up your work}%
 \label{sub:backup_your_work}
 
-At this time, or even earlier if you think you might make a mistake or if you are concerned about computer crashes, you should save your work.  Use the \textit{File} pulldown, and you can use \texttt{Save as} to designate a directory and filename.  Then click the green checkmark.  You are saving the EDL which is the set of changes that you have made -- this file is separate from your original media.
+At this time, or even earlier if you think you might make a mistake or if you are concerned about computer crashes, you should save your work.  Use the \textit{File} pulldown, and you can use \textit{Save as} to designate a directory and filename.  Then click the green checkmark.  You are saving the EDL which is the set of changes that you have made -- this file is separate from your original media.
 
 \subsection{Create your new media}%
 \label{sub:create_new_media}
 
 \begin{enumerate}
        \item Once again in the main Program window, click on the \textit{File} pulldown and highlight/click the \texttt{Render}
-       option which is about the $9^{th}$ option down from the top of the list.  A Cinelerra Render menu will
+       option which is about the $9^{th}$ option down from the top of the list.  A \CGG{} Render menu will
        appear.
        \item First key in the first textbox the file to render to under \textit{Select a file to render to}.
        \item For the \textit{File Format}, click on the down arrow and select FFMPEG (because this is the most
@@ -254,7 +255,7 @@ At this time, or even earlier if you think you might make a mistake or if you ar
        the menu.  Then click on the wrench for Video and check Pixels by using the down arrow to the
        right to be yuv420p -- this is most commonly usable option.  And click on the green checkmark.
        \item Check the Insertion Strategy in the Render Menu window.  You might want to change that to
-       a different strategy than the default of \texttt{Append in new tracks}.  If not, then when the Render is done,
+       a different strategy than the default of \textit{Append in new tracks}.  If not, then when the Render is done,
        your new video will automatically be loaded in another set of tracks below your work tracks.  Click
        on the green checkmark in the lower left corner to start the render.
        \item As the render is running, you will see the video play by in the Compositor.  Rendering is usually
@@ -264,15 +265,16 @@ At this time, or even earlier if you think you might make a mistake or if you ar
 \subsection{Play your new media}%
 \label{sub:play_your_new_media}
 
-The file you created in the Render step should now be playable.  You can test this in Cinelerra most easily by going to the Resource window in the lower right corner, clicking on the Media folder, and dragging and dropping the last video to the Viewer window.  There is a separate set of transport buttons on the bottom on that screen to use for playing.
+The file you created in the Render step should now be playable.  You can test this in \CGG{} most easily by going to the Resource window in the lower right corner, clicking on the Media folder, and dragging and dropping the last video to the Viewer window.  There is a separate set of transport buttons on the bottom on that screen to use for playing.
 
-\section{YouTube with Cinelerra}%
+\section{YouTube with \CGG{}}%
 \label{sec:youtube_with_cinelerra}
+\index{rendering!youtube preset}
 
-To create a youtube or dailymotion video, you can easily follow the steps below.  You will have to learn a lot more about Cinelerra to take full advantage of its capabilities and make some really special videos, but this is just to get a start and to see the possibilities.
+To create a youtube or dailymotion video, you can easily follow the steps below.  You will have to learn a lot more about \CGG{} to take full advantage of its capabilities and make some really special videos, but this is just to get a start and to see the possibilities.
 
 \begin{enumerate}
-       \item Start Cinelerra; usually you can do this by clicking on Cinelerra icon or key in \texttt{{cin\_path}/bin/cin}.
+       \item Start \CGG{}; usually you can do this by clicking on \CGG{} icon or key in \texttt{{cin\_path}/bin/cin}.
        \item In the Program window on the lower left side of your screen, left mouse click the \textit{File} pulldown.
        \item You will see \textit{Load files} as the second choice so left mouse click this and find your video file to
        load, highlight it, and check the green checkmark in the lower left hand corner to get it loaded.
@@ -287,16 +289,16 @@ To create a youtube or dailymotion video, you can easily follow the steps below.
     highlighting the \textit{Title} icon and dragging it to the Program window video track and dropping.
     \item Click on the middle icon button (looks like a magnifying glass) on the brown colored Title bar to
     bring up the Title window bottom text box and key in a title.
-    \item Use the \textit{File} pulldown to select \texttt{Render} to create the desired video.  In the \textit{Render} window just next to the empty box to the right of the \texttt{ffmpeg} file format, click on the down arrow shown there
-    to see the choices and pick \texttt{youtube}.  Then move back up to key in the path and filename to render
+    \item Use the \textit{File} pulldown to select \textit{Render} to create the desired video.  In the \textit{Render} window just next to the empty box to the right of the \textit{ffmpeg} file format, click on the down arrow shown there
+    to see the choices and pick \textit{youtube}.  Then move back up to key in the path and filename to render
     to.  It will pick all of the defaults automatically for you so then just click on the green checkmark to
     have it start.  There is a progress bar in the main window, very bottom of the right hand side.
-    \item Key in “q” in the main window to get out of Cinelerra and yes or no to save your edit session.
+    \item Key in “q” in the main window to get out of \CGG{} and yes or no to save your edit session.
 \end{enumerate}
 
-Youtube will allow the upload of the resulting rendered file as named.  However, Dailymotion requires that the file be named with an acceptable extension so you must rename the output file to have the extension of \texttt{.webm} instead of \texttt{.youtube}.
+Youtube will allow the upload of the resulting rendered file as named.  However, Dailymotion requires that the file be named with an acceptable extension so you must rename the output file to have the extension of .webm instead of .youtube
 
-There are currently 6 specific variations within the ffmpeg (file format) / youtube (file type) for different video options.  You see these when you click on the wrench to the right of the word Video and then the Compression down arrow in the Video Preset window.  The first 3 are based on Webm/Vp9 (credit Frederic Roenitz) and contain basic comments of usage and where to find more information.
+There are currently 6 specific variations within the ffmpeg (file format) / youtube (file type) for different video options.  You see these when you click on the wrench to the right of the word Video and then the Compression down arrow in the Video Preset window.  The first 3 are based on Webm/Vp9\protect\footnote{credit by Frederic Roenitz} and contain basic comments of usage and where to find more information.
 
 The first 3 below, plus any of the VP9 files under the file type of \textit{webm} are the recommended options to use because they are freely usable in any circumstance.
 
@@ -308,7 +310,7 @@ The first 3 below, plus any of the VP9 files under the file type of \textit{webm
        \end{tabular}
 \end{center}
 
-Alternatives based on h264 and for non-commercial use are listed below.  For Dailymotion, these must be renamed to have a different extension of \texttt{.mp4} instead of \texttt{.youtube} before uploading.
+Alternatives based on h264 and for non-commercial use are listed below.  For Dailymotion, these must be renamed to have a different extension of .mp4 instead of .youtube before uploading.
 
 \begin{center}
        \begin{tabular}{l p{8cm}}
@@ -316,4 +318,4 @@ Alternatives based on h264 and for non-commercial use are listed below.  For Dai
                hd\_h264.youtube & High Definition -          “ “ \\
                uhd\_u264.youtube & Ultra High Definition - “ “ \\
        \end{tabular}
-\end{center}
\ No newline at end of file
+\end{center}