added test plans for multitexture, contour-lines and cutout geometry

pro3d-space · Feb 8, 2024 · ebc7600 · ebc7600
1 parent d70ca82
commit ebc7600
Show file tree

Hide file tree

Showing 23 changed files with 17,127 additions and 2 deletions.
diff --git a/docs/tests/contourLines.md b/docs/tests/contourLines.md
@@ -0,0 +1,24 @@
+# Layered OPCs
+
+Goal: [Countour lines](../Contour-Lines.md) can be mapped onto secondary textures of [multilayer opcs](../Feature-Multitexture.md). Contour distance can be specified, the lines should appear as anti-aliased lines given a line width.
+
+Dependent tests: [layers](./layers.md)
+
+Approach:
+ - import of OPC data
+ - changing visualization properties to use secondary texture
+ - apply contour line onto secondary texture
+ - save/load of scenes and check whether all properties are restored properly
+
+Out-of-scope:
+ - Multitextured OBJs
+
+Data needed: OPC with layers, e.g. Dimorphos, HeraV3.
+
+Steps:
+ - [ ] run the [layers](./layers.md) test
+ - [ ] Check whether counturs tab in the surface window appears
+ ![](./images/contours1.png)
+ - [ ] For eleveation as layer, choose distance/width/border accordingly:
+ ![](./images/contours2.png)
+ Note: Lines should be crisp and anti-aliased. In the current screenshot above those are not. When we get higher-resolution layer this image will be updated.
diff --git a/docs/tests/cutoutGeometry.md b/docs/tests/cutoutGeometry.md
@@ -0,0 +1,35 @@
+# Cutout geometry
+
+Goal: Perform annotations on a [multilayer](../Feature-Multitexture.md) opc and export cut-out geometry described by the annotation.
+
+Dependent tests: [layers](./layers.md)
+
+Approach:
+ - import of OPC data
+ - perform an annotation
+ - use vscode nodebook to run a demo [notebook](../../notebooks/CutoutDemo.ipynb) to create an obj of the cutout geometry
+
+Prerequisited:
+ - vscode with: ionide & polyglot notebook extension
+
+Out-of-scope:
+ - Multitextured OBJs
+
+Data needed: OPC with layers, e.g. Dimorphos, HeraV3.
+
+Steps:
+ - [ ] start PRo3D with the the pro3d api enabled using the command line flag (`--remoteApi `) or the predefined launch profile
+ ![](./images/cutout1.png)
+ - [ ] run the [layers](./layers.md) test
+ - [ ] open vscode in PRo3D root/notebooks and open the [cutout notebook](../../notebooks/CutoutDemo.ipynb).
+ ![](./images/cutout2.png)
+ - [ ] run the first cell and check the result (should be a green tickbox)
+ ![](./images/cutout3.png)
+ - [ ] create a annotation which forms a convex polygon
+ ![](./images/cutout4.png)
+ ![](./images/cutout5.png)
+ - [ ] run the next cell in the notebook. First it should print the ID of the annotation created:
+ ![](./images/cutout6.png)
+ - [ ] next it should print filtered vertices. Next check the result.obj - does it contain geometry representing the cotout, colored with elevation values:
+ ![](./images/cutout7.png)
+ ![](./images/cutout8.png)
diff --git a/docs/tests/images/contours1.png b/docs/tests/images/contours1.png
diff --git a/docs/tests/images/contours2.png b/docs/tests/images/contours2.png
diff --git a/docs/tests/images/cutout1.png b/docs/tests/images/cutout1.png
diff --git a/docs/tests/images/cutout2.png b/docs/tests/images/cutout2.png
diff --git a/docs/tests/images/cutout3.png b/docs/tests/images/cutout3.png
diff --git a/docs/tests/images/cutout4.png b/docs/tests/images/cutout4.png
diff --git a/docs/tests/images/cutout5.png b/docs/tests/images/cutout5.png
diff --git a/docs/tests/images/cutout6.png b/docs/tests/images/cutout6.png
diff --git a/docs/tests/images/cutout7.png b/docs/tests/images/cutout7.png
diff --git a/docs/tests/images/cutout8.png b/docs/tests/images/cutout8.png
diff --git a/docs/tests/images/layers1.png b/docs/tests/images/layers1.png
diff --git a/docs/tests/images/layers2.png b/docs/tests/images/layers2.png
diff --git a/docs/tests/images/layers3.png b/docs/tests/images/layers3.png
diff --git a/docs/tests/images/layers4.png b/docs/tests/images/layers4.png
diff --git a/docs/tests/images/layers4_1.png b/docs/tests/images/layers4_1.png
diff --git a/docs/tests/images/layers5.png b/docs/tests/images/layers5.png
diff --git a/docs/tests/layers.md b/docs/tests/layers.md
@@ -0,0 +1,32 @@
+# Layered OPCs
+
+Goal: OPCs with multiple texture layers can be visualized, its pixel information can be blended and mapped using a transfer function. The (surface) properties can be saved and reloaded from scene files.
+
+Approach:
+ - import of OPC data
+ - changing visualization properties
+ - save/load of scenes containing layered opcs
+
+Out-of-scope:
+ - Multitextured OBJs
+
+Data needed: OPC with layers, e.g. Dimorphos, HeraV3.
+
+Test needs to be done manually, by importing multilayer opcs:
+ - [ ] Import OPC, surface gets visible
+    ![](./images/layers1.png)
+    ![](./images/layers2.png)
+ - [ ] Select Surface, surface properties get visible
+    ![](./images/layers3.png)
+ - [ ] Change visualization properties, change properties and check result visually
+    * check whether *all* layers are available as primary texture
+
+    ![](./images/layers4.png)
+    Check whether they match the layers in opcx.json file:
+
+    ![](./images/layers4_1.png)
+    * perform blending, choose a color map and check wether two layers can be visualizated properly
+
+    ![](./images/layers5.png)
+ - [ ] Save the scene
+ - [ ] Check whether the visualization properties appear as tested befor saving.
diff --git a/provex/CutoutDemo.ipynb → notebooks/CutoutDemo.ipynb b/provex/CutoutDemo.ipynb → notebooks/CutoutDemo.ipynb
diff --git a/provex/RemoteApi.ipynb → notebooks/RemoteApi.ipynb b/provex/RemoteApi.ipynb → notebooks/RemoteApi.ipynb
diff --git a/notebooks/result.obj b/notebooks/result.obj
diff --git a/src/PRo3D.Viewer/Properties/launchSettings.json b/src/PRo3D.Viewer/Properties/launchSettings.json
@@ -2,13 +2,17 @@
   "profiles": {
     "PRo3D.Viewer": {
       "commandName": "Project",
-      "commandLineArgs": "",
       "nativeDebugging": true
     },
-	"PRo3D.Viewer.Provex": {
+    "PRo3D.Viewer.Provex": {
       "commandName": "Project",
       "commandLineArgs": "--disableCors --port 4321 --remoteApi --enableProvenance",
       "nativeDebugging": true
+    },
+    "PRo3D.RemoteApi": {
+      "commandName": "Project",
+      "commandLineArgs": "--disableCors --port 4321 --remoteApi",
+      "nativeDebugging": true
     }
   }
 }