picplanner/README.md

69 wiersze
4.7 KiB
Markdown

2020-06-22 07:38:23 +00:00
# PicPlanner
2022-02-16 15:34:34 +00:00
<img align='center' alt='PicPlanner Icon' src='https://gitlab.com/Zwarf/picplanner/-/raw/master/title-image.png'/>
2022-01-17 10:32:03 +00:00
<br/><br/>
<p> A GTK application for photographers using GNU Linux or especially Linux phones. It can be used to calculate the position of the Sun, Moon and Milky Way in order to plan the position and time for a photograph.</p>
2020-07-02 19:02:37 +00:00
## The Idea
People who love to photograph know, that the biggest problem is being at the right spot at the right time.
Therefore, landscape pictures should be planned before visiting the place of choice. To plan the location it is important to know the position of the sun, moon, and sometimes also the milky way.
Where to find the sun at which time is most of the time easy to guess but when is the sunset? And for the milky way normally nobody knows where to find it in the night sky at which time at a specific location.
This small program should answer all these questions.
2020-07-02 19:02:37 +00:00
## Plan
2020-07-02 19:19:44 +00:00
```diff
2022-02-01 20:08:06 +00:00
+1. Create a basic GNOME like GUI -- Starting from zero again... Update: I think we can call it basic now :D
+2. Calculate the center of the milky way at a specific time -- Implemented and equations seem to be very precise (± 1°)
+3. Calculate the position of the sun -- Implemented and equations seem to be very precise (< ± 1°)
+4. Find the position of the moon at a spesific time -- Implemented and equations seem to be sufficiently precise (~ ± 2°)
2022-03-27 14:28:39 +00:00
+5. Present all calculated data in the GUI -- Most of the data is showen
+6. Create the location search -- A simple offline search is implemented now more will follow
2022-05-06 21:49:10 +00:00
-7. Implement "smarphone functionality" e.g. find location via GPS
+8. Insert a map view with OSM
+9. Visualise important data direktly on the map
```
2020-07-02 19:02:37 +00:00
2020-06-22 07:38:23 +00:00
## Formulas used
2021-11-21 00:10:30 +00:00
Most of the formulas used are explained in detail directly inside the code. Reference is given or will be added soon.
Some of these formulas are from the excellent book by Jean Meeus "Astronomical Algorithms". Others are from scientific papers or combined by me.
2020-07-02 19:02:37 +00:00
2020-06-22 07:38:23 +00:00
2021-11-21 00:10:30 +00:00
## Libraries
2020-08-19 21:53:57 +00:00
2021-11-21 00:10:30 +00:00
- GTK 4 is used to create the GUI.
- Libadwaita is used to make the GUI adaptive.
- Shumate is used to show a map.
- Libgweather is used for the offline search functionality.
2020-07-02 19:04:06 +00:00
2021-11-21 00:10:30 +00:00
2020-07-02 19:04:06 +00:00
## Build
At the moment this application is NOT fully functional.
2020-07-09 10:04:34 +00:00
2020-08-19 21:49:09 +00:00
```diff
2022-01-21 09:45:53 +00:00
git clone https://gitlab.com/Zwarf/picplanner.git
2020-08-19 21:51:42 +00:00
cd picplanner
2020-08-19 21:49:09 +00:00
meson builddir
cd builddir
ninja
ninja install
2020-08-19 21:51:42 +00:00
```
2022-07-19 10:27:03 +00:00
## Screenshots Desktop Size, Light Theme
2020-07-09 10:04:34 +00:00
2022-07-10 21:34:37 +00:00
<a href='https://gitlab.com/zwarf/picplanner/-/blob/main/screenshots/screenshot-large-1.png'><img height='550px' alt='screenshot-large' src='https://gitlab.com/zwarf/picplanner/-/raw/main/screenshots/screenshot-large-1.png'/></a>
<a href='https://gitlab.com/zwarf/picplanner/-/blob/main/screenshots/screenshot-large-2.png'><img height='550px' alt='screenshot-large' src='https://gitlab.com/zwarf/picplanner/-/raw/main/screenshots/screenshot-large-2.png'/></a>
<a href='https://gitlab.com/zwarf/picplanner/-/blob/main/screenshots/screenshot-large-3.png'><img height='550px' alt='screenshot-large' src='https://gitlab.com/zwarf/picplanner/-/raw/main/screenshots/screenshot-large-3.png'/></a>
<a href='https://gitlab.com/zwarf/picplanner/-/blob/main/screenshots/screenshot-large-4.png'><img height='550px' alt='screenshot-large' src='https://gitlab.com/zwarf/picplanner/-/raw/main/screenshots/screenshot-large-4.png'/></a>
<a href='https://gitlab.com/zwarf/picplanner/-/blob/main/screenshots/screenshot-large-5.png'><img height='550px' alt='screenshot-large' src='https://gitlab.com/zwarf/picplanner/-/raw/main/screenshots/screenshot-large-5.png'/></a>
<a href='https://gitlab.com/zwarf/picplanner/-/blob/main/screenshots/screenshot-large-6.png'><img height='550px' alt='screenshot-large' src='https://gitlab.com/zwarf/picplanner/-/raw/main/screenshots/screenshot-large-6.png'/></a>
2022-07-10 21:28:04 +00:00
## Screenshots Mobile Size, Light Theme
2022-07-10 21:34:37 +00:00
<a href='https://gitlab.com/zwarf/picplanner/-/blob/main/screenshots/screenshot-small-1.png'><img height='550px' alt='screenshot-large' src='https://gitlab.com/zwarf/picplanner/-/raw/main/screenshots/screenshot-small-1.png'/></a>
<a href='https://gitlab.com/zwarf/picplanner/-/blob/main/screenshots/screenshot-small-2.png'><img height='550px' alt='screenshot-large' src='https://gitlab.com/zwarf/picplanner/-/raw/main/screenshots/screenshot-small-2.png'/></a>
<a href='https://gitlab.com/zwarf/picplanner/-/blob/main/screenshots/screenshot-small-3.png'><img height='550px' alt='screenshot-large' src='https://gitlab.com/zwarf/picplanner/-/raw/main/screenshots/screenshot-small-3.png'/></a>
<a href='https://gitlab.com/zwarf/picplanner/-/blob/main/screenshots/screenshot-small-4.png'><img height='550px' alt='screenshot-large' src='https://gitlab.com/zwarf/picplanner/-/raw/main/screenshots/screenshot-small-4.png'/></a>