fixed tesselation of curtain & added docs

Author: haraldsteinlechner

PRODUCT_RELEASE_NOTES.md

@@ -1,4 +1,4 @@
-## 5.6.0-prerelease1
+## 5.6.0-prerelease2
 - added cross sections
 
 ## 5.5.0

aardium/package.json

@@ -1,7 +1,7 @@
 {
   "name": "PRo3D",
   "productName": "PRo3D.Viewer",
-  "version": "5.6.0-prerelease1",
+  "version": "5.6.0-prerelease2",
   "description": "PRo3D, short for Planetary Robotics 3D Viewer, is an interactive 3D visualization tool to allow planetary scientists to work with high-resolution 3D reconstructions of the Martian surface.",
   "license": "AGPL",
   "copyright": "VRVis Zentrum für Virtual Reality und Visualisierung Forschungs-GmbH",

docs/CrossSections.md

@@ -0,0 +1,59 @@
+# Synopsis
+
+![alt text](crossSectionTeaser.png)
+
+The cross section feature allows you to cut  surfaces and map images onto the cutting plane.
+
+# Approach
+
+## 1. Create a polyline annotation. Use subsampling if needed.
+
+![alt text](images/crossSectionAnno.png)
+
+## 2. 
+
+![alt text](images/exportProfile.png)
+
+this will look like this:
+```
+"distance","elevation"
+"0","-2540.3019554105754"
+"96.56728104292469","-2532.4515562465303"
+"146.95083969889563","-2529.7198536160195"
+"178.2109028662038","-2525.732550567427"
+"238.47366569537462","-2515.188256619444"
+"332.84560816666226","-2514.8733450224286"
+```
+
+now use the draw profile tool to create an svg/png of which shows the profile
+```
+python draw_profile.py --profile testProfile2.csv --curtain-height 100 --min-altitude -2200 --vertical-px 2000 --overlay --x-interval 20 --y-interval 20 --x-grid 25 --y-grid 1 --output profile.svg --grid-opacity 1.0 --grid-width 3.0
+```
+
+Look at the profile or the info in pro3d to find good parameters.
+
+
+Use approximate curtain height and min altitude to specify the 2d viewport of the cross section.
+
+## 3. do your interpretation & tweaking of the cross section
+
+Next convert it to a png and remember the file name.
+
+## 5. Creating the cross section
+
+Next go to annotation properties and move the caemera far away from the cross section.
+All between the annotation and the point when creating the cross section will be clipped away.
+![alt text](images/createCrossSection.png)
+
+This will leave you with the data clipped:
+![alt text](images/image.png)
+
+## 6. Setting curtain details
+
+Next choose curtain settings and set up the curtain:
+
+![alt text](images/curtainProperties.png)
+
+## 7. Inspection of cross section & curtain
+
+![alt text](images/crossSectionAndCurtain.png)

docs/images/CrossSections.md

@@ -0,0 +1,59 @@
+# Synopsis
+
+![alt text](crossSectionTeaser.png)
+
+The cross section feature allows you to cut  surfaces and map images onto the cutting plane.
+
+# Approach
+
+## 1. Create a polyline annotation. Use subsampling if needed.
+
+![alt text](images/crossSectionAnno.png)
+
+## 2. 
+
+![alt text](exportProfile.png)
+
+this will look like this:
+```
+"distance","elevation"
+"0","-2540.3019554105754"
+"96.56728104292469","-2532.4515562465303"
+"146.95083969889563","-2529.7198536160195"
+"178.2109028662038","-2525.732550567427"
+"238.47366569537462","-2515.188256619444"
+"332.84560816666226","-2514.8733450224286"
+```
+
+now use the draw profile tool to create an svg/png of which shows the profile
+```
+python draw_profile.py --profile testProfile2.csv --curtain-height 100 --min-altitude -2200 --vertical-px 2000 --overlay --x-interval 20 --y-interval 20 --x-grid 25 --y-grid 1 --output profile.svg --grid-opacity 1.0 --grid-width 3.0
+```
+
+Look at the profile or the info in pro3d to find good parameters.
+
+
+Use approximate curtain height and min altitude to specify the 2d viewport of the cross section.
+
+## 3. do your interpretation & tweaking of the cross section
+
+Next convert it to a png and remember the file name.
+
+## 5. Creating the cross section
+
+Next go to annotation properties and move the caemera far away from the cross section.
+All between the annotation and the point when creating the cross section will be clipped away.
+![alt text](createCrossSection.png)
+
+This will leave you with the data clipped:
+![alt text](image.png)
+
+## 6. Setting curtain details
+
+Next choose curtain settings and set up the curtain:
+
+![alt text](curtainProperties.png)
+
+## 7. Inspection of cross section & curtain
+
+![alt text](crossSectionAndCurtain.png)