<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>  Compositor &lt; Cinelerra &lt; TWiki</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />

<link rel="alternate" type="application/rss+xml" title="RSS Feed" href="WebRss?skin=rss&contenttype=text%2fxml" />
<!-- <base href="Compositor" /> -->
<style type="text/css" media="all">
	/* Default TWiki layout */
	@import url('../../../pub/TWiki/PatternSkin/layout.css');
	/* Default TWiki style */
	@import url('../../../pub/TWiki/PatternSkin/style.css');
	/* Custom overriding layout per web or per topic */
	@import url('http://www.ftconsult.com/twiki/bin/view/Cinelerra/%USERLAYOUTURL%');
	/* Custom overriding style per web or per topic */
	@import url('http://www.ftconsult.com/twiki/bin/view/Cinelerra/%USERSTYLEURL%');
	.twikiToc li {
		list-style-image:url('../../../pub/TWiki/PatternSkin/i_arrow_down.gif');
	}	        
	.twikiWebIndicator {
		background-color:#D0D0D0;
	}
</style>
<style type="text/css" media="all"></style>
<script type="text/javascript">
<!-- HIDE
	function initPage() { }
-->
</script>
</head>
<body class="twikiViewPage" onload="initPage()"><a name="PageTop"></a>
<div class="twikiHidden"><a href="#Content">Skip to topic</a> | <a href="#PageBottom">Skip to bottom</a><hr /></div><div class="twikiTopBar"><div class="twikiTopBarContents"><form name="top" action="Compositor"> <div class="twikiLeft">
<a href="http://twiki.org/"><img src="../../../pub/TWiki/TWikiLogos/twikiRobot46x50.gif" border="0" alt="Home"/></a>
</div>
<div class="twikiRight twikiSearchBox">
<table border="0" cellpadding="0" cellspacing="0">
<tr>
<td><label for="go">Jump: </label><input type="text" id="go" name="topic" size="16" /></td>
</tr>
</table>
</div>
</form></div></div><div class="twikiMiddleContainer"><div class="twikiLeftBar"><div class="twikiWebIndicator"><b>Cinelerra</b></div>
<div class="twikiLeftBarContents"><form name="main" action="Compositor"> 
<ul>
<li> <b>Cinelerra Web</b>
</li>
<li> <a class="twikiLink" href="WebHome">Cinelerra Web Home</a>
</li>
<li> <a class="twikiLink" href="WebChanges">Changes</a> 
</li>
<li> <a class="twikiLink" href="WebIndex">Index</a>
</li>
<li> <a class="twikiLink" href="WebSearch">Search</a>
</li>
</ul>
<hr />
<ul>
<li> <strong>Webs</strong>
<ul>
<li> <a class="twikiLink" href="WebHome">Cinelerra</a>
</li>
<li> <a class="twikiLink" href="../Espanol/WebHome">Espanol</a>
</li>
<li> <a class="twikiLink" href="../Francais/WebHome">Francais</a>
</li>
<li> <a class="twikiLink" href="../Italiano/WebHome">Italiano</a>
</li>
<li> <a class="twikiLink" href="../Main/WebHome">Main</a>
</li>
<li> <a class="twikiLink" href="../Sandbox/WebHome">Sandbox</a>
</li>
<li> <a class="twikiLink" href="../Slovenian/WebHome">Slovenian</a>
</li>
<li> <a class="twikiLink" href="../TWiki/WebHome">TWiki</a>
</li>
</ul>
</li>
</ul>
<div class="twikiLeftBarPersonal">
<p />
<ul>
<li> <strong>My links</strong>
</li>
<li> <a class="twikiLink" href="../Main/AeliotBoswell">My home page</a>
</li>
<li> <a href="http://www.ftconsult.com/twiki/bin/search/Codev/?search=InterestedParties.*AeliotBoswell&regex=on" target="_top"><img src="../../../pub/TWiki/TWikiDocGraphics/stargold.gif" style="width:16px; height:16px; border:0px;" alt="Show me topics of interest" /></a>
</li>
</ul>
<div class="twikiSmall"><a href="http://www.ftconsult.com/twiki/bin/edit/Main/TWikiGuestLeftBar?t=20051021151258">edit</a></div>
<p />
</div>
</form></div></div><div class="twikiMain"><div class="twikiToolBar"><div>
<ul>
<li> <a href="http://www.ftconsult.com/twiki/bin/edit/Cinelerra/Compositor?t=1129907578"><b>Edit</b></a>
</li>
<li> <a href="http://www.ftconsult.com/twiki/bin/attach/Cinelerra/Compositor">Attach</a>
</li>
<li> <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/Compositor?skin=print.pattern">Printable</a>
</li>
</ul>
</div><div class="twikiRevInfo"><span class="twikiGrayText"><span class="twikiToolbarElem">Cinelerra.Compositor</span><span class="twikiToolbarElem">r1.7 - 18 May 2004 - 18:56 - <a class="twikiLink" href="../Main/JeremieKnuesel">JeremieKnuesel</a></span><span class="twikiToolbarElem"><a href="#TopicEnd">topic&nbsp;end</a></span></span></div></div>
<div class="twikiHidden"><hr /></div><a name="Content"> </a><div class="twikiHidden">Start of topic | <a href="#Actions">Skip to actions</a><hr /></div>
<div class="twikiTopic">
<h2><a name="The_Compositor"> </a><a name="The_Compositor_"> </a> The <a class="twikiLink" href="Compositor">Compositor</a> </h2>
<img src="../../../pub/Cinelerra/CinelerraImages/compositor.png" alt="compositor.png" /> <br>
The compositor is the control center for all compositing operations on Cinelerra. Here you can create complex video compositions using masks, crop, camera and projector tools.  
<p />
<img src="../../../pub/TWiki/TWikiDocGraphics/tip.gif" border="0" alt="TIP" width="16" height="16" />Operations done in the Compositor affect the timeline but don't affect clips.
<p />
<h3><a name="The_Display"> </a> The Display  </h3>
This area of the Compositor window displays the final output of your project. It's also the interface point for most compositing operations or operations that affect the appearance of the timeline output. 
<p />
<h4><a name="Display_Menu"> </a> Display Menu  </h4>
 Right click over the video portion of the display area to bring up the following menu. 
