Upload 1461 files

.gitattributes

@@ -55,3 +55,25 @@ ObjectReconApp/sugar/media/overview/playroom_hybrid.gif filter=lfs diff=lfs merg
 ObjectReconApp/sugar/media/overview/playroom_notex.gif filter=lfs diff=lfs merge=lfs -text
 ObjectReconApp/sugar/media/overview/qant03_hybrid.gif filter=lfs diff=lfs merge=lfs -text
 ObjectReconApp/sugar/media/overview/qant03_notex.gif filter=lfs diff=lfs merge=lfs -text
+sugar/gaussian_splatting/SIBR_viewers/docs/img/diagramas/sequence/Renderers/seq_ulr_stream.pdf filter=lfs diff=lfs merge=lfs -text
+sugar/gaussian_splatting/SIBR_viewers/docs/img/multiviewmanager.png filter=lfs diff=lfs merge=lfs -text
+sugar/gaussian_splatting/SIBR_viewers/docs/img/ulr_screenshot.png filter=lfs diff=lfs merge=lfs -text
+sugar/gaussian_splatting/submodules/diff-gaussian-rasterization/third_party/glm/doc/manual.pdf filter=lfs diff=lfs merge=lfs -text
+sugar/media/blender/full_teaser.png filter=lfs diff=lfs merge=lfs -text
+sugar/media/examples/attack.gif filter=lfs diff=lfs merge=lfs -text
+sugar/media/examples/process_0.png filter=lfs diff=lfs merge=lfs -text
+sugar/media/examples/process_1.png filter=lfs diff=lfs merge=lfs -text
+sugar/media/examples/viewer_example.png filter=lfs diff=lfs merge=lfs -text
+sugar/media/examples/walk.gif filter=lfs diff=lfs merge=lfs -text
+sugar/media/overview/counter_hybrid.gif filter=lfs diff=lfs merge=lfs -text
+sugar/media/overview/counter_notex.gif filter=lfs diff=lfs merge=lfs -text
+sugar/media/overview/dukemon_hybrid.gif filter=lfs diff=lfs merge=lfs -text
+sugar/media/overview/dukemon_notex.gif filter=lfs diff=lfs merge=lfs -text
+sugar/media/overview/garden_hybrid.gif filter=lfs diff=lfs merge=lfs -text
+sugar/media/overview/garden_notex.gif filter=lfs diff=lfs merge=lfs -text
+sugar/media/overview/kitchen_hybrid.gif filter=lfs diff=lfs merge=lfs -text
+sugar/media/overview/kitchen_notex.gif filter=lfs diff=lfs merge=lfs -text
+sugar/media/overview/playroom_hybrid.gif filter=lfs diff=lfs merge=lfs -text
+sugar/media/overview/playroom_notex.gif filter=lfs diff=lfs merge=lfs -text
+sugar/media/overview/qant03_hybrid.gif filter=lfs diff=lfs merge=lfs -text
+sugar/media/overview/qant03_notex.gif filter=lfs diff=lfs merge=lfs -text

README.md

@@ -1,12 +1 @@
----
-title: 3D Reconstruction Demo
-emoji: 📚
-colorFrom: red
-colorTo: yellow
-sdk: gradio
-sdk_version: 4.19.0
-app_file: app.py
-pinned: false
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# ObjectReconApp

app.py

@@ -0,0 +1,78 @@
+import os
+import torch
+import subprocess
+import gradio as gr
+from tqdm import tqdm
+import post_process
+import shutil
+from sugar.gaussian_splatting import convert
+from sugar.gaussian_splatting import train as train_gs
+from sugar import train as train_sugar
+
+
+def process_images(images):
+    print("Preparing directories...")
+    # Specify the target folder where you want to copy the images
+    target_folder = "data/custom/input/"
+
+    # Remove and Create the target folder if it doesn't exist
+    os.removedirs(target_folder)
+    os.makedirs(target_folder, exist_ok=True)
+
+    # Copy each image to the target folder
+    file_paths = []
+    for image in tqdm(images):
+        image_path = image.name  # Get the original image path
+        new_path = os.path.join(target_folder, os.path.basename(image_path))  # Construct the new path
+        shutil.move(image_path, new_path)  # Move the image to the target folder
+        file_paths.append(new_path)
+
+    return file_paths
+
+
+def get_3d(file_paths):
+    # Your 3D model reconstruction logic using the file paths goes here
+    # For demonstration, I'll just return the file paths
+    print(file_paths)
+    file_paths = process_images(file_paths)
+    print(file_paths)
+
+    # 3d reconstruction
+    torch.cuda.empty_cache()
+
+    # subprocess.run(['python', 'sugar/gaussian_splatting/convert.py', '-s', 'data/custom/'])
+    convert.main()
+    torch.cuda.empty_cache()
+
+    # subprocess.run(['python', 'sugar/gaussian_splatting/train.py', '-s', 'data/custom/', '--iterations', '7000', '-m', 'output/custom/'])
+    train_gs.main()
+    torch.cuda.empty_cache()
+
+    # subprocess.run(['python', 'sugar/train.py', '-c', 'output/custom/', '-r', 'density', '-t', 'True', '--export_ply', 'True'])
+    train_sugar.main()
+    torch.cuda.empty_cache()
+
+    out_dir = "output/final_mesh/custom/"
+    os.makedirs(out_dir, exist_ok=True)
+    post_process.post_process_textured_mesh("output/refined_mesh/custom/sugarfine_3Dgs7000_densityestim02_sdfnorm02_level03_decim1000000_normalconsistency01_gaussperface6.obj", "output/final_mesh/custom/custom.obj", crop=True, remesh=False, repair=True, viz=False, save=True)
+    torch.cuda.empty_cache()
+
+    return f"output/refined_mesh/custom/sugarfine_3Dgs7000_densityestim02_sdfnorm02_level03_decim1000000_normalconsistency01_gaussperface6.obj", f"output/final_mesh/custom/custom.glb"
+
+
+demo = gr.Interface(
+    fn=get_3d,  # Function that will be called when the button is clicked
+    inputs=gr.Files(file_types=["image", "video"], file_count="multiple"),
+    outputs=[
+        gr.Model3D(clear_color=[0.0, 0.0, 0.0, 0.0], label="3D Model (Recon.)"),
+        gr.Model3D(clear_color=[0.0, 0.0, 0.0, 0.0], label="3D Model (Final)"),
+    ],
+    title="Alteredverse::3D Model Reconstruction",
+    description="Upload a video or set of images to reconstruct a 3D model.",
+)
+
+
+if __name__ == "__main__":
+    demo.queue()
+    # demo.launch(share=True)
+    demo.launch()

install.sh

@@ -0,0 +1,3 @@
+sh install_sugar.sh
+conda activate sugar
+pip install -r requirements.txt

install_sugar.sh

@@ -0,0 +1,52 @@
+#conda env create -f environment.yml
+#conda activate sugar
+
+### sugar installation
+conda create --name sugar -y python=3.9
+conda activate sugar
+conda install pytorch==2.0.1 torchvision==0.15.2 torchaudio==2.0.2 pytorch-cuda=11.8 -c pytorch -c nvidia
+conda install -c fvcore -c iopath -c conda-forge fvcore iopath
+conda install pytorch3d==0.7.4 -c pytorch3d
+conda install -c plotly plotly
+conda install -c conda-forge rich
+conda install -c conda-forge plyfile==0.8.1
+conda install -c conda-forge jupyterlab
+conda install -c conda-forge nodejs
+conda install -c conda-forge ipywidgets
+pip install open3d
+pip install --upgrade PyMCubes
+conda install -c conda-forge colmap -y
+conda install -c conda-forge ffmpeg -y
+
+cd sugar/gaussian_splatting/submodules/diff-gaussian-rasterization/ || exit
+pip install -e .
+cd ../simple-knn/ || exit
+pip install -e .
+cd ../../../../
+
+curl -fsSL https://deb.nodesource.com/setup_21.x | sudo -E bash -
+sudo apt-get install -y nodejs
+sudo apt-get install -y aptitude
+sudo aptitude install -y npm
+cd sugar_viewer || exit
+npm install
+cd ../
+
+
+# apt install openssh-server
+
+# background remover tools
+pip install rembg[gpu,cli]
+pip install --upgrade pip
+pip install backgroundremover
+pip install carvekit --extra-index-url https://download.pytorch.org/whl/cu117
+
+
+# mip_sugar
+#pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu117
+#
+#cd mip_splatting/submodules/diff-gaussian-rasterization/ || exit
+#pip install -e .
+#cd ../simple-knn/ || exit
+#pip install -e .
+#cd ../../../

post_process.py

@@ -0,0 +1,99 @@
+import os
+import trimesh
+import numpy as np
+
+
+def crop_mesh(mesh, desired_bounding_box_length=15, viz=False):
+    print("Cropping mesh...")
+    mesh_bounds = mesh.bounding_box.bounds
+    center = (mesh_bounds[0] + mesh_bounds[1]) / 2
+    bbox_half_size = desired_bounding_box_length / 2
+
+    cropped_mesh = mesh
+    for axis in [(1, 0, 0), (0, 1, 0), (0, 0, 1)]:  # Iterate through X, Y, Z axes
+        plane_origin = center + bbox_half_size * np.array(axis)  # Convert axis to NumPy array for multiplication
+        plane_normal = - np.array(axis)  # Negate the NumPy array version of axis
+        cropped_mesh = cropped_mesh.slice_plane(plane_origin, plane_normal)
+
+    if viz:
+        print("Visualizing cropped mesh...")
+        cropped_mesh.show()
+
+    return cropped_mesh
+
+
+def remesh_mesh(mesh, viz=False):
+    print("Remeshing...")
+    # Concat the uv with the vertices and subdivide
+    vertices, faces = trimesh.remesh.subdivide(
+        vertices=np.hstack((mesh.vertices, mesh.visual.uv.copy())),
+        faces=mesh.faces
+    )
+
+    mesh.vertices = vertices[:, :3]
+    mesh.faces = faces
+    mesh.visual.uv = vertices[:, 3:]
+
+    if viz:
+        print("Visualizing remeshed mesh...")
+        mesh.show()
+
+    return mesh
+
+
+def repair_mesh(mesh, viz=False):
+    print("Repairing...")
+    # Access repair functions from the 'repair' module:
+    trimesh.repair.fix_winding(mesh)  # Ensure consistent winding order first
+    trimesh.repair.fix_normals(mesh)  # Recalculate normals based on winding
+    trimesh.repair.fix_inversion(mesh)  # Fix inverted faces
+    trimesh.repair.fill_holes(mesh)  # Fill holes after fixing topology
+    trimesh.repair.broken_faces(mesh)  # Handle broken faces after filling holes
+    # trimesh.repair.stitch(mesh)  # Stitch disconnected components (optional)
+
+    if viz:
+        mesh.show()
+
+    return mesh
+
+
+def post_process_textured_mesh(mesh_path, out_path, crop=False, remesh=False, repair=True, viz=False, save=True):
+    print("Loading mesh...")
+    mesh = trimesh.load(mesh_path)
+
+    if viz:
+        mesh.show()
+
+    # crop mesh
+    if crop:
+        mesh = crop_mesh(mesh)
+
+    # remesh and repair and remesh
+    if remesh:
+        mesh = remesh_mesh(mesh)
+
+    if repair:
+        mesh = repair_mesh(mesh)
+
+    # visualize
+    if viz:
+        print("Visualizing processed mesh...")
+        mesh.show()
+
+    # save the cropped mesh and texture
+    if save:
+        print("Saving mesh...")
+        mesh.export(out_path)
+
+    print("Finished!")
+
+
+if __name__ == "__main__":
+    mesh_dir = "output/refined_mesh/custom/"
+    input_mesh_path = os.path.join(mesh_dir, "sugarfine_3Dgs7000_densityestim02_sdfnorm02_level03_decim1000000_normalconsistency01_gaussperface6.obj")
+
+    out_dir = "output/final_mesh/custom/"
+    os.makedirs(out_dir, exist_ok=True)
+    output_mesh_path = os.path.join(out_dir, 'custom.glb')
+
+    post_process_textured_mesh(input_mesh_path, output_mesh_path, crop=False, remesh=False, repair=True, viz=False, save=True)

requirements.txt

@@ -0,0 +1,4 @@
+gradio
+tqdm
+trimesh
+shapely

run.sh

@@ -0,0 +1,5 @@
+python sugar/gaussian_splatting/convert.py -s data/custom/
+python sugar/gaussian_splatting/train.py -s data/custom/ --iterations 7000 -m output/custom/
+python sugar/train.py -s data/custom/ -c output/custom/ -r density -t True --export_ply True
+
+python post_process.py

sugar/LICENSE.md

@@ -0,0 +1,83 @@
+Gaussian-Splatting License  
+===========================  
+
+**Inria** and **the Max Planck Institut for Informatik (MPII)** hold all the ownership rights on the *Software* named **gaussian-splatting**.  
+The *Software* is in the process of being registered with the Agence pour la Protection des  
+Programmes (APP).  
+
+The *Software* is still being developed by the *Licensor*.  
+
+*Licensor*'s goal is to allow the research community to use, test and evaluate  
+the *Software*.  
+
+## 1.  Definitions  
+
+*Licensee* means any person or entity that uses the *Software* and distributes  
+its *Work*.  
+
+*Licensor* means the owners of the *Software*, i.e Inria and MPII  
+
+*Software* means the original work of authorship made available under this  
+License ie gaussian-splatting.  
+
+*Work* means the *Software* and any additions to or derivative works of the  
+*Software* that are made available under this License.  
+
+
+## 2.  Purpose  
+This license is intended to define the rights granted to the *Licensee* by  
+Licensors under the *Software*.  
+
+## 3.  Rights granted  
+
+For the above reasons Licensors have decided to distribute the *Software*.  
+Licensors grant non-exclusive rights to use the *Software* for research purposes  
+to research users (both academic and industrial), free of charge, without right  
+to sublicense.. The *Software* may be used "non-commercially", i.e., for research  
+and/or evaluation purposes only.  
+
+Subject to the terms and conditions of this License, you are granted a  
+non-exclusive, royalty-free, license to reproduce, prepare derivative works of,  
+publicly display, publicly perform and distribute its *Work* and any resulting  
+derivative works in any form.  
+
+## 4.  Limitations  
+
+**4.1 Redistribution.** You may reproduce or distribute the *Work* only if (a) you do  
+so under this License, (b) you include a complete copy of this License with  
+your distribution, and (c) you retain without modification any copyright,  
+patent, trademark, or attribution notices that are present in the *Work*.  
+
+**4.2 Derivative Works.** You may specify that additional or different terms apply  
+to the use, reproduction, and distribution of your derivative works of the *Work*  
+("Your Terms") only if (a) Your Terms provide that the use limitation in  
+Section 2 applies to your derivative works, and (b) you identify the specific  
+derivative works that are subject to Your Terms. Notwithstanding Your Terms,  
+this License (including the redistribution requirements in Section 3.1) will  
+continue to apply to the *Work* itself.  
+
+**4.3** Any other use without of prior consent of Licensors is prohibited. Research  
+users explicitly acknowledge having received from Licensors all information  
+allowing to appreciate the adequacy between of the *Software* and their needs and  
+to undertake all necessary precautions for its execution and use.  
+
+**4.4** The *Software* is provided both as a compiled library file and as source  
+code. In case of using the *Software* for a publication or other results obtained  
+through the use of the *Software*, users are strongly encouraged to cite the  
+corresponding publications as explained in the documentation of the *Software*.  
+
+## 5.  Disclaimer  
+
+THE USER CANNOT USE, EXPLOIT OR DISTRIBUTE THE *SOFTWARE* FOR COMMERCIAL PURPOSES  
+WITHOUT PRIOR AND EXPLICIT CONSENT OF LICENSORS. YOU MUST CONTACT INRIA FOR ANY  
+UNAUTHORIZED USE: [email protected] . ANY SUCH ACTION WILL  
+CONSTITUTE A FORGERY. THIS *SOFTWARE* IS PROVIDED "AS IS" WITHOUT ANY WARRANTIES  
+OF ANY NATURE AND ANY EXPRESS OR IMPLIED WARRANTIES, WITH REGARDS TO COMMERCIAL  
+USE, PROFESSIONNAL USE, LEGAL OR NOT, OR OTHER, OR COMMERCIALISATION OR  
+ADAPTATION. UNLESS EXPLICITLY PROVIDED BY LAW, IN NO EVENT, SHALL INRIA OR THE  
+AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR  
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE  
+GOODS OR SERVICES, LOSS OF USE, DATA, OR PROFITS OR BUSINESS INTERRUPTION)  
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT  
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING FROM, OUT OF OR  
+IN CONNECTION WITH THE *SOFTWARE* OR THE USE OR OTHER DEALINGS IN THE *SOFTWARE*.  

sugar/README.md

@@ -0,0 +1,436 @@
+<div align="center">
+
+# SuGaR: Surface-Aligned Gaussian Splatting for Efficient 3D Mesh Reconstruction and High-Quality Mesh Rendering
+
+<font size="4">
+<a href="https://anttwo.github.io/" style="font-size:100%;">Antoine Guédon</a>&emsp;
+<a href="https://vincentlepetit.github.io/" style="font-size:100%;">Vincent Lepetit</a>&emsp;
+</font>
+<br>
+
+<font size="4">
+LIGM, Ecole des Ponts, Univ Gustave Eiffel, CNRS
+</font>
+
+| <a href="https://anttwo.github.io/sugar/">Webpage</a> | <a href="https://arxiv.org/abs/2311.12775">arXiv</a> | <a href="https://www.youtube.com/watch?v=MAkFyWfiBQo">Presentation video</a> | <a href="https://www.youtube.com/watch?v=YbjE0wnw67I">Viewer video</a> |
+
+<img src="./media/examples/walk.gif" alt="walk.gif" width="350"/><img src="./media/examples/attack.gif" alt="attack.gif" width="350"/> <br>
+<b>Our method extracts meshes from 3D Gaussian Splatting reconstructions and builds hybrid representations <br>that enable easy composition and animation in Gaussian Splatting scenes by manipulating the mesh.</b>
+</div>
+
+## Abstract
+
+_We propose a method to allow precise and extremely fast mesh extraction from <a href="https://repo-sam.inria.fr/fungraph/3d-gaussian-splatting/">3D Gaussian Splatting (SIGGRAPH 2023)</a>.
+Gaussian Splatting has recently become very popular as it yields realistic rendering while being significantly faster to train than NeRFs. It is however challenging to extract a mesh from the millions of tiny 3D Gaussians as these Gaussians tend to be unorganized after optimization and no method has been proposed so far.
+Our first key contribution is a regularization term that encourages the 3D Gaussians to align well with the surface of the scene.
+We then introduce a method that exploits this alignment to sample points on the real surface of the scene and extract a mesh from the Gaussians using Poisson reconstruction, which is fast, scalable, and preserves details, in contrast to the Marching Cubes algorithm usually applied to extract meshes from Neural SDFs.
+Finally, we introduce an optional refinement strategy that binds Gaussians to the surface of the mesh, and jointly optimizes these Gaussians and the mesh through Gaussian splatting rendering. This enables easy editing, sculpting, rigging, animating, or relighting of the Gaussians using traditional softwares (Blender, Unity, Unreal Engine, etc.) by manipulating the mesh instead of the Gaussians themselves.
+Retrieving such an editable mesh for realistic rendering is done within minutes with our method, compared to hours with the state-of-the-art method on neural SDFs, while providing a better rendering quality in terms of PSNR, SSIM and LPIPS._
+
+<div align="center">
+<b>Hybrid representation (Mesh + Gaussians on the surface)</b><br>
+<img src="./media/overview/garden_hybrid.gif" alt="garden_hybrid.gif" width="250"/>
+<img src="./media/overview/kitchen_hybrid.gif" alt="kitchen_hybrid.gif" width="250"/>
+<img src="./media/overview/counter_hybrid.gif" alt="counter_hybrid.gif" width="250"/><br>
+<img src="./media/overview/playroom_hybrid.gif" alt="playroom_hybrid.gif" width="323"/>
+<img src="./media/overview/qant03_hybrid.gif" alt="qant03_hybrid.gif" width="323"/>
+<img src="./media/overview/dukemon_hybrid.gif" alt="_hybrid.gif" width="102"/><br>
+<b>Underlying mesh without texture</b><br>
+<img src="./media/overview/garden_notex.gif" alt="garden_notex.gif" width="250"/>
+<img src="./media/overview/kitchen_notex.gif" alt="kitchen_notex.gif" width="250"/>
+<img src="./media/overview/counter_notex.gif" alt="counter_notex.gif" width="250"/><br>
+<img src="./media/overview/playroom_notex.gif" alt="playroom_notex.gif" width="323"/>
+<img src="./media/overview/qant03_notex.gif" alt="qant03_notex.gif" width="323"/>
+<img src="./media/overview/dukemon_notex.gif" alt="dukemon_notex.gif" width="102"/><br>
+</div>
+
+
+## BibTeX
+
+```
+@article{guedon2023sugar,
+  title={SuGaR: Surface-Aligned Gaussian Splatting for Efficient 3D Mesh Reconstruction and High-Quality Mesh Rendering},
+  author={Gu{\'e}don, Antoine and Lepetit, Vincent},
+  journal={arXiv preprint arXiv:2311.12775},
+  year={2023}
+}
+```
+
+## Updates and To-do list
+
+<details>
+<summary><span style="font-weight: bold;">Updates</span></summary>
+<ul>
+  <li><b>[01/09/2024]</b> Added a dedicated, real-time viewer to let users visualize and navigate in the reconstructed scenes (hybrid representation, textured mesh and wireframe mesh).</li>
+  <li><b>[12/20/2023]</b> Added a short notebook showing how to render images with the hybrid representation using the Gaussian Splatting rasterizer.</li>
+  <li><b>[12/18/2023]</b> Code release.</li>
+</ul>
+</details><br>
+
+<details>
+<summary><span style="font-weight: bold;">To-do list</span></summary>
+<ul>
+  <li><b>Improvement:</b> Add an <code>if</code> block to <code>sugar_extractors/coarse_mesh.py</code> to skip foreground mesh reconstruction and avoid triggering an error if no surface point is detected inside the foreground bounding box. This can be useful for users that want to reconstruct "<i>background scenes</i>". </li>
+  <li><b>Using precomputed masks with SuGaR:</b> Add a mask functionality to the SuGaR optimization, to allow the user to mask out some pixels in the training images (like white backgrounds in synthetic datasets).
+  </li>
+  <li><b>Using SuGaR with Windows:</b> Adapt the code to make it compatible with Windows. Due to path-writing conventions, the current code is not compatible with Windows. 
+  </li>
+  <li><b>Synthetic datasets:</b> Add the possibility to use the NeRF synthetic dataset (which has a different format than COLMAP scenes)
+  </li>
+  <li><b>Composition and animation:</b> Finish to clean the code for composition and animation, and add it to the <code>sugar_scene/sugar_compositor.py</code> script.
+  </li>
+  <li><b>Composition and animation:</b> Make a tutorial on how to use the scripts in the <code>blender</code> directory and the <code>sugar_scene/sugar_compositor.py</code> class to import composition and animation data into PyTorch and apply it to the SuGaR hybrid representation.
+  </li>
+  <!-- <li><b>Improvement:</b> Implement a simple method to avoid artifacts when reconstructing thin objects with poor coverage/visibility in the training images.</li>
+  </li> -->
+</ul>
+</details>
+
+## Overview
+
+As we explain in the paper, SuGaR optimization starts with first optimizing a 3D Gaussian Splatting model for 7k iterations with no additional regularization term. 
+In this sense, SuGaR is a method that can be applied on top of any 3D Gaussian Splatting model, and a Gaussian Splatting model optimized for 7k iterations must be provided to SuGaR.
+
+Consequently, the current implementation contains a version of the original <a href="https://github.com/graphdeco-inria/gaussian-splatting">3D Gaussian Splatting code</a>, and we built our model as a wrapper of a vanilla 3D Gaussian Splatting model.
+Please note that, even though this wrapper implementation is convenient for many reasons, it may not be the most optimal one for memory usage, so we might change it in the future.
+
+After optimizing a vanilla Gaussian Splatting model, the SuGaR pipeline consists of 3 main steps, and an optional one:
+1. **SuGaR optimization**: optimizing Gaussians alignment with the surface of the scene
+2. **Mesh extraction**: extracting a mesh from the optimized Gaussians
+3. **SuGaR refinement**: refining the Gaussians and the mesh together to build a hybrid representation
+4. **Textured mesh extraction (Optional)**: extracting a traditional textured mesh from the refined SuGaR model
+
+<div align="center"><br>
+<img src="./media/examples/process_0.png" alt="process_0.png" width="750"/><br>
+<img src="./media/examples/process_1.png" alt="process_.png" width="750"/><br>
+</div><br>
+
+We provide a dedicated script for each of these steps, as well as a script `train.py` that runs the entire pipeline. We explain how to use this script in the next sections. <br>
+
+Please note that the final step, _Textured mesh extraction_, is optional but is enabled by default in the `train.py` script. Indeed, it is very convenient to have a traditional textured mesh for visualization, composition and animation using traditional softwares such as Blender. However, this step is not needed to produce, modify or animate hybrid representations.
+
+<div align="center">
+<b>Hybrid representation (Mesh + Gaussians on the surface)</b><br>
+<img src="./media/overview/garden_hybrid.png" alt="garden_hybrid.gif" height="135"/>
+<img src="./media/overview/kitchen_hybrid.png" alt="kitchen_hybrid.gif" height="135"/>
+<img src="./media/overview/qant03_hybrid.png" alt="qant03_hybrid.gif" height="135"/>
+<img src="./media/overview/dukemon_hybrid.png" alt="_hybrid.gif" height="135"/><br>
+<b>Underlying mesh with a traditional colored UV texture</b><br>
+<img src="./media/overview/garden_texture.png" alt="garden_notex.gif" height="135"/>
+<img src="./media/overview/kitchen_texture.png" alt="kitchen_notex.gif" height="135"/>
+<img src="./media/overview/qant03_texture.png" alt="qant03_notex.gif" height="135"/>
+<img src="./media/overview/dukemon_texture.png" alt="dukemon_notex.gif" height="135"/><br>
+</div><br>
+
+Below is another example of a scene showing a robot with a black and specular material. The following images display the hybrid representation (Mesh + Gaussians on the surface), the mesh with a traditional colored UV texture, and a depth map of the mesh:
+<div align="center">
+<b>Hybrid representation - Textured mesh - Depth map of the mesh</b><br>
+<img src="./media/examples/alpha_hybrid.png" alt="alpha_hybrid.png" height="400"/>
+<img src="./media/examples/alpha_texture.png" alt="alpha_texture.gif" height="400"/>
+<img src="./media/examples/alpha_depth.png" alt="alpha_depth.gif" height="400"/>
+</div>
+
+## Installation
+
+### 0. Requirements
+
+The software requirements are the following:
+- Conda (recommended for easy setup)
+- C++ Compiler for PyTorch extensions
+- CUDA toolkit 11.8 for PyTorch extensions
+- C++ Compiler and CUDA SDK must be compatible
+
+Please refer to the original <a href="https://github.com/graphdeco-inria/gaussian-splatting">3D Gaussian Splatting repository</a> for more details about requirements.
+
+### 1. Clone the repository
+
+Start by cloning this repository:
+
+```shell
+# HTTPS
+git clone https://github.com/Anttwo/SuGaR.git --recursive
+```
+
+or
+
+```shell
+# SSH
+git clone [email protected]:Anttwo/SuGaR.git --recursive
+```
+
+### 2. Install the required Python packages
+To install the required Python packages and activate the environment, go inside the `SuGaR/` directory and run the following commands:
+
+```shell
+conda env create -f environment.yml
+conda activate sugar
+```
+
+<details>
+<summary><span style="font-weight: bold;">If this command fails to create a working environment</span></summary>
+
+Then you can try to install the required packages manually by running the following commands:
+```shell
+conda create --name sugar -y python=3.9
+conda activate sugar
+conda install pytorch==2.0.1 torchvision==0.15.2 torchaudio==2.0.2 pytorch-cuda=11.8 -c pytorch -c nvidia
+conda install -c fvcore -c iopath -c conda-forge fvcore iopath
+conda install pytorch3d==0.7.4 -c pytorch3d
+conda install -c plotly plotly
+conda install -c conda-forge rich
+conda install -c conda-forge plyfile==0.8.1
+conda install -c conda-forge jupyterlab
+conda install -c conda-forge nodejs
+conda install -c conda-forge ipywidgets
+pip install open3d
+pip install --upgrade PyMCubes
+```
+</details>
+
+### 3. Install the Gaussian Splatting rasterizer
+
+Run the following commands inside the sugar directory to install the additional Python submodules required for Gaussian Splatting:
+
+```shell
+cd gaussian_splatting/submodules/diff-gaussian-rasterization/
+pip install -e .
+cd ../simple-knn/
+pip install -e .
+cd ../../../
+```
+Please refer to the <a href="https://github.com/graphdeco-inria/gaussian-splatting">3D Gaussian Splatting repository</a> for more details.
+
+
+## Quick Start
+
+Start by optimizing a vanilla Gaussian Splatting model for 7k iterations by running the script `gaussian_splatting/train.py`, as shown below. Please refer to the original <a href="https://github.com/graphdeco-inria/gaussian-splatting">3D Gaussian Splatting repository</a> for more details. This optimization should be very fast, and last only a few minutes.
+
+```shell
+python gaussian_splatting/train.py -s <path to COLMAP dataset> --iterations 7000 -m <path to the desired output directory>
+```
+
+Then, run the script `train.py` in the root directory to optimize a SuGaR model.
+
+```shell
+python train.py -s <path to COLMAP dataset> -c <path to the Gaussian Splatting checkpoint> -r <"density" or "sdf">
+```
+
+The most important arguments for the `train.py` script are the following:
+| Parameter | Type | Description |
+| :-------: | :--: | :---------: |
+| `--scene_path` / `-s`   | `str` | Path to the source directory containing a COLMAP dataset.|
+| `--checkpoint_path` / `-c` | `str` | Path to the checkpoint directory of the vanilla 3D Gaussian Splatting model. |
+| `--regularization_type` / `-r` | `str` | Type of regularization to use for optimizing SuGaR. Can be `"density"` or `"sdf"`. For reconstructing detailed objects centered in the scene with 360° coverage, `"density"` provides a better foreground mesh. For a stronger regularization and a better balance between foreground and background, choose `"sdf"`. |
+| `--eval` | `bool` | If True, performs an evaluation split of the training images. Default is `True`. |
+| `--low_poly` | `bool` | If True, uses the standard config for a low poly mesh, with `200_000` vertices and `6` Gaussians per triangle. |
+| `--high_poly` | `bool` | If True, uses the standard config for a high poly mesh, with `1_000_000` vertices and `1` Gaussian per triangle. |
+| `--refinement_time` | `str` | Default configs for time to spend on refinement. Can be `"short"` (2k iterations), `"medium"` (7k iterations) or `"long"` (15k iterations). |
+| `--export_uv_textured_mesh` / `-t` | `bool` | If True, will optimize and export a traditional textured mesh as an `.obj` file from the refined SuGaR model, after refinement. Computing a traditional color UV texture should take less than 10 minutes. Default is `True`. |
+| `--export_ply` | `bool` | If True, export a `.ply` file with the refined 3D Gaussians at the end of the training. This file can be large (+/- 500MB), but is needed for using the dedicated viewer. Default is `True`. |
+
+We provide more details about the two regularization methods `"density"` and `"sdf"` in the next section. For reconstructing detailed objects centered in the scene with 360° coverage, `"density"` provides a better foreground mesh. For a stronger regularization and a better balance between foreground and background, choose `"sdf"`. <br>
+The default configuration is `high_poly` with `refinement_time` set to `"long"`. Results are saved in the `output/` directory.<br>
+
+As we explain in the paper, this script extracts a mesh in 30~35 minutes on average on a single GPU. After mesh extraction, the refinement time only takes a few minutes when using `--refinement_time "short"`, but can take up to an hour when using `--refinement_time "long"`. A short refinement time is enough to produce a good-looking hybrid representation in most cases.
+
+Please note that the optimization time may vary (from 20 to 45 minutes) depending on the complexity of the scene and the GPU used. Moreover, the current implementation splits the optimization into 3 scripts that can be run separately (SuGaR optimization, mesh extraction, model refinement) so it reloads the data at each part, which is not optimal and takes several minutes. We will update the code in a near future to optimize this.
+
+Below is a detailed list of all the command line arguments for the `train.py` script.
+<details>
+<summary><span style="font-weight: bold;">All command line arguments for train.py</span></summary>
+
+#### Data and initial 3D Gaussian Splatting optimization
+
+| Parameter | Type | Description |
+| :-------: | :--: | :---------: |
+| `--scene_path` / `-s`   | `str` | Path to the source directory containing a COLMAP data set.|
+| `--checkpoint_path` / `-c` | `str` | Path to the checkpoint directory of the vanilla 3D Gaussian Splatting model. |
+| `--iteration_to_load` / `-i` | `int` | Iteration to load from the 3DGS checkpoint directory. If not specified, loads the iteration `7000`. |
+| `--eval` | `bool` | If True, performs an evaluation split of the training images. Default is `True`. |
+
+#### SuGaR optimization
+| Parameter | Type | Description |
+| :-------: | :--: | :---------: |
+| `--regularization_type` / `-r` | `str` | Type of regularization to use for optimizing SuGaR. Can be `"density"` or `"sdf"`. |
+| `--gpu` | `int` | Index of GPU device to use. Default is `0`. |
+
+#### Mesh extraction
+
+| Parameter | Type | Description |
+| :-------: | :--: | :---------: |
+| `--surface_level` / `-l` |`int`| Surface level to extract the mesh at. Default is `0.3`. |
+| `--n_vertices_in_mesh` / `-v` | `int` | Number of vertices in the extracted mesh. Default is `1_000_000`. |
+| `--bboxmin` / `-b` | `str` | Min coordinates to use for foreground bounding box, formatted as a string `"(x,y,z)"`.|
+| `--bboxmax` / `-B` | `str` | Max coordinates to use for foreground bounding box, formatted as a string `"(x,y,z)"`. |
+| `--center_bbox` | `bool` | If True, centers the bbox. Default is True. |
+
+#### SuGaR and mesh refinement (Hybrid representation)
+
+| Parameter | Type | Description |
+| :-------: | :--: | :---------: |
+| `--gaussians_per_triangle` / `-g` | `int` | Number of gaussians per triangle. Default is `1`. |
+| `--refinement_iterations` / `-f` | `int` | Number of refinement iterations. Default is `15_000`. |    
+
+#### (Optional) Parameters for traditional textured mesh extraction
+
+| Parameter | Type | Description |
+| :-------: | :--: | :---------: |
+| `--export_uv_textured_mesh` / `-t` | `bool` | If True, will optimize and export a textured mesh as an .obj file from the refined SuGaR model. Computing a traditional colored UV texture should take less than 10 minutes. Default is `True`. |
+| `--square_size` | `int` | Size of the square to use for the UV texture. Default is `10`. |
+| `--postprocess_mesh` | `bool` | If True, postprocess the mesh by removing border triangles with low-density. This step takes a few minutes and is not needed in general, as it can also be risky. However, it increases the quality of the mesh in some cases, especially when very thin objects are visible only from one side in the images. Default is `False`. |
+| `--postprocess_density_threshold` | `float` | Threshold to use for postprocessing the mesh. Default is `0.1`. |
+| `--postprocess_iterations` | `int` | Number of iterations to use for postprocessing the mesh. Default is `5`. |
+
+#### (Optional) Parameters for exporting PLY files for the dedicated viewer
+
+| Parameter | Type | Description |
+| :-------: | :--: | :---------: |
+| `--export_ply` | `bool` | If True, export a `.ply` file with the refined 3D Gaussians at the end of the training. This file can be large (+/- 500MB), but is needed for using the dedicated viewer. Default is `True`. |
+
+#### (Optional) Default configurations
+
+| Parameter | Type | Description |
+| :-------: | :--: | :---------: |
+| `--low_poly` | `bool` | If True, uses standard config for a low poly mesh, with `200_000` vertices and `6` Gaussians per triangle. |
+| `--high_poly` | `bool` | If True, uses standard config for a high poly mesh, with `1_000_000` vertices and `1` Gaussians per triangle. |
+| `--refinement_time` | `str` | Default configs for time to spend on refinement. Can be `"short"` (2k iterations), `"medium"` (7k iterations) or `"long"` (15k iterations). |
+
+</details>
+
+
+## Installing and using the real-time viewer
+
+Please find <a href="https://www.youtube.com/watch?v=YbjE0wnw67I">here</a> a short video illustrating how to use the viewer.
+
+### 1. Installation
+
+*The viewer is currently built for Linux and Mac OS. It is not compatible with Windows. For Windows users, we recommend to use WSL2 (Windows Subsystem for Linux), as it is very easy to install and use. Please refer to the <a href="https://docs.microsoft.com/en-us/windows/wsl/install-win10">official documentation</a> for more details.<br> We thank <a href="https://github.com/mkkellogg/GaussianSplats3D">Mark Kellogg for his awesome 3D Gaussian Splatting implementation for Three.js</a>, which we used for building this viewer.*
+
+Please start by installing the latest versions of Node.js (such as 21.x) and npm.
+A simple way to do this is to run the following commands (using aptitude):
+
+```shell
+curl -fsSL https://deb.nodesource.com/setup_21.x | sudo -E bash -
+sudo apt-get install -y nodejs
+sudo apt-get install aptitude
+sudo aptitude install -y npm
+```
+
+Then, go inside the `./sugar_viewer/` directory and run the following commands:
+
+```shell
+npm install
+cd ..
+```
+
+### 2. Usage
+
+First, make sure you have exported a `.ply` file and an `.obj` file using the `train.py` script. The `.ply` file contains the refined 3D Gaussians, and the `.obj` file contains the textured mesh. These files are exported by default when running the `train.py` script, so if you ran the code with default values for `--export_ply` and `--export_uv_textured_mesh`, you should be good to go.
+
+The ply file should be located in `./output/refined_ply/<your scene name>/`. Then, just run the following command in the root directory to start the viewer:
+
+```shell
+python run_viewer.py -p <path to the .ply file>
+```
+Please make sure your `.ply` file is located in the right folder, and use a relative path starting with `./output/refined_ply`.
+This command will redirect you to a local URL. Click on the link to open the viewer in your browser. Click the icons on the top right to switch between the different representations (hybrid representation, textured mesh, wireframe mesh). Use the mouse to rotate the scene, and the mouse wheel to zoom in and out. 
+
+<div align="center" >
+<img src="./media/examples/viewer_example.png" alt="viewer_example.png" width="800"/>
+</div><br>
+
+## Tips for using SuGaR on your own data and obtain better reconstructions
+
+### 1. Capture images or videos that cover the entire surface of the scene
+
+Using a smartphone or a camera, capture images or a video that cover the entire surface of the 3D scene you want to reconstruct. The easiest way to do this is to move around the scene while recording a video. Try to move slowly and smoothly in order to avoid motion blur. For consistent reconstruction and easier camera pose estimation with COLMAP, maintaining a uniform focal length and a constant exposure time is also important. We recommend to disable auto-focus on your smartphone to ensure that the focal length remains constant.
+
+For better reconstructions, try to cover objects from several and different angles, especially for thin and detailed parts of the scene. 
+Indeed, SuGaR is able to reconstruct very thin and detailed objects, but some artifacts may appear if these thin objects are not covered enough and are visible only from one side in the training images.
+
+<details>
+<summary><span style="font-weight: bold;">Detailed explanation</span></summary>
+SuGaR applies Poisson reconstruction with 3D points sampled on the parts of the surface that are visible in the training images. This visibility constraint is important to prevent sampling points on the backside of the Gaussian level sets, located behind the surface of the scene, which would produce a lot of self-collisions and many unnecessary vertices in the mesh after applying Poisson reconstruction.
+However, this visibility constraint also means that SuGaR cannot reconstruct parts of the surface that are not visible in the training images. If thin objects are visible only from one side in the training images, the Poisson reconstruction will try to reconstruct a closed surface, and will extend the surface of the thin objects, which produces an inaccurate mesh.
+
+_TODO: Add images illustrating such artifacts._
+</details><br>
+
+However, such artifacts are not visible in the hybrid representation, because the gaussian texturing gives low-opacity to these artifacts during refinement. 
+
+We already have simple ideas that could help to avoid such artifacts, such as **(a)** identifying new camera poses that cover parts of the surface non-visible in the training images that are likely to be on the same level set as the visible parts, and **(b)** adding these camera poses to the set of cameras used for sampling the points when applying Poisson reconstruction. We will update the code in a near future to include this.
+
+To convert a video to images, you can install `ffmpeg` and run the following command:
+```shell
+ffmpeg -i <Path to the video file> -qscale:v 1 -qmin 1 -vf fps=<FPS> %04d.jpg
+```
+where `<FPS>` is the desired sampling rate of the video images. An FPS value of 1 corresponds to sampling one image per second. We recommend to adjust the sampling rate to the length of the video, so that the number of sampled images is between 100 and 300.
+
+### 2. Estimate camera poses with COLMAP
+
+Please first install a recent version of COLMAP (ideally CUDA-powered) and make sure to put the images you want to use in a directory `<location>/input`. Then, run the script `gaussian_splatting/convert.py` from the original Gaussian splatting implementation to compute the camera poses from the images using COLMAP. Please refer to the original <a href="https://github.com/graphdeco-inria/gaussian-splatting">3D Gaussian Splatting repository</a> for more details.
+
+```shell
+python gaussian_splatting/convert.py -s <location>
+```
+
+Sometimes COLMAP fails to reconstruct all images into the same model and hence produces multiple sub-models. The smaller sub-models generally contain only a few images. However, by default, the script `convert.py` will apply Image Undistortion only on the first sub-model, which may contain only a few images.
+
+If this is the case, a simple solution is to keep only the largest sub-model and discard the others. To do this, open the source directory containing your input images, then open the sub-directory `<Source_directory>/distorted/sparse/`. You should see several sub-directories named `0/`, `1/`, etc., each containing a sub-model. Remove all sub-directories except the one containing the largest files, and rename it to `0/`. Then, run the script `convert.py` one more time but skip the matching process:
+
+```shell
+python gaussian_splatting/convert.py -s <location> --skip_matching
+```
+
+_Note: If the sub-models have common registered images, they could be merged into a single model as post-processing step using COLMAP; However, merging sub-models requires to run another global bundle adjustment after the merge, which can be time consuming._
+
+
+### 3. Density or SDF? Choose a regularization method that fits your scene
+
+As we explain in the paper, we provide two separate regularization methods for SuGaR: a density regularization and an SDF regularization. The density regularization is the simplest one and works well with objects centered in the scene. The SDF provides a stronger regularization, especially in background regions. 
+As a consequence, the SDF regularization produces higher metrics on standard datasets. 
+However, for reconstructing an object centered in the scene with images taken from all around the object, the simpler density regularization generally produces a better mesh.
+
+Therefore, we recommend the following when using the `train.py` script:
+- For reconstructing detailed objects centered in the scene with 360° coverage (such as the toys we reconstructed in our presentation video), start with the density regularization `-r 'density'`. However, this may result in more chaotic Gaussians in the background.
+- For reconstructing more challenging scenes or enforcing a stronger regularization in the background, use the SDF regularization `-r 'sdf'`.
+
+### 4. (Optional) Adapt the scale and the bounding box of the scene
+
+As it is explained in the original <a href="https://github.com/graphdeco-inria/gaussian-splatting">3D Gaussian Splatting repository</a>, the method is expected to reconstruct a scene with reasonable scale. For reconstructing much larger datasets, like a city district, the original authors recommend to lower the learning rates of the positions and scaling factors of the Gaussians. The more extensive the scene, the lower these values should be.
+
+Concerning SuGaR, such learning rates should also be lowered when reconstructing a very large scene. Moreover, as we explain in the supplementary material of the paper, for extracting a mesh from the Gaussians with an optimal repartition of vertices, we apply two Poisson reconstructions in practice: one on _foreground_ Gaussians, and one on _background_ Gaussians. The foreground Gaussians are defined as the Gaussians located inside a predefined bounding box, and the background Gaussians are defined as the Gaussians located outside this bounding box. 
+
+By default, this bounding box is computed as the bounding box of all camera centers. This general approach is coherent with how the original 3D Gaussian Splatting scales the learning rates. We used this default bounding box for all the reconstructions shown in the paper and the presentation video.
+
+However, this bounding box might not be optimal in very specific cases, especially when the user wants to reconstruct with high details a very specific object located somewhere in the scene, or if the scene is very large, or if the camera centers are very far from the scene.
+The user is free to provide a custom bounding box to the `train.py` script, using the parameters `--bboxmin` and `--bboxmax`. Please note that the bounding box must be provided as strings, formatted as `"(x,y,z)"`, where `x`, `y` and `z` are the coordinates of the min and max points of the bounding box.
+
+
+## Rendering, composition and animation
+
+The `view_sugar_results.ipynb` notebook and the `metrics.py` script provides examples of how to load a refined SuGaR model for rendering a scene with the hybrid representation and the Gaussian Splatting rasterizer. We will add more details about this in a near future.
+
+We also provide in the `blender` directory several python scripts to export from Blender composition and animation data of SuGaR meshes modified or animated within Blender. Additionally, we provide in the `sugar_scene/sugar_compositor.py` script a Python class that can be used to import such animation or composition data into PyTorch and apply it to the SuGaR hybrid representation. 
+
+The hybrid representation allows for high-quality rendering of the scene with the Gaussian Splatting rasterizer, as shown below.<br>
+
+<div align="center" >
+<img src="./media/blender/full_teaser.png" alt="teaser.gif" width="800"/>
+</div><br>
+
+The usage of these scripts and class may be a bit tricky, so we will add a detailed tutorial on how to use them in a near future.
+
+
+## Evaluation
+
+To evaluate the quality of the reconstructions, we provide a script `metrics.py` that computes the PSNR, SSIM and LPIPS metrics on test images. Start by optimizing SuGaR models for the desired scenes and a regularization method (`"density"` or `"sdf"`), then create a `.json` config file containing the paths to the scenes in the following format: `{source_images_dir_path: vanilla_gaussian_splatting_checkpoint_path}`.
+
+Finally, run the script as follows:
+
+```shell
+python metrics.py --scene_config <Path to the .json file> -r <"sdf" or "density"> 
+```
+
+Results are saved in a `.json` file in the `output/metrics/` directory. 
+Please refer to the script for more details on the command line arguments.

