Transferred project from private repository

Author: CodingFactoryT

Documentation-de.docx

@@ -0,0 +1,54 @@
+# Geo Image Viewer
+A project that visualizes the locations where pictures were taken.
+
+## Usage
+Drag and drop pictures with GPS-Information from your local explorer onto the map, the program will show you where they were taken.
+
+### Command line arguments
+| shortcut | option            | argument 1         | description                                   |
+|----------|-------------------|--------------------|-----------------------------------------------|
+| -h       | --help            |                    | prints help message and exits                 |
+| -l       | --log-file        | /path/to/file      | enables logging and sets log file accordingly |
+| -d       | --image-directory | /path/to/directory | sets image directory accordingly              |
+
+## Dependencies
+
+### [metadata-extractor](https://github.com/drewnoakes/metadata-extractor)
+We use this library, so we can support many file types at once with little effort.
+
+### [jxmapviewer2](https://github.com/msteiger/jxmapviewer2)
+This library helps us to draw the maps from OpenStreetMap.
+
+### [commons-cli](https://commons.apache.org/proper/commons-cli/)
+In order to parse command line arguments, we use this library.
+
+### [commons-csv](https://commons.apache.org/proper/commons-csv/)
+We are using this library to easily read and write CSV files.
+
+## Requirements
+This project uses [Maven](https://maven.apache.org/) to manage its dependencies.
+The next instructions can only be followed if Maven has been successfully installed onto your system.
+
+## Building the app
+The following commands should provide you a running build.
+
+### 1. Build script:
+Works on most GNU+Linux based operating systems (Build + Execute):
+`/path/to/geoimageviewer/build.sh`
+
+### 2. Manual procedure:
+```bash
+cd /path/to/geoimageviewer
+mvn clean package
+java -jar target/geoimageviewer-1.0-SNAPSHOT.jar
+```
+
+## Documentation
+### UML diagrams
+Latest UML diagram:
+
+![Image failed to load](https://github.com/madcomputerscientists/geoimageviewer/blob/main/plans/UML/MainDiagram-latest.png?raw=true)
+
+The UML diagrams for this project are stored [here](https://github.com/madcomputerscientists/geoimageviewer/tree/main/plans/UML).
+
+## Feel free to create [Issues](https://github.com/madcomputerscientists/geoimageviewer/issues) and [Pull Requests](https://github.com/madcomputerscientists/geoimageviewer/pulls)!

README.md

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+SCRIPT_PATH=`readlink -f "$0"`
+SCRIPT_DIR=`dirname "$SCRIPT_PATH"`
+
+cd "$SCRIPT_DIR"
+mvn clean package
+java -jar target/geoimageviewer-1.0-SNAPSHOT.jar -d images

build.sh

@@ -0,0 +1,3 @@
+https://github.com/msteiger/jxmapviewer2
+https://github.com/drewnoakes/metadata-extractor/
+https://web.archive.org/web/20100309081606/http://today.java.net/pub/a/today/2007/10/30/building-maps-into-swing-app-with-jxmapviewer.html

plans/GUI/MainScreen.pdn

@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>org.madcomputerscientists</groupId>
+    <artifactId>geoimageviewer</artifactId>
+    <version>1.0-SNAPSHOT</version>
+
+    <properties>
+        <maven.compiler.source>17</maven.compiler.source>
+        <maven.compiler.target>17</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <exec.mainClass>org.madcomputerscientists.Main</exec.mainClass>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.jxmapviewer</groupId>
+            <artifactId>jxmapviewer2</artifactId>
+            <version>2.6</version>
+        </dependency>
+        <dependency>
+            <groupId>com.drewnoakes</groupId>
+            <artifactId>metadata-extractor</artifactId>
+            <version>2.18.0</version>
+        </dependency>
+        <!-- https://mvnrepository.com/artifact/commons-cli/commons-cli -->
+        <dependency>
+            <groupId>commons-cli</groupId>
+            <artifactId>commons-cli</artifactId>
+            <version>1.5.0</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.commons</groupId>
+            <artifactId>commons-csv</artifactId>
+            <version>1.9.0</version>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-dependency-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <id>copy-dependencies</id>
+                        <phase>prepare-package</phase>
+                        <goals>
+                            <goal>copy-dependencies</goal>
+                        </goals>
+                        <configuration>
+                            <outputDirectory>${project.build.directory}/${project.build.finalName}.lib</outputDirectory>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <!-- Build an executable JAR -->
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-jar-plugin</artifactId>
+                <version>3.3.0</version>
+                <configuration>
+                    <archive>
+                        <manifest>
+                            <addClasspath>true</addClasspath>
+                            <classpathPrefix>${project.build.finalName}.lib/</classpathPrefix>
+                            <mainClass>org.madcomputerscientists.Main</mainClass>
+                        </manifest>
+                    </archive>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+</project>

plans/GUI/MainScreen.png

@@ -0,0 +1,33 @@
+package org.madcomputerscientists;
+
+import org.jxmapviewer.viewer.DefaultWaypoint;
+import org.jxmapviewer.viewer.GeoPosition;
+
+import javax.swing.JButton;
+import javax.swing.Icon;
+
+import java.awt.Dimension;
+
+public class ClickableWaypoint extends DefaultWaypoint {
+    private ResourceFetcher resourceFetcher = new ResourceFetcher();
+    private Icon defaultIcon = resourceFetcher.getIconByName("imageRecordLocation.png");
+    private JButton button = new JButton();
+
+    public ClickableWaypoint(GeoPosition geoPosition, int width, int height) {
+        super(geoPosition);
+        button.setContentAreaFilled(false);
+        button.setIcon(defaultIcon);
+        button.setBorderPainted(false);
+        button.setFocusPainted(false);
+        button.setSize(new Dimension(width, height));
+        button.setBorder(null);
+    }
+
+    public JButton getButton() {
+        return button;
+    }
+
+    public boolean equals(ClickableWaypoint waypoint){
+        return this.getPosition().equals(waypoint.getPosition());
+    }
+}

plans/GUI/Marker Clicked.pdn

@@ -0,0 +1,26 @@
+package org.madcomputerscientists;
+
+import org.jxmapviewer.JXMapViewer;
+import org.jxmapviewer.viewer.WaypointPainter;
+
+import javax.swing.JButton;
+
+import java.awt.Graphics2D;
+import java.awt.Rectangle;
+import java.awt.geom.Point2D;
+
+public class ClickableWaypointRenderer extends WaypointPainter<ClickableWaypoint> {
+    @Override
+    protected void doPaint(Graphics2D g, JXMapViewer map, int width, int height) {
+        for (ClickableWaypoint waypoint : this.getWaypoints()) {
+            Point2D point = map.getTileFactory().geoToPixel(waypoint.getPosition(), map.getZoom());
+
+            Rectangle viewportBounds = map.getViewportBounds();
+            int x = (int) (point.getX() - viewportBounds.getX());
+            int y = (int) (point.getY() - viewportBounds.getY());
+
+            JButton button = waypoint.getButton();
+            button.setLocation(x - button.getWidth() / 2, y - button.getHeight());
+        }
+    }
+}

plans/GUI/Marker Clicked.png

@@ -0,0 +1,135 @@
+package org.madcomputerscientists;
+
+import java.text.DecimalFormat;
+import java.text.DecimalFormatSymbols;
+import java.util.Locale;
+
+public class Coordinate {
+    private double latitude_dec;
+    private double longitude_dec;
+
+    private String latitude_str;
+    private String longitude_str;
+
+
+    public Coordinate(double latitude, double longitude) {
+        this.latitude_dec = latitude;
+        this.longitude_dec = longitude;
+
+        this.latitude_str = decToStr(latitude);
+        this.longitude_str = decToStr(longitude);
+    }
+
+    /**
+     * uses the <a href="https://en.wikipedia.org/wiki/Haversine_formula">Haversine</a>
+     * formula to calculate the distance between two coordinates on earth
+     * @param coordinate coordinate to which the distance should be calculated
+     * @return distance from the coordinate that the method was called on to the given coordinate
+     */
+    public double distanceTo(Coordinate coordinate) {
+        final int EARTH_RADIUS_KM = 6371;
+
+        double lat1 = this.latitude_dec;
+        double long1 = this.longitude_dec;
+        double lat2 = coordinate.latitude_dec;
+        double long2 = coordinate.longitude_dec;
+
+        double latDistance = Math.toRadians(lat2-lat1);
+        double longDistance = Math.toRadians(long2-long1);
+        double a = Math.sin(latDistance / 2) * Math.sin(latDistance / 2) +
+                Math.cos(Math.toRadians(lat1)) * Math.cos(Math.toRadians(lat2)) *
+                        Math.sin(longDistance / 2) * Math.sin(longDistance / 2);
+        double c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+
+        return EARTH_RADIUS_KM * c * 1000; //convert distance from kilometers in meters
+    }
+
+    /**
+     *
+     * @param coordinate the coordinate the range should be compared to
+     * @param range range in meter
+     * @return true/false if coordinate is in range
+     */
+    public boolean isInRange(Coordinate coordinate, double range) {
+        return distanceTo(coordinate) <= range;
+    }
+
+    public static double toDecimal(String value) {
+        value = value.replaceAll(" ", "").replaceAll(",", ".");
+
+        int degreeIndex = value.indexOf('°');
+        int minuteIndex = value.indexOf('\'');
+        int secondsIndex = value.indexOf("\"");
+
+        int degrees = Integer.parseInt(value.substring(0, degreeIndex));
+
+        if (degrees < 0) {
+            degrees *= -1;
+        }
+
+        int minutes = Integer.parseInt(value.substring(degreeIndex + 1, minuteIndex));
+        double seconds = Double.parseDouble(value.substring(minuteIndex + 1, secondsIndex));
+
+        double result = degrees + (minutes * 60.0 + seconds) / 3600.0;
+
+        if (value.contains("-")) {
+            result *= -1;
+        }
+
+        return result;
+    }
+
+    public static String decToStr(double value) {
+        DecimalFormat df = new DecimalFormat("0.00", DecimalFormatSymbols.getInstance(Locale.US));
+
+        String pre = "";
+        if (value < 0) {
+            pre = "-";
+            value *= -1;
+        }
+
+        int degrees = (int) value;
+        double a = (value - degrees) * 60;
+        int minutes = (int) a;
+        double seconds = (a - minutes) * 60;
+
+        return pre + degrees + "° " + minutes + "' " + df.format(seconds) + "\"";
+    }
+
+    public String toString() {
+        return "Lat: " + latitude_str + " Long: " + longitude_str;
+    }
+
+    public double getLatitude_dec() {
+        return this.latitude_dec;
+    }
+    public double getLongitude_dec() {
+        return longitude_dec;
+    }
+
+    public String getLatitude_str() {
+        return this.latitude_str;
+    }
+
+    public String getLongitude_str() {
+        return this.longitude_str;
+    }
+
+    public void setCoordinate(double latitude, double longitude){
+        this.latitude_dec = latitude;
+        this.longitude_dec = longitude;
+
+        this.latitude_str = decToStr(latitude);
+        this.longitude_str = decToStr(longitude);
+    }
+
+    public String getLatitude_dec_Formatted(){
+        DecimalFormat df = new DecimalFormat("0.000000", DecimalFormatSymbols.getInstance(Locale.US));
+        return df.format(latitude_dec);
+    }
+
+    public String getLongitude_dec_Formatted(){
+        DecimalFormat df = new DecimalFormat("0.000000", DecimalFormatSymbols.getInstance(Locale.US));
+        return df.format(longitude_dec);
+    }
+}