<!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>  CompositingMask &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="CompositingMask" /> -->
<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="CompositingMask"> <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="CompositingMask"> 
<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=20051021150301">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/CompositingMask?t=1129906980"><b>Edit</b></a>
</li>
<li> <a href="http://www.ftconsult.com/twiki/bin/attach/Cinelerra/CompositingMask">Attach</a>
</li>
<li> <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?skin=print.pattern">Printable</a>
</li>
</ul>
</div><div class="twikiRevInfo"><span class="twikiGrayText"><span class="twikiToolbarElem">Cinelerra.CompositingMask</span><span class="twikiToolbarElem">r1.12 - 11 Nov 2004 - 18:25 - <a class="twikiLink" href="../Main/ArthurSosa">ArthurSosa</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">
<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 />
<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/CompositingMask?t=1129906980"><b>Edit</b></a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/attach/Cinelerra/CompositingMask">Attach image or document</a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?skin=print.pattern">Printable version</a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?raw=on">Raw text</a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/oops/Cinelerra/CompositingMask?template=oopsmore&param1=1.12&param2=1.12">More topic actions</a><br />Revisions:  | r1.12 | <a href="http://www.ftconsult.com/twiki/bin/rdiff/Cinelerra/CompositingMask?rev1=1.12&rev2=1.11">&gt;</a> | <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=1.11">r1.11</a> | <a href="http://www.ftconsult.com/twiki/bin/rdiff/Cinelerra/CompositingMask?rev1=1.11&rev2=1.10">&gt;</a> | <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=1.10">r1.10</a> <span class="twikiSeparator">|</span> <a href="../../rdiff/Cinelerra/CompositingMask">Total page history</a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/search/Cinelerra/SearchResult?scope=text&regex=on&excludetopic=CompositingMask&search=Compositing%20*Mask%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="WhatIsCinelerra">WhatIsCinelerra</a> &gt; <a class="twikiLink" href="AboutCinelerra">AboutCinelerra</a> &gt; <a class="twikiLink" href="Compositing">Compositing</a> <span class='twikiSeparator'>&gt;</span> CompositingMask </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>