<!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>(r1.1 vs. r1.12) CompositingMask &lt; Cinelerra &lt; TWiki</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta name="robots" content="noindex" />
<link rel="alternate" type="application/rss+xml" title="RSS Feed" href="../../view/Cinelerra/WebRss?skin=rss&contenttype=text%2fxml" />
<!-- <base href="../../view/Cinelerra/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="twikiNoViewPage twikiDiffPage"><a name="PageTop"></a>
<div class="twikiMiddleContainer"><div class="twikiMain"><div class="twikiSearchResults"><div class="twikiSearchResultsHeader">&nbsp;<tt><b>&lt;&lt;O&gt;&gt;</b></tt>&nbsp; Difference Topic
		<b><a href="../../view/Cinelerra/CompositingMask">CompositingMask</a></b>
		(<a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=r1.12">r1.12</a> - 11&nbsp;Nov&nbsp;2004 - <a class="twikiLink" href="../../view/Main/ArthurSosa">ArthurSosa</a>)</div>
<table class="twikiDiffTable" width="100%" cellspacing="0">
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<table border="1" cellspacing="1" cellpadding="0">
<tr><th class="twikiFirstCol" bgcolor="#99CCCC"> <strong>META TOPICPARENT</strong> </th><td colspan="2" bgcolor="#FFFFCC"> Compositing </td></tr>
</table>
<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="../../view/Cinelerra/CompositingMask">Compositing Masks</a> </h2>
</td></tr>
<tr bgcolor="#eeeeee" class="twikiDiffLineNumberHeader"><th align="left" colspan="9">Line: 12 to 12</th></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<h3><a name="Working_with_masks_on_the_Compos"> </a> Working with masks on the <a class="twikiLink" href="../../view/Cinelerra/Compositor">Compositor</a> window </h3>
<p />
<h4><a name="Creating_a_mask"> </a><a name="Creating_a_mask_"> </a> Creating a mask : </h4>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<ul>
<li> Using the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">PatchBay</a> on the <a class="twikiLink" href="../../view/Cinelerra/MainProgram">MainProgram</a>, <code><b>arm</b></code> a single video track. <br> <img src="http://www.ftconsult.com/twiki/pub/Cinelerra/TrackControl/program_track_toggles_arm.png" alt="program_track_toggles_arm.png" />  (<em>Shift click on the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">arm track</a> button to <code><b>single</b></code> activate a track.</em>)
</li>
</ul>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<ul>
<li> Using the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">PatchBay</a> on the <a class="twikiLink" href="../../view/Cinelerra/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="../../view/Cinelerra/PatchBay">arm track</a> button to <code><b>single</b></code> activate a track.</em>)
</li>
</ul>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<ul>
<li> On the <a class="twikiLink" href="../../view/Cinelerra/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>
</td></tr>

