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  2019-03-03 j.h: check for v2.10
6  2005-10-24 created en;fr by julien hardelin
7-->
8<sect2 id="plug-in-tile">
9  <title>Tile</title>
10  <indexterm>
11    <primary>Filters</primary>
12    <secondary>Map</secondary>
13    <tertiary>Tile</tertiary>
14  </indexterm>
15  <indexterm>
16    <primary>Tile</primary>
17  </indexterm>
18  <sect3>
19    <title>Overview</title>
20    <figure>
21      <title>The same image, before and after applying Tile filter</title>
22      <mediaobject>
23        <imageobject>
24          <imagedata format="PNG"
25            fileref="images/filters/examples/2zinnias.png"/>
26        </imageobject>
27        <caption>
28          <para>Original image</para>
29        </caption>
30      </mediaobject>
31      <mediaobject>
32        <imageobject>
33          <imagedata format="PNG"
34            fileref="images/filters/examples/map-tile.png"/>
35        </imageobject>
36        <caption>
37          <para>(We have reduced image size intentionally)</para>
38        </caption>
39      </mediaobject>
40    </figure>
41    <para>
42      This filter makes several copies of the original image, in a same or
43      reduced size, into a bigger (new) image.
44    </para>
45  </sect3>
46
47  <sect3>
48    <title>Activate the filter</title>
49    <para>
50      You can find this filter through
51      <menuchoice>
52        <guimenu>Filters</guimenu>
53        <guisubmenu>Map</guisubmenu>
54        <guimenuitem>Tile…</guimenuitem>
55      </menuchoice>.
56    </para>
57  </sect3>
58
59  <sect3>
60    <title>Options</title>
61    <figure>
62      <title><quote>Tile</quote> filter options</title>
63      <mediaobject>
64        <imageobject>
65          <imagedata format="PNG"
66            fileref="images/filters/map/tile.png"/>
67        </imageobject>
68      </mediaobject>
69    </figure>
70    <variablelist>
71      <title>Tile to New Size</title>
72      <varlistentry>
73        <term>Width</term>
74        <term>Height</term>
75        <listitem>
76          <para>
77            Input boxes and their arrow-heads allow you to enter the
78            dimensions for the new image. Both directions are linked by
79            default with a chain
80            <guiicon>
81              <inlinemediaobject>
82                <imageobject><imagedata format="PNG"
83                    fileref="images/dialogs/stock-vchain-24.png"/>
84                </imageobject>
85              </inlinemediaobject>
86            </guiicon>.
87            You can make them independent by breaking
88            this chain. You can choose a unit else than pixel by clicking on
89            the drop-down list button.
90          </para>
91          <para>
92            <emphasis>The new image must be bigger than the original
93            one</emphasis>. Else, you will get an image sample only. Choose
94            sizes which are multiple of original sizes if you don't want to
95            have truncated tiles.
96          </para>
97        </listitem>
98      </varlistentry>
99      <varlistentry>
100        <term>Create new image</term>
101        <listitem>
102          <para>
103            It's in your interest to keep this option checked to avoid
104            modifying your original image.
105          </para>
106        </listitem>
107      </varlistentry>
108    </variablelist>
109  </sect3>
110</sect2>
111