Add support for saving/loading statefiles

.github/ISSUE_TEMPLATE/new_release.md

@@ -86,6 +86,8 @@ Linux testing protocol:
 - Double click on supported file in testing/data, especially for new file formats if any and check it opens in F3D
 - Drag&Drop cow.vtp, Drag&Drop shanghai_bund.hdr, check render
 - Check that CTRL+O (file dialog) is working
+- Check that CTRL+S then CTRL+L (statefile save/load file dialogs) are working: save a statefile, change the background color, load it back and check the color is restored
+- Check that CTRL+C then CTRL+V (statefile save/load to clipboard) are working: copy the state, change the background color, paste it back and check the color is restored
 - Press "Esc" and check the following commands `reload_current_file_group`, `set_camera top`, `toggle_volume_rendering`, `exit`
 
 macOS testing protocol:
@@ -98,6 +100,8 @@ macOS testing protocol:
 - Check all supported file in testing/data directory in finder have the f3d mark, if not, check that "open with" suggest F3D
 - Drag&Drop cow.vtp, Drag&Drop shanghai_bund.hdr, check render
 - Check that CMD+O (file dialog) is working
+- Check that CMD+S then CMD+L (statefile save/load file dialogs) are working: save a statefile, change the background color, load it back and check the color is restored
+- Check that CMD+C then CMD+V (statefile save/load to clipboard) are working: copy the state, change the background color, paste it back and check the color is restored
 - Press "Esc" and check the following commands `reload_current_file_group`, `set_camera top`, `toggle_volume_rendering`, `exit`
 
 Windows testing protocol:
@@ -113,6 +117,8 @@ Windows testing protocol:
 - Double click on f3d.glb, press "Space", check animation is going smoothly and takes 4 seconds
 - Double click on any new supported file format, check render
 - Check that CTRL+O (file dialog) is working
+- Check that CTRL+S then CTRL+L (statefile save/load file dialogs) are working: save a statefile, change the background color, load it back and check the color is restored
+- Check that CTRL+C then CTRL+V (statefile save/load to clipboard) are working: copy the state, change the background color, paste it back and check the color is restored
 - run `f3d-console --version` in a Windows command line and check it output the version
 - Press "Esc" and check the following commands `reload_current_file_group`, `set_camera top`, `toggle_volume_rendering`, `exit`
 

.github/actions/coverage-ci/action.yml

@@ -64,6 +64,7 @@ runs:
         -DCMAKE_MODULE_PATH=$(pwd)/../dependencies/install/lib/cmake/OpenVDB/
         -DCMAKE_PREFIX_PATH:PATH=$(pwd)/../dependencies/install/
         -DF3D_COVERAGE=ON
+        -DF3D_MODULE_CLIP=ON
         -DF3D_MODULE_EXR=ON
         -DF3D_MODULE_WEBP=ON
         -DF3D_MODULE_RAYTRACING=ON

.github/actions/generic-ci/action.yml

@@ -178,6 +178,7 @@ runs:
         -DF3D_LINUX_GENERATE_MAN=ON
         -DF3D_LINUX_INSTALL_DEFAULT_CONFIGURATION_FILE_IN_PREFIX=ON
         -DF3D_MACOS_BUNDLE=${{ inputs.bundle_label == 'bundle' && 'ON' || 'OFF' }}
+        -DF3D_MODULE_CLIP=${{ inputs.optdeps_label == 'optdeps' && 'ON' || 'OFF' }}
         -DF3D_MODULE_EXR=${{ inputs.optdeps_label == 'optdeps' && 'ON' || 'OFF' }}
         -DF3D_MODULE_WEBP=${{ inputs.optdeps_label == 'optdeps' && 'ON' || 'OFF' }}
         -DF3D_MODULE_RAYTRACING=${{ inputs.optdeps_label == 'optdeps' && 'ON' || 'OFF' }}

.github/actions/sanitizer-ci/action.yml

@@ -72,6 +72,7 @@ runs:
         -DCMAKE_INSTALL_RPATH_USE_LINK_PATH=ON
         -DCMAKE_PREFIX_PATH:PATH=$(pwd)/../dependencies/install/
         -DF3D_BINDINGS_C=${{ inputs.sanitizer_type == 'undefined' && 'OFF' || 'ON' }}
+        -DF3D_MODULE_CLIP=ON
         -DF3D_MODULE_EXR=ON
         -DF3D_MODULE_UI=ON
         -DF3D_MODULE_WEBP=ON

CMakeLists.txt

@@ -96,7 +96,7 @@ option(F3D_MODULE_WEBP "WebP images module" OFF)
 option(F3D_MODULE_UI "ImGui widgets module" ON)
 option(F3D_MODULE_DMON "dmon (watch) module" ON)
 option(F3D_MODULE_TINYFILEDIALOGS "tinyfiledialogs module" ON)
-option(F3D_MODULE_CLIP "clip module (experimental)" OFF)
+option(F3D_MODULE_CLIP "clip module" OFF)
 
 # Use externals
 option(F3D_USE_EXTERNAL_CXXOPTS "Use external cxxopts dependency" OFF)

application/CMakeLists.txt

@@ -82,6 +82,11 @@ function(f3d_create_exec target_name)
     target_compile_definitions(${target_name} PRIVATE F3D_MODULE_WEBP)
   endif ()
 
+  # clip
+  if (F3D_MODULE_CLIP)
+    target_compile_definitions(${target_name} PRIVATE F3D_MODULE_CLIP)
+  endif ()
+
   # dmon
   if (F3D_MODULE_DMON)
     target_compile_definitions(${target_name} PRIVATE F3D_MODULE_DMON)

application/F3DOptionsTools.h

@@ -34,6 +34,9 @@ static inline const OptionsDict DefaultAppOptions = {
   { "config", "" },
   { "no-config", "false" },
   { "no-render", "false" },
+  { "load-statefile", "" },
+  { "save-statefile", "" },
+  { "statefile-filename", "" },
   { "rendering-backend", "auto" },
   { "max-size", "" },
   { "animation-time", "" },