Blender 之 入门

KAlO2

随笔 - 24  文章 - 2  评论 - 23  阅读 - 73554

Blender 之 Splash 代码分析


　　
　　注：以下内容基于 Blender 2.7x 版本工程，其它低版本可能有改动。

　　Blender启动完成时，会出现一个画面，英文叫Splash。默认是打开的，可以在设置里关闭。在文件菜单里点击用户首选项（快捷键Ctrl + Alt + U)，在弹出的窗口第一个Tab页面，也就是界面(Interface)的右下角，有一个选项 Show Splash，默认打了勾，关闭然后最下一行的 Save User Settings。这样，下次启动的时候就不会出现Splash。

　　假设你已经下载好了blender工程代码，下面通过Splash讲解C语言Operator的实现，前一篇是关于Python的Operator。

 

datatoc

　　Splash资源所在的文件夹是 blender/release/datafiles/ ，一起的还有各种图标、字体、SVG矢量图、画笔以及matcap效果图。
　　source/blender/editors/datafiles/CMakeLists.txt 会调用 data_to_c_simple 函数从图片格式转换成C代码（其实就是长度加二进制数据），blender 需要在源代码路径外编译(out of source build) ，对应生成在 blender-build/release/datafiles/ 。
data_to_c_simple(../../../../release/datafiles/splash.png SRC)
　　data_to_c_simple 函数（cmake的宏）定义在 build_files/cmake/macros.cmake
　　data_to_c 需要提供file_from、file_to参数，data_to_c_simple 则仅提供 file_from 参数，file_to 的值为 ${file_from}.c。
　　调用的命令是 datatoc 其工程在 source/blender/datatoc/ 。

　　该 CMakeLists.txt 的最后一句指明生成 bf_editor_datafiles.lib
blender_add_lib(bf_editor_datafiles "${SRC}" "${INC}" "${INC_SYS}")

bf_editor_datafiles.vcxproj -> blender-build/lib/Debug/bf_editor_datafiles.lib


　　blender/source/blenderplayer/CMakeLists.txt
　　bf_editor_datafiles 被包含在 BLENDER_SORTED_LIBS 里，blender.exe blenderplayer.exe 会依赖这些工程库。
target_link_libraries(blenderplayer ${BLENDER_SORTED_LIBS})
target_link_libraries(blender ${BLENDER_SORTED_LIBS})

　　这些图片资源最终转换成C数组数据链接到.exe文件里。
好处是：如果缺少相关资源（写错名字、用了中文字符、或者图片格式误写），编译期就会报错；如果仅仅是替换掉一张图片的话，错误只能在运行时被发现，导致出错。
坏处是：不仅仅是换掉图片资源就好了的，还需要重新编译。这让一些想把splash换成自己作品的艺术家望而却步。
后话：Google Summer Of Code 2016 列出了可配置的Splash想法（Configuration Splash Screen）。

 

main函数

　　Blender.sln 解决方案包含多个工程，cmake工具会额外生成 ALL_BUILD / INSTALL / PACKAGE / RUN_TESTS / ZERO_CHECK 等几个工程。其中，ALL_BUILD与INSTALL相当于makefile里面的make与install命令。
　　编译完成，在运行的时候，需要将启动工程从 ALL_BUILD 修改成 blender，否则会提示 Unable to start program 'build\x64\Debug\ALL_BUILD' 拒绝访问。（在blender工程上鼠标右键后，选择 Set as StartUp Project 即可）

　　一切的一切，要从main函数开始……
　　main函数在 blender 工程里的 source/creator/creator.c ，初始化子系统（图像、修改器、画笔、Python、节点、材质等）、处理命令行参数、进入消息循环WM_main()或者退出循环在后台运行（-b参数可以指定在后台渲染）。
BLI_argsAdd(ba, 1, "-b", "--background", "\n\tRun in background (often used for UI-less rendering)", background_mode, NULL);

　　所有有UI的应用程序会有消息循环机制。Blender 的是在 WM_main(C);
　　WM_main 的实现在 source/blender/windowmanager/intern/wm.c ，很简单的几行代码。

 