sugar/blender/export_camera_trajectory.py

@@ -0,0 +1,42 @@
+import bpy
+import csv
+import os
+import json
+
+# Get the path to the current Blender file
+blend_file_path = bpy.data.filepath
+
+# Get the directory of the Blender file
+blend_dir = os.path.dirname(blend_file_path)
+
+# Construct the absolute path to the "data.csv" file
+path = './'
+data_file_path = os.path.join(blend_dir, path)
+data_file_path = os.path.join(data_file_path, "camera_trajectory.json")
+print('Camera poses file path:', data_file_path)
+
+res_dict = {}
+res_dict['matrix_world'] = []
+
+start_frame = 1
+end_frame = 71
+
+# Save frame poses for all bones
+for i_frame in range(start_frame, end_frame+1):
+    print('\nFrame', i_frame)
+    
+    # Set frame
+    bpy.context.scene.frame_set(i_frame)
+    
+    # Save camera pose
+    obj = bpy.context.active_object
+    res_dict['matrix_world'].append([[obj.matrix_world[i][j] for j in range(4)] for i in range(4)])
+    
+    print('matrix world:')
+    print(res_dict['matrix_world'])
+    
+        
+with open(data_file_path, "w") as outfile:
+    json.dump(res_dict, outfile)
+    print(f'Results saved to "{data_file_path}".')
+    

sugar/blender/export_pose_bones.py

@@ -0,0 +1,62 @@
+import bpy
+import csv
+import os
+import json
+
+# Get the path to the current Blender file
+blend_file_path = bpy.data.filepath
+
+# Get the directory of the Blender file
+blend_dir = os.path.dirname(blend_file_path)
+
+path = './'
+
+# Construct the absolute path to the "data.csv" file
+data_file_path = os.path.join(blend_dir, path)
+data_file_path = os.path.join(data_file_path, "animation.json")  # TODO: Depends on the animation
+print('Pose file path:', data_file_path)
+
+start_frame = 1
+end_frame = 100 # TODO: Depends on the animation
+
+res_dict = {}
+
+obj = bpy.context.active_object
+armature = obj.data
+
+# Initialize dict
+res_dict['matrix_world'] = [[obj.matrix_world[i][j] for j in range(4)] for i in range(4)]
+res_dict['rest_bones'] = {}
+res_dict['pose_bones'] = {}
+    
+# Save rest poses for all bones
+for bone in armature.bones:
+    mat = obj.matrix_world @ bone.matrix_local
+    mat_list = [[mat[i][j] for j in range(4)] for i in range(4)]
+    res_dict['rest_bones'][bone.name] = mat_list
+    res_dict['pose_bones'][bone.name] = []
+
+# Save frame poses for all bones
+for i_frame in range(start_frame, end_frame+1):
+    print('Frame', i_frame)
+    
+    # Set frame
+    bpy.context.scene.frame_set(i_frame)
+    
+    # Get object transform
+    obj = bpy.context.active_object
+    
+    pose = obj.pose
+    armature = obj.data
+    
+    print("pose_position:", armature.pose_position)
+    
+    for bone in pose.bones:
+        mat = obj.matrix_world @ bone.matrix
+        mat_list = [[mat[i][j] for j in range(4)] for i in range(4)]
+        res_dict['pose_bones'][bone.name].append(mat_list)
+        
+with open(data_file_path, "w") as outfile:
+    json.dump(res_dict, outfile)
+    print(f'Results saved to "{data_file_path}".')
+    

sugar/blender/export_reference_points.py

@@ -0,0 +1,58 @@
+import bpy
+import csv
+import os
+import json
+
+# Get the path to the current Blender file
+blend_file_path = bpy.data.filepath
+
+# Get the directory of the Blender file
+blend_dir = os.path.dirname(blend_file_path)
+
+path = './'
+
+# Construct the absolute path to the "data.csv" file
+data_file_path = os.path.join(blend_dir, path)
+data_file_path = os.path.join(data_file_path, "scene_reference_points.json")  # TODO: Depends on the scene
+print('Points file path:', data_file_path)
+
+# Get data
+obj = bpy.context.active_object
+m = bpy.context.object.evaluated_get(bpy.context.evaluated_depsgraph_get()).to_mesh()
+vertices = m.vertices        
+print("Number of vertices:", len(m.vertices))
+
+# Initialize dict
+res_dict = {}
+res_dict['matrix_world'] = [[obj.matrix_world[i][j] for j in range(4)] for i in range(4)]
+res_dict['reference_points'] = []
+res_dict['groups'] = []
+res_dict['weights'] = []
+
+# Get names of all vertex groups
+vertex_group_names = {}
+print("Vertex groups:")
+for i in range(len(obj.vertex_groups)):
+    group = obj.vertex_groups[i]
+    print(group.index, ":", group.name)
+    vertex_group_names[str(group.index)] = group.name
+ 
+for i in range(len(vertices)):
+    
+    # Add coordinates
+    v = obj.matrix_world @ vertices[i].co
+    res_dict['reference_points'].append([v[0], v[1], v[2]])
+    
+    # Add the names of the corresponding vertex groups
+    group_list = []
+    weight_list = []
+    for group in vertices[i].groups:
+        group_list.append(vertex_group_names[str(group.group)])
+        weight_list.append(group.weight)
+    res_dict['groups'].append(group_list)
+    res_dict['weights'].append(weight_list)
+        
+with open(data_file_path, "w") as outfile:
+    json.dump(res_dict, outfile)
+    print(f'Results saved to "{data_file_path}".')
+    

sugar/blender/export_tpose_bones.py

@@ -0,0 +1,37 @@
+import bpy
+import csv
+import os
+import json
+
+# Get the path to the current Blender file
+blend_file_path = bpy.data.filepath
+
+# Get the directory of the Blender file
+blend_dir = os.path.dirname(blend_file_path)
+
+path = './'
+
+# Construct the absolute path to the "data.csv" file
+data_file_path = os.path.join(blend_dir, path)
+data_file_path = os.path.join(data_file_path, "scene_tpose.json")  # TODO: Depends on the scene
+print('Pose file path:', data_file_path)
+
+res_dict = {}
+
+obj = bpy.context.active_object
+armature = obj.data
+
+# Initialize dict
+res_dict['matrix_world'] = [[obj.matrix_world[i][j] for j in range(4)] for i in range(4)]
+res_dict['tpose_bones'] = {}
+    
+# Save rest poses for all bones
+for bone in armature.bones:
+    mat = obj.matrix_world @ bone.matrix_local
+    mat_list = [[mat[i][j] for j in range(4)] for i in range(4)]
+    res_dict['tpose_bones'][bone.name] = mat_list
+        
+with open(data_file_path, "w") as outfile:
+    json.dump(res_dict, outfile)
+    print(f'Results saved to "{data_file_path}".')
+    

sugar/blender/export_tpose_points.py

@@ -0,0 +1,58 @@
+import bpy
+import csv
+import os
+import json
+
+# Get the path to the current Blender file
+blend_file_path = bpy.data.filepath
+
+# Get the directory of the Blender file
+blend_dir = os.path.dirname(blend_file_path)
+
+path = './'
+
+# Construct the absolute path to the "data.csv" file
+data_file_path = os.path.join(blend_dir, path)
+data_file_path = os.path.join(data_file_path, "scene_tpose_points.json")  # TODO: Depends on the scene
+print('Points file path:', data_file_path)
+
+# Get data
+obj = bpy.context.active_object
+m = bpy.context.object.evaluated_get(bpy.context.evaluated_depsgraph_get()).to_mesh()
+vertices = m.vertices        
+print("Number of vertices:", len(m.vertices))
+
+# Initialize dict
+res_dict = {}
+res_dict['matrix_world'] = [[obj.matrix_world[i][j] for j in range(4)] for i in range(4)]
+res_dict['tpose_points'] = []
+res_dict['groups'] = []
+res_dict['weights'] = []
+
+# Get names of all vertex groups
+vertex_group_names = {}
+print("Vertex groups:")
+for i in range(len(obj.vertex_groups)):
+    group = obj.vertex_groups[i]
+    print(group.index, ":", group.name)
+    vertex_group_names[str(group.index)] = group.name
+ 
+for i in range(len(vertices)):
+    
+    # Add coordinates
+    v = obj.matrix_world @ vertices[i].co
+    res_dict['tpose_points'].append([v[0], v[1], v[2]])
+    
+    # Add the names of the corresponding vertex groups
+    group_list = []
+    weight_list = []
+    for group in vertices[i].groups:
+        group_list.append(vertex_group_names[str(group.group)])
+        weight_list.append(group.weight)
+    res_dict['groups'].append(group_list)
+    res_dict['weights'].append(weight_list)
+        
+with open(data_file_path, "w") as outfile:
+    json.dump(res_dict, outfile)
+    print(f'Results saved to "{data_file_path}".')
+    

sugar/configs/metrics/scenes.json

@@ -0,0 +1,16 @@
+
+{
+    "../nerfs/data/nerfstudio/garden": "../nerfs/og_gaussian_splatting/output/b5287e20-5/",
+    "../nerfs/data/nerfstudio/kitchen": "../nerfs/og_gaussian_splatting/output/dbde7200-f/",
+    "../nerfs/data/nerfstudio/room": "../nerfs/og_gaussian_splatting/output/a4f1fad4-6/",
+    "../nerfs/data/nerfstudio/bicycle": "../nerfs/og_gaussian_splatting/output/7d853ef3-c/",
+    "../nerfs/data/nerfstudio/counter": "../nerfs/og_gaussian_splatting/output/56003f04-1/",
+    "../nerfs/data/nerfstudio/bonsai": "../nerfs/og_gaussian_splatting/output/24f88369-5/",
+    "../nerfs/data/nerfstudio/stump": "../nerfs/og_gaussian_splatting/output/c4e344f5-a/",
+
+    "../nerfs/data/nerfstudio/playroom": "../nerfs/og_gaussian_splatting/output/ebefd1c2-7/",
+    "../nerfs/data/nerfstudio/drjohnson": "../nerfs/og_gaussian_splatting/output/da1efd51-d/",
+
+    "../nerfs/data/nerfstudio/train": "../nerfs/og_gaussian_splatting/output/0b8edce2-7/",
+    "../nerfs/data/nerfstudio/truck": "../nerfs/og_gaussian_splatting/output/cc98c5bd-6/"
+}

sugar/environment.yml

@@ -0,0 +1,246 @@
+name: sugar
+channels:
+  - pytorch3d
+  - plotly
+  - iopath
+  - pytorch
+  - nvidia
+  - conda-forge
+  - defaults
+dependencies:
+  - _libgcc_mutex=0.1=main
+  - _openmp_mutex=5.1=1_gnu
+  - anyio=4.1.0=pyhd8ed1ab_0
+  - argon2-cffi=21.1.0=py39h3811e60_2
+  - arrow=1.3.0=pyhd8ed1ab_0
+  - asttokens=2.4.1=pyhd8ed1ab_0
+  - async-lru=2.0.4=pyhd8ed1ab_0
+  - attrs=23.1.0=pyh71513ae_1
+  - babel=2.14.0=pyhd8ed1ab_0
+  - beautifulsoup4=4.12.2=pyha770c72_0
+  - blas=1.0=mkl
+  - bleach=6.1.0=pyhd8ed1ab_0
+  - brotli-python=1.0.9=py39h6a678d5_7
+  - bzip2=1.0.8=h7b6447c_0
+  - ca-certificates=2023.11.17=hbcca054_0
+  - cached-property=1.5.2=hd8ed1ab_1
+  - cached_property=1.5.2=pyha770c72_1
+  - certifi=2023.11.17=pyhd8ed1ab_0
+  - cffi=1.16.0=py39h5eee18b_0
+  - charset-normalizer=2.0.4=pyhd3eb1b0_0
+  - colorama=0.4.6=pyhd8ed1ab_0
+  - cryptography=41.0.7=py39hdda0065_0
+  - cuda-cudart=11.8.89=0
+  - cuda-cupti=11.8.87=0
+  - cuda-libraries=11.8.0=0
+  - cuda-nvrtc=11.8.89=0
+  - cuda-nvtx=11.8.86=0
+  - cuda-runtime=11.8.0=0
+  - decorator=5.1.1=pyhd8ed1ab_0
+  - defusedxml=0.7.1=pyhd8ed1ab_0
+  - entrypoints=0.4=pyhd8ed1ab_0
+  - exceptiongroup=1.2.0=pyhd8ed1ab_0
+  - executing=2.0.1=pyhd8ed1ab_0
+  - ffmpeg=4.3=hf484d3e_0
+  - filelock=3.13.1=py39h06a4308_0
+  - fqdn=1.5.1=pyhd8ed1ab_0
+  - freetype=2.12.1=h4a9f257_0
+  - fvcore=0.1.5.post20221221=pyhd8ed1ab_0
+  - giflib=5.2.1=h5eee18b_3
+  - gmp=6.2.1=h295c915_3
+  - gmpy2=2.1.2=py39heeb90bb_0
+  - gnutls=3.6.15=he1e5248_0
+  - idna=3.4=py39h06a4308_0
+  - importlib-metadata=7.0.0=pyha770c72_0
+  - importlib_metadata=7.0.0=hd8ed1ab_0
+  - importlib_resources=6.1.1=pyhd8ed1ab_0
+  - intel-openmp=2023.1.0=hdb19cb5_46306
+  - iopath=0.1.9=py39
+  - ipykernel=5.5.5=py39hef51801_0
+  - ipython=8.18.1=pyh707e725_3
+  - ipython_genutils=0.2.0=py_1
+  - ipywidgets=8.1.1=pyhd8ed1ab_0
+  - isoduration=20.11.0=pyhd8ed1ab_0
+  - jedi=0.19.1=pyhd8ed1ab_0
+  - jinja2=3.1.2=py39h06a4308_0
+  - jpeg=9e=h5eee18b_1
+  - json5=0.9.14=pyhd8ed1ab_0
+  - jsonpointer=2.4=py39hf3d152e_3
+  - jsonschema=4.20.0=pyhd8ed1ab_0
+  - jsonschema-specifications=2023.11.2=pyhd8ed1ab_0
+  - jsonschema-with-format-nongpl=4.20.0=pyhd8ed1ab_0
+  - jupyter-lsp=2.2.1=pyhd8ed1ab_0
+  - jupyter_client=8.6.0=pyhd8ed1ab_0
+  - jupyter_core=5.5.0=py39hf3d152e_0
+  - jupyter_events=0.9.0=pyhd8ed1ab_0
+  - jupyter_server=2.12.1=pyhd8ed1ab_0
+  - jupyter_server_terminals=0.5.0=pyhd8ed1ab_0
+  - jupyterlab=4.0.9=pyhd8ed1ab_0
+  - jupyterlab_pygments=0.3.0=pyhd8ed1ab_0
+  - jupyterlab_server=2.25.2=pyhd8ed1ab_0
+  - jupyterlab_widgets=3.0.9=pyhd8ed1ab_0
+  - lame=3.100=h7b6447c_0
+  - lcms2=2.12=h3be6417_0
+  - ld_impl_linux-64=2.38=h1181459_1
+  - lerc=3.0=h295c915_0
+  - libcublas=11.11.3.6=0
+  - libcufft=10.9.0.58=0
+  - libcufile=1.8.1.2=0
+  - libcurand=10.3.4.101=0
+  - libcusolver=11.4.1.48=0
+  - libcusparse=11.7.5.86=0
+  - libdeflate=1.17=h5eee18b_1
+  - libffi=3.4.4=h6a678d5_0
+  - libgcc=7.2.0=h69d50b8_2
+  - libgcc-ng=11.2.0=h1234567_1
+  - libgomp=11.2.0=h1234567_1
+  - libiconv=1.16=h7f8727e_2
+  - libidn2=2.3.4=h5eee18b_0
+  - libnpp=11.8.0.86=0
+  - libnvjpeg=11.9.0.86=0
+  - libpng=1.6.39=h5eee18b_0
+  - libsodium=1.0.18=h36c2ea0_1
+  - libstdcxx-ng=11.2.0=h1234567_1
+  - libtasn1=4.19.0=h5eee18b_0
+  - libtiff=4.5.1=h6a678d5_0
+  - libunistring=0.9.10=h27cfd23_0
+  - libwebp=1.3.2=h11a3e52_0
+  - libwebp-base=1.3.2=h5eee18b_0
+  - lz4-c=1.9.4=h6a678d5_0
+  - markdown-it-py=3.0.0=pyhd8ed1ab_0
+  - markupsafe=2.1.1=py39h7f8727e_0
+  - matplotlib-inline=0.1.6=pyhd8ed1ab_0
+  - mdurl=0.1.0=pyhd8ed1ab_0
+  - mistune=3.0.2=pyhd8ed1ab_0
+  - mkl=2023.1.0=h213fc3f_46344
+  - mkl-service=2.4.0=py39h5eee18b_1
+  - mkl_fft=1.3.8=py39h5eee18b_0
+  - mkl_random=1.2.4=py39hdb19cb5_0
+  - mpc=1.1.0=h10f8cd9_1
+  - mpfr=4.0.2=hb69a4c5_1
+  - mpmath=1.3.0=py39h06a4308_0
+  - nbclient=0.8.0=pyhd8ed1ab_0
+  - nbconvert-core=7.12.0=pyhd8ed1ab_0
+  - ncurses=6.4=h6a678d5_0
+  - nettle=3.7.3=hbbd107a_1
+  - networkx=3.1=py39h06a4308_0
+  - nodejs=6.13.1=0
+  - notebook-shim=0.2.3=pyhd8ed1ab_0
+  - numpy=1.26.2=py39h5f9d8c6_0
+  - numpy-base=1.26.2=py39hb5e798b_0
+  - openh264=2.1.1=h4ff587b_0
+  - openjpeg=2.4.0=h3ad879b_0
+  - openssl=3.0.12=h7f8727e_0
+  - overrides=7.4.0=pyhd8ed1ab_0
+  - packaging=23.2=pyhd8ed1ab_0
+  - pandocfilters=1.5.0=pyhd8ed1ab_0
+  - parso=0.8.3=pyhd8ed1ab_0
+  - pickleshare=0.7.5=py_1003
+  - pillow=10.0.1=py39ha6cbd5a_0
+  - pip=23.3.1=py39h06a4308_0
+  - pkgutil-resolve-name=1.3.10=pyhd8ed1ab_1
+  - platformdirs=4.1.0=pyhd8ed1ab_0
+  - plotly=5.18.0=py_0
+  - plyfile=0.8.1=pyhd8ed1ab_0
+  - portalocker=2.8.2=py39hf3d152e_1
+  - prometheus_client=0.19.0=pyhd8ed1ab_0
+  - ptyprocess=0.7.0=pyhd3deb0d_0
+  - pure_eval=0.2.2=pyhd8ed1ab_0
+  - pycparser=2.21=pyhd3eb1b0_0
+  - pygments=2.17.2=pyhd8ed1ab_0
+  - pyopenssl=23.2.0=py39h06a4308_0
+  - pysocks=1.7.1=py39h06a4308_0
+  - python=3.9.18=h955ad1f_0
+  - python-dateutil=2.8.2=pyhd8ed1ab_0
+  - python-fastjsonschema=2.19.0=pyhd8ed1ab_0
+  - python-json-logger=2.0.7=pyhd8ed1ab_0
+  - python_abi=3.9=2_cp39
+  - pytorch=2.0.1=py3.9_cuda11.8_cudnn8.7.0_0
+  - pytorch-cuda=11.8=h7e8668a_5
+  - pytorch-mutex=1.0=cuda
+  - pytorch3d=0.7.4=py39_cu118_pyt201
+  - pytz=2023.3.post1=pyhd8ed1ab_0
+  - pyyaml=6.0=py39hb9d737c_4
+  - pyzmq=25.1.0=py39h6a678d5_0
+  - readline=8.2=h5eee18b_0
+  - referencing=0.32.0=pyhd8ed1ab_0
+  - requests=2.31.0=py39h06a4308_0
+  - rfc3339-validator=0.1.4=pyhd8ed1ab_0
+  - rfc3986-validator=0.1.1=pyh9f0ad1d_0
+  - rich=13.7.0=pyhd8ed1ab_0
+  - send2trash=1.8.2=pyh41d4057_0
+  - setuptools=68.2.2=py39h06a4308_0
+  - six=1.16.0=pyh6c4a22f_0
+  - sniffio=1.3.0=pyhd8ed1ab_0
+  - soupsieve=2.5=pyhd8ed1ab_1
+  - sqlite=3.41.2=h5eee18b_0
+  - stack_data=0.6.2=pyhd8ed1ab_0
+  - sympy=1.12=py39h06a4308_0
+  - tabulate=0.9.0=pyhd8ed1ab_1
+  - tbb=2021.8.0=hdb19cb5_0
+  - tenacity=8.2.2=py39h06a4308_0
+  - termcolor=2.3.0=pyhd8ed1ab_0
+  - terminado=0.18.0=pyh0d859eb_0
+  - tinycss2=1.2.1=pyhd8ed1ab_0
+  - tk=8.6.12=h1ccaba5_0
+  - tomli=2.0.1=pyhd8ed1ab_0
+  - torchaudio=2.0.2=py39_cu118
+  - torchtriton=2.0.0=py39
+  - torchvision=0.15.2=py39_cu118
+  - tornado=6.3.3=py39h5eee18b_0
+  - tqdm=4.66.1=pyhd8ed1ab_0
+  - traitlets=5.14.0=pyhd8ed1ab_0
+  - types-python-dateutil=2.8.19.14=pyhd8ed1ab_0
+  - typing_extensions=4.7.1=py39h06a4308_0
+  - typing_utils=0.1.0=pyhd8ed1ab_0
+  - uri-template=1.3.0=pyhd8ed1ab_0
+  - urllib3=1.26.18=py39h06a4308_0
+  - wcwidth=0.2.12=pyhd8ed1ab_0
+  - webcolors=1.13=pyhd8ed1ab_0
+  - webencodings=0.5.1=pyhd8ed1ab_2
+  - websocket-client=1.7.0=pyhd8ed1ab_0
+  - wheel=0.41.2=py39h06a4308_0
+  - widgetsnbextension=4.0.9=pyhd8ed1ab_0
+  - xz=5.4.5=h5eee18b_0
+  - yacs=0.1.8=pyhd8ed1ab_0
+  - yaml=0.2.5=h7f98852_2
+  - zeromq=4.3.4=h2531618_0
+  - zipp=3.17.0=pyhd8ed1ab_0
+  - zlib=1.2.13=h5eee18b_0
+  - zstd=1.5.5=hc292b87_0
+  - pip:
+      - addict==2.4.0
+      - ansi2html==1.9.1
+      - blinker==1.7.0
+      - click==8.1.7
+      - comm==0.2.0
+      - configargparse==1.7
+      - contourpy==1.2.0
+      - cycler==0.12.1
+      - dash==2.14.2
+      - dash-core-components==2.0.0
+      - dash-html-components==2.0.0
+      - dash-table==5.0.0
+      - flask==3.0.0
+      - fonttools==4.46.0
+      - itsdangerous==2.1.2
+      - joblib==1.3.2
+      - kiwisolver==1.4.5
+      - matplotlib==3.8.2
+      - nbformat==5.7.0
+      - nest-asyncio==1.5.8
+      - open3d==0.17.0
+      - pandas==2.1.4
+      - pexpect==4.9.0
+      - prompt-toolkit==3.0.43
+      - pymcubes==0.1.4
+      - pyparsing==3.1.1
+      - pyquaternion==0.9.9
+      - retrying==1.3.4
+      - rpds-py==0.15.2
+      - scikit-learn==1.3.2
+      - scipy==1.11.4
+      - stack-data==0.6.3
+      - threadpoolctl==3.2.0
+      - tzdata==2023.3
+      - werkzeug==3.0.1

sugar/extract_mesh.py

@@ -0,0 +1,47 @@
+import argparse
+from sugar.sugar_utils.general_utils import str2bool
+from sugar.sugar_extractors.coarse_mesh import extract_mesh_from_coarse_sugar
+
+if __name__ == "__main__":
+    # Parser
+    parser = argparse.ArgumentParser(description='Script to extract a mesh from a coarse SuGaR scene.')
+    parser.add_argument('-s', '--scene_path',
+                        type=str, 
+                        help='path to the scene data to use.')
+    parser.add_argument('-c', '--checkpoint_path', 
+                        type=str, 
+                        help='path to the vanilla 3D Gaussian Splatting Checkpoint to load.')
+    parser.add_argument('-i', '--iteration_to_load', 
+                        type=int, default=7000, 
+                        help='iteration to load.')
+    
+    parser.add_argument('-m', '--coarse_model_path', type=str, default=None, help='')
+    
+    parser.add_argument('-l', '--surface_level', type=float, default=None, 
+                        help='Surface level to extract the mesh at. If None, will extract levels 0.1, 0.3 and 0.5')
+    parser.add_argument('-d', '--decimation_target', type=int, default=None, 
+                        help='Target number of vertices to decimate the mesh to. If None, will decimate to 200_000 and 1_000_000.')
+    
+    parser.add_argument('-o', '--mesh_output_dir',
+                        type=str, default=None, 
+                        help='path to the output directory.')
+    
+    parser.add_argument('-b', '--bboxmin', type=str, default=None, help='Min coordinates to use for foreground.')
+    parser.add_argument('-B', '--bboxmax', type=str, default=None, help='Max coordinates to use for foreground.')
+    parser.add_argument('--center_bbox', type=str2bool, default=False, help='If True, center the bounding box. Default is False.')
+    
+    parser.add_argument('--gpu', type=int, default=0, help='Index of GPU device to use.')
+    
+    parser.add_argument('--eval', type=str2bool, default=True, help='Use eval split.')
+    parser.add_argument('--use_centers_to_extract_mesh', type=str2bool, default=False, 
+                        help='If True, just use centers of the gaussians to extract mesh.')
+    parser.add_argument('--use_marching_cubes', type=str2bool, default=False, 
+                        help='If True, use marching cubes to extract mesh.')
+    parser.add_argument('--use_vanilla_3dgs', type=str2bool, default=False, 
+                        help='If True, use vanilla 3DGS to extract mesh.')
+    
+    args = parser.parse_args()
+    
+    # Call function
+    extract_mesh_from_coarse_sugar(args)
+    

sugar/extract_refined_mesh_with_texture.py

