Orthographic projection cli option (#1315)

Includes

 - The command line option
 - The test case for the command line option
 - Document correction in OPTIONS.md

application/F3DOptionsParser.cxx

@@ -392,6 +392,7 @@ void ConfigurationOptions::GetOptions(F3DAppOptions& appOptions, f3d::options& o
     this->DeclareOption(grpCamera, "camera-zoom-factor", "", "Camera zoom factor (non-zero)", appOptions.CameraZoomFactor, HasDefault::YES, MayHaveConfig::YES, "<factor>");
     this->DeclareOption(grpCamera, "camera-azimuth-angle", "", "Camera azimuth angle (in degrees), performed after other camera options", appOptions.CameraAzimuthAngle, HasDefault::YES, MayHaveConfig::YES, "<angle>");
     this->DeclareOption(grpCamera, "camera-elevation-angle", "", "Camera elevation angle (in degrees), performed after other camera options", appOptions.CameraElevationAngle, HasDefault::YES, MayHaveConfig::YES, "<angle>");
+    this->DeclareOption(grpCamera, "camera-orthographic", "", "Use an orthographic camera", options.getAsBoolRef("scene.camera.orthographic"), HasDefault::YES, MayHaveConfig::YES);
 
 #if F3D_MODULE_RAYTRACING
     auto grp5 = cxxOptions.add_options("Raytracing");

application/testing/CMakeLists.txt

@@ -154,6 +154,7 @@ f3d_test(NAME TestColormap DATA IM-0001-1983.dcm ARGS --scalars --roughness=1 --
 f3d_test(NAME TestCameraConfiguration DATA suzanne.obj ARGS --camera-position=0,0,-10 -x --camera-view-up=1,0,0 --camera-focal-point=1,0,0 --camera-view-angle=20 --camera-azimuth-angle=40 --camera-elevation-angle=-80 --camera-direction=12,34,56 --camera-zoom-factor=78)
 f3d_test(NAME TestCameraDirection DATA suzanne.obj ARGS --camera-direction=-1,-1,1 DEFAULT_LIGHTS)
 f3d_test(NAME TestCameraClipping DATA checkerboard_colorful.obj CONFIG ${F3D_SOURCE_DIR}/testing/configs/checkerboard_colorful.json RESOLUTION 800,600)
+f3d_test(NAME TestCameraOrthographic ARGS --camera-orthographic DATA cow.vtp DEFAULT_LIGHTS)
 f3d_test(NAME TestToneMapping DATA suzanne.ply ARGS -t DEFAULT_LIGHTS)
 f3d_test(NAME TestDepthPeelingToneMapping DATA suzanne.ply ARGS --opacity=0.9 -pt DEFAULT_LIGHTS)
 f3d_test(NAME TestVolume DATA HeadMRVolume.mhd ARGS -v --camera-position=127.5,-400,127.5 --camera-view-up=0,0,1 LONG_TIMEOUT THRESHOLD 300 DEFAULT_LIGHTS) # Using default lights because of ResetCamera, High threshold for volume as it is dependent on the OpenGL implementation

doc/libf3d/OPTIONS.md

@@ -23,7 +23,7 @@ scene.animation.speed-factor|double<br>1<br>render|Set the animation speed facto
 scene.animation.frame-rate|double<br>60<br>render|Set the animation frame rate used to play the animation interactively.|\-\-animation-frame-rate
 scene.camera.index|int<br>-1<br>load|Select the scene camera to use when available in the file.<br>Any negative value means automatic camera.<br>The default scene always uses automatic camera.|\-\-camera-index
 scene.up-direction|string<br>+Y<br>load|Define the Up direction|\-\-up
-camera.orthographic|bool<br>false<br>load|Toggles between orthographic projection and parallel mode.|\-\-orthographic
+scene.camera.orthographic|bool<br>false<br>load|Toggles between orthographic projection and parallel mode.|\-\-camera\-orthographic
 
 ## Interactor Options
 

doc/user/OPTIONS.md

@@ -99,6 +99,7 @@ Options|Default|Description
 \-\-camera-zoom-factor=\<factor\>||Set the camera zoom factor relative to the autozoom on data, a strictly positive value.
 \-\-camera-azimuth-angle=\<angle\>|0.0|Apply an azimuth transformation to the camera, in degrees, added after other camera options.
 \-\-camera-elevation-angle=\<angle\>|0.0|Apply an elevation transformation to the camera, in degrees, added after other camera options.
+\-\-camera-orthographic||Set the camera to use the orthographic projection.
 
 ## Raytracing options
 

library/src/interactor_impl.cxx

@@ -320,7 +320,7 @@ class interactor_impl::internals
         render = true;
         break;
       case '5':
-        self->Options.toggle("camera.orthographic");
+        self->Options.toggle("scene.camera.orthographic");
         render = true;
         break;
       case '7':

library/src/options.cxx

@@ -217,7 +217,7 @@ options::options()
   this->Internals->init("model.volume.inverse", false);
 
   // Camera projection
-  this->Internals->init("camera.orthographic", false);
+  this->Internals->init("scene.camera.orthographic", false);
 
   // Interactor
   this->Internals->init("interactor.axis", false);

library/src/window_impl.cxx

@@ -420,7 +420,7 @@ void window_impl::UpdateDynamicOptions()
   if (this->Internals->Options.getAsInt("scene.camera.index") == -1)
   {
     this->Internals->Renderer->SetUseOrthographicProjection(
-      this->Internals->Options.getAsBool("camera.orthographic"));
+      this->Internals->Options.getAsBool("scene.camera.orthographic"));
   }
 
   if (this->Internals->WithColoring)