void WM_main(bContext *C)

{

    while (1) {

        

        /* get events from ghost, handle window events, add to window queues */

        wm_window_process_events(C);

        

        /* per window, all events to the window, screen, area and region handlers */

        wm_event_do_handlers(C);

        

        /* events have left notes about changes, we handle and cache it */

        wm_event_do_notifiers(C);

        

        /* execute cached changes draw */

        wm_draw_update(C);

    }

}

 

在 WM_main(C); 一行的上面是关于splash的，

if(!G.file_loaded)

    WM_init_splash(C);

　　Blender 有两个重要的数据结构 Global G; 和 UserDef U; ，见名知意。
　　Global 的字段 file_loaded 是 bool 类型的，但是字符串全局搜索到的是赋值为整形1，其实就是true。
source/blender/windowmanager/intern/wm_operators.c: G.file_loaded = 1; /* prevents splash to show */
　　file_loaded 为 true 则阻止加载splash，否则启动时加载splash。

 

Splash

　　关于 splash 的代码，就在 WM_init_splash(C); 这一行了。
　　WM是WindowManager的缩写，C语言缺少 C++ 的 namespace 概念，这样附带模块命名以防冲突。
　　来看看代码中有关splash的地方，Blender一个很常见的概念是Operator。
source/blender/windowmanager/intern/wm_init_exit.c

 

void WM_init_splash(bContext *C)

{

    if ((U.uiflag & USER_SPLASH_DISABLE) == 0) {

        wmWindowManager *wm = CTX_wm_manager(C);

        wmWindow *prevwin = CTX_wm_window(C);

    

        if (wm->windows.first) {

            CTX_wm_window_set(C, wm->windows.first);

            WM_operator_name_call(C, "WM_OT_splash", WM_OP_INVOKE_DEFAULT, NULL);

            CTX_wm_window_set(C, prevwin);

        }

    }

}

 

　　U.uiflag的比特位差不多用光了，又开了uiflag2。其中，USER_SPLASH_DISABLE 对应上面用户偏好里的 Show Splash。
　　bContext 是很重要的数据结构，通过指针传递，函数定义在 source/blender/blenkernel/intern/context.c，很多地方都引用了它，应该定义在 .h 文件里的。

　　给变量取好名字，更方便读代码。WM_operator_name_call 见名知意，根据Operator的名字来调用函数，比如上面就是想调用 "WM_OT_splash" 函数。

 

int WM_operator_name_call(bContext *C, const char *opstring, short context, PointerRNA *properties)

{

    wmOperatorType *ot = WM_operatortype_find(opstring, 0);

    if (ot) {

        return WM_operator_name_call_ptr(C, ot, context, properties);

    }

 

    return 0;

}

 

　　在 blender/source/blender/windowmanager/intern/wm_operators.c 你可以看到关于 Operator 的各种操作，通过函数 WM_operatortype_append 可以添加新的 Operator，由于有很多 Operator，Blender 用自己的哈希表 GHash *global_ops_hash 管理，WM_OT_splash 是在 WM_init() 初始化时添加的。

 

/* called on initialize WM_init() */void wm_operatortype_init(void)

{

    /* reserve size is set based on blender default setup */

    global_ops_hash = BLI_ghash_str_new_ex("wm_operatortype_init gh", 2048);

    

    ...

    WM_operatortype_append(WM_OT_splash);

    ...

}

 

调用的栈是这样的
int main(int argc, const char **argv)
　　WM_init(C, argc, (const char **)argv);
　　　　wm_operatortype_init();
　　　　　　WM_operatortype_append(WM_OT_splash);

　　WM_OT_splash，WM是Operator的种类，_OT_ 是 Operator Type，构成Operator ID名称的一部分，该函数填充 wmOperatorType 里的字段。

 

static void WM_OT_splash(wmOperatorType *ot)

{

    ot->name = "Splash Screen";

    ot->idname = "WM_OT_splash";

    ot->description = "Open the splash screen with release info";

    

    ot->invoke = wm_splash_invoke;

    ot->poll = WM_operator_winactive;

}

 

 

