Wikipedia，自由的百科全书

Module API_intro

Contents 1 Module API_intro 2 API介绍 3 The Blender Python API Reference  4 涉及到的Blender Python API 4.1 Top Module:父模块 4.2 Submodules:子模块 4.3 Additional information:附加资料 5 Introduction:入门 6 Scripting and Blender:脚本和Blender 6.1 Interaction with users: 6.2 Command line mode: 6.3 Demo mode: 6.4 The Game Engine API: 6.5 Blender Data Structures: 6.6 A note to newbie script writers:

Module API_intro

API介绍

The Blender Python API Reference 

涉及到的Blender Python API

An asterisk (*) means the module has been updated.

带（*）的模块已经更新

Top Module:父模块

• Blender

Submodules:子模块

• Armature
  • NLA
  • Action
• BezTriple (*)
• BGL
• Camera
• Curve
• Draw
• Effect
• Geometry (*)
• Group (*)
• Image
• Ipo (*)
  • IpoCurve (*)
• Key (*)
• Lamp
• Lattice
• Library
• Material (*)
• Mathutils (*)
• Mesh (*)
  • MeshPrimitives (*)
• Metaball
• Modifier (*)
• NMesh (*)
• Noise
• Object (*)
  • Pose
  • Constraint (*)
  • ActionStrips (*)
• Registry
• Scene
  • Radio
  • Render
• Sound
• Text
• Text3d
  • Font
• Texture (*)
• TimeLine
• Types
• Window
  • Theme
• World
• sys

Additional information:附加资料

• Special features:
  • scripts: registering in menus, documenting, configuring (new); 脚本：寄存在菜单、文档、配置（新）
  • command line examples (new); 命令行例子（新）
  • script links (*), space handler script links, Group module (new). 脚本连接（*），空间脚本连接，组模块（新）

Introduction:入门

This reference documents the Blender Python API, a growing collection of Python modules (libraries) that give access to part of the program's internal data and functions.

这是一篇涉及到Blender Python API 的文档，一个不断搜集面向程序员的Python模块（库）资料和函数。

Through scripting Blender can be extended in real-time via Python, an impressive high level, multi-paradigm, open source language. Newcomers are recommended to start with the tutorial that comes with it.

通过脚本Blender可以用Python实时的进行扩展，Python是一个高水平、多风格、开源语言。你可以通过Python的新的指南了解它。

This opens many interesting possibilities, ranging from automating repetitive tasks to adding new functionality to the program: procedural models, importers and exporters, even complex applications and so on. Blender itself comes with

some scripts, but many others can be found in the Scripts & Plugins sections and forum posts at the Blender-related sites listed below.

这可以广泛引起大家的兴趣，广泛应用在程序函数自动化重复任务：程序模型，输入和输出，复杂的综合应用和其它。Blender自带一些脚本，而且有许多可以在脚本插件片断和与Blender相关的网站和论坛里找到。

Scripting and Blender:脚本和Blender

These are the basic ways to execute scripts in Blender:

1. They can be loaded or typed as text files in the Text Editor window, then executed with ALT+P.
2. Via command line: blender -P <scriptname> will start Blender and execute the given script. <scriptname> can be a filename in the user's file system or the name of a text saved in a .blend Blender file: 'blender myfile.blend -P textname'.
3. Via command line in background mode: use the '-b' flag (the order is important): blender -b <blendfile> -P <scriptname>. <blendfile> can be any .blend file, including the default .B.blend that is in Blender's home directory Blender.Get('homedir'). In this mode no window will be opened and the program will leave as soon as the script finishes execution.
4. Properly registered scripts can be selected directly from the program's menus.
5. Scriptlinks: these are also loaded or typed in the Text Editor window and can be linked to objects, materials or scenes using the Scriptlink buttons tab. Script links get executed automatically when their events (ONLOAD, REDRAW, FRAMECHANGED) are triggered. Normal scripts can create (Text) and link other scripts to objects and events, see Object.Object.addScriptLink, for example.
6. A script can call another script (that will run in its own context, with its own global dictionary) with the Blender.Run module function.

Interaction with users:

Scripts can:

