1
|
Panorama-ttnn
|
2
|
=============
|
3
|
|
4
|
*Visualize a collection of panoramic photos.*
|
5
|
|
6
|
**Panorama-ttnn** allows you to upload/share/visualize panoramic photos. It has been
|
7
|
created for evaluating lines-of-sight for radio networks, like the one of
|
8
|
[tetaneutral.net](http://tetaneutral.net).
|
9
|
|
10
|
Features
|
11
|
--------
|
12
|
|
13
|
* **Upload** panoramas to web server (i.e: made with [Hugin](hugin.sf.net));
|
14
|
* **visualize**, pan and zoom panoramas, as if you were on site;
|
15
|
* **georeference** panoramas : set GPS coordinates and elevation by hand and set
|
16
|
orientation by pointing at known points;
|
17
|
* **visualize a point** by lat/lon/elevation on your panorama ;
|
18
|
* **see other panoramas** locations to evaluate the lines-of-sight;
|
19
|
* **view on map** for a given LOS between two points/panoramas.
|
20
|
|
21
|
|
22
|
Getting started : upload a panorama
|
23
|
-----------------------------------
|
24
|
|
25
|
1. Go to the index and click "Ajouter un panorama", let upload process
|
26
|
2. Just click on the image in the subsequent list, and wait for it to be
|
27
|
processed (split into tiles) ;
|
28
|
3. Choose "accéder directement au panorama" to view it and use the red up-right box to enter
|
29
|
coordinates and altitudes from where the photos have beenn taken. *bouclage*
|
30
|
means that left and right borders are matching exactly (360° panorama).
|
31
|
4. Reference some known points by right clicking (see relevant section), the
|
32
|
others will get interpolated and presented to you on the view.
|
33
|
|
34
|
|
35
|
Viewing reference points
|
36
|
------------------------
|
37
|
|
38
|
You'll see big colored bubbles :
|
39
|
|
40
|
* *Blue points* : reference points you referenced and pointed by hand
|
41
|
* *Red points* : other panorama (click and fly to it !)
|
42
|
* *Green points* : reference points automatically placed (estimated according to
|
43
|
the blue ones)
|
44
|
|
45
|
|
46
|
Adding reference points
|
47
|
----------------------------
|
48
|
|
49
|
Reference points are known points you are likely to see from your panoramas,
|
50
|
they are a visual reference and a way to orientate your panoramas.
|
51
|
|
52
|
By default, there are no *ref_points*, you can create your own *ref_points* list
|
53
|
or use one of the provided lists.
|
54
|
|
55
|
To get started, copy one of the files from `ref_points` folder in the root
|
56
|
folder, remane it to `ref_points.local.php` and customize it.
|
57
|
|
58
|
*Hint: prefer to register the altitudes of the topmost point of a building: they
|
59
|
are the easier parts to aim from other panoramas.*
|
60
|
|
61
|
|
62
|
Panorama view
|
63
|
--------------
|
64
|
|
65
|
This is the main view, you can pan and scroll a panorama.
|
66
|
|
67
|
|
68
|
From this view you can use the *Reference points menu*. The reference points
|
69
|
menu allows you to set the orientation of your panorama by pointing at a known
|
70
|
location you visualize on the panorama.
|
71
|
|
72
|
|
73
|
### Mouse interaction for panorama view ###
|
74
|
|
75
|
* *drag image* to move
|
76
|
* *right-click* to pop the Reference points menu
|
77
|
|
78
|
|
79
|
### Keyboard shortcuts for panorama view ###
|
80
|
|
81
|
* `Pgup`/`Pgdown`: zoom in/out
|
82
|
* `←`/`↑`/`↓`/`→`: pan the image
|
83
|
* `Home`/`End`: turn backwards (180°)
|
84
|
|
85
|
|
86
|
"Show cap" view
|
87
|
---------------
|
88
|
|
89
|
In this view, you see a map with your current view point and a ray between it
|
90
|
and your target ref_point.
|
91
|
|
92
|
Options and layers selection can be set in the `+` menu. To move from/to the, click
|
93
|
on *the top-right button*.
|
94
|
|
95
|
|
96
|
Known limitations
|
97
|
------------------
|
98
|
|
99
|
### Cannot delete anything from the interface ###
|
100
|
|
101
|
Uploaded images nor panoramas.
|