　　前一篇讲到过 name、idname、description。struct wmOperatorType 也给了注释。name 会在UI上显示出来的。idname 名字应该和函数名字一致，这里可以用 __func__ 宏的。description 是提示信息，鼠标放在上面会显示出来。
　　poll回调函数用来测试该Operator是否可以在当前环境(context)执行。我发现有些人在读代码的时候，对变量或函数的取名不在意。poll是轮询的意思，通过名称就能猜到要完成的功能。有关函数WM_operator_poll
　　invoke 就是函数调用了。

　　因为是static函数，所以只需要在本文件内搜索调用处，其他文件是不能调用的。这也算是一种搜索技巧。

static int wm_splash_invoke(bContext *C, wmOperator *UNUSED(op), const wmEvent *UNUSED(event))

{

    UI_popup_block_invoke(C, wm_block_create_splash, NULL);

    

    return OPERATOR_FINISHED;

}

　　C返回 OPERATOR_FINISHED 的状态，对应 Python 返回 {"FINISHED"}。
　　接着就是 wm_block_create_splash 函数了，画出Splash的地方，Splash上面的跳转链接也写在这个函数里。
// blender/source/blender/windowmanager/intern/wm_operators.c

 splash.png

　　WITH_HEADLESS 名字看不懂，CMakeLists.txt 里解释说是不带图形界面的编译（渲染农场，服务端模式），默认是关闭的。
　　这里引用到了 splash.png 的图，工程datatoc用来将splash.png图片资源转换成长度datatoc_splash_png_size 和二进制的dump datatoc_splash_png，上面讲过。

　　有关函数wm_operator_invoke，在 source/blender/windowmanager/intern/wm_event_system.c，调用栈是这样的：
int main(int argc, const char **argv)
　　WM_main(C);
　　　　WM_init_splash(C);
　　　　　　WM_operator_name_call(C, "WM_OT_splash", WM_OP_INVOKE_DEFAULT, NULL);
　　　　　　　　WM_operator_name_call_ptr(C, ot, context, properties);
　　　　　　　　　　wm_operator_call_internal(C, ot, properties, NULL, context, false);
　　　　　　　　　　　　wm_operator_invoke(C, ot, event, properties, reports, poll_only);

 wm_operator_invoke

 

　　invoke和exec是函数指针，要二选一填充，否则就是非法的Operator调用。上面的Splash Operator用的是invoke，它们的函数原型是：
int (*exec)(struct bContext *, struct wmOperator *);
int (*invoke)(struct bContext *, struct wmOperator *, const struct wmEvent *);

　　invoke 比 exec 多出一个 struct wmEvent* 参数，返回类型是int，其实是下面的无名enum类型。
　　调用exec或invoke后，都会 OPERATOR_RETVAL_CHECK(ret) 测试一下返回值。
　　invoke比exec多出的一句是：wm_region_mouse_co(C, event);

 OPERATOR_RETVAL_CHECK

　　Blender的用户偏好设置是可以保存在.blend文件里的，这是关于Splash的。
source/blender/makesrna/intern/rna_userdef.c
　　prop = RNA_def_property(srna, "show_splash", PROP_BOOLEAN, PROP_NONE);
　　RNA_def_property_boolean_negative_sdna(prop, NULL, "uiflag", USER_SPLASH_DISABLE);
　　RNA_def_property_ui_text(prop, "Show Splash", "Display splash screen on startup");

source/blender/makesdna/DNA_userdef_types.h
　　USER_SPLASH_DISABLE = (1 << 27),

 

参考：
Context + Operator = Action!

 

 

 

 

 

blender工程_blender插件开发入门

 

金门走狗 2020-12-27 03:33:07  825  收藏 5

文章标签： blender工程

版权

 

身为游戏开发者,不想只用blender建模,想写插件提升工作效率?

 

一、介绍

我希望这篇文章可以让你快速入门,早知道插件的套路,少走弯路，这篇文章将先直接快速演示一遍如何创建插件工程，从为blender添加一个简单实用小功能开始，开始带大家在接下来的时间逐渐熟悉blender插件开发，然后才是回过头来，介绍必要的常识资料。

 

