2003-06-24 07:21:17 +00:00
|
|
|
# The Blender Module
|
|
|
|
|
2003-06-25 04:38:38 +00:00
|
|
|
# The module files in this folder are used to create the API documentation.
|
|
|
|
# Doc system used: epydoc - http://epydoc.sf.net
|
2003-07-12 18:21:07 +00:00
|
|
|
# command line:
|
|
|
|
|
2003-11-08 02:19:09 +00:00
|
|
|
# epydoc -o BPY_API_230 --url "http://www.blender.org" -t Blender.py \
|
2003-07-16 01:44:51 +00:00
|
|
|
# -n "Blender" --no-private --no-frames Blender.py \
|
|
|
|
# Types.py Scene.py Object.py NMesh.py Material.py Camera.py Lamp.py \
|
|
|
|
# Armature.py Metaball.py Effect.py Curve.py Ipo.py World.py BGL.py Window.py \
|
2004-03-02 11:56:20 +00:00
|
|
|
# Draw.py Image.py Text.py Lattice.py Texture.py Registry.py Sys.py Mathutils.py
|
2003-06-25 04:38:38 +00:00
|
|
|
|
2003-06-24 07:21:17 +00:00
|
|
|
"""
|
2003-07-16 01:44:51 +00:00
|
|
|
The main Blender module.
|
2003-06-28 07:38:21 +00:00
|
|
|
|
2003-07-16 01:44:51 +00:00
|
|
|
The Blender Python API Reference
|
|
|
|
================================
|
2003-07-12 18:02:54 +00:00
|
|
|
|
2003-06-28 07:38:21 +00:00
|
|
|
Submodules:
|
|
|
|
-----------
|
|
|
|
|
2003-07-16 01:44:51 +00:00
|
|
|
- L{Armature}
|
2003-11-24 03:47:49 +00:00
|
|
|
- L{BGL}
|
2003-06-28 07:38:21 +00:00
|
|
|
- L{Camera}
|
2003-07-12 18:21:07 +00:00
|
|
|
- L{Curve}
|
2003-07-12 18:02:54 +00:00
|
|
|
- L{Draw}
|
2003-11-24 03:47:49 +00:00
|
|
|
- L{Effect}
|
2003-07-12 18:02:54 +00:00
|
|
|
- L{Image}
|
2003-11-24 03:47:49 +00:00
|
|
|
- L{Ipo}
|
|
|
|
- L{Lamp}
|
|
|
|
- L{Lattice}
|
2004-04-25 14:43:21 +00:00
|
|
|
- L{Library} (new)
|
2003-11-24 03:47:49 +00:00
|
|
|
- L{Material}
|
2004-04-25 14:43:21 +00:00
|
|
|
- L{Mathutils} (new)
|
2003-11-24 03:47:49 +00:00
|
|
|
- L{Metaball}
|
|
|
|
- L{NMesh}
|
2004-04-25 14:43:21 +00:00
|
|
|
- L{Noise} (new)
|
2003-11-24 03:47:49 +00:00
|
|
|
- L{Object}
|
2004-01-23 02:59:54 +00:00
|
|
|
- L{Registry}
|
2003-11-24 03:47:49 +00:00
|
|
|
- L{Scene}
|
2003-06-28 07:38:21 +00:00
|
|
|
- L{Text}
|
2003-11-24 03:47:49 +00:00
|
|
|
- L{Texture}
|
|
|
|
- L{Types}
|
|
|
|
- L{Window}
|
|
|
|
- L{World}
|
2004-04-25 14:43:21 +00:00
|
|
|
- L{sys<Sys>} (added time function)
|
2003-06-28 07:38:21 +00:00
|
|
|
|
|
|
|
Introduction:
|
|
|
|
-------------
|
2003-07-16 01:44:51 +00:00
|
|
|
|
|
|
|
This Reference documents the Blender Python API, a growing collection of
|
|
|
|
Python modules (libs) that give access to part of the program's internal data
|
|
|
|
and functions.
|
|
|
|
|
|
|
|
Through scripting, Blender can be extended in realtime. Possibilities range
|
|
|
|
from simple functionality to importers / exporters and even more complex
|
|
|
|
"applications". Blender scripts are written in
|
|
|
|
U{Python <www.python.org>}, an impressive high level, multi-paradigm,
|
|
|
|
open-source language.
|
2003-06-28 07:38:21 +00:00
|
|
|
|
2003-06-24 07:21:17 +00:00
|
|
|
@author: The Blender Python Team
|
2004-04-25 14:43:21 +00:00
|
|
|
@requires: Blender 2.33 or newer.
|
|
|
|
@version: 2.33
|
2003-06-24 07:21:17 +00:00
|
|
|
@see: U{www.blender.org<http://www.blender.org>}
|
|
|
|
@see: U{projects.blender.org<http://projects.blender.org>}
|
2003-07-16 01:44:51 +00:00
|
|
|
@see: U{www.python.org<http://www.python.org>}
|
2003-07-17 00:26:33 +00:00
|
|
|
@see: U{www.python.org/doc<http://www.python.org/doc>}
|
2003-06-24 07:21:17 +00:00
|
|
|
"""
|
|
|
|
|
|
|
|
def Set (request, data):
|
|
|
|
"""
|
2004-01-23 19:24:45 +00:00
|
|
|
Update settings in Blender.
|
2003-06-24 07:21:17 +00:00
|
|
|
@type request: string
|
|
|
|
@param request: The setting to change:
|
|
|
|
- 'curframe': the current animation frame
|
|
|
|
@type data: int
|
|
|
|
@param data: The new value.
|
|
|
|
"""
|
|
|
|
|
|
|
|
def Get (request):
|
|
|
|
"""
|
|
|
|
Retrieve settings from Blender.
|
|
|
|
@type request: string
|
|
|
|
@param request: The setting data to be returned:
|
|
|
|
- 'curframe': the current animation frame
|
|
|
|
- 'curtime' : the current animation time
|
|
|
|
- 'staframe': the start frame of the animation
|
|
|
|
- 'endframe': the end frame of the animation
|
|
|
|
- 'filename': the name of the last file read or written
|
|
|
|
- 'version' : the Blender version number
|
|
|
|
@return: The requested data.
|
|
|
|
"""
|
|
|
|
|
|
|
|
def Redraw ():
|
|
|
|
"""
|
2004-01-23 19:24:45 +00:00
|
|
|
Redraw all 3D windows.
|
2003-06-24 07:21:17 +00:00
|
|
|
"""
|
|
|
|
|
|
|
|
def ReleaseGlobalDict (bool = None):
|
|
|
|
"""
|
2004-01-23 19:24:45 +00:00
|
|
|
@depreciated: this function doesn't work anymore and will be removed.
|
|
|
|
Look at the L{Registry} submodule for a better alternative.
|
2003-06-24 07:21:17 +00:00
|
|
|
"""
|