synfig-docs/en/steps/shapes.sgml

   1 <!-- retain these comments for translator revision tracking -->
   2 <!-- $Id:shapes.sgml 1 2006-08-29 05:11:55 xerakko $ -->
   3 <sect1 id="shapes">
   4   <title>Shapes</title>
   5   <para> Basic primitives such as circles or
   6 rectangles are all great, but they are pretty much geometrically
   7 inflexible. What about shapes? To do this, we use the bline tool.</para>
   8   <para>In Synfig, the construct for describing shapes is called a Bline. This
   9 is roughly analogous to a "path" in other programs, except that it is
  10 strictly a hermite spline.</para>
  11   <para>When you click on the bline tool, you will see that the ducks from
  12 your currently selected layer (if there was one) will disappear, but
  13 the layer(s) will still remain selected in the Layers Dialog. This is
  14 normal. Anything you create in the bline tool will be inserted above the
  15 currently selected layer. Keep in mind that if you want to insert a shape
  16 somewhere, you should select where you want to insert it before you go
  17 into the Bline tool-changing the selection afterward will automaticly
  18 swap you back to the normal tool.</para>
  19   <para>If you take a look at the tool options dialog, you'll notice that the
  20 first things you see are three checkboxes. Make sure that only "Fill"
  21 AND "Outline" are checked.</para>
  22   <para>First, go ahead and click on the "R" button in the lower left corner of
  23 the FG/BG color widget in the toolbox. This will reset us back to black
  24 and white. Also, go ahead and set the default line width (right next to
  25 the FG/BG widget) to something nice and thick -- 10pt should do the
  26 trick.</para>
  27   <para>Clicking with your mouse in the canvas will place vertices. While you are
  28 placing a vertex, you can drag out its tangent by dragging the mouse. Do
  29 this over and over, and you construct a Bline.</para>
  30   <para>Keep in mind, however, that during this construction, there is nothing
  31 stopping you from just moving it if you don't like where you placed
  32 a vertex or a tangent. Honest! If you want to remove a vertex, right
  33 click on it and delete it. Want to split the tangents? Right click on
  34 the tangent and hit "split tangents". Want to loop the bline? right
  35 click on the first vertex and select "loop".</para>
  36   <para>So I assume you got your first Bline laid out like you want it. That's
  37 great. But we are still in construction mode -- the layers haven't been
  38 created yet. There are two ways to create the layers:</para>
  39   <orderedlist>
  40     <listitem>
  41       <para>just switch to another tool, or</para>
  42     </listitem>
  43     <listitem>
  44       <para>press the "create" button at the bottom of the tool options tab
  45       (it's the icon that looks like a gear).</para>
  46     </listitem>
  47   </orderedlist>
  48   <para>     For now, just go ahead and click on the normal tool because we
  49       are done with the bline tool.</para>
  50   <para>// Insert Figure about here</para>
  51   <para>Ok, we now have a nice pretty white region with a thick black
  52       outline. Notice that there are two layers that we have created--the
  53       Outline and the Region. Despite the fact that they are two separate
  54       layers, their vertices parameter has already been linked--so you
  55       can select either one and move its ducks around and the other one
  56       will also change.</para>
  57   <para>If you want to manipulate the vertices after you have created
  58       the layers, it is very easy to do so. Just click on one of the
  59       layers and have at it. If you want to remove a vertex, right
  60       click on it and hit "Remove Item (smart)". Want to insert a point
  61       somewhere? Right click on the segment where you want to insert
  62       something and his "Insert item (smart)".</para>
  63   <para>NOTE: The only major difference between this normal editing mode
  64       and the construction mode is in how you split the tangents--in
  65       construction mode you right click on the tangent itself. In normal
  66       duck editing mode, you must right click on the vertex that the
  67       tangents are attached to. This could be considered a usability bug,
  68       and it will be resolved at some point.</para>
  69   <para>This may appear to be leading to a mess of layers. And yes, if
  70       you aren't using the software properly, that is exactly what you
  71       will get. But there is a way to make this more sane: Just study
  72       the previous tutorial</para>
  73   <para>One quick thing to mention before I finish up. You can change the
  74       width of an outline at each vertex. You do this by selecting the
  75       outline layer (NOTE: you must select the Outline Layer, the Region
  76       Layer has no width data) and tweaking with the width ducks. By
  77       default, these are masked. To show them, press Alt-5. Repeat to
  78       hide them again. You can also see other things to mask via the
  79       Canvas Menu Caret &gt; View Menu &gt; Mask Ducks Menu.</para>
  80   <para>That should give you enough of a grasp of the software to be able
  81       to figure out more stuff on your own.</para>
  82 </sect1>