@@ -0,0 +1,46 @@
+import argparse
+from sugar.sugar_utils.general_utils import str2bool
+from sugar.sugar_extractors.refined_mesh import extract_mesh_and_texture_from_refined_sugar
+
+if __name__ == "__main__":
+    # Parser
+    parser = argparse.ArgumentParser(description='Script to train a full macarons model in large 3D scenes.')
+    parser.add_argument('-s', '--scene_path',
+                        type=str, 
+                        help='(Required) path to the scene data to use.')  # --OK
+    parser.add_argument('-i', '--iteration_to_load', 
+                        type=int, default=7000, 
+                        help='iteration to load.')  # --OK
+    parser.add_argument('-c', '--checkpoint_path', 
+                        type=str, 
+                        help='(Required) path to the vanilla 3D Gaussian Splatting Checkpoint to load.')  # --OK
+    parser.add_argument('-m', '--refined_model_path',
+                        type=str, 
+                        help='(Required) Path to the refine model checkpoint.')  # --OK
+    parser.add_argument('-o', '--mesh_output_dir',
+                        type=str, 
+                        default=None, 
+                        help='path to the output directory.')  # --OK
+    parser.add_argument('-n', '--n_gaussians_per_surface_triangle',
+                        default=None, type=int, help='Number of gaussians per surface triangle.')  # --OK
+    parser.add_argument('--square_size',
+                        default=None, type=int, help='Size of the square to use for the texture.')  # --OK
+    
+    parser.add_argument('--eval', type=str2bool, default=True, help='Use eval split.')
+    parser.add_argument('-g', '--gpu', type=int, default=0, help='Index of GPU to use.')
+    
+    # Optional postprocessing
+    parser.add_argument('--postprocess_mesh', type=str2bool, default=False, 
+                        help='If True, postprocess the mesh by removing border triangles with low-density. '
+                        'This step takes a few minutes and is not needed in general, as it can also be risky. '
+                        'However, it increases the quality of the mesh in some cases, especially when an object is visible only from one side.')  # --OK
+    parser.add_argument('--postprocess_density_threshold', type=float, default=0.1,
+                        help='Threshold to use for postprocessing the mesh.')  # --OK
+    parser.add_argument('--postprocess_iterations', type=int, default=5,
+                        help='Number of iterations to use for postprocessing the mesh.')  # --OK
+    
+    args = parser.parse_args()
+    
+    # Call function
+    extract_mesh_and_texture_from_refined_sugar(args)
+    

sugar/gaussian_splatting/LICENSE.md

@@ -0,0 +1,83 @@
+Gaussian-Splatting License  
+===========================  
+
+**Inria** and **the Max Planck Institut for Informatik (MPII)** hold all the ownership rights on the *Software* named **gaussian-splatting**.  
+The *Software* is in the process of being registered with the Agence pour la Protection des  
+Programmes (APP).  
+
+The *Software* is still being developed by the *Licensor*.  
+
+*Licensor*'s goal is to allow the research community to use, test and evaluate  
+the *Software*.  
+
+## 1.  Definitions  
+
+*Licensee* means any person or entity that uses the *Software* and distributes  
+its *Work*.  
+
+*Licensor* means the owners of the *Software*, i.e Inria and MPII  
+
+*Software* means the original work of authorship made available under this  
+License ie gaussian-splatting.  
+
+*Work* means the *Software* and any additions to or derivative works of the  
+*Software* that are made available under this License.  
+
+
+## 2.  Purpose  
+This license is intended to define the rights granted to the *Licensee* by  
+Licensors under the *Software*.  
+
+## 3.  Rights granted  
+
+For the above reasons Licensors have decided to distribute the *Software*.  
+Licensors grant non-exclusive rights to use the *Software* for research purposes  
+to research users (both academic and industrial), free of charge, without right  
+to sublicense.. The *Software* may be used "non-commercially", i.e., for research  
+and/or evaluation purposes only.  
+
+Subject to the terms and conditions of this License, you are granted a  
+non-exclusive, royalty-free, license to reproduce, prepare derivative works of,  
+publicly display, publicly perform and distribute its *Work* and any resulting  
+derivative works in any form.  
+
+## 4.  Limitations  
+
+**4.1 Redistribution.** You may reproduce or distribute the *Work* only if (a) you do  
+so under this License, (b) you include a complete copy of this License with  
+your distribution, and (c) you retain without modification any copyright,  
+patent, trademark, or attribution notices that are present in the *Work*.  
+
+**4.2 Derivative Works.** You may specify that additional or different terms apply  
+to the use, reproduction, and distribution of your derivative works of the *Work*  
+("Your Terms") only if (a) Your Terms provide that the use limitation in  
+Section 2 applies to your derivative works, and (b) you identify the specific  
+derivative works that are subject to Your Terms. Notwithstanding Your Terms,  
+this License (including the redistribution requirements in Section 3.1) will  
+continue to apply to the *Work* itself.  
+
+**4.3** Any other use without of prior consent of Licensors is prohibited. Research  
+users explicitly acknowledge having received from Licensors all information  
+allowing to appreciate the adequacy between of the *Software* and their needs and  
+to undertake all necessary precautions for its execution and use.  
+
+**4.4** The *Software* is provided both as a compiled library file and as source  
+code. In case of using the *Software* for a publication or other results obtained  
+through the use of the *Software*, users are strongly encouraged to cite the  
+corresponding publications as explained in the documentation of the *Software*.  
+
+## 5.  Disclaimer  
+
+THE USER CANNOT USE, EXPLOIT OR DISTRIBUTE THE *SOFTWARE* FOR COMMERCIAL PURPOSES  
+WITHOUT PRIOR AND EXPLICIT CONSENT OF LICENSORS. YOU MUST CONTACT INRIA FOR ANY  
+UNAUTHORIZED USE: [email protected] . ANY SUCH ACTION WILL  
+CONSTITUTE A FORGERY. THIS *SOFTWARE* IS PROVIDED "AS IS" WITHOUT ANY WARRANTIES  
+OF ANY NATURE AND ANY EXPRESS OR IMPLIED WARRANTIES, WITH REGARDS TO COMMERCIAL  
+USE, PROFESSIONNAL USE, LEGAL OR NOT, OR OTHER, OR COMMERCIALISATION OR  
+ADAPTATION. UNLESS EXPLICITLY PROVIDED BY LAW, IN NO EVENT, SHALL INRIA OR THE  
+AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR  
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE  
+GOODS OR SERVICES, LOSS OF USE, DATA, OR PROFITS OR BUSINESS INTERRUPTION)  
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT  
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING FROM, OUT OF OR  
+IN CONNECTION WITH THE *SOFTWARE* OR THE USE OR OTHER DEALINGS IN THE *SOFTWARE*.  

sugar/gaussian_splatting/SIBR_viewers/.gitignore