• simply run and exit;
• pop messages, menus and small number and text input boxes;
• draw graphical user interfaces (GUIs) with OpenGL calls and native program buttons, which stay there accepting user input like any other Blender window until the user closes them;
• attach themselves to a space's event or drawing code (aka space handlers, [API_related-module.html check here]);
• make changes to the 3D View (set visible layer(s), view point, etc);
• grab the main input event queue and process (or pass to Blender) selected keyboard, mouse, redraw events -- not considered good practice, but still available for private use;
• tell Blender to execute other scripts (see Blender.Run());
• use external Python libraries, if available.

You can read the documentation for the Window, Draw and BGL modules for more information and also check the Python site for external modules that might be useful to you. Note though that any imported module will become a requirement of your script, since Blender itself does not bundle external modules.

Command line mode:

Python was embedded in Blender, so to access BPython modules you need to run scripts from the program itself: you can't import the Blender module into an external Python interpreter.

On the other hand, for many tasks it's possible to control Blender via some automated process using scripts. Interested readers should learn about features like "OnLoad" script links, the "-b <blendfile>" (background mode) and "-P <script>" (run script) command line options and API calls like Blender.Save, Blender.Load, Blender.Quit and the Library and Render modules.

Note that command line scripts are run before Blender initializes its windows (and in '-b' mode no window will be initialized), so many functions that get or set window related attributes (like most in Window) don't work here. If you need those, use an ONLOAD script link (see Scene.Scene.addScriptLink) instead -- it's also possible to use a command line script to write or set an ONLOAD script link. Check the Blender.mode module var to know if Blender is being executed in "background" or "interactive" mode.

[API_related-module.html Click here for command line and background mode examples].

Demo mode:

Blender has a demo mode, where once started it can work without user intervention, "showing itself off". Demos can render stills and animations, play rendered or real-time animations, calculate radiosity simulations and do many other nifty things. If you want to turn a .blend file into a demo, write a script to run the show and link it as a scene "OnLoad" scriptlink. The demo will then be played automatically whenever this .blend file is opened, unless Blender was started with the "-y" parameter.

The Game Engine API:

Blender has a game engine for users to create and play 3d games. This engine lets programmers add scripts to improve game AI, control, etc, making more complex interaction and tricks possible. The game engine API is separate from the Blender Python API this document references and you can find its own ref doc in the docs section of the main sites below.

Blender Data Structures:

Programs manipulate data structures. Blender python scripts are no exception. Blender uses an Object Oriented architecture. The BPython interface tries to present Blender objects and their attributes in the same way you see them through the User Interface (the GUI). One key to BPython programming is understanding the information presented in Blender's OOPS window where Blender objects and their relationships are displayed.

Each Blender graphic element (Mesh, Lamp, Curve, etc.) is composed from two parts: an Object and ObData. The Object holds information about the position, rotation and size of the element. This is information that all elements have in common. The ObData holds information specific to that particular type of element.

Each Object has a link to its associated ObData. A single ObData may be shared by many Objects. A graphic element also has a link to a list of Materials. By default, this list is associated with the ObData.

All Blender objects have a unique name. However, the name is qualified by the type of the object. This means you can have a Lamp Object called Lamp.001 (OB:Lamp.001) and a Lamp ObData called Lamp.001 (LA:Lamp.001).

For a more in-depth look at Blender internals, and some understanding of why Blender works the way it does, see the Blender Architecture document.

A note to newbie script writers:

Interpreted languages are known to be much slower than compiled code, but for many applications the difference is negligible or acceptable. Also, with profiling (or even simple direct timing with Blender.sys.time) to identify slow areas and well thought optimizations, the speed can be considerably improved in many cases. Try some of the best BPython scripts to get an idea of what can be done, you may be surprised.

---

Version: 2.42

Author: The Blender Python Team

Notes:

• this documentation was generated by epydoc, which can output html and pdf. For pdf it requires a working LaTeX environment.
• the official version of this reference guide is only updated for each new Blender release. But you can build the current CVS version yourself: install epydoc, grab all files in the source/blender/python/api2_2x/doc/ folder of Blender's CVS and use the epy_docgen.sh script also found there to generate the html docs. Naturally you will also need a recent Blender binary to try the new features. If you prefer not to compile it yourself, there is a testing builds forum at blender.org.

Requires: Blender 2.42 or newer.

See Also:

www.blender3d.org: main site, www.blender.org: documentation and forum, www.elysiun.com: user forum, projects.blender.org,blender architecture: blender architecture document, www.python.org, www.python.org/doc, en.wikibooks.org/wiki/Blender_3D:_Blending_Into_Python: User contributed documentation, featuring a blender/python cookbook with many examples.