<p />
<ul>
<li> <code><b>Zoom 25%</b></code> reduces the display size to 25% of the original. 
</li>
<li> <code><b>Zoom 50%</b></code> reduces the display size to 50% of the original.
</li>
<li> <code><b>Zoom 100%</b></code> display media at it's original size.
</li>
<li> <code><b>Zoom 200%</b></code> increases the display size to 200% of the original .
</li>
<li> <code><b>Reset the camera</b></code> returns the <a class="twikiLink" href="CompositingCamera">CompositingCamera</a> to the center position.
</li>
<li> <code><b>Reset the projector</b></code> returns the <a class="twikiLink" href="CompositingProjector">CompositingProjector</a> to the center position.
</li>
<li> <code><b>Show/hide controls</b></code> Shows/hides the controls around the image area
</li>
</ul>
<p />
<h3><a name="Protect_Video"> </a><a name="_Protect_Video"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_protect.png" alt="button_compositor_protect.png" /> Protect Video </h3>
Protects the video from any changes <img src="../../../pub/TWiki/TWikiDocGraphics/pencil.gif" border="0" alt="REFACTOR" width="16" height="16" />. Because the compositor window has so many options and features,this option is a very convenient way to avoid accidentally damaging your ongoing work. _(Specially when working with the camera, projector and keyframes!)
<p />
<h3><a name="The_Compositor_Zoom_Control"> </a><a name="_The_Compositor_Zoom_Control_"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_zoom.png" alt="button_compositor_zoom.png" /> The <a class="twikiLink" href="CompositorZoomControl">Compositor Zoom Control</a> </h3>
<p />
Zoom Video, zooms video in and out in the same way as the zoom option on the menu or the zoom control on the bottom control panel. In zoom mode :
<ul>
<li> clicking in the video output zooms in.
</li>
<li> ctrl-clicking in the video output zooms out.
</li>
<li> If you have a wheel mouse, rotating the wheel zooms in or out too
</li>
</ul>
In addition to the compositor <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_zoom.png" alt="button_compositor_zoom.png" /> Zoom View Tool, the compositing window has a  pulldown menu on the bottom of the window that offers the following zoom options:
<ul>
<li> <code><b>Auto</b></code> the video is zoomed to match the <a class="twikiLink" href="Compositor">compositor</a> window size as closely as possible.
</li>
<li> <code><b>Zoom</b></code> the video is zoomed a power of 2 and scrollbars can be used to scroll around the output. 
</li>
</ul>
<p />
When the video is zoomed bigger than the window size, not only do scrollbars scan around it but middle mouse button dragging in the video output scans around it. This is exactly when The Gimp does.
<p />
<img src="../../../pub/TWiki/TWikiDocGraphics/tip.gif" border="0" alt="TIP" width="16" height="16" /> Zooming in or out with the zoom tool does not change the rendered output, it's merely for scrutinizing video or fitting it in the desktop.
<p />
<img src="../../../pub/TWiki/TWikiDocGraphics/warning.gif" border="0" alt="ALERT!" width="16" height="16" /> Playing video on the compositor when zoomed to any size other that 100% (<em>The original size!</em>) requires cinelerra to do extra processing steps. This could affect the performance on <a class="twikiLink" href="HardwareRequirements">slower systems</a>. 
<p />
<p />
-- <a class="twikiLink" href="../Main/AlexFerrer">AlexFerrer</a> - 23 Jan 2004 <em>from <a class="twikiLink" href="SecretsOfCinelerra">SecretsOfCinelerra</a></em>
<hr />
<p />
<img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" />
<h2><a name="Compositing_Masks"> </a><a name="_Compositing_Masks_"> </a> <a class="twikiLink" href="CompositingMask">Compositing Masks</a> </h2>
In Cinelerra, the <a class="twikiLink" href="CompositingMask">Compositing Mask</a> is one of the most powerful editing tools. A mask is a user defined region on the video track that can be controlled to either <code><b>display</b></code> or <code><b>hide</b></code> it's contents. 
<p />
The power of the mask comes from the ability to let any other tracks behind the mask to be seen through. (<em>if there are no tracks behind, it just shows the space in black.</em>)  
<p />
Using track/mask layering techniques, we can create a variety of effects, like area specific color corrections (for a blue sky!)or removing unwanted objects from the video. (like boom microphones, airplanes or bystanders!) 
<img src="../../../pub/TWiki/TWikiDocGraphics/tip.gif" border="0" alt="TIP" width="16" height="16" /> See some examples at the <a class="twikiLink" href="MaskEffectsTutorial">MaskEffectsTutorial</a> page. 
<p />
<h3><a name="Working_with_masks_on_the_Compos"> </a> Working with masks on the <a class="twikiLink" href="Compositor">Compositor</a> window </h3>
<p />
<h4><a name="Creating_a_mask"> </a><a name="Creating_a_mask_"> </a> Creating a mask : </h4>
<ul>
<li> Using the <a class="twikiLink" href="PatchBay">PatchBay</a> on the <a class="twikiLink" href="MainProgram">MainProgram</a>, <code><b>arm</b></code> a single video track. <br> <img src="../../../pub/Cinelerra/CinelerraImages/program_track_toggles_arm.png" alt="program_track_toggles_arm.png" />  (<em>Shift click on the <a class="twikiLink" href="PatchBay">arm track</a> button to <code><b>single</b></code> activate a track.</em>)
</li>
<li> On the <a class="twikiLink" href="Compositor">Compositor</a> window, click on the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> button to enter <code><b>mask mode</b></code>. 
</li>
<li> Click a point on the video to set the first point of the mask, then Click-drag other points on the video....
</li>
</ul>
<table border="1" cellspacing="1" cellpadding="0">
<tr><td class="twikiFirstCol" bgcolor="#FFFFCC"> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_small.png" alt="compositor_small.png" /> <br> Compositor window </td><td bgcolor="#FFFFCC"> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask1.png" alt="compositor_mask1.png" /> <br> Mask points 1,2,3.. </td><td bgcolor="#FFFFCC"> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask2.png" alt="compositor_mask2.png" /> <br>  Finished mask area </td></tr>
</table>
<p />
<ul>
<li> ...as you add points, the area <code><b>inside</b></code> the perimeter of the points becomes the mask. 
</li>
<li> <img src="../../../pub/TWiki/TWikiDocGraphics/tip.gif" border="0" alt="TIP" width="16" height="16" /> You can create up to eight masks per track. For details look at the <code><b>Mask Number</b></code> option below.
</li>
</ul>
<p />
<h4><a name="Changing_a_mask"> </a><a name="Changing_a_mask_"> </a> Changing a mask: </h4>
Once finished defining the mask, you might need to change or adjust the position of mask points to better fit the object you are trying to mask or to follow along with changes on the video. For this purpose we use special <code><b>Key+mouse</b></code> controls.
<p />
<ul>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask_drag.png" alt="compositor_mask_drag.png" /> <br> <code><b>Ctrl-drag</b></code> allows you to <code><b>move</b></code> existing points to new locations. <em>(Thus altering the shape of the mask.)</em>
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask_belzier.png" alt="compositor_mask_belzier.png" /> <br> <code><b>Shift-drag</b></code> activates <code><b>belzier</b></code> handles to create curves between mask points.
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask_translate.png" alt="compositor_mask_translate.png" /> <br> <code><b>Ctrl-Alt-drag</b></code> translates an entire mask to a new location on the screen.
</li>
</ul>
<p />
<img src="../../../pub/TWiki/TWikiDocGraphics/help.gif" border="0" alt="HELP" width="16" height="16" /> Mask editing in Cinelerra is identical to how <a href="http://www.gimp.org/" target="_top">The Gimp</a> edits masks except in this case the effect of the mask is always on.
<p />
<p />
<h3><a name="The_Mask_Options_Window"> </a> The Mask Options Window </h3>
<p />
Selecting the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_info.png" alt="button_compositor_info.png" /> question mark from the tool bar of the <a class="twikiLink" href="Compositor">Compositor</a> window (on <code><b>mask mode</b></code> of course) brings up the mask options window. The mask options windows has the following controls to affect the behaviour of masks:
<p />
<img src="../../../pub/Cinelerra/CinelerraImages/mask_dialog.png" alt="mask_dialog.png" />
<p />
<ul>
<li> <code><b>Mode</b></code> The mode of the mask determines the effect of the mask on the track temporary.
<ul>
<li> In <code><b>subtract alpha</b></code> mode, the mask causes video to disappear. 
</li>
<li> In <code><b>multiply alpha</b></code> mode, the mask causes video to appear and everything outside the mask to disappear.
</li>
</ul>
</li>
</ul>
<img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask_mode.png" alt="compositor_mask_mode.png" /> 
<p />
<ul>
<li> <code><b>Value</b></code> The value of the mask determines how extreme the mask effect is. 
<ul>
<li> In <code><b>subtract alpha</b></code> mode, higher values make the masked area images less visible. 
</li>
<li> In <code><b>multiply alpha</b></code> mode, higher values make the masked area brighter while the region outside the mask is always hidden.<br>  <img src="../../../pub/Cinelerra/CinelerraImages/composite_mask_value.png" alt="composite_mask_value.png" /> 
</li>
</ul>
</li>
</ul>
<p />
<ul>
<li> <code><b>Mask Number</b></code> Each track has eight possible masks, the selected mask number determines which one of the eight masks will be edited when click-draggin in the compositor window.
</li>
<li> <img src="../../../pub/TWiki/TWikiDocGraphics/tip.gif" border="0" alt="TIP" width="16" height="16" /> Other mask are still active but only the curve overlay for the currently selected mask is visible.
</li>
</ul>
<p />
<ul>
<li> <code><b>Feather</b></code> The feather parameter determines how many pixels to feather the mask. This creates softer edges but takes longer to render. <br> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_feather.png" alt="compositor_feather.png" /> 
</li>
</ul>
<p />
<ul>
<li> <code><b>Delete</b></code> Deletes the <code><b>active point</b></code> on the current mask <br>
</li>
<li> <img src="../../../pub/TWiki/TWikiDocGraphics/warning.gif" border="0" alt="ALERT!" width="16" height="16" /> The <code><b>active point</b></code> is defined as the last point dragged in the compositor window. <em>(Any point can be activated by ctrl-clicking it)</em>
</li>
</ul>
<p />
<ul>
<li> <code><b>X: &amp; Y:</b></code> This control moves the <code><b>active point</b></code> to the X Y coordinates entered.
</li>
</ul>
<p />
<h3><a name="Other_Notes"> </a> Other Notes </h3>
<img src="../../../pub/TWiki/TWikiDocGraphics/tip.gif" border="0" alt="TIP" width="16" height="16" /> When multiple masks are used, their effects are ORed together. Every mask in a single track uses the same value and mode.
<p />
The order of the compositing pipeline affects what can be done with masks. Mainly, masks are performed on the temporary after effects and before the projector. This means multiple tracks can be bounced to a masked track and projected with the same mask.
<p />
-- <a class="twikiLink" href="../Main/AlexFerrer">AlexFerrer</a> - Jan 20 2004 <em>from <a class="twikiLink" href="SecretsOfCinelerra">SecretsOfCinelerra</a></em>
<hr />
<p />
<img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_camera.png" alt="button_compositor_camera.png" /> 
<h3><a name="CompositingCamera_Compositing_Ca"> </a><a name="_CompositingCamera_Compositing_C"> </a> <a class="twikiLink" href="CompositingCamera">Compositing Camera Controls</a> </h3>
In Cinelerra's compositing pipeline, the <a class="twikiLink" href="CompositingCamera">CompositingCamera</a> is the mechanism that " <em>captures</em> " images from the original source video, and then transfers them to the <a class="twikiLink" href="CompositingTemporary">CompositingTemporary</a>. We call this mechanism a " <code><b>camera</b></code> ", because the capturing process is analogous to a camera scanning frames from film. 
<p />
The purpose of the camera, is to select a user defined sub-area of the original video material for it's transfer to the <a class="twikiLink" href="CompositingTemporary">temporary</a> and later use on the compositing pipeline. The intention of the camera is to produce still photo panning.
<p />
<h4><a name="The_Viewport"> </a> The Viewport </h4>
<p />
<ul>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/camera_concept.png" alt="camera_concept.png" />
</li>
</ul>
<p />
The <code><b>viewport</b></code>, is a window on the camera that frames the area of source video to be scanned. The viewport is represented as a red frame with diagonal cross bars.
<p />
<ul>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/viewport_sizes.png" alt="viewport_sizes.png" /> <br> 
</li>
</ul>
<p />
The size of the viewport is defined by the <a class="twikiLink" href="ResizeTrack">size of the current track</a>. A smaller viewport <em>(640x400)</em> captures a smaller area. A larger viewport <em>(800x200)</em> captures an area larger than the source video and fills the empty spaces with blanks.
<p />
<h4><a name="Controlling_the_position_of_the"> </a><a name="Controlling_the_position_of_the_"> </a> Controlling the position of the camera </h4>
Once we have our viewport defined, we still need to place the camera right above the area of source video we are interested on. 
<p />
To control the location of the camera,
<ul>
<li> Open the compositor window with a track selected.
</li>
<li> Select the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_camera.png" alt="button_compositor_camera.png" /> camera button to enable camera editing mode.
</li>
<li> Drag over the display window. 
</li>
</ul>
<p />
When we drag over the viewport in the compositor window <em>(although initially counter-intuitive)</em>, the viewport does not moves, but the area of video that sits under the camera's location does!. (<em>like when monitoring a moving camera on a monitor!</em>)
<p />
<ul>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/viewport_drag.png" alt="viewport_drag.png" /> <br> <strong><em>In the compositor window, the viewport is always shown centered, what moves is the video under it.</em></strong>
</li>
</ul>
<p />
For example : when you drag the camera down, the viewport in effect is moving downwards on the video, showing it's path towards the bottom of the video, but from our perspective on the compositor screen, we see the video moving <code><b>up</b></code>. When you drag the camera right, the video seems to move left, and so on. 
<p />
<img src="../../../pub/TWiki/TWikiDocGraphics/warning.gif" border="0" alt="ALERT!" width="16" height="16" /> The guide box shows where the camera position is in relation to past and future camera positions, not where it is in relation to the source video.
<p />
<h4><a name="Controlling_the_zoom_factor_of_t"> </a> Controlling the zoom factor of the camera </h4>
When you shift-drag over the vieport, the camera digitally zooms in or out on the source video. 
<p />
<ul>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/viewport_zoom.png" alt="viewport_zoom.png" /> <br> <strong><em>Shift-Drag to Zoom the source video.</em></strong> (Zoom: 200%, 100%, 50% )
</li>
</ul>
<p />
Once the camera zoom level is set, the displayed image bound by the viewport is what gets transfered to the temporary. 
<p />
<h4><a name="Camera_Tool"> </a> Camera Tool </h4>
The camera tool window shows x, y, and z coordinates. When doing adjustments for fine control the camera can be precisely moved (x,y) or zoomed (z), by either tumbling or entering text directly into the value fields.
<p />
<img src="../../../pub/Cinelerra/CinelerraImages/compositor_campro_tool.png" alt="compositor_campro_tool.png" />
<p />
<h4><a name="Auto_Justification_controls"> </a> Auto Justification controls </h4>
 The justify buttons, automatically align the camera viewport to anyone of nine pre-set justify positions. The positions are: 