@@ -0,0 +1,45 @@
+extlibs/
+build/
+install/
+src/projects/*
+cmake-gui.exe.stackdump
+__pycache__/
+
+# emacs garbage
+\#*
+.\#*
+
+# vim garbage
+*.swp
+*.swo
+*.idea/
+*.log
+*.sh
+*.tmp
+
+hs_err_*
+
+# re include common public projects
+!src/projects/ulr/
+!src/projects/dataset_tools/
+
+# more vim garbage
+# Swap
+[._]*.s[a-v][a-z]
+!*.svg  # comment out if you don't need vector files
+[._]*.sw[a-p]
+[._]s[a-rt-v][a-z]
+[._]ss[a-gi-z]
+[._]sw[a-p]
+
+# Session
+Session.vim
+Sessionx.vim
+
+# Temporary
+.netrwhist
+*~
+# Auto-generated tag files
+tags
+# Persistent undo
+[._]*.un~

sugar/gaussian_splatting/SIBR_viewers/CMakeLists.txt

@@ -0,0 +1,213 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+CMAKE_MINIMUM_REQUIRED(VERSION 3.22)
+
+set (CMAKE_SYSTEM_VERSION 10.0.15063.0 CACHE INTERNAL "Cmake system version" FORCE)
+PROJECT(sibr_projects)
+
+set(REQUIRED_VERSION "3.22.0")
+set(CHECKED_VERSION "3.27.0")
+
+if (CMAKE_VERSION VERSION_LESS REQUIRED_VERSION)
+    message(WARNING "Deprecated version of cmake. Please update to at least ${REQUIRED_VERSION} (${CHECKED_VERSION} recommended).")
+elseif (CMAKE_VERSION VERSION_GREATER CHECKED_VERSION)
+	message(WARNING "Untested version of cmake. If you checked everything is working properly, please update ${CHECKED_VERSION} in the main CmakeLists.txt with the version you tested.")
+endif()
+
+## Include cmake stuff (functions/macros) : Modules files
+if(WIN32)
+list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake/windows)
+list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake/windows/Modules)
+else()
+list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake/linux)
+list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake/linux/Modules)
+endif()
+set_property(GLOBAL PROPERTY USE_FOLDERS ON)
+
+## To maintain cmake versions compatibilities
+include(cmake_policies)
+setPolicies()
+
+include(git_describe)
+git_describe(GIT_BRANCH SIBR_CORE_BRANCH GIT_COMMIT_HASH SIBR_CORE_COMMIT_HASH GIT_TAG SIBR_CORE_TAG GIT_VERSION SIBR_CORE_VERSION)
+
+message(STATUS "SIBR version :\n BRANCH ${SIBR_CORE_BRANCH}\n COMMIT_HASH ${SIBR_CORE_COMMIT_HASH}\n TAG ${SIBR_CORE_TAG}\n VERSION ${SIBR_CORE_VERSION}")
+
+if(NOT WIN32)
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+endif()
+
+
+if (WIN32)
+	## Allow C++11 + other flags
+	include(CheckCXXCompilerFlag)
+	get_filename_component(currentBuildTool ${CMAKE_BUILD_TOOL} NAME_WE)	# tool that can launch the native build system. returned value may be the full path
+	if(${currentBuildTool} MATCHES "(msdev|devenv|nmake|MSBuild)")
+
+		add_compile_options("$<$<COMPILE_LANGUAGE:CXX>:/W3;/DNOMINMAX;/MP;-D_USE_MATH_DEFINES>")
+	    #add_definitions(/W3 /DNOMINMAX /MP -D_USE_MATH_DEFINES)# /D_ITERATOR_DEBUG_LEVEL=1 because you need all external DLl to compile with this flag too
+	    set(CMAKE_CONFIGURATION_TYPES "RelWithDebInfo;Release;Debug" CACHE STRING "" FORCE)
+	    set(CMAKE_CXX_STANDARD 14)
+		set(CMAKE_CXX_STANDARD_REQUIRED ON)
+		set(CMAKE_CXX_EXTENSIONS OFF)
+	elseif(${currentBuildTool} MATCHES "(make|gmake)")
+	    add_definitions("-Wall -Wno-unknown-pragmas -Wno-sign-compare -g -std=c++14 -D__forceinline=\"inline\ __attribute__((always_inline))\"")
+		# CHECK_CXX_COMPILER_FLAG("-std=gnu++11" COMPILER_SUPPORTS_CXX11)
+		# CHECK_CXX_COMPILER_FLAG("-std=gnu++0x" COMPILER_SUPPORTS_CXX0X)
+		# if(COMPILER_SUPPORTS_CXX11)
+		# 	add_definitions(-std=gnu++11)
+		# elseif(COMPILER_SUPPORTS_CXX0X)
+		# 	add_definitions(-std=gnu++0x)
+		# else()
+		# 	message(SEND_ERROR "The compiler ${CMAKE_CXX_COMPILER} has no C++14 support. Please use a different C++ compiler.")
+		# endif()
+	elseif(APPLE) ## \todo TODO: do a better test and send error on unsupported c++14 compiler
+	    add_definitions(-std=c++14 -stdlib=libc++)
+	endif()
+else()
+	## Allow C++11 + other flags
+	include(CheckCXXCompilerFlag)
+	get_filename_component(currentBuildTool ${CMAKE_BUILD_TOOL} NAME_WE)	# tool that can launch the native build system. returned value may be the full path
+	if(${currentBuildTool} MATCHES "(msdev|devenv|nmake|MSBuild)")
+
+		add_compile_options("$<$<COMPILE_LANGUAGE:CXX>:/W3;/DNOMINMAX;/MP;-D_USE_MATH_DEFINES>")
+	    #add_definitions(/W3 /DNOMINMAX /MP -D_USE_MATH_DEFINES)# /D_ITERATOR_DEBUG_LEVEL=1 because you need all external DLl to compile with this flag too
+	    set(CMAKE_CONFIGURATION_TYPES "RelWithDebInfo;Release;Debug" CACHE STRING "" FORCE)
+	    set(CMAKE_CXX_STANDARD 14)
+		set(CMAKE_CXX_STANDARD_REQUIRED ON)
+		set(CMAKE_CXX_EXTENSIONS OFF)
+	elseif(${currentBuildTool} MATCHES "(make|gmake|ninja)")
+		add_definitions("-fpermissive -fPIC -Wall -Wno-unknown-pragmas -Wno-sign-compare -g -std=c++17 -D__forceinline=\"inline\ __attribute__((always_inline))\"")
+	elseif(APPLE) ## \todo TODO: do a better test and send error on unsupported c++14 compiler
+	    add_definitions(-std=c++17 -stdlib=libc++)
+	endif()
+endif()
+
+set(INSTALL_STANDALONE ON)
+
+## Set default build output binaries (used also in sub CMakeLists.txt) :
+set(BIN_BUILT_DIR "bin")
+if(CMAKE_SIZEOF_VOID_P EQUAL 8)
+	set(ARCHI_BUILT_DIR "x64")
+	set(LIB_BUILT_DIR "lib64")
+else()
+	set(ARCHI_BUILT_DIR "x86")
+	set(LIB_BUILT_DIR "lib")
+endif()
+
+option(SEPARATE_CONFIGURATIONS "Clearer separation between configurations" OFF)
+SET(CMAKE_INSTALL_ROOT ${CMAKE_CURRENT_SOURCE_DIR}/install)
+SET(CMAKE_INSTALL_PREFIX ${CMAKE_INSTALL_ROOT})
+
+if(DEFINED CMAKE_BUILD_TYPE) ## for mono config type (make/nmake/ninja based)
+	if(${CMAKE_BUILD_TYPE} MATCHES "Debug")
+		set(CMAKE_DEBUG_POSTFIX "_d")
+	elseif(${CMAKE_BUILD_TYPE} MATCHES "RelWithDebInfo")
+		set(CMAKE_RELWITHDEBINFO_POSTFIX "_rwdi")
+	elseif(${CMAKE_BUILD_TYPE} MATCHES "MinSizeRel")
+		set(CMAKE_MINSIZEREL_POSTFIX "_msr")
+	elseif(${CMAKE_BUILD_TYPE} MATCHES "Release")
+		set(CMAKE_RELEASE_POSTFIX "")
+	endif()
+
+	if(SEPARATE_CONFIGURATIONS)
+		SET(CMAKE_INSTALL_PREFIX_${CMAKE_BUILD_TYPE} 	${CMAKE_INSTALL_ROOT}/${CMAKE_BUILD_TYPE})
+	else()
+		SET(CMAKE_INSTALL_PREFIX_${CMAKE_BUILD_TYPE} 	${CMAKE_INSTALL_ROOT})
+	endif()
+
+	MESSAGE(STATUS "Install path set to ${CMAKE_INSTALL_PREFIX}.")
+	SET(CMAKE_OUTPUT_LIB_${CMAKE_BUILD_TYPE} 	${CMAKE_INSTALL_PREFIX_${CMAKE_BUILD_TYPE}}/lib)
+	SET(CMAKE_OUTPUT_BIN_${CMAKE_BUILD_TYPE} 	${CMAKE_INSTALL_PREFIX_${CMAKE_BUILD_TYPE}}/bin)
+
+	set(CMAKE_LIBRARY_OUTPUT_DIRECTORY_${CMAKE_BUILD_TYPE} 	${CMAKE_OUTPUT_LIB_${CMAKE_BUILD_TYPE}})
+	set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY_${CMAKE_BUILD_TYPE} 	${CMAKE_OUTPUT_LIB_${CMAKE_BUILD_TYPE}})
+	set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_${CMAKE_BUILD_TYPE} 	${CMAKE_OUTPUT_BIN_${CMAKE_BUILD_TYPE}})
+	set(CMAKE_PDB_OUTPUT_DIRECTORY_${CMAKE_BUILD_TYPE} 		${CMAKE_OUTPUT_BIN_${CMAKE_BUILD_TYPE}})
+endif()
+foreach(CONFIG_TYPES ${CMAKE_CONFIGURATION_TYPES}) ## for multi config types (MSVC based)
+	string(TOUPPER ${CONFIG_TYPES} CONFIG_TYPES_UC)
+	if(${CONFIG_TYPES} MATCHES "Debug")
+		set(CMAKE_DEBUG_POSTFIX "_d")
+	elseif(${CONFIG_TYPES} MATCHES "RelWithDebInfo")
+		set(CMAKE_RELWITHDEBINFO_POSTFIX "_rwdi")
+	elseif(${CONFIG_TYPES} MATCHES "MinSizeRel")
+		set(CMAKE_MINSIZEREL_POSTFIX "_msr")
+	elseif(${CMAKE_BUILD_TYPE} MATCHES "Release")
+		set(CMAKE_RELEASE_POSTFIX "")
+	endif()
+
+	if(SEPARATE_CONFIGURATIONS)
+		SET(CMAKE_INSTALL_PREFIX_${CONFIG_TYPES_UC} ${CMAKE_INSTALL_ROOT}/${CONFIG_TYPES})
+	else()
+		SET(CMAKE_INSTALL_PREFIX_${CONFIG_TYPES_UC} ${CMAKE_INSTALL_ROOT})
+	endif()
+	
+	MESSAGE(STATUS "Install path for ${CONFIG_TYPES} set to ${CMAKE_INSTALL_PREFIX_${CONFIG_TYPES_UC}}.")
+	SET(CMAKE_OUTPUT_LIB_${CONFIG_TYPES_UC} 	${CMAKE_INSTALL_PREFIX_${CONFIG_TYPES_UC}}/lib)
+	SET(CMAKE_OUTPUT_BIN_${CONFIG_TYPES_UC} 	${CMAKE_INSTALL_PREFIX_${CONFIG_TYPES_UC}}/bin)
+
+	set(CMAKE_LIBRARY_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC} 	${CMAKE_OUTPUT_LIB_${CONFIG_TYPES_UC}})
+	set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC} 	${CMAKE_OUTPUT_LIB_${CONFIG_TYPES_UC}})
+	set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC} 	${CMAKE_OUTPUT_BIN_${CONFIG_TYPES_UC}})
+	set(CMAKE_PDB_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC} 		${CMAKE_OUTPUT_BIN_${CONFIG_TYPES_UC}})
+endforeach()
+
+
+# Settings for RPATH
+if (NOT WIN32)
+	# Default config of Fedora at INRIA has no LD_LIBRARY_PATH (for security reasons I guess)
+	# So at least I had "./" in RPATH and found link paths
+	#set(CMAKE_SKIP_RPATH TRUE)
+	#SET(CMAKE_SKIP_BUILD_RPATH  FALSE)
+	SET(CMAKE_BUILD_WITH_INSTALL_RPATH TRUE)
+
+	SET(CMAKE_INSTALL_RPATH "$ORIGIN")
+	#SET(CMAKE_INSTALL_RPATH "./")
+	#SET(CMAKE_INSTALL_RPATH "./:/usr/lib64/:/usr/lib/:/usr/local/lib64/:/usr/local/lib/") # This one causes be a problem -> a "default" version of libGL (swrast) is located in /usr/lib64 and was selected instead of nvidia one (in /usr/lib64/nividia)
+
+	SET(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
+endif()
+
+
+set(SIBR_PROGRAMARGS "" CACHE STRING "Default program arguments used in Visual Studio target properties")
+if ("${SIBR_PROGRAMARGS}" STREQUAL "")
+  if (DEFINED ENV{SIBR_PROGRAMARGS})
+    set(SIBR_PROGRAMARGS "$ENV{SIBR_PROGRAMARGS}" CACHE STRING "Default program arguments used in Visual Studio target properties" FORCE)
+    message( STATUS "Using program options found in environment variable 'SIBR_PROGRAMARGS' => '${SIBR_PROGRAMARGS}'")
+  else()
+    message(
+      "Note you can provide default program options for Visual Studio target properties by either setting"
+      " a value for the cmake cached variable 'SIBR_PROGRAMARGS' or by setting a new environment "
+      "variable 'SIBR_PROGRAMARGS'")
+  endif()
+endif()
+
+add_custom_target(PREBUILD ALL)
+
+## Include all projects
+set(SIBR_PROJECTS_SAMPLES_SUBPAGE_REF "")
+set(SIBR_PROJECTS_OURS_SUBPAGE_REF "")
+set(SIBR_PROJECTS_TOOLBOX_SUBPAGE_REF "")
+set(SIBR_PROJECTS_OTHERS_SUBPAGE_REF "")
+set(SIBR_PROJECTS_SAMPLES_REF_REF "")
+set(SIBR_PROJECTS_OURS_REF_REF "")
+set(SIBR_PROJECTS_TOOLBOX_REF_REF "")
+set(SIBR_PROJECTS_OTHERS_REF_REF "")
+set(DOXY_APP_SPECIFIC_IMG_PATH "")
+set(DOXY_DOC_EXCLUDE_PATTERNS_DIRS "")
+ADD_SUBDIRECTORY(src)
+
+
+## handle documentation
+if (WIN32)
+ADD_SUBDIRECTORY(docs)
+endif()

sugar/gaussian_splatting/SIBR_viewers/LICENSE.md

@@ -0,0 +1,83 @@
+SIBR License  
+============  
+
+**Inria** and **UCA** hold all the ownership rights on the *Software* named **sibr-core**.  
+The *Software* has been registered with the Agence pour la Protection des  
+Programmes (APP) under IDDN.FR.001.430020.000.S.P.2019.000.31235  
+
+The *Software* is still being developed by the *Licensor*.  
+
+*Licensor*'s goal is to allow the research community to use, test and evaluate  
+the *Software*.  
+
+## 1.  Definitions  
+
+*Licensee* means any person or entity that uses the *Software* and distributes  
+its *Work*.  
+
+*Licensor* means the owners of the *Software*, i.e Inria and UCA  
+
+*Software* means the original work of authorship made available under this  
+License ie Sibr-core.  
+
+*Work* means the *Software* and any additions to or derivative works of the  
+*Software* that are made available under this License.  
+
+
+## 2.  Purpose  
+This license is intended to define the rights granted to the *Licensee* by  
+Licensors under the *Software*.  
+
+## 3.  Rights granted  
+
+For the above reasons Licensors have decided to distribute the *Software*.  
+Licensors grant non-exclusive rights to use the *Software* for research purposes  
+to research users (both academic and industrial), free of charge, without right  
+to sublicense.. The *Software* may be used "non-commercially", i.e., for research  
+and/or evaluation purposes only.  
+
+Subject to the terms and conditions of this License, you are granted a  
+non-exclusive, royalty-free, license to reproduce, prepare derivative works of,  
+publicly display, publicly perform and distribute its *Work* and any resulting  
+derivative works in any form.  
+
+## 4.  Limitations  
+
+**4.1 Redistribution.** You may reproduce or distribute the *Work* only if (a) you do  
+so under this License, (b) you include a complete copy of this License with  
+your distribution, and (c) you retain without modification any copyright,  
+patent, trademark, or attribution notices that are present in the *Work*.  
+
+**4.2 Derivative Works.** You may specify that additional or different terms apply  
+to the use, reproduction, and distribution of your derivative works of the *Work*  
+("Your Terms") only if (a) Your Terms provide that the use limitation in  
+Section 2 applies to your derivative works, and (b) you identify the specific  
+derivative works that are subject to Your Terms. Notwithstanding Your Terms,  
+this License (including the redistribution requirements in Section 3.1) will  
+continue to apply to the *Work* itself.  
+
+**4.3** Any other use without of prior consent of Licensors is prohibited. Research  
+users explicitly acknowledge having received from Licensors all information  
+allowing to appreciate the adequacy between of the *Software* and their needs and  
+to undertake all necessary precautions for its execution and use.  
+
+**4.4** The *Software* is provided both as a compiled library file and as source  
+code. In case of using the *Software* for a publication or other results obtained  
+through the use of the *Software*, users are strongly encouraged to cite the  
+corresponding publications as explained in the documentation of the *Software*.  
+
+## 5.  Disclaimer  
+
+THE USER CANNOT USE, EXPLOIT OR DISTRIBUTE THE *SOFTWARE* FOR COMMERCIAL PURPOSES  
+WITHOUT PRIOR AND EXPLICIT CONSENT OF LICENSORS. YOU MUST CONTACT INRIA FOR ANY  
+UNAUTHORIZED USE: [email protected] . ANY SUCH ACTION WILL  
+CONSTITUTE A FORGERY. THIS *SOFTWARE* IS PROVIDED "AS IS" WITHOUT ANY WARRANTIES  
+OF ANY NATURE AND ANY EXPRESS OR IMPLIED WARRANTIES, WITH REGARDS TO COMMERCIAL  
+USE, PROFESSIONNAL USE, LEGAL OR NOT, OR OTHER, OR COMMERCIALISATION OR  
+ADAPTATION. UNLESS EXPLICITLY PROVIDED BY LAW, IN NO EVENT, SHALL INRIA OR THE  
+AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR  
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE  
+GOODS OR SERVICES, LOSS OF USE, DATA, OR PROFITS OR BUSINESS INTERRUPTION)  
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT  
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING FROM, OUT OF OR  
+IN CONNECTION WITH THE *SOFTWARE* OR THE USE OR OTHER DEALINGS IN THE *SOFTWARE*.  

sugar/gaussian_splatting/SIBR_viewers/README.md

@@ -0,0 +1,142 @@
+# SIBR Core
+
+**SIBR** is a System for Image-Based Rendering.  
+It is built around the *sibr-core* in this repo and several *Projects* implementing published research papers.  
+For more complete documentation, see here: [SIBR Documentation](https://sibr.gitlabpages.inria.fr) 
+  
+This **SIBR core** repository provides :
+- a basic Image-Based Renderer
+- a per-pixel implementation of Unstructured Lumigraph (ULR)
+- several dataset tools & pipelines do process input images
+  
+Details on how to run in the documentation and in the section below.  
+If you use this code in a publication, please cite the system as follows:
+
+```
+@misc{sibr2020,
+   author       = "Bonopera, Sebastien and Esnault, Jerome and Prakash, Siddhant and Rodriguez, Simon and Thonat, Theo and Benadel, Mehdi and Chaurasia, Gaurav and Philip, Julien and Drettakis, George",
+   title        = "sibr: A System for Image Based Rendering",
+   year         = "2020",
+   url          = "https://gitlab.inria.fr/sibr/sibr_core"
+}
+```
+
+## Setup
+
+**Note**: The current release is for *Windows 10* only. We are planning a Linux release soon.
+
+#### Binary distribution
+
+The easiest way to use SIBR is to download the binary distribution. All steps described below, including all preprocessing for your datasets will work using this code.
+
+Download the distribution from the page: https://sibr.gitlabpages.inria.fr/download.html (Core, 57Mb); unzip the file and rename the directory "install".
+
+#### Install requirements
+
+- [**Visual Studio 2019**](https://visualstudio.microsoft.com/fr/downloads/)
+- [**Cmake 3.16+**](https://cmake.org/download)
+- [**7zip**](https://www.7-zip.org)
+- [**Python 3.8+**](https://www.python.org/downloads/) for shaders installation scripts and dataset preprocess scripts
+- [**Doxygen 1.8.17+**](https://www.doxygen.nl/download.html#srcbin) for documentation
+- [**CUDA 10.1+**](https://developer.nvidia.com/cuda-downloads) and [**CUDnn**](https://developer.nvidia.com/cudnn) if projects requires it
+
+Make sure Python, CUDA and Doxygen are in the PATH
+
+If you have Chocolatey, you can grab most of these with this command:
+
+```sh
+choco install cmake 7zip python3 doxygen.install cuda
+
+## Visual Studio is available on Chocolatey,
+## though we do advise to set it from Visual Studio Installer and to choose your licensing accordingly
+choco install visualstudio2019community
+```
+
+#### Generation of the solution
+
+- Checkout this repository's master branch:
+  
+  ```sh
+  ## through HTTPS
+  git clone https://gitlab.inria.fr/sibr/sibr_core.git -b master
+  ## through SSH
+  git clone [email protected]:sibr/sibr_core.git -b master
+  ```
+- Run Cmake-gui once, select the repo root as a source directory, `build/` as the build directory. Configure, select the Visual Studio C++ Win64 compiler
+- Select the projects you want to generate among the BUILD elements in the list (you can group Cmake flags by categories to access those faster)
+- Generate
+
+#### Compilation
+
+- Open the generated Visual Studio solution (`build/sibr_projects.sln`)
+- Build the `ALL_BUILD` target, and then the `INSTALL` target
+- The compiled executables will be put in `install/bin`
+- TODO: are the DLLs properly installed?
+
+#### Compilation of the documentation
+
+- Open the generated Visual Studio solution (`build/sibr_projects.sln`)
+- Build the `DOCUMENTATION` target
+- Run `install/docs/index.html` in a browser
+
+
+## Scripts
+
+Some scripts will require you to install `PIL`, and `convert` from `ImageMagick`.
+
+```sh
+## To install pillow
+python -m pip install pillow
+
+## If you have Chocolatey, you can install imagemagick from this command
+choco install imagemagick
+```
+
+## Troubleshooting
+
+#### Bugs and Issues
+
+We will track bugs and issues through the Issues interface on gitlab. Inria gitlab does not allow creation of external accounts, so if you have an issue/bug please email <code>[email protected]</code> and we will either create a guest account or create the issue on our side.
+
+#### Cmake complaining about the version
+
+if you are the first to use a very recent Cmake version, you will have to update `CHECKED_VERSION` in the root `CmakeLists.txt`.
+
+#### Weird OpenCV error
+
+you probably selected the 32-bits compiler in Cmake-gui.
+
+#### `Cmd.exe failed with error 009` or similar
+
+make sure Python is installed and in the path. 
+
+#### `BUILD_ALL` or `INSTALL` fail because of a project you don't really need
+
+build and install each project separately by selecting the proper targets.
+
+#### Error in CUDA headers under Visual Studio 2019
+
+make sure CUDA >= 10.1 (first version to support VS2019) is installed.
+
+## To run an example
+
+For more details, please see the documentation: http://sibr.gitlabpages.inria.fr
+
+Download a dataset from: https://repo-sam.inria.fr/fungraph/sibr-datasets/
+
+e.g., the *sibr-museum-front* dataset in the *DATASETS_PATH* directory.
+
+```
+wget https://repo-sam.inria.fr/fungraph/sibr-datasets/museum_front27_ulr.zip
+```
+
+Once you have built the system or downloaded the binaries (see above), go to *install/bin* and you can run:
+```
+	sibr_ulrv2_app.exe --path DATASETS_PATH/sibr-museum-front
+```
+
+You will have an interactive viewer and you can navigate freely in the captured scene. 
+Our default interactive viewer has a main view running the algorithm and a top view to visualize the position of the calibrated cameras. By default you are in WASD mode, and can toggle to trackball using the "y" key. Please see the page [Interface](https://sibr.gitlabpages.inria.fr/docs/nightly/howto_sibr_useful_objects.html) for more details on the interface.
+
+Please see the documentation on how to create a dataset from your own scene, and the various other IBR algorithms available.
+

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/MSVCsetUserCommand.cmake

@@ -0,0 +1,149 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+if(__MSVCsetUserCommand_cmake_INCLUDED__)
+	return()
+else()
+	set(__MSVCsetUserCommand_cmake_INCLUDED__ ON)
+endif()
+
+## Allow to configure the Debugger settings of visual studio
+## Note: Using this command under linux doesn't affect anything
+## On run Debug Windows local : visual will try to load a specific COMMAND with ARGS in the provided WORKING_DIR
+##
+## usage:
+## MSVCsetUserCommand(	<targetName>
+##    [COMMAND 			<myCustomAppToLaunch> | [ PATH <myCustomDirWhereIsDefaultTargetFileNameToLaunch> [FILE <myCustomExecFileToLaunch>] ] ]
+##    ARGS 				<associatedArguments>
+##    WORKING_DIR		<whereStartTheProgram>
+## )
+##
+## Warning 1 : All arugments () must be passed under quotes
+## Warning 2 : WORKING_DIR path arg have to finish with remain slah '/'
+## Warning 3 : use COMMAND for external app OR PATH (optionaly with FILE) option(s) to set your built/installed/moved target
+##
+## Example 1:
+## include(MSVCsetUserCommand)
+## MSVCsetUserCommand(	UnityRenderingPlugin
+## 	  COMMAND 			"C:/Program Files (x86)/Unity/Editor/Unity.exe"
+## 	  ARGS				"-force-opengl -projectPath \"${CMAKE_HOME_DIRECTORY}/UnityPlugins/RenderingPluginExample/UnityProject\""
+## 	  WORKING_DIR		"${CMAKE_HOME_DIRECTORY}/UnityPlugins/RenderingPluginExample/UnityProject"
+## 	  VERBOSE
+## )
+##
+## Example 2:
+## include(MSVCsetUserCommand)
+## MSVCsetUserCommand(	ibrApp
+## 	  PATH 				"C:/Program Files (x86)/workspace/IBR/install"
+##	  FILE				"ibrApp${CMAKE_EXECUTABLE_SUFFIX}" ## this option line is optional since the target name didn't change between build and install step
+## 	  ARGS				"-path \"${CMAKE_HOME_DIRECTORY}/dataset\""
+## 	  WORKING_DIR		"${CMAKE_HOME_DIRECTORY}"
+## 	  VERBOSE
+## )
+##
+function(MSVCsetUserCommand targetName)
+    cmake_parse_arguments(MSVCsuc "VERBOSE" "PATH;FILE;COMMAND;ARGS;WORKING_DIR" "" ${ARGN} )
+
+	## If no arguments are given, do not create an unecessary .vcxproj.user file
+	set(MSVCsuc_DEFAULT OFF)
+
+	if(MSVCsuc_PATH AND MSVCsuc_DEFAULT)
+		set(MSVCsuc_DEFAULT OFF)
+	endif()
+
+	if(MSVCsuc_FILE AND MSVCsuc_DEFAULT)
+		set(MSVCsuc_DEFAULT OFF)
+	endif()
+
+	if(NOT MSVCsuc_COMMAND)
+		if(MSVCsuc_PATH AND MSVCsuc_FILE)
+			set(MSVCsuc_COMMAND "${MSVCsuc_PATH}\\${MSVCsuc_FILE}")
+		elseif(MSVCsuc_PATH)
+			set(MSVCsuc_COMMAND "${MSVCsuc_PATH}\\$(TargetFileName)")
+		else()
+			set(MSVCsuc_COMMAND "$(TargetPath)") ## => $(TargetDir)\$(TargetName)$(TargetExt)
+		endif()
+	elseif(MSVCsuc_DEFAULT)
+		set(MSVCsuc_DEFAULT OFF)
+	endif()
+
+        # NOTE: there was a typo here. there is an else if written after else statement
+        # changing the order of the else if statement
+	if(MSVCsuc_WORKING_DIR)
+		file(TO_NATIVE_PATH ${MSVCsuc_WORKING_DIR} MSVCsuc_WORKING_DIR)
+	elseif(MSVCsuc_DEFAULT)
+		set(MSVCsuc_DEFAULT OFF)
+	else()
+		set(MSVCsuc_WORKING_DIR "$(ProjectDir)")
+	endif()
+
+	if(NOT MSVCsuc_ARGS)
+		set(MSVCsuc_ARGS "")
+	elseif(MSVCsuc_DEFAULT)
+		set(MSVCsuc_DEFAULT OFF)
+	endif()
+
+	if(MSVC10 OR (MSVC AND MSVC_VERSION GREATER 1600)) # 2010 or newer
+
+		if(CMAKE_SIZEOF_VOID_P EQUAL 8)
+			set(PLATEFORM_BITS x64)
+		else()
+			set(PLATEFORM_BITS Win32)
+		endif()
+
+		if(NOT MSVCsuc_DEFAULT AND PLATEFORM_BITS)
+
+			file(WRITE "${CMAKE_CURRENT_BINARY_DIR}/${targetName}.vcxproj.user"
+		"<?xml version=\"1.0\" encoding=\"utf-8\"?>
+<Project ToolsVersion=\"4.0\" xmlns=\"http://schemas.microsoft.com/developer/msbuild/2003\">
+  <PropertyGroup Condition=\"'$(Configuration)|$(Platform)'=='Release|${PLATEFORM_BITS}'\">
+    <LocalDebuggerCommand>${MSVCsuc_COMMAND}</LocalDebuggerCommand>
+    <LocalDebuggerCommandArguments>${MSVCsuc_ARGS}</LocalDebuggerCommandArguments>
+    <DebuggerFlavor>WindowsLocalDebugger</DebuggerFlavor>
+	<LocalDebuggerWorkingDirectory>${MSVCsuc_WORKING_DIR}</LocalDebuggerWorkingDirectory>
+  </PropertyGroup>
+  <PropertyGroup Condition=\"'$(Configuration)|$(Platform)'=='Debug|${PLATEFORM_BITS}'\">
+    <LocalDebuggerCommand>${MSVCsuc_COMMAND}</LocalDebuggerCommand>
+    <LocalDebuggerCommandArguments>${MSVCsuc_ARGS}</LocalDebuggerCommandArguments>
+    <DebuggerFlavor>WindowsLocalDebugger</DebuggerFlavor>
+    <LocalDebuggerWorkingDirectory>${MSVCsuc_WORKING_DIR}</LocalDebuggerWorkingDirectory>
+  </PropertyGroup>
+    <PropertyGroup Condition=\"'$(Configuration)|$(Platform)'=='MinSizeRel|${PLATEFORM_BITS}'\">
+    <LocalDebuggerCommand>${MSVCsuc_COMMAND}</LocalDebuggerCommand>
+    <LocalDebuggerCommandArguments>${MSVCsuc_ARGS}</LocalDebuggerCommandArguments>
+    <DebuggerFlavor>WindowsLocalDebugger</DebuggerFlavor>
+    <LocalDebuggerWorkingDirectory>${MSVCsuc_WORKING_DIR}</LocalDebuggerWorkingDirectory>
+  </PropertyGroup>
+    <PropertyGroup Condition=\"'$(Configuration)|$(Platform)'=='RelWithDebInfo|${PLATEFORM_BITS}'\">
+    <LocalDebuggerCommand>${MSVCsuc_COMMAND}</LocalDebuggerCommand>
+    <LocalDebuggerCommandArguments>${MSVCsuc_ARGS}</LocalDebuggerCommandArguments>
+    <DebuggerFlavor>WindowsLocalDebugger</DebuggerFlavor>
+    <LocalDebuggerWorkingDirectory>${MSVCsuc_WORKING_DIR}</LocalDebuggerWorkingDirectory>
+  </PropertyGroup>
+</Project>"
+			)
+			if(MSVCsuc_VERBOSE)
+				message(STATUS "[MSVCsetUserCommand] Write ${CMAKE_CURRENT_BINARY_DIR}/${targetName}.vcxproj.user file")
+				message(STATUS "   to execute ${MSVCsuc_COMMAND} ${MSVCsuc_ARGS}")
+				message(STATUS "   from derectory ${MSVCsuc_WORKING_DIR}")
+				message(STATUS "   on visual studio run debugger button")
+			endif()
+
+		else()
+			message(WARNING "PLATEFORM_BITS is undefined...")
+		endif()
+
+	else()
+		if(MSVCsuc_VERBOSE)
+			message(WARNING "MSVCsetUserCommand is disable because too old MSVC is used (need MSVC10 2010 or newer)")
+		endif()
+	endif()
+
+endfunction()

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/Modules/FindASSIMP.cmake

@@ -0,0 +1,114 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+## Try to find the ASSIMP library
+## Once done this will define
+##
+##  	ASSIMP_FOUND 		- system has ASSIMP
+##  	ASSIMP_INCLUDE_DIR 	- The ASSIMP include directory
+##  	ASSIMP_LIBRARIES 	- The libraries needed to use ASSIMP
+##  	ASSIMP_CMD 			- the full path of ASSIMP executable
+##	ASSIMP_DYNAMIC_LIB	- the Assimp dynamic lib (available only on windows as .dll file for the moment)
+##
+## Edited for using a bugfixed version of Assimp
+
+if(NOT ASSIMP_DIR)
+    set(ASSIMP_DIR "$ENV{ASSIMP_DIR}" CACHE PATH "ASSIMP root directory")
+	message("NO ASSIMP DIR " ASSIMP_DIR )
+	file(TO_CMAKE_PATH "/data/graphdeco/share/usr/local" ASSIMP_DIR)
+        set(ASSIMP_DIR "/data/graphdeco/share/usr/local" )
+	message("SETTING ASSIMP DIR " ASSIMP_DIR )
+endif()
+if(ASSIMP_DIR)
+	file(TO_CMAKE_PATH ${ASSIMP_DIR} ASSIMP_DIR)
+	file(TO_CMAKE_PATH "/data/graphdeco/share/usr/local" ASSIMP_DIR)
+	message("ASSIMP DIR " ASSIMP_DIR )
+endif()
+
+
+## set the LIB POSTFIX to find in a right directory according to what kind of compiler we use (32/64bits)
+if(CMAKE_SIZEOF_VOID_P EQUAL 8)
+	set(ASSIMP_SEARCH_LIB "lib64")
+	set(ASSIMP_SEARCH_BIN "bin64")
+	set(ASSIMP_SEARCH_LIB_PATHSUFFIXE "x64")
+else()
+	set(ASSIMP_SEARCH_LIB "lib32")
+	set(ASSIMP_SEARCH_BIN "bin32")
+	set(ASSIMP_SEARCH_LIB_PATHSUFFIXE "x86")
+endif()
+
+set(PROGRAMFILESx86 "PROGRAMFILES(x86)")
+
+
+FIND_PATH(ASSIMP_INCLUDE_DIR
+	NAMES assimp/config.h
+	PATHS
+		${ASSIMP_DIR}
+		## linux
+		/usr
+		/usr/include
+		/usr/local
+		/opt/local
+		## windows
+		"$ENV{PROGRAMFILES}/Assimp"
+		"$ENV{${PROGRAMFILESx86}}/Assimp"
+		"$ENV{ProgramW6432}/Assimp"
+	PATH_SUFFIXES include
+)
+
+
+FIND_LIBRARY(ASSIMP_LIBRARY
+	NAMES assimp-vc140-mt assimp
+	PATHS
+		${ASSIMP_DIR}/${ASSIMP_SEARCH_LIB}
+		${ASSIMP_DIR}/lib
+		${ASSIMP_DIR}/lib64
+		## linux
+		/usr/${ASSIMP_SEARCH_LIB}
+		/usr/local/${ASSIMP_SEARCH_LIB}
+		/opt/local/${ASSIMP_SEARCH_LIB}
+		/usr/lib
+		/usr/lib64
+		/usr/local/lib
+		/opt/local/lib
+		## windows
+		"$ENV{PROGRAMFILES}/Assimp/${ASSIMP_SEARCH_LIB}"
+		"$ENV{${PROGRAMFILESx86}}/Assimp/${ASSIMP_SEARCH_LIB}"
+		"$ENV{ProgramW6432}/Assimp/${ASSIMP_SEARCH_LIB}"
+		"$ENV{PROGRAMFILES}/Assimp/lib"
+		"$ENV{${PROGRAMFILESx86}}/Assimp/lib"
+		"$ENV{ProgramW6432}/Assimp/lib"
+	PATH_SUFFIXES ${ASSIMP_SEARCH_LIB_PATHSUFFIXE}
+)
+set(ASSIMP_LIBRARIES ${ASSIMP_LIBRARY})
+
+
+if(ASSIMP_LIBRARY)
+	get_filename_component(ASSIMP_LIBRARY_DIR ${ASSIMP_LIBRARY} PATH)
+	if(WIN32)
+		file(GLOB ASSIMP_DYNAMIC_LIB "${ASSIMP_LIBRARY_DIR}/assimp*.dll")
+		if(NOT ASSIMP_DYNAMIC_LIB)
+			message("ASSIMP_DYNAMIC_LIB is missing... at ${ASSIMP_LIBRARY_DIR}")
+		endif()
+	endif()
+	set(ASSIMP_DYNAMIC_LIB ${ASSIMP_DYNAMIC_LIB} CACHE PATH "Windows dll location")
+endif()
+
+MARK_AS_ADVANCED(ASSIMP_DYNAMIC_LIB ASSIMP_INCLUDE_DIR ASSIMP_LIBRARIES)
+
+INCLUDE(FindPackageHandleStandardArgs)
+FIND_PACKAGE_HANDLE_STANDARD_ARGS(ASSIMP
+	REQUIRED_VARS ASSIMP_INCLUDE_DIR ASSIMP_LIBRARIES
+	FAIL_MESSAGE "ASSIMP wasn't found correctly. Set ASSIMP_DIR to the root SDK installation directory."
+)
+
+if(NOT ASSIMP_FOUND)
+	set(ASSIMP_DIR "" CACHE STRING "Path to ASSIMP install directory")
+endif()

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/Modules/FindEGL.cmake

@@ -0,0 +1,161 @@
+#.rst:
+# FindEGL
+# -------
+#
+# Try to find EGL.
+#
+# This will define the following variables:
+#
+# ``EGL_FOUND``
+#     True if (the requested version of) EGL is available
+# ``EGL_VERSION``
+#     The version of EGL; note that this is the API version defined in the
+#     headers, rather than the version of the implementation (eg: Mesa)
+# ``EGL_LIBRARIES``
+#     This can be passed to target_link_libraries() instead of the ``EGL::EGL``
+#     target
+# ``EGL_INCLUDE_DIRS``
+#     This should be passed to target_include_directories() if the target is not
+#     used for linking
+# ``EGL_DEFINITIONS``
+#     This should be passed to target_compile_options() if the target is not
+#     used for linking
+#
+# If ``EGL_FOUND`` is TRUE, it will also define the following imported target:
+#
+# ``EGL::EGL``
+#     The EGL library
+#
+# In general we recommend using the imported target, as it is easier to use.
+# Bear in mind, however, that if the target is in the link interface of an
+# exported library, it must be made available by the package config file.
+#
+# Since pre-1.0.0.
+
+#=============================================================================
+# Copyright 2014 Alex Merry <[email protected]>
+# Copyright 2014 Martin Gräßlin <[email protected]>
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+#
+# 1. Redistributions of source code must retain the copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+# 3. The name of the author may not be used to endorse or promote products
+#    derived from this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#=============================================================================
+
+include(CheckCXXSourceCompiles)
+include(CMakePushCheckState)
+
+# Use pkg-config to get the directories and then use these values
+# in the FIND_PATH() and FIND_LIBRARY() calls
+find_package(PkgConfig)
+pkg_check_modules(PKG_EGL QUIET egl)
+
+set(EGL_DEFINITIONS ${PKG_EGL_CFLAGS_OTHER})
+
+find_path(EGL_INCLUDE_DIR
+    NAMES
+        EGL/egl.h
+    HINTS
+        ${PKG_EGL_INCLUDE_DIRS}
+)
+find_library(EGL_LIBRARY
+    NAMES
+        EGL
+    HINTS
+        ${PKG_EGL_LIBRARY_DIRS}
+)
+
+# NB: We do *not* use the version information from pkg-config, as that
+#     is the implementation version (eg: the Mesa version)
+if(EGL_INCLUDE_DIR)
+    # egl.h has defines of the form EGL_VERSION_x_y for each supported
+    # version; so the header for EGL 1.1 will define EGL_VERSION_1_0 and
+    # EGL_VERSION_1_1.  Finding the highest supported version involves
+    # finding all these defines and selecting the highest numbered.
+    file(READ "${EGL_INCLUDE_DIR}/EGL/egl.h" _EGL_header_contents)
+    string(REGEX MATCHALL
+        "[ \t]EGL_VERSION_[0-9_]+"
+        _EGL_version_lines
+        "${_EGL_header_contents}"
+    )
+    unset(_EGL_header_contents)
+    foreach(_EGL_version_line ${_EGL_version_lines})
+        string(REGEX REPLACE
+            "[ \t]EGL_VERSION_([0-9_]+)"
+            "\\1"
+            _version_candidate
+            "${_EGL_version_line}"
+        )
+        string(REPLACE "_" "." _version_candidate "${_version_candidate}")
+        if(NOT DEFINED EGL_VERSION OR EGL_VERSION VERSION_LESS _version_candidate)
+            set(EGL_VERSION "${_version_candidate}")
+        endif()
+    endforeach()
+    unset(_EGL_version_lines)
+endif()
+
+cmake_push_check_state(RESET)
+list(APPEND CMAKE_REQUIRED_LIBRARIES "${EGL_LIBRARY}")
+list(APPEND CMAKE_REQUIRED_INCLUDES "${EGL_INCLUDE_DIR}")
+
+check_cxx_source_compiles("
+#include <EGL/egl.h>
+
+int main(int argc, char *argv[]) {
+    EGLint x = 0; EGLDisplay dpy = 0; EGLContext ctx = 0;
+    eglDestroyContext(dpy, ctx);
+}" HAVE_EGL)
+
+cmake_pop_check_state()
+
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(EGL
+    FOUND_VAR
+        EGL_FOUND
+    REQUIRED_VARS
+        EGL_LIBRARY
+        EGL_INCLUDE_DIR
+        HAVE_EGL
+    VERSION_VAR
+        EGL_VERSION
+)
+
+if(EGL_FOUND AND NOT TARGET EGL::EGL)
+    add_library(EGL::EGL UNKNOWN IMPORTED)
+    set_target_properties(EGL::EGL PROPERTIES
+        IMPORTED_LOCATION "${EGL_LIBRARY}"
+        INTERFACE_COMPILE_OPTIONS "${EGL_DEFINITIONS}"
+        INTERFACE_INCLUDE_DIRECTORIES "${EGL_INCLUDE_DIR}"
+    )
+endif()
+
+mark_as_advanced(EGL_LIBRARY EGL_INCLUDE_DIR HAVE_EGL)
+
+# compatibility variables
+set(EGL_LIBRARIES ${EGL_LIBRARY})
+set(EGL_INCLUDE_DIRS ${EGL_INCLUDE_DIR})
+set(EGL_VERSION_STRING ${EGL_VERSION})
+
+include(FeatureSummary)
+set_package_properties(EGL PROPERTIES
+    URL "https://www.khronos.org/egl/"
+    DESCRIPTION "A platform-agnostic mechanism for creating rendering surfaces for use with other graphics libraries, such as OpenGL|ES and OpenVG."
+)

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/Modules/FindEmbree.cmake

@@ -0,0 +1,94 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+## Important Note:
+## This is not an official Find*cmake. It has been written for searching through
+## a custom path (EMBREE_DIR) before checking elsewhere.
+##
+## FindEMBREE.cmake
+## Find EMBREE's includes and library
+##
+## This module defines :
+## 	[in] 	EMBREE_DIR, The base directory to search for EMBREE (as cmake var or env var)
+## 	[out] 	EMBREE_INCLUDE_DIR where to find EMBREE.h
+## 	[out] 	EMBREE_LIBRARIES, EMBREE_LIBRARY, libraries to link against to use EMBREE
+## 	[out] 	EMBREE_FOUND, If false, do not try to use EMBREE.
+##
+
+
+if(NOT EMBREE_DIR)
+    set(EMBREE_DIR "$ENV{EMBREE_DIR}" CACHE PATH "EMBREE root directory")
+endif()
+if(EMBREE_DIR)
+	file(TO_CMAKE_PATH ${EMBREE_DIR} EMBREE_DIR)
+endif()
+
+
+## set the LIB POSTFIX to find in a right directory according to what kind of compiler we use (32/64bits)
+if(CMAKE_SIZEOF_VOID_P EQUAL 8)
+	set(EMBREE_SEARCH_LIB "lib64")
+	set(EMBREE_SEARCH_BIN "bin64")
+	set(EMBREE_SEARCH_LIB_PATHSUFFIXE "x64")
+else()
+	set(EMBREE_SEARCH_LIB "lib32")
+	set(EMBREE_SEARCH_BIN "bin32")
+	set(EMBREE_SEARCH_LIB_PATHSUFFIXE "x86")
+endif()
+
+set(PROGRAMFILESx86 "PROGRAMFILES(x86)")
+
+FIND_PATH(EMBREE_INCLUDE_DIR
+	NAMES embree3/rtcore_geometry.h
+	PATHS
+		${EMBREE_DIR}
+		## linux
+		/usr
+		/usr/local
+		/opt/local
+		## windows
+		"$ENV{PROGRAMFILES}/EMBREE"
+		"$ENV{${PROGRAMFILESx86}}/EMBREE"
+		"$ENV{ProgramW6432}/EMBREE"
+	PATH_SUFFIXES include
+)
+
+FIND_LIBRARY(EMBREE_LIBRARY
+	NAMES embree3
+	PATHS
+		${EMBREE_DIR}/${EMBREE_SEARCH_LIB}
+		${EMBREE_DIR}/lib
+		## linux
+		/usr/${EMBREE_SEARCH_LIB}
+		/usr/local/${EMBREE_SEARCH_LIB}
+		/opt/local/${EMBREE_SEARCH_LIB}
+		/usr/lib
+		/usr/local/lib
+		/opt/local/lib
+		## windows
+		"$ENV{PROGRAMFILES}/EMBREE/${EMBREE_SEARCH_LIB}"
+		"$ENV{${PROGRAMFILESx86}}/EMBREE/${EMBREE_SEARCH_LIB}"
+		"$ENV{ProgramW6432}/EMBREE/${EMBREE_SEARCH_LIB}"
+		"$ENV{PROGRAMFILES}/EMBREE/lib"
+		"$ENV{${PROGRAMFILESx86}}/EMBREE/lib"
+		"$ENV{ProgramW6432}/EMBREE/lib"
+	PATH_SUFFIXES ${EMBREE_SEARCH_LIB_PATHSUFFIXE}
+)
+set(EMBREE_LIBRARIES ${EMBREE_LIBRARY})
+
+MARK_AS_ADVANCED(EMBREE_INCLUDE_DIR EMBREE_LIBRARIES)
+
+INCLUDE(FindPackageHandleStandardArgs)
+FIND_PACKAGE_HANDLE_STANDARD_ARGS(EMBREE
+	REQUIRED_VARS EMBREE_INCLUDE_DIR EMBREE_LIBRARIES
+	FAIL_MESSAGE "EMBREE wasn't found correctly. Set EMBREE_DIR to the root SDK installation directory."
+)
+
+if(NOT EMBREE_FOUND)
+	set(EMBREE_DIR "" CACHE STRING "Path to EMBREE install directory")
+endif()

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/Modules/FindFFMPEG.cmake

@@ -0,0 +1,110 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+## Try to find the FFMPEG library
+## Once done this will define
+##
+##  	FFMPEG_FOUND 		- system has FFmpeg
+##  	FFMPEG_INCLUDE_DIR 	- The FFmpeg include directory
+##  	FFMPEG_LIBRARIES 	- The libraries needed to use FFmpeg
+##		FFMPEG_DYNAMIC_LIBS	- DLLs for windows
+
+
+if(NOT FFMPEG_DIR)
+    set(FFMPEG_DIR "$ENV{FFMPEG_DIR}" CACHE PATH "FFMPEG_DIR root directory")
+endif()
+
+if(FFMPEG_DIR)
+	file(TO_CMAKE_PATH ${FFMPEG_DIR} FFMPEG_DIR)
+endif()
+
+MACRO(FFMPEG_FIND varname shortname headername)
+	
+	# Path to include dirs
+	FIND_PATH(FFMPEG_${varname}_INCLUDE_DIRS 
+		NAMES "lib${shortname}/${headername}" 
+		PATHS
+			"${FFMPEG_DIR}/include" # modify this to adapt according to OS/compiler	
+			"/usr/include"
+			"/usr/include/ffmpeg"		
+	)
+		
+	#Add libraries
+	IF(${FFMPEG_${varname}_INCLUDE_DIRS} STREQUAL "FFMPEG_${varname}_INCLUDE_DIR-NOTFOUND")
+		MESSAGE(STATUS "Can't find includes for ${shortname}...")
+	ELSE()
+		FIND_LIBRARY(FFMPEG_${varname}_LIBRARIES
+			NAMES ${shortname}
+			PATHS
+				${FFMPEG_DIR}/lib
+				"/usr/lib"
+				"/usr/lib64"
+				"/usr/local/lib"
+				"/usr/local/lib64"
+		)
+
+		# set libraries and other variables
+		SET(FFMPEG_${varname}_FOUND 1)
+		SET(FFMPEG_${varname}_INCLUDE_DIRS ${FFMPEG_${varname}_INCLUDE_DIR})
+		SET(FFMPEG_${varname}_LIBS ${FFMPEG_${varname}_LIBRARIES})
+	ENDIF()
+ ENDMACRO(FFMPEG_FIND)
+
+#Calls to ffmpeg_find to get  librarires ------------------------------
+FFMPEG_FIND(LIBAVFORMAT avformat avformat.h)
+FFMPEG_FIND(LIBAVDEVICE avdevice avdevice.h)
+FFMPEG_FIND(LIBAVCODEC  avcodec  avcodec.h)
+FFMPEG_FIND(LIBAVUTIL   avutil   avutil.h)
+FFMPEG_FIND(LIBSWSCALE  swscale  swscale.h)
+ 
+# check if libs are found and set FFMPEG related variables
+#SET(FFMPEG_FOUND "NO")
+IF(FFMPEG_LIBAVFORMAT_FOUND 
+	AND FFMPEG_LIBAVDEVICE_FOUND 
+	AND FFMPEG_LIBAVCODEC_FOUND 
+	AND FFMPEG_LIBAVUTIL_FOUND 
+	AND FFMPEG_LIBSWSCALE_FOUND)
+ 
+	# All ffmpeg libs are here
+    SET(FFMPEG_FOUND "YES")
+	SET(FFMPEG_INCLUDE_DIR ${FFMPEG_LIBAVFORMAT_INCLUDE_DIRS})
+	SET(FFMPEG_LIBRARY_DIRS ${FFMPEG_LIBAVFORMAT_LIBRARY_DIRS})
+	SET(FFMPEG_LIBRARIES
+        ${FFMPEG_LIBAVFORMAT_LIBS}
+        ${FFMPEG_LIBAVDEVICE_LIBS}
+        ${FFMPEG_LIBAVCODEC_LIBS}
+        ${FFMPEG_LIBAVUTIL_LIBS}
+		${FFMPEG_LIBSWSCALE_LIBS}	)
+		
+	# add dynamic libraries
+	if(WIN32)
+		file(GLOB FFMPEG_DYNAMIC_LIBS "${FFMPEG_DIR}/bin/*.dll")
+		if(NOT FFMPEG_DYNAMIC_LIBS)
+			message("FFMPEG_DYNAMIC_LIBS is missing...")
+	endif()
+	set(FFMPEG_DYNAMIC_LIBS ${FFMPEG_DYNAMIC_LIBS} CACHE PATH "Windows dll location")
+endif()
+	
+	mark_as_advanced(FFMPEG_INCLUDE_DIR FFMPEG_LIBRARY_DIRS FFMPEG_LIBRARIES FFMPEG_DYNAMIC_LIBS)
+ELSE ()
+    MESSAGE(STATUS "Could not find FFMPEG")
+ENDIF()
+ 
+ 
+INCLUDE(FindPackageHandleStandardArgs)
+FIND_PACKAGE_HANDLE_STANDARD_ARGS(FFMPEG
+	REQUIRED_VARS FFMPEG_INCLUDE_DIR FFMPEG_LIBRARIES
+	FAIL_MESSAGE "FFmpeg wasn't found correctly. Set FFMPEG_DIR to the root SDK installation directory."
+)
+
+if(NOT FFMPEG_FOUND)
+	set(FFMPEG_DIR "" CACHE STRING "Path to FFmpeg install directory")
+endif()
+  

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/Modules/FindGLFW.cmake

@@ -0,0 +1,109 @@
+##=============================================================================
+##
+##  Copyright (c) Kitware, Inc.
+##  All rights reserved.
+##  See LICENSE.txt for details.
+##
+##  This software is distributed WITHOUT ANY WARRANTY; without even
+##  the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
+##  PURPOSE.  See the above copyright notice for more information.
+##
+##  Copyright 2016 Sandia Corporation.
+##  Copyright 2016 UT-Battelle, LLC.
+##  Copyright 2016 Los Alamos National Security.
+##
+##  Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation,
+##  the U.S. Government retains certain rights in this software.
+##  Under the terms of Contract DE-AC52-06NA25396 with Los Alamos National
+##  Laboratory (LANL), the U.S. Government retains certain rights in
+##  this software.
+##
+##=============================================================================
+# Try to find EGL library and include dir.
+# Once done this will define
+#
+# GLFW_FOUND
+# GLFW_INCLUDE_DIR
+# GLFW_LIBRARY
+#
+
+include(FindPackageHandleStandardArgs)
+
+if (WIN32)
+    find_path( GLFW_INCLUDE_DIR
+        NAMES
+            GLFW/glfw3.h
+        PATHS
+            ${PROJECT_SOURCE_DIR}/shared_external/glfw/include
+            ${PROJECT_SOURCE_DIR}/../shared_external/glfw/include
+            ${GLFW_LOCATION}/include
+            $ENV{GLFW_LOCATION}/include
+            $ENV{PROGRAMFILES}/GLFW/include
+            ${GLFW_LOCATION}
+            $ENV{GLFW_LOCATION}
+            DOC "The directory where GLFW/glfw3.h resides" )
+    if(ARCH STREQUAL "x86")
+      find_library( GLFW_LIBRARY
+          NAMES
+              glfw3
+          PATHS
+              ${GLFW_LOCATION}/lib
+              $ENV{GLFW_LOCATION}/lib
+              $ENV{PROGRAMFILES}/GLFW/lib
+              DOC "The GLFW library")
+    else()
+      find_library( GLFW_LIBRARY
+          NAMES
+              glfw3
+          PATHS
+              ${GLFW_LOCATION}/lib
+              $ENV{GLFW_LOCATION}/lib
+              $ENV{PROGRAMFILES}/GLFW/lib
+              DOC "The GLFW library")
+    endif()
+endif ()
+
+if (${CMAKE_HOST_UNIX})
+    message("GFLW LOCATION " $ENV{GLFW_LOCATION} )
+    find_path( GLFW_INCLUDE_DIR
+        NAMES
+            GLFW/glfw3.h
+        PATHS
+#            ${GLFW_LOCATION}/include
+            $ENV{GLFW_LOCATION}/include
+#            /usr/include
+#            /usr/local/include
+#            /sw/include
+#            /opt/local/include
+#            NO_DEFAULT_PATH
+            DOC "The directory where GLFW/glfw3.h resides"
+    )
+    find_library( GLFW_LIBRARY
+        NAMES
+            glfw3 glfw
+        PATHS
+#            ${GLFW_LOCATION}/lib
+            $ENV{GLFW_LOCATION}/lib
+            $ENV{GLFW_LOCATION}/lib64
+#            /usr/lib64
+#            /usr/lib
+#            /usr/local/lib64
+#            /usr/local/lib
+#            /sw/lib
+#            /opt/local/lib
+#            /usr/lib/x86_64-linux-gnu
+#            NO_DEFAULT_PATH
+            DOC "The GLFW library")
+
+    set( GLFW_INCLUDE_DIR $ENV{GLFW_LOCATION}/include )
+    set( GLFW_LIBRARY $ENV{GLFW_LOCATION}/lib64/libglfw3.a )
+    message("*************==========> FindGLFW .cmake " ${GLFW_INCLUDE_DIR} " LIB " ${GLFW_LIBRARY} )
+endif ()
+
+find_package_handle_standard_args(GLFW DEFAULT_MSG
+    GLFW_INCLUDE_DIR
+    GLFW_LIBRARY
+)
+
+mark_as_advanced( GLFW_FOUND )
+

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/Win3rdParty.cmake

@@ -0,0 +1,337 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+## This file should be include and use only on WIN32 OS and once
+## It allow to auto check/download and use a preconfigured 3rdParty binaries for cmake usage
+## It use the downloadAndExtractZipFile cmake module to work.
+##
+if(__Win3rdParty_cmake_INCLUDED__)
+	return()
+else()
+	set(__Win3rdParty_cmake_INCLUDED__ ON)
+endif()
+
+
+##
+## To be sure to reset an empty cached variable but keep any other kind of variables
+##
+## Usage:
+## check_cached_var(<var> <resetedCachedValue> <cacheType> <cacheDoc> [FORCE])
+##
+## <var> is the cached cmake variable you need to reset
+## <resetedCachedValue> is the new default value of the reseted cached cmake variable
+## <cacheType> is the kind of GUI cache input can be : FILEPATH; PATH; STRING or BOOL
+## <cacheDoc> is the associated GUI cache input documentation display in the GUI
+## FORCE option could be use to reset a cached variable even if it is not empty.
+##
+macro(check_cached_var var resetedCachedValue cacheType cacheDoc)
+    # message(STATUS "inside check_cached_var macro. argn=${ARGN}")
+    cmake_parse_arguments(ccv "FORCE" "" "" ${ARGN})
+
+    if(ccv_FORCE)
+        set(FORCE FORCE)
+    else()
+        set(FORCE )
+    endif()
+
+    if(NOT ${var} OR ccv_FORCE)
+        unset(${var} CACHE)
+        # message(STATUS "setting new cache value. var ${var} = ${resetedCachedValue}")
+        set(${var}	"${resetedCachedValue}" CACHE ${cacheType} "${cacheDoc}" ${FORCE})
+    endif()
+endmacro()
+
+
+##
+## Win3rdParty function allow to specify a directory which contain all necessary windows dependenties.
+## By uploading 3rdParty directory (which contain dependencies, *.lib, *.dll... for a specific version of compiler) onto Gforge file tab,
+## you get back an URL of download you can give to this function with a directory name. So you can provide multiple 3rdParty version of same dependencies (MSVC11, MSVC12...).
+## By providing a prefix to this function, you allow to use different kind of 3rdParty which can be handled by CMAKE OPTIONS depending on what your framework need for example.
+##
+## Usage 1:
+##    Win3rdParty(<prefix> MSVC<XX> <DirName> <URL>
+##					[MSVC<XX> <DirName> <URL>] [...]
+##					[VCID] [DEFAULT_USE] [VERBOSE] )
+##
+## * <prefix> allow to identify which 3rdParty you process (prefix name)
+## * MSVC<XX> flag could be MSVC11 or MSVC12 (any element of the MSVC_VERSIONS_LIST) and refer to a 3rdParty compiler with :
+##   * <DirName> which will be the local pathName of the downloaded 3rdParty : relative to CMAKE_BINARY_DIR
+##   * <URL> which is the link location of the 3rdParty zip
+## * VCID flag will make available a cache variable ${prefix}_WIN3RDPARTY_VCID
+## * DEFAULT_USE flag [ON|OFF] may be used to set default value of cmake cached variable : <prefix>_WIN3RDPARTY_USE [default to ON]
+##
+## WARNING:
+## This function define CACHE variables you can use after :
+## * ${prefix}_WIN3RDPARTY_USE : allow to check/downloaded win3rdParty dir (it will force the cached variables for this dependency folder generally <prefix>_DIR>)
+## * ${prefix}_WIN3RDPARTY_DIR : where is your local win3rdParty dir (the PATH)
+## * ${prefix}_WIN3RDPARTY_VCID : [if VCID flag is used] the MSVC id (commonly used to prefix/suffix library name, see boost or CGAL)
+##
+## If you want to add a win3rdParty version, please:
+## 1- build dependencies on your local side with the compiler you want
+## 2- build your own zip with your built dependencies
+## 3- upload it (onto the forge where the project is stored) and copy the link location in order to use it for this function
+## 4- if you just introduced a new MSVC version, add it to the MSVC_VERSIONS_LIST bellow
+##
+## In a second pass, you can also use this function to set necessary cmake cached variables in order to let cmake find packages of these 3rdParty.
+##
+## Usage 2:
+##    win3rdParty(<prefix> [VERBOSE] MULTI_SET|SET
+##          CHECK_CACHED_VAR <cmakeVar> <cmakeCacheType> [LIST] <cmakeValue> [DOC <stringToolTips>]
+##        [ CHECK_CACHED_VAR <cmakeVar> <cmakeCacheType> [LIST] <cmakeValue> [DOC <stringToolTips>] ] [...]
+##
+## * MULTI_SET or SET flags are used to tell cmake that all next arguments will use repeated flags with differents entries (SET mean we will provide only one set of arguments, without repetition)
+## * CHECK_CACHED_VAR are the repeated flag which contain differents entries
+##      * <cmakeVar> is the cmake variable you want to be cached for the project
+##      * <cmakeCacheType> is the kind of cmake variable (couble be: FILEPATH; PATH; STRING or BOOL) => see check_cached_var.
+##      * LIST optional flag could be used with CHECK_CACHED_VAR when <cmakeCacheType> = STRING. It allow to handle multiple STRINGS value list.
+##      * <cmakeValue> is the value of the variable (if FILEPATH, PATH or STRING: use quotes, if BOOL : use ON/OFF)
+##      * DOC optional flag is used to have a tooltips info about this new cmake variable entry into the GUI (use quotes).
+##
+## Full example 1 :
+##    win3rdParty(COMMON MSVC11 "win3rdParty-MSVC11" "https://path.to/an.archive.7z"
+##                SET CHECK_CACHED_VAR SuiteSparse_DIR PATH "SuiteSparse-4.2.1" DOC "default empty doc"
+##    )
+##
+## WARNING:
+## For the 2nd usage (with MULTI_SET), if you planned to set some CACHED_VAR using/composed by ${prefix}_WIN3RDPARTY_* just set in this macro (usage 1),
+## then (due to the not yet existing var) you will need to call this function 2 times :
+## One for the 1st usage (downloading of the current compiler 3rdParty).
+## One for the MLUTI_SET flag which will use existsing ${prefix}_WIN3RDPARTY_* cached var.
+##
+## Full example 2 :
+##    win3rdParty(COMMON MSVC11    "win3rdParty-MSVC11" "https://path.to/an.archive.7z")
+##    win3rdParty(COMMON MULTI_SET
+##       CHECK_CACHED_VAR CGAL_INCLUDE_DIR  PATH "CGAL-4.3/include" DOC "default empty doc"
+##       CHECK_CACHED_VAR CGAL_LIBRARIES	STRING LIST "debug;CGAL-4.3/lib${LIB_POSTFIX}/CGAL-${WIN3RDPARTY_COMMON_VCID}-mt-gd-4.3.lib;optimized;CGAL-4.3/lib${LIB_POSTFIX}/CGAL-${WIN3RDPARTY_COMMON_VCID}-mt-4.3.lib"
+##
+##
+## WARNING: This function use internaly :
+## * downloadAndExtractZipFile.cmake
+## * parse_arguments_multi.cmake
+## * check_cached_var macro
+##
+function(win3rdParty prefix )
+
+    # ARGV: list of all arguments given to the macro/function
+    # ARGN: list of remaining arguments
+
+    if(NOT WIN32)
+        return()
+    endif()
+
+    ## set the handled version of MSVC
+    ## if you plan to add a win3rdParty dir to download with a new MSVC version: build the win3rdParty dir and add the MSCV entry here.
+    set(MSVC_VERSIONS_LIST "MSVC17;MSVC11;MSVC12;MSVC14")
+
+    #include(CMakeParseArguments)   # CMakeParseArguments is obsolete since cmake 3.5
+    # cmake_parse_arguments (<prefix> <options> <one_value_keywords> <multi_value_keywords> args)
+    # <options> : options (flags) pass to the macro
+    # <one_value_keywords> : options that neeed a value
+    # <multi_value_keywords> : options that neeed more than one value
+    cmake_parse_arguments(w3p "VCID" "VERBOSE;TIMEOUT;DEFAULT_USE" "${MSVC_VERSIONS_LIST};MULTI_SET;SET" ${ARGN})
+
+    # message(STATUS "value of w3p_VCID = ${w3p_VCID}")
+    # message(STATUS "value of w3p_VERBOSE = ${w3p_VERBOSE}")
+    # message(STATUS "value of w3p_TIMEOUT = ${w3p_TIMEOUT}")
+    # message(STATUS "value of w3p_DEFAULT_USE = ${w3p_DEFAULT_USE}")
+
+    # foreach (loop_var ${MSVC_VERSIONS_LIST})
+            # message(STATUS "value of w3p_${loop_var} = ${w3p_${loop_var}}")
+    # endforeach(loop_var)
+
+    # message(STATUS "value of w3p_MULTI_SET = ${w3p_MULTI_SET}")
+    # message(STATUS "value of w3p_SET = ${w3p_SET}")
+
+    # message("values for MSVC = ${w3p_MSVC14}")
+
+    if(NOT w3p_TIMEOUT)
+        set(w3p_TIMEOUT 300)
+    endif()
+
+    if(NOT DEFINED w3p_DEFAULT_USE)
+        set(w3p_DEFAULT_USE ON)
+    endif()
+	
+
+    ## 1st use (check/update|download) :
+    set(${prefix}_WIN3RDPARTY_USE ${w3p_DEFAULT_USE} CACHE BOOL "Use required 3rdParty binaries from ${prefix}_WIN3RDPARTY_DIR or download it if not exist")
+
+
+    ## We want to test if each version of MSVC was filled by the function (see associated parameters)
+    ## As CMake is running only for one version of MSVC, if that MSVC version was filled, we get back associated parameters,
+    ## otherwise we can't use the downloadAndExtractZipFile with win3rdParty.
+    set(enableWin3rdParty OFF)
+	
+	foreach(MSVC_VER ${MSVC_VERSIONS_LIST})
+		if(${MSVC_VER} AND w3p_${MSVC_VER} OR ${MSVC_TOOLSET_VERSION} EQUAL 143 AND ${MSVC_VER} STREQUAL "MSVC17") 
+			list(LENGTH w3p_${MSVC_VER} count)
+			if("${count}" LESS "2")
+				#message(WARNING "You are using ${MSVC_VER} with ${prefix}_WIN3RDPARTY_USE=${${prefix}_WIN3RDPARTY_USE}, but win3rdParty function isn't filled for ${MSVC_VER}!")
+			else()
+				list(GET w3p_${MSVC_VER} 0 Win3rdPartyName)
+				list(GET w3p_${MSVC_VER} 1 Win3rdPartyUrl)
+				if(w3p_VCID)
+					## try to get the VcId of MSVC. See also MSVC_VERSION cmake var in the doc.
+					string(REGEX REPLACE "MS([A-Za-z_0-9-]+)" "\\1" vcId ${MSVC_VER})
+					string(TOLOWER ${vcId} vcId)
+					set(${prefix}_WIN3RDPARTY_VCID "${vcId}0" CACHE STRING "the MSVC id (commonly used to prefix/suffix library name, see boost or CGAL)")
+					mark_as_advanced(${prefix}_WIN3RDPARTY_VCID)
+				endif()
+				set(enableWin3rdParty ON)
+				set(suffixCompilerID ${MSVC_VER})
+				break()
+			endif()
+		endif()
+	endforeach()
+    ## If previous step succeed to get MSVC dirname and URL of the current MSVC version, use it to auto download/update the win3rdParty dir
+    if(enableWin3rdParty AND ${prefix}_WIN3RDPARTY_USE)
+
+        if(IS_ABSOLUTE "${Win3rdPartyName}")
+        else()
+            set(Win3rdPartyName "${CMAKE_BINARY_DIR}/${Win3rdPartyName}")
+        endif()
+
+        if(NOT EXISTS "${Win3rdPartyName}")
+            file(MAKE_DIRECTORY ${Win3rdPartyName})
+        endif()
+
+        include(downloadAndExtractZipFile)
+        downloadAndExtractZipFile(  "${Win3rdPartyUrl}"                             ## URL link location
+                                    "Win3rdParty-${prefix}-${suffixCompilerID}.7z"  ## where download it: relative path, so default to CMAKE_BINARY_DIR
+                                    "${Win3rdPartyName}"                            ## where extract it : fullPath (default relative to CMAKE_BINARY_DIR)
+            CHECK_DIRTY_URL "${Win3rdPartyName}/Win3rdPartyUrl"                     ## last downloaded url file : fullPath (default relative to CMAKE_BINARY_DIR)
+            TIMEOUT ${w3p_TIMEOUT}
+            VERBOSE ${w3p_VERBOSE}
+        )
+        file(GLOB checkDl "${Win3rdPartyName}/*")
+        list(LENGTH checkDl checkDlCount)
+        if("${checkDlCount}" GREATER "1")
+        else()
+            message("The downloadAndExtractZipFile didn't work...?")
+            set(enableWin3rdParty OFF)
+        endif()
+    endif()
+
+    ## Try to auto set ${prefix}_WIN3RDPARTY_DIR or let user set it manually
+    set(${prefix}_WIN3RDPARTY_DIR "" CACHE PATH "windows ${Win3rdPartyName} dir to ${prefix} dependencies of the project")
+
+    if(NOT ${prefix}_WIN3RDPARTY_DIR AND ${prefix}_WIN3RDPARTY_USE)
+        if(EXISTS "${Win3rdPartyName}")
+            unset(${prefix}_WIN3RDPARTY_DIR CACHE)
+            set(${prefix}_WIN3RDPARTY_DIR "${Win3rdPartyName}" CACHE PATH "dir to ${prefix} dependencies of the project")
+        endif()
+    endif()
+
+    if(EXISTS ${${prefix}_WIN3RDPARTY_DIR})
+        message(STATUS "Found a 3rdParty ${prefix} dir : ${${prefix}_WIN3RDPARTY_DIR}.")
+        set(enableWin3rdParty ON)
+    elseif(${prefix}_WIN3RDPARTY_USE)
+        message(WARNING "${prefix}_WIN3RDPARTY_USE=${${prefix}_WIN3RDPARTY_USE} but ${prefix}_WIN3RDPARTY_DIR=${${prefix}_WIN3RDPARTY_DIR}.")
+        set(enableWin3rdParty OFF)
+    endif()
+
+    ## Final check
+    if(NOT enableWin3rdParty)
+        message("Disable ${prefix}_WIN3RDPARTY_USE (cmake cached var will be not set), due to a win3rdParty problem.")
+        message("You still can set ${prefix}_WIN3RDPARTY_DIR to an already downloaded Win3rdParty directory location.")
+        set(${prefix}_WIN3RDPARTY_USE OFF CACHE BOOL "Use required 3rdParty binaries from ${prefix}_WIN3RDPARTY_DIR or download it if not exist" FORCE)
+    endif()
+
+    ## 2nd use : handle multi values args to set cached cmake variables in order to ease the next find_package call
+    if(${prefix}_WIN3RDPARTY_USE AND ${prefix}_WIN3RDPARTY_DIR)
+        if(w3p_VERBOSE)
+            message(STATUS "Try to set cmake cached variables for ${prefix} required libraries directly from : ${${prefix}_WIN3RDPARTY_DIR}.")
+        endif()
+
+        include(parse_arguments_multi)
+        # message (STATUS "before defining an override of parse_arguments_multi_function")
+        function(parse_arguments_multi_function ) ## overloaded function to handle all CHECK_CACHED_VAR values list (see: parse_arguments_multi)
+            # message(STATUS "inside overloaded parse_arguments_multi_function defined in Win3rdParty.cmake")
+            # message(STATUS ${ARGN})
+            ## we know the function take 3 args : var cacheType resetedCachedValue (see check_cached_var)
+            cmake_parse_arguments(pamf "" "DOC" "LIST" ${ARGN})
+
+            ## var and cacheType are mandatory (with the resetedCachedValue)
+            set(var         ${ARGV0})
+            set(cacheType   ${ARGV1})
+            # message(STATUS "var=${var} and cacheType=${cacheType} list=${pamf_LIST}")
+            if(pamf_DOC)
+                set(cacheDoc    ${pamf_DOC})
+            else()
+                set(cacheDoc    "")
+            endif()
+            if(pamf_LIST)
+                set(value ${pamf_LIST})
+            else()
+                # message("USING ARGV2 with value ${ARGV2}")
+                set(value ${ARGV2})
+            endif()
+            # message("inside override function in Win3rdparty.cmake value+ ${value}")
+            if("${cacheType}" MATCHES "PATH" AND EXISTS "${${prefix}_WIN3RDPARTY_DIR}/${value}")
+                # message("math with path")
+                set(resetedCachedValue "${${prefix}_WIN3RDPARTY_DIR}/${value}") ## path relative to ${prefix}_WIN3RDPARTY_DIR
+            elseif ("${cacheType}" MATCHES "PATH" AND EXISTS "${${prefix}_WIN3RDPARTY_DIR}")
+                set(resetedCachedValue "${${prefix}_WIN3RDPARTY_DIR}") ## path relative to ${prefix}_WIN3RDPARTY_DIR
+            elseif("${cacheType}" MATCHES "STRING")
+                foreach(var IN LISTS value)
+                    if(EXISTS "${${prefix}_WIN3RDPARTY_DIR}/${var}")
+                        list(APPEND resetedCachedValue "${${prefix}_WIN3RDPARTY_DIR}/${var}") ## string item of the string list is a path => make relative to ${prefix}_WIN3RDPARTY_DIR
+                    else()
+                        list(APPEND resetedCachedValue ${var}) ## string item of the string list is not an existing path => simply use the item
+                    endif()
+                endforeach()
+            else()
+                set(resetedCachedValue "${value}") ## could be a BOOL or a STRING
+            endif()
+
+            ## call our macro to reset cmake cache variable if empty
+            check_cached_var(${var} "${resetedCachedValue}" ${cacheType} "${cacheDoc}" FORCE)
+
+        endfunction()
+        # message (STATUS "after defining an override of parse_arguments_multi_function")
+
+        if(w3p_MULTI_SET)
+            parse_arguments_multi(CHECK_CACHED_VAR w3p_MULTI_SET ${w3p_MULTI_SET}) ## internaly will call our overloaded parse_arguments_multi_function
+        elseif(w3p_SET)
+            # message("calling set version of parse_arguments_multi with w3p_set = ${w3p_SET}")
+            parse_arguments_multi(CHECK_CACHED_VAR w3p_SET ${w3p_SET})
+        endif()
+
+    endif()
+
+endfunction()
+
+## cmake variables introspection to globally activate/deactivate ${prefix}_WIN3RDPARTY_USE
+## This "one shot" call (only one for the next cmake configure) will automatically then reset the global variable WIN3RDPARTY_USE to UserDefined (do nothing).
+## use (call it) before and after the call of all your win3rdParty functions
+function(Win3rdPartyGlobalCacheAction )
+	set(WIN3RDPARTY_USE "UserDefined" CACHE STRING "Choose how to handle all cmake cached *_WIN3RDPARTY_USE for the next configure.\nCould be:\nUserDefined [default]\nActivateAll\nDesactivateAll" )
+	set_property(CACHE WIN3RDPARTY_USE PROPERTY STRINGS "UserDefined;ActivateAll;DesactivateAll" )
+	if(${WIN3RDPARTY_USE} MATCHES "UserDefined")
+	else()
+		if(${WIN3RDPARTY_USE} MATCHES "ActivateAll")
+			set(win3rdPvalue ON)
+		elseif(${WIN3RDPARTY_USE} MATCHES "DesactivateAll")
+			set(win3rdPvalue OFF)
+		endif()
+		get_cmake_property(_variableNames CACHE_VARIABLES)
+		foreach (_variableName ${_variableNames})
+			string(REGEX MATCH 	"[A-Za-z_0-9-]+_WIN3RDPARTY_USE" win3rdpartyUseCacheVar ${_variableName})
+			if(win3rdpartyUseCacheVar)
+				string(REGEX REPLACE "([A-Za-z_0-9-]+_WIN3RDPARTY_USE)" "\\1" win3rdpartyUseCacheVar ${_variableName})
+				set(${win3rdpartyUseCacheVar} ${win3rdPvalue} CACHE BOOL "Use required 3rdParty binaries from ${prefix}_WIN3RDPARTY_DIR or download it if not exist" FORCE)
+				message(STATUS "${win3rdpartyUseCacheVar} cached variable set to ${win3rdPvalue}.")
+			endif()
+		endforeach()
+		set(WIN3RDPARTY_USE "UserDefined" CACHE STRING "Choose how to handle all cmake cached *_WIN3RDPARTY_USE for the next configure.\nCould be:\nUserDefined [default]\nActivateAll\nDesactivateAll" FORCE)
+		message(STATUS "reset WIN3RDPARTY_USE to UserDefined.")
+	endif()
+	mark_as_advanced(WIN3RDPARTY_USE)
+endfunction()

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/cmake_policies.cmake

@@ -0,0 +1,19 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+if(__set_policies_INCLUDED__)
+	return()
+else()
+	set(__set_policies_INCLUDED__ ON)
+endif()
+
+macro(setPolicies)
+	# No more policies to enforce
+endmacro()

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/dependencies.cmake

@@ -0,0 +1,324 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+## Included once for all sub project.
+## It contain the whole cmake instructions to find necessary common dependencies.
+## 3rdParty (provided by sibr_addlibrary win3rdParty or from external packages) are then available in cmake sub projects.
+##
+## Do not include this file more than once but you can modify it to fit to your own project.
+## So please, read it carefully because you can use on of these dependencies for your project or appen new one.
+##
+## As it is included after camke options, you can use conditional if(<CMAKE_PROJ_OPT>)/endif() to encapsulate your 3rdParty.
+##
+
+## win3rdParty function allowing to auto check/download/update binaries dependencies for current windows compiler
+## Please open this file in order to get more documentation and usage examples.
+include(Win3rdParty)
+
+include(sibr_library)
+
+Win3rdPartyGlobalCacheAction()
+
+find_package(OpenGL REQUIRED)
+
+set(OpenGL_GL_PREFERENCE "GLVND")
+
+############
+## Find GLEW
+############
+##for headless rendering
+find_package(EGL QUIET)
+
+if(EGL_FOUND)
+    add_definitions(-DGLEW_EGL)
+    message("Activating EGL support for headless GLFW/GLEW")
+else()
+    message("EGL not found : EGL support for headless GLFW/GLEW is disabled")
+endif()
+
+if (MSVC11 OR MSVC12)
+    set(glew_multiset_arguments 
+            CHECK_CACHED_VAR GLEW_INCLUDE_DIR	    PATH "glew-1.10.0/include" DOC "default empty doc"
+            CHECK_CACHED_VAR GLEW_LIBRARIES         STRING LIST "debug;glew-1.10.0/${LIB_BUILT_DIR}/glew32d.lib;optimized;glew-1.10.0/${LIB_BUILT_DIR}/glew32.lib" DOC "default empty doc"
+        )
+elseif (MSVC14)
+    set(glew_multiset_arguments 
+            CHECK_CACHED_VAR GLEW_INCLUDE_DIR	    PATH "glew-2.0.0/include" DOC "default empty doc"
+            CHECK_CACHED_VAR GLEW_SHARED_LIBRARY_RELEASE       PATH "glew-2.0.0/${LIB_BUILT_DIR}/glew32.lib"
+            CHECK_CACHED_VAR GLEW_STATIC_LIBRARY_RELEASE       PATH "glew-2.0.0/${LIB_BUILT_DIR}/glew32s.lib"
+            CHECK_CACHED_VAR GLEW_SHARED_LIBRARY_DEBUG         PATH "glew-2.0.0/${LIB_BUILT_DIR}/glew32d.lib"
+            CHECK_CACHED_VAR GLEW_STATIC_LIBRARY_DEBUG         PATH "glew-2.0.0/${LIB_BUILT_DIR}/glew32sd.lib"
+        )
+else ()
+    message("There is no provided GLEW library for your compiler, relying on find_package to find it")
+endif()
+sibr_addlibrary(NAME GLEW #VERBOSE ON
+    MSVC11 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC11-splitted%20version/glew-1.10.0.7z"
+    MSVC12 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC11-splitted%20version/glew-1.10.0.7z"
+    MSVC14 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC15-splitted%20version/glew-2.0.0.7z"        # using recompiled version of glew
+    MULTI_SET ${glew_multiset_arguments}
+)
+set(GLEW_VERBOSE ON)
+FIND_PACKAGE(GLEW REQUIRED)
+IF(GLEW_FOUND)
+    INCLUDE_DIRECTORIES(${GLEW_INCLUDE_DIR})
+ELSE(GLEW_FOUND)
+    MESSAGE("GLEW not found. Set GLEW_DIR to base directory of GLEW.")
+ENDIF(GLEW_FOUND)
+
+
+##############
+## Find ASSIMP
+##############
+if (MSVC11 OR MSVC12)
+    set(assimp_set_arguments 
+        CHECK_CACHED_VAR ASSIMP_DIR PATH "Assimp_3.1_fix"
+    )
+elseif (MSVC14)
+    set(assimp_set_arguments 
+        CHECK_CACHED_VAR ASSIMP_DIR PATH "Assimp-4.1.0"
+    )
+else ()
+    message("There is no provided ASSIMP library for your compiler, relying on find_package to find it")
+endif()
+
+sibr_addlibrary(NAME ASSIMP #VERBOSE ON
+        MSVC11 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC11-splitted%20version/Assimp_3.1_fix.7z"
+        MSVC12 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC11-splitted%20version/Assimp_3.1_fix.7z"
+        MSVC14 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC15-splitted%20version/Assimp-4.1.0.7z"
+        MULTI_SET
+            ${assimp_set_arguments}
+)
+
+find_package(ASSIMP REQUIRED)
+include_directories(${ASSIMP_INCLUDE_DIR})
+
+################
+## Find FFMPEG
+################
+sibr_addlibrary(NAME FFMPEG
+    MSVC11 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC11-splitted%20version/ffmpeg.zip"
+    MSVC12 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC11-splitted%20version/ffmpeg.zip"
+    MSVC14 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC15-splitted%20version/ffmpeg-4.0.2-win64-win3rdParty.7z"
+    SET CHECK_CACHED_VAR FFMPEG_DIR PATH ${FFMPEG_WIN3RDPARTY_DIR}
+)
+find_package(FFMPEG)
+include_directories(${FFMPEG_INCLUDE_DIR})
+## COMMENT OUT ALL FFMPEG FOR CLUSTER
+
+###################
+## Find embree3
+###################
+sibr_addlibrary(
+    NAME embree3
+    MSVC11 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC11-splitted%20version/embree2.7.0.x64.windows.7z"
+    MSVC14 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC15-splitted%20version/embree-3.6.1.x64.vc14.windows.7z"     # TODO SV: provide a valid version if required
+)
+
+# CLUSTER
+#find_package(embree 3.0 REQUIRED PATHS "/data/graphdeco/share/embree/usr/local/lib64/cmake/" )
+find_package(embree 3.0 )
+
+###################
+## Find eigen3
+###################
+sibr_addlibrary(
+	NAME eigen3
+	#MSVC11 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC11-splitted%20version/eigen-eigen-dc6cfdf9bcec.7z"
+	#MSVC14 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC11-splitted%20version/eigen-eigen-dc6cfdf9bcec.7z"    # TODO SV: provide a valid version if required
+    MSVC11 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC15-splitted%20version/eigen3.7z"
+    MSVC14 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC15-splitted%20version/eigen3.7z"
+    SET CHECK_CACHED_VAR eigen3_DIR PATH "eigen/share/eigen3/cmake"
+)
+include_directories(/usr/include/eigen3)
+add_definitions(-DEIGEN_INITIALIZE_MATRICES_BY_ZERO)
+
+#############
+## Find Boost
+#############
+set(Boost_REQUIRED_COMPONENTS "system;chrono;filesystem;date_time" CACHE INTERNAL "Boost Required Components")
+
+if (WIN32)
+    # boost multiset arguments
+    if (MSVC11 OR MSVC12)
+        set(boost_multiset_arguments 
+                CHECK_CACHED_VAR BOOST_ROOT                 PATH "boost_1_55_0"
+                CHECK_CACHED_VAR BOOST_INCLUDEDIR 		    PATH "boost_1_55_0"
+                CHECK_CACHED_VAR BOOST_LIBRARYDIR 		    PATH "boost_1_55_0/${LIB_BUILT_DIR}"
+                #CHECK_CACHED_VAR Boost_COMPILER             STRING "-${Boost_WIN3RDPARTY_VCID}" DOC "vcid (eg: -vc110 for MSVC11)"
+                CHECK_CACHED_VAR Boost_COMPILER             STRING "-vc110" DOC "vcid (eg: -vc110 for MSVC11)" # NOTE: if it doesnt work, uncomment this option and set the right value for VisualC id
+            )
+    elseif (MSVC14)
+        set(boost_multiset_arguments 
+                CHECK_CACHED_VAR BOOST_ROOT                 PATH "boost-1.71"
+                CHECK_CACHED_VAR BOOST_INCLUDEDIR 		    PATH "boost-1.71"
+                CHECK_CACHED_VAR BOOST_LIBRARYDIR 		    PATH "boost-1.71/${LIB_BUILT_DIR}"
+                CHECK_CACHED_VAR Boost_COMPILER             STRING "-vc141" DOC "vcid (eg: -vc110 for MSVC11)" # NOTE: if it doesnt work, uncomment this option and set the right value for VisualC id
+            )
+        
+        option(BOOST_MINIMAL_VERSION "Only get minimal Boost dependencies" ON)
+
+        if(${BOOST_MINIMAL_VERSION})
+            set(BOOST_MSVC14_ZIP "boost-1.71-ibr-minimal.7z")
+        else()
+            set(BOOST_MSVC14_ZIP "boost-1.71.7z")
+        endif()
+    else ()
+        message("There is no provided Boost library for your compiler, relying on find_package to find it")
+    endif()
+
+    sibr_addlibrary(NAME Boost VCID TIMEOUT 600 #VERBOSE ON
+        MSVC11 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC11-splitted%20version/boost_1_55_0.7z"
+        MSVC12 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC11-splitted%20version/boost_1_55_0.7z"
+        MSVC14 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC15-splitted%20version/${BOOST_MSVC14_ZIP}"    # boost compatible with msvc14
+        MULTI_SET ${boost_multiset_arguments}
+            CHECK_CACHED_VAR Boost_NO_SYSTEM_PATHS      BOOL ON DOC "Set to ON to disable searching in locations not specified by these boost cached hint variables"
+            CHECK_CACHED_VAR Boost_NO_BOOST_CMAKE       BOOL ON DOC "Set to ON to disable the search for boost-cmake (package cmake config file if boost was built with cmake)"
+    )
+    if(NOT Boost_COMPILER AND Boost_WIN3RDPARTY_USE)
+        message(WARNING "Boost_COMPILER is not set and it's needed.")
+    endif()
+endif()
+
+find_package(Boost 1.65.0 REQUIRED COMPONENTS ${Boost_REQUIRED_COMPONENTS})
+# for CLUSTER
+##find_package(Boost 1.58.0 REQUIRED COMPONENTS ${Boost_REQUIRED_COMPONENTS})
+
+
+if(WIN32)
+	add_compile_options("$<$<COMPILE_LANGUAGE:CXX>:/EHsc>")
+    #add_definitions(/EHsc)
+endif()
+
+if(Boost_LIB_DIAGNOSTIC_DEFINITIONS)
+    add_definitions(${Boost_LIB_DIAGNOSTIC_DEFINITIONS})
+endif()
+
+#if(WIN32)
+    add_definitions(-DBOOST_ALL_DYN_LINK -DBOOST_ALL_NO_LIB)
+#endif()
+
+include_directories(${BOOST_INCLUDEDIR} ${Boost_INCLUDE_DIRS})
+link_directories(${BOOST_LIBRARYDIR} ${Boost_LIBRARY_DIRS})
+
+
+##############
+## Find OpenMP
+##############
+find_package(OpenMP)
+
+##############
+## Find OpenCV
+##############
+if (WIN32)
+	if (${MSVC_TOOLSET_VERSION} EQUAL 143)
+		MESSAGE("SPECIAL OPENCV HANDLING")
+		set(opencv_set_arguments 
+		CHECK_CACHED_VAR OpenCV_DIR PATH "install" ## see OpenCVConfig.cmake
+	    )
+	elseif (MSVC11 OR MSVC12)
+	    set(opencv_set_arguments 
+		CHECK_CACHED_VAR OpenCV_DIR PATH "opencv/build" ## see OpenCVConfig.cmake
+	    )
+	elseif (MSVC14)
+	    set(opencv_set_arguments 
+		CHECK_CACHED_VAR OpenCV_DIR PATH "opencv-4.5.0/build" ## see OpenCVConfig.cmake
+	    )
+	else ()
+	    message("There is no provided OpenCV library for your compiler, relying on find_package to find it")
+	endif()
+else()
+	    message("There is no provided OpenCV library for your compiler, relying on find_package to find it")
+endif()
+
+sibr_addlibrary(NAME OpenCV #VERBOSE ON
+        MSVC11 "https://repo-sam.inria.fr/fungraph/dependencies/sibr/~0.9/opencv.7z"
+        MSVC12 "https://repo-sam.inria.fr/fungraph/dependencies/sibr/~0.9/opencv.7z"
+        MSVC14 "https://repo-sam.inria.fr/fungraph/dependencies/sibr/~0.9/opencv-4.5.0.7z"    # opencv compatible with msvc14 and with contribs
+        MSVC17 "https://repo-sam.inria.fr/fungraph/dependencies/sibr/~0.9/opencv4-8.7z" 
+		SET ${opencv_set_arguments}
+    )
+find_package(OpenCV 4.5 REQUIRED) ## Use directly the OpenCVConfig.cmake provided
+## FOR CLUSTER
+###find_package(OpenCV 4.5 REQUIRED PATHS "/data/graphdeco/share/opencv/usr/local/lib64/cmake/opencv4/" ) ## Use directly the OpenCVConfig.cmake provided
+
+    ##https://stackoverflow.com/questions/24262081/cmake-relwithdebinfo-links-to-debug-libs
+set_target_properties(${OpenCV_LIBS} PROPERTIES MAP_IMPORTED_CONFIG_RELWITHDEBINFO RELEASE)
+
+add_definitions(-DOPENCV_TRAITS_ENABLE_DEPRECATED) 
+
+if(OpenCV_INCLUDE_DIRS)
+    foreach(inc ${OpenCV_INCLUDE_DIRS})
+        if(NOT EXISTS ${inc})
+            set(OpenCV_INCLUDE_DIR "" CACHE PATH "additional custom include DIR (in case of trouble to find it (fedora 17 opencv package))")
+        endif()
+    endforeach()
+    if(OpenCV_INCLUDE_DIR)
+        list(APPEND OpenCV_INCLUDE_DIRS ${OpenCV_INCLUDE_DIR})
+        include_directories(${OpenCV_INCLUDE_DIRS})
+    endif()
+endif()
+
+###################
+## Find GLFW
+###################
+sibr_addlibrary(
+    NAME glfw3
+    MSVC11 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC15-splitted%20version/glfw-3.2.1.7z"
+    MSVC14 "https://repo-sam.inria.fr/fungraph/dependencies/ibr-common/win3rdParty-MSVC15-splitted%20version/glfw-3.2.1.7z"     # TODO SV: provide a valid version if required
+    SET CHECK_CACHED_VAR glfw3_DIR PATH "glfw-3.2.1"
+)
+
+### FOR CLUSTER COMMENT OUT lines above, uncomment lines below
+##find_package(GLFW REQUIRED 3.3 )
+##message("***********=============> GLFW IS " ${GLFW_LIBRARY})
+##message("***********=============> GLFW IS " ${GLFW_LIBRARIES})
+
+find_package(glfw3 REQUIRED)
+
+sibr_gitlibrary(TARGET imgui
+    GIT_REPOSITORY 	"https://gitlab.inria.fr/sibr/libs/imgui.git"
+    GIT_TAG			"741fb3ab6c7e1f7cef23ad0501a06b7c2b354944"
+)
+
+## FOR CLUSTER COMMENT OUT nativefiledialog
+sibr_gitlibrary(TARGET nativefiledialog
+    GIT_REPOSITORY 	"https://gitlab.inria.fr/sibr/libs/nativefiledialog.git"
+    GIT_TAG			"ae2fab73cf44bebdc08d997e307c8df30bb9acec"
+)
+
+
+sibr_gitlibrary(TARGET mrf
+    GIT_REPOSITORY 	"https://gitlab.inria.fr/sibr/libs/mrf.git"
+    GIT_TAG			"30c3c9494a00b6346d72a9e37761824c6f2b7207"
+)
+
+sibr_gitlibrary(TARGET nanoflann
+    GIT_REPOSITORY 	"https://gitlab.inria.fr/sibr/libs/nanoflann.git"
+    GIT_TAG			"7a20a9ac0a1d34850fc3a9e398fc4a7618e8a69a"
+)
+
+sibr_gitlibrary(TARGET picojson
+    GIT_REPOSITORY 	"https://gitlab.inria.fr/sibr/libs/picojson.git"
+    GIT_TAG			"7cf8feee93c8383dddbcb6b64cf40b04e007c49f"
+)
+
+sibr_gitlibrary(TARGET rapidxml
+    GIT_REPOSITORY 	"https://gitlab.inria.fr/sibr/libs/rapidxml.git"
+    GIT_TAG			"069e87f5ec5ce1745253bd64d89644d6b894e516"
+)
+
+sibr_gitlibrary(TARGET xatlas
+    GIT_REPOSITORY 	"https://gitlab.inria.fr/sibr/libs/xatlas.git"
+    GIT_TAG			"0fbe06a5368da13fcdc3ee48d4bdb2919ed2a249"
+    INCLUDE_DIRS 	"source/xatlas"
+)
+
+Win3rdPartyGlobalCacheAction()

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/downloadAndExtractZipFile.cmake

@@ -0,0 +1,243 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+## downloadAndExtractZipFile cmake function
+## Provide a way to download zip file from public internet ZIP_URL host
+## and to extract it in a specific EXCTRATED_ZIP_PATH destination.
+## This function use 7-Zip external tool to maximize the compatibles formats.
+## This will be not download again if the EXCTRATED_ZIP_PATH already exist and DL_FORCE is set to OFF.
+## This will try to unzip file if already exist in the ZIP_DL_PATH.
+##
+## If EXCTRATED_ZIP_PATH and/or ZIP_DL_PATH are not full path,
+## it will be interpreted relative to CMAKE_BINARY_DIR
+##
+## Usage example :
+## include(downloadAndExtractZipFile)
+## downloadAndExtractZipFile(
+## 	http://www.cs.cornell.edu/~snavely/bundler/distr/bundler-v0.4-source.zip
+## 	${CMAKE_BINARY_DIR}/Bundler/bundler-v0.4-source.zip
+## 	${CMAKE_BINARY_DIR}/Bundler
+##  [DL_FORCE ON|OFF]
+##  [TIMEOUT]
+##  [CHECK_DIRTY_URL]
+## )
+##
+## option DL_FORCE will redownload the zip file [deafult to OFF]
+## option TIMEOUT will end the unzip process after this period of time [default to 600s]
+## option CHECK_DIRTY_URL will write into the given file the downloaded URL and then,
+## next time, if the URL was updated, it detect it with this file
+## and will download the last version. This prevent to alway set manually DL_FORCE to ON...
+##
+if(__downloadAndExtractZipFile_cmake_INCLUDED__)
+	return()
+else()
+	set(__downloadAndExtractZipFile_cmake_INCLUDED__ ON)
+endif()
+
+function(downloadAndExtractZipFile ZIP_URL ZIP_DL_PATH EXCTRATED_ZIP_PATH)
+
+    # message(STATUS "zipUrl=${ZIP_URL} zipDlPath=${ZIP_DL_PATH} extractedZipPath=${EXCTRATED_ZIP_PATH}")
+    cmake_parse_arguments(dwnlezf "" "VERBOSE;DL_FORCE;TIMEOUT;CHECK_DIRTY_URL" "" ${ARGN})
+
+	set(PROGRAMFILESx86 "PROGRAMFILES(x86)")
+
+    ## Check entries mandatory args
+    if(IS_ABSOLUTE "${ZIP_DL_PATH}")
+    else()
+        set(ZIP_DL_PATH "${CMAKE_BINARY_DIR}/${ZIP_DL_PATH}")
+    endif()
+    if(IS_ABSOLUTE "${EXCTRATED_ZIP_PATH}")
+    else()
+        set(EXCTRATED_ZIP_PATH "${CMAKE_BINARY_DIR}/${EXCTRATED_ZIP_PATH}")
+    endif()
+    if(NOT EXISTS "${EXCTRATED_ZIP_PATH}")
+        file(MAKE_DIRECTORY ${EXCTRATED_ZIP_PATH})
+    endif()
+
+	# SB: Once, one of downloaded zip was corrupted by an error message coming from the server.
+	if(EXISTS "${ZIP_DL_PATH}")
+		# So I check for removing such corrupted files
+		message("Removing previous ${ZIP_DL_PATH} (might be corrupted)")
+		file(REMOVE "${ZIP_DL_PATH}")
+		if(EXISTS "${dwnlezf_CHECK_DIRTY_URL}")
+			# and remove the previous (corrupted) made 'Win3rdPartyUrl' file
+			file(REMOVE "${dwnlezf_CHECK_DIRTY_URL}")
+		endif()
+	endif()
+
+    ## Check entries optional args
+	macro(readDirtyUrl )
+		if(dwnlezf_CHECK_DIRTY_URL)
+			if(IS_ABSOLUTE "${dwnlezf_CHECK_DIRTY_URL}")
+			else()
+				set(dwnlezf_CHECK_DIRTY_URL "${CMAKE_BINARY_DIR}/${dwnlezf_CHECK_DIRTY_URL}")
+			endif()
+			get_filename_component(unzipDir 	${EXCTRATED_ZIP_PATH} NAME)
+			get_filename_component(unzipPath 	${EXCTRATED_ZIP_PATH} PATH)
+			message(STATUS "Checking ${unzipDir} [from ${unzipPath}]...")
+			if(EXISTS "${dwnlezf_CHECK_DIRTY_URL}")
+				get_filename_component(CHECK_DIRTY_URL_FILENAME ${dwnlezf_CHECK_DIRTY_URL} NAME)
+				file(STRINGS "${dwnlezf_CHECK_DIRTY_URL}" contents)
+				list(GET contents 0 downloadURL)
+				list(REMOVE_AT contents 0)
+				if("${downloadURL}" MATCHES "${ZIP_URL}")
+					if(dwnlezf_VERBOSE)
+						message(STATUS "Your downloaded version (URL) seems to be up to date. Let me check if nothing is missing... (see ${dwnlezf_CHECK_DIRTY_URL}).")
+					endif()
+					file(GLOB PATHNAME_PATTERN_LIST "${EXCTRATED_ZIP_PATH}/*") ## is there something inside the downloaded destination ?
+					unset(NAME_PATTERN_LIST)
+					foreach(realPathPattern ${PATHNAME_PATTERN_LIST})
+						get_filename_component(itemName ${realPathPattern} NAME)
+						list(APPEND NAME_PATTERN_LIST ${itemName})
+					endforeach()
+					if(NAME_PATTERN_LIST)
+						foreach(item ${contents})
+							list(FIND NAME_PATTERN_LIST ${item} id)
+							if(${id} MATCHES "-1")
+								message(STATUS "${item} is missing, your downloaded version content changed, need to redownload it.")
+								set(ZIP_DL_FORCE ON)
+								break()
+							else()
+								list(REMOVE_AT NAME_PATTERN_LIST ${id})
+								set(ZIP_DL_FORCE OFF)
+							endif()
+						endforeach()
+						if(NOT ZIP_DL_FORCE AND NAME_PATTERN_LIST)
+							message("Yours seems to be up to date (regarding to ${CHECK_DIRTY_URL_FILENAME})!\nBut there are additional files/folders into your downloaded destination (feel free to clean it if you want).")
+							foreach(item ${NAME_PATTERN_LIST})
+								if(item)
+									message("${item}")
+								endif()
+							endforeach()
+						endif()
+					endif()
+				else()
+					set(ZIP_DL_FORCE ON)
+					message(STATUS "Your downloaded version is dirty (too old).")
+				endif()
+			else()
+				file(GLOB PATHNAME_PATTERN_LIST "${EXCTRATED_ZIP_PATH}/*") ## is there something inside the downloaded destination ?
+				if(NOT PATHNAME_PATTERN_LIST)
+					message("We found nothing into ${EXCTRATED_ZIP_PATH}, we will try to download it for you now.")
+				endif()
+				set(ZIP_DL_FORCE ON)
+			endif()
+		endif()
+	endmacro()
+	readDirtyUrl()
+	if(NOT ZIP_DL_FORCE)
+		return() ## do not need to further (as we are up to date, just exit the function
+	endif()
+
+	macro(writeDirtyUrl )
+		if(dwnlezf_CHECK_DIRTY_URL)
+			file(WRITE "${dwnlezf_CHECK_DIRTY_URL}" "${ZIP_URL}\n")
+			file(GLOB PATHNAME_PATTERN_LIST "${EXCTRATED_ZIP_PATH}/*") ## is there something inside the downloaded destination ?
+			unset(NAME_PATTERN_LIST)
+			foreach(realPathPattern ${PATHNAME_PATTERN_LIST})
+				get_filename_component(itemName ${realPathPattern} NAME)
+				list(APPEND NAME_PATTERN_LIST ${itemName})
+			endforeach()
+			if(NAME_PATTERN_LIST)
+				foreach(item ${NAME_PATTERN_LIST})
+					file(APPEND "${dwnlezf_CHECK_DIRTY_URL}" "${item}\n")
+				endforeach()
+			endif()
+		endif()
+	endmacro()
+
+	if(dwnlezf_DL_FORCE)
+        set(ZIP_DL_FORCE ON)
+    endif()
+
+	if(NOT dwnlezf_TIMEOUT)
+		set(dwnlezf_TIMEOUT 600)
+	endif()
+	math(EXPR dwnlezf_TIMEOUT_MIN "${dwnlezf_TIMEOUT}/60")
+
+	macro(unzip whichZipFile)
+		if(NOT SEVEN_ZIP_CMD)
+			find_program(SEVEN_ZIP_CMD NAMES 7z 7za p7zip DOC "7-zip executable" PATHS "$ENV{PROGRAMFILES}/7-Zip" "$ENV{${PROGRAMFILESx86}}/7-Zip" "$ENV{ProgramW6432}/7-Zip")
+		endif()
+		if(SEVEN_ZIP_CMD)
+            if(dwnlezf_VERBOSE)
+                message(STATUS "UNZIP: please, WAIT UNTIL ${SEVEN_ZIP_CMD} finished...\n(no more than ${dwnlezf_TIMEOUT_MIN} min)")
+            else()
+                message(STATUS "UNZIP...wait...")
+            endif()
+			execute_process( 	COMMAND ${SEVEN_ZIP_CMD} x ${whichZipFile} -y
+								WORKING_DIRECTORY ${EXCTRATED_ZIP_PATH}	TIMEOUT ${dwnlezf_TIMEOUT}
+								RESULT_VARIABLE resVar OUTPUT_VARIABLE outVar ERROR_VARIABLE errVar
+							)
+			if(${resVar} MATCHES "0")
+                if(dwnlezf_VERBOSE)
+                    message(STATUS "SUCESS to unzip in ${EXCTRATED_ZIP_PATH}. Now we can remove the downloaded zip file.")
+                endif()
+				execute_process(COMMAND ${CMAKE_COMMAND} -E remove ${whichZipFile})
+				mark_as_advanced(SEVEN_ZIP_CMD)
+			else()
+				message(WARNING "something wrong in ${EXCTRATED_ZIP_PATH}\n with \"${SEVEN_ZIP_CMD} x ${whichZipFile} -y\", redo or try to unzip by yourself...")
+				message("unzip: resVar=${resVar}")
+				message("unzip: outVar=${outVar}")
+				message("unzip: errVar=${errVar}")
+				message("unzip: failed or canceled or timeout")
+			endif()
+		else()
+			message(WARNING "You need 7zip (http://www.7-zip.org/download.html) to unzip the downloaded dir.")
+			set(SEVEN_ZIP_CMD "" CACHE FILEPATH "7-zip executable")
+			mark_as_advanced(CLEAR SEVEN_ZIP_CMD)
+		endif()
+	endmacro()
+
+    if(dwnlezf_VERBOSE)
+        message(STATUS "Trying to look ${ZIP_DL_PATH} if a zip file exist...")
+    endif()
+	if(EXISTS "${ZIP_DL_PATH}")
+
+		## already downloaded, so just unzip it
+		unzip(${ZIP_DL_PATH})
+		writeDirtyUrl()
+
+	elseif(ZIP_DL_FORCE)
+
+		## the download part (+ unzip)
+		message(STATUS "Let me try to download package for you : ${ZIP_URL}")
+        if(dwnlezf_VERBOSE)
+            message(STATUS "Downloading...\n   SRC=${ZIP_URL}\n   DEST=${ZIP_DL_PATH}.tmp\n   INACTIVITY_TIMEOUT=180s")
+        endif()
+		file(DOWNLOAD ${ZIP_URL} ${ZIP_DL_PATH}.tmp INACTIVITY_TIMEOUT 360 STATUS status SHOW_PROGRESS)
+
+		list(GET status 0 numResult)
+		if(${numResult} MATCHES "0")
+
+            if(dwnlezf_VERBOSE)
+                message(STATUS "Download succeed, so let me rename the tmp file to unzip it")
+            endif()
+			execute_process(COMMAND ${CMAKE_COMMAND} -E rename ${ZIP_DL_PATH}.tmp ${ZIP_DL_PATH})
+			unzip(${ZIP_DL_PATH})
+			writeDirtyUrl()
+
+		else()
+
+			list(GET status 1 errMsg)
+			message(WARNING "DOWNLOAD ${ZIP_URL} to ${ZIP_DL_PATH} failed\n:${errMsg}")
+			message(WARNING "OK, you need to download the ${ZIP_URL} manually and put it into ${ZIP_DL_PATH}")
+			message("Take a look at the project website page to check available URL.")
+
+		endif()
+
+	endif()
+
+	## clean up the tmp downloaded file
+	if(EXISTS "${ZIP_DL_PATH}.tmp")
+		execute_process(COMMAND ${CMAKE_COMMAND} -E remove ${ZIP_DL_PATH}.tmp)
+	endif()
+
+endfunction()

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/git_describe.cmake

@@ -0,0 +1,114 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+if(__git_describe_INCLUDED__)
+	return()
+else()
+	set(__git_describe_INCLUDED__ ON)
+endif()
+
+find_package(Git)
+if(Git_FOUND)
+  message(STATUS "Git found: ${GIT_EXECUTABLE}")
+else()
+  message(FATAL_ERROR "Git not found. Aborting")
+endif()
+
+macro(git_describe)
+    cmake_parse_arguments(GIT_DESCRIBE "" "GIT_URL;GIT_BRANCH;GIT_COMMIT_HASH;GIT_TAG;GIT_VERSION;PATH" "" ${ARGN})
+
+    if(NOT GIT_DESCRIBE_PATH)
+        set(GIT_DESCRIBE_PATH ${CMAKE_SOURCE_DIR})
+    endif()
+
+    if(GIT_DESCRIBE_GIT_URL)
+        # Get the current remote
+        execute_process(
+            COMMAND git remote
+            WORKING_DIRECTORY   ${GIT_DESCRIBE_PATH}
+            OUTPUT_VARIABLE     GIT_DESCRIBE_GIT_REMOTE
+            OUTPUT_STRIP_TRAILING_WHITESPACE
+            ERROR_QUIET
+        )
+
+        # Get the current remote
+        execute_process(
+            COMMAND git remote get-url ${GIT_DESCRIBE_GIT_REMOTE}
+            WORKING_DIRECTORY   ${GIT_DESCRIBE_PATH}
+            OUTPUT_VARIABLE     ${GIT_DESCRIBE_GIT_URL}
+            OUTPUT_STRIP_TRAILING_WHITESPACE
+            ERROR_QUIET
+        )
+    endif()
+
+    if(GIT_DESCRIBE_GIT_BRANCH)
+        # Get the current working branch
+        execute_process(
+            COMMAND git rev-parse --abbrev-ref HEAD
+            WORKING_DIRECTORY   ${GIT_DESCRIBE_PATH}
+            OUTPUT_VARIABLE     ${GIT_DESCRIBE_GIT_BRANCH}
+            OUTPUT_STRIP_TRAILING_WHITESPACE
+            ERROR_QUIET
+        )
+    endif()
+
+    if(GIT_DESCRIBE_GIT_COMMIT_HASH)
+        # Get the latest abbreviated commit hash of the working branch
+        execute_process(
+            COMMAND git rev-parse HEAD
+            WORKING_DIRECTORY   ${GIT_DESCRIBE_PATH}
+            OUTPUT_VARIABLE     ${GIT_DESCRIBE_GIT_COMMIT_HASH}
+            OUTPUT_STRIP_TRAILING_WHITESPACE
+            ERROR_QUIET
+        )
+    endif()
+
+    if(GIT_DESCRIBE_GIT_TAG)
+        # Get the tag
+        execute_process(
+            COMMAND git describe --tags --exact-match
+            WORKING_DIRECTORY   ${GIT_DESCRIBE_PATH}
+            OUTPUT_VARIABLE     ${GIT_DESCRIBE_GIT_TAG}
+            OUTPUT_STRIP_TRAILING_WHITESPACE
+            ERROR_QUIET
+        )
+    endif()
+
+    if(GIT_DESCRIBE_GIT_VERSION)
+        # Get the version from git describe
+        execute_process(
+            COMMAND git describe
+            WORKING_DIRECTORY   ${GIT_DESCRIBE_PATH}
+            OUTPUT_VARIABLE     ${GIT_DESCRIBE_GIT_VERSION}
+            OUTPUT_STRIP_TRAILING_WHITESPACE
+            ERROR_QUIET
+        )
+
+        if(${GIT_DESCRIBE_GIT_VERSION} STREQUAL "")
+            execute_process(
+                COMMAND git rev-parse --abbrev-ref HEAD
+                WORKING_DIRECTORY   ${GIT_DESCRIBE_PATH}
+                OUTPUT_VARIABLE     GIT_DESCRIBE_GIT_VERSION_BRANCH
+                OUTPUT_STRIP_TRAILING_WHITESPACE
+                ERROR_QUIET
+            )
+            execute_process(
+                COMMAND git log -1 --format=%h
+                WORKING_DIRECTORY   ${GIT_DESCRIBE_PATH}
+                OUTPUT_VARIABLE     GIT_DESCRIBE_GIT_VERSION_COMMIT
+                OUTPUT_STRIP_TRAILING_WHITESPACE
+                ERROR_QUIET
+            )
+
+            set(${GIT_DESCRIBE_GIT_VERSION} "${GIT_DESCRIBE_GIT_VERSION_BRANCH}-${GIT_DESCRIBE_GIT_VERSION_COMMIT}")
+        endif()
+    endif()
+
+endmacro()

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/include_once.cmake

@@ -0,0 +1,22 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+macro(include_once file)
+    get_filename_component(INCLUDE_ONCE_FILEPATH ${file} REALPATH)
+    string(REGEX REPLACE "(\\.|\\/+|\\:|\\\\+)" "_" INCLUDE_ONCE_FILEPATH ${INCLUDE_ONCE_FILEPATH})
+    get_property(INCLUDED_${INCLUDE_ONCE_FILEPATH}_LOCAL GLOBAL PROPERTY INCLUDED_${INCLUDE_ONCE_FILEPATH})
+    if (INCLUDED_${INCLUDE_ONCE_FILEPATH}_LOCAL)
+        return()
+    else()
+        set_property(GLOBAL PROPERTY INCLUDED_${INCLUDE_ONCE_FILEPATH} true)
+
+        include(${file})
+    endif()
+endmacro()

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/install_runtime.cmake

@@ -0,0 +1,887 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+## This file is mainly used to allow runtime installation
+## There are some utilities cmake functions to ease the generic deployement (abstract common usage of cmake)...
+##
+## You cannot run your programm automaticaly from your CNAKE_BINARY_DIR when you build
+## as it will miss all dependencies and ressources files...
+## You have to run install target in order to test your programm.
+##
+## The only one function/macros you may use inside your sub-CMakeLists.txt (sub-project) is :
+## ******************
+## ibr_install_target macro => see documentation at the end of this file
+## ******************
+## It use these utilities cmake functions to abstract the installation in an uniform way for all sub-projects.
+##
+if(__install_runtime_cmake_INCLUDED__)
+	return()
+else()
+	set(__install_runtime_cmake_INCLUDED__ ON)
+endif()
+
+
+##
+## Allow to write a resource config file which contain additional ressource paths
+## (used by IBR_Common Resource system to load shaders and potentialy images, plugins and so on)
+##
+## ADD option list all the paths to add in the file (relative paths are interpreted relative to working dir of the executable)
+## INSTALL option to specify where we want to install this file
+##
+## Example usage:
+## resourceFile(ADD "shaders" "${PROJECT_NAME}_rsc" INSTALL bin)
+##
+macro(resourceFile)
+	cmake_parse_arguments(rsc "" "INSTALL;FILE_PATH;CONFIG_TYPE" "ADD" ${ARGN}) ## both args are directory path
+
+	if(rsc_ADD)
+		unset(IBR_RSC_FILE_CONTENT_LIST)
+		if(EXISTS "${rsc_FILE_PATH}")
+			file(READ "${rsc_FILE_PATH}" IBR_RSC_FILE_CONTENT)
+			string(REGEX REPLACE "\n" ";" IBR_RSC_FILE_CONTENT_LIST "${IBR_RSC_FILE_CONTENT}")
+		endif()
+		list(APPEND IBR_RSC_FILE_CONTENT_LIST "${rsc_ADD}")
+		list(REMOVE_DUPLICATES IBR_RSC_FILE_CONTENT_LIST)
+		file(WRITE "${rsc_FILE_PATH}" "")
+		foreach(rscDir ${IBR_RSC_FILE_CONTENT_LIST})
+			file(APPEND "${rsc_FILE_PATH}" "${rscDir}\n")
+		endforeach()
+		unset(rsc_ADD)
+	endif()
+
+	if(rsc_INSTALL)
+		install(FILES ${rsc_FILE_PATH} CONFIGURATIONS ${rsc_CONFIG_TYPE} DESTINATION ${rsc_INSTALL})
+		unset(rsc_INSTALL)
+	endif()
+endmacro()
+
+
+##
+## Install *.pdb generated file for the current cmake project
+## assuming the output target name is the cmake project name.
+## This macro is useful for crossplateform multi config mode.
+##
+## Usage Example:
+##
+## 	if(DEFINED CMAKE_BUILD_TYPE)						## for make/nmake based
+##		installPDB(${PROJECT_NAME} ${CMAKE_BUILD_TYPE} RUNTIME_DEST bin ARCHIVE_DEST lib LIBRARY_DEST lib)
+## 	endif()
+##	foreach(CONFIG_TYPES ${CMAKE_CONFIGURATION_TYPES}) 	## for multi config types (MSVC based)
+##		installPDB(${PROJECT_NAME} ${CONFIG_TYPES} RUNTIME_DEST bin ARCHIVE_DEST lib LIBRARY_DEST lib)
+##	endforeach()
+##
+macro(installPDB targetName configType)
+	cmake_parse_arguments(instpdb "" "COMPONENT" "ARCHIVE_DEST;LIBRARY_DEST;RUNTIME_DEST" ${ARGN}) ## both args are directory path
+
+	if(NOT MSVC)
+		return()
+	endif()
+
+    ## Check if DESTINATION are provided according to the TYPE of the given target (see install command doc to see correspodances)
+    get_target_property(type ${targetName} TYPE)
+    if(${type} MATCHES "EXECUTABLE" AND instpdb_RUNTIME_DEST)
+        set(pdb_DESTINATION ${instpdb_RUNTIME_DEST})
+    elseif(${type} MATCHES "STATIC_LIBRARY" AND instpdb_ARCHIVE_DEST)
+        set(pdb_DESTINATION ${instpdb_ARCHIVE_DEST})
+    elseif(${type} MATCHES "MODULE_LIBRARY" AND instpdb_LIBRARY_DEST)
+        set(pdb_DESTINATION ${instpdb_LIBRARY_DEST})
+    elseif(${type} MATCHES "SHARED_LIBRARY")
+        if(WIN32 AND instpdb_RUNTIME_DEST)
+            set(pdb_DESTINATION ${instpdb_RUNTIME_DEST})
+        else()
+            set(pdb_DESTINATION ${instpdb_LIBRARY_DEST})
+        endif()
+    endif()
+
+    if(NOT pdb_DESTINATION)
+		set(pdb_DESTINATION bin) ## default destination of the pdb file
+	endif()
+
+	if(NOT instpdb_COMPONENT)
+		set(instpdb_COMPONENT )
+	else()
+		set(instpdb_COMPONENT COMPONENT ${instpdb_COMPONENT})
+	endif()
+
+	string(TOUPPER ${configType} CONFIG_TYPES_UC)
+	get_target_property(PDB_PATH ${targetName} PDB_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC})
+
+	get_target_property(confModePostfix ${targetName} ${CONFIG_TYPES_UC}_POSTFIX)
+	if(NOT confModePostfix)
+		set(confModePostfix "")
+	endif()
+	set_target_properties(${targetName} PROPERTIES  PDB_NAME_${CONFIG_TYPES_UC} ${targetName}${confModePostfix})
+	get_target_property(PDB_NAME ${targetName} PDB_NAME_${CONFIG_TYPES_UC})# if not set, this is empty
+
+	if(EXISTS "${PDB_PATH}/${PDB_NAME}.pdb")
+		install(FILES "${PDB_PATH}/${PDB_NAME}.pdb" CONFIGURATIONS ${configType} DESTINATION ${pdb_DESTINATION} ${instpdb_COMPONENT} OPTIONAL)
+	endif()
+endmacro()
+
+
+##
+## Add additional target to install a project independently and based on its component
+## configMode is used to prevent default Release installation (we want also to install in other build/config type)
+##
+macro(installTargetProject targetOfProject targetOfInstallProject)
+ 	if(DEFINED CMAKE_BUILD_TYPE) ## for make/nmake based
+		set(configMode ${CMAKE_BUILD_TYPE})
+	elseif(MSVC)
+		## $(Configuration) will be one of the following : Debug, Release, MinSizeRel, RelWithDebInfo
+		set(configMode $(Configuration))
+ 	endif()
+	if(configMode)
+        get_target_property(srcFiles ${targetOfProject} SOURCES)
+		add_custom_target(	${targetOfInstallProject} #ALL
+							${CMAKE_COMMAND} -DBUILD_TYPE=${configMode} -DCOMPONENT=${targetOfInstallProject} -P ${CMAKE_BINARY_DIR}/cmake_install.cmake
+							DEPENDS ${srcFiles}
+							COMMENT "run the installation only for ${targetOfProject}" VERBATIM
+							)
+		add_dependencies(${targetOfInstallProject} ${targetOfProject})
+
+		get_target_property(INSTALL_BUILD_FOLDER ${targetOfProject} FOLDER)
+		set_target_properties(${targetOfInstallProject} PROPERTIES FOLDER ${INSTALL_BUILD_FOLDER})
+	endif()
+endmacro()
+
+# Collect all currently added targets in all subdirectories
+#
+# Parameters:
+# - _result the list containing all found targets
+# - _dir root directory to start looking from
+function(get_all_targets _result _dir)
+    get_property(_subdirs DIRECTORY "${_dir}" PROPERTY SUBDIRECTORIES)
+    foreach(_subdir IN LISTS _subdirs)
+        get_all_targets(${_result} "${_subdir}")
+    endforeach()
+
+    get_directory_property(_sub_targets DIRECTORY "${_dir}" BUILDSYSTEM_TARGETS)
+    set(${_result} ${${_result}} ${_sub_targets} PARENT_SCOPE)
+endfunction()
+
+##
+## Add targets for building and installing subdirectories
+macro(subdirectory_target target directory build_folder)
+	add_custom_target(${target}
+		COMMENT "run build for all projects in this directory" VERBATIM
+	)
+	get_all_targets(ALL_TARGETS ${directory})
+	add_dependencies(${target} ${ALL_TARGETS})
+	add_custom_target(${target}_install
+		${CMAKE_COMMAND} -DBUILD_TYPE=$<CONFIG> -DCOMPONENT=${target}_install -P ${CMAKE_BINARY_DIR}/cmake_install.cmake
+		COMMENT "run install for all projects in this directory" VERBATIM
+	)
+	add_dependencies(${target}_install ${target})
+
+	set_target_properties(${target}			PROPERTIES FOLDER ${build_folder})
+	set_target_properties(${target}_install PROPERTIES FOLDER ${build_folder})
+endmacro()
+
+
+##  CMAKE install all required dependencies for an application (included system OS files like msvc*.dll for example)
+##
+## install_runtime(<installedFilePathTargetAppToResolve>
+##      [TARGET                 name]
+##      [PLUGINS 				name 		[nameN ...] [PLUGIN_PATH_NAME currentPathName [FROM_REL_PATH matchDirFromCurrentPathName] [PLUGIN_PATH_DEST installDir] ]
+##      [PLUGINS 				...]
+##      [DIRS 					path 		[pathN ...] ]
+##		[TARGET_LIBRARIES  		filePath	[filePathN ...] ]
+##		[TARGET_PACKAGES   		packageName [packageNameN ...] ]
+##		[COMPONENT				installComponentName]
+##		[PLAUSIBLES_POSTFIX		Debug_postfix [MinSizeRel_postfix relWithDebInfo_postfix ...] ]
+##      [VERBOSE]
+## )
+##
+## installedFilePathTargetAppToResolve : the final installed targetApp absolute full file path name you want to resolve
+##
+## TARGET           :   The target app we want to install. If given, it's used to look for link libraries paths (best choice to use, strongly advised to use it)
+##
+## PLUGINS 			: 	Some application built use/load some plugins which can't be detect inside its binary,
+##						so, here you can specify which plugins the application use/load in order to install them
+##						and resolve also there dependencies.
+## 		With PLUGINS multi FLAGS 	:
+## 	 		PLUGIN_PATH_NAME 	: The current plugin full file path we want to install
+##			FROM_REL_PATH		: [optional: default only the file is kept] From which matching dir of the plugin path we want to install (keep the directories structure)
+##			PLUGIN_PATH_DEST	: [optional: default relative to executable directory] Where (full path to the install directory) we will install the plugin file (or file path)
+##
+## DIRS 			:	A list of directories to looking for dependencies
+## TARGET_LIBRARIES :	DEPRECATED (use TARGET flag instead) : The cmake content variables used for the target_link_libraries(<targetApp> ...)
+## TARGET_PACKAGES 	: 	DEPRECATED (use TARGET flag instead) : The cmake package names used for the findPackage(...) for your targetApp
+##						ADVICE: This flag add entries in cache (like: <packageName>_DIR), it could be useful to fill these variable!
+## COMPONENT		:	(default to runtime) Is the component name associated to the installation
+##						It is used when you want to install separatly some part of your projets (see install cmake doc)
+## VERBOSE			: 	For debug or to get more informations in the output console
+##
+## Usage:
+##	 install_runtime(${CMAKE_INSTALL_PREFIX}/${EXECUTABLE_NAME}${CMAKE_EXECUTABLE_SUFFIX}
+##		VERBOSE
+##      TARGET  ${PROJECT_NAME}
+##      PLAUSIBLES_POSTFIX  _d
+##      PLUGINS
+##		    PLUGIN_PATH_NAME    ${PLUGIN_PATH_NAME}${CMAKE_SHARED_MODULE_SUFFIX} ## will be installed (default exec path if no PLUGINS_DEST) and then will be resolved
+##			FROM_REL_PATH		plugins ## optional, used especially for keeping qt plugins tree structure
+##          PLUGIN_PATH_DEST    ${CMAKE_INSTALL_PREFIX}/plugins ## (or relative path 'plugins' will be interpreted relative to installed executable)
+##		DIRS				${CMAKE_CURRENT_BINARY_DIR} ${CMAKE_BINARY_DIR}
+##		TARGET_LIBRARIES	${OPENGL_LIBRARIES}         ## DEPRECATED (use TARGET flag instead)
+##							${GLEW_LIBRARIES}
+##							${GLUT_LIBRARIES}
+##							${Boost_LIBRARIES}
+##							${SuiteSparse_LIBRARIES}
+##							${CGAL_LIBRARIES}
+##		TARGET_PACKAGES		OPENGL                      ## DEPRECATED (use TARGET flag instead)
+##							GLEW
+##							GLUT
+##							CGAL
+##							Boost
+##							SuiteSparse
+##	)
+##
+## For plugins part, it use our internal parse_arguments_multi.cmake
+##
+function(install_runtime installedFilePathTargetAppToResolve)
+    set(optionsArgs "VERBOSE")
+    set(oneValueArgs "COMPONENT;INSTALL_FOLDER;CONFIG_TYPE")
+    set(multiValueArgs "DIRS;PLUGINS;TARGET_LIBRARIES;TARGET_PACKAGES;TARGET;PLAUSIBLES_POSTFIX")
+    cmake_parse_arguments(inst_run "${optionsArgs}" "${oneValueArgs}" "${multiValueArgs}" ${ARGN} )
+
+    if(IS_ABSOLUTE ${installedFilePathTargetAppToResolve})
+    else()
+        set(installedFilePathTargetAppToResolve ${inst_run_INSTALL_FOLDER}/${installedFilePathTargetAppToResolve})
+    endif()
+
+	get_filename_component(EXEC_NAME ${installedFilePathTargetAppToResolve} NAME_WE)
+	get_filename_component(EXEC_PATH ${installedFilePathTargetAppToResolve} PATH)
+
+	if(NOT inst_run_COMPONENT)
+		set(inst_run_COMPONENT runtime)
+	endif()
+
+
+    ## Try to append as more possible as possible paths to find dependencies (deprecated since we can use target_properties to get back paths)
+    set(libPaths )
+	foreach(libraryFileName ${inst_run_TARGET_LIBRARIES})
+		if(IS_DIRECTORY "${libraryFileName}")
+			list(APPEND libPaths "${libraryFileName}")
+		else()
+			get_filename_component(libpath "${libraryFileName}" PATH)
+			if(EXISTS "${libpath}")
+				list(APPEND libPaths "${libpath}")
+			endif()
+		endif()
+	endforeach()
+
+    ## This macro is used internaly here to recursilvely get path of LINK_LIBRARIES of each non imported target
+    ## Typically if you have 2 internal dependencies between cmake targets, we want cmake to be able to get back path where are these dependencies
+    macro(recurseDepList target)
+        get_target_property(linkLibs ${target} LINK_LIBRARIES)
+        foreach(lib ${linkLibs})
+            string(FIND ${lib} ">" strId) ## cmake is using generator-expression?
+			if(TARGET ${lib})
+				## Skipping interface libraries as they're system ones
+                get_target_property(type ${lib} TYPE)
+				get_target_property(imported ${lib} IMPORTED)
+				if(type STREQUAL "INTERFACE_LIBRARY")
+					get_target_property(imp_loc ${lib} INTERFACE_IMPORTED_LOCATION)
+					if(imp_loc)
+						get_filename_component(imp_loc ${imp_loc} PATH)
+						list(APPEND targetLibPath ${imp_loc})
+					endif()
+					get_target_property(loc ${lib} INTERFACE_LOCATION)
+					if(loc)
+						get_filename_component(loc ${loc} PATH)
+						list(APPEND targetLibPath ${loc})
+					endif()
+                ## it's not a path but a single target name
+                ## for build-target which are part of the current cmake configuration : nothing to do as cmake already know the output path
+                ## for imported target, we need to look for theire imported location
+                elseif(imported)
+                    get_target_property(imp_loc ${lib} IMPORTED_LOCATION)
+                    if(imp_loc)
+                        get_filename_component(imp_loc ${imp_loc} PATH)
+                        list(APPEND targetLibPath ${imp_loc})
+                    endif()
+                    get_target_property(loc ${lib} LOCATION)
+                    if(loc)
+                        get_filename_component(loc ${loc} PATH)
+                        list(APPEND targetLibPath ${loc})
+                    endif()
+                else()
+                    recurseDepList(${lib})
+                endif()
+            elseif(NOT ${strId} MATCHES -1) ## mean cmake use generator-expression (CMAKE VERSION > 3.0)
+                string(REGEX MATCH      ">:[@A-Za-z_:/.0-9-]+"           targetLibPath ${lib})
+                string(REGEX REPLACE    ">:([@A-Za-z_:/.0-9-]+)" "\\1"   targetLibPath ${targetLibPath})
+                get_filename_component(targetLibPath ${targetLibPath} PATH)
+            elseif(EXISTS ${lib})
+                set(targetLibPath ${lib})
+                get_filename_component(targetLibPath ${targetLibPath} PATH)
+            else()
+                #message(STATUS "[install_runtime] skip link library : ${lib} , of target ${target}")
+            endif()
+            if(targetLibPath)
+                list(APPEND targetLinkLibsPathList ${targetLibPath})
+            endif()
+        endforeach()
+        if(targetLinkLibsPathList)
+            list(REMOVE_DUPLICATES targetLinkLibsPathList)
+        endif()
+    endmacro()
+    if(inst_run_TARGET)
+        recurseDepList(${inst_run_TARGET})
+        if(targetLinkLibsPathList)
+            list(APPEND libPaths ${targetLinkLibsPathList})
+        endif()
+    endif()
+
+	if(libPaths)
+		list(REMOVE_DUPLICATES libPaths)
+        foreach(libPath ${libPaths})
+            get_filename_component(path ${libPath} PATH)
+            list(APPEND libPaths ${path})
+        endforeach()
+	endif()
+
+
+	## possible speciale dir(s) according to the build system and OS
+	if(CMAKE_SIZEOF_VOID_P EQUAL 8)
+		set(BUILD_TYPES_FOR_DLL "x64")
+		if(WIN32)
+			list(APPEND BUILD_TYPES_FOR_DLL "Win64")
+		endif()
+	else()
+		set(BUILD_TYPES_FOR_DLL "x86")
+		if(WIN32)
+			list(APPEND BUILD_TYPES_FOR_DLL "Win32")
+		endif()
+	endif()
+
+
+	## Try to append as more as possible paths to find dependencies (here, mainly for *.dll)
+	foreach(dir ${inst_run_DIRS} ${libPaths})
+		if(EXISTS "${dir}/bin")
+			list(APPEND inst_run_DIRS "${dir}/bin")
+        elseif(EXISTS "${dir}")
+            list(APPEND inst_run_DIRS "${dir}")
+		endif()
+	endforeach()
+    list(REMOVE_DUPLICATES inst_run_DIRS)
+	foreach(dir ${inst_run_DIRS})
+		if(EXISTS "${dir}")
+			list(APPEND argDirs ${dir})
+			foreach(BUILD_TYPE_FOR_DLL ${BUILD_TYPES_FOR_DLL})
+				if(EXISTS "${dir}/${BUILD_TYPE_FOR_DLL}")
+					list(APPEND argDirs "${dir}/${BUILD_TYPE_FOR_DLL}")
+				endif()
+				foreach(OUTPUTCONFIG ${CMAKE_CONFIGURATION_TYPES}) ## for windows multi-generator (MSVC)
+					if(EXISTS "${dir}/${BUILD_TYPE_FOR_DLL}/${OUTPUTCONFIG}")
+						list(APPEND argDirs "${dir}/${BUILD_TYPE_FOR_DLL}/${OUTPUTCONFIG}")
+					endif()
+				endforeach()
+				if(CMAKE_BUILD_TYPE) ## for single generator (makefiles)
+					if(EXISTS "${dir}/${BUILD_TYPE_FOR_DLL}/${CMAKE_BUILD_TYPE}")
+						list(APPEND argDirs "${dir}/${BUILD_TYPE_FOR_DLL}/${CMAKE_BUILD_TYPE}")
+					endif()
+				endif()
+			endforeach()
+			foreach(OUTPUTCONFIG ${CMAKE_CONFIGURATION_TYPES}) ## for windows multi-generator (MSVC)
+				if(EXISTS "${dir}/${OUTPUTCONFIG}")
+					list(APPEND argDirs "${dir}/${OUTPUTCONFIG}")
+				endif()
+				foreach(BUILD_TYPE_FOR_DLL ${BUILD_TYPES_FOR_DLL})
+					if(EXISTS "${dir}/${OUTPUTCONFIG}/${BUILD_TYPE_FOR_DLL}")
+						list(APPEND argDirs "${dir}/${OUTPUTCONFIG}/${BUILD_TYPE_FOR_DLL}")
+					endif()
+				endforeach()
+			endforeach()
+			if(CMAKE_BUILD_TYPE) ## for single generator (makefiles)
+				if(EXISTS "${dir}/${CMAKE_BUILD_TYPE}")
+					list(APPEND argDirs "${dir}/${CMAKE_BUILD_TYPE}")
+				endif()
+				foreach(BUILD_TYPE_FOR_DLL ${BUILD_TYPES_FOR_DLL})
+					if(EXISTS "${dir}/${CMAKE_BUILD_TYPE}/${BUILD_TYPE_FOR_DLL}")
+						list(APPEND argDirs "${dir}/${CMAKE_BUILD_TYPE}/${BUILD_TYPE_FOR_DLL}")
+					endif()
+				endforeach()
+			endif()
+		endif()
+	endforeach()
+	if(argDirs)
+		list(REMOVE_DUPLICATES argDirs)
+	endif()
+
+
+	## Try to append as more possible paths to find dependencies (here, mainly for *.dll)
+	foreach(packageName ${inst_run_TARGET_PACKAGES})
+		if(EXISTS "${${packageName}_DIR}")
+			list(APPEND packageDirs ${${packageName}_DIR})
+			list(APPEND packageDirs ${${packageName}_DIR}/bin)
+			foreach(BUILD_TYPE_FOR_DLL ${BUILD_TYPES_FOR_DLL})
+				if(EXISTS "${${packageName}_DIR}/bin/${BUILD_TYPE_FOR_DLL}")
+					list(APPEND packageDirs "${${packageName}_DIR}/bin/${BUILD_TYPE_FOR_DLL}")
+				endif()
+				foreach(OUTPUTCONFIG ${CMAKE_CONFIGURATION_TYPES}) ## for windows multi-generator (MSVC)
+					if(EXISTS "${${packageName}_DIR}/bin/${BUILD_TYPE_FOR_DLL}/${OUTPUTCONFIG}")
+						list(APPEND packageDirs "${${packageName}_DIR}/bin/${BUILD_TYPE_FOR_DLL}/${OUTPUTCONFIG}")
+					endif()
+				endforeach()
+				if(CMAKE_BUILD_TYPE) ## for single generator (makefiles)
+					if(EXISTS "${${packageName}_DIR}/bin/${BUILD_TYPE_FOR_DLL}/${CMAKE_BUILD_TYPE}")
+						list(APPEND packageDirs "${${packageName}_DIR}/bin/${BUILD_TYPE_FOR_DLL}/${CMAKE_BUILD_TYPE}")
+					endif()
+				endif()
+			endforeach()
+			foreach(OUTPUTCONFIG ${CMAKE_CONFIGURATION_TYPES}) ## for windows multi-generator (MSVC)
+				if(EXISTS "${${packageName}_DIR}/bin/${OUTPUTCONFIG}")
+					list(APPEND packageDirs "${${packageName}_DIR}/bin/${OUTPUTCONFIG}")
+				endif()
+				foreach(BUILD_TYPE_FOR_DLL ${BUILD_TYPES_FOR_DLL})
+					if(EXISTS "${${packageName}_DIR}/bin/${OUTPUTCONFIG}/${BUILD_TYPE_FOR_DLL}")
+						list(APPEND packageDirs "${${packageName}_DIR}/bin/${OUTPUTCONFIG}/${BUILD_TYPE_FOR_DLL}")
+					endif()
+				endforeach()
+			endforeach()
+			if(CMAKE_BUILD_TYPE) ## for single generator (makefiles)
+				if(EXISTS "${${packageName}_DIR}/bin/${CMAKE_BUILD_TYPE}")
+					list(APPEND packageDirs "${${packageName}_DIR}/bin/${CMAKE_BUILD_TYPE}")
+				endif()
+				foreach(BUILD_TYPE_FOR_DLL ${BUILD_TYPES_FOR_DLL})
+					if(EXISTS "${${packageName}_DIR}/bin/${CMAKE_BUILD_TYPE}/${BUILD_TYPE_FOR_DLL}")
+						list(APPEND packageDirs "${${packageName}_DIR}/bin/${CMAKE_BUILD_TYPE}/${BUILD_TYPE_FOR_DLL}")
+					endif()
+				endforeach()
+			endif()
+		else()
+			set(${packageName}_DIR "$ENV{${packageName}_DIR}" CACHE PATH "${packageName}_DIR root directory for looking for dirs containning *.dll")
+		endif()
+	endforeach()
+	if(packageDirs)
+		list(REMOVE_DUPLICATES packageDirs)
+	endif()
+
+
+	set(dirsToLookFor "${EXEC_PATH}")
+	if(packageDirs)
+		list(APPEND dirsToLookFor ${packageDirs})
+	endif()
+	if(argDirs)
+		list(APPEND dirsToLookFor ${argDirs})
+	endif()
+	get_property(used_LINK_DIRECTORIES DIRECTORY PROPERTY LINK_DIRECTORIES)
+	if (used_LINK_DIRECTORIES)
+		list(APPEND dirsToLookFor ${used_LINK_DIRECTORIES})
+		list(REMOVE_DUPLICATES dirsToLookFor)
+	endif()
+
+
+    ## handle plugins
+	set(pluginsList "")
+    include(parse_arguments_multi) ## this function will process recursively items of the sub-list [default print messages]
+    function(parse_arguments_multi_function results)
+        cmake_parse_arguments(pamf "VERBOSE" "PLUGIN_PATH_DEST;FROM_REL_PATH;EXEC_PATH;COMPONENT" "" ${ARGN}) ## EXEC_PATH and COMPONENT are for exclusive internal use
+		list(REMOVE_DUPLICATES pamf_UNPARSED_ARGUMENTS)
+        foreach(PLUGIN_PATH_NAME ${pamf_UNPARSED_ARGUMENTS})
+            if(EXISTS ${PLUGIN_PATH_NAME})
+                if(IS_DIRECTORY ${PLUGIN_PATH_NAME})
+                    if(pamf_VERBOSE)
+                        message(WARNING "${PLUGIN_PATH_NAME} IS_DIRECTORY, cannot installed a directory, please give a path filename")
+                    endif()
+                else()
+                    if(NOT pamf_PLUGIN_PATH_DEST)
+                        set(PLUGIN_PATH_DEST ${pamf_EXEC_PATH}) ## the default dest value
+					else()
+						set(PLUGIN_PATH_DEST ${pamf_PLUGIN_PATH_DEST})
+                    endif()
+
+					if(pamf_FROM_REL_PATH)
+						file(TO_CMAKE_PATH ${PLUGIN_PATH_NAME} PLUGIN_PATH_NAME)
+						get_filename_component(PLUGIN_PATH ${PLUGIN_PATH_NAME} PATH)
+						unset(PLUGIN_PATH_LIST)
+						unset(PLUGIN_PATH_LIST_COUNT)
+						unset(PLUGIN_REL_PATH_LIST)
+						unset(PLUGIN_REL_PATH)
+						string(REPLACE "/" ";" PLUGIN_PATH_LIST ${PLUGIN_PATH}) ## create a list of dir
+						list(FIND 	PLUGIN_PATH_LIST ${pamf_FROM_REL_PATH} id)
+						list(LENGTH PLUGIN_PATH_LIST PLUGIN_PATH_LIST_COUNT)
+						if(${id} GREATER 0)
+							math(EXPR id "${id}+1") ## matches relative path not include
+							math(EXPR PLUGIN_PATH_LIST_COUNT "${PLUGIN_PATH_LIST_COUNT}-1") ## the end of the list
+							foreach(i RANGE ${id} ${PLUGIN_PATH_LIST_COUNT})
+								list(GET 	PLUGIN_PATH_LIST 	${i} out)
+								list(APPEND PLUGIN_REL_PATH_LIST 	${out})
+							endforeach()
+							foreach(dir ${PLUGIN_REL_PATH_LIST})
+								set(PLUGIN_REL_PATH "${PLUGIN_REL_PATH}/${dir}")
+							endforeach()
+						endif()
+						set(PLUGIN_PATH_DEST ${PLUGIN_PATH_DEST}${PLUGIN_REL_PATH})
+					endif()
+
+                    install(FILES ${PLUGIN_PATH_NAME} CONFIGURATIONS ${inst_run_CONFIG_TYPE} DESTINATION ${PLUGIN_PATH_DEST} COMPONENT ${pamf_COMPONENT})
+                    get_filename_component(pluginName ${PLUGIN_PATH_NAME} NAME)
+                    if(IS_ABSOLUTE ${PLUGIN_PATH_DEST})
+                    else()
+                        set(PLUGIN_PATH_DEST ${inst_run_INSTALL_FOLDER}/${PLUGIN_PATH_DEST})
+                    endif()
+                    list(APPEND pluginsList ${PLUGIN_PATH_DEST}/${pluginName})
+                endif()
+            else()
+                message(WARNING "You need to provide a valid PLUGIN_PATH_NAME")
+                set(pluginsList )
+            endif()
+        endforeach()
+        set(${results} ${pluginsList} PARENT_SCOPE)
+    endfunction()
+
+    if(inst_run_VERBOSE)
+        list(APPEND extra_flags_to_add VERBOSE)
+    endif()
+    list(APPEND extra_flags_to_add EXEC_PATH ${EXEC_PATH} COMPONENT ${inst_run_COMPONENT}) ## for internal use inside overloaded function
+    list(LENGTH inst_run_PLUGINS inst_run_PLUGINS_count)
+    if(${inst_run_PLUGINS_count} GREATER 0)
+        parse_arguments_multi(PLUGIN_PATH_NAME inst_run_PLUGINS ${inst_run_PLUGINS} ## see internal overload parse_arguments_multi_function for processing each sub-list
+                                NEED_RESULTS ${inst_run_PLUGINS_count}  ## this is used to check when we are in the first loop (in order to reset parse_arguments_multi_results)
+                                EXTRAS_FLAGS ${extra_flags_to_add}      ## this is used to allow catching additional internal flags of our overloaded function
+        )
+    endif()
+
+    #message(parse_arguments_multi_results = ${parse_arguments_multi_results})
+    list(APPEND pluginsList ${parse_arguments_multi_results})
+
+
+
+	## Install rules for required system runtimes such as MSVCRxx.dll
+	set(CMAKE_INSTALL_SYSTEM_RUNTIME_LIBS_SKIP ON)
+	include(InstallRequiredSystemLibraries)
+	if(CMAKE_INSTALL_SYSTEM_RUNTIME_LIBS)
+		install(FILES 			${CMAKE_INSTALL_SYSTEM_RUNTIME_LIBS}
+				CONFIGURATIONS 	${inst_run_CONFIG_TYPE}
+				DESTINATION 	${EXEC_PATH}
+				COMPONENT   	${inst_run_COMPONENT}
+		)
+	endif()
+
+	## print what we are doing to do
+	if(inst_run_VERBOSE)
+		message(STATUS "[install_runtime] On install target call, cmake will try to resolve dependencies for given app:\n ${installedFilePathTargetAppToResolve} (with plausible postfix: ${inst_run_PLAUSIBLES_POSTFIX})")
+		if(pluginsList)
+			message(STATUS "   and also for plugins :")
+			foreach(plugin ${pluginsList})
+				message(STATUS "      ${plugin}")
+			endforeach()
+		endif()
+		message(STATUS "   Looking for dependencies into:")
+		foreach(dir ${dirsToLookFor})
+			message(STATUS "      ${dir}")
+		endforeach()
+	endif()
+
+	## Install rules for required dependencies libs/plugins for the target app
+	## will resolve all installed target files with config modes postfixes
+	string(TOUPPER ${inst_run_CONFIG_TYPE} inst_run_CONFIG_TYPE_UC)
+	get_target_property(postfix ${inst_run_TARGET} "${inst_run_CONFIG_TYPE_UC}_POSTFIX")
+	install(CODE "set(target 						\"${inst_run_TARGET}\")" 												COMPONENT ${inst_run_COMPONENT}  CONFIGURATIONS ${CONFIG_TYPE})
+	install(CODE "set(inst_run_CONFIG_TYPE 			\"${inst_run_CONFIG_TYPE}\")" 											COMPONENT ${inst_run_COMPONENT}  CONFIGURATIONS ${CONFIG_TYPE})
+	install(CODE "set(inst_run_INSTALL_FOLDER 		\"${inst_run_INSTALL_FOLDER}\")" 										COMPONENT ${inst_run_COMPONENT}  CONFIGURATIONS ${CONFIG_TYPE})
+	install(CODE "set(app	 						\"${EXEC_PATH}/${EXEC_NAME}${postfix}${CMAKE_EXECUTABLE_SUFFIX}\")" 	COMPONENT ${inst_run_COMPONENT}  CONFIGURATIONS ${CONFIG_TYPE})
+	install(CODE "set(dirsToLookFor 				\"${dirsToLookFor}\")" 													COMPONENT ${inst_run_COMPONENT}  CONFIGURATIONS ${CONFIG_TYPE})
+	install(CODE
+		[[
+			if("${CMAKE_INSTALL_CONFIG_NAME}" STREQUAL "${inst_run_CONFIG_TYPE}")
+				message(STATUS "Installing ${target} dependencies...")
+
+				file(GET_RUNTIME_DEPENDENCIES
+					EXECUTABLES ${app}
+					RESOLVED_DEPENDENCIES_VAR _r_deps
+					UNRESOLVED_DEPENDENCIES_VAR _u_deps
+					CONFLICTING_DEPENDENCIES_PREFIX _c_deps
+					DIRECTORIES ${dirsToLookFor}
+					PRE_EXCLUDE_REGEXES "api-ms-*"
+					POST_EXCLUDE_REGEXES ".*system32/.*\\.dll" ".*SysWOW64/.*\\.dll"
+				)
+			
+				if(_u_deps)
+					message(WARNING "There were unresolved dependencies for executable ${EXEC_FILE}: \"${_u_deps}\"!")
+				endif()
+				if(_c_deps_FILENAMES)
+					message(WARNING "There were conflicting dependencies for executable ${EXEC_FILE}: \"${_c_deps_FILENAMES}\"!")
+				endif()
+			
+				foreach(_file ${_r_deps})
+					file(INSTALL
+					DESTINATION "${inst_run_INSTALL_FOLDER}/bin"
+					TYPE SHARED_LIBRARY
+					FOLLOW_SYMLINK_CHAIN
+					FILES "${_file}"
+				)
+				endforeach()
+			endif()
+		]]
+	   COMPONENT ${inst_run_COMPONENT} CONFIGURATIONS ${CONFIG_TYPE}
+	)
+
+endfunction()
+
+## High level macro to install resources in the correct folder
+##
+## EXECUTABLE: [opt] option to copy files as programs
+## RELATIVE  : [opt] copy files relatively to current folder
+## TYPE      : [opt] type and folder where to store the files
+## FOLDER    : [opt] subfolder to use
+## FILES     : [opt] contains a list of resources files to copy to install folder
+macro(ibr_install_rsc target)
+	cmake_parse_arguments(install_rsc_${target} "EXECUTABLE;RELATIVE" "TYPE;FOLDER" "FILES" ${ARGN})
+	set(rsc_target "${target}_${install_rsc_${target}_TYPE}")
+
+	if(install_rsc_${target}_FOLDER)
+		set(rsc_folder "${install_rsc_${target}_TYPE}/${install_rsc_${target}_FOLDER}")
+	else()
+		set(rsc_folder "${install_rsc_${target}_TYPE}")
+	endif()
+
+	add_custom_target(${rsc_target}
+					COMMENT "run the ${install_rsc_${target}_TYPE} installation only for ${target} (component ${rsc_target})"
+					VERBATIM)
+	foreach(scriptFile ${install_rsc_${target}_FILES})
+		if(install_rsc_${target}_RELATIVE)
+			file(RELATIVE_PATH relativeFilename ${CMAKE_CURRENT_SOURCE_DIR} ${scriptFile})
+		else()
+			get_filename_component(relativeFilename ${scriptFile} NAME)
+		endif()
+
+		if(DEFINED CMAKE_BUILD_TYPE)						## for make/nmake based
+			add_custom_command(TARGET ${rsc_target} POST_BUILD
+							COMMAND ${CMAKE_COMMAND} -E
+							copy_if_different ${scriptFile} ${CMAKE_INSTALL_PREFIX_${CMAKE_BUILD_TYPE}}/${rsc_folder}/${relativeFilename})
+		endif()
+		foreach(CONFIG_TYPES ${CMAKE_CONFIGURATION_TYPES}) 	## for multi config types (MSVC based)
+			string(TOUPPER ${CONFIG_TYPES} CONFIG_TYPES_UC)
+			add_custom_command(TARGET ${rsc_target} POST_BUILD
+							COMMAND ${CMAKE_COMMAND} -E
+							copy_if_different ${scriptFile} ${CMAKE_INSTALL_PREFIX_${CONFIG_TYPES_UC}}/${rsc_folder}/${relativeFilename})
+		endforeach()
+	endforeach()
+
+	get_target_property(INSTALL_RSC_BUILD_FOLDER ${target} FOLDER)
+	set_target_properties(${rsc_target} PROPERTIES FOLDER ${INSTALL_RSC_BUILD_FOLDER})
+
+	add_dependencies(${target} ${rsc_target})
+	add_dependencies(PREBUILD ${rsc_target})
+
+	if(DEFINED CMAKE_BUILD_TYPE)						## for make/nmake based
+		resourceFile(ADD ${rsc_folder} CONFIG_TYPE ${CMAKE_BUILD_TYPE} FILE_PATH "${CMAKE_INSTALL_PREFIX_${CMAKE_BUILD_TYPE}}/ibr_resources.ini")
+		
+		if(install_rsc_${target}_EXECUTABLE)
+			install(
+				PROGRAMS ${install_rsc_${target}_FILES}
+				CONFIGURATIONS ${CMAKE_BUILD_TYPE}
+				DESTINATION "${CMAKE_INSTALL_PREFIX_${CMAKE_BUILD_TYPE}}/${rsc_folder}"
+			)
+		else()
+			install(
+				FILES ${install_rsc_${target}_FILES}
+				CONFIGURATIONS ${CMAKE_BUILD_TYPE}
+				DESTINATION "${CMAKE_INSTALL_PREFIX_${CMAKE_BUILD_TYPE}}/${rsc_folder}"
+			)
+		endif()
+	endif()
+	foreach(CONFIG_TYPES ${CMAKE_CONFIGURATION_TYPES}) 	## for multi config types (MSVC based)
+		string(TOUPPER ${CONFIG_TYPES} CONFIG_TYPES_UC)
+		resourceFile(ADD ${rsc_folder} CONFIG_TYPE ${CONFIG_TYPES} FILE_PATH "${CMAKE_INSTALL_PREFIX_${CONFIG_TYPES_UC}}/ibr_resources.ini")
+		
+		if(install_rsc_${target}_EXECUTABLE)
+			install(
+				PROGRAMS ${install_rsc_${target}_FILES}
+				CONFIGURATIONS ${CONFIG_TYPES}
+				DESTINATION "${CMAKE_INSTALL_PREFIX_${CONFIG_TYPES_UC}}/${rsc_folder}"
+			)
+		else()
+			install(
+				FILES ${install_rsc_${target}_FILES}
+				CONFIGURATIONS ${CONFIG_TYPES}
+				DESTINATION "${CMAKE_INSTALL_PREFIX_${CONFIG_TYPES_UC}}/${rsc_folder}"
+			)
+		endif()
+	endforeach()
+endmacro()
+
+
+## High level macro to install in an homogen way all our ibr targets (it use some functions inside this file)
+##
+## RSC_FILE_ADD : [opt] is used to auto write/append relative paths of target resources into a common file
+## INSTALL_PDB  : [opt] is used to auto install PDB file (when using MSVC according to the target type)
+## STANDALONE   : [opt] bool ON/OFF var to call install_runtime or not (for bundle resolution)
+##       DIRS   : [opt] used if STANDALONE set to ON, see install_runtime doc
+##       PLUGINS: [opt] used if STANDALONE set to ON, see install_runtime doc
+## MSVC_CMD     : [opt] used to specify an absolute filePathName application to launch with the MSVC IDE Debugger associated to this target (project file)
+## MSVC_ARGS    : [opt] load the MSVC debugger with correct settings (app path, args, working dir)
+##
+macro(ibr_install_target target)
+	cmake_parse_arguments(ibrInst${target} "VERBOSE;INSTALL_PDB" "COMPONENT;MSVC_ARGS;STANDALONE;RSC_FOLDER" "SHADERS;RESOURCES;SCRIPTS;DIRS;PLUGINS" ${ARGN})
+	
+	if(ibrInst${target}_RSC_FOLDER)
+		set(rsc_folder "${ibrInst${target}_RSC_FOLDER}")
+	else()
+		set(rsc_folder "${target}")
+	endif()
+
+	if(ibrInst${target}_SHADERS)
+		ibr_install_rsc(${target} EXECUTABLE TYPE "shaders" FOLDER ${rsc_folder} FILES "${ibrInst${target}_SHADERS}")
+    endif()
+	
+	if(ibrInst${target}_RESOURCES)
+		ibr_install_rsc(${target} TYPE "resources" FOLDER ${rsc_folder} FILES "${ibrInst${target}_RESOURCES}")
+    endif()
+	
+	if(ibrInst${target}_SCRIPTS)
+		ibr_install_rsc(${target} EXECUTABLE TYPE "scripts" FOLDER ${rsc_folder} FILES "${ibrInst${target}_SCRIPTS}")
+    endif()
+
+    if(ibrInst${target}_COMPONENT)
+        set(installCompArg COMPONENT ${ibrInst${target}_COMPONENT})
+        ## Create a custom install target based on COMPONENT
+        installTargetProject(${target} ${ibrInst${target}_COMPONENT})
+	endif()
+	
+	if(DEFINED CMAKE_BUILD_TYPE)						## for make/nmake based
+		set_target_properties(${target} PROPERTIES ${CMAKE_BUILD_TYPE}_POSTFIX 	"${CMAKE_${CMAKE_BUILD_TYPE}_POSTFIX}")
+		get_target_property(CURRENT_TARGET_BUILD_TYPE_POSTFIX ${target} ${CMAKE_BUILD_TYPE}_POSTFIX)
+	endif()
+	foreach(CONFIG_TYPES ${CMAKE_CONFIGURATION_TYPES}) 	## for multi config types (MSVC based)
+		string(TOUPPER ${CONFIG_TYPES} CONFIG_TYPES_UC)
+		set_target_properties(${target} PROPERTIES ${CONFIG_TYPES_UC}_POSTFIX 	"${CMAKE_${CONFIG_TYPES_UC}_POSTFIX}")
+		get_target_property(CURRENT_TARGET_BUILD_TYPE_POSTFIX ${target} ${CONFIG_TYPES_UC}_POSTFIX)
+	endforeach()
+
+	## Specify default installation rules
+	if(DEFINED CMAKE_BUILD_TYPE)						## for make/nmake based
+		install(TARGETS	${target}
+			CONFIGURATIONS ${CMAKE_BUILD_TYPE}
+			LIBRARY		DESTINATION ${CMAKE_LIBRARY_OUTPUT_DIRECTORY_${CMAKE_BUILD_TYPE}} ${installCompArg}
+			ARCHIVE		DESTINATION ${CMAKE_ARCHIVE_OUTPUT_DIRECTORY_${CMAKE_BUILD_TYPE}} ${installCompArg}
+			RUNTIME 	DESTINATION ${CMAKE_RUNTIME_OUTPUT_DIRECTORY_${CMAKE_BUILD_TYPE}} ${installCompArg}
+		)
+		install(TARGETS	${target}
+			CONFIGURATIONS ${CMAKE_BUILD_TYPE}
+			LIBRARY		DESTINATION ${CMAKE_RUNTIME_OUTPUT_DIRECTORY_${CMAKE_BUILD_TYPE}} ${installCompArg}
+			ARCHIVE		DESTINATION ${CMAKE_RUNTIME_OUTPUT_DIRECTORY_${CMAKE_BUILD_TYPE}} ${installCompArg}
+		)
+	endif()
+	foreach(CONFIG_TYPES ${CMAKE_CONFIGURATION_TYPES}) 	## for multi config types (MSVC based)
+		string(TOUPPER ${CONFIG_TYPES} CONFIG_TYPES_UC)
+		install(TARGETS	${target}
+			CONFIGURATIONS ${CONFIG_TYPES}
+			LIBRARY		DESTINATION ${CMAKE_LIBRARY_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC}} ${installCompArg}
+			ARCHIVE		DESTINATION ${CMAKE_ARCHIVE_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC}} ${installCompArg}
+			RUNTIME 	DESTINATION ${CMAKE_RUNTIME_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC}} ${installCompArg}
+		)
+		install(TARGETS	${target}
+			CONFIGURATIONS ${CONFIG_TYPES}
+			LIBRARY		DESTINATION ${CMAKE_RUNTIME_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC}} ${installCompArg}
+			ARCHIVE		DESTINATION ${CMAKE_RUNTIME_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC}} ${installCompArg}
+		)
+	endforeach()
+
+    if(ibrInst${target}_INSTALL_PDB)
+        if(DEFINED CMAKE_BUILD_TYPE)						## for make/nmake based
+			installPDB(${target} ${CMAKE_BUILD_TYPE}
+				LIBRARY_DEST ${CMAKE_LIBRARY_OUTPUT_DIRECTORY_${CMAKE_BUILD_TYPE}}
+				ARCHIVE_DEST ${CMAKE_ARCHIVE_OUTPUT_DIRECTORY_${CMAKE_BUILD_TYPE}}
+				RUNTIME_DEST ${CMAKE_RUNTIME_OUTPUT_DIRECTORY_${CMAKE_BUILD_TYPE}}
+			)
+        endif()
+        foreach(CONFIG_TYPES ${CMAKE_CONFIGURATION_TYPES}) 	## for multi config types (MSVC based)
+			string(TOUPPER ${CONFIG_TYPES} CONFIG_TYPES_UC)
+			installPDB(${target} ${CONFIG_TYPES}
+				LIBRARY_DEST ${CMAKE_LIBRARY_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC}}
+				ARCHIVE_DEST ${CMAKE_ARCHIVE_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC}}
+				RUNTIME_DEST ${CMAKE_RUNTIME_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC}}
+			)
+        endforeach()
+    endif()
+
+    ## install dynamic necessary dependencies
+    if(ibrInst${target}_STANDALONE)
+        get_target_property(type ${target} TYPE)
+        if(${type} MATCHES "EXECUTABLE")
+
+            if(ibrInst${target}_VERBOSE)
+                set(VERBOSE VERBOSE)
+            else()
+                set(VERBOSE )
+			endif()
+			
+			if(DEFINED CMAKE_BUILD_TYPE)						## for make/nmake based
+				install_runtime(bin/${target}${CMAKE_EXECUTABLE_SUFFIX} ## default relative to CMAKE_INSTALL_PREFIX
+					INSTALL_FOLDER		"${CMAKE_INSTALL_PREFIX_${CMAKE_BUILD_TYPE}}"
+					CONFIG_TYPE			${CMAKE_BUILD_TYPE}
+					${VERBOSE}
+					TARGET              ${target}
+					${installCompArg}
+					PLUGINS	## will be installed
+										${ibrInst${target}_PLUGINS}
+					DIRS				${CMAKE_RUNTIME_OUTPUT_DIRECTORY_${CMAKE_BUILD_TYPE}}
+										${ibrInst${target}_DIRS}
+				)
+			endif()
+			foreach(CONFIG_TYPES ${CMAKE_CONFIGURATION_TYPES}) 	## for multi config types (MSVC based)
+				string(TOUPPER ${CONFIG_TYPES} CONFIG_TYPES_UC)
+				install_runtime(bin/${target}${CMAKE_EXECUTABLE_SUFFIX} ## default relative to CMAKE_INSTALL_PREFIX
+					INSTALL_FOLDER		"${CMAKE_INSTALL_PREFIX_${CONFIG_TYPES_UC}}"
+					CONFIG_TYPE			${CONFIG_TYPES}
+					${VERBOSE}
+					TARGET              ${target}
+					${installCompArg}
+					PLUGINS	## will be installed
+										${ibrInst${target}_PLUGINS}
+					DIRS				${CMAKE_RUNTIME_OUTPUT_DIRECTORY_${CONFIG_TYPES_UC}}
+										${ibrInst${target}_DIRS}
+				)
+			endforeach()
+        else()
+            message(WARNING "STANDALONE option is only compatible with EXECUTABLES target type. Skip the STANDALONE installation process.")
+        endif()
+    endif()
+
+    ## Provide a way to directly load the MSVC debugger with correct settings
+    if(MSVC)
+        if(ibrInst${target}_MSVC_CMD)  ## command absolute filePathName is optional as the default is to use the installed target file application
+            set(msvcCmdArg  COMMAND ${ibrInst${target}_MSVC_CMD}) ## flag following by the value (both to pass to the MSVCsetUserCommand function)
+        endif()
+        if(ibrInst${target}_MSVC_ARGS) ## args (between quotes) are optional
+            set(msvcArgsArg ARGS ${ibrInst${target}_MSVC_ARGS})   ## flag following by the value (both to pass to the MSVCsetUserCommand function)
+        endif()
+        get_target_property(type ${target} TYPE)
+        if( (ibrInst${target}_MSVC_CMD OR ibrInst${target}_MSVC_ARGS) OR (${type} MATCHES "EXECUTABLE") )
+			include(MSVCsetUserCommand)
+			if(DEFINED CMAKE_BUILD_TYPE)						## for make/nmake based
+				MSVCsetUserCommand(	${target}
+					PATH 			${CMAKE_OUTPUT_BIN_${CMAKE_BUILD_TYPE}} ##FILE option not necessary since it deduced from targetName
+									ARGS				"${SIBR_PROGRAMARGS}"
+					${msvcCmdArg}
+					#${msvcArgsArg}
+					WORKING_DIR		${CMAKE_OUTPUT_BIN_${CMAKE_BUILD_TYPE}}
+				)
+			endif()
+			foreach(CONFIG_TYPES ${CMAKE_CONFIGURATION_TYPES}) 	## for multi config types (MSVC based)
+				string(TOUPPER ${CONFIG_TYPES} CONFIG_TYPES_UC)
+				MSVCsetUserCommand(	${target}
+					PATH 			${CMAKE_OUTPUT_BIN_${CONFIG_TYPES_UC}} ##FILE option not necessary since it deduced from targetName
+									ARGS				"${SIBR_PROGRAMARGS}"
+					${msvcCmdArg}
+					#${msvcArgsArg}
+					WORKING_DIR		${CMAKE_OUTPUT_BIN_${CONFIG_TYPES_UC}}
+				)
+			endforeach()
+        elseif(NOT ${type} MATCHES "EXECUTABLE")
+            #message("Cannot set MSVCsetUserCommand with target ${target} without COMMAND parameter as it is not an executable (skip it)")
+        endif()
+    endif()
+
+endmacro()

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/parse_arguments_multi.cmake

@@ -0,0 +1,304 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+if(NOT WIN32 OR __parse_arguments_multi_cmake_INCLUDED__)
+	return()
+else()
+	set(__parse_arguments_multi_cmake_INCLUDED__ ON)
+endif()
+
+## This macro allow to process repeating multi value args from a given function which use cmake_parse_arguments module.
+##
+## cmake_parse_arguments multi args standard behavior:
+##    function(foo)
+##        cmake_parse_arguments(arg "" "" "MULTI" ${ARGN})
+##        foreach(item IN LISTS arg_MULTI)
+##            message(STATUS "${item}")
+##        endforeach()
+##    endfunction()
+##    foo(MULTI x y MULTI z w)
+##  The above code outputs 'z' and 'w'. It originally expected it to output all of 'x' 'y' 'z' 'w'.
+##
+## Using this macro inside a function which want to handle repeating multi args values
+## will recursively iterate onto the multi tags list to process each sub list.
+## It take as 1st argument the subTag flag to separate sub list from the main multi list.
+## It take as 2nd argument the nameList of the main multi list (the multiValuesArgs from cmake_parse_arguments: here it is MULTI in the example)
+## and that's why it is important that it should be a macro and not a function (to get access to external variable).
+## Then you give the content of this list allowing to be processed by the macro.
+##
+## parse_arguments_multi macro call a parse_arguments_multi_function which do actually the process from the given sub-list.
+## By default this function only print infos about what variables you are trying to pass/process (only verbose messages),
+## but, by overloading this cmake function, you will be able to externalize the process of your multi argument list.
+##
+## Usage (into a function) : 
+## parse_arguments_multi(<multiArgsSubTag> <multiArgsList> <multiArgsListContent> 
+##      [NEED_RESULTS <multiArgsListSize>] [EXTRAS_FLAGS <...> <...> ...]
+## )
+##
+## Simple usage example [user point of view]:
+## foo(MULTI
+##    SUB_MULTI x y
+##    SUB_MULTI z w
+## )
+##
+## Simple usage example [inside a function]:
+##    function(foo)
+##        cmake_parse_arguments(arg "" "" "MULTI" ${ARGN})
+##        include(parse_arguments_multi)
+##        function(parse_arguments_multi_function )
+##          #message("I'm an overloaded cmake function used by parse_arguments_multi")
+##          #message("I'm processing first part of my sub list: ${ARGN}")
+##          message("ARGV0=${ARGV0}")
+##          message("ARGV1=${ARGV1}")
+##        endfunction()
+##        parse_arguments_multi(SUB_MULTI arg_MULTI ${arg_MULTI}) ## this function will process recusively items of the sub-list [default print messages]
+##    endfunction()
+##
+##  Will print:
+##      ARGV0=z
+##      ARGV1=w
+##      ARGV0=x
+##      ARGV1=y
+##
+## WARNING : DO NEVER ADD EXTRA THINGS TO parse_arguments_multi MACRO :
+##          parse_arguments_multi(SUB_MULTI arg_MULTI ${arg_MULTI} EXTRAS foo bar SOMTHING) => will failed !!
+## use EXTRAS_FLAGS instead !!
+##
+## Advanced usage example [user point of view]:
+## bar(C:/prout/test.exe VERBOSE 
+##      PLUGINS
+##          PLUGIN_PATH_NAME x      PLUGIN_PATH_DEST w
+##          PLUGIN_PATH_NAME a b    PLUGIN_PATH_DEST y
+##          PLUGIN_PATH_NAME c
+## )
+##
+## Advanced usage example [inside a function]:
+##    function(bar execFilePathName)
+##        cmake_parse_arguments(arg "VERBOSE" "" "PLUGINS" ${ARGN})
+##
+##        include(parse_arguments_multi)
+##        function(parse_arguments_multi_function results)
+##            cmake_parse_arguments(pamf "VERBOSE" "PLUGIN_PATH_DEST;EXEC_PATH" "" ${ARGN}) ## EXEC_PATH is for internal use
+##            message("")
+##            message("I'm an overloaded cmake function used by parse_arguments_multi from install_runtime function")
+##            message("I'm processing first part of my sub list: ${ARGN}")
+##            message("PLUGIN_PATH_NAME = ${pamf_UNPARSED_ARGUMENTS}")
+##            message(pamf_VERBOSE = ${pamf_VERBOSE})
+##            message("pamf_PLUGIN_PATH_DEST = ${pamf_PLUGIN_PATH_DEST}")
+##            message(pamf_EXEC_PATH = ${pamf_EXEC_PATH})
+##            if(NOT ${pamf_PLUGIN_PATH_DEST})
+##              set(pamf_PLUGIN_PATH_DEST ${pamf_EXEC_PATH})
+##            endif()
+##            foreach(plugin ${pamf_UNPARSED_ARGUMENTS})
+##              get_filename_component(pluginName ${plugin} NAME)
+##              list(APPEND pluginsList ${pamf_PLUGIN_PATH_DEST}/${pluginName})
+##            endforeach()
+##            set(${results} ${pluginsList} PARENT_SCOPE)
+##        endfunction()
+##
+##        if(arg_VERBOSE)
+##            list(APPEND extra_flags_to_add VERBOSE) ## here we transmit the VERNOSE flag
+##        endif()
+##        get_filename_component(EXEC_PATH ${execFilePathName} PATH) ## will be the default value if PLUGIN_PATH_DEST option is not provided
+##        list(APPEND extra_flags_to_add EXEC_PATH ${EXEC_PATH})  
+##        list(LENGTH arg_PLUGINS arg_PLUGINS_count)
+##        parse_arguments_multi(PLUGIN_PATH_NAME arg_PLUGINS ${arg_PLUGINS}
+##                            NEED_RESULTS ${arg_PLUGINS_count}  ## this is used to check when we are in the first loop (in order to reset parse_arguments_multi_results)
+##                            EXTRAS_FLAGS ${extra_flags_to_add} ## this is used to allow catching VERBOSE and PLUGIN_PATH_DEST flags of our overloaded function
+##        )
+##    endfunction()
+##    message(parse_arguments_multi_results = ${parse_arguments_multi_results}) ## list of the whole pluginsList
+##    #Will print w/x;a/y;b/y;C:/prout/c
+##
+##  NOTE that here, since our overloaded function need to provide a result list, we use the other parse_arguments_multi_function signature (the which one with a results arg)
+##
+
+function(parse_arguments_multi_function_default) ## used in case of you want to reset the default behavior of this function process
+    message("[default function] parse_arguments_multi_function(ARGC=${ARGC} ARGV=${ARGV} ARGN=${ARGN})")
+    message("This function is used by parse_arguments_multi and have to be overloaded to process sub list of multi values args")
+endfunction()
+
+function(parse_arguments_multi_function )   ## => the function to overload
+    parse_arguments_multi_function_default(${ARGN})
+endfunction()
+
+## first default signature above
+##------------------------------
+## second results signature behind
+
+function(parse_arguments_multi_function_default result) ## used in case of you want to reset the default behavior of this function process
+    message("[default function] parse_arguments_multi_function(ARGC=${ARGC} ARGV=${ARGV} ARGN=${ARGN})")
+    message("This function is used by parse_arguments_multi and have to be overloaded to process sub list of muluti values args")
+endfunction()
+
+function(parse_arguments_multi_function result)   ## => the function to overload
+    parse_arguments_multi_function_default(result ${ARGN})
+endfunction()
+
+## => the macro to use inside your function which use cmake_parse_arguments
+# NOTE: entry point of parse_arguments_multi, which is called from win3rdPart)
+macro(parse_arguments_multi multiArgsSubTag multiArgsList #<${multiArgsList}> the content of the list
+)
+    # message (STATUS "")
+    # message(STATUS "calling parse_arguemnts_multi defined in parse_arguments_multi.cmake:141")
+    # message(STATUS "multiArgsSubTag = ${multiArgsSubTag}")	# CHECK_CACHED_VAR
+    # message(STATUS "multiArgsList = ${multiArgsList}")	# it contains the name of the variable which is holding the list i.e w3p_MULTI_SET
+    # message(STATUS "value of ${multiArgsList} = ${${multiArgsList}}") # a semicolon separated list of values passed to SET or MULTISET keyword in win3rdParty
+    # message(STATUS "actual values ARGN = ${ARGN}")  # the same as ${${multiArgsList}}
+
+    ## INFO
+    ## starting from CMake 3.5 cmake_parse_arguments is not a module anymore and now is a native CMake command.
+    ## the behaviour is different though
+    ## In CMake 3.4, if you pass multiple times a multi_value_keyword, CMake returns the values of the LAST match
+    ## In CMake 3.5 and above, CMake returns the whole list of values that were following that multi_value_keyword
+    ## example:
+    ## cmake_parse_arguments(
+    ##			<prefix>
+    ##			""		# options
+    ##			""		# one value keywords
+    ##			"MY_MULTI_VALUE_TAG"
+    ##				MY_MULTI_VALUE_TAG value1 value2
+    ##				MY_MULTI_VALUE_TAG value3 value4
+    ##				MY_MULTI_VALUE_TAG value5 value6
+    ##			)
+    ## result in CMake 3.4
+    ## <prefix>_MY_MULTI_VALUE_TAG = "value5;value6"
+    ##
+    ## result in CMake 3.8
+    ## <prefix>_MY_MULTI_VALUE_TAG = "value5;value6"
+
+    #include(CMakeParseArguments) #module CMakeParseArguments is obsolete since cmake 3.5
+    # cmake_parse_arguments (<prefix> <options> <one_value_keywords> <multi_value_keywords> args)
+    # <options> : options (flags) pass to the macro
+    # <one_value_keywords> : options that neeed a value
+    # <multi_value_keywords> : options that neeed more than one value
+    cmake_parse_arguments(_pam "" "NEED_RESULTS" "${multiArgsSubTag};EXTRAS_FLAGS" ${ARGN})
+    
+    ## multiArgsList is the name of the list used by the multiValuesOption flag from the cmake_parse_arguments of the user function
+    ## that's why we absolutly need to use MACRO here (and also for passing parse_arguments_multi_results when NEED_RESULTS flag is set)
+    
+    ## for debugging
+    #message("")
+    #message("[parse_arguments_multi] => ARGN = ${ARGN}")
+    #message("_pam_NEED_RESULTS=${_pam_NEED_RESULTS}")
+    #message("_pam_EXTRAS_FLAGS=${_pam_EXTRAS_FLAGS}")
+    # foreach(var ${_pam_${multiArgsSubTag}})
+    #     message("arg=${var}")
+    # endforeach()
+
+    if (${CMAKE_VERSION} VERSION_GREATER "3.5")
+        # lets make ${_pam_${multiArgsSubTag}} behave as it is in version 3.4
+        # that means, cmake_parse_arguments should have only the last values of a multi set for a given keyword
+
+        # message("")
+        # message("values in multiArgsList")
+        # foreach(val ${${multiArgsList}})
+        #     message(STATUS ${val})
+        # endforeach()
+        # message("end values in multiArgsList")
+
+
+        set(lastIndexFound OFF)
+        list(LENGTH ${multiArgsList} argnLength)
+        # message(${argnLength})
+        math(EXPR argnLength "${argnLength}-1")             # make last index a valid one
+        set(recordIndex 0)
+        set(records "")                                     # clear records list
+        set(record0 "")                                    # clear first record list
+        foreach(iter RANGE ${argnLength})
+            list(GET ${multiArgsList} ${iter} value)
+            # message(STATUS "index=${iter} value=${value}")
+            if (${value} STREQUAL ${multiArgsSubTag})
+                if (lastIndexFound)
+                    list(APPEND records ${recordIndex})    # records store the list NAMES
+                    math(EXPR recordIndex "${recordIndex}+1")
+                    set(record${recordIndex} "")            # clear record list
+                else ()
+                    set(lastIndexFound ON)
+                endif()
+
+                set(lastIndex ${iter})
+            else ()
+                if (lastIndexFound)
+                    # message(${value})
+                    list(APPEND record${recordIndex} ${value})
+                endif()
+            endif()
+        endforeach()
+
+        # save the last list of values
+        if (lastIndexFound)
+            list(APPEND records ${recordIndex})    # records store the list NAMES
+        endif()
+
+        # set multiArgsList to make it behave like CMake 3.4
+        # message("")
+        # message("using my records")
+        foreach(recordName ${records})
+            # message(${recordName})
+            # foreach(value ${record${recordName}})
+            #     message(${value})
+            # endforeach()
+            # message("")
+            set(_pam_${multiArgsSubTag} ${record${recordName}})
+        endforeach()
+        # message(${_pam_${multiArgsSubTag}})
+
+        # message("")
+        # message("using argn")
+        # foreach(value ${ARGN})
+        #     message(${value})
+        # endforeach()
+    endif() # end if cmake > 3.5
+
+    # message("values with pam ${_pam_${multiArgsSubTag}}")
+
+    ## check and init
+    list(LENGTH ${multiArgsList} globalListCount)	# GLUT_TRACE: globalListCound=16 in CMake3.4 and CMake3.8
+    # message(STATUS "nr items in multiArgsList: ${globalListCount}")
+    math(EXPR globalListCount "${globalListCount}-1") ## because it will contain [multiArgsSubTag + ${multiArgsList}]
+    if(_pam_NEED_RESULTS)
+        if(${globalListCount} EQUAL ${_pam_NEED_RESULTS})
+            ## first time we enter into this macro (because we call it recursively)
+            unset(parse_arguments_multi_results)
+        endif()
+    endif()
+    
+    ## process the part of the multi agrs list
+    ## ${ARGN} shouldn't be passed to the function in order to avoid missmatch size list ${multiArgsList} and _pam_${multiArgsSubTag}
+    ## if you want to pass extra internal flags from your function to this callback, use EXTRAS_FLAGS
+    if(_pam_NEED_RESULTS)
+        parse_arguments_multi_function(parse_arguments_multi_function_result ${_pam_${multiArgsSubTag}} ${_pam_EXTRAS_FLAGS})
+        list(APPEND parse_arguments_multi_results ${parse_arguments_multi_function_result})
+    else()
+        # message(STATUS "about to call parse_arguments_multi_function in parse_arguments_multi.cmake:177 ${_pam_${multiArgsSubTag}} and extra flags ${_pam_EXTRAS_FLAGS}")
+        parse_arguments_multi_function(${_pam_${multiArgsSubTag}} ${_pam_EXTRAS_FLAGS})
+    endif()
+
+    ## remove just processed items from the main list to process (multiArgsList)
+    list(REVERSE ${multiArgsList})
+    list(LENGTH _pam_${multiArgsSubTag} subTagListCount)
+    unset(ids)
+    foreach(id  RANGE ${subTagListCount})
+         list(APPEND ids ${id})
+    endforeach()
+    list(REMOVE_AT  ${multiArgsList} ${ids})
+    list(REVERSE    ${multiArgsList})
+    
+    ## test if remain sub multi list to process (recursive call) or finish the process
+    list(LENGTH ${multiArgsList} mainTagListCount)
+    if(${mainTagListCount} GREATER 1)
+        ## do not pass ${ARGN} just because it will re pass the initial 2 inputs args and we wont as they was consumed (in order to avoir conflicts)
+        # message(STATUS "about to call a parse_arguments_multi but without knowing where the definition is going to be taken from")
+        parse_arguments_multi(${multiArgsSubTag} ${multiArgsList} ${${multiArgsList}} 
+                                NEED_RESULTS ${_pam_NEED_RESULTS} EXTRAS_FLAGS ${_pam_EXTRAS_FLAGS}
+            )
+    endif()
+endmacro()

sugar/gaussian_splatting/SIBR_viewers/cmake/linux/sibr_library.cmake

@@ -0,0 +1,174 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+# NOTE
+# This feature is used to easily download, store and link external dependencies. This
+# requires to prepare pre-compiled libraries (to download). For now, packages have
+# only be prepare for Windows 64-bit with Visual Studio 2012. (You should re-build
+# everything if you want to use another version of Visual Studio/ another compiler).
+
+# NOTE ABOUT UNIX SYSTEMS
+# There is no need for "searching mechanism". This function is discard and your
+# libraries should be installed is the standard folders that are:
+#
+# /usr/include/
+# /usr/lib/
+# /usr/lib64/
+# for packages downloaded using apt-get/yum
+# 
+# /usr/local/include/
+# /usr/local/lib/
+# /usr/local/lib64/
+# for packages manually installed ("make install")
+#
+# if you encounter problems when linking (e.g. lib not found even if it is installed),
+# please check these folders are in your search PATH environment variables.
+
+set(EXTLIBS_PACKAGE_FOLDER "${CMAKE_SOURCE_DIR}/extlibs")
+
+function(sibr_addlibrary)
+    if(NOT WIN32)
+        return()
+    endif()
+
+    file(MAKE_DIRECTORY ${EXTLIBS_PACKAGE_FOLDER})
+    cmake_parse_arguments(args "VCID" "VERBOSE;TIMEOUT;DEFAULT_USE;NAME;VERSION;MSVC11;MSVC12;MSVC14;MSVC17" "MULTI_SET;SET" ${ARGN})
+
+
+    if (NOT "${args_VERSION}" MATCHES "")
+        message(WARNING "VERSION is not implemented yet")
+    endif()
+
+    set(lcname "")
+    set(ucname "")
+    string(TOLOWER "${args_NAME}" lcname)
+    string(TOUPPER "${args_NAME}" ucname)
+
+    set(LIB_PACKAGE_FOLDER "${EXTLIBS_PACKAGE_FOLDER}/${lcname}")
+    win3rdParty(${ucname}
+                    $<args_VCID:VCID>
+                    VERBOSE     ${args_VERBOSE}
+                    TIMEOUT     ${args_TIMEOUT}
+                    DEFAULT_USE ${args_DEFAULT_USE}
+                    MSVC11 "${LIB_PACKAGE_FOLDER}" "${args_MSVC11}"
+                    MSVC12 "${LIB_PACKAGE_FOLDER}" "${args_MSVC12}"
+                    MSVC14 "${LIB_PACKAGE_FOLDER}" "${args_MSVC14}" # TODO SV: make sure to build this library if required
+					MSVC17 "${LIB_PACKAGE_FOLDER}" "${args_MSVC17}"
+                    SET         ${args_SET}
+                    MULTI_SET   ${args_MULTI_SET}
+                )
+			
+    # Add include/ directory
+    # and lib/ directories
+
+    # TODO SV: paths not matching with current hierarchy. example: libraw/libraw-0.17.1/include
+    # SR:	The link directories will also be used to lookup for dependency DLLs to copy in the install directory.
+    #		Some libraries put the DLLs in the bin/ directory, so we include those.
+    file(GLOB subdirs RELATIVE ${LIB_PACKAGE_FOLDER} ${LIB_PACKAGE_FOLDER}/*)
+    set(dirlist "")
+    foreach(dir ${subdirs})
+        if(IS_DIRECTORY ${LIB_PACKAGE_FOLDER}/${dir})
+            # message("adding ${LIB_PACKAGE_FOLDER}/${dir}/include/ to the include directories")
+            include_directories("${LIB_PACKAGE_FOLDER}/${dir}/include/")
+            # message("adding ${LIB_PACKAGE_FOLDER}/${dir}/lib[64] to the link directories")
+            link_directories("${LIB_PACKAGE_FOLDER}/${dir}/")
+            link_directories("${LIB_PACKAGE_FOLDER}/${dir}/lib/")
+            link_directories("${LIB_PACKAGE_FOLDER}/${dir}/lib64/")
+            link_directories("${LIB_PACKAGE_FOLDER}/${dir}/bin/")
+        endif()
+    endforeach()
+
+endfunction()
+
+include(FetchContent)
+include(git_describe)
+include(install_runtime)
+
+function(sibr_gitlibrary)
+    cmake_parse_arguments(args "" "TARGET;GIT_REPOSITORY;GIT_TAG;ROOT_DIR;SOURCE_DIR" "INCLUDE_DIRS" ${ARGN})
+    if(NOT args_TARGET)
+        message(FATAL "Error on sibr_gitlibrary : please define your target name.")
+        return()
+    endif()
+
+    if(NOT args_ROOT_DIR)
+        set(args_ROOT_DIR ${args_TARGET})
+    endif()
+
+    if(NOT args_SOURCE_DIR)
+        set(args_SOURCE_DIR ${args_TARGET})
+    endif()
+
+    if(args_GIT_REPOSITORY AND args_GIT_TAG)
+        if(EXISTS ${CMAKE_SOURCE_DIR}/extlibs/${args_ROOT_DIR}/${args_SOURCE_DIR}/.git)
+            git_describe(
+                PATH ${CMAKE_SOURCE_DIR}/extlibs/${args_ROOT_DIR}/${args_SOURCE_DIR}
+                GIT_URL SIBR_GITLIBRARY_URL
+                GIT_BRANCH SIBR_GITLIBRARY_BRANCH
+                GIT_COMMIT_HASH SIBR_GITLIBRARY_COMMIT_HASH
+                GIT_TAG SIBR_GITLIBRARY_TAG
+            )
+
+            if((SIBR_GITLIBRARY_URL STREQUAL args_GIT_REPOSITORY) AND
+                ((SIBR_GITLIBRARY_BRANCH STREQUAL args_GIT_TAG) OR
+                 (SIBR_GITLIBRARY_TAG STREQUAL args_GIT_TAG) OR
+                 (SIBR_GITLIBRARY_COMMIT_HASH STREQUAL args_GIT_TAG)))
+                message(STATUS "Library ${args_TARGET} already available, skipping.")
+                set(SIBR_GITLIBRARY_DECLARED ON)
+            else()
+                message(STATUS "Adding library ${args_TARGET} from git...")
+            endif()
+        endif()
+
+        FetchContent_Declare(${args_TARGET}
+            GIT_REPOSITORY 	${args_GIT_REPOSITORY}
+            GIT_TAG			${args_GIT_TAG}
+            GIT_SHALLOW		ON
+            SOURCE_DIR 		${CMAKE_SOURCE_DIR}/extlibs/${args_ROOT_DIR}/${args_SOURCE_DIR}
+            SUBBUILD_DIR    ${CMAKE_SOURCE_DIR}/extlibs/${args_ROOT_DIR}/subbuild
+            BINARY_DIR      ${CMAKE_SOURCE_DIR}/extlibs/${args_ROOT_DIR}/build
+        )
+        FetchContent_GetProperties(${args_TARGET})
+        string(TOLOWER "<name>" lcTargetName)
+
+        if((NOT SIBR_GITLIBRARY_DECLARED) AND (NOT ${lcTargetName}_POPULATED))
+            message(STATUS "Populating library ${args_TARGET}...")
+            FetchContent_Populate(${args_TARGET} QUIET
+                GIT_REPOSITORY 	${args_GIT_REPOSITORY}
+                GIT_TAG			${args_GIT_TAG}
+                SOURCE_DIR 		${CMAKE_SOURCE_DIR}/extlibs/${args_ROOT_DIR}/${args_SOURCE_DIR}
+                SUBBUILD_DIR    ${CMAKE_SOURCE_DIR}/extlibs/${args_ROOT_DIR}/subbuild
+                BINARY_DIR      ${CMAKE_SOURCE_DIR}/extlibs/${args_ROOT_DIR}/build
+            )
+        endif()
+
+        add_subdirectory(${CMAKE_SOURCE_DIR}/extlibs/${args_ROOT_DIR}/${args_SOURCE_DIR} ${CMAKE_SOURCE_DIR}/extlibs/${args_ROOT_DIR}/build)
+
+        get_target_property(type ${args_TARGET} TYPE)
+        if(NOT (type STREQUAL "INTERFACE_LIBRARY"))
+            set_target_properties(${args_TARGET} PROPERTIES FOLDER "extlibs")
+
+            ibr_install_target(${args_TARGET}
+                COMPONENT   ${args_TARGET}_install  ## will create custom target to install only this project
+            )
+        endif()
+
+        list(APPEND ${args_TARGET}_INCLUDE_DIRS ${EXTLIBS_PACKAGE_FOLDER}/${args_ROOT_DIR})
+        list(APPEND ${args_TARGET}_INCLUDE_DIRS ${EXTLIBS_PACKAGE_FOLDER}/${args_ROOT_DIR}/${args_SOURCE_DIR})
+
+        foreach(args_INCLUDE_DIR ${args_INCLUDE_DIRS})
+            list(APPEND ${args_TARGET}_INCLUDE_DIRS ${EXTLIBS_PACKAGE_FOLDER}/${args_ROOT_DIR}/${args_SOURCE_DIR}/${args_INCLUDE_DIR})
+        endforeach()
+
+        include_directories(${${args_TARGET}_INCLUDE_DIRS})
+    else()
+        message(FATAL "Error on sibr_gitlibrary for target ${args_TARGET}: missing git tag or git url.")
+    endif()
+endfunction()

sugar/gaussian_splatting/SIBR_viewers/cmake/windows/MSVCsetUserCommand.cmake

@@ -0,0 +1,149 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+if(__MSVCsetUserCommand_cmake_INCLUDED__)
+	return()
+else()
+	set(__MSVCsetUserCommand_cmake_INCLUDED__ ON)
+endif()
+
+## Allow to configure the Debugger settings of visual studio
+## Note: Using this command under linux doesn't affect anything
+## On run Debug Windows local : visual will try to load a specific COMMAND with ARGS in the provided WORKING_DIR
+##
+## usage:
+## MSVCsetUserCommand(	<targetName>
+##    [COMMAND 			<myCustomAppToLaunch> | [ PATH <myCustomDirWhereIsDefaultTargetFileNameToLaunch> [FILE <myCustomExecFileToLaunch>] ] ]
+##    ARGS 				<associatedArguments>
+##    WORKING_DIR		<whereStartTheProgram>
+## )
+##
+## Warning 1 : All arugments () must be passed under quotes
+## Warning 2 : WORKING_DIR path arg have to finish with remain slah '/'
+## Warning 3 : use COMMAND for external app OR PATH (optionaly with FILE) option(s) to set your built/installed/moved target
+##
+## Example 1:
+## include(MSVCsetUserCommand)
+## MSVCsetUserCommand(	UnityRenderingPlugin
+## 	  COMMAND 			"C:/Program Files (x86)/Unity/Editor/Unity.exe"
+## 	  ARGS				"-force-opengl -projectPath \"${CMAKE_HOME_DIRECTORY}/UnityPlugins/RenderingPluginExample/UnityProject\""
+## 	  WORKING_DIR		"${CMAKE_HOME_DIRECTORY}/UnityPlugins/RenderingPluginExample/UnityProject"
+## 	  VERBOSE
+## )
+##
+## Example 2:
+## include(MSVCsetUserCommand)
+## MSVCsetUserCommand(	ibrApp
+## 	  PATH 				"C:/Program Files (x86)/workspace/IBR/install"
+##	  FILE				"ibrApp${CMAKE_EXECUTABLE_SUFFIX}" ## this option line is optional since the target name didn't change between build and install step
+## 	  ARGS				"-path \"${CMAKE_HOME_DIRECTORY}/dataset\""
+## 	  WORKING_DIR		"${CMAKE_HOME_DIRECTORY}"
+## 	  VERBOSE
+## )
+##
+function(MSVCsetUserCommand targetName)
+    cmake_parse_arguments(MSVCsuc "VERBOSE" "PATH;FILE;COMMAND;ARGS;WORKING_DIR" "" ${ARGN} )
+
+	## If no arguments are given, do not create an unecessary .vcxproj.user file
+	set(MSVCsuc_DEFAULT OFF)
+
+	if(MSVCsuc_PATH AND MSVCsuc_DEFAULT)
+		set(MSVCsuc_DEFAULT OFF)
+	endif()
+
+	if(MSVCsuc_FILE AND MSVCsuc_DEFAULT)
+		set(MSVCsuc_DEFAULT OFF)
+	endif()
+
+	if(NOT MSVCsuc_COMMAND)
+		if(MSVCsuc_PATH AND MSVCsuc_FILE)
+			set(MSVCsuc_COMMAND "${MSVCsuc_PATH}\\${MSVCsuc_FILE}")
+		elseif(MSVCsuc_PATH)
+			set(MSVCsuc_COMMAND "${MSVCsuc_PATH}\\$(TargetFileName)")
+		else()
+			set(MSVCsuc_COMMAND "$(TargetPath)") ## => $(TargetDir)\$(TargetName)$(TargetExt)
+		endif()
+	elseif(MSVCsuc_DEFAULT)
+		set(MSVCsuc_DEFAULT OFF)
+	endif()
+
+        # NOTE: there was a typo here. there is an else if written after else statement
+        # changing the order of the else if statement
+	if(MSVCsuc_WORKING_DIR)
+		file(TO_NATIVE_PATH ${MSVCsuc_WORKING_DIR} MSVCsuc_WORKING_DIR)
+	elseif(MSVCsuc_DEFAULT)
+		set(MSVCsuc_DEFAULT OFF)
+	else()
+		set(MSVCsuc_WORKING_DIR "$(ProjectDir)")
+	endif()
+
+	if(NOT MSVCsuc_ARGS)
+		set(MSVCsuc_ARGS "")
+	elseif(MSVCsuc_DEFAULT)
+		set(MSVCsuc_DEFAULT OFF)
+	endif()
+
+	if(MSVC10 OR (MSVC AND MSVC_VERSION GREATER 1600)) # 2010 or newer
+
+		if(CMAKE_SIZEOF_VOID_P EQUAL 8)
+			set(PLATEFORM_BITS x64)
+		else()
+			set(PLATEFORM_BITS Win32)
+		endif()
+
+		if(NOT MSVCsuc_DEFAULT AND PLATEFORM_BITS)
+
+			file(WRITE "${CMAKE_CURRENT_BINARY_DIR}/${targetName}.vcxproj.user"
+		"<?xml version=\"1.0\" encoding=\"utf-8\"?>
+<Project ToolsVersion=\"4.0\" xmlns=\"http://schemas.microsoft.com/developer/msbuild/2003\">
+  <PropertyGroup Condition=\"'$(Configuration)|$(Platform)'=='Release|${PLATEFORM_BITS}'\">
+    <LocalDebuggerCommand>${MSVCsuc_COMMAND}</LocalDebuggerCommand>
+    <LocalDebuggerCommandArguments>${MSVCsuc_ARGS}</LocalDebuggerCommandArguments>
+    <DebuggerFlavor>WindowsLocalDebugger</DebuggerFlavor>
+	<LocalDebuggerWorkingDirectory>${MSVCsuc_WORKING_DIR}</LocalDebuggerWorkingDirectory>
+  </PropertyGroup>
+  <PropertyGroup Condition=\"'$(Configuration)|$(Platform)'=='Debug|${PLATEFORM_BITS}'\">
+    <LocalDebuggerCommand>${MSVCsuc_COMMAND}</LocalDebuggerCommand>
+    <LocalDebuggerCommandArguments>${MSVCsuc_ARGS}</LocalDebuggerCommandArguments>
+    <DebuggerFlavor>WindowsLocalDebugger</DebuggerFlavor>
+    <LocalDebuggerWorkingDirectory>${MSVCsuc_WORKING_DIR}</LocalDebuggerWorkingDirectory>
+  </PropertyGroup>
+    <PropertyGroup Condition=\"'$(Configuration)|$(Platform)'=='MinSizeRel|${PLATEFORM_BITS}'\">
+    <LocalDebuggerCommand>${MSVCsuc_COMMAND}</LocalDebuggerCommand>
+    <LocalDebuggerCommandArguments>${MSVCsuc_ARGS}</LocalDebuggerCommandArguments>
+    <DebuggerFlavor>WindowsLocalDebugger</DebuggerFlavor>
+    <LocalDebuggerWorkingDirectory>${MSVCsuc_WORKING_DIR}</LocalDebuggerWorkingDirectory>
+  </PropertyGroup>
+    <PropertyGroup Condition=\"'$(Configuration)|$(Platform)'=='RelWithDebInfo|${PLATEFORM_BITS}'\">
+    <LocalDebuggerCommand>${MSVCsuc_COMMAND}</LocalDebuggerCommand>
+    <LocalDebuggerCommandArguments>${MSVCsuc_ARGS}</LocalDebuggerCommandArguments>
+    <DebuggerFlavor>WindowsLocalDebugger</DebuggerFlavor>
+    <LocalDebuggerWorkingDirectory>${MSVCsuc_WORKING_DIR}</LocalDebuggerWorkingDirectory>
+  </PropertyGroup>
+</Project>"
+			)
+			if(MSVCsuc_VERBOSE)
+				message(STATUS "[MSVCsetUserCommand] Write ${CMAKE_CURRENT_BINARY_DIR}/${targetName}.vcxproj.user file")
+				message(STATUS "   to execute ${MSVCsuc_COMMAND} ${MSVCsuc_ARGS}")
+				message(STATUS "   from derectory ${MSVCsuc_WORKING_DIR}")
+				message(STATUS "   on visual studio run debugger button")
+			endif()
+
+		else()
+			message(WARNING "PLATEFORM_BITS is undefined...")
+		endif()
+
+	else()
+		if(MSVCsuc_VERBOSE)
+			message(WARNING "MSVCsetUserCommand is disable because too old MSVC is used (need MSVC10 2010 or newer)")
+		endif()
+	endif()
+
+endfunction()

sugar/gaussian_splatting/SIBR_viewers/cmake/windows/Modules/FindASSIMP.cmake

@@ -0,0 +1,104 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+## Try to find the ASSIMP library
+## Once done this will define
+##
+##  	ASSIMP_FOUND 		- system has ASSIMP
+##  	ASSIMP_INCLUDE_DIR 	- The ASSIMP include directory
+##  	ASSIMP_LIBRARIES 	- The libraries needed to use ASSIMP
+##  	ASSIMP_CMD 			- the full path of ASSIMP executable
+##	ASSIMP_DYNAMIC_LIB	- the Assimp dynamic lib (available only on windows as .dll file for the moment)
+##
+## Edited for using a bugfixed version of Assimp
+
+if(NOT ASSIMP_DIR)
+    set(ASSIMP_DIR "$ENV{ASSIMP_DIR}" CACHE PATH "ASSIMP root directory")
+endif()
+if(ASSIMP_DIR)
+	file(TO_CMAKE_PATH ${ASSIMP_DIR} ASSIMP_DIR)
+endif()
+
+
+## set the LIB POSTFIX to find in a right directory according to what kind of compiler we use (32/64bits)
+if(CMAKE_SIZEOF_VOID_P EQUAL 8)
+	set(ASSIMP_SEARCH_LIB "lib64")
+	set(ASSIMP_SEARCH_BIN "bin64")
+	set(ASSIMP_SEARCH_LIB_PATHSUFFIXE "x64")
+else()
+	set(ASSIMP_SEARCH_LIB "lib32")
+	set(ASSIMP_SEARCH_BIN "bin32")
+	set(ASSIMP_SEARCH_LIB_PATHSUFFIXE "x86")
+endif()
+
+set(PROGRAMFILESx86 "PROGRAMFILES(x86)")
+
+
+FIND_PATH(ASSIMP_INCLUDE_DIR
+	NAMES assimp/config.h
+	PATHS
+		${ASSIMP_DIR}
+		## linux
+		/usr
+		/usr/local
+		/opt/local
+		## windows
+		"$ENV{PROGRAMFILES}/Assimp"
+		"$ENV{${PROGRAMFILESx86}}/Assimp"
+		"$ENV{ProgramW6432}/Assimp"
+	PATH_SUFFIXES include
+)
+
+
+FIND_LIBRARY(ASSIMP_LIBRARY
+	NAMES assimp-vc140-mt
+	PATHS
+		${ASSIMP_DIR}/${ASSIMP_SEARCH_LIB}
+		${ASSIMP_DIR}/lib
+		${ASSIMP_DIR}/lib64
+		## linux
+		/usr/${ASSIMP_SEARCH_LIB}
+		/usr/local/${ASSIMP_SEARCH_LIB}
+		/opt/local/${ASSIMP_SEARCH_LIB}
+		/usr/lib
+		/usr/local/lib
+		/opt/local/lib
+		## windows
+		"$ENV{PROGRAMFILES}/Assimp/${ASSIMP_SEARCH_LIB}"
+		"$ENV{${PROGRAMFILESx86}}/Assimp/${ASSIMP_SEARCH_LIB}"
+		"$ENV{ProgramW6432}/Assimp/${ASSIMP_SEARCH_LIB}"
+		"$ENV{PROGRAMFILES}/Assimp/lib"
+		"$ENV{${PROGRAMFILESx86}}/Assimp/lib"
+		"$ENV{ProgramW6432}/Assimp/lib"
+	PATH_SUFFIXES ${ASSIMP_SEARCH_LIB_PATHSUFFIXE}
+)
+set(ASSIMP_LIBRARIES ${ASSIMP_LIBRARY})
+
+
+if(ASSIMP_LIBRARY)
+	get_filename_component(ASSIMP_LIBRARY_DIR ${ASSIMP_LIBRARY} PATH)
+	file(GLOB ASSIMP_DYNAMIC_LIB "${ASSIMP_LIBRARY_DIR}/assimp*.dll")
+	if(NOT ASSIMP_DYNAMIC_LIB)
+		message("ASSIMP_DYNAMIC_LIB is missing... at ${ASSIMP_LIBRARY_DIR}")
+	endif()
+	set(ASSIMP_DYNAMIC_LIB ${ASSIMP_DYNAMIC_LIB} CACHE PATH "Windows dll location")
+endif()
+
+MARK_AS_ADVANCED(ASSIMP_DYNAMIC_LIB ASSIMP_INCLUDE_DIR ASSIMP_LIBRARIES)
+
+INCLUDE(FindPackageHandleStandardArgs)
+FIND_PACKAGE_HANDLE_STANDARD_ARGS(ASSIMP
+	REQUIRED_VARS ASSIMP_INCLUDE_DIR ASSIMP_LIBRARIES
+	FAIL_MESSAGE "ASSIMP wasn't found correctly. Set ASSIMP_DIR to the root SDK installation directory."
+)
+
+if(NOT ASSIMP_FOUND)
+	set(ASSIMP_DIR "" CACHE STRING "Path to ASSIMP install directory")
+endif()

sugar/gaussian_splatting/SIBR_viewers/cmake/windows/Modules/FindEmbree.cmake

@@ -0,0 +1,95 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+## Important Note:
+## This is not an official Find*cmake. It has been written for searching through
+## a custom path (EMBREE_DIR) before checking elsewhere.
+##
+## FindEMBREE.cmake
+## Find EMBREE's includes and library
+##
+## This module defines :
+## 	[in] 	EMBREE_DIR, The base directory to search for EMBREE (as cmake var or env var)
+## 	[out] 	EMBREE_INCLUDE_DIR where to find EMBREE.h
+## 	[out] 	EMBREE_LIBRARIES, EMBREE_LIBRARY, libraries to link against to use EMBREE
+## 	[out] 	EMBREE_FOUND, If false, do not try to use EMBREE.
+##
+
+
+if(NOT EMBREE_DIR)
+    set(EMBREE_DIR "$ENV{EMBREE_DIR}" CACHE PATH "EMBREE root directory")
+endif()
+if(EMBREE_DIR)
+	file(TO_CMAKE_PATH ${EMBREE_DIR} EMBREE_DIR)
+endif()
+
+
+## set the LIB POSTFIX to find in a right directory according to what kind of compiler we use (32/64bits)
+if(CMAKE_SIZEOF_VOID_P EQUAL 8)
+	set(EMBREE_SEARCH_LIB "lib64")
+	set(EMBREE_SEARCH_BIN "bin64")
+	set(EMBREE_SEARCH_LIB_PATHSUFFIXE "x64")
+else()
+	set(EMBREE_SEARCH_LIB "lib32")
+	set(EMBREE_SEARCH_BIN "bin32")
+	set(EMBREE_SEARCH_LIB_PATHSUFFIXE "x86")
+endif()
+
+set(PROGRAMFILESx86 "PROGRAMFILES(x86)")
+
+FIND_PATH(EMBREE_INCLUDE_DIR
+	NAMES embree3/rtcore_geometry.h
+	PATHS
+		${EMBREE_DIR}
+		## linux
+		/usr
+		/usr/local
+		/opt/local
+		## windows
+		"$ENV{PROGRAMFILES}/EMBREE"
+		"$ENV{${PROGRAMFILESx86}}/EMBREE"
+		"$ENV{ProgramW6432}/EMBREE"
+	PATH_SUFFIXES include
+)
+
+FIND_LIBRARY(EMBREE_LIBRARY
+	NAMES embree3
+	PATHS
+		${EMBREE_DIR}/${EMBREE_SEARCH_LIB}
+		${EMBREE_DIR}/lib
+		## linux
+		/usr/${EMBREE_SEARCH_LIB}
+		/usr/local/${EMBREE_SEARCH_LIB}
+		/opt/local/${EMBREE_SEARCH_LIB}
+		/usr/lib
+		/usr/local/lib
+		/opt/local/lib
+		## windows
+		"$ENV{PROGRAMFILES}/EMBREE/${EMBREE_SEARCH_LIB}"
+		"$ENV{${PROGRAMFILESx86}}/EMBREE/${EMBREE_SEARCH_LIB}"
+		"$ENV{ProgramW6432}/EMBREE/${EMBREE_SEARCH_LIB}"
+		"$ENV{PROGRAMFILES}/EMBREE/lib"
+		"$ENV{${PROGRAMFILESx86}}/EMBREE/lib"
+		"$ENV{ProgramW6432}/EMBREE/lib"
+	PATH_SUFFIXES ${EMBREE_SEARCH_LIB_PATHSUFFIXE}
+)
+set(EMBREE_LIBRARIES ${EMBREE_LIBRARY})
+
+MARK_AS_ADVANCED(EMBREE_INCLUDE_DIR EMBREE_LIBRARIES)
+
+INCLUDE(FindPackageHandleStandardArgs)
+FIND_PACKAGE_HANDLE_STANDARD_ARGS(EMBREE
+	REQUIRED_VARS EMBREE_INCLUDE_DIR EMBREE_LIBRARIES
+	FAIL_MESSAGE "EMBREE wasn't found correctly. Set EMBREE_DIR to the root SDK installation directory."
+)
+
+if(NOT EMBREE_FOUND)
+	set(EMBREE_DIR "" CACHE STRING "Path to EMBREE install directory")
+endif()

sugar/gaussian_splatting/SIBR_viewers/cmake/windows/Modules/FindFFmpeg.cmake

@@ -0,0 +1,104 @@
+# Copyright (C) 2020, Inria
+# GRAPHDECO research group, https://team.inria.fr/graphdeco
+# All rights reserved.
+# 
+# This software is free for non-commercial, research and evaluation use 
+# under the terms of the LICENSE.md file.
+# 
+# For inquiries contact [email protected] and/or [email protected]
+
+
+## Try to find the FFMPEG library
+## Once done this will define
+##
+##  	FFMPEG_FOUND 		- system has FFmpeg
+##  	FFMPEG_INCLUDE_DIR 	- The FFmpeg include directory
+##  	FFMPEG_LIBRARIES 	- The libraries needed to use FFmpeg
+##		FFMPEG_DYNAMIC_LIBS	- DLLs for windows
+
+
+if(NOT FFMPEG_DIR)
+    set(FFMPEG_DIR "$ENV{FFMPEG_DIR}" CACHE PATH "FFMPEG_DIR root directory")
+endif()
+
+if(FFMPEG_DIR)
+	file(TO_CMAKE_PATH ${FFMPEG_DIR} FFMPEG_DIR)
+endif()
+
+MACRO(FFMPEG_FIND varname shortname headername)
+	
+	# Path to include dirs
+	FIND_PATH(FFMPEG_${varname}_INCLUDE_DIRS 
+		NAMES "lib${shortname}/${headername}" 
+		PATHS
+			"${FFMPEG_DIR}/include" # modify this to adapt according to OS/compiler			
+	)
+		
+	#Add libraries
+	IF(${FFMPEG_${varname}_INCLUDE_DIRS} STREQUAL "FFMPEG_${varname}_INCLUDE_DIR-NOTFOUND")
+		MESSAGE(STATUS "Can't find includes for ${shortname}...")
+	ELSE()
+		FIND_LIBRARY(FFMPEG_${varname}_LIBRARIES
+			NAMES ${shortname}
+			PATHS
+				${FFMPEG_DIR}/lib
+		)
+
+		# set libraries and other variables
+		SET(FFMPEG_${varname}_FOUND 1)
+		SET(FFMPEG_${varname}_INCLUDE_DIRS ${FFMPEG_${varname}_INCLUDE_DIR})
+		SET(FFMPEG_${varname}_LIBS ${FFMPEG_${varname}_LIBRARIES}) 
+	ENDIF()
+ ENDMACRO(FFMPEG_FIND)
+
+#Calls to ffmpeg_find to get  librarires ------------------------------
+FFMPEG_FIND(LIBAVFORMAT avformat avformat.h)
+FFMPEG_FIND(LIBAVDEVICE avdevice avdevice.h)
+FFMPEG_FIND(LIBAVCODEC  avcodec  avcodec.h)
+FFMPEG_FIND(LIBAVUTIL   avutil   avutil.h)
+FFMPEG_FIND(LIBSWSCALE  swscale  swscale.h)
+ 
+# check if libs are found and set FFMPEG related variables
+#SET(FFMPEG_FOUND "NO")
+IF(FFMPEG_LIBAVFORMAT_FOUND 
+	AND FFMPEG_LIBAVDEVICE_FOUND 
+	AND FFMPEG_LIBAVCODEC_FOUND 
+	AND FFMPEG_LIBAVUTIL_FOUND 
+	AND FFMPEG_LIBSWSCALE_FOUND)
+ 
+	# All ffmpeg libs are here
+    SET(FFMPEG_FOUND "YES")
+	SET(FFMPEG_INCLUDE_DIR ${FFMPEG_LIBAVFORMAT_INCLUDE_DIRS})
+	SET(FFMPEG_LIBRARY_DIRS ${FFMPEG_LIBAVFORMAT_LIBRARY_DIRS})
+	SET(FFMPEG_LIBRARIES
+        ${FFMPEG_LIBAVFORMAT_LIBS}
+        ${FFMPEG_LIBAVDEVICE_LIBS}
+        ${FFMPEG_LIBAVCODEC_LIBS}
+        ${FFMPEG_LIBAVUTIL_LIBS}
+		${FFMPEG_LIBSWSCALE_LIBS}	)
+		
+	# add dynamic libraries
+	if(WIN32)
+		file(GLOB FFMPEG_DYNAMIC_LIBS "${FFMPEG_DIR}/bin/*.dll")
+		if(NOT FFMPEG_DYNAMIC_LIBS)
+			message("FFMPEG_DYNAMIC_LIBS is missing...")
+	endif()
+	set(FFMPEG_DYNAMIC_LIBS ${FFMPEG_DYNAMIC_LIBS} CACHE PATH "Windows dll location")
+endif()
+	
+	mark_as_advanced(FFMPEG_INCLUDE_DIR FFMPEG_LIBRARY_DIRS FFMPEG_LIBRARIES FFMPEG_DYNAMIC_LIBS)
+ELSE ()
+    MESSAGE(STATUS "Could not find FFMPEG")
+ENDIF()
+ 
+ 
+INCLUDE(FindPackageHandleStandardArgs)
+FIND_PACKAGE_HANDLE_STANDARD_ARGS(FFMPEG
+	REQUIRED_VARS FFMPEG_INCLUDE_DIR FFMPEG_LIBRARIES
+	FAIL_MESSAGE "FFmpeg wasn't found correctly. Set FFMPEG_DIR to the root SDK installation directory."
+)
+
+if(NOT FFMPEG_FOUND)
+	set(FFMPEG_DIR "" CACHE STRING "Path to FFmpeg install directory")
+endif()
+