Implementation Plan

[BeebBenjamin]

I think we should use ansible as the base for this project because this can be used to provision a service on a local machine or a remote server, hence the name ansible.meshroom. Let me know if you can think of a better name later!

I envision this as being something that can use an API to upload pictures to and run some automated processes using meshroom, then dump the project files to a mounted storage drive so that people can do some manual checking/rework in blender before the service continues onto texturing after detecting changes in the files. We can create separate repos to hold some of the other code for the service once we know what we're dealing with.

This way OpenScan and PalaeoPi can offer a cloud processing option with our products, and other users can also set up their own for their own projects.

At this stage, this is open to change, these are just my ideas.

[BeebBenjamin]

There is an existing node.js pipline line the Smithsonian uses called The Cook may be good for ideas on implementation. I like the use of RESTful APIs to handle jobs and recipes for the pipeline. Something that I did not previously consider is also post processing e.g. mesh decimation, uv-mapping, normal-mapping, diffuse-mapping etc. It might be useful to make a list of the rough steps required and identify software that can do these via CL interface.

[BeebBenjamin]

Proposed Pipeline

• [ ] Set up project/job meta data using a POST request, including a list of tasks/recipes. Set up inspection points.
• [ ] Start job
• [ ] Use a 3D viewer such as Smithsonian voyager or a simple three.js viewer with a GET request to inspect results at inspection points with a PATCH request to update the job.
• [ ] Optional DELETE request to delete the job and tasks or optional PATCH request to add different tasks based on results.
• [ ] Use a 3D viewer with a GET request to inspect the final results.

Example Tasklist

• [ ] Identify photos
• [ ] Generate masks GIMP CL
• [ ] Import photos into Meshroom
• [ ] Apply masks to photos in Meshroom
• [ ] Align photos in Meshroom
• [ ] Automatic or manual checking of alignment with potential use of a three.js viewer
• [ ] Generate dense point cloud in Meshroom
• [ ] Optional checking of dense cloud with potential use of a three.js viewer
• [ ] Optional clean up of dense cloud in Meshroom
• [ ] Generate model in Meshroom
• [ ] Clean up model in Meshroom
• [ ] Generate texture in Meshroom
• [ ] Optional checking of the model with potential use of a three.js viewer
• [ ] Generate texture in Meshroom
• [ ] Optional checking of the texture with potential use of a three.js viewer
• [ ] Optional Retopology and decimation using Instant Meshes CL
• [ ] Optional normal/diffuse re-mapping using Blender
• [ ] Optional checking og the model with potential use of a three.js viewer