Remove ancient trunk folder from svn repository
[synfig.git] / synfig-docs / en / interface / interface.sgml
1 <!-- retain these comments for translator revision tracking -->
2 <!-- $Id$ -->
3
4 <chapter id="interface">
5 <title>The user Interface</title>
6 <para>When you start Synfig Studio, it will display a splash graphic and boot 
7 itself up. After it finishes loading, you should see three windows. The window 
8 in the upper left is the toolbox. This is where you can open files, change tools, 
9 etc. You'll notice that most of the buttons are greyed out--because there is no 
10 file open yet.</para>
11
12 <para>The other two windows (one on the bottom, and one to the right) are 
13 customizable dock dialogs. You can rearrange the contents of these however 
14 you wish by simply dragging the tab to where you want it. You can even create a 
15 new dock dialog by dragging a tab out of the dock dialog it was inside of.</para>
16
17 <para>If you ever accidently close a dock tabs (by dragging it out of the dock 
18 dialog, and closing the new dock dialog that gets created), no worries. Simply 
19 goto the toolbox and goto "File->Dialogs", and then click on the name of the 
20 dialog you need.</para>
21
22 <para>There are a lot of dock tabs. If you have no idea what a dock tab does, 
23 simply hold your mouse over its icon and a tooltip will pop up describing the 
24 name of the tab.<para>
25
26 Here are some of the more important ones:
27 <itemizedlist>
28  <listitem>
29   <para>Layers Dialog (<xref linkend="layers"/>) - This tab shows you the layer 
30   hierarchy for the currently selected canvas. It also allows you to manipulate 
31   these layers.</para>
32  </listitem>
33  <listitem>
34   <para>Params Dialog (<xref linkend="params"/>)- This tab will show you the 
35   parameters of the currently selected layer, (OR, if multiple layers are 
36   selected, it shows you only the parameters that the selected layers have 
37   in common)</para>
38  </listitem>
39  <listitem>
40   <para>Tool Options Dialog (<xref linkend="tooloptions"/>) - Shows you any 
41   options specific to the currently selected tool</para>
42  </listitem>
43  <listitem>
44   <para>Navigator (<xref linkend="navigator"/>) - Shows you a thumbnail of what the currently selected Canvas
45   looks like. You can also zoom in and move the focus around with this tab.</para>
46  </listitem>
47  <listitem>
48   <para>History Dialog (<xref linkend="history"/>- Shows you the history stack for the current composition. 
49   You can also edit the actions in history.</para>
50  </listitem>
51 </itemizedlist>
52
53 <para>If you click the "new composition" button in the toolbox, a new composition 
54 will be opened and the canvas properties dialog will appear.</para>
55
56 <para>The canvas properties dialog is a mess, I know. I'll have it re-designed into 
57 something much more comprehendible in the next few days. For now, ignore the 
58 "Image Area" and "Locks and Links" sections.</para>
59
60 <para>If you click OK, the canvas properties dialog will disappear and you will see 
61 the Canvas window. This window represents the Root Canvas, not that that means much 
62 to you at the moment, but that's OK--I'm just trying to show you around.</para>
63
64 <para>In the upper left corner of the Canvas Window, you'll see a button with a 
65 caret If you click on this button, the canvas window menu will pop up. (As an aside, 
66 if you right click in the canvas area and there is not a layer under the mouse 
67 position, this menu will also appear) So now you know where the menu is in the Canvas 
68 Window. Good. Everything else should be pretty self-explanatory in the Canvas Window. 
69 (Explanations on the menu stuff is to come in a sec)</para>
70 &toolbox.sgml;
71 &layers.sgml;
72 &params.sgml;
73 &tooloptions.sgml;
74 &navigator.sgml;
75 &history.sgml;
76 </chapter>