Blender Python scripts for rendering images directly from command-line interface

yuki-koyama yuki-koyama Last update: Apr 27, 2024

blender-cli-rendering

GitHub Blender

A set of Blender Python scripts for generating scenes and rendering images directly from command-line interface.

Principles

  • Able to run without display (thus, the renderer should be Cycles instead of EEVEE)
  • Support the latest LTS release (currently 2.93)

Possible Usages

  • Material to learn how to use Blender Python APIs.
  • Visualization of 3D data with fancy rendering quality.
  • Generation of synthetic training datasets for machine learning-based computer vision.

Scripts

01_cube.py

  • Cycles renderer

01_cube

02_suzanne.py

  • Directional light
  • Algorithmic object placement
  • Subdivision surfaces
  • TRACK_TO constraint to achieve camera's look-at behavior
  • Depth of field
  • Smooth shading

02_suzanne

03_ibl.py

  • Node-tree
  • Image-based lighting using an HDR image

03_ibl

04_principled_bsdf.py

  • Principled BSDF
  • Denoising
  • Empty object as a target

04_principled_bsdf

05_composition.py

  • Composition nodes
  • Node group

05_composition

06_split_tone.py

  • Split tone effect
  • Checker board texture

06_split_tone

07_texturing.py

  • Image texture

07_texturing

08_animation.py

  • Keyframing
  • Motion blur

08_animation

09_armature.py

  • Skeletal animation
  • Skinning

09_armature

10_mocap.py

  • Mesh creation from Python data
  • BVH data import
  • Texture tiling
  • Camera following

10_mocap

11_mesh_visualization.py

  • Wireframe
  • Vertex colors
  • Transparent background

11_mesh_visualization

12_cloth.py

  • Cloth modifier
  • Collision modifier
  • Area light

12_cloth

13_matcap.py

  • MatCap (a.k.a. Lit Sphere)
  • Image filtering (e.g., sharpen)
  • Simple RGB background
  • Node frame

13_matcap

14_procedural_texturing.py

  • Noise texture

14_procedural_texturing

License

GNU General Public License v3.0 (GPL-3.0). We have chosen this license because we respect the philosophy of free software.

Subscribe to our newsletter