（我想大家在blender画贴图后，一定会一遍一遍不厌其烦的手动保存贴图-UV/Image_Editor-Image-Save All Images，因为blender文件保存时不会保存贴图等数据，一旦什么时候忘记保存贴图，在心安理得保存完blender文件后关闭blender猛然想起贴图没了，可谓欲吐血。这次要添加的简单又极其实用的功能便是：保存blender文件时自动保存所有已修改图片）

 

建议跟随本文章演示做一遍,本篇文章创建的基础工程将在未来不断填充扩展功能。

 

本文章使用2.79版本，建议插件入门不要使用2.8版本。

 

二、创建第一个插件工程

1、进入blender的用户插件文件夹，创建工程文件

 

 

上两图贴出了blender的两个插件路径。

 

第一个路径是用户目录插件，目录：userAppDataRoamingBlender FoundationBlenderscriptsaddons,代表非系统原生插件,blender所有安装的外置插件最终都会被解压放置到这个文件夹下。安装插件可以在blender的addon界面直接选择zip文件安装，也可以把zip文件中文件夹直接拖入此目录完成安装。。

 

第二个是系统插件路径，不建议将自己写的插件放入此地，此地不少系统插件的代码可在以后做参考用，值得了解。

 

请在userAppDataRoamingBlender FoundationBlenderscriptsaddons文件夹下新建工程文件夹HelloAddon，并在HelloAddon文件夹下再次新建三个文件夹“command_operators”"model_data"、"view_panels"。

 

工程文件布局仿造mvc，在前期，我们会经常与command_operators与view panels打交道，组合blender自身的命令与编写相关界面，至于数据层自然也都是blender内置的各种数据了，基本不需要自定义数据层，暂不关注model_data文件夹。

 

我使用的文本编辑器为sublime3，仅有方便打开工程文件与python语法高亮功能：

 

 

2、新建基础脚本

a.HelloAddon文件夹下新建入口脚本__init__.py

 

 

bl_info = {

    "name": "HelloAddon",

    "author": "作者",

    "version": (1, 0),

    "blender": (2, 79, 0),

    "location": "View3D > Tool Shelf >HelloAddon Panel",

    "description": "插件描述",

    "warning": "",

    "wiki_url": "",

    "category": "3D View",

}

 

import bpy

import logging

from . import model_data

from . import command_operators

from . import view_panels

 

 

def register():

    bpy.utils.register_module(__name__)

    command_operators.register()

    view_panels.register()

 

 

def unregister():

    bpy.utils.unregister_module(__name__)

    command_operators.unregister()

    view_panels.unregister()

 

if __name__ == "__main__":

    register()

以上代码就是套路，不需要理解，主体为bpy.utils.register_module(__name_)，作用是注册import进来的所有模块。至于command_operators.register() 与 view_panels.register()则代表其他非模块相关的注册。这里的代码以后要新建工程直接ctrl c即可。

 

view_panels文件夹底新建脚本_init__.py

 

 

import bpy

 

 

def register():

    pass

 

 

def unregister():

    pass

 

3、开始添加自动保存图片功能

command_operators文件夹下新建脚本save_dirty_images.py

 

 

import bpy

from bpy.app.handlers import persistent

from bpy.types import Operator

 

 

@persistent

def save_dirty_images(dummy):

    bpy.ops.image.save_dirty()

    print('save image')

保存文件时自动保存图片的其中一句关键代码就在这里，即使用了系统命令bpy.ops.image.savedirty()。

 

扩展：可以在blender的系统脚本中找到此命令的类SaveDirty(Operator) 查看实现path:blender/release/scripts/startup/bl_operators/image.py：

 

这个类的参数Operator，代表此类为blender可调用的操作类，其他函数中可根据bl_idname中的值直接调用执行此类的execute方法，bl_label为blender界面中直接调用执行此方法的命令名称，可在blender2.79中空格键键入SaveAllDirtyImages直接执行此类中的execute中的函数功能。

