#acl AdminGroup:read,write,revert EditorsGroup:read,write,revert All:read

##############################################################################
##############################################################################

## DE-EN_Sprachflaggen

{{{#!wiki language_selector/de
[[ de/Waypoint/WP-Generator/Panorama | {{ http://www.mikrokopter.de/addons/shared_addons/themes/mk3/img/flag_ger.png }}]]
}}}

###########################################################################
<<BR>>
<<BR>>
<<BR>>
<<BR>>
<<TableOfContents>>
<<BR>><<BR>>
###########################################################################
###########################################################################
<<BR>>


= Panorama =
Inside the '''!MikroKopter-OSD''' you will get with a "click" on the tab '''"!WayPoints"''' and on  '''"Generator..."''' into the !WayPoint-Generator.<<BR>><<BR>>

{{http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=100814&g2_serialNumber=2}} <<BR>><<BR>>

Here now you can choose the tab '''"Panorama"'''.<<BR>><<BR>>

Using the function "Panorama" you can take easily panoramas in the air.<<BR>>
Here you can preset settings, which are necessary for taking panoramas.<<BR>>
The Kopter will do so and will trigger the camera accordingly.<<BR>><<BR>>



||<|18 (width= 220px>{{http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=99188&g2_serialNumber=6}}||||<-2:#FFAD47 height= 40px>'''Description of the function:'''||
||<-2(height= 30px #FAD165>'''Panorama'''||
||<(width= 150px #FFFFAA>'''#WPs'''         ||<(height= 30px>Specifies the number of view directions in the circle (WPs) in which an image should be taken||
||<(#FFFFAA>'''Heading Offset [°]'''       ||<(height= 30px>Direction in which the first image should be taken||
||<(#FFFFAA>'''Copy MK heading'''           ||<(height= 30px>Takes over the "View Direction" of the Kopter as a start for the first image into the "Direction-offset".||
||<(#FFFFAA>'''Direction'''                 ||<(height= 30px>Direction of rotation of the Kopter in which the WPs are flown (clockwise/counter-clockwise)||
||<-2(height= 20px #FAD165>'''Waypoint'''   ||
||<(#FFFFAA>'''Radius [m]'''                ||<(height= 30px>Radius around each !WayPoint||
||<(#FFFFAA>'''Altitude [m]'''                  ||<(height= 30px>Height of the !WayPoint||
||<(#FFFFAA>                                ||<(height= 30px>||
||<(#FFFFAA>'''Cam-Nick [°]'''              ||<(height= 30px>Tilt of the camera while reaching the !WayPoint||
||<(#FFFFAA>                                ||<(height= 30px>||
||<(#FFFFAA>'''Climb rate [0.1m/s]'''        ||<(height= 30px>Speed in which the Kopter climbs/falls between the !WayPoints||
||<(#FFFFAA>'''Delay time [s]'''             ||<(height= 30px>Waiting time per !WayPoint (View direction)||
||<(#FFFFAA>'''WP event'''                  ||<(height= 30px>Here you can enter the trigger time for i.e. to trigger a camera||
||<(#FFFFAA>'''Delete existing WPs'''       ||<(height= 30px>Creating new !WayPoints will delete existing WPs||
||<(#FFFFAA>'''Generate'''                  ||<(height= 30px>Create(s) !WayPoint(s) with the set values||
||<(#FFFFAA>                                ||<(height= 30px>||

= Introduction to the panorama =

There are different types of panoramas. These may consist out of one or more rows.<<BR>>
Simply explained multiple images are combined with an overlap to form a panorama. <<BR>><<BR>>

To create a panorama out of different images you need to have an extra program.<<BR>>
Those are i.e. '''"Hugin"''', '''"PTGui"''' or '''"!PanoramaStudio"''', just to name a few. <<BR>>
Information on those programs like creating a panorama and what must be considered can be found in the Internet. <<BR>><<BR>>

 (!) '''__HINT__'''<<BR>>
 In general the programs edit the individual images from left to right, clockwise.<<BR>>
 If you don't want to sort all images by hand it is advisable to take images in a clockwise direction.
<<BR>><<BR>>

= Example 1 - Single-row Panorama =

In this example we want to take a 360° Panorama with a height of 30mtr. The camera should point straight forward.<<BR>>
For example, here we want to use a lens with a focal length of 8mm and a viewing angle of 180°.<<BR>>
To have a sufficient overlap of the images, four images should be taken in a circle. Within a 360° circle is that a photo every 90°. <<BR>><<BR>>


'''Step 1''' <<BR>>
First at all you need to mark the point in the map from where the Kopter should start to make the images.<<BR>>
Here you need to make a "Left-click" with the mouse on the appropriate spot on the map. <<BR>>
At this spot appears a marking point {{http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=100161&g2_serialNumber=1}}.<<BR>><<BR>>

'''Step 2''' <<BR>>
For that reason that 4 images should be taken for the 360° Panorama the number must be entered under "WPs".
<<BR>>
 * '''#WPs''' = 4

Now you can set and enter the view direction for the first image which should be taken.<<BR>>
That has to be done here: <<BR>>
 * '''Heading Offset [°]''' = 0

{OK} '''Hint'''<<BR>>
 Here you can either enter a degree by yourself in which direction the Kopter should point for the first image,<<BR>>
 or you place the Kopter with the front into the desired direction of the first image and you "click" on '''"Accept MK-Direction"'''.<<BR>>
 The direction of the Kopter will be taken automatically into the "Heading Offset".<<BR>><<BR>>

The direction in which the images are taken in a sequence can be entered under '''"Direction"'''. <<BR>>
Since the most of the Panorama-Programs handle images clockwise you need to choose '''"CW"''' (clockwise).<<BR>>
 * '''"Direction"''' = CW
<<BR>><<BR>>

'''Step 3''' <<BR>>

Altogether there are four !WayPoints (for the 4 images) superimposed. In order to take the images also during windy conditions the '''"Radius [m]"''' __should not__ be too small. <<BR>>
If, for example, a radius of 1mtr. will be selected and a stronger wind is blowing out the copter from the position, it would turn first to the new direction. After that the Kopter would shoot more photos when it returns exactly (+/- 1mtr.) at the previous position.<<BR>>
However, that can be very difficult with stronger wind and it would need a long time. <<BR>><<BR>>

We want to set here a radius of 10mtr.<<BR>>
 * '''"Radius [m]"''' = 10

The Kopter should take the images out of a height of 30mtr. That will be entered under "Height".<<BR>>
 * '''"Altitude [m]"''' = 30

For all photos the camera should point straight forward. For that reason the camera tilt will be entered with 0°.<<BR>>
 * '''"Camera tilt [°]"''' = 0

The '''Climb rate''' can be ignored for the panorama scene in the same height. <<BR>>
If you want to take the photos in different heights you need to set the speed <<BR>>
in which the !WayPoints should be flown at that specific height.<<BR>><<BR>>

To get several images per view direction (not all images are sharp!) you need to set the Waiting Time per !WayPoint and the WP-Event.
 * '''"Delay Time: [s]"''' = 10
 * '''"WP event"''' = 100

'''Step 4''' <<BR>>

Those set up !WayPoints must be created now. Here you just need to "click" on '''"Generate"'''.

 (!) '''Hint'''<<BR>>
 Is '''"Delete existing WPs"''' marked, with each "click" on "Generate" already existing !WayPoints on the map will be deleted.<<BR>>
 If you take off the checkmark you can place i.e. several !WayPoints overlaped or at different places on the map.<<BR>><<BR>><<BR>>


'''Example View:''' <<BR>>
[[http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101311&g2_serialNumber=1|{{http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101313&g2_serialNumber=2}}]]
<<BR>><<BR>>

After a "click" on the button '''"Generate"''' the !WayPoints with the settings will be entered automatically into the '''!WayPoint-Editor'''. <<BR>>
Under '''"Heading"''' you will see the alignment of the individual images: <<BR>><<BR>>

[[http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101331&g2_serialNumber=1|{{http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101333&g2_serialNumber=2}}]]
<<BR>><<BR>>


After that the 4 !WayPoints need to be entered into the map one above the other: <<BR>><<BR>>

[[http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101401&g2_serialNumber=1|{{http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101404&g2_serialNumber=2}}]]
<<BR>><<BR>>

Now you can transfer the !WayPoints to the Kopter and been flown. How this works is described under [[#Wegpunkteflug|"The WayPoint-Flight"]].
<<BR>><<BR>>

= Example 2 - Multi-row panorama =

In this example we want to take also a 360° panorama out of a height of 30mtr. <<BR>>
Here, the camera should point first straight forward, then inclined 45° downwards and finally we want to take an image straight downwards.<<BR>><<BR>>

Used will be for example a lens with a focal length of 8mm and a viewing angle of 180°.<<BR>>
To get a sufficient overlap of the images, 4 images should be taken per circle. With a 360° circle is that an image every 90°.<<BR>><<BR>>

'''First Step'''<<BR>>
In the first step you need to make the settings in that way like described in '''example 1'''. <<BR>>
If you have transfered those first settings into the map you need to make only two different changes. <<BR>>

'''Second Step'''<<BR>>
In the "First Step" all was set for the first images with a view "straight forward".<<BR>>
So that the camera should take in the second round all images 45° inclined it need to be set under '''"Camera tilt"'''.
  * '''"Camera tilt [°]"''' = 45

So that you get the following shots seamlessly after the first shots you need to remove the checkmark in "Delete existing WPs".<<BR>><<BR>>

Those set up !WayPoints you need to create now. Here you need to "click" on '''"Generate"'''.
<<BR>><<BR>>

[[http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101321&g2_serialNumber=1|{{http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101323&g2_serialNumber=2}}]]
<<BR>><<BR>>

After a "click" on "Generate" (4) the first !WayPoints (No. 1-4) will be entered into the Editor.<<BR>>
Then, after changing the tilt (5) and removing the check mark in "Delete existing WPS" (6) and "clicking" again on "Generate" (7) the new !WayPoints (No. 5-8) with the new tilt appears in the editor under the already existing ones: 
<<BR>><<BR>>

[[http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101341&g2_serialNumber=1|{{http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101343&g2_serialNumber=2}}]]
<<BR>><<BR>>

In the map the second panorama-entry will be placed over the existing one: 
<<BR>><<BR>>

[[http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101401&g2_serialNumber=1|{{http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101404&g2_serialNumber=2}}]]
<<BR>><<BR>>



'''Third Step'''<<BR>>
In the last step we want set the camera in that way that it points for the last image straight downwards. <<BR>><<BR>>

Here you can set in the '''"!WayPoint Editor"''' a new !WayPoint by yourself. Just "click" on '''!WayPoint''' and '''Add'''. <<BR>>
This automatically creates a new !WayPoint with the settings of the last !WayPoint. <<BR>><<BR>>

For the last !WayPoint No.9 you just need to set a new camera tilt.<<BR>>
Continue with "click" on the entry '''"45"''' (45°) and open with the button '''"F2"''' the Editor.<<BR>>
Here now you need to enter the new camera tilt with '''"90"''' (90°) and just confirm it with '''"Enter"'''.
<<BR>><<BR>>

[[http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101350&g2_serialNumber=1|{{http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=101353&g2_serialNumber=2}}]]
<<BR>><<BR>>

Now the !WayPoints can be transferred to the Kopter and been flown. How that works is described under [[#Wegpunkteflug|"The WayPoint-Flight"]].
<<BR>><<BR>>

= Settings to trigger the camera =
In our '''Example 1+2''' the camera was triggered per !WayPoint. Here the time was set under '''WP event'''.<<BR>><<BR>>

<<Anchor(WP-Event)>> 
Those settings are described here: [[en/WaypointEvent|WP-Event Trigger camera]]<<BR>><<BR>>

Alternatively the camera can be triggered continuously. Here you need to make two settings in the '''!KopterTool''' under the tab '''Outputs'''. <<BR>><<BR>>

<<Anchor(Kamera)>> 
Those settings are described here: [[en/CameraConnect#Kamera|Triggering camera permanently]]

<<Anchor(Wegpunkteflug)>>
= The WayPoint-Flight =
The settings are made and the !WayPoints created.<<BR>><<BR>>

In the next step the !WayPoints will be transfered to the Kopter (See also: [[en/MikroKopterTool-OSD#Transfer_WayPoints_to_the_Kopter|Transfer waypoints]]).<<BR>>
Bevor the start, the camera mount will be aligned in that way that the camera points straight forward (horizontally).<<BR>><<BR>>

{{http://gallery.mikrokopter.de/main.php?g2_view=core.DownloadItem&g2_itemId=104373&g2_serialNumber=2}}<<BR>><<BR>>

Now you can start the Kopter and "park" it in the air. Activate the function '''"Hold Height"''' and '''"!PositionHold"'''. <<BR>><<BR>>

So that the Kopter and the camera align itself (Kopter should show southward) you need to activate the function '''"!CareFree"'''.<<BR>><<BR>>

In order to start now the !WayPoint-Flight the GPS-Switch must be set to '''"!ComingHome"'''.<<BR>>
Directly after switching, the Kopter starts with the !WayPoint-Flight.<<BR>><<BR>>

Is the !WayPoint-Flight done the Kopter stops at the last !WayPoint. Now you can fly your Kopter back manually and land it.<<BR>>
You can set also the GPS-Switch to "OFF" and after that to "!ComingHome". The Kopter will fly automatically back to the start-point.

= example panorama =

Here is an example of a panorama, that was made as shown in the example above.<<BR>><<BR>>

With the left pressed button of your mouse you can move the panorama. <<BR>><<BR>>

<<Pano2VR(104481)>>