<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:e="http://projectmallard.org/experimental/" type="topic" id="keyframecurves" xml:lang="de">
  <info>
    <link type="guide" xref="index#timeline"/>
    <link type="seealso" xref="usingeffects"/>
    <link type="seealso" xref="transitions"/>
    <revision pkgversion="0.96" version="0.3" date="2016-02-17" status="complete"/>
    <credit type="author">
      <name>Jean-François Fortin Tam</name>
      <email>nekohayo@gmail.com</email>
    </credit>
    <credit type="contributor">
      <name>Mario Blättermann</name>
      <email>mariobl@gnome.org</email>
    </credit>
    <credit type="contributor">
      <name>Tomáš Karger</name>
      <email>tomkarger@gmail.com</email>
    </credit>
    <credit type="contributor">
      <name>Alexandru Băluț</name>
      <email>alexandru.balut@gmail.com</email>
    </credit>
    <desc>
      Changing properties of a clip over time.
    </desc>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Mario Blättermann</mal:name>
      <mal:email>mariobl@freenet.de</mal:email>
      <mal:years>2010, 2011</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Marcel Tiede</mal:name>
      <mal:email>marcel.tiede@yahoo.de</mal:email>
      <mal:years>2014</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Benjamin Steinwender</mal:name>
      <mal:email>b@stbe.at</mal:email>
      <mal:years>2014</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Christian Kirbach</mal:name>
      <mal:email>christian.kirbach@gmail.com</mal:email>
      <mal:years>2014</mal:years>
    </mal:credit>
  </info>
  <title>Keyframe curves</title>
  <p>By using keyframe curves, you can change the value of a property over time, instead of having a fixed value for the entire duration of a clip. This can be used to change opacity or volume just as well as effect properties at any point in the clip's duration.</p>
  <figure>
    <title>Keyframe curves</title>
    <media type="image" src="figures/keyframecurves.png" mime="image/png" style="right"/>
  </figure>
  <p>A terminological note:</p>
  <list>
    <item>
      <p><em>Keyframes</em> are the points that are used to determine the property value at a specific point in time.</p>
    </item>
    <item>
      <p><em>Keyframe curves</em> are the lines connecting the points providing smooth transitions between them.</p>
    </item>
  </list>
  <p>By default, the keyframe curves on an audio clip control the volume (on a scale from 0 to 200%) and the keyframe curves on a video clip control the alpha (opacity) of the video (on a scale from 0 to 100%). See the <link xref="layers">Understanding layers</link> page for more details on opacity. The default alpha or volume keyframe curves are an intrinsic property of clips and cannot be removed.</p>
  <note style="tip">
    <p>You can create fade-in and fade-out transitions by controlling opacity and volume. See an example in the <link xref="transitions#fades">Transitions</link> page.</p>
  </note>
  <p>Besides volume and alpha, you can use keyframes to control effect properties. See the <link xref="usingeffects#keyframes">Using effects</link> page for details.</p>
  <section id="usage">
    <title>General usage</title>
    <p>The start and end keyframes are fixed to the start and end points of the clip and cannot be removed. The curve between these two keyframes is initially a flat horizontal line, indicating that the value of the controlled property is the same at each point in time within the clip's duration. To change the value (and the rate of its change) at any point, you can add one or more keyframes to the clip and drag them to appropriate vertical positions representing their values.</p>
    <p>You can:</p>
    <list>
      <item>
        <p>Add a new keyframe by clicking on the line.</p>
      </item>
      <item>
        <p>Remove a keyframe by double-clicking on it.</p>
      </item>
      <item>
        <p>Adjust the time and value of a keyframe by moving it with the mouse.</p>
      </item>
      <item>
        <p>Click-and-drag on a segment of a curve between two keyframes to adjust the vertical position of the segment.</p>
      </item>
    </list>
    <note>
      <p>Currently only linear keyframe curves are supported.</p>
    </note>
  </section>
</page>
