summaryrefslogtreecommitdiff
path: root/crates/wipfel/README.md
diff options
context:
space:
mode:
authorJohannes Hofmann <Johannes.Hofmann@gmx.de>2026-10-27 13:55:35 +0100
committerJohannes Hofmann <Johannes.Hofmann@gmx.de>2026-10-27 13:55:35 +0100
commitf6883fa1d586a040bf228ab886b95ca64457fa34 (patch)
tree9e071b64c4f1a6ac46a7b4033e0c9a4b284742bb /crates/wipfel/README.md
parent0b85e7989eacb26d3496cdb98ed3221868a4013f (diff)
Rename web front end to wipfel
'gipfel web' is taken by an existing related project. The browser app is now wipfel — web based gipfel photogrammetry for mountain images: crate gipfel-web -> wipfel, updated titles, docs, plan and dev script. The shared engine crate stays gipfel-core.
Diffstat (limited to 'crates/wipfel/README.md')
-rw-r--r--crates/wipfel/README.md47
1 files changed, 47 insertions, 0 deletions
diff --git a/crates/wipfel/README.md b/crates/wipfel/README.md
new file mode 100644
index 0000000..37c09ea
--- /dev/null
+++ b/crates/wipfel/README.md
@@ -0,0 +1,47 @@
+# wipfel
+
+Browser front end for gipfel (WASM, Yew + canvas 2D). See
+[`/wasm-plan.md`](../../wasm-plan.md) for the overall plan and milestones.
+
+**Status: W1 (scaffold + image display) done** — open/drag-drop a JPEG,
+pan (drag) and zoom (wheel, cursor-anchored). Peak identification,
+fitting and saving arrive in W2/W3.
+
+## Development
+
+Prerequisites: [rustup](https://rustup.rs) and trunk:
+
+```sh
+cargo install --locked trunk
+```
+
+Serve with hot reload:
+
+```sh
+cd crates/wipfel
+trunk serve --port 8090 # then open http://localhost:8090
+```
+
+Release build (static output in `dist/`, serveable by any web server):
+
+```sh
+trunk build --release
+```
+
+## Layout
+
+| File | Purpose |
+|---|---|
+| `src/main.rs` | entry point |
+| `src/app.rs` | root component: sidebar, file loading, state |
+| `src/canvas_view.rs` | viewport canvas: bitmap blit, pan/zoom |
+| `src/bridge.rs` | JS glue: image decode, blob read, canvas ctx |
+| `index.html` | trunk entry point (canonical trunk layout) |
+| `www/style.css` | stylesheet (trunk asset) |
+
+## Notes
+
+- The base image is decoded by the browser (`createImageBitmap`), not
+ by the `image` crate — faster decode and GPU-backed blitting.
+- The crate compiles natively (`cargo check -p wipfel`) so it can
+ be checked in CI without a wasm toolchain; runtime is wasm-only.