Andrea addition of fary54 real world example + ffmpeg new plugins
authorGood Guy <good1.2guy@gmail.com>
Fri, 17 Jul 2020 01:20:44 +0000 (19:20 -0600)
committerGood Guy <good1.2guy@gmail.com>
Fri, 17 Jul 2020 01:20:44 +0000 (19:20 -0600)
12 files changed:
CinelerraGG_Manual.tex
images/openedl-01.png [new file with mode: 0644]
images/openedl-02.png [new file with mode: 0644]
images/openedl-03.png [new file with mode: 0644]
images/openedl-04.png [new file with mode: 0644]
images/openedl-05.png [new file with mode: 0644]
images/openedl-06.png [new file with mode: 0644]
images/openedl-07.png [new file with mode: 0644]
images/openedl-08.png [new file with mode: 0644]
parts/Editing.tex
parts/Plugins.tex
parts/Real-World.tex [new file with mode: 0644]

index 434054d3103c52a9b3e74d2cb07684d8b267e1ec..bcf4f73fd0730213b4211036b8addf50eea01ce8 100644 (file)
@@ -55,6 +55,7 @@ svgnames,
 \include{parts/Quickstart}
 \include{parts/Developer}
 \include{parts/AuxilaryPrograms}
+\include{parts/Real-World}
 \end{appendices}
 
 \pagestyle{plain}
diff --git a/images/openedl-01.png b/images/openedl-01.png
new file mode 100644 (file)
index 0000000..674fb54
Binary files /dev/null and b/images/openedl-01.png differ
diff --git a/images/openedl-02.png b/images/openedl-02.png
new file mode 100644 (file)
index 0000000..3e90f39
Binary files /dev/null and b/images/openedl-02.png differ
diff --git a/images/openedl-03.png b/images/openedl-03.png
new file mode 100644 (file)
index 0000000..d8900ac
Binary files /dev/null and b/images/openedl-03.png differ
diff --git a/images/openedl-04.png b/images/openedl-04.png
new file mode 100644 (file)
index 0000000..c3fed72
Binary files /dev/null and b/images/openedl-04.png differ
diff --git a/images/openedl-05.png b/images/openedl-05.png
new file mode 100644 (file)
index 0000000..23d130e
Binary files /dev/null and b/images/openedl-05.png differ
diff --git a/images/openedl-06.png b/images/openedl-06.png
new file mode 100644 (file)
index 0000000..b0fe228
Binary files /dev/null and b/images/openedl-06.png differ
diff --git a/images/openedl-07.png b/images/openedl-07.png
new file mode 100644 (file)
index 0000000..323e0e1
Binary files /dev/null and b/images/openedl-07.png differ
diff --git a/images/openedl-08.png b/images/openedl-08.png
new file mode 100644 (file)
index 0000000..7046ea9
Binary files /dev/null and b/images/openedl-08.png differ
index b898283c703ddcb1bdb4035445c40d09f1ce69d1..932e7ee163f8dbcf21732b313d5e88df83736658 100644 (file)
@@ -1258,6 +1258,7 @@ with the stack level.  So, \texttt{backup.xml} is
 that if you \textit{load backup} at stack level 1, the session will
 reload from history at stack level 1, not the main session.
 
+See a real-world workflow at appendix \nameref{sec:workflow_openedl_nested_clips}
 
 \subsection{Editing with File by Reference}%
 \label{sub:file-reference}
index 66d97d2a8309755a8532de9b6a2dad4a32078b78..f2cdee0f066e44ed1a8a0ee90789718b00c7b9c8 100644 (file)
@@ -3585,6 +3585,7 @@ The following is a list of the integrated audio plug-ins.
   the data.
 \item [F\_astats]~\\Shows time domain statistics about audio
   frames.
+\item [F\_asubboost]~\\Boost subwoofer frequencies.
 \item [F\_atempo]~\\Adjusts audio tempo.
 \item [F\_atrim]~\\Pick one continuous section from the input,
   drop the rest.
@@ -3669,6 +3670,7 @@ The following is a list of the integrated audio plug-ins.
 
 The following is a list of the integrated video plug-ins.
 \begin{description}
+\item [F\_addroi]~\\Mark a region of interest in a video frame.
 \item [F\_amplify]~\\Amplify changes between successive video
   frames.
 \item [F\_atadenoise]~\\Apply an Adaptive Temporal Averaging
@@ -3676,6 +3678,7 @@ The following is a list of the integrated video plug-ins.
 \item [F\_avgblur]~\\Apply average blur filter.
 \item [F\_bbox]~\\Compute bounding box for each frame.
 \item [F\_bench]~\\Benchmarks part of a filtergraph.
