1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3                       "http://www.docbook.org/xml/4.3/docbookx.dtd">
4<!-- section history:
5  2009-07-19 ude: changed id 'gimp-image-guides-add' to 'script-fu-guide-new'
6  2007-11-25 j.h: changed 'image' to 'canvas' for origin of coordinates
7  2007-09-28 AntI: Added 'es'
8  2007-03-09 alex falappa: added it translation
9  2006-08-10 scb: revised 'en'
10  2005-10-30 created from image-guides.xml by axel.wernicke
11-->
12<sect2 id="script-fu-guide-new">
13  <title>New Guide</title>
14
15  <indexterm>
16    <primary>Guide</primary>
17    <secondary>Add</secondary>
18  </indexterm>
19
20  <para>
21    The <guimenuitem>New Guide</guimenuitem> command adds a guide to
22    the image.
23  </para>
24  <tip>
25    <para>
26      You can add guides to the image more quickly, but less accurately, by
27      simply clicking and dragging guides from the image rulers and
28      positioning them where you would like.
29    </para>
30  </tip>
31
32  <sect3>
33    <title>Activate the Command</title>
34    <para>
35      You can access this command from the image menubar through
36      <menuchoice>
37        <guimenu>Image</guimenu>
38        <guisubmenu>Guides</guisubmenu>
39        <guimenuitem>New Guide</guimenuitem>
40      </menuchoice>
41    </para>
42  </sect3>
43
44  <sect3>
45    <title><quote>New Guide</quote> Options</title>
46    <para>
47      When you select <guimenuitem>New Guide</guimenuitem>, a dialog opens,
48      which allows you to set the <guilabel>Direction</guilabel> and
49      <guilabel>Position</guilabel>, in pixels, of the new guide more
50      precisely than by using click-and-drag.
51    </para>
52    <figure>
53      <title>The <quote>New Guide</quote> Dialog</title>
54      <mediaobject>
55        <imageobject>
56          <imagedata format="PNG"
57            fileref="images/menus/image/new-guide.png"/>
58        </imageobject>
59      </mediaobject>
60    </figure>
61    <variablelist>
62      <varlistentry>
63        <term>Direction</term>
64        <listitem>
65          <para>
66            You can choose the <guilabel>Direction</guilabel> of the guide,
67            either <guilabel>Horizontal</guilabel> or
68            <guilabel>Vertical</guilabel>, by using the drop-down list.
69          </para>
70        </listitem>
71      </varlistentry>
72      <varlistentry>
73        <term>Position</term>
74        <listitem>
75          <para>
76            The coordinate origin for the <guilabel>Position</guilabel> is
77            the upper left corner of the canvas.
78          </para>
79        </listitem>
80      </varlistentry>
81    </variablelist>
82  </sect3>
83</sect2>
84