#
# Hinweise für das THP
#
# $Id$
# $HeadURL$
# $Author$
#

N. Thoden, 12.03.2020

Das TakeHomePackage (für Windows) besteht aus 3 Komponenten:
============================================================

1) den THP-Viewer / THP-Starter
   (inkl. Qt ;  ohne MSVCRuntime, z.B. msvcr120.dll, in C:\Windows\system32 !?)
   http://jenkins-master.sl.defence-elec.de:8080/job/ahtc_OC-Tablet/
   thp.tgz
2) die Kartendaten
   (evtl. für den Datenträger reduziert in Bezug auf die Speichergröße)
3) die Topic-Daten (Video, Audio, DB-Abzug...)


Woher kommt was?
================
1) Der THP-Viewer / THP-Starter
   Kann aus der CI-Umgebung (Jenkins) heruntergeladen werden (thp.tgz)
   Am besten mit 7Zip entpackt werden:
   (tgz -> gepackt und anschliessend komprimiert)
    - Per Kontext-Menue "entpacken nach hier"
    - die resultierende Datei "thp' "entpacken nach thp~".
    Dann sollte ein Verzeichnis "thp" MIT diversen Unterverzeichnissen entstehen.

   Das THP-Verzeichnis wird auf jeder Workstation im Ordner /opt/THP als Quelle für den USB-Datentraeger bereitgestellt.

2) Diese werden manuell für das THP bereitgestellt (meist als tpk-Datei).

3) Die Topic-Daten werden in der OpApp mit "Präsentation exportieren" erzeugt.
   Sie werden unter /tmp/THP-Export generiert.


Woher kommt das Verzeichnis 'Maps'?
===================================
Der Verzeichnisname 'Maps' ist fest und darf nicht verändert werden.
Es müssen die für das Medium (CD, DVD, Stick..) passenden Basiskarten/Kartendaten hinein.
Das sind also z.B.
  - 2020-03-03_UaeAerial_32639_Lvl6.tpk
  - 2020-03-03_UaeAerial_WebMerc_Lvl15.tpk
  - 2020-03-03_UaeTopo_32639_Lvl6.tpk
  - 2020-03-03_UaeTopo_WebMerc_Lvl15.tpk
  - AHTC_utm_dgm_surface_wgs84.tif

Das layerMapping.json hat nun die Aufgabe, diese (für das Übungsgebiet) spezifischen
Dateinamen zu abstrahieren.
Die bei der Ausführung des THPs geforderten Basiskarten (Annahme: eine Topo und zwei Aerial)
können mit Hilfe der layerMapping.json auf eine geringere Anzahl Dateien gemappt werden.

Basiskarten: Mapping per layerMapping.json
   in der WS-App:                           Dateien in Dir 'Maps'
   --------------                           ---------------------
 - Aerial2            ->                    2020-03-03_UaeAerial_32639_Lvl6.tpk
 - Aerial1            ->                    2020-03-03_UaeAerial_32639_Lvl6.tpk
 - Topo               ->                    2020-03-03_UaeTopo_32639_Lvl6.tpk

Best Practise:
Daher ergibt es Sinn, eine layerMapping.json in dem Verzeichnis 'Maps' vorzubereiten
und beim Zusammengefügen in die darüberliegende Dateiebene zu kopieren.


Wie müssen die 3 Komponenten zusammengefügt werden?
===================================================

Device:
  - Excersise_6
    - 1                          <- Übungsdaten (Komponenten 3)
      - ...
    - index.html                 <- Übungsdaten (Komponenten 3)
    - ...                        <- Übungsdaten (Komponenten 3)

    - Maps                       <- Kartendaten (Komponenten 2)
      - *.tpk
      - [layerMapping.json]      <- Sonderfall AHTC 03/2020: Diese Datei in
                                    die darüberliegende Ebenen verschieben.
    - layerMapping.json          <- Übungsdaten (Komponenten 2/3)
                                    (generiert, Sonderfall AHTC 03/2020:
                                    aus 'Maps' hierher transferieren)

    - thp                        <- thp (Komponenten 1)
      - resources                <- thp (Komponenten 1), hat mal gefehlt)
      - thv_viewer.exe           <- thp (Komponenten 1)
      - vc.redist.x64.exe        <- thp (Komponenten 1), für MSVCRuntime
    - thp_starter.exe            <- thp (Komponenten 1)
    - autorun.inf                <- thp (Komponenten 1)
    - [wappen.png]               <- thp (Komponenten 1 oder 3) optional !?


Logfiles zuir Fehlersuche
=========================
Ein Logfile befindet sich unter ~Benutzer\AppData\Local\Temp\.
Bsp: C:\User\thoden\AppData\Local\Temp\thoden_thp.log
     C:\User\thoden\AppData\Local\Temp\thoden_thp.log.1