summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorJohannes Hofmann <Johannes.Hofmann@gmx.de>2026-11-09 10:21:03 +0100
committerJohannes Hofmann <Johannes.Hofmann@gmx.de>2026-11-09 10:21:03 +0100
commit31a47fc4393856a0a0380b2fdcf79f9dac72ad56 (patch)
tree6db58e01329bc0331fc7e4b8b2db09d7c8b3b6fc /README.md
parentd5967c1b91b14b3b4e5b0d9663e8a4d2a5e80533 (diff)
web: projection switch, external image URLs, zoom buttons
- ?file= now also accepts absolute http(s) image URLs (CORS applies); README documents all URL parameters - Projection dropdown (rectilinear / cylindrical-panoramic), synced from the gipfel comment on load; cylindrical lifts the lens-FOV visibility limit (unlimited view angle) so 360 deg panoramas show peaks in every direction - force visibility rebuild on every image load (the change detection alone could keep a stale list when the limit value was unchanged) - Google-Maps-style +/- zoom buttons at the lower right of the canvas - save/load roundtrip test for the projection type in the gipfel comment; build stamp in the sidebar footer and ?debug=1 console diagnostics to spot stale cached bundles and inspect the effective visibility state
Diffstat (limited to 'README.md')
-rw-r--r--README.md23
1 files changed, 23 insertions, 0 deletions
diff --git a/README.md b/README.md
index 3ecf7a0..85d49ef 100644
--- a/README.md
+++ b/README.md
@@ -87,6 +87,29 @@ right-click removes it. Once at least two mountains are positioned,
gipfel fits the view parameters automatically and moves the remaining
peaks to their correct positions. More markers improve the fit.
+URL Parameters
+--------------
+The web app can be fully linked to: image and view parameters are
+passed as URL query parameters, e.g.
+
+ https://example.org/gipfel/?file=photo.jpg
+ https://example.org/gipfel/?file=https://host/pano.jpg&az=57.4&pitch=-20
+
+* `file` — image to open: a path on the same host, or an absolute
+ `http(s)` URL (the remote host must allow CORS)
+* `az` — azimuth in degrees (true north)
+* `pitch` — pitch in degrees
+* `roll` — roll in degrees
+* `focal` — focal length in mm (35 mm equivalent)
+* `vis` — visibility override (0.01–0.1, same scale as the Visibility
+ slider; higher shows more distant peaks)
+
+The parameters are applied *after* the image's own EXIF/gipfel
+metadata, so they override values recorded in the photo. A `gipfel:`
+comment saved by "Save image…" is read back when the saved file is
+opened again, so annotated images carry their view without any URL
+parameters.
+
You may also want to have a look at the (outdated)
[screen video](http://www.flpsed.org/images/gipfel.avi)
for an example session.