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

淩亂°似流年 2022-01-16 14:25 695阅读 0赞

[2019独角兽企业重金招聘Python工程师标准>>> ][2019_Python_] ![hot3.png][]

按照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控制台运行一下即可。

转载于:https://my.oschina.net/u/2306127/blog/372034

[2019_Python_]: https://my.oschina.net/u/2663968/blog/3061697
[hot3.png]: /images/20220114/d87ac446e04d41f0ab6027f9f6ee1394.png