Initial commit

Lts/Application/THP/README.txt

@@ -0,0 +1,101 @@
+#
+# 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
+