====== GPS Photography ======

In the 'GPS Photography' tab, imported GPS photos can be selected, viewed, edited and inventorised. All imported GPS photos are added to the 'GPS Photos' dataset and visualised on map as an arrow. Additional photos from a GPS camera can be imported.  

{{  orbitgis_extensions_mi:asset_inventory:gps_photography:use:gps_tab_v4.png?nolink  }}  \\  \\

===== GPS photos =====
A GPS photo contains the following properties:
  * **Location**: A GPS photo is visualised on map as an arrow. The location of the arrow represents the point of view. It is the location where the photo was taken (= location of the photographer), not the location of the photographed object. Note that GPS coordinates are based on the WGS-84 reference system. 
  * **Direction**: The direction of the arrow indicates the direction in which the photographer was looking. The photographed object can therefore be found in the indicated direction.
  * **Type**: Photos are grouped by type (eg trees, street furniture, roadworks, ...). The available types can be found in a dropdownlist next to "Selected TAG :". The color of an arrow indicates to which type it is assigned. Further details are provided in the legend of the 'GPS photos' dataset. 
  * **The actual picture**: A selected photo is displayed in the central part of the 'GPS Photography' tab.  \\  \\

===== Import Photos =====

The GPS Photography procedure “Import photos” allows the Orbit user to import new GPS photos. 

=== Procedure ===

  - **Launch** the procedure "Import photos".\\ \\ {{orbitgis_extensions_mi:asset_inventory:gps_photography:use:open_procedure_v1.png?nolink}} \\ \\
  - **Import** : import GPS photos   
      - Browse to the folder where your GPS photos are located.  \\  If photos include a TAG, they will automatically be assigned to the according type\\ \\ {{orbitgis_extensions_mi:asset_inventory:gps_photography:use:import_photos_v2.png?nolink300  }}Select the according folder \\ \\ {{:orbitgis_extensions_mi:asset_inventory:gps_photography:use:open_folder.png?nolink300}} \\ \\ \\ \\
      - Click the 'Import Photos' button \\ Depending on the image size and the number of photos this might take a couple of minutes. \\  \\  {{orbitgis_extensions_mi:asset_inventory:gps_photography:use:import_photos_tags.png?nolink300}}  \\  \\
      - A popup window automatically opens when the import of gps photos has completed. It also shows some information about the import:\\ \\ 
          * the number of succesfully imported photos\\
          * the number of photos in the folder that were imported previously\\
          * the number of imported photos that didn't include a TAG. These are automatically assigned to the 'Default' type.  \\  \\  {{orbitgis_extensions_mi:asset_inventory:gps_photography:use:import_finished.png?nolink200}}\\ \\
  - **Finish** the procedure by clicking the square button.  \\  \\ 


===== Selecting, viewing and editing GPS Photos =====

==== Selecting and Opening a GPS Photo ==== 

GPS Photos can be selected in two ways:    
{{  orbitgis_extensions_mi:asset_inventory:gps_photography:use:select.png?nolink}}
{{  orbitgis_extensions_mi:asset_inventory:gps_photography:use:arrow_v2.png?nolink}}                                    

**Selection on the MapCanvas**
  - Make sure the GPS Photos dataset is visible. 
  - Select an arrow on map.\\ 
Accordingly the GPS photo is selected in the GPS Photography tab.
\\ \\ \\
**Selection from the GPS Photography tab**
  - Choose a type from the drop-down list next to "Selected TAG:". All GPS photos that include this TAG will be browsable. 
  - Select a GPS photo in the list. The photo appears in the central part of the GPS Photography tab. The corresponding arrow from the GPS photos dataset is centered in the MapCanvas.\\ \\

==== Viewing a selected GPS Photo ====

For viewing selected GPS photos in the gray box, some handlers and tools are provided: 

{{  orbitgis_extensions_mi:asset_inventory:gps_photography:use:view2.png?nolink}}

^ Mouse Events ^^^
|{{orbitgis_extensions_mi:asset_inventory:gps_photography:use:pan.png?nolink}} | Move | Drag the selected GPS photo within the gray box to the desired position.| 
|{{orbitgis_extensions_mi:asset_inventory:gps_photography:use:mouse.png?nolink}}| Zoom in/out| Scroll mouse to zoom in and out.|
^ Toolbar ^^^
| {{orbitgis_extensions_mi:asset_inventory:gps_photography:use:max.png?nolink}} | Maximize | Maximize the selected GPS photo within the gray box. | 
| {{orbitgis_extensions_mi:asset_inventory:gps_photography:use:copy.png?nolink}} | Copy | Copy the GPS photo to the clipboard.|
| {{orbitgis_extensions_mi:asset_inventory:gps_photography:use:save.png?nolink}} | Save | Save the GPS photo in a folder on your local computer.|
| {{orbitgis_extensions_mi:asset_inventory:gps_photography:use:focus.png?nolink}} | Focus | Center the location of the GPS photo in the MapCanvas.|
| {{orbitgis_extensions_mi:asset_inventory:gps_photography:use:show.png?nolink}} | Show | Show the GPS photo in an external viewer.| {{  :orbitgis_extensions_mi:asset_inventory:gps_photography:use:view.png?nolink}}
 \\
==== Using and Editing GPS Photos ====

{{  orbitgis_extensions_mi:asset_inventory:gps_photography:use:edit.png?nolink}}

^ Inventory ^^^
| Add to Inventory | Start [[1813:desktop_ext:asset_inventory:add_item|inventory procedure]] and keep the GPS photo in list. ||
| Add and remove photo | Start [[1813:desktop_ext:asset_inventory:add_item|inventory procedure]] and remove the GPS photo from list. ||
| Remove without adding to inventory | Delete the GPS photo without inventorising. ||
^ Edit photo properties ^^^
| Update TAG to | Select a TAG type and click the 'Update TAG to' button. ||
| Update position | {{orbitgis_extensions_mi:asset_inventory:gps_photography:use:position.png?nolink }} | Click 'Update position' and drag the arrow around in the MapCanvas. |
| Update orientation | {{orbitgis_extensions_mi:asset_inventory:gps_photography:use:rotate.png?nolink}} | Click 'Update orientation' and adjust the orientation of the arrow. |
| Place | In case no position and orientation are provided, 'Place' is enabled to set these. ||
 \\