Blender的插件开发－对象体系探索

按照python的说法一切皆对象，Blender中亦然。

Blender的根对象是bpy，所以任何模块都须要：

import bpy

注意：

        Blender的脚本print("hello")函数是输出信息到启动的控制台的，直接运行的时候看不到输出的信息。

        能够扩展出一个窗口，选择“信息”，就能够把当前全部操做的命令和执行结果都显示在其中，很是方便。

bpy.data

而后，任何对象其实都是数据，所以访问blender的第一个关键对象是bpy.data。如今，咱们打开python的命令行窗口：

拖动3D视图的右上角，向左下，扩展出一个窗口。
选择左下角的立方体，选择Python控制台，而后就能够输入Python脚本了。

在其中输入：

>>bpy.data.objects
<bpy_collection[4], BlendDataObjects>

    bpy_collection是一个python的词典对象，显示有四个对象（窗口初始是三个对象，我加了一个）。

    想知道是哪几个对象？很好办。用一个遍历，以下所示，列出了全部对象的名字：

>>> for obj in bpy.data.objects:
...     print(obj.name)
...     
Camera
Cube
Lamp
融球

    经过这种方式，咱们能够操做Blender的几乎全部数据。

bpy.context

    bpy.context顾名思义就是运行的上下文环境，这个在脚本环境里处处碰到了。知道了这个，呵呵！

>>> bpy.context.object
>>> bpy.context.selected_objects
>>> bpy.context.visible_bones

    这里能够看到，context也能够访问到object，这个是当前的环境可用的对象，其数据跟data里是一致的。后面的ops还能够来访问和修改对象的属性值。

    这是典型的python式的“面向对象”，数据按照对象来组织，可是访问时倒是以函数方式出现的，从而适应脚本环境的运行须要。

bpy.ops

    bpy.ops是Operator（操做器）的简写，封装了不少的对象操做在里面，是Blender功能的核心了。

>>> bpy.ops.mesh.flip_normals()
{'FINISHED'}

>>> bpy.ops.mesh.hide(unselected=False)
{'FINISHED'}

>>> bpy.ops.object.scale_apply()
{'FINISHED'}

    一个操做器的完整例子：

import bpy

def main(context):
    for ob in context.scene.objects:
        print(ob)

class SimpleOperator(bpy.types.Operator):
    """Tooltip"""
    bl_idname = "object.simple_operator"
    bl_label = "Simple Object Operator"

    @classmethod
    def poll(cls, context):
        return context.active_object is not None

    def execute(self, context):
        main(context)
        return {'FINISHED'}

def register():
    bpy.utils.register_class(SimpleOperator)

def unregister():
    bpy.utils.unregister_class(SimpleOperator)

if __name__ == "__main__":
    register()

    # test call
    bpy.ops.object.simple_operator()

     注意里面的register/unregister，以及其中的class和poll、execute成员函数，这是一个典型的插件的实现结构。

    大部分插件照着上面这个结构依瓢画葫芦就能够了。

bpy.types

    bpy.types不是python的type对象的简单封装，而是Blender各类“类”的集合，不要问我到底有啥区别哈，谁用谁知道啊。

   注意：Panel也是types里面的东东啊。下面是定义Panel的插件：

import bpyclass HelloWorldPanel(bpy.types.Panel):
    """Creates a Panel in the Object properties window"""
    bl_label = "Hello World Panel"
    bl_idname = "OBJECT_PT_hello"
    bl_space_type = 'PROPERTIES'
    bl_region_type = 'WINDOW'
    bl_context = "object"

    def draw(self, context):
        layout = self.layout

        obj = context.object

        row = layout.row()
        row.label(text="Hello world!", icon='WORLD_DATA')

        row = layout.row()
        row.label(text="Active object is: " + obj.name)
        row = layout.row()
        row.prop(obj, "name")

        row = layout.row()
        row.operator("mesh.primitive_cube_add")

def register():
    bpy.utils.register_class(HelloWorldPanel)

def unregister():
    bpy.utils.unregister_class(HelloWorldPanel)

if __name__ == "__main__":
    register()

    注意，这里多了一些变量的声明，这是插件的一些说明。

bl_label = "Hello World Panel"
bl_idname = "OBJECT_PT_hello"
bl_space_type = 'PROPERTIES'
bl_region_type = 'WINDOW'
bl_context = "object"

    全部插件原则上都应该包含上面这些信息，引号内的字符串能够修改，变量名不能修改（不然就成本身的了）。这个插件信息声明了这个panel是在对象的属性面板中出现。

    bpy.types包含的一些对象以下：

bpy.types.Panel
bpy.types.Menu
bpy.types.Operator
bpy.types.PropertyGroup
bpy.types.KeyingSet
bpy.types.RenderEngine

    这里再次了出现Operator对象，跟前面的bpy.ops是否是同样的啊？

    我猜想应该是，考虑到type是python的基本对象，这个现象一点也不奇怪。要想一探究竟，很简单，到python控制台运行一下便可。