[WIP] Introduce a new interaction API

.clang-tidy

@@ -0,0 +1,4 @@
+Checks: '-*,performance-*,modernize-*,-modernize-use-trailing-return-type,-modernize-use-nodiscard,-modernize-avoid-c-arrays,-modernize-use-auto'
+WarningsAsErrors: '*'
+UseColor: true
+FormatStyle: none

.codespellrc

@@ -0,0 +1,3 @@
+[codespell]
+skip = ./testing/**/*,./.git/**/*,./**/*.patch,./external/cxxopts/cxxopts.hpp,./external/nlohmann_json/nlohmann/json.hpp
+ignore-words-list=nnumber,unknwn,dota,modle

.cppcheck.supp

@@ -0,0 +1,18 @@
+// remove some checks
+missingInclude
+unusedFunction
+unknownMacro
+
+// external libraries
+*:external/nlohmann_json/nlohmann/json.hpp
+*:external/cxxopts/cxxopts.hpp
+
+// specific checks
+knownConditionTrueFalse:library/testing/TestSDKImage.cxx
+knownConditionTrueFalse:library/testing/TestSDKImageDeprecated.cxx
+noExplicitConstructor:library/public/types.h
+preprocessorErrorDirective:library/src/engine.cxx
+preprocessorErrorDirective:plugins/draco/module/vtkF3DDracoReader.cxx
+unknownMacro:library/VTKExtensions/Applicative/vtkF3DObjectFactory.cxx
+unusedVariable:*factory.cxx*
+constParameter:library/src/image.cxx

.gitattributes

@@ -1 +1,6 @@
-data/**/* filter=lfs diff=lfs merge=lfs -text
+testing/data/**/* filter=lfs diff=lfs merge=lfs -text
+testing/baselines/**/* filter=lfs diff=lfs merge=lfs -text
+testing/data/DATA_LICENSES.md !filter !diff !merge text
+examples/**/*/data/**/* filter=lfs diff=lfs merge=lfs -text
+examples/**/*/baselines/**/* filter=lfs diff=lfs merge=lfs -text
+.github/baselines/**/* filter=lfs diff=lfs merge=lfs -text

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: f3d-app

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,30 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is, a screenshot helps a lot.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+ 1. Open the file using `f3d --dry-run example.glb`
+ 2. step 2
+ 3. step 3
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**System Information:**
+ - OS:
+ - GPU and GPU driver:
+
+**F3D Information**
+Paste the content of `f3d --version`:
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,24 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
+
+**Contribution**
+Please tell us if you are able to contribute (Can you develop this new feature?)
+Don't worry, you can still post a feature request if you cannot contribute!*

.github/ISSUE_TEMPLATE/new_release.md

@@ -0,0 +1,54 @@
+---
+name: New release
+about: An issue to create a new release
+title: ''
+labels: release
+assignees: ''
+
+---
+
+When creating this issue
+
+- Edit `vX.Y.Z-RCN` to the right version
+- Edit `vX.Y.Z` to the right version
+
+Before release:
+
+- [ ] Force fetch origin remote tag with `git fetch origin --tags --force`
+- [ ] Write and format release notes from the ongoing changelog, including contributors and packagers
+
+Release Split :
+
+- [ ] Create, review and merge a MR from `master` branch into `release`: https://github.com/f3d-app/f3d/compare/release...master
+
+Release Candidates :
+
+- [ ] Commit, review and merge a `vX.Y.Z-RCN` version change in https://github.com/f3d-app/f3d `CMakeLists.txt` and `pyproject.toml` in the `release` branch
+- [ ] Tag and push to https://github.com/f3d-app/f3d: `git tag vX.Y.Z-RCN -m vX.Y.Z-RCN`
+- [ ] Trigger a release build using https://github.com/f3d-app/f3d-superbuild actions with `vX.Y.Z-RCN` F3D version, superbuild `main` branch and prerelease publish `true`
+- [ ] Download the prerelease from https://github.com/f3d-app/f3d/releases
+- [ ] Locally test the prerelease on Linux: run, render, raytracing, config file, drag&drop, thumbnails, exec from file manager, sdk, python wheel
+- [ ] Locally test the prerelease on macOS (Intel): run, render, raytracing, config file, drag&drop, exec from file manager, python wheel
+- [ ] Locally test the prerelease on macOS (Silicon): run, render, config file, drag&drop, exec from file manager
+- [ ] Locally test the prerelease on Windows: run, render, raytracing, config file, drag&drop, thumbnails, exec from file manager, sdk, python wheel
+- [ ] Download all python wheels and upload them to https://test.pypi.org/project/f3d/, check `pip install f3d`
+- [ ] If it fails, fix the issues in `release` branch, copy this paragraph and increment `N`
+- [ ] Else proceed to the next part
+
+Release :
+
+- [ ] Commit, review and merge `vX.Y.Z` version change in https://github.com/f3d-app/f3d `CMakeLists.txt` and `pyproject.toml` in the `release` branch
+- [ ] Tag `vX.Y.Z` and push it to https://github.com/f3d-app/f3d: `git tag vX.Y.Z -m vX.Y.Z`
+- [ ] Commit, review and merge adding `X.Y.Z` in https://github.com/f3d-app/f3d-superbuild `versions.cmake` in the `main` branch
+- [ ] Tag `vX.Y.Z` and push it to https://github.com/f3d-app/f3d-superbuild: `git tag vX.Y.Z -m vX.Y.Z`
+- [ ] Merge F3D release into master: https://github.com/f3d-app/f3d/compare/master...release
+- [ ] Trigger a release build using https://github.com/f3d-app/f3d-superbuild actions with `vX.Y.Z` F3D version, `vX.Y.Z` sb version and prerelease publish true
+- [ ] Finalize release note and add them to the release
+- [ ] Download all python wheels and upload them to https://pypi.org/project/f3d/
+- [ ] Release
+- [ ] Update download links and update changelog in https://github.com/f3d-app/f3d `doc`
+- [ ] Update `.github/ISSUE_TEMPLATE/new_release.md` in https://github.com/f3d-app/f3d if needed
+- [ ] Communicate on discord
+- [ ] Communicate on reddit
+- [ ] Communicate on hackernews
+- [ ] Communicate on linkedin

