.. include:: <isonum.txt>

Schrägluftbildebenen und View erstellen
========================================

In den folgenden Abschnitten wird erörtert, welche Daten für die Verarbeitung
von Schrägluftbildern in PlexMap benötigt werden und mit welchen Switchboard-Funktionen
die Daten in den Datentyp "Trapeze" umgewandelt werden.

Schließlich können die Trapeze mitsamt den Bilder in Ebenen gespeichert und
in einer View dargestellt werden.

Quelldaten
----------

Um Schrägluftbilder in einer View anzuzeigen, sollten folgende Daten vorliegen:

 * **Footprints**:
    Polygone der Bildeckkoordinaten in Lage und Höhe
 * **Kameraposition**:
    Koordinaten der Aufnahmezentren in Lage und Höhe
 * **Kameraparameter**:
    Kamerakonstante, Bildhöhe, Bildbreite
 * **Schrägluftbilder**:
    Bilddateien

.. _trapeze-create:

Trapeze erzeugen
----------------

Die aufbereiteten Daten werden mit ``oblique.trapeze.create``
in den Datentyp "Trapeze" umgewandelt.

.. image:: oblique_layers_and_view_0.png

Für jedes Schrägluftbild müssen folgende Daten vorliegen:

``oblique.trapeze.create``
 * ``footprint``: Footprint Polygone (Polygon-Feature mit vier Eckpunkten)
 * ``projection_center``: Kamerapositionen (Point-Feature mit Z-Koordinate)
 * ``image_name``: Namen der Bilddateien
 * ``image_width``: Bildbreiten (in Pixel)
 * ``image_height``: Bildhöhen (in Pixel)
 * ``camera_constant``: Kamerakonstante
 * ``direction``: Aufnahmerichtungen *[north, east, west, south]* (optional)

Aufnahmerichtung bestimmen
-------------------------

Wurden die Aufnahmerichtungen in :ref:`trapeze-create` nicht angegeben,
müssen diese mit ``oblique.trapeze.orientation`` ermittelt und
mit ``properties.set`` an die Trapeze als Attribut mit Schlüssel ``Direction``
gesetzt werden.

.. image:: oblique_layers_and_view_1.png

Attributname der Aufnahmezentren angeben:

``oblique.trapeze.orientation``
 * ``trapeze``: Trapeze
 * ``x_field``: ProjectionCenterX
 * ``y_field``: ProjectionCenterY

Attribut mit Schlüssel ``Direction`` setzen:

``properties.set``
 * ``objects``: Trapeze
 * ``key``: Direction
 * ``value``: Aufnahmerichtungen

Nach Aufnahmerichtung aufteilen
-------------------------------

Um die Trapeze in die jeweiligen Aufnahmerichtungen aufzuteilen wird
``oblique.trapeze.split_by_directions`` verwendet.

.. image:: oblique_layers_and_view_2.png

``oblique.trapeze.split_by_directions``
 * ``trapeze``: Trapeze

Trapeze in Layer speichern
--------------------------

Für jede Aufnahmerichtung wird ein Layer mit dem Ebenentyp ``Oblique TMS`` erstellt.
Die Trapeze und Bilddateien mittels ``layer.store`` in die Layer speichern.

.. image:: oblique_layers_and_view_3.png

``layer.store``
 * ``0``: Trapeze
 * ``1``: Bilddateien
 * ``layer``: Oblique Layer


View konfigurieren
------------------

Zunächst wird eine neue View erstellt und den *Startansicht* |rarr| *Startmodus*
auf ``Schrägluftbilder (Oblique)`` gestellt.

.. image:: oblique_layers_and_view_4.png

Anschließend die einzelnen Layer in den Einstellungen *Tools* |rarr| *Schrägluftbilder*
definieren.

.. image:: oblique_layers_and_view_5.png