Projet

Général

Profil

Paste
Télécharger (3,41 ko) Statistiques
| Branche: | Révision:

root / README.md @ e5dbdbd0

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.