<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<book lang="en">
  <bookinfo>
    <title>arrowmatcher 3.0</title>
    <authorgroup>
      <author>
        <personname>
          <firstname>Herbert</firstname>
          <surname>Roider</surname>
        </personname>
      </author>
    </authorgroup>
    <pubdate>2011.02.19</pubdate>
  </bookinfo>
  <chapter id="pid_52">
    <title>Install</title>
    <section id="pid_52-uid_229">
      <title>Requirements</title>
      <para>The current Version need the qt Toolkit from 
      <ulink url="http://qt.nokia.com">http://qt.nokia.com/
      ,</ulink>the requiered Version is 4.3 or higher.</para>
      <para>optional:</para>
      <blockquote>
        <para>Gnuplot ( 
        <ulink url="http://www.gnuplot.info/">
        http://www.gnuplot.info/</ulink>), if Gnuplot is not in
        PATH, you can set the path to Gnuplot: "Edit" -&gt;
        "Preferences"</para>
      </blockquote>
    </section>
    <section id="pid_52-uid_228">
      <title>Windows: Executable</title>
      <para>Download the 
      <ulink url="https://sourceforge.net/projects/arrowmatcher/files/">
      zip-Archive</ulink>from the Windows folder.</para>
      <para>Extract it in a folder.</para>
      <para>Doubleclick the Executable file (.exe) in Filemanager
      or somewhat.</para>
    </section>
    <section id="pid_52-uid_226">
      <title>Windows: build from Source</title>
      <para>if you have troubles to install the Qt toolkit, please
      read: 
      <link linkend="pid_40">"installation of Qt for
      Windows"</link>.</para>
      <para>Download the newest arrowmatcher Package: 
      <ulink url="http://sourceforge.net/projects/arrowmatcher/files/">
      http://sourceforge.net/projects/arrowmatcher/files/</ulink>.
      Unpack it in a Directory.</para>
      <para>Please read 
      <link linkend="pid_53">"Windows"</link>.</para>
    </section>
    <section id="pid_52-uid_225">
      <title>Linux: precompiled binary</title>
      <para>I have build some precompiled Packages, which are easy
      to install:</para>
      <para>
        <emphasis role="bold">
          <ulink url="http://sourceforge.net/project/showfiles.php?group_id=47525">
          Linux Packages</ulink>
        </emphasis>
      </para>
      <para>To run arrowmacher from a terminal:</para>
      <programlisting language="bash" linenumbering="numbered">
arrowmatcher2
</programlisting>
    </section>
    <section id="pid_52-uid_222">
      <title>Linux: build from Source</title>
      <para>"unpack":</para>
      <programlisting language="bash" linenumbering="numbered">
tar -xzf arrowmatcher2-&lt;version&gt;.tar.gz
</programlisting>
      <para>change in the new directory:</para>
      <programlisting language="bash" linenumbering="numbered">
cd arrowmatcher2-&lt;version&gt;
</programlisting>
      <para>set the path (if necessary):</para>
      <programlisting language="bash" linenumbering="numbered">
export QTDIR=/usr/local/Trolltech/Qt-4.x
export PATH=$QTDIR/bin:$PATH
</programlisting>
      <para>build arrowmatcher:</para>
      <programlisting language="bash" linenumbering="numbered">
qmake -makefile arrowmatcher2.pro
make
</programlisting>
      <para>Start:</para>
      <programlisting language="bash" linenumbering="numbered">
./src/release/arrowmatcher2
</programlisting>
    </section>
    <section id="pid_52-uid_220">
      <title>Mac OS</title>
      <para>XCode is requiered. It is not installed by default, so
      you can install it from the install DVD, or download from
      web.</para>
      <para>start the Terminal:</para>
      <programlisting language="bash" linenumbering="numbered">
cd Downloads/arrowmatcher2
</programlisting>
      <para>compile the ballistic library:</para>
      <programlisting language="bash" linenumbering="numbered">
qmake -spec macx-g++ arrowmatcher2.pro
make
</programlisting>
      <para>change to the directory where the new executable
      lives:</para>
      <programlisting language="bash" linenumbering="numbered">
cd src/debug
</programlisting>
      <para>Start:</para>
      <programlisting language="bash" linenumbering="numbered">
arrowmatcher2.app/Contents/MacOS/arrowmatcher2
</programlisting>
    </section>
    <section id="pid_53">
      <title>Windows</title>
      <section id="pid_53-uid_240">
        <title>Foldertree</title>
        <para>After extract the archive, you should have a folder
        structure as shown in the picture.</para>
        <mediaobject>
          <imageobject>
            <imagedata fileref="folder_03.gif" />
          </imageobject>
        </mediaobject>
      </section>
      <section id="pid_53-uid_238">
        <title>Qt Command Prompt</title>
        <para>Start the Qt Command Prompt: Start -&gt; Programme
        -&gt; Qt by Trolltech v4.x (Open Source) -&gt; Qt 4.x
        Command Prompt</para>
        <mediaobject>
          <imageobject>
            <imagedata fileref="screen_3_start_konsole_05.gif" />
          </imageobject>
        </mediaobject>
        <mediaobject>
          <imageobject>
            <imagedata fileref="jump_folder_0_03.gif" />
          </imageobject>
        </mediaobject>
      </section>
      <section id="pid_53-uid_235">
        <title>jump the the root folder of arrowmatcher</title>
        <para>Type the following command to the command prompt to
        change to the root directory of the extracted
        archive:</para>
        <programlisting language="bash" linenumbering="numbered">
cd c:\arrowmatcher2
</programlisting>
        <mediaobject>
          <imageobject>
            <imagedata fileref="jump_folder_1_02.gif" />
          </imageobject>
        </mediaobject>
        <mediaobject>
          <imageobject>
            <imagedata fileref="jump_folder_2_02.gif" />
          </imageobject>
        </mediaobject>
      </section>
      <section id="pid_53-uid_234">
        <title>build arrowmatcher</title>
        <para>to build the application type the following 2
        commands to the command prompt:</para>
        <programlisting language="bash" linenumbering="numbered">
qmake -makefile arrowmatcher2.pro
make
</programlisting>
        <mediaobject>
          <imageobject>
            <imagedata fileref="build_1_03.gif" />
          </imageobject>
        </mediaobject>
        <mediaobject>
          <imageobject>
            <imagedata fileref="build_2_03.gif" />
          </imageobject>
        </mediaobject>
        <mediaobject>
          <imageobject>
            <imagedata fileref="build_3_03.gif" />
          </imageobject>
        </mediaobject>
        <mediaobject>
          <imageobject>
            <imagedata fileref="build_4_03.gif" />
          </imageobject>
        </mediaobject>
      </section>
      <section id="pid_53-uid_232">
        <title>run arrowmatcher</title>
        <para>Start the appliction. It is necessary to start the
        aplication from this folder "src", because to find the
        translation file for the german language:</para>
        <programlisting language="bash" linenumbering="numbered">
cd src
debug\arrowmatcher2.exe
</programlisting>
        <mediaobject>
          <imageobject>
            <imagedata fileref="run_1_03.gif" />
          </imageobject>
        </mediaobject>
        <mediaobject>
          <imageobject>
            <imagedata fileref="run_2_03.gif" />
          </imageobject>
        </mediaobject>
        <mediaobject>
          <imageobject>
            <imagedata fileref="run_3_03.gif" />
          </imageobject>
        </mediaobject>
      </section>
    </section>
  </chapter>
  <chapter id="pid_51">
    <title>getting started</title>
    <section id="pid_51-uid_218">
      <title>The main window</title>
      <para>After start of this application the window appears like
      in the picture.</para>
      <para>Select an arrow and a crossbow in the lists and click
      on "execute".</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00009.png" />
        </imageobject>
      </mediaobject>
    </section>
    <section id="pid_51-uid_216">
      <title>edit an arrow</title>
      <para>Click on the arrow in the toolbar to open the
      dialog.</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00010.png" />
        </imageobject>
      </mediaobject>
    </section>
    <section id="pid_51-uid_214">
      <title>arrow dialog</title>
      <para>The arrow dialog contains 2 tabs:</para>
      <para>"required values" and "dimensions"</para>
      <para>The "dimensions" tab helps you to calculate the
      required values. So you don't need to input the required
      values.</para>
      <para>Blue values are the default values. Green values are
      calculated and black values are user input. Black values are
      untouched by the application, but green and blue values are
      recalculated when it is possible.</para>
      <para>The "shaft code" is the number with 4 digits on the
      shaft. If you know this number you should input it, because
      to calculate the diameter and the thickness.</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00015_07.png" />
        </imageobject>
      </mediaobject>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00020_09.png" />
        </imageobject>
      </mediaobject>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00029_07.png" />
        </imageobject>
      </mediaobject>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00030_07.png" />
        </imageobject>
      </mediaobject>
    </section>
    <section id="pid_51-uid_212">
      <title>Edit the crossbow</title>
      <para>Click on the crossbow tool button in the
      toolbar.</para>
      <para>Important is the position of the sight. The picture
      describe the 3 values x,y and z. For first steps only the
      first tab is necessary, the other tabs are described
      later.</para>
      <para>The crossbow origin is normally the end of the track,
      where the arrow leaves the crossbow.</para>
      <para>The origin of the sight is the middle point of the
      sight.</para>
      <para>Click the button "Calculate the energy ..." to open a
      new dialog.</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00035_05.png" />
        </imageobject>
      </mediaobject>
    </section>
    <section id="pid_51-uid_210">
      <title>Setup</title>
      <para>This is the main setup dialog for arrowmatcher. It is
      necessary to shoot at 2 different ranges with the same arrow
      and without change the setting of the sight. Select an arrow.
      Input the coordinates y and z of the 2 target points as shown
      in the image. Click on "calculate". Arrowmatcher try to
      determine the muzzle velocity of the arrow and the energy.
      Try these values:</para>
      <table frame="all">
        <title>Examplevalues for speedcalculation</title>
        <tgroup cols="3">
          <colspec colnum="1" colname="col1" />
          <colspec colnum="2" colname="col2" />
          <colspec colnum="3" colname="col3" />
          <thead>
            <row>
              <entry />
              <entry>
                <para>small range</para>
              </entry>
              <entry>
                <para>wide range</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>
                <para>range [Metre]</para>
              </entry>
              <entry>
                <para>10</para>
              </entry>
              <entry>
                <para>30</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>crosshair</para>
              </entry>
              <entry>
                <para>do not change</para>
              </entry>
              <entry>
                <para>do not change</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>vertical hit (y) [Millimetre]</para>
              </entry>
              <entry>
                <para>0</para>
              </entry>
              <entry>
                <para>-300</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <para>This means the zerorange is 10 metre. At 30 metre the
      targetpoint is 300mm below. Now the setup is complete!</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00050_05.png" />
        </imageobject>
      </mediaobject>
    </section>
  </chapter>
  <chapter id="pid_50">
    <title>arrow</title>
    <section id="pid_50-uid_208">
      <title>edit an arrow</title>
      <para>Click on the arrow in the toolbar to open the
      dialog.</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00010.png" />
        </imageobject>
      </mediaobject>
    </section>
    <section id="pid_50-uid_207">
      <title>Arrow Model</title>
      <para>There are 2 models for arrows:</para>
      <para>
        <emphasis role="bold">"Simplified Arrow"</emphasis>
      </para>
      <para>and</para>
      <para>
        <emphasis role="bold">"Full Arrow"</emphasis>
      </para>
      <para>The Simplified Arrow is also for bullets.</para>
    </section>
    <section id="pid_50-uid_206">
      <title>Basic settings for the simplified arrow</title>
      <para>The simplified arrow model take only 2 values: weight
      and diameter. You can used the simplified arrow model also
      for bullets.</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="arrow_dlg_simple_04.gif" />
        </imageobject>
      </mediaobject>
    </section>
    <section id="pid_50-uid_202">
      <title>Basic settings for full arrow</title>
      <para>The arrow dialog contains 2 tabs:</para>
      <para>"Basic" and "Advanced"</para>
      <para>Insert only all values in the "Basic".</para>
      <para>Blue values are the default values. Green values are
      calculated and black values are user input. Black values are
      untouched by the application, but green and blue values are
      recalculated when it is possible.</para>
      <para>The "shaft code" is the number with 4 digits on the
      shaft. If you know this number you should input it, because
      to calculate the diameter and the thickness.</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00015_05.png" />
        </imageobject>
      </mediaobject>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00020_07.png" />
        </imageobject>
      </mediaobject>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00029_05.png" />
        </imageobject>
      </mediaobject>
    </section>
    <section id="pid_50-uid_201">
      <title>Advanced settings</title>
      <para>The values in the "Advanced Settings" Tab are automatic
      calculated or default values. This is for advanced Users who
      want to play around with custom values.</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00030_05.png" />
        </imageobject>
      </mediaobject>
    </section>
  </chapter>
  <chapter id="pid_49">
    <title>sight</title>
    <section id="pid_49-uid_198">
      <title>Position of the sight</title>
      <para>To edit the sight click the toolbar button with the
      crossbow.</para>
      <para>The crossbow dialog appears. Insert the position of the
      sight. In most cases only the height (Y - Value) is important
      and the values for Z and X can be zero.</para>
      <para>Click the tab "sight".</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="open_crossbow_dlg_01.png" />
        </imageobject>
      </mediaobject>
      <mediaobject>
        <imageobject>
          <imagedata fileref="crossbow_dlg_01.png" />
        </imageobject>
      </mediaobject>
    </section>
    <section id="pid_49-uid_197">
      <title>edit crosshairs</title>
      <para>There are 2 options: "crosshair" or "micro
      adjust".</para>
      <para>The default is "crosshair". This is for multible
      crosshairs. You can add a lot of crosshairs.</para>
      <para>Click "new" to add a crosshair.</para>
      <para>Mark a row by clicking it and click "edit". A setup
      dialog appears. Don't edit the first row. Let the values for
      y and z to 0.</para>
      <para>The Reticle of my scope has the following
      crosshairs:</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="RTEmagicC_Absehen_01.gif" />
        </imageobject>
      </mediaobject>
      <table frame="all">
        <title>Examplevalues for a Reticle</title>
        <tgroup cols="2">
          <colspec colnum="1" colname="col1" />
          <colspec colnum="2" colname="col2" />
          <thead>
            <row>
              <entry>
                <para>Y [mm/m]</para>
              </entry>
              <entry>
                <para>Z [mm/m]</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>
                <para>0</para>
              </entry>
              <entry>
                <para>0</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>-6.179</para>
              </entry>
              <entry>
                <para>0</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>-15.935</para>
              </entry>
              <entry>
                <para>0</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>-22.114</para>
              </entry>
              <entry>
                <para>0</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>-26.667</para>
              </entry>
              <entry>
                <para>0</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00081_01.png" />
        </imageobject>
      </mediaobject>
    </section>
    <section id="pid_49-uid_196">
      <title>setup crosshair</title>
      <para>Select an arrow.</para>
      <para>Input the range.</para>
      <para>Input the targetpoint as shown in the picture.</para>
      <para>Click on "execute".</para>
      <para>That's it. Click on "ok" to close the dialog.</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00086_01.png" />
        </imageobject>
      </mediaobject>
    </section>
    <section id="pid_49-uid_195">
      <title>Visier</title>
      <para>Now you can see all the new crosshairs.</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_00096_01.png" />
        </imageobject>
      </mediaobject>
      <mediaobject>
        <imageobject>
          <imagedata fileref="crosshairs_01.gif" />
        </imageobject>
      </mediaobject>
    </section>
  </chapter>
  <chapter id="pid_40">
    <title>installation of Qt for Windows</title>
    <section id="pid_40-uid_108">
      <title>introduction</title>
      <para>Please read this if you have troubles to install Qt on
      Windows.</para>
    </section>
    <section id="pid_40-uid_109">
      <title>download</title>
      <para>Download an older Version 4.5.3 of Qt from the ftp
      archiv:
      ftp://ftp.qt.nokia.com/qt/source/qt-win-opensource-4.5.3-mingw.exe</para>
      <para>Doubleclick this file to start the setup
      program.</para>
    </section>
    <section id="pid_40-uid_110">
      <title>MinGW</title>
      <para>Select MinGW. The souces are not necessary.</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_0_mingw.gif" />
        </imageobject>
      </mediaobject>
    </section>
    <section id="pid_40-uid_111">
      <title>download MinGW</title>
      <para>Select "Trolltech" to download MinGW, there is only one
      option.</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_1_download_mingw.gif" />
        </imageobject>
      </mediaobject>
    </section>
    <section id="pid_40-uid_112">
      <title>finished</title>
      <para>After a successful installation of Qt your rootfolder
      contains "MinGW" and "Qt".</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="screen_2_folder.gif" />
        </imageobject>
      </mediaobject>
    </section>
  </chapter>
</book>