</table></div><div class="twikiSearchResults"><div class="twikiSearchResultsHeader">&nbsp;<tt><b>&lt;&lt;O&gt;&gt;</b></tt>&nbsp; Difference Topic
		<b><a href="../../view/Cinelerra/CompositingMask">CompositingMask</a></b>
		(<a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=r1.11">r1.11</a> - 22&nbsp;Jun&nbsp;2004 - <a class="twikiLink" href="../../view/Main/AndrazTori">AndrazTori</a>)</div>
<table class="twikiDiffTable" width="100%" cellspacing="0">
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<table border="1" cellspacing="1" cellpadding="0">
<tr><th class="twikiFirstCol" bgcolor="#99CCCC"> <strong>META TOPICPARENT</strong> </th><td colspan="2" bgcolor="#FFFFCC"> Compositing </td></tr>
</table>
<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="../../view/Cinelerra/CompositingMask">Compositing Masks</a> </h2>
</td></tr>
<tr bgcolor="#eeeeee" class="twikiDiffLineNumberHeader"><th align="left" colspan="9">Line: 27 to 27</th></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<ul>
<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>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<img src="../../../pub/TWiki/TWikiDocGraphics/help.gif" border="0" alt="HELP" width="16" height="16" /> Mask editing in Cinelerra is identical to how <span class="twikiNewLink" style="background : #FFFFCE;"><font color="#0000FF">The Gimp</font><a href="http://www.ftconsult.com/twiki/bin/edit/Cinelerra/Httpwwwgimporg?topicparent=Cinelerra.CompositingMask"><sup>?</sup></a></span> edits masks except in this case the effect of the mask is always on.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<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.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
<p />
<h3><a name="The_Mask_Options_Window"> </a> The Mask Options Window </h3>
</td></tr>

</table></div><div class="twikiSearchResults"><div class="twikiSearchResultsHeader">&nbsp;<tt><b>&lt;&lt;O&gt;&gt;</b></tt>&nbsp; Difference Topic
		<b><a href="../../view/Cinelerra/CompositingMask">CompositingMask</a></b>
		(<a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=r1.10">r1.10</a> - 26&nbsp;Jan&nbsp;2004 - <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a>)</div>
<table class="twikiDiffTable" width="100%" cellspacing="0">
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<table border="1" cellspacing="1" cellpadding="0">
<tr><th class="twikiFirstCol" bgcolor="#99CCCC"> <strong>META TOPICPARENT</strong> </th><td colspan="2" bgcolor="#FFFFCC"> Compositing </td></tr>
</table>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<h2><a name="Compositing_Masks"> </a><a name="_Compositing_Masks_"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> <a class="twikiLink" href="../../view/Cinelerra/CompositingMask">Compositing Masks</a> </h2>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<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="../../view/Cinelerra/CompositingMask">Compositing Masks</a> </h2>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
In Cinelerra, the <a class="twikiLink" href="../../view/Cinelerra/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>)  
</td></tr>

</table></div><div class="twikiSearchResults"><div class="twikiSearchResultsHeader">&nbsp;<tt><b>&lt;&lt;O&gt;&gt;</b></tt>&nbsp; Difference Topic
		<b><a href="../../view/Cinelerra/CompositingMask">CompositingMask</a></b>
		(<a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=r1.9">r1.9</a> - 22&nbsp;Jan&nbsp;2004 - <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a>)</div>
<table class="twikiDiffTable" width="100%" cellspacing="0">
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<table border="1" cellspacing="1" cellpadding="0">
<tr><th class="twikiFirstCol" bgcolor="#99CCCC"> <strong>META TOPICPARENT</strong> </th><td colspan="2" bgcolor="#FFFFCC"> Compositing </td></tr>
</table>
<h2><a name="Compositing_Masks"> </a><a name="_Compositing_Masks_"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> <a class="twikiLink" href="../../view/Cinelerra/CompositingMask">Compositing Masks</a> </h2>
In Cinelerra, the <a class="twikiLink" href="../../view/Cinelerra/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. 
</td></tr>
<tr bgcolor="#eeeeee" class="twikiDiffLineNumberHeader"><th align="left" colspan="9">Line: 11 to 11</th></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<h3><a name="Working_with_masks_on_the_Compos"> </a> Working with masks on the <a class="twikiLink" href="../../view/Cinelerra/Compositor">Compositor</a> window </h3>
<p />
<h4><a name="Creating_a_mask"> </a><a name="Creating_a_mask_"> </a> Creating a mask : </h4>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<ul>
<li> Using the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">PatchBay</a> on the <a class="twikiLink" href="../../view/Cinelerra/MainProgram">MainProgram</a>, <code><b>arm</b></code> a single video track. <br> <img src="http://www.ftconsult.com/twiki/pub/Cinelerra/TrackControls/program_track_toggles_arm.png" alt="program_track_toggles_arm.png" />  (<em>Shift click on the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">arm track</a> button to <code><b>single</b></code> activate a track.</em>)
</li>
</ul>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<ul>
<li> Using the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">PatchBay</a> on the <a class="twikiLink" href="../../view/Cinelerra/MainProgram">MainProgram</a>, <code><b>arm</b></code> a single video track. <br> <img src="http://www.ftconsult.com/twiki/pub/Cinelerra/TrackControl/program_track_toggles_arm.png" alt="program_track_toggles_arm.png" />  (<em>Shift click on the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">arm track</a> button to <code><b>single</b></code> activate a track.</em>)
</li>
</ul>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<ul>
<li> On the <a class="twikiLink" href="../../view/Cinelerra/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>
</td></tr>

</table></div><div class="twikiSearchResults"><div class="twikiSearchResultsHeader">&nbsp;<tt><b>&lt;&lt;O&gt;&gt;</b></tt>&nbsp; Difference Topic
		<b><a href="../../view/Cinelerra/CompositingMask">CompositingMask</a></b>
		(<a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=r1.8">r1.8</a> - 21&nbsp;Jan&nbsp;2004 - <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a>)</div>
<table class="twikiDiffTable" width="100%" cellspacing="0">
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<table border="1" cellspacing="1" cellpadding="0">
<tr><th class="twikiFirstCol" bgcolor="#99CCCC"> <strong>META TOPICPARENT</strong> </th><td colspan="2" bgcolor="#FFFFCC"> Compositing </td></tr>
</table>
<h2><a name="Compositing_Masks"> </a><a name="_Compositing_Masks_"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> <a class="twikiLink" href="../../view/Cinelerra/CompositingMask">Compositing Masks</a> </h2>
In Cinelerra, the <a class="twikiLink" href="../../view/Cinelerra/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>)  
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
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" /> For more examples look at the <a class="twikiLink" href="../../view/Cinelerra/MaskEffectsTutorial">MaskEffectsTutorial</a> section. 
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
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="../../view/Cinelerra/MaskEffectsTutorial">MaskEffectsTutorial</a> page. 
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
<h3><a name="Working_with_masks_on_the_Compos"> </a> Working with masks on the <a class="twikiLink" href="../../view/Cinelerra/Compositor">Compositor</a> window </h3>
</td></tr>
<tr bgcolor="#eeeeee" class="twikiDiffLineNumberHeader"><th align="left" colspan="9">Line: 13 to 14</th></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<ul>
<li> Using the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">PatchBay</a> on the <a class="twikiLink" href="../../view/Cinelerra/MainProgram">MainProgram</a>, <code><b>arm</b></code> a single video track. <br> <img src="http://www.ftconsult.com/twiki/pub/Cinelerra/TrackControls/program_track_toggles_arm.png" alt="program_track_toggles_arm.png" />  (<em>Shift click on the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">arm track</a> button to <code><b>single</b></code> activate a track.</em>)
</li>
<li> On the <a class="twikiLink" href="../../view/Cinelerra/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>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<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 </td><td bgcolor="#FFFFCC"> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask2.png" alt="compositor_mask2.png" /> <br>  Finished mask </td></tr>
</table>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<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>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<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>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
After finishing 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.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
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.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<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>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<img src="../../../pub/TWiki/TWikiDocGraphics/help.gif" border="0" alt="HELP" width="16" height="16" /> Mask editing in Cinelerra is identical to how The Gimp edits masks except in this case the effect of the mask is always on.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<img src="../../../pub/TWiki/TWikiDocGraphics/help.gif" border="0" alt="HELP" width="16" height="16" /> Mask editing in Cinelerra is identical to how <span class="twikiNewLink" style="background : #FFFFCE;"><font color="#0000FF">The Gimp</font><a href="http://www.ftconsult.com/twiki/bin/edit/Cinelerra/Httpwwwgimporg?topicparent=Cinelerra.CompositingMask"><sup>?</sup></a></span> edits masks except in this case the effect of the mask is always on.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
<p />
<h3><a name="The_Mask_Options_Window"> </a> The Mask Options Window </h3>
</td></tr>
<tr bgcolor="#eeeeee" class="twikiDiffLineNumberHeader"><th align="left" colspan="9">Line: 48 to 49</th></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<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>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<ul>
<li> <code><b>Delete=</b></code> Deletes the <code><b>active point= on the current mask <br> <img src="../../../pub/TWiki/TWikiDocGraphics/warning.gif" border="0" alt="ALERT!" width="16" height="16" /> <em>The ==active point</b></code> is defined as the last point dragged in the compositor window. Any point can be activated by ctrl-clicking it</em>
</li>
</ul>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<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>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<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>
</td></tr>

</table></div><div class="twikiSearchResults"><div class="twikiSearchResultsHeader">&nbsp;<tt><b>&lt;&lt;O&gt;&gt;</b></tt>&nbsp; Difference Topic
		<b><a href="../../view/Cinelerra/CompositingMask">CompositingMask</a></b>
		(<a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=r1.7">r1.7</a> - 21&nbsp;Jan&nbsp;2004 - <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a>)</div>
<table class="twikiDiffTable" width="100%" cellspacing="0">
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<table border="1" cellspacing="1" cellpadding="0">
<tr><th class="twikiFirstCol" bgcolor="#99CCCC"> <strong>META TOPICPARENT</strong> </th><td colspan="2" bgcolor="#FFFFCC"> <a class="twikiLink" href="../../view/Cinelerra/KeyFrame">KeyFrame</a> </td></tr>
</table>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<table border="1" cellspacing="1" cellpadding="0">
<tr><th class="twikiFirstCol" bgcolor="#99CCCC"> <strong>META TOPICPARENT</strong> </th><td colspan="2" bgcolor="#FFFFCC"> Compositing </td></tr>
</table>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<h2><a name="Compositing_Masks"> </a><a name="_Compositing_Masks_"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> <a class="twikiLink" href="../../view/Cinelerra/CompositingMask">Compositing Masks</a> </h2>
In Cinelerra, the <a class="twikiLink" href="../../view/Cinelerra/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>)  
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
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" /> For more examples look at the Tutorial section. 
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
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" /> For more examples look at the <a class="twikiLink" href="../../view/Cinelerra/MaskEffectsTutorial">MaskEffectsTutorial</a> section. 
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
<h3><a name="Working_with_masks_on_the_Compos"> </a> Working with masks on the <a class="twikiLink" href="../../view/Cinelerra/Compositor">Compositor</a> window </h3>
</td></tr>

</table></div><div class="twikiSearchResults"><div class="twikiSearchResultsHeader">&nbsp;<tt><b>&lt;&lt;O&gt;&gt;</b></tt>&nbsp; Difference Topic
		<b><a href="../../view/Cinelerra/CompositingMask">CompositingMask</a></b>
		(<a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=r1.6">r1.6</a> - 21&nbsp;Jan&nbsp;2004 - <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a>)</div>
<table class="twikiDiffTable" width="100%" cellspacing="0">
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<table border="1" cellspacing="1" cellpadding="0">
<tr><th class="twikiFirstCol" bgcolor="#99CCCC"> <strong>META TOPICPARENT</strong> </th><td colspan="2" bgcolor="#FFFFCC"> <a class="twikiLink" href="../../view/Cinelerra/KeyFrame">KeyFrame</a> </td></tr>
</table>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<h2><a name="Compositing_Masks_Edit_Mask"> </a><a name="_Compositing_Masks_Edit_Mask_"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> <a class="twikiLink" href="../../view/Cinelerra/CompositingMask">Edit Mask</a> </h2>
In Cinelerra masks select a user defined region of a video track for displaying or hiding on the compositing pipeline.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<h2><a name="Compositing_Masks"> </a><a name="_Compositing_Masks_"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> <a class="twikiLink" href="../../view/Cinelerra/CompositingMask">Compositing Masks</a> </h2>
In Cinelerra, the <a class="twikiLink" href="../../view/Cinelerra/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. 
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffAddedHeader" colspan ="9"><b> Added:   </b>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
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>)  
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<p />
Using masks color corrections can be applied to just a section of the color corrected track while the vanilla track shows through. Removal of boom microphones, airplanes, and housewives are other mask uses.
<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 />
Our compositing pipeline graph now has a masking stage. 
<p />
<ul>
<li> There are 8 possible masks per track. 
</li>
<li> Each mask is defined separately, although they each perform the same operation, whether it's addition or subtraction.
</li>
<li> Each track can have up to 8 separate masks.
</li>
</ul>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
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" /> For more examples look at the Tutorial section. 
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
<h3><a name="Working_with_masks_on_the_Compos"> </a> Working with masks on the <a class="twikiLink" href="../../view/Cinelerra/Compositor">Compositor</a> window </h3>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<h4><a name="Define_a_mask"> </a><a name="Define_a_mask_"> </a> Define a mask : </h4>
<ul>
<li> Using the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">PatchBay</a> on the <a class="twikiLink" href="../../view/Cinelerra/MainProgram">MainProgram</a> to <code><b>arm</b></code> a single video track where to define our mask.<br> <img src="http://www.ftconsult.com/twiki/pub/Cinelerra/TrackControls/program_track_toggles_arm.png" alt="program_track_toggles_arm.png" />  (<em>Shift click on the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">arm track</a> button to <code><b>single</b></code> activate the track.</em>)
</li>
<li> Go to the <a class="twikiLink" href="../../view/Cinelerra/Compositor">Compositor</a> window and click on the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> button to enter <code><b>mask</b></code> mode. 
</li>
<li> Click a point on the video to set the first point of the mask, then Click-drag to the next 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> selected mask points </td><td bgcolor="#FFFFCC"> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask2.png" alt="compositor_mask2.png" /> <br> finished mask </td></tr>
</table>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<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="../../view/Cinelerra/PatchBay">PatchBay</a> on the <a class="twikiLink" href="../../view/Cinelerra/MainProgram">MainProgram</a>, <code><b>arm</b></code> a single video track. <br> <img src="http://www.ftconsult.com/twiki/pub/Cinelerra/TrackControls/program_track_toggles_arm.png" alt="program_track_toggles_arm.png" />  (<em>Shift click on the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">arm track</a> button to <code><b>single</b></code> activate a track.</em>)
</li>
<li> On the <a class="twikiLink" href="../../view/Cinelerra/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 </td><td bgcolor="#FFFFCC"> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask2.png" alt="compositor_mask2.png" /> <br>  Finished mask </td></tr>
</table>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<ul>
<li> When finished, the mask hides the selected area form the output. 
</li>
</ul>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<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>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
<h4><a name="Changing_a_mask"> </a><a name="Changing_a_mask_"> </a> Changing a mask: </h4>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
After you are finished defining a mask, you might need to change or adjust the mask to get a better fit on the object you are trying to mask or to follow along with changes on the video. For this purpose there special mouse-key controls.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
After finishing 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.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<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, altering the shape of the mask.
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask_belzier.png" alt="compositor_mask_belzier.png" /> <br> <code><b>Shift-drag</b></code> show <code><b>belzier</b></code> handles to create soft curves between points.
</li>
</ul>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<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>
</ul>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<ul>
<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 The Gimp edits masks except in this case the effect of the mask is always on.
</td></tr>
<tr><td bgcolor="#FFD7D7" class="twikiDiffDeletedHeader" colspan ="9"><b> Deleted: </b>
</td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<h4><a name="The_Mask_Options_Window"> </a> The Mask Options Window </h4>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<img src="../../../pub/TWiki/TWikiDocGraphics/warning.gif" border="0" alt="ALERT!" width="16" height="16" /> The active point is defined as the last point dragged in the compositor window. Any point can be activated merely by ctrl-clicking near it without moving the pointer.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<h3><a name="The_Mask_Options_Window"> </a> The Mask Options Window </h3>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
Selecting the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_info.png" alt="button_compositor_info.png" /> question mark when the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> mask toggle is highlighted brings up the mask options window.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
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="../../view/Cinelerra/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:
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
<img src="../../../pub/Cinelerra/CinelerraImages/mask_dialog.png" alt="mask_dialog.png" />
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<ul>
<li> <code><b>Mode</b></code> The mode of the mask determines if the mask removes data or makes data visible. 
<ul>
<li> If the mode is subtractive, the mask causes video to disappear. 
</li>
<li> If the mode is additive, the mask causes video to appear and everything outside the mask to disappear.
</li>
</ul>
</li>
<li> <code><b>Value</b></code> The value of the mask determines how extreme the addition or subtraction is. 
<ul>
<li> In the subtractive mode, higher values subtract more alpha. 
</li>
<li> In the additive mode, higher values make the region in the mask brighter while the region outside the mask is always hidden.
</li>
</ul>
</li>
</ul>
<p />
<ul>
<li> <code><b>Mask Number</b></code> The mask number determines which one of the 8 possible masks we're editing. 
<ul>
<li> Each track has 8 possible masks. When you click-drag in the compositor window, you're only editing one of the masks.
</li>
<li> Change the value of mask number to cause another mask to be edited. 
</li>
<li> The previous mask is still active but only the curve overlay for the currently selected mask is visible.
</li>
</ul>
</li>
</ul>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<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" /> 
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<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.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<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>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<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.
</li>
</ul>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<ul>
<li> <code><b>Delete=</b></code> Deletes the <code><b>active point= on the current mask <br> <img src="../../../pub/TWiki/TWikiDocGraphics/warning.gif" border="0" alt="ALERT!" width="16" height="16" /> <em>The ==active point</b></code> is defined as the last point dragged in the compositor window. Any point can be activated by ctrl-clicking it</em>
</li>
</ul>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<ul>
<li> <code><b>Delete=</b></code> Delete the active point on the current mask
</li>
<li> <code><b>X: &amp; Y:</b></code> Move the active point to the selected X Y coordinates  
</li>
</ul>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<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>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffAddedHeader" colspan ="9"><b> Added:   </b>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<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.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
-- <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a> - Jan 20 2004 <em>from <a class="twikiLink" href="../../view/Cinelerra/SecretsOfCinelerra">SecretsOfCinelerra</a></em>
<hr />
</td></tr>

</table></div><div class="twikiSearchResults"><div class="twikiSearchResultsHeader">&nbsp;<tt><b>&lt;&lt;O&gt;&gt;</b></tt>&nbsp; Difference Topic
		<b><a href="../../view/Cinelerra/CompositingMask">CompositingMask</a></b>
		(<a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=r1.5">r1.5</a> - 21&nbsp;Jan&nbsp;2004 - <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a>)</div>
<table class="twikiDiffTable" width="100%" cellspacing="0">
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<table border="1" cellspacing="1" cellpadding="0">
<tr><th class="twikiFirstCol" bgcolor="#99CCCC"> <strong>META TOPICPARENT</strong> </th><td colspan="2" bgcolor="#FFFFCC"> <a class="twikiLink" href="../../view/Cinelerra/KeyFrame">KeyFrame</a> </td></tr>
</table>
<h2><a name="Compositing_Masks_Edit_Mask"> </a><a name="_Compositing_Masks_Edit_Mask_"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> <a class="twikiLink" href="../../view/Cinelerra/CompositingMask">Edit Mask</a> </h2>
In Cinelerra masks select a user defined region of a video track for displaying or hiding on the compositing pipeline.
</td></tr>
<tr bgcolor="#eeeeee" class="twikiDiffLineNumberHeader"><th align="left" colspan="9">Line: 18 to 18</th></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
<h3><a name="Working_with_masks_on_the_Compos"> </a> Working with masks on the <a class="twikiLink" href="../../view/Cinelerra/Compositor">Compositor</a> window </h3>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
To define a mask:
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<h4><a name="Define_a_mask"> </a><a name="Define_a_mask_"> </a> Define a mask : </h4>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<ul>
<li> Using the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">PatchBay</a> on the <a class="twikiLink" href="../../view/Cinelerra/MainProgram">MainProgram</a> to <code><b>arm</b></code> a single video track where to define our mask.<br> <img src="http://www.ftconsult.com/twiki/pub/Cinelerra/TrackControls/program_track_toggles_arm.png" alt="program_track_toggles_arm.png" />  (<em>Shift click on the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">arm track</a> button to <code><b>single</b></code> activate the track.</em>)
</li>
</ul>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<ul>
<li> Go to the <a class="twikiLink" href="../../view/Cinelerra/Compositor">Compositor</a> window and click on the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> button to enter <code><b>mask</b></code> mode. (<em>it highlights in red</em>) <br> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_small.png" alt="compositor_small.png" />
</li>
<li> Click a point on the video to set the first point of the mask. ( <em>point #1 appears</em> ) 
</li>
<li> Click-drag to another point on the video. <br> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask1.png" alt="compositor_mask1.png" /> <br>(<em>new points connected by a hairline are displayed</em>) 
</li>
<li> Continue until you define a perimeter surrounding the area you wish to mask. <br> 
</li>
<li> You can <code><b>move</b></code> existing points by <code><b>Ctrl-dragging</b></code> them to new locations or create <code><b>belzier curves</b></code> by <code><b>Shift-dragging</b></code> points 
   <br> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask2.png" alt="compositor_mask2.png" /> ----- <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask_belzier.png" alt="compositor_mask_belzier.png" /> 
</li>
<li> The mask can be translated in one piece by <code><b>Ctrl-Alt-dragging</b></code> the mask. <img src="../../../pub/TWiki/TWikiDocGraphics/pencil.gif" border="0" alt="REFACTOR" width="16" height="16" />(<em>Ctrl Alt on my system</em>)
</li>
<li> When you are finished defining the masked area, the mask shows on the screen <br>
</li>
</ul>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<ul>
<li> Go to the <a class="twikiLink" href="../../view/Cinelerra/Compositor">Compositor</a> window and click on the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> button to enter <code><b>mask</b></code> mode. 
</li>
<li> Click a point on the video to set the first point of the mask, then Click-drag to the next 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> selected mask points </td><td bgcolor="#FFFFCC"> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask2.png" alt="compositor_mask2.png" /> <br> finished mask </td></tr>
</table>
<p />
<ul>
<li> When finished, the mask hides the selected area form the output. 
</li>
</ul>
<p />
<h4><a name="Changing_a_mask"> </a><a name="Changing_a_mask_"> </a> Changing a mask: </h4>
After you are finished defining a mask, you might need to change or adjust the mask to get a better fit on the object you are trying to mask or to follow along with changes on the video. For this purpose there special mouse-key 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, altering the shape of the mask.
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask_belzier.png" alt="compositor_mask_belzier.png" /> <br> <code><b>Shift-drag</b></code> show <code><b>belzier</b></code> handles to create soft curves between 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>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
<img src="../../../pub/TWiki/TWikiDocGraphics/help.gif" border="0" alt="HELP" width="16" height="16" /> Mask editing in Cinelerra is identical to how The Gimp edits masks except in this case the effect of the mask is always on.
</td></tr>

</table></div><div class="twikiSearchResults"><div class="twikiSearchResultsHeader">&nbsp;<tt><b>&lt;&lt;O&gt;&gt;</b></tt>&nbsp; Difference Topic
		<b><a href="../../view/Cinelerra/CompositingMask">CompositingMask</a></b>
		(<a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=r1.4">r1.4</a> - 20&nbsp;Jan&nbsp;2004 - <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a>)</div>
<table class="twikiDiffTable" width="100%" cellspacing="0">
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<table border="1" cellspacing="1" cellpadding="0">
<tr><th class="twikiFirstCol" bgcolor="#99CCCC"> <strong>META TOPICPARENT</strong> </th><td colspan="2" bgcolor="#FFFFCC"> <a class="twikiLink" href="../../view/Cinelerra/KeyFrame">KeyFrame</a> </td></tr>
</table>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<h3><a name="Compositing_Masks_Edit_Mask"> </a><a name="_Compositing_Masks_Edit_Mask_"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> <a class="twikiLink" href="../../view/Cinelerra/CompositingMask">Edit Mask</a> </h3>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<h2><a name="Compositing_Masks_Edit_Mask"> </a><a name="_Compositing_Masks_Edit_Mask_"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> <a class="twikiLink" href="../../view/Cinelerra/CompositingMask">Edit Mask</a> </h2>
In Cinelerra masks select a user defined region of a video track for displaying or hiding on the compositing pipeline.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#FFD7D7" class="twikiDiffDeletedHeader" colspan ="9"><b> Deleted: </b>
</td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
Masks select a region of the video for either displaying or hiding. Masks are also used in conjunction with another effect to isolate the effect to a certain region of the frame.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#FFD7D7" class="twikiDiffDeletedHeader" colspan ="9"><b> Deleted: </b>
</td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
A copy of one video track may be delayed slightly and unmasked in locations where the one copy has interference but the other copy doesn't.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
Color correction may be needed in one section of a frame but not another. 
<p />
A mask can be applied to just a section of the color corrected track while the vanilla track shows through. Removal of boom microphones, airplanes, and housewives are other mask uses.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
Using masks color corrections can be applied to just a section of the color corrected track while the vanilla track shows through. Removal of boom microphones, airplanes, and housewives are other mask uses.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<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.
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
Our compositing pipeline graph now has a masking stage. There are 8 possible masks per track. Each mask is defined separately, although they each perform the same operation, whether it's addition or subtraction.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
Our compositing pipeline graph now has a masking stage. 
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
compositing_pipeline2.png
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<ul>
<li> There are 8 possible masks per track. 
</li>
<li> Each mask is defined separately, although they each perform the same operation, whether it's addition or subtraction.
</li>
<li> Each track can have up to 8 separate masks.
</li>
</ul>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
Compositing pipeline with masks
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<h3><a name="Working_with_masks_on_the_Compos"> </a> Working with masks on the <a class="twikiLink" href="../../view/Cinelerra/Compositor">Compositor</a> window </h3>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
To define a mask:
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<ul>
<li> In the Compositor window, enable the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> mask toggle.
</li>
<li> Go over the video and click-drag. 
</li>
<li> Click-drag again in another part of the image to create each new point of the mask.
</li>
</ul>
<p />
While it isn't the conventional bezier curve behavior, this masking interface performs in realtime what the effect of the mask is going to be. Creating each point of the mask expands a rubber band curve.
<p />
Once points are defined:
<ul>
<li> they can be moved by ctrl-dragging in the vicinity of the corner. This; however, doesn't smooth out the curve. 
</li>
<li> The in-out points of the bezier curve are accessed by shift-dragging in the vicinity of the corner. 
</li>
<li> Then shift-dragging near the in or out point causes the point to move.
</li>
</ul>
<p />
Finally, once you have a mask:
<ul>
<li> the mask can be translated in one piece by alt-dragging the mask. <img src="../../../pub/TWiki/TWikiDocGraphics/pencil.gif" border="0" alt="REFACTOR" width="16" height="16" />(<em>I can;t get this to work.</em>)
</li>
</ul>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<ul>
<li> Using the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">PatchBay</a> on the <a class="twikiLink" href="../../view/Cinelerra/MainProgram">MainProgram</a> to <code><b>arm</b></code> a single video track where to define our mask.<br> <img src="http://www.ftconsult.com/twiki/pub/Cinelerra/TrackControls/program_track_toggles_arm.png" alt="program_track_toggles_arm.png" />  (<em>Shift click on the <a class="twikiLink" href="../../view/Cinelerra/PatchBay">arm track</a> button to <code><b>single</b></code> activate the track.</em>)
</li>
<li> Go to the <a class="twikiLink" href="../../view/Cinelerra/Compositor">Compositor</a> window and click on the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> button to enter <code><b>mask</b></code> mode. (<em>it highlights in red</em>) <br> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_small.png" alt="compositor_small.png" />
</li>
<li> Click a point on the video to set the first point of the mask. ( <em>point #1 appears</em> ) 
</li>
<li> Click-drag to another point on the video. <br> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask1.png" alt="compositor_mask1.png" /> <br>(<em>new points connected by a hairline are displayed</em>) 
</li>
<li> Continue until you define a perimeter surrounding the area you wish to mask. <br> 
</li>
<li> You can <code><b>move</b></code> existing points by <code><b>Ctrl-dragging</b></code> them to new locations or create <code><b>belzier curves</b></code> by <code><b>Shift-dragging</b></code> points 
   <br> <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask2.png" alt="compositor_mask2.png" /> ----- <img src="../../../pub/Cinelerra/CinelerraImages/compositor_mask_belzier.png" alt="compositor_mask_belzier.png" /> 
</li>
<li> The mask can be translated in one piece by <code><b>Ctrl-Alt-dragging</b></code> the mask. <img src="../../../pub/TWiki/TWikiDocGraphics/pencil.gif" border="0" alt="REFACTOR" width="16" height="16" />(<em>Ctrl Alt on my system</em>)
</li>
<li> When you are finished defining the masked area, the mask shows on the screen <br>
</li>
</ul>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
<img src="../../../pub/TWiki/TWikiDocGraphics/help.gif" border="0" alt="HELP" width="16" height="16" /> Mask editing in Cinelerra is identical to how The Gimp edits masks except in this case the effect of the mask is always on.
</td></tr>
<tr><td bgcolor="#FFD7D7" class="twikiDiffDeletedHeader" colspan ="9"><b> Deleted: </b>
</td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<img src="../../../pub/TWiki/TWikiDocGraphics/warning.gif" border="0" alt="ALERT!" width="16" height="16" /> The active point is defined as the last point dragged in the compositor window. Any point can be activated merely by ctrl-clicking near it without moving the pointer.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<h4><a name="The_Mask_Options_Window"> </a> The Mask Options Window </h4>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffAddedHeader" colspan ="9"><b> Added:   </b>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<img src="../../../pub/TWiki/TWikiDocGraphics/warning.gif" border="0" alt="ALERT!" width="16" height="16" /> The active point is defined as the last point dragged in the compositor window. Any point can be activated merely by ctrl-clicking near it without moving the pointer.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
Selecting the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_info.png" alt="button_compositor_info.png" /> question mark when the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> mask toggle is highlighted brings up the mask options window.
<p />
<img src="../../../pub/Cinelerra/CinelerraImages/mask_dialog.png" alt="mask_dialog.png" />
</td></tr>

</table></div><div class="twikiSearchResults"><div class="twikiSearchResultsHeader">&nbsp;<tt><b>&lt;&lt;O&gt;&gt;</b></tt>&nbsp; Difference Topic
		<b><a href="../../view/Cinelerra/CompositingMask">CompositingMask</a></b>
		(<a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=r1.3">r1.3</a> - 20&nbsp;Jan&nbsp;2004 - <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a>)</div>
<table class="twikiDiffTable" width="100%" cellspacing="0">
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<table border="1" cellspacing="1" cellpadding="0">
<tr><th class="twikiFirstCol" bgcolor="#99CCCC"> <strong>META TOPICPARENT</strong> </th><td colspan="2" bgcolor="#FFFFCC"> <a class="twikiLink" href="../../view/Cinelerra/KeyFrame">KeyFrame</a> </td></tr>
</table>
<h3><a name="Compositing_Masks_Edit_Mask"> </a><a name="_Compositing_Masks_Edit_Mask_"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> <a class="twikiLink" href="../../view/Cinelerra/CompositingMask">Edit Mask</a> </h3>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
Masks select a region of the video for either displaying or hiding. Masks are also used in conjunction with another effect to isolate the effect to a certain region of the frame. A copy of one video track may be delayed slightly and unmasked in locations where the one copy has interference but the other copy doesn't. Color correction may be needed in one section of a frame but not another. A mask can be applied to just a section of the color corrected track while the vanilla track shows through. Removal of boom microphones, airplanes, and housewives are other mask uses.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
Masks select a region of the video for either displaying or hiding. Masks are also used in conjunction with another effect to isolate the effect to a certain region of the frame.
<p />
A copy of one video track may be delayed slightly and unmasked in locations where the one copy has interference but the other copy doesn't.
<p />
Color correction may be needed in one section of a frame but not another. 
<p />
A mask can be applied to just a section of the color corrected track while the vanilla track shows through. Removal of boom microphones, airplanes, and housewives are other mask uses.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<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.
</td></tr>
<tr bgcolor="#eeeeee" class="twikiDiffLineNumberHeader"><th align="left" colspan="9">Line: 14 to 20</th></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
Compositing pipeline with masks
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
To define a mask, go into the Compositor window and enable the mask.png mask toggle. Now go over the video and click-drag. Click-drag again in another part of the image to create each new point of the mask. While it isn't the conventional bezier curve behavior, this masking interface performs in realtime what the effect of the mask is going to be. Creating each point of the mask expands a rubber band curve.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
To define a mask:
<ul>
<li> In the Compositor window, enable the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> mask toggle.
</li>
<li> Go over the video and click-drag. 
</li>
<li> Click-drag again in another part of the image to create each new point of the mask.
</li>
</ul>
<p />
While it isn't the conventional bezier curve behavior, this masking interface performs in realtime what the effect of the mask is going to be. Creating each point of the mask expands a rubber band curve.
<p />
Once points are defined:
<ul>
<li> they can be moved by ctrl-dragging in the vicinity of the corner. This; however, doesn't smooth out the curve. 
</li>
<li> The in-out points of the bezier curve are accessed by shift-dragging in the vicinity of the corner. 
</li>
<li> Then shift-dragging near the in or out point causes the point to move.
</li>
</ul>
<p />
Finally, once you have a mask:
<ul>
<li> the mask can be translated in one piece by alt-dragging the mask. <img src="../../../pub/TWiki/TWikiDocGraphics/pencil.gif" border="0" alt="REFACTOR" width="16" height="16" />(<em>I can;t get this to work.</em>)
</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 The Gimp edits masks except in this case the effect of the mask is always on.
<p />
<img src="../../../pub/TWiki/TWikiDocGraphics/warning.gif" border="0" alt="ALERT!" width="16" height="16" /> The active point is defined as the last point dragged in the compositor window. Any point can be activated merely by ctrl-clicking near it without moving the pointer.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
Once points are defined, they can be moved by ctrl-dragging in the vicinity of the corner. This; however, doesn't smooth out the curve. The in-out points of the bezier curve are accessed by shift-dragging in the vicinity of the corner. Then shift-dragging near the in or out point causes the point to move.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<h4><a name="The_Mask_Options_Window"> </a> The Mask Options Window </h4>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
Finally, once you have a mask, the mask can be translated in one piece by alt-dragging the mask. Mask editing in Cinelerra is identical to how The Gimp edits masks except in this case the effect of the mask is always on.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
Selecting the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_info.png" alt="button_compositor_info.png" /> question mark when the <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> mask toggle is highlighted brings up the mask options window.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
The masks have many more parameters which couldn't be represented with video overlays. These are represented in the tool window for masks. Selecting the toolwindow.png question mark when the mask.png mask toggle is highlighted brings up the mask options.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<img src="../../../pub/Cinelerra/CinelerraImages/mask_dialog.png" alt="mask_dialog.png" />
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
The mode of the mask determines if the mask removes data or makes data visible. If the mode is subtractive, the mask causes video to disappear. If the mode is additive, the mask causes video to appear and everything outside the mask to disappear.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<ul>
<li> <code><b>Mode</b></code> The mode of the mask determines if the mask removes data or makes data visible. 
<ul>
<li> If the mode is subtractive, the mask causes video to disappear. 
</li>
<li> If the mode is additive, the mask causes video to appear and everything outside the mask to disappear.
</li>
</ul>
</li>
<li> <code><b>Value</b></code> The value of the mask determines how extreme the addition or subtraction is. 
<ul>
<li> In the subtractive mode, higher values subtract more alpha. 
</li>
<li> In the additive mode, higher values make the region in the mask brighter while the region outside the mask is always hidden.
</li>
</ul>
</li>
</ul>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
The value of the mask determines how extreme the addition or subtraction is. In the subtractive mode, higher values subtract more alpha. In the additive mode, higher values make the region in the mask brighter while the region outside the mask is always hidden.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<ul>
<li> <code><b>Mask Number</b></code> The mask number determines which one of the 8 possible masks we're editing. 
<ul>
<li> Each track has 8 possible masks. When you click-drag in the compositor window, you're only editing one of the masks.
</li>
<li> Change the value of mask number to cause another mask to be edited. 
</li>
<li> The previous mask is still active but only the curve overlay for the currently selected mask is visible.
</li>
</ul>
</li>
</ul>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
The mask number determines which one of the 8 possible masks we're editing. Each track has 8 possible masks. When you click-drag in the compositor window, you're only editing one of the masks. Change the value of mask number to cause another mask to be edited. The previous mask is still active but only the curve overlay for the currently selected mask is visible.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<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.
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
When multiple masks are used, their effects are ORed together. Every mask in a single track uses the same value and mode.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<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.
</li>
</ul>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
The edges of a mask are hard by default but this rarely is desired. The feather parameter determines how many pixels to feather the mask. This creates softer edges but takes longer to render.
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<ul>
<li> <code><b>Delete=</b></code> Delete the active point on the current mask
</li>
<li> <code><b>X: &amp; Y:</b></code> Move the active point to the selected X Y coordinates  
</li>
</ul>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#FFD7D7" class="twikiDiffDeletedHeader" colspan ="9"><b> Deleted: </b>
</td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
Finally, there are parameters which affect one point on the current mask instead of the whole mask. These are Delete, x, y. The active point is defined as the last point dragged in the compositor window. Any point can be activated merely by ctrl-clicking near it without moving the pointer. Once a point is activated, Delete deletes it and x, y allow repositioning by numeric entry. 
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">

</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
-- <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a> - 21 Dec 2003 from <a class="twikiLink" href="../../view/Cinelerra/SecretsOfCinelerra">SecretsOfCinelerra</a>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
-- <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a> - Jan 20 2004 <em>from <a class="twikiLink" href="../../view/Cinelerra/SecretsOfCinelerra">SecretsOfCinelerra</a></em>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<hr />
</td></tr>

</table></div><div class="twikiSearchResults"><div class="twikiSearchResultsHeader">&nbsp;<tt><b>&lt;&lt;O&gt;&gt;</b></tt>&nbsp; Difference Topic
		<b><a href="../../view/Cinelerra/CompositingMask">CompositingMask</a></b>
		(<a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=r1.2">r1.2</a> - 18&nbsp;Jan&nbsp;2004 - <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a>)</div>
<table class="twikiDiffTable" width="100%" cellspacing="0">
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<table border="1" cellspacing="1" cellpadding="0">
<tr><th class="twikiFirstCol" bgcolor="#99CCCC"> <strong>META TOPICPARENT</strong> </th><td colspan="2" bgcolor="#FFFFCC"> <a class="twikiLink" href="../../view/Cinelerra/KeyFrame">KeyFrame</a> </td></tr>
</table>
</td></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffChangedHeader" colspan ="9"><b> Changed: </b></td></tr>
<tr><td bgcolor="#ff9999" class="twikiDiffDeletedMarker" valign="top" width="1%">&lt;<br />&lt;</td>
<td class="twikiDiffDeletedText">
<h3><a name="Compositing_Masks"> </a><a name="_Compositing_Masks_"> </a> <a class="twikiLink" href="../../view/Cinelerra/CompositingMask">Compositing Masks</a> </h3>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<h3><a name="Compositing_Masks_Edit_Mask"> </a><a name="_Compositing_Masks_Edit_Mask_"> </a> <img src="../../../pub/Cinelerra/CinelerraImages/button_compositor_mask.png" alt="button_compositor_mask.png" /> <a class="twikiLink" href="../../view/Cinelerra/CompositingMask">Edit Mask</a> </h3>
</td></tr>
<tr><td valign="top" bgcolor="#ffffff" class="twikiDiffUnchangedText" width="1%"><br /></td>
<td class="twikiDiffUnchangedText">
<p />
Masks select a region of the video for either displaying or hiding. Masks are also used in conjunction with another effect to isolate the effect to a certain region of the frame. A copy of one video track may be delayed slightly and unmasked in locations where the one copy has interference but the other copy doesn't. Color correction may be needed in one section of a frame but not another. A mask can be applied to just a section of the color corrected track while the vanilla track shows through. Removal of boom microphones, airplanes, and housewives are other mask uses.
</td></tr>

</table></div><div class="twikiSearchResults"><div class="twikiSearchResultsHeader">&nbsp;<tt><b>&lt;&lt;O&gt;&gt;</b></tt>&nbsp; Difference Topic
		<b><a href="../../view/Cinelerra/CompositingMask">CompositingMask</a></b>
		(<a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=r1.1">r1.1</a> - 21&nbsp;Dec&nbsp;2003 - <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a>)</div>
<table class="twikiDiffTable" width="100%" cellspacing="0">
<tr bgcolor="#eeeeee" class="twikiDiffLineNumberHeader"><th align="left" colspan="9">Line: 1 to 1</th></tr>
<tr><td bgcolor="#D0FFD0" class="twikiDiffAddedHeader" colspan ="9"><b> Added:   </b>
</td></tr>
<tr><td bgcolor="#ccccff" class="twikiDiffAddedMarker" valign="top" width="1%">&gt;<br />&gt;</td>
<td class="twikiDiffAddedText">
<table border="1" cellspacing="1" cellpadding="0">
<tr><th class="twikiFirstCol" bgcolor="#99CCCC"> <strong>META TOPICPARENT</strong> </th><td colspan="2" bgcolor="#FFFFCC"> <a class="twikiLink" href="../../view/Cinelerra/KeyFrame">KeyFrame</a> </td></tr>
</table>
<h3><a name="Compositing_Masks"> </a><a name="_Compositing_Masks_"> </a> <a class="twikiLink" href="../../view/Cinelerra/CompositingMask">Compositing Masks</a> </h3>
<p />
Masks select a region of the video for either displaying or hiding. Masks are also used in conjunction with another effect to isolate the effect to a certain region of the frame. A copy of one video track may be delayed slightly and unmasked in locations where the one copy has interference but the other copy doesn't. Color correction may be needed in one section of a frame but not another. A mask can be applied to just a section of the color corrected track while the vanilla track shows through. Removal of boom microphones, airplanes, and housewives are other mask uses.
<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 />
Our compositing pipeline graph now has a masking stage. There are 8 possible masks per track. Each mask is defined separately, although they each perform the same operation, whether it's addition or subtraction.
<p />
<p />
compositing_pipeline2.png
<p />
<p />
Compositing pipeline with masks
<p />
To define a mask, go into the Compositor window and enable the mask.png mask toggle. Now go over the video and click-drag. Click-drag again in another part of the image to create each new point of the mask. While it isn't the conventional bezier curve behavior, this masking interface performs in realtime what the effect of the mask is going to be. Creating each point of the mask expands a rubber band curve.
<p />
Once points are defined, they can be moved by ctrl-dragging in the vicinity of the corner. This; however, doesn't smooth out the curve. The in-out points of the bezier curve are accessed by shift-dragging in the vicinity of the corner. Then shift-dragging near the in or out point causes the point to move.
<p />
Finally, once you have a mask, the mask can be translated in one piece by alt-dragging the mask. Mask editing in Cinelerra is identical to how The Gimp edits masks except in this case the effect of the mask is always on.
<p />
The masks have many more parameters which couldn't be represented with video overlays. These are represented in the tool window for masks. Selecting the toolwindow.png question mark when the mask.png mask toggle is highlighted brings up the mask options.
<p />
The mode of the mask determines if the mask removes data or makes data visible. If the mode is subtractive, the mask causes video to disappear. If the mode is additive, the mask causes video to appear and everything outside the mask to disappear.
<p />
The value of the mask determines how extreme the addition or subtraction is. In the subtractive mode, higher values subtract more alpha. In the additive mode, higher values make the region in the mask brighter while the region outside the mask is always hidden.
<p />
The mask number determines which one of the 8 possible masks we're editing. Each track has 8 possible masks. When you click-drag in the compositor window, you're only editing one of the masks. Change the value of mask number to cause another mask to be edited. The previous mask is still active but only the curve overlay for the currently selected mask is visible.
<p />
When multiple masks are used, their effects are ORed together. Every mask in a single track uses the same value and mode.
<p />
The edges of a mask are hard by default but this rarely is desired. The feather parameter determines how many pixels to feather the mask. This creates softer edges but takes longer to render.
<p />
Finally, there are parameters which affect one point on the current mask instead of the whole mask. These are Delete, x, y. The active point is defined as the last point dragged in the compositor window. Any point can be activated merely by ctrl-clicking near it without moving the pointer. Once a point is activated, Delete deletes it and x, y allow repositioning by numeric entry. 
<p />
-- <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a> - 21 Dec 2003 from <a class="twikiLink" href="../../view/Cinelerra/SecretsOfCinelerra">SecretsOfCinelerra</a>
<hr />
</td></tr>

</table></div><div class="twikiTopicAction"><a href="../../view/Cinelerra/CompositingMask">View topic</a>
 <span class="twikiSeparator">|</span> <a href="CompositingMask">Diffs</a>  | <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/CompositingMask?rev=1.12">r1.12</a> | <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="http://www.ftconsult.com/twiki/bin/oops/Cinelerra/CompositingMask?template=oopsmore&param1=1.12&param2=1.12">More</a>
</div><div class="twikiTopicInfo"><span class="twikiRevInfo twikiGrayText">Revision r1.1 - 21 Dec 2003 - 20:12 - <a class="twikiLink" href="../../view/Main/AlexFerrer">AlexFerrer</a><br />
Revision r1.12 - 11 Nov 2004 - 18:25 - <a class="twikiLink" href="../../view/Main/ArthurSosa">ArthurSosa</a></span></div>
<div class="twikiTopicFooter"></div>
<a name="PageBottom"></a> </div></div>
</body></html>