<div dir="ltr">Ok, so I'm still working on improving the API documentation and wanted to add a section "How it works" to explain (ELI5) how KStars overall work. I wrote the following which is most likely inaccurate, please help me come up with a decent "How it works" section in the updated API docs:<div><br></div><div><div>How it works?</div><div><br></div><div>TODO This is a work in progress, it might not be accurate.</div><div><br></div><div>The following explanation is a very high level and general overview on the basic workflow in KStars. When you run KStars, the following general steps are executed (not necessarily in this order):</div><div><br></div><div>+ An Instance of KStars is created.</div><div>+ Data for stars, catalogs, deep sky objects, comets...etc are read and loaded into memory. Some data are not read unless necessary, such as stars that only appear at very high zoom levels.</div><div>+ Toolbars, menus, and GUI elements are initialized.</div><div>+ Time is initialized. Simulated clocks normally ticks forward at a particular interval, the default being once per second like a real clock.</div><div>+ The coordinates of the sky objects loaded previously are calculated given the current date and time settings. Effects for precession, nutation, aberration, and refraction are taken into account.</div><div>+ Each component draws itself on the skymap. The order of the drawing routine ensures layers such as equatorial/horizontal grid lines are drawn last.</div><div>+ The sky map responds to user input from keyboard and mouse to perform various actions such as panning, zooming, invoking the popup menu for a particular object...etc.</div><div>+ TODO Add more detials</div></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Feb 9, 2015 at 10:11 AM, Jasem Mutlaq <span dir="ltr"><<a href="mailto:mutlaqja@ikarustech.com" target="_blank">mutlaqja@ikarustech.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Hello folks,<div><br></div><div>Recently, I started revamping KStars API documentation since I realized that even after 10+ years in KStars, I am completely oblivious to some KStars key components. The API documentation is now better but it still needs a lot of work. I also plan to work on updating the handbook (or if anyone else wants to step in that would be great!). For now, I propose the following breakdown for the API, please let me know if I am missing anything or if it needs to be structured differently altogether.</div><div><br></div><div><div>API Breakdown:</div><div><br></div><div>1. Data</div><div>  + SkyMapComposite</div><div>  + SkyComponent</div><div>  + SkyObject et al.</div><div><br></div><div>2. View</div><div>  + KStars</div><div>  + SkyMap</div><div>  + KSPopupMenu</div><div>  + InfoBoxes</div><div>  + Labels & Trails</div><div>  + Flags</div><div>  + FOVs</div><div>  + Projections</div><div><br></div><div>3. Time</div><div>  + SimClock</div><div><br></div><div>4. Math</div><div><br></div><div>5. Tools</div><div>  + Calculator</div><div>  + Devices</div><div>  + Sky Calender</div><div>  + What's up tonight</div><div>  + What's interesting</div><div>  + Solar System</div><div>  + Jupiter Moon</div><div>  + Star Hopper</div><div>  + Angular Distance</div><div><br></div><div>6. Observation</div><div>    + OAL</div><div>    + Observation Planner</div><div>    + Session Planner</div><div><br></div><div>7. Auxiliary</div><div>  + Image Viewer</div><div>  + Color Schemes</div><div>  + Wizard</div><div>  + Settings</div><div><br></div><div>8. Scripting</div><div>  + DBUS interface</div><div>  + Script Builder</div><span class="HOEnZb"><font color="#888888"><div><br></div>-- <br><div><div dir="ltr"><div>Best Regards,<br>Jasem Mutlaq<br></div><div><br></div></div></div>
</font></span></div></div>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div>Best Regards,<br>Jasem Mutlaq<br></div><div><br></div></div></div>
</div>