我们的脚本中首先使用了一个空函数save_dirty_images（dummy）调用命令bpy.ops.image.save_dirty()，即执行系统类SaveDirty（operator）的execute方法，这样包装起来是为了后续要将此函数传入blender的保存文件回调方法中做参数，该方法接受一个函数而不是方法，且@persistent与（dummy）是必须的参数。此外我们在save_dirty_images函数底下 print('save image')输出语句，以便待会能在控制台看到执行成功的消息。

 

这里虽然创建了可直接执行的命令，但要使得保存blender时自动保存修改过的图片，还差了一步：找到blender保存文件的回调函数，并将此类附加上去。

 

commandoperators文件夹下新建_init__.py脚本

 

 

import bpy

 

from . import(

    save_dirty_images,

)

 

 

def register():

    #bpy.app.handlers.save_pre.append为blender保存文件时的回调

    bpy.app.handlers.save_pre.append(save_dirty_images.save_dirty_images)

 

 

def unregister():

    bpy.app.handlers.save_pre.append(save_dirty_images.save_dirty_images)

好了，我们的目的已经达到了，接下来打开blender，开始看效果！

 

4、打开blender，启用插件，测试功能

ctrl+alt+U打开配置界面，启用HelloAddon，并点击左下按钮SaveUserSettings保存设置。

 

 

Window/Toggle System Console打开控制台，待会可看到命令执行成功我们要输出的语句。

 

 

 

回到blender主界面，空格键后输入SaveAllDirtyImages，可以看到我们刚才写的函数：

 

 

回车键执行，可看到控制台输出了“save image”

 

 

也可以直接ctrl-s保存blender文件，也会在控制台输出save image，代表确实执行了保存图片命令，不过我们目前还未创建图片，没能看到效果，创建图片的步骤留给读者自行尝试，在image editor创建图片后切换到paint模式抹两笔，先手动将图片保存到自己要的目录，然后就可以开始测试了，继续往图片上抹，然后ctrl-s保存blender文件，将能观察到图片也自动保存更新了。

 

保存blender文件时自动保存所有更改图片，从此再无忘记保存图片的烦恼，各位读者用起来！

 

5、功能升级

上述虽然实现了保存文件自动保存图片功能，但唯一的缺点是其只对已有保存路径的图片而言有效，若是新建图片还未保存指定保存路径，那么此方法会将其直接忽视掉，原因见前面的系统脚本实现。

 

所以我们现在来改写系统的方法，当然不是直接更改系统文件，我们将其实现copy出来，加上一个提示功能：若有新建图片未指定保存路径，则自动将图片保存到blender文件的根目录下。

 

代码如下：

 

 

import bpy

import os

from bpy.app.handlers import persistent

from bpy.types import Operator

 

 

@persistent

def save_dirty_images(dummy):

    unique_paths = set()

    for image in bpy.data.images:

        if image.is_dirty:

            if image.packed_file:

                if image.library:

                    self.report({'WARNING'},

                                "Packed library image: %r from library %r"

                                " can't be re-packed" %

                                (image.name, image.library.filepath))

                else:

                    image.pack(as_png=True)

            else:

                # 若blender与图片均无路径,则忽略此图片自动保存

                # 若blender有路径而图片无路径,根目录上自动保存

                if image.filepath == "":

                    if not bpy.data.filepath == "":

                        filepath = CreateUniquePath(os.path.split(bpy.data.filepath)[0] + "", image.name, ".png")

                        image.filepath = filepath

                else:

                    filepath = bpy.path.abspath(image.filepath,

                                                library=image.library)

 

                if "" not in filepath and "/" not in filepath:

                    print("Invalid path: " + filepath)

                elif filepath in unique_paths:

                    print("Path used by more than one image: %r" %

                          filepath)

                else:

                    unique_paths.add(filepath)

                    image.save()

                    print('save image')

 

 

def CreateUniquePath(base_path, file_name, extension):

    path = base_path + file_name + extension

    while os.path.isfile(path):

        file_name += ".001"

        path = base_path + file_name + extension

    return path

 

 