<ul>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_left.png" alt="button_justify_left.png" /> Left 
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_centerH.png" alt="button_justify_centerH.png" /> Center Horizontal 
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_right.png" alt="button_justify_right.png" /> Right  
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_top.png" alt="button_justify_top.png" /> Top
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_centerV.png" alt="button_justify_centerV.png" /> Center Vertical
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_bottom.png" alt="button_justify_bottom.png" /> Bottom
</li>
</ul>
<p />
<img src="../../../pub/TWiki/TWikiDocGraphics/tip.gif" border="0" alt="TIP" width="16" height="16" /> A popular justification operation is upper left  <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_top.png" alt="button_justify_top.png" /> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_left.png" alt="button_justify_left.png" />  projection after image reduction. This is used when reducing the size of video with aspect ratio adjustment. 
<p />
<img src="../../../pub/TWiki/TWikiDocGraphics/warning.gif" border="0" alt="ALERT!" width="16" height="16" /> Be sure to read the <a class="twikiLink" href="KeyFrame">KeyFrame</a> page to better understand  the use of the <a class="twikiLink" href="CompositingCamera">CompositingCamera</a>.
<p />
<p />
-- <a class="twikiLink" href="../Main/AlexFerrer">AlexFerrer</a> - 24 Jan 2004
<hr />
<p />
<img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_projector.png" alt="button_compositor_projector.png" />
<h2><a name="CompositingProjector_Compositing"> </a><a name="_CompositingProjector_Compositin"> </a> <a class="twikiLink" href="CompositingProjector">Compositing Projector Controls</a> </h2>
In Cinelerra's compositing pipeline, the <a class="twikiLink" href="CompositingProjector">CompositingProjector</a> is the mechanism that " <em>projects</em> " images in the temporary into the output. We call this mechanism a " <code><b>projector</b></code> ", because the rendering process of the images is analogous to a film projecting into a canvas for the final output.
<p />
<img src="../../../pub/Cinelerra/CinelerraImages/projector_concept.png" alt="projector_concept.png" />
<p />
The purpose of the projector, is to place the contents of the <a class="twikiLink" href="CompositingTemporary">temporary</a> _ (earlier captured by the <a class="twikiLink" href="CompositingCamera">camera</a>)_  into the project's output. The intention of the projector is to composite several sources ( <em>from the various tracks</em> ) into one final output track. 
<p />
<h4><a name="The_projector_alignment_frame"> </a> The projector alignment frame </h4>
The projector alignment frame is identical to the <a class="twikiLink" href="CompositingCamera">camera's viewport</a>, except that it  guides where on the output canvas to put the contents of each temporary. (<em>and the projection size too</em>)
<p />
<img src="../../../pub/Cinelerra/CinelerraImages/projector_screen.png" alt="projector_screen.png" /><br> <strong><em>Compositor window on projector mode with 3 composited tracks on</em></strong>
<p />
<h3><a name="Controlling_the_position_of_the"> </a><a name="Controlling_the_position_of_the_"> </a> Controlling the position of the projector. </h3>
<p />
Each track-temporary has a corresponding projector. To select the track you wish to work on :
<ul>
<li> On the <a class="twikiLink" href="PatchBay">PatchBay</a> for the track you want, Single select the track. (<em>shift arm</em>)
</li>
</ul>
<p />
To control the position of the projector for the selected track, 
<ul>
<li> Click the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_projector.png" alt="button_compositor_projector.png" /> projector button to enable projector editing mode. <em>(A guide box appears in the video window.)</em> 
</li>
<li> Drag over the video window causes to move the guide box. (<em>along with the video</em>)
</li>
<li> <img src="../../../pub/TWiki/TWikiDocGraphics/warning.gif" border="0" alt="ALERT!" width="16" height="16" /> The adjustments only affect the selected track.
</li>
</ul>
<p />
To change the size of the image projected,
<ul>
<li> Shift-drag the video window.
</li>
</ul>
<p />
To work on any other track, go back to the <a class="twikiLink" href="MainProgram">MainProgram</a> <img src="../../../pub/TWiki/TWikiDocGraphics/arrowright.gif" border="0" alt="MOVED TO..." width="16" height="16" /> <a class="twikiLink" href="PatchBay">PatchBay</a> and single select the track. 
<p />
<h3><a name="Compositing_Overlapping_Tracks"> </a> Compositing Overlapping Tracks </h3>
When various traks are projected on the output, tracks may overlap each other. In such cases, the first track on the timeline, will be on top, the second below the first and so on. <img src="../../../pub/TWiki/TWikiDocGraphics/tip.gif" border="0" alt="TIP" width="16" height="16" /> To change the order of the tracks use the <a class="twikiLink" href="MediaTrack">pop-up menu</a> available at each track.
<p />
When the compositor finds overlaping tracks, it mixes them based on the <a class="twikiLink" href="OverlayMode">OverlayMode</a> set for each track on the <a class="twikiLink" href="TrackControl">TrackControls</a>. 
<p />
<p />
<h3><a name="Projector_Tool"> </a> Projector Tool </h3>
To activate the projector tool, press the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_info.png" alt="button_compositor_info.png" /> button. 
<p />
<img src="../../../pub/Cinelerra/CinelerraImages/compositor_campro_tool.png" alt="compositor_campro_tool.png" />
<p />
The tool window shows x, y, and z coordinates. By either tumbling or entering text directly, the projector can be precisely positioned. 
<p />
<p />
<h4><a name="Auto_Justification_controls"> </a> Auto Justification controls </h4>
 The justify buttons, automatically align the projector  to any one of nine pre-set justify positions. The positions are: 
