Blender <> Automate

Speckle Automate unlocks new potentials for running Blender in the cloud.

This Speckle Function uses Blender's rendering engine Cycles to produce global illumation renders for each 3d view/camera in your versioned Speckle data.

When you send a new Speckle Version to Speckle, this Function creates stylized renders of your 3D Views and Cameras.

Using this Speckle Function

1. Create a new Speckle Automation.
2. Select your Speckle Project and Speckle Model.
3. Select the existing Speckle Function named blender-automate.
4. Click Create Automation.

Examples

More examples!!

Repo Structure

The function entry point is main.py following the structure of the speckle_automate_python_example.

The function serializes an automate_data.json file with the required data to receive the Speckle data within a Blender subprocess running the Speckle Blender connector.

speckle_import.py runs within the Blender context, receiving speckle data, applying material styalisation, replacing Speckle Rooms with point lights, and rendering each camera to the ./Screenshots folder. Automate will then pickup and attach these renders as blobs to the automate result.

Developer Requirements

1. Install the following:
   • Python 3
   • Poetry
   • Blender 3.X
2. Run poetry shell && poetry install to install the required Python packages.

Building and Testing

The code can be tested locally by running poetry run pytest. The code should also be packaged into the format required by Speckle Automate, a Docker Container Image, and that should also be tested.

Resources

• Learn more about SpecklePy, and interacting with Speckle from Python.