.github/actions/alembic-install-dep/action.yml

@@ -0,0 +1,62 @@
+name: 'Install Alembic Dependency'
+description: 'Install Alembic Dependency using cache when possible'
+inputs:
+  cpu:
+    description: 'CPU architecture to build for'
+    required: false
+    default: 'x86_64'
+
+runs:
+  using: "composite"
+  steps:
+
+    - name: Cache Alembic
+      id: cache-alembic
+      uses: actions/cache@v3
+      with:
+        path: dependencies/alembic_install
+        key: alembic-v1.8.5-${{runner.os}}-${{inputs.cpu}}-1
+
+    - name: Checkout Alembic
+      if: steps.cache-alembic.outputs.cache-hit != 'true'
+      uses: actions/checkout@v3
+      with:
+        repository: alembic/alembic
+        path: './dependencies/alembic'
+        ref: 1.8.5
+
+    - name: Setup Alembic
+      if: steps.cache-alembic.outputs.cache-hit != 'true'
+      working-directory: ${{github.workspace}}/dependencies
+      shell: bash
+      run: |
+        mkdir alembic_build
+        mkdir alembic_install
+
+    - name: Configure Alembic
+      if: steps.cache-alembic.outputs.cache-hit != 'true'
+      working-directory: ${{github.workspace}}/dependencies/alembic_build
+      shell: bash
+      run: >
+        cmake ../alembic
+        -DALEMBIC_LIB_INSTALL_DIR=${{ runner.os == 'Windows' && 'bin' || 'lib' }}
+        -DALEMBIC_SHARED_LIBS=ON
+        -DCMAKE_BUILD_TYPE=Release
+        -DCMAKE_INSTALL_PREFIX:PATH=../alembic_install
+        -DCMAKE_PREFIX_PATH:PATH=../install/
+        -DUSE_BINARIES=OFF
+        -DUSE_TESTS=OFF
+        -DCMAKE_OSX_ARCHITECTURES=${{ inputs.cpu }}
+        ${{ runner.os == 'macOS' && '-DCMAKE_OSX_DEPLOYMENT_TARGET=10.15 -DCMAKE_MACOSX_RPATH=ON' || null }}
+        ${{ runner.os == 'Windows' && '-Ax64 -DCMAKE_POLICY_DEFAULT_CMP0091=NEW -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreadedDLL' || null }}
+
+    - name: Build Alembic
+      if: steps.cache-alembic.outputs.cache-hit != 'true'
+      working-directory: ${{github.workspace}}/dependencies/alembic_build
+      shell: bash
+      run: cmake --build . --parallel 2 --target install --config Release
+
+    - name: Copy to install
+      working-directory: ${{github.workspace}}/dependencies/alembic_install
+      shell: bash
+      run: cp -r ./* ../install/

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

@@ -0,0 +1,69 @@
+name: 'Android CI'
+description: 'Android CI'
+inputs:
+  arch:
+    description: 'Android arch to build'
+    required: true
+  vtk_version:
+    description: 'VTK version'
+    required: false
+    default: 'commit'
+
+runs:
+  using: "composite"
+  steps:
+
+    - name: Check required inputs
+      shell: bash
+      run: |
+        [[ "${{ inputs.arch }}" ]] || { echo "arch input is empty" ; exit 1; }
+
+    - name: Dependencies Dir
+      shell: bash
+      working-directory: ${{github.workspace}}
+      run: mkdir dependencies
+
+    - name: Install NDK
+      shell: bash
+      working-directory: ${{github.workspace}}
+      run: |
+        apt-get install unzip
+        wget https://dl.google.com/android/repository/android-ndk-${{env.NDK_VERSION}}-linux-x86_64.zip
+        unzip -qq android-ndk-${{env.NDK_VERSION}}-linux-x86_64.zip
+        mv android-ndk-${{env.NDK_VERSION}} android-ndk
+
+    - name: Install VTK dependency
+      uses: ./source/.github/actions/vtk-android-install-dep
+      with:
+        arch: ${{inputs.arch}}
+        api_level: ${{env.API_LEVEL}}
+        vtk_version: ${{inputs.vtk_version}}
+        vtk_sha_file: ./source/.github/actions/vtk_commit_sha
+
+    - name: Setup Directories
+      shell: bash
+      working-directory: ${{github.workspace}}
+      run: |
+         mkdir build
+         mkdir install
+
+    - name: Configure
+      shell: bash
+      working-directory: ${{github.workspace}}/build
+      run: >
+        cmake ../source
+        -DCMAKE_ANDROID_ARCH_ABI=${{inputs.arch}}
+        -DCMAKE_ANDROID_NDK=$(pwd)/../android-ndk
+        -DCMAKE_BUILD_TYPE=Release
+        -DCMAKE_FIND_ROOT_PATH=$(pwd)/../dependencies/vtk_build/CMakeExternals/Install/vtk-android/
+        -DCMAKE_INSTALL_PREFIX:PATH=../install
+        -DCMAKE_SYSTEM_NAME=Android
+        -DCMAKE_SYSTEM_VERSION=${{env.API_LEVEL}}
+        -DF3D_BINDINGS_JAVA=ON
+        -DF3D_PLUGIN_BUILD_EXODUS=OFF
+        -DF3D_STRICT_BUILD=ON
+
+    - name: Build
+      shell: bash
+      working-directory: ${{github.workspace}}/build
+      run: cmake --build . --parallel 2 --target install

.github/actions/assimp-install-dep/action.yml

@@ -0,0 +1,68 @@
+name: 'Install Assimpp Dependency'
+description: 'Install Assimp Dependency using cache when possible'
+inputs:
+  cpu:
+    description: 'CPU architecture to build for'
+    required: false
+    default: 'x86_64'
+
+runs:
+  using: "composite"
+  steps:
+
+    - name: Cache ASSIMP
+      id: cache-assimp
+      uses: actions/cache@v3
+      with:
+        path: dependencies/assimp_install
+        key: assimp-v5.3.1-${{runner.os}}-${{inputs.cpu}}-0
+
+    - name: Checkout ASSIMP
+      if: steps.cache-assimp.outputs.cache-hit != 'true'
+      uses: actions/checkout@v3
+      with:
+        repository: assimp/assimp
+        path: './dependencies/assimp'
+        ref: v5.3.1
+
+    - name: Setup ASSIMP
+      if: steps.cache-assimp.outputs.cache-hit != 'true'
+      working-directory: ${{github.workspace}}/dependencies
+      shell: bash
+      run: |
+        mkdir assimp_build
+        mkdir assimp_install
+
+    - name: Configure ASSIMP
+      if: steps.cache-assimp.outputs.cache-hit != 'true'
+      working-directory: ${{github.workspace}}/dependencies/assimp_build
+      shell: bash
+      run: >
+        cmake ../assimp
+        -DASSIMP_BUILD_ALL_IMPORTERS_BY_DEFAULT=OFF
+        -DASSIMP_BUILD_ASSIMP_TOOLS=OFF
+        -DASSIMP_BUILD_COLLADA_IMPORTER=ON
+        -DASSIMP_BUILD_DXF_IMPORTER=ON
+        -DASSIMP_BUILD_FBX_IMPORTER=ON
+        -DASSIMP_BUILD_OFF_IMPORTER=ON
+        -DASSIMP_BUILD_SAMPLES=OFF
+        -DASSIMP_BUILD_TESTS=OFF
+        -DASSIMP_NO_EXPORT=ON
+        -DASSIMP_WARNINGS_AS_ERRORS=OFF
+        -DBUILD_SHARED_LIBS=ON
+        -DCMAKE_BUILD_TYPE=Release
+        -DCMAKE_INSTALL_PREFIX:PATH=../assimp_install
+        -DCMAKE_OSX_ARCHITECTURES=${{ inputs.cpu }}
+        ${{ runner.os == 'macOS' && '-DCMAKE_OSX_DEPLOYMENT_TARGET=10.15' || null }}
+        ${{ runner.os == 'Windows' && '-Ax64 -DCMAKE_POLICY_DEFAULT_CMP0091=NEW -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreadedDLL' || null }}
+
+    - name: Build ASSIMP
+      if: steps.cache-assimp.outputs.cache-hit != 'true'
+      working-directory: ${{github.workspace}}/dependencies/assimp_build
+      shell: bash
+      run: cmake --build . --parallel 2 --target install --config Release
+
+    - name: Copy to install
+      working-directory: ${{github.workspace}}/dependencies/assimp_install
+      shell: bash
+      run: cp -r ./* ../install/