<ul>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_left.png" alt="button_justify_left.png" /> Left 
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_centerH.png" alt="button_justify_centerH.png" /> Center Horizontal 
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_right.png" alt="button_justify_right.png" /> Right  
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_top.png" alt="button_justify_top.png" /> Top
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_centerV.png" alt="button_justify_centerV.png" /> Center Vertical
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_bottom.png" alt="button_justify_bottom.png" /> Bottom
</li>
</ul>
<p />
Merely by selecting left justify and top justify <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_left.png" alt="button_justify_left.png" /> <img src="../../../pub/Cinelerra/CinelerraImages/button_justify_top.png" alt="button_justify_top.png" />  , the projector displays the reduced image from the top left corner of the temporary in the center of the output. 
<p />
-- <a class="twikiLink" href="../Main/AlexFerrer">AlexFerrer</a> - 21 Dec 2003
<hr />
<p />
<h3><a name="Compositing_Cropping_Crop_a_laye"> </a><a name="_Compositing_Cropping_Crop_a_lay"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_crop.png" alt="button_compositor_crop.png" /> <a class="twikiLink" href="CompositingCropping">Crop</a> a layer or output </h3>
<p />
Cropping changes the value of the output dimensions and the <a class="twikiLink" href="CompositingProjector">CompositingProjector</a> to reduce the visible picture area. 
<p />
<h4><a name="Cropping_a_video"> </a> Cropping a video  </h4>
On the compositor window ...
<ul>
<li> Enable the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_crop.png" alt="button_compositor_crop.png" /> crop toggle.
</li>
<li> Click on the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_info.png" alt="button_compositor_info.png" /> tool to display the <code><b>Crop control</b></code> dialog box.
</li>
</ul>
<p />
<ul>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_crop_tool.png" alt="compositor_crop_tool.png" /> <br> <strong><em>Crop control dialog box</em></strong>
</li>
</ul>
<p />
<ul>
<li> Click-drag anywhere in the video to define the crop area. 
</li>
<li> <img src="../../../pub/TWiki/TWikiDocGraphics/tip.gif" border="0" alt="TIP" width="16" height="16" /> Click-drag over <code><b>any</b></code> corner of the rectangle to resize/re-position the crop area.
</li>
</ul>
<p />
<ul>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_crop.png" alt="compositor_crop.png" /> <br> <strong><em>Crop area defined</em></strong> 
</li>
</ul>
<p />
<ul>
<li> When the crop area is exactly right, click <code><b>(Do it)</b></code> on the Crop control dialog.
</li>
</ul>
The image is then cropped to fit the area defined by the crop lines.
<p />
<img src="../../../pub/TWiki/TWikiDocGraphics/help.gif" border="0" alt="HELP" width="16" height="16" /> The X1,Y1 &amp; X2,Y2 cordinates on the crop control dialog allows text entry of the top left and bottom right coordinates that define the crop rectangle.  
<p />
<a class="twikiLink" href="../Main/AlexFerrer">AlexFerrer</a> Jan 18 2004  <em>from <a class="twikiLink" href="SecretsOfCinelerra">SecretsOfCinelerra</a></em>
<hr />
<p />
<h3><a name="Show_CompositingTool_Tool_inform"> </a><a name="_Show_CompositingTool_Tool_infor"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_info.png" alt="button_compositor_info.png" /> Show <a class="twikiLink" href="CompositingTool">Tool</a> information </h3>
<p />
The Show tools button works only in conjuction with the other controls on the compositor. Based on what compositing control is active the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_info.png" alt="button_compositor_info.png" /> toggle button will activate/deactivate the appropiate control dialog box.
<p />
Controls with dialog boxes are :
<ul>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> Edit mask
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_camera.png" alt="button_compositor_camera.png" /> Camera automation
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_projector.png" alt="button_compositor_projector.png" /> Projector automation
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_crop.png" alt="button_compositor_crop.png" /> Crop control
</li>
</ul>
<p />
<p />
-- <a class="twikiLink" href="../Main/AlexFerrer">AlexFerrer</a> - 18 Jan 2004
<hr />
<p />
<h3><a name="Show_SafeRegions_Safe_Regions"> </a><a name="_Show_SafeRegions_Safe_Regions_"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_saferegion.png" alt="button_compositor_saferegion.png" /> Show <a class="twikiLink" href="SafeRegions">Safe Regions</a> </h3>
On consumer displays the borders of the image are cut off and within the cutoff point is a region which isn't always square like it is in the compositor window. The borders are intended for scratch room and vertical blanking data. You can show where these borders are by enabling the titlesafe.png safe regions toggle. Keep titles inside the inner rectangle and keep action inside the outer rectangle. 
<p />
<a class="twikiLink" href="../Main/AlexFerrer">AlexFerrer</a> Jan 18 2004 <em>from <a class="twikiLink" href="SecretsOfCinelerra">SecretsOfCinelerra</a></em>
<hr />
<p />
<p />
<h3><a name="Other_controls"> </a> Other controls </h3>
The <a class="twikiLink" href="Compositor">Compositor</a> window uses the exact same transport and editing controls as the <a class="twikiLink" href="Viewer">Viewer</a> window.
<p />
<p />
<p />
-- <a class="twikiLink" href="../Main/AlexFerrer">AlexFerrer</a> - 18 Dec 2003
<hr />
<br class="twikiClear" />
<a name="TopicEnd"></a>
<span class="twikiRight twikiPageNav twikiGrayText"><a href="#PageTop">to&nbsp;top</a></span><br class="twikiClear" />
</div><div class="twikiHidden"><hr />End of topic<br /><a href="#Actions">Skip to action links</a> | <a href="#PageTop">Back&nbsp;to&nbsp;top</a><hr /></div>
<!---->
<!---->
<a name="Actions"> </a><span class="twikiHidden"><br /></span><div class="twikiTopicAction"><a href="http://www.ftconsult.com/twiki/bin/edit/Cinelerra/Compositor?t=1129907578"><b>Edit</b></a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/attach/Cinelerra/Compositor">Attach image or document</a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/Compositor?skin=print.pattern">Printable version</a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/Compositor?raw=on">Raw text</a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/oops/Cinelerra/Compositor?template=oopsmore&param1=1.7&param2=1.7">More topic actions</a><br />Revisions:  | r1.7 | <a href="http://www.ftconsult.com/twiki/bin/rdiff/Cinelerra/Compositor?rev1=1.7&rev2=1.6">&gt;</a> | <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/Compositor?rev=1.6">r1.6</a> | <a href="http://www.ftconsult.com/twiki/bin/rdiff/Cinelerra/Compositor?rev1=1.6&rev2=1.5">&gt;</a> | <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/Compositor?rev=1.5">r1.5</a> <span class="twikiSeparator">|</span> <a href="../../rdiff/Cinelerra/Compositor">Total page history</a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/search/Cinelerra/SearchResult?scope=text&regex=on&excludetopic=Compositor&search=Compositor%5B%5EA-Za-z0-9%5D">Backlinks</a></div>
<div class="twikiTopicInfo twikiRevInfo twikiGrayText twikiMoved"></div>
<div class="twikiTopicFooter"><span class="twikiLeft"><span class="twikiHomePath">You are here: <a class="twikiLink" href="WebHome">Cinelerra</a>  <span class='twikiSeparator'>&gt;</span> <a class="twikiLink" href="CinelerraManualTOC">CinelerraManualTOC</a> &gt; <a class="twikiLink" href="UnderstandingTheUI">UnderstandingTheUI</a> <span class='twikiSeparator'>&gt;</span> Compositor </span></span><span class="twikiHidden"><br /><br /></span><span class="twikiRight twikiPageNav twikiGrayText"><a href="#PageTop">to&nbsp;top</a></span><br class="twikiClear" /><span class="twikiHidden"><br /></span></div>
<a name="PageBottom"></a> </div></div><div class="twikiBottomBar"><div class="twikiBottomBarContents"><span class="twikiGrayText">Copyright &copy; 1999-2005 by the contributing authors. 
All material on this collaboration platform is the property of the contributing authors. <br /> 
Ideas, requests, problems regarding TWiki? <a href="mailto:alex@ftconsult.com?subject=TWiki&#32;Feedback&#32;on&#32;TWiki.WebBottomBar">Send feedback</a>
</span></div></div>
</body></html>