3D-face-morph

Running Instructions for 3D Face Morph Software

Running Instructions

Download the code from this GitHub and then go to the directory where you keep the code. The canvas.blend file, Morphed3DGenerator.py file, and your 3D models to morph should be in the same directory.

• The canvas.blend is a blank blender file. To prepare this, simply open blender, delete the default cube, light source, and camera (and anything else present) and save the .blend file. This will serve as our blank canvas. This file is provided on this page for your convenience.
• The Morphed3DGenerator.py is phyton code that accomplishes the morphing.

Windows Instructions (using the command line on Windows)

"C:\Users\path\to\blender\blender.lnk" "C:\Users\path\to\canvas.blend" --background --python "C:\Users\path\to\Morphed3DGenerator.py" 

Mac Instructions (using the Terminal app on Mac)

/Applications/Blender.app/Contents/MacOS/Blender canvas.blend --background --python Morphed3DGenerator.py

When the above command is executed, the program will prompt you to enter the name of the configuration JSON file as follows: “Please enter the path to the JSON file:” Then enter the name of the JSON file that has the modifications desired.

You can use the ‘CreateMorphingConfigurations.html’ file to prepare the JSON file that includes the modifications. A sample JSON file is given (Facial-Deformities.json). See the instructions about how to create a configuration JSON file.

Note: Due to the huge number of outputs and size of the individual outputs that would be created, you may have to cancel the execution at some point with CTRL+C. If you do this while a file is being exported, it can lead to an incomplete file. Such a file can be disregarded and discarded.