+\item [F\_bilateral]~\\Apply bilateral filter, spatial smoothing while preserving edges.
 \item [F\_bitplaneoise]~\\Measure bit plane noise.
 \item [F\_blackdetect]~\\Detect video intervals that are
   (almost) black.
@@ -3684,6 +3687,7 @@ The following is a list of the integrated video plug-ins.
   settings you are able to change the power and the radius of the
   boxblur applied to luma, chroma and alpha.
 \item [F\_bwdif]~\\Deinterlaces the input image.
+\item [F\_cas]~\\Apply Contrast Adaptive Sharpen filter to video.
 \item [F\_chromakey]~\\Turns a certain color into
   transparency. Operates on YUV colors.
 \item [F\_ciescope]~\\Video CIE scope.
@@ -3702,6 +3706,7 @@ The following is a list of the integrated video plug-ins.
 \item [F\_cropdetect]~\\Auto-detect crop size.
 \item [F\_curves]~\\Adjust components curves.
 \item [F\_datascope]~\\Video data analysis.
+\item [F\_dblur]~\\Apply Directional blur filter.
 \item [F\_dctdnoiz]~\\Denoise frames using $2D DCT$.
 \item [F\_deband]~\\Debands video.
 \item [F\_deblock]~\\Deblocks video.
@@ -3766,6 +3771,7 @@ The following is a list of the integrated video plug-ins.
 \item [F\_fspp]~\\Applies Fast Simple Post-processing filter.
 \item [F\_gblur]~\\Apply Gaussian Blur filter.
 \item [F\_gradfun]~\\Debands video quickly using gradients.
+\item [F\_gradients]~\\Draws a transparent gradient.
 \item [F\_graphmonitor]~\\Show various filtergraph stats.
 \item [F\_greyedge]~\\Estimates scene illumination by grey
   edge assumption.
@@ -3807,6 +3813,7 @@ The following is a list of the integrated video plug-ins.
 \item [F\_mandelbrot]~\\Render a Mandelbrot fractal.
 \item [F\_mcdeint]~\\Applies motion compensating
   deinterlacing.
+\item [F\_median]~\\Pick median pixel from rectangle defined by radius.
 \item [F\_mestimate]~\\Generate motion vectors.
 \item [F\_mpdecimate]~\\Remove near-duplicate frames.
 \item [F\_mptestsrc]~\\Generate various test pattern.
@@ -3827,6 +3834,7 @@ The following is a list of the integrated video plug-ins.
 \item [F\_perms]~\\Set permissions for the output video frame.
 \item [F\_perspective]~\\Corrects the perspective of video.
 \item [F\_phase]~\\Phases shift fields.
+\item [F\_photosensitivity]~\\Filter out photosensitive epilepsy seizure-inducing flashes.
 \item [F\_pixscope]~\\Pixel data analysis for checking color
   and levels. It will display sample values of color channels.
 \item [F\_pp]~\\Filters video using libpostproc.
@@ -3850,6 +3858,8 @@ The following is a list of the integrated video plug-ins.
 \item [F\_sab]~\\Applies shape adaptive blur.
 \item [F\_scale]~\\Scale the input video size and/or convert
   the image format.
+\item [F\_scdet]~\\Detect video scene change.
+\item [F\_scroll]~\\Scroll input video horizontally and/or vertically by constant speed.
 \item [F\_separatefields]~\\Split input video frames into
   fields.
 \item [F\_setparams]~\\Force field, or color property for the
@@ -3859,6 +3869,7 @@ The following is a list of the integrated video plug-ins.
 \item [F\_showpalette]~\\Display frame palette.
 \item [F\_shuffleframes]~\\Shuffles video frames.
 \item [F\_shuffleplanes]~\\Shuffles video planes.
+\item [F\_sierpinski]~\\Generate a Sierpinski carpet/triangle fractal, and randomly pan around.
 \item [F\_signalstats]~\\Separates statistics from video
   analysis.
 \item [F\_smartblur]~\\Blurs the input video without impacting
@@ -3876,15 +3887,19 @@ The following is a list of the integrated video plug-ins.
 \item [F\_tblend]~\\Blend successive frames.
 \item [F\_testsrc]~\\Generate test pattern.
 \item [F\_testsrc2]~\\Generate another test pattern.
+\item [F\_thistogram]~\\Compute and draw a color distribution histogram for the input video across time.
 \item [F\_tile]~\\Tile several successive frames together.
 \item [F\_tinterlace]~\\Performs temporal field interlacing.
 \item [F\_tlut2]~\\Compute and apply a lookup table from 2
   successive frames.
