Blender Documentation contents

Welcome, this document is an API reference for Blender 2.59.4. built Unknown.

A PDF version of this document is also available

Blender/Python Documentation

• Blender/Python Quickstart: new to blender/scripting and want to get you’re feet wet?
• Blender/Python API Overview: a more complete explanation of python integration
• Best Practice: Conventions to follow for writing good scripts
• Tips and Tricks: Hints to help you while writeing scripts for blender
• Gotcha’s: some of the problems you may come up against when writing scripts

Application Modules

• Context Access (bpy.context)
• Data Access (bpy.data)
• Operators (bpy.ops)
• Types (bpy.types)
• Utilities (bpy.utils)
• Path Utilities (bpy.path)
• Application Data (bpy.app)
• Property Definitions (bpy.props)

Standalone Modules

• Math Types & Utilities (mathutils)
• Geometry Utilities (mathutils.geometry)
• OpenGL Wrapper (bgl)
• Font Drawing (blf)
• GPU functions (gpu)
• Audio System (aud)
• Extra Utilities (bpy_extras)

Game Engine Modules

• Game Types (bge.types)
• Game Logic (bge.logic)
• Rasterizer (bge.render)
• Video Texture (bge.texture)
• Game Keys (bge.events)
• Physics Constraints (bge.constraints)

API Info

• Blender API Change Log

Note

The Blender Python API has areas which are still in development.

The following areas are subject to change.

• operator behavior, names and arguments
• mesh creation and editing functions

These parts of the API are relatively stable and are unlikely to change significantly

• data API, access to attributes of blender data such as mesh verts, material color, timeline frames and scene objects
• user interface functions for defining buttons, creation of menus, headers, panels
• render engine integration
• modules: bgl, mathutils & game engine.