class SaveDirty(Operator):

    """Save all modified textures"""

    bl_idname = "image.save_dirty_images"

    bl_label = "SaveAllDirtyImages"

 

    def execute(self, context):

        save_dirty_images(None)

        return {'FINISHED'}

将代码更改后，现在能保存新建未指定路径的图片，路径图片名称将与blender文件内的图片名称相同，若根目录下已有相同名称图片，则保存名称往后叠加.001。

 

到这里为止，一个完整而实用的小功能就完成了！

 

6、为下一篇文章做准备

只有一个看不见摸不着的命令怎么行，本着全都要的原则，下面我们来实现一个UI的hello world！下面先来写一个界面函数。

 

view_panels文件夹底下新建脚本hello_panel.py,并修改viewpanels/_init__.py，添加语句

 

from . import(hello_panel)

 

view_panels文件夹底下新建脚本hello_panel.py

 

 

import bpy

from bpy.types import Panel, Menu, UIList, PropertyGroup

from HelloAddon import command_operators

 

 

class HelloWorld(Panel):

    bl_space_type = 'VIEW_3D'

    bl_region_type = 'TOOLS'

    bl_category = 'HelloAddon'

    bl_idname = 'hello_world'

    bl_label = 'HelloWorld'

    # bl_options = {'DEFAULT_CLOSED'}

 

    def draw(self, context):

        layout = self.layout

        layout.label("你好UI")

        layout.operator("image.save_dirty_images", text="保存图片")

重新打开blender（注意blender插件更改后需要重启blender）：

 

 

可以看到T面板已经出现HelloAddon面板，包含HelloWorld标题（由bl_label决定）与Label“你好UI”以及按钮“保存图片”。

 

三、blender脚本插件入门心得

跟着上面做完一个插件功能，现在开始介绍如何自行深入学习blender脚本：

 

途径1：打开blender的text editor，很多模板文件可供复读（制）：

 

 

途径2：活用python console中的.后代码提示快捷键自动补全查看方法

 

 

默认的智能提示快捷键未ctrl+space，对中国人而言实在不友好，我改为了ctrl+alt+/，建议读者也改为此键位。

途径3：关注Outliner的Data-Blocks面板，极其方便，新手时对blender数据块摸不着头脑时务必打开此面板，直接http://bpy.data.xxx点出来，如bpy.data.images['myimage']....、bpy.data.objects['myobj'].data...，此面板下要找什么数据一路沿着+号点下去即可看到，可以说是可视化的代码自动补全！

 

 

途径4：查询api（实用性不高）

 

 

途径5：blender python 全球最大爱好者论坛：Stack Exchange

 

 

途径6：查看各类开源插件

 

blender插件那么多，随便拿起一个找到想学的功能就可以开始copy了，不需要自己从零走，何乐不为

 

本篇文章到此结束，有什么想法欢迎提出，下一篇文章内容将根据评论区而定，当然这第一篇文章很可能根本没什么人看到，那我就按照自己想法继续走啦。

 

相关资源：blender:自行编写或修改的Blender插件-源码_blender插件开发...

————————————————

版权声明：本文为CSDN博主「金门走狗」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。

原文链接：https://blog.csdn.net/weixin_32768455/article/details/112126216

 

 

Blender插件初始化范例

 

目标

  • [x] 总结Blender插件初始化范例

总结

插件模板

Blender内部插件实现方式模板功能总结如下:

  1. 定义了子模块重加载方式
  2. 定义了批量加载子模块的方式
  3. 插件注册函数
  4. 插件注销函数

模块总体结构如下:

# 支持子模块重加载(support reloading sub-modules)if "bpy" in locals():

    from importlib import reload

    _modules_loaded[:] = [reload(val) for val in _modules_loaded]

    del reload

# 定义要加载的模块

_modules = [

    "add_mesh_torus",

    ...

    ]

import bpy

# 模块加载, __import__()相当于 from __name__ import _modules__import__(name=__name__, fromlist=_modules)

_namespace = globals()

_modules_loaded = [_namespace[name] for name in _modules]del _namespace

 

