Embedding image files (.png, .jpg, etc.) into a 3D frame using Blender. It scales the frame according to the aspect ratio of each input image and exports the resulting model.

• Blender v3.x (tested on v3.2.2)

• input/: Folder containing images to be processed.
• output/: Folder where processed models will be stored.
• frame.blend: Blender file containing the 3D frame model.
• artwork-framer.sh: Shell script that runs the Python script.
• main.py: Python script that processes the images and exports the models.
• src/exporters: Contains the exporters for different file formats (not all of them currently work correctly, if in doubt, default to GLTF).

There are two main ways to run the script: via the command line or inside Blender.

The command line method is preferred since it's the easiest to set up and use. The Blender method is useful if you want to make changes to the script and test them out.

Regardless, the script will process all images in the input/ directory and store the resulting models in the output/ directory (by default in GLTF format).

Currently, the format is hard-coded in the script. You can find it in the main.py file if you want to change it (CMD + F and Ctrl + F are your friends).

There are a couple of steps to make this all work.

1. Find out your Blender path (check official Blender docs for instructions)
2. Create .env, and set BLENDER_PATH to the path you found in step 1.
3. You might need to make the script executable: chmod +x artwork-framer.sh

Once you're set-up, you can run the script.

./artwork-framer.sh

This will process all the images, and you should see the output models in the output/ directory.

Add a label to the artwork 3D model. This will be displayed in the Blender scene.

./artwork-framer.sh --artwork_label "My Artwork"

• Open frame.blend in Blender.
• Open the main.py script in Blender's text editor.
• Run the script.

To run batch processing of images, simply place all images in the input/ directory before running the script. The script will process all images and store the output models in output/.

If you want to change the frame, you can do so by opening the frame.blend file in Blender and making the changes you want.

The script works by moving the top vertices of the frame upwards to match the aspect ratio of the input image. This means that the frame object must be a rectangle, and you need to follow a couple of rules.

• Keep the frame & picture objects named Frame & Picture respectively.

• Keep the dimensions of the Picture object to 2 x 2 (the default). You can change the depth of the picture (Y axis), but the width and height must remain the same.

• If you make any changes to the frame, you may need to reassign the vertices at the top of the frame to the Top Frame Edge vertex group.

• If you make any changes to the picture, you may need to reassign the vertices at the top of the picture to the Top Picture Edge vertex group.

Feel free to fork this repository or submit PRs for improvements.