|
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
|
Getting started : upload a panorama
|
|
22
|
-----------------------------------
|
|
23
|
|
|
24
|
1. Go to the index and click "Ajouter un panorama", let upload process
|
|
25
|
2. Just click on the image in the subsequent list, and wait for it to be
|
|
26
|
processed (split into tiles) ;
|
|
27
|
3. Choose "accéder directement au panorama" to view it and use the red up-right box to enter
|
|
28
|
coordinates and altitudes from where the photos have beenn taken. *bouclage*
|
|
29
|
means that left and right borders are matching exactly (360° panorama).
|
|
30
|
4. Reference some known points by right clicking (see relevant section), the
|
|
31
|
others will get interpolated and presented to you on the view.
|
|
32
|
|
|
33
|
|
|
34
|
Viewing reference points
|
|
35
|
------------------------
|
|
36
|
|
|
37
|
You'll see big colored bubbles :
|
|
38
|
|
|
39
|
* *Blue points* : reference points you referenced and pointed by hand
|
|
40
|
* *Red points* : other panorama (click and fly to it !)
|
|
41
|
* *Green points* : reference points automatically placed (estimated according to
|
|
42
|
the blue ones)
|
|
43
|
|
|
44
|
|
|
45
|
Adding reference points
|
|
46
|
----------------------------
|
|
47
|
|
|
48
|
Reference points are known points you are likely to see from your panoramas,
|
|
49
|
they are a visual reference and a way to orientate your panoramas.
|
|
50
|
|
|
51
|
By default, there are no *ref_points*, you can create your own *ref_points* list
|
|
52
|
or use one of the provided lists.
|
|
53
|
|
|
54
|
To get started, copy one of the files from `ref_points` folder in the root
|
|
55
|
folder, remane it to `ref_points.local.php` and customize it.
|
|
56
|
|
|
57
|
*Hint: prefer to register the altitudes of the topmost point of a building: they
|
|
58
|
are the easier parts to aim from other panoramas.*
|
|
59
|
|
|
60
|
|
|
61
|
Panorama view
|
|
62
|
--------------
|
|
63
|
|
|
64
|
This is the main view, you can pan and scroll a panorama.
|
|
65
|
|
|
66
|
|
|
67
|
From this view you can use the *Reference points menu*. The reference points
|
|
68
|
menu allows you to set the orientation of your panorama by pointing at a known
|
|
69
|
location you visualize on the panorama.
|
|
70
|
|
|
71
|
|
|
72
|
### Mouse interaction for panorama view ###
|
|
73
|
|
|
74
|
* *drag image* to move
|
|
75
|
* *right-click* to pop the Reference points menu
|
|
76
|
|
|
77
|
|
|
78
|
### Keyboard shortcuts for panorama view ###
|
|
79
|
|
|
80
|
* `Pgup`/`Pgdown`: zoom in/out
|
|
81
|
* `←`/`↑`/`↓`/`→`: pan the image
|
|
82
|
* `Home`/`End`: turn backwards (180°)
|
|
83
|
|
|
84
|
|
|
85
|
"Show cap" view
|
|
86
|
---------------
|
|
87
|
|
|
88
|
In this view, you see a map with your current view point and a ray between it
|
|
89
|
and your target ref_point.
|
|
90
|
|
|
91
|
Options and layers selection can be set in the `+` menu. To move from/to the, click
|
|
92
|
on *the top-right button*.
|
|
93
|
|
|
94
|
|
|
95
|
Installing
|
|
96
|
----------
|
|
97
|
|
|
98
|
You need PHP
|
|
99
|
|
|
100
|
- in your php.ini set upload_max_filesize and post_max_size to "100M" or near.
|
|
101
|
- in your httpd configuration, set the max post size accordingly
|
|
102
|
|
|
103
|
You need imagemagick. On debian : apt-get install imagemagick
|
|
104
|
|
|
105
|
Known limitations
|
|
106
|
------------------
|
|
107
|
|
|
108
|
### Cannot delete anything from the interface ###
|
|
109
|
|
|
110
|
Uploaded images nor panoramas.
|