def register():

    from bpy.utils import register_class

    for mod in _modules_loaded:

        for cls in mod.classes:

            register_class(cls)

 

def unregister():

    from bpy.utils import unregister_class

    for mod in reversed(_modules_loaded):

        for cls in reversed(mod.classes):

            if cls.is_registered:

                unregister_class(cls)

范例

Blender Foundation\Blender\2.79\scripts\startup\bl_operators\__init__.py

# ##### BEGIN GPL LICENSE BLOCK #######  This program is free software; you can redistribute it and/or#  modify it under the terms of the GNU General Public License#  as published by the Free Software Foundation; either version 2#  of the License, or (at your option) any later version.##  This program is distributed in the hope that it will be useful,#  but WITHOUT ANY WARRANTY; without even the implied warranty of#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the#  GNU General Public License for more details.##  You should have received a copy of the GNU General Public License#  along with this program; if not, write to the Free Software Foundation,#  Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.## ##### END GPL LICENSE BLOCK #####

# <pep8 compliant>

# support reloading sub-modulesif "bpy" in locals():

    from importlib import reload

    _modules_loaded[:] = [reload(val) for val in _modules_loaded]

    del reload

 

_modules = [

    "add_mesh_torus",

    "anim",

    "clip",

    "console",

    "file",

    "image",

    "mask",

    "mesh",

    "node",

    "object_align",

    "object",

    "object_randomize_transform",

    "object_quick_effects",

    "presets",

    "rigidbody",

    "screen_play_rendered_anim",

    "sequencer",

    "uvcalc_follow_active",

    "uvcalc_lightmap",

    "uvcalc_smart_project",

    "vertexpaint_dirt",

    "view3d",

    "wm",

    ]

import bpy

if bpy.app.build_options.freestyle:

    _modules.append("freestyle")

__import__(name=__name__, fromlist=_modules)

_namespace = globals()

_modules_loaded = [_namespace[name] for name in _modules]del _namespace

 

def register():

    from bpy.utils import register_class

    for mod in _modules_loaded:

        for cls in mod.classes:

            register_class(cls)

 

def unregister():

    from bpy.utils import unregister_class

    for mod in reversed(_modules_loaded):

        for cls in reversed(mod.classes):

            if cls.is_registered:

                unregister_class(cls)

 

 

Blender插件编写指南

 

前言

Blender插件是Blender的利器, 用户可以使用各种插件扩充Blender的功能.

Blender Python插件以bpy.props, bpy.types.Operator, bpy.types.Panel, bpy.types.UILayout, (...)为基础, 通过用户自定义包来实现.

插件要点

  1. 定义操作器
  2. 定义操作器控制面板(或菜单)
  3. 注册/注销操作器和面板

简单实例

bl_info = {

    "name": "Move X Axis",

    "category": "Object",

}

import bpy

 

class ObjectMoveX(bpy.types.Operator):

    """My Object Moving Script"""      # blender will use this as a tooltip for menu items and buttons.

    bl_idname = "object.move_x"        # unique identifier for buttons and menu items to reference.

    bl_label = "Move X by One"         # display name in the interface.

    bl_options = {'REGISTER', 'UNDO'}  # enable undo for the operator.

 

    def execute(self, context):        # execute() is called by blender when running the operator.

 

        # The original script

        scene = context.scene

        for obj in scene.objects:

            obj.location.x += 1.0

 

        return {'FINISHED'}            # this lets blender know the operator finished successfully.

def register():

    bpy.utils.register_class(ObjectMoveX)

 

def unregister():

    bpy.utils.unregister_class(ObjectMoveX)

 

# This allows you to run the script directly from blenders text editor# to test the addon without having to install it.if __name__ == "__main__":

    register()

参考

  1. Blender插件之操作器(Operator)实战 1
  2. Blender之UILayout 2
  3. Blender插件之Panel 3
  4. Blender之Property 4
  5. Addon Tutorial 5

 

 

posted @ 2021-11-25 17:41  廖先生  阅读(910)  评论(0)  编辑  收藏  举报