create-3d-scene

Create 3D Scene

Set up a complete Blender scene programmatically using the Python API (bpy). Configure scene hierarchy, add mesh objects, create PBR materials with node-based shaders, position lighting and cameras, and set up environment/world settings.

When to Use

• Creating reproducible 3D visualization scenes from scratch
• Automating product visualization or architectural rendering setup
• Generating multiple scene variations programmatically
• Building template scenes for batch rendering workflows
• Prototyping scene layouts before manual refinement
• Integrating 3D visualization into data pipelines or reporting systems

Inputs

Procedure

1. Set Up Script Structure

Create a Python script with proper imports and structure:

#!/usr/bin/env python3
"""
Scene setup script for Blender.
Usage: blender --background --python setup_scene.py
"""

import bpy
import math
import os
from pathlib import Path

def clear_scene():
    """Remove all objects from the scene."""
    bpy.ops.object.select_all(action='SELECT')
    bpy.ops.object.delete(use_global=False)

    # Clear orphaned data
    for block in bpy.data.meshes:
        if block.users == 0:
            bpy.data.meshes.remove(block)

    for block in bpy.data.materials:
        if block.users == 0:
            bpy.data.materials.remove(block)

def main():
    clear_scene()
    # Scene setup steps follow

if __name__ == "__main__":
    main()