2023年10月26日 (木) 22:07にYamyamによる

2023-10-26T22:07:16Z

Yamyam: ページの作成:「元記事：[https://wiki.blender.org/wiki/Reference/Release_Notes/4.0/Animation_Rigging/Bone_Collections_%26_Colors:_Upgrading Reference/Release Notes/4.0/Animation Rigg…」

2023-10-26T22:05:35Z

ページの作成:「元記事：[https://wiki.blender.org/wiki/Reference/Release_Notes/4.0/Animation_Rigging/Bone_Collections_%26_Colors:_Upgrading Reference/Release Notes/4.0/Animation Rigg…」

新規ページ

元記事：[https://wiki.blender.org/wiki/Reference/Release_Notes/4.0/Animation_Rigging/Bone_Collections_%26_Colors:_Upgrading Reference/Release Notes/4.0/Animation Rigging/Bone Collections & Colors: Upgrading - Blender Developer Wiki]

= ボーンコレクションとカラーの4.0へのアップグレード =

このページはアーマチュアレイヤーとボーングループで動作していた Python コードを、Blender 3.6から4.0へのアップグレードする方法のドキュメントです。

== アーマチュアレイヤー ==

* Blender 4.0はアーマチュアレイヤーをボーンコレクションに変換します。

* コレクション名は `Layer N` になり、N には1から32が入ります。

* もしアーマチュアに、[Bone Manager アドオン](https://fin.gumroad.com/l/STdb)で設定したレイヤー名があった場合、これらの名前はアペンドされ、`Layer N - 名前` になります。このアドオンは好きな名前をアーマチュアの `layer_name_M`（M は0から31）という名前のカスタムプロパティに格納します。

* 一つ以上のボーンがあるレイヤーが変換されます。空のレイヤーはスキップします。

=== Visibility（可視性）の変更 ===

Blender 3.6 以前：
<syntaxhighlight lang="Python">
arm.layers = [True, False, True] + 29 * [False]
arm.layers[0] = False
</syntaxhighlight>

Blender 4.0：
<syntaxhighlight lang="Python">
for bcoll in arm.collections:
bcoll.is_visible = True

arm.collections['IK Controls'].is_visible = False
arm.collections[0].is_visible = False
</syntaxhighlight>

=== ボーンの割り当てと割り当て解除 ===

Blender 3.6以前：
<syntaxhighlight lang="Python">
arm.bones['arm_lower_R'].layers = [True, False, True] + 29 * [False]
arm.bones['arm_lower_R'].layers[1] = True
</syntaxhighlight>

Blender 4.0：
<syntaxhighlight lang="Python">
arm.collections['IK Controls'].assign(arm.bones['arm_lower_R'])
arm.collections['IK Controls'].unassign(arm.bones['arm_lower_R'])
arm.collections[2].assign(arm.bones['arm_lower_R'])
arm.collections[2].unassign(arm.bones['arm_lower_R'])
</syntaxhighlight>

=== ボーンを他のボーンのコレクションに割り当てる場合 ===

Blender 3.6以前：
<syntaxhighlight lang="Python">
arm.bones['arm_lower_R'].layers = arm.bones['other_bone'].layers
</syntaxhighlight>

Blender 4.0（`bone.collections.set(other_collections)` 関数があるまで）：
<syntaxhighlight lang="Python">
bone = arm.bones['arm_lower_R']
bone.collections.clear()
for bcoll in arm.bones['other_bone'].collections:
bcoll.assign(bone)
</syntaxhighlight>

=== レイヤー/コレクション内ボーンへのアクセス ===

Blender 3.6以前：
<syntaxhighlight lang="Python">
in_layer_3 = [bone for bone in arm.bones
if bone.layers[3]]
</syntaxhighlight>

Blender 4.0：
<syntaxhighlight lang="Python">
# アーマチュアの編集モード以外:
in_collection = arm.collections['IK Controls'].bones

# アーマチュア編集モード:
in_collection = [ebone for ebone in arm.edit_bones
if 'IK Controls' in ebone.collections]
</syntaxhighlight>

=== コレクション内のカスタムプロパティ ===

Blender 3.6以前では Armature 自身にデータを格納していました：
<syntaxhighlight lang="Python">
arm["custom_layer_data"] = {
0: 'some data for layer 0',
1: 'other data for layer 1',
}
</syntaxhighlight>

Blender 4.0ではボーンコレクションがカスタムコレクションを持ちます：
<syntaxhighlight lang="Python">
arm.collections['IK Controls']['custom'] = 'some custom data'
arm.collections[3]['whatever'] = 'you need'
</syntaxhighlight>

== ボーングループからボーンコレクションへの移行 ==

* Blender 4.0はボーングループをボーンコレクションに変換します。

* コレクション名はボーングループと同じになります。

* ボーングループはアーマチュアレイヤーの**後で**変換されます。もし `Layer 1` というボーングループ名があり、アーマチュアレイヤー1がボーンコレクションに変換された場合、そのボーングループ変換後のコレクションの名前は `Layer 1.001` になります。

* ボーングループのコレクションは最初は非表示になっています。これは Blender 3.6以前と同様、レイヤーが可視性を決め、グループはそうではないという挙動にするためです（上記のボーンコレクションの可視性ルールを参照）。

* ボーングループはアーマチュア自身ではなく、オブジェクトのポーズデータに格納されていたため、オブジェクトが利用可能な時のみ変換されます。

3.6のファイルからの「アーマチュアデータ」のリンク（「アーマチュアオブジェクト」のリンクではないことに注意）では**この変換は行われず**、単にデータが利用不可になります。

* すべてのボーングループが対象で、ボーンが入ってなくても変換されます。

== ボーンカラー ==

Blender 3.6以前ではボーングループをボーンの色付けに使用していました。ボーングループはアーマチュア自身ではなく、オブジェクトのポーズデータに格納されており、下記のような性質がありました。

* ボーンカラーがアーマチュア編集モードで利用できない。

* ボーンカラーがアーマチュアのユーザー間で共有できない。オブジェクト毎に設定や保守が必要。

* ボーンカラーはアーマチュアが共有されていてもオブジェクト毎の設定可能。これはボーンと各キャラクターの色でのコントラストを保つのに便利です。

Blender 4.0ではボーンカラーは直接アーマチュアボーンに格納されます。ポーズボーンはこれらの色をオーバーライドします。これにより、上で説明したような、オブジェクト毎に独立した色を持つことができるようになっています。

=== Python コード ===

Blender 3.6以前（ボーンをボーングループに割り当て済みと仮定）

<syntaxhighlight lang="Python">
# テーマカラー設定：
obj.pose.bone_groups['IK Bones'].color_set = 'THEME09'

# カスタムカラー設定：
group = obj.pose.bone_groups['IK Bones']
group.color_set = 'CUSTOM'
group.colors.active = (0.95, 1.0, 0.0)

# アーマチュアでのボーンカラー表示を無効化
arm.show_group_colors = False
</syntaxhighlight>

Blender 4.0：

<syntaxhighlight lang="Python">
# アーマチュアボーンに設定：
bone = arm.bones['arm_lower_R']
# 代わりにポーズボーンに設定:
bone = obj.pose.bones['arm_lower_R']

# テーマカラー設定：
bone.color.palette = 'THEME09'

# カスタムカラー設定：
bone.color.palette = 'CUSTOM'
bone.color.custom.active = (0.95, 1.0, 0.0)

# アーマチュアでのボーンカラー表示を無効化
arm.show_bone_colors = False
</syntaxhighlight>

@@ 11行目: / 11行目: @@
 * コレクション名は `Layer N` になり、N には1から32が入ります。
-* もしアーマチュアに、[Bone Manager アドオン](https://fin.gumroad.com/l/STdb)で設定したレイヤー名があった場合、これらの名前はアペンドされ、`Layer N - 名前` になります。このアドオンは好きな名前をアーマチュアの `layer_name_M`（M は0から31）という名前のカスタムプロパティに格納します。
+* もしアーマチュアに、[https://fin.gumroad.com/l/STdb Bone Manager アドオン]で設定したレイヤー名があった場合、これらの名前はアペンドされ、`Layer N - 名前` になります。このアドオンは好きな名前をアーマチュアの `layer_name_M`（M は0から31）という名前のカスタムプロパティに格納します。
 * 一つ以上のボーンがあるレイヤーが変換されます。空のレイヤーはスキップします。

Dev:JA/Ref/Release Notes/4.00/BoneCollectionsUpgrading - 版の履歴

2023年10月26日 (木) 22:07にYamyamによる

Yamyam: ページの作成:「元記事：[https://wiki.blender.org/wiki/Reference/Release_Notes/4.0/Animation_Rigging/Bone_Collections_%26_Colors:_Upgrading Reference/Release Notes/4.0/Animation Rigg…」