Warning, /education/kstars/doc/eyepieceview.docbook is written in an unsupported language. File is not indexed.

0001 <sect1 id="tool-eyepieceview">
0002 <title>Simulate Eyepiece View</title>
0003 <indexterm><primary>Tools</primary>
0004 <secondary>Simulate Eyepiece View</secondary>
0005 </indexterm>
0007 <screenshot>
0008 <screeninfo>
0009 Simulate eyepiece view
0010 </screeninfo>
0011 <mediaobject>
0012   <imageobject>
0013     <imagedata fileref="EPView_Screenshot.png" format="PNG"/>
0014   </imageobject>
0015   <textobject>
0016     <phrase>
0017         Example View
0018     </phrase>
0019   </textobject>
0020   <caption>
0021       On the left hand side is the sky map shot from &kstars;. On the right hand side is the POSS (DSS) image of the same region. The orientation in the above example has been adjusted to match the view through a Dobsonian telescope at the location and time of the simulation in &kstars;.
0022   </caption>
0023 </mediaobject>
0024 </screenshot>
0026 <para>
0027 This tool simulates how an object looks through your eyepiece. In addition to rendering the eyepiece field, &kstars; can also fetch and overlay the DSS imagery. Additionally, if you are using a Dobsonian telescope, you can rotate the field of view to match the eyepiece view.
0028 </para>
0030 <para>To use this feature, first define your eyepieces' fields of view using the <link linkend="customize">FOV Symbol editor</link>.</para>
0032 <para>Then there are two ways to invoke the feature:
0033 <itemizedlist>
0034     <listitem><para>In Sky Map, right click on the desired object and click <guilabel>Simulate eyepiece view</guilabel> in the popup menu.</para></listitem>
0035     <listitem><para>In observation planner, right click an object and click <guilabel>Simulate eyepiece view</guilabel> in the popup menu.</para></listitem>
0036 </itemizedlist>
0037 </para>
0039 <para>When the tool is first invoked, it will prompt a dialog to select the desired FOV to render the view. To compare the rendered view against a real sky image, click the <guibutton>Fetch DSS image</guibutton> button to download a DSS image. You can manually adjust the view to match your eyepiece using the rotation slider, the <guilabel>Invert view</guilabel> and <guilabel>Flip view</guilabel> check boxes. Alternatively, you can use a pre-calculated amount of rotation by using one item of the <guilabel>Preset:</guilabel> dropdown box that is tailored for different optical systems.</para>
0041 <screenshot>
0042 <screeninfo>
0043 Arp84 eyepiece view
0044 </screeninfo>
0045 <mediaobject>
0046   <imageobject>
0047     <imagedata fileref="Arp84_EyepieceView.png" format="PNG"/>
0048   </imageobject>
0049   <textobject>
0050     <phrase>
0051         View with Overlay
0052     </phrase>
0053   </textobject>
0054   <caption>
0055       Arp84 eyepiece view with ticks enabled indicating how the chart must be oriented to match the eyepiece view through a Dobsonian at a given time (the generated data is for location McDonald Observatory Texas, and the date is 14th Dec 2016).
0056   </caption>
0057 </mediaobject>
0058 </screenshot>
0060 <para>
0061 To export the view to a file, click <guibutton>Export</guibutton> button. Export enables adding ticks for printed charts as shown above and save the image.
0062 </para>
0064 </sect1>