+\item [F\_tmedian]~\\Pick median pixels from successive frames.
 \item [F\_tmix]~\\Mix successive video frames.
 \item [F\_transpose]~\\Transposes input video.
 \item [F\_unsharp]~\\Sharpen or blur the input videlo.
+\item [F\_untile]~\\Untile a frame into a sequence of frames.
 \item [F\_uspp]~\\Applies Ultra Simple/Slow Post-processing
   filter.
+\item [F\_v360]~\\Convert 360 videos between various formats.
 \item [F\_vaguedenoiser]~\\Applies a Wavelet based Denoiser.
 \item [F\_vectorscope]~\\Video vectorscope.
 \item [F\_vflip]~\\Flips the input video vertically.
@@ -3900,6 +3915,7 @@ The following is a list of the integrated video plug-ins.
 \item [F\_weave]~\\Weaves input video fields into frames.
 \item [F\_xbr]~\\Scales the input using $xBR$ algorithm.
 \item [F\_yadif]~\\Deinterlaces the input image.
+\item [F\_yaepblur]~\\Yet another edge preserving blur filter.
 \item [F\_yuvtestsrc]~\\Generate YUV test pattern.
 \item [F\_zoompan]~\\Applies Zoom \& Pan effect.
 \end{description}
diff --git a/parts/Real-World.tex b/parts/Real-World.tex
new file mode 100644 (file)
index 0000000..35d8a63
--- /dev/null
@@ -0,0 +1,163 @@
+\chapter{Editing: real-world usage cases}%
+\label{cha:editing_real_world_usage}
+
+\section{Workflow with OpenEDL and Nested Clips\protect\footnote{credit fary54}}%
+\label{sec:workflow_openedl_nested_clips}
+
+This is a real world usage case that provides an excellent example of how OpenEDL has been a
+revolution for \CGG{}. Advantages include: editing speed, clarity, ease of finding a specific item,
+and movement of a subject block via \textit{Nest to media}.
+The main concept of editing using OpenEDL in this real world case is to
+reduce a large quantity of videos and shots to a few big clips by using
+an OpenEDL session for each clip. Using the OpenEDL timeline is similar to
+ using the normal timeline: you can add effects, cut and drag, add or delete
+tracks, etc.
+
+For more information on OpenEDL and Nested clips see sections \nameref{sub:edit-edls} and \nameref{sub:nesting}.
+
+Scenario setup consists of making one hour videos using 3 different cameras:
+
+\begin{itemize}
+       \item \textit{Footage 1:} A person uses camera 1 to shoot a general view of the subject (e.g. a jazz group concert).
+       \item \textit{Footage 2:} Another person uses camera 2 to film a detail of a specific subject (e.g. saxophonist or trumpet player).
+       \item \textit{Footage 3:} Contains images of the journey between the subjects (action cam on the windshield of a moving car, on the helmet of a biker, on the handlebars of a bicycle, or on a boat).
+\end{itemize}
+
+\textit{Note:} Camera 1 and 2 are both filming the same subject so the number of hours for the footage from these two cameras easily reaches 20 hours, but the final movie can only be one hour maximum.  For this case, the final movie consists of all the subjects separated by camera 3 footage.
+
+\textit{Workflow:} OpenEDL is used throughout the editing process with the timeline reserved as the workspace. Basically, every time you have to work on a clip (consisting of one or more tracks), you use OpenEDL instead of the classic method of bringing each clip to the timeline, before doing the necessary Drag and Drop or Cut and Paste operations between different tracks. When finished with each
+OpenEDL clip session, save it outside of the OpenEDL layer at the top level of the main timeline.
+
+See \href{https://youtu.be/0li5DdeQ6_o}{Video 1} (using French locale).
+
+
+\subsubsection*{Pre-sorting of the footage}
+\label{ssub:pre_sorting_footage}
+
+       \begin{itemize}
+               \item Load all the shots from camera 1 and create a single clip; do the same with cameras 2 and 3.
+               \item Watch each clip and sort the images to keep (via OpenEDL); delete the blurred footage and the images you do not want to keep.
+       \end{itemize}
+
+\begin{figure}[htpb]
+       \centering
+       \includegraphics[width=0.8\linewidth]{openedl-01.png}
+       \caption{three clips modified with OpenEDL}
+       \label{fig:openedl-01}
+\end{figure}
+
+\textit{Camera 1} contains shots of Barcelona and Lisbon concert made by Camera 1.
+
+\textit{Camera 2} contains shots of Barcelona and Lisbon concert made by Camera 2.
+
+\textit{Camera 3} contains the images of the journey between the first subject and the second (e.g from Barcelona to Lisbon).
+
+\subsubsection*{Extraction of the subjects}
+\label{ssub:extraction_subjects}
+
+Next extract each common subject from the camera 1 \& 2 footage and create a clip, for example - a place, a city, or a subject. In this case scenario, it is a concert in a specific city.
+You end up with as many clips as there are subjects (e.g. Barcelona \& Lisbon).
+ See figure ~\ref{fig:openedl-02}.
+
+\begin{figure}[htpb]
+       \centering
+       \includegraphics[width=0.8\linewidth]{openedl-02.png}
+       \caption{a new clip for each subject: Barcelona and Lisbon}
+       \label{fig:openedl-02}
+\end{figure}
+
+Each subject selected contains 2 video tracks and 4 audio tracks. See figure ~\ref{fig:openedl-03} of a Barcelona clip.
+
+\begin{figure}[htpb]
+       \centering
+       \includegraphics[width=1.0\linewidth]{openedl-03.png}
+       \caption{Barcelona clip: 2 video tracks and 4 audio tracks}
+       \label{fig:openedl-03}
+\end{figure}
+
+\subsubsection*{Editing of the subjects}
+\label{ssub:editing_subjects}
+
+Then edit each subject via OpenEDL. From the 2 tracks 1 \& 4 (camera 1 \& 2) you create a a single track (+ 2 audio tracks) as seen in figure ~\ref{fig:openedl-04}.
+
+\begin{figure}[htpb]
+       \centering
+       \includegraphics[width=1.0\linewidth]{openedl-04.png}
+       \caption{Barcelona clip: 2 video tracks to 1 video track}
+       \label{fig:openedl-04}
+\end{figure}
+
+\subsubsection*{Add sound effects and video/audio effects}
+\label{ssub:add_sound_video_effects}
+
+Next add the sound effects (such as birds or a water fountain) and video / audio effects for each subject; again via OpenEDL.
+
+\subsubsection*{Compaction}
+\label{ssub:compaction}
+
+Each subject is converted to a nested clip by using the \textit{Nest to media} option, making it a group.
+
+\begin{figure}[htpb]
+       \centering
+       \includegraphics[width=0.8\linewidth]{openedl-05.png}
+       \caption{two new nested clips: Barcelona and Lisbon}
+       \label{fig:openedl-05}
+\end{figure}
+
+The subject converted to a nested clip is automatically moved from the Clip folder to the Media folder.
+
+See \href{https://youtu.be/kQ7sGq0o44U}{Video 2} (using French locale).
+
+\subsubsection*{Final assembly}
+\label{ssub:final_assembly}
+
+Import each subject (Nested clip) on the main timeline. Converting using Nest to Media makes it easy to move and position each subject. You can move one subject after or before another.
+
+\begin{figure}[htpb]
+       \centering
+       \includegraphics[width=1.0\linewidth]{openedl-06.png}
+       \caption{Barcelona and Lisbon nested clips on timeline}
+       \label{fig:openedl-06}
+\end{figure}
+
+Insert the retained shots coming from \textit{camera 3} between the different subjects.
+
+\begin{figure}[htpb]
+       \centering
+       \includegraphics[width=1.0\linewidth]{openedl-07.png}
+       \caption{camera 3 footage between Barcelona and Lisbon nested clips}
+       \label{fig:openedl-07}
+\end{figure}
+
+See \href{https://youtu.be/9Hz0a-1i3I8}{Video 3} (using French locale).
+
+Add background music and comments.
+
+\begin{figure}[htpb]
+       \centering
+       \includegraphics[width=1.0\linewidth]{openedl-08.png}
+       \caption{completion of the work}
+       \label{fig:openedl-08}
+\end{figure}
+
+\subsubsection*{More editing}
+\label{ssub:more_editing}
+
+At this stage, each subject can still be edited and undergo any modification via OpenEDL (again ... and always)
+
+\subsubsection*{Render your movie}
+\label{ssub:render_movie}
+
+All that remains is mastering the video with a render.
+
+Ordinarily it it is very difficult to set up such a project but using tools such as OpenEDL and Nested clips makes it quite easy. These tools, in many cases, are essential and become standards for the development of important projects using \CGG{}.
+
+\subsubsection*{Important Notes}
+\label{ssub:important_notes}
+
+\begin{itemize}
+       \item It is recommended that you save your project, not inside an OpenEDL, but rather after you exit openEDL and are on the main timeline.
+       \item Once converted to nest to media the clips disappear from the clips folder to end up in the media folder. You can always, if you wish to recover it in the clips folder do so via the \textit{EDL to clip} menu. In this case, the name of the clip can change but the reference of the clip can be found in the comment of the clip.
+\end{itemize}
+
+See \href{https://youtu.be/bfYaBqVbdCo}{Video 4} (using French locale).