Project

General

Profile

Paste
Download (3.57 KB) Statistics
| Branch: | Revision:

root / README.md @ afe20e9f

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 easire 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
### Saving of ref_points in a panorama  ###
100

    
101
To make the position of ref points within a panorama permanents, you should
102
define them when configuring the panorama (see 3. of *Getting
103
started*). Otherwise, you have to configure them every time you view the
104
panorama.
105

    
106
A workaround is to delete the tiles/<pano name>/<pano name>.params file to get
107
prompted for parameters again, but lat/lon/alt are lost again.
108

    
109
### Cannot delete anything from the interface ###
110

    
111
Uploaded images nor panoramas.