@rr0/ufoathome 0.58.1 → 0.59.0

package/README.md

@@ -476,6 +476,7 @@ interface SightingRecordingJson {
   instrument?: "eye" | "rectilinear-lens" // what it was observed THROUGH — see Instrument. Absent = the naked eye
   soundTrack?: { keyframes: Array<{ t: number, sound: { kind: "none" | "hum" | "whistle" | "rumble" | "crackle", volume: number, pitchHz: number, src?: string } }> } // what the witness heard — see What it sounded like
   decor?: DecorObject[] // buildings, trees, streetlights, vehicles, other witnesses — see src/engine/model/Decor.ts
+  references?: SceneReference[] // pictures of the place laid over the scene, each at a registered heading/pitch/roll/field — see Pictures of the place
 }
 ```
 
@@ -514,6 +515,35 @@ one instant of a sighting — weather still going on over it would be the reader
 evening. Clouds likewise use the recording's timeline: wind advection stops on pause and is
 recomputed deterministically when seeking.
 
+### Pictures of the place
+
+Everything the scene draws is computed, and a reader has no way to tell a faithful reconstruction from a plausible
+one. A photograph of the same place does: `references` lays pictures over the render, each at the direction it was
+registered in (`registration`: heading, pitch, roll and vertical field, angles and nothing else), at an opacity the
+reader varies with the slider beside the 🖼 button — all picture, all render, and every step between, with the
+witness's own phenomenon drawn over both. A `photo` is a flat panel at its lens's field, a `panorama` an
+equirectangular sphere. `src` is an address (rr0.org's case pictures are served to any origin; the bytes must be, since
+WebGL draws them) or the picture itself as a `data:` URL when it was added from a disk, which keeps the recording
+self-contained at the price of its size. `credit` and `creditUrl` are shown in the info panel's credits, `t` says it
+was taken during the observation at that instant, and `drawing` that somebody drew on it — Cussac's own view from the
+spot carries the sphere and its spiral by hand.
+
+Nothing in the scene hides a picture and a picture hides nothing: it is a field of directions from one point, valid
+from that point alone, and the reconstruction stands it at the witness's eye.
+
+**Lining it up.** The editor's Pictures group types the registration, copies the witness's pose into it, and while that
+group is open the canvas belongs to the selected picture: a drag turns it, the wheel changes its field, and *Add a
+landmark* arms two clicks that name a detail on the picture, then the same detail in the render. Landmarks are kept in
+the recording with a name ("Arbre masquant", "barrière") and listed with how far each still is from fitting; either end
+of one can be dragged, and the selected one is bolder on the canvas — two landmarks turn the picture to fit them, three
+or more fit its field too (`PictureRegistration`, a triad first guess refined by Gauss-Newton on the rotation), and the
+status line says how far off the landmarks still are. *Adopt as the witness's pose* then writes the fitted heading,
+pitch and roll into the pose at the playhead as a **measurement**, with a `derived` provenance naming the picture and
+the residual — a heading read off a picture that fits the relief, where the one typed in the Witness group is the
+witness's word. *Street-level pictures nearby* asks Panoramax (open imagery, CC BY-SA, served to any origin) for
+pictures taken within 300 m of the witness's spot; each comes with where it was taken from and which way it looked, so
+it arrives registered in heading, a full turn arriving as a panorama.
+
 ### Naming a place
 
 Testimony names a place. It says "on the Valensole plateau", "near Socorro", "over Montgomery" —

package/dist-embed-scene/{UfoMessages_fr-BJPYHN17.js → UfoMessages_fr-DacU0rOw.js}

@@ -1 +1 @@
-const e={play:"Lecture",pause:"Pause",noDuration:"Aucune durée d'observation",autoReplay:"Lecture automatique",currentPosition:"Position actuelle",duration:"Durée",switchToElapsed:"cliquer pour afficher la durée écoulée",switchToClockTime:"cliquer pour afficher l'heure de l'observation",fullscreen:"Plein écran",exitFullscreen:"Quitter le plein écran",showWitnessMap:"Voir où était le témoin",hideWitnessMap:"Masquer où était le témoin",mapImageryUnavailable:"Vue aérienne indisponible",showMilestones:"Voir les moments du récit",hideMilestones:"Masquer les moments du récit",witnessHere:"Le témoin, ici",decorHere:"Élément de décor"};export{e as ufoMessages_fr};
+const e={play:"Lecture",pause:"Pause",noDuration:"Aucune durée d'observation",autoReplay:"Lecture automatique",currentPosition:"Position actuelle",duration:"Durée",switchToElapsed:"cliquer pour afficher la durée écoulée",switchToClockTime:"cliquer pour afficher l'heure de l'observation",fullscreen:"Plein écran",exitFullscreen:"Quitter le plein écran",showWitnessMap:"Voir où était le témoin",hideWitnessMap:"Masquer où était le témoin",mapImageryUnavailable:"Vue aérienne indisponible",showReferences:"Voir les photos des lieux",hideReferences:"Masquer les photos des lieux",referenceOpacity:"Opacité des photos",showMilestones:"Voir les moments du récit",hideMilestones:"Masquer les moments du récit",witnessHere:"Le témoin, ici",decorHere:"Élément de décor"};export{e as ufoMessages_fr};