<!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>  LabelControl &lt; Cinelerra &lt; TWiki</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />

<link rel="alternate" type="application/rss+xml" title="RSS Feed" href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/WebRss?skin=rss&contenttype=text/xml" />
<!-- <base href="LabelControl" /> -->
<style type="text/css" media="all">
	/* Default TWiki layout */
	@import url('../../../pub/TWiki/PatternSkin/layout.css');
	/* Default TWiki style */
	@import url('../../../pub/TWiki/PatternSkin/style.css');
	/* Custom overriding layout per web or per topic */
	@import url('http://www.ftconsult.com/twiki/bin/view/Cinelerra/%USERLAYOUTURL%');
	/* Custom overriding style per web or per topic */
	@import url('http://www.ftconsult.com/twiki/bin/view/Cinelerra/%USERSTYLEURL%');
	.twikiToc li {
		list-style-image:url('../../../pub/TWiki/PatternSkin/i_arrow_down.gif');
	}	        
	.twikiWebIndicator {
		background-color:#D0D0D0;
	}
</style>
<style type="text/css" media="all"></style>
<script type="text/javascript">
<!-- HIDE
	function initPage() { }
-->
</script>
</head>
<body class="twikiViewPage" onload="initPage()"><a name="PageTop"></a>
<div class="twikiHidden"><a href="#Content">Skip to topic</a> | <a href="#PageBottom">Skip to bottom</a><hr /></div><div class="twikiTopBar"><div class="twikiTopBarContents"><form name="top" action="LabelControl"> <div class="twikiLeft">
<a href="http://twiki.org/"><img src="../../../pub/TWiki/TWikiLogos/twikiRobot46x50.gif" border="0" alt="Home"/></a>
</div>
<div class="twikiRight twikiSearchBox">
<table border="0" cellpadding="0" cellspacing="0">
<tr>
<td><label for="go">Jump: </label><input type="text" id="go" name="topic" size="16" /></td>
</tr>
</table>
</div>
</form></div></div><div class="twikiMiddleContainer"><div class="twikiLeftBar"><div class="twikiWebIndicator"><b>Cinelerra</b></div>
<div class="twikiLeftBarContents"><form name="main" action="LabelControl"> 
<ul>
<li> <b>Cinelerra Web</b>
</li>
<li> <a class="twikiLink" href="WebHome">Cinelerra Web Home</a>
</li>
<li> <a class="twikiLink" href="WebChanges">Changes</a> 
</li>
<li> <a class="twikiLink" href="WebIndex">Index</a>
</li>
<li> <a class="twikiLink" href="WebSearch">Search</a>
</li>
</ul>
<hr />
<ul>
<li> <strong>Webs</strong>
<ul>
<li> <a class="twikiLink" href="WebHome">Cinelerra</a>
</li>
<li> <a class="twikiLink" href="../Espanol/WebHome">Espanol</a>
</li>
<li> <a class="twikiLink" href="../Francais/WebHome">Francais</a>
</li>
<li> <a class="twikiLink" href="../Italiano/WebHome">Italiano</a>
</li>
<li> <a class="twikiLink" href="../Main/WebHome">Main</a>
</li>
<li> <a class="twikiLink" href="../Sandbox/WebHome">Sandbox</a>
</li>
<li> <a class="twikiLink" href="../Slovenian/WebHome">Slovenian</a>
</li>
<li> <a class="twikiLink" href="../TWiki/WebHome">TWiki</a>
</li>
</ul>
</li>
</ul>
<div class="twikiLeftBarPersonal">
<p />
<ul>
<li> <strong>My links</strong>
</li>
<li> <a class="twikiLink" href="../Main/AeliotBoswell">My home page</a>
</li>
<li> <a href="http://www.ftconsult.com/twiki/bin/search/Codev/?search=InterestedParties.*AeliotBoswell&regex=on" target="_top"><img src="../../../pub/TWiki/TWikiDocGraphics/stargold.gif" style="width:16px; height:16px; border:0px;" alt="Show me topics of interest" /></a>
</li>
</ul>
<div class="twikiSmall"><a href="http://www.ftconsult.com/twiki/bin/edit/Main/TWikiGuestLeftBar?t=20051021145811">edit</a></div>
<p />
</div>
</form></div></div><div class="twikiMain"><div class="twikiToolBar"><div>
<ul>
<li> <a href="http://www.ftconsult.com/twiki/bin/edit/Cinelerra/LabelControl?t=1129906691"><b>Edit</b></a>
</li>
<li> <a href="http://www.ftconsult.com/twiki/bin/attach/Cinelerra/LabelControl">Attach</a>
</li>
<li> <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/LabelControl?skin=print.pattern">Printable</a>
</li>
</ul>
</div><div class="twikiRevInfo"><span class="twikiGrayText"><span class="twikiToolbarElem">Cinelerra.LabelControl</span><span class="twikiToolbarElem">r1.8 - 28 Mar 2005 - 11:38 - <a class="twikiLink" href="../Main/JarleBjo">JarleBjo</a></span><span class="twikiToolbarElem"><a href="#TopicEnd">topic&nbsp;end</a></span></span></div></div>
<div class="twikiHidden"><hr /></div><a name="Content"> </a><div class="twikiHidden">Start of topic | <a href="#Actions">Skip to actions</a><hr /></div>
<div class="twikiTopic">
<h3><a name="Label_controls"> </a><a name="_Label_controls_"> </a> <a class="twikiLink" href="LabelControl">Label controls</a> </h3>
Labels are an easy way to set exact locations on the timeline you want to jump to. 
<p />
<ul>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_set_label.png" alt="button_set_label.png" /> Set/un-set label
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_prev_label.png" alt="button_prev_label.png" /> Jump to previous label
</li>
<li> <img src="../../../pub/Cinelerra/CinelerraImages/button_next_label.png" alt="button_next_label.png" /> Jump to next label
</li>
</ul>
<p />
<h4><a name="Using_Labels_in_the_Main_Program"> </a> Using Labels in the <a class="twikiLink" href="MainProgram">Main Program</a> Window </h4>
When you position the insertion point somewhere and hit the <img src="../../../pub/Cinelerra/CinelerraImages/button_set_label.png" alt="button_set_label.png" /> <strong>set label button</strong> a new label appears on the timeline. (<strong><em>diplayed as a</em></strong> <strong><font color="#008000">V</font></strong> <strong><em>on the timeline</em></strong>)
<p />
<img src="../../../pub/Cinelerra/CinelerraImages/program_timebar_busy.png" alt="program_timebar_busy.png" /><br>
A timebar with a <strong><font color="#008000">labels</font></strong> &amp; in/out points on it
<p />
No matter what the zoom settings are, clicking on the label positions moves the <a class="twikiLink" href="InsertionPoint">InsertionPoint</a> exactly where you set it. Hitting the label button again when a label is selected deletes it.
<p />
<ul>
<li> <code><b>Shift-clicking</b></code> on a label extends the highlighted region.
</li>
<li> <code><b>Double-clicking</b></code> between two labels highlights the region between the labels.
</li>
<li> Hitting the <code><b>l</b></code> key has the same effect as the label button.
</li>
</ul>
<p />
<img src="../../../pub/TWiki/TWikiDocGraphics/tip.gif" border="0" alt="TIP" width="16" height="16" />If you hit the label button when a region is highlighted, two labels are toggled at each end of the highlighted region. ( <em>If one end already has a label, then the existing label is deleted and a label is created at the opposite end.</em> )
<p />
<p />
Labels can reposition the <a class="twikiLink" href="InsertionPoint">InsertionPoint</a> when they are selected but they can also be traversed with the <img src="../../../pub/Cinelerra/CinelerraImages/button_prev_label.png" alt="button_prev_label.png" /> <img src="../../../pub/Cinelerra/CinelerraImages/button_next_label.png" alt="button_next_label.png" /> <strong>label traversal buttons</strong>. When a label is out of view, the label traversal buttons reposition the timeline so the label is visible. 
<img src="../../../pub/TWiki/TWikiDocGraphics/tip.gif" border="0" alt="TIP" width="16" height="16" />There are <a class="twikiLink" href="KeyboardShortcuts">KeyboardShortcuts</a> for label traversal, too.
<p />
<ul>
<li> <code><b>CTRL-LEFT</b></code> repositions the insertion point on the previous label.
</li>
<li> <code><b>CTRL-RIGHT</b></code> repositions the insertion point on the next label.
</li>
</ul>
<p />
With label traversal you can quickly seek back and forth on the timeline but you can also select regions.
<p />
<ul>
<li> <code><b>SHIFT-CTRL-LEFT</b></code> extends the highlighted region to the previous label.
</li>
<li> <code><b>SHIFT-CTRL-RIGHT</b></code> extends the highlighted region to the next label. 
</li>
</ul>
<p />
<h4><a name="Deleting_all_labels"> </a> Deleting all labels  </h4>
Manually hitting the label button or l key over and over again to delete a series of labels can get tedious. For deleting a set of labels, first highlight a region and second use the Edit-&gt;Clear labels function. If in/out points exist, the labels between the in/out points are cleared and the highlighted region ignored. 
<p />
<h4><a name="Using_Labels_on_the_Viewer_Compo"> </a> Using Labels on the <a class="twikiLink" href="Viewer">Viewer</a> &amp; <a class="twikiLink" href="Compositor">Compositor</a> </h4>
Labels and in/out points are fully supported in the viewer and compositor. The only difference between the viewer and compositor is the compositor reflects the state of the program while the viewer reflects the state of a clip but not the program.
<p />
<img src="../../../pub/Cinelerra/CinelerraImages/timebar_busy.png" alt="timebar_busy.png" /><br>
<p />
<ul>
<li> When you hit the label button in the <a class="twikiLink" href="Compositor">compositor</a>, the label appears both in the <a class="twikiLink" href="Compositor">compositor</a> timebar and the program timebar.
</li>
</ul>
<p />
<ul>
<li> When you select a label or in/out point in the <a class="twikiLink" href="Compositor">compositor</a>, the program window jumps to that position.
</li>
</ul>
<p />
<p />
-- <a class="twikiLink" href="../Main/AlexFerrer">AlexFerrer</a> - 08 Jan 2004  
<hr />
<p />
I tried using labels in the main program window, to create reference points on the global timeline. I'm just very puzzled, by the behavior of cinelerra labels when i splice from the viewer into tracks in the main program window. When using splice , the labels are pushed as further out on the timeline as much as the lenghth of the splice. Is this intended behavior ..  ? I expected the labels to stay in position on the timeline ... 
<p />
-- <a class="twikiLink" href="../Main/JarleBjo">JarleBjo</a> - 27 Mar 2005
<p />
I found that I had to use "overwrite" rather than "splice" to make the labels stay in place when inserting from the viewer. (Two screen editing) ... Makes sense too, I guess ... <img src="../../../pub/TWiki/SmiliesPlugin/smile.gif" alt="smile" title="smile" border="0" />
<p />
-- <a class="twikiLink" href="../Main/JarleBjo">JarleBjo</a> - 28 Mar 2005
<br class="twikiClear" />
<a name="TopicEnd"></a>
<span class="twikiRight twikiPageNav twikiGrayText"><a href="#PageTop">to&nbsp;top</a></span><br class="twikiClear" />
</div><div class="twikiHidden"><hr />End of topic<br /><a href="#Actions">Skip to action links</a> | <a href="#PageTop">Back&nbsp;to&nbsp;top</a><hr /></div>
<!---->
<!---->
<a name="Actions"> </a><span class="twikiHidden"><br /></span><div class="twikiTopicAction"><a href="http://www.ftconsult.com/twiki/bin/edit/Cinelerra/LabelControl?t=1129906691"><b>Edit</b></a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/attach/Cinelerra/LabelControl">Attach image or document</a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/LabelControl?skin=print.pattern">Printable version</a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/LabelControl?raw=on">Raw text</a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/oops/Cinelerra/LabelControl?template=oopsmore&param1=1.8&param2=1.8">More topic actions</a><br />Revisions:  | r1.8 | <a href="http://www.ftconsult.com/twiki/bin/rdiff/Cinelerra/LabelControl?rev1=1.8&rev2=1.7">&gt;</a> | <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/LabelControl?rev=1.7">r1.7</a> | <a href="http://www.ftconsult.com/twiki/bin/rdiff/Cinelerra/LabelControl?rev1=1.7&rev2=1.6">&gt;</a> | <a href="http://www.ftconsult.com/twiki/bin/view/Cinelerra/LabelControl?rev=1.6">r1.6</a> <span class="twikiSeparator">|</span> <a href="../../rdiff/Cinelerra/LabelControl">Total page history</a> <span class="twikiSeparator">|</span> <a href="http://www.ftconsult.com/twiki/bin/search/Cinelerra/SearchResult?scope=text&regex=on&excludetopic=LabelControl&search=Label%20*Control%5B%5EA-Za-z0-9%5D">Backlinks</a></div>
<div class="twikiTopicInfo twikiRevInfo twikiGrayText twikiMoved"><i>Cinelerra.LabelControl moved from Cinelerra.LabelControls on 21 Dec 2003 - 19:52 by <a class="twikiLink" href="../Main/AlexFerrer">AlexFerrer</a> </i> - <a title="Click to move topic back to previous location, with option to change references." href="http://www.ftconsult.com/twiki/bin/rename/Cinelerra/LabelControl?newweb=Cinelerra&newtopic=LabelControls&confirm=on">put it back</a></div>
<div class="twikiTopicFooter"><span class="twikiLeft"><span class="twikiHomePath">You are here: <a class="twikiLink" href="WebHome">Cinelerra</a>  <span class='twikiSeparator'>&gt;</span> <a class="twikiLink" href="CinelerraManualTOC">CinelerraManualTOC</a> &gt; <a class="twikiLink" href="UnderstandingTheUI">UnderstandingTheUI</a> &gt; <a class="twikiLink" href="MainProgram">MainProgram</a> &gt; <a class="twikiLink" href="ProgramControlToolBar">ProgramControlToolBar</a> &gt; <a class="twikiLink" href="EditingControl">EditingControl</a> <span class='twikiSeparator'>&gt;</span> LabelControl </span></span><span class="twikiHidden"><br /><br /></span><span class="twikiRight twikiPageNav twikiGrayText"><a href="#PageTop">to&nbsp;top</a></span><br class="twikiClear" /><span class="twikiHidden"><br /></span></div>
<a name="PageBottom"></a> </div></div><div class="twikiBottomBar"><div class="twikiBottomBarContents"><span class="twikiGrayText">Copyright &copy; 1999-2005 by the contributing authors. 
All material on this collaboration platform is the property of the contributing authors. <br /> 
Ideas, requests, problems regarding TWiki? <a href="mailto:alex@ftconsult.com?subject=TWiki&#32;Feedback&#32;on&#32;TWiki.WebBottomBar">Send feedback</a>
</span></div></div>
</body></html>