Yamyam: 1版をインポートしました

2018-06-28T21:23:19Z

1版をインポートしました

wiki>Klutz: /* Module Registration */

2018-06-14T10:55:01Z

‎Module Registration

新規ページ

= Updating Scripts from 2.7x =

This page lists change you may need to make to your scripts so they run in 2.8x.

== Module Registration ==

Module registration (<tt>bpy.utils.register_module</tt>) convenience function has been removed, since keeping track of this information adds unnecessary overhead.

Add-ons should assign their classes to a tuple or list and register/unregister them directly.

eg:

<pre>
classes = (
FooClass,
BarClass,
BazClass,
)

def register():
from bpy.utils import register_class
for cls in classes:
register_class(cls)

def unregister():
from bpy.utils import unregister_class
for cls in reversed(classes):
unregister_class(cls)
</pre>

To avoid having to copy & paste the functions above, you can use <tt>bpy.utils.register_classes_factory</tt> utility function.

<pre>
classes = (
FooClass,
BarClass,
BazClass,
)
register, unregister = bpy.utils.register_classes_factory(classes)
</pre>

If you have an addon with many classes, the list can be generated using this patch: https://developer.blender.org/P455

== Class Registration ==

See {{BugReport|52599}} for proposal and details.

==== Access (bpy.types) ====

Now only [Header, Menu, Operator, Panel, UIList] are accessed from <tt>bpy.types</tt>.

Generally scripts access classes they define by importing their own modules,
so this should not impact many scripts.

==== Naming ====

In Blender2.7x it was too easy to accidentally register multiple classes with the same name.

To prevent collisions 2.8x enforces naming conventions ''(already in use across much of Blender's code-base)''

This constraint applies to the <tt>bl_idname</tt> of each class (or the class name which is used if no bl_idname is defined in the class).

These are: <tt>UPPER_CASE_{SEPARATOR}_mixed_case</tt>, in the case of a menu the regular expression is:

<tt>[A-Z][A-Z0-9_]*_MT_[A-Za-z0-9_]+</tt>

Each classes separator is listed below:

* Header -> <tt>_HT_</tt>
* Menu -> <tt>_MT_</tt>
* Operator -> <tt>_OT_</tt>
* Panel -> <tt>_PT_</tt>
* UIList -> <tt>_UL_</tt>

Valid Examples:

* <tt>OBJECT_OT_fancy_tool</tt>
* <tt>SOME_HEADER_HT_my_header</tt>
* <tt>PANEL123_PT_myPanel</tt> ''(lower case is preferred but mixed case is supported)''.

At time of writing names that don't conform to this convention will warn on startup.
Eventually we will make this into an error, eg:

<pre>
Warning: 'Oscurart Files Tools' doesn't contain '_PT_' with prefix & suffix
Warning: 'Oscurart Overrides' doesn't contain '_PT_' with prefix & suffix
Warning: 'Oscurart Animation Tools' doesn't contain '_PT_' with prefix & suffix
</pre>

== Scene Layer Access ==

TODO.

== Object Selection Access ==

TODO.

← 古い版	2018年6月28日 (木) 21:23時点における版
(相違点なし)

Dev:2.8/Source/Python/UpdatingScripts - 版の履歴

Yamyam: 1版 をインポートしました

wiki>Klutz: /* Module Registration */

Yamyam: 1版をインポートしました