@volter/blender-engine 0.1.148 → 0.1.149

package/browser/addons/vrm/documentation/ja-jp/material-pbr/index.md

@@ -0,0 +1,90 @@
+---
+title: "物理ベースのマテリアル設定"
+description: "プリンシプルBSDFシェーダーを用いた物理ベースのマテリアルを設定します。"
+---
+
+リアルな物理ベースのマテリアルをVRMに設定します。
+
+![](/assets/images/material_pbr.gif)
+
+VRM Add-on for Blenderでは、リアルな物理ベースのマテリアルの設定はBlenderのglTF
+2.0アドオンの処理と全く同じ処理を行っています。
+詳しくは該当するドキュメントを参照ください
+
+https://docs.blender.org/manual/ja/2.93/addons/import_export/scene_gltf2.html#exported-materials
+
+Blenderを起動したら、初めから表示されている立方体を削除します。まずその立方体にマウスの左クリックして選択します。
+
+![](1.png)
+
+選択すると、立方体の周りがオレンジ色になります。その状態でキーボードの `x`
+キーを押してください。
+
+![](2.png)
+
+削除の確認表示がされるので、そのままキーボードの `Enter` キーを押してください。
+
+![](3.png)
+
+成功すると立方体が削除されます。次に、三角形からなる球を追加します。
+3Dビューポート内にカーソルを置いた状態で、キーボードの `Shift` キーを押したまま
+`a` キーを押してください。 オブジェクトの追加メニューが表示されるため `メッシュ`
+→ `ICO球` を選択してください。
+
+![](4.png)
+
+成功すると、三角形からなる球が追加されます。
+
+![](5.png)
+
+次にマテリアルの色を確認できるようにします。
+3Dビューポート内にカーソルを置いた状態で、キーボードの `z`
+キーを押すことでプレビュー表示選択メニューが出ます。
+その状態でマウスを下に移動し `マテリアルプレビュー` を選択します。
+
+![](6.png)
+
+成功すると、表示の灰色っぽさが増します。とはいえ変化はほとんどないですが、デフォルトのままだと色つけても表示に反映されないので注意してください。
+
+![](7.png)
+
+この状態でマテリアルの設定を行います。右下の「![](/assets/images/material_property_tab_icon.png)」アイコンのタブを選び
+`新規` ボタンを押します。
+
+![](8.png)
+
+`マテリアル` という名前のマテリアルが追加されます。 また `サーフェス` の設定が
+`プリンシプルBSDF` になっていることを確認してください。
+
+![](9.png)
+
+`プリンシプルBSDF`
+を設定することで、リアルな物理ベースの質感の設定ができ、その設定をそのままVRMにエクスポートすることができます。
+
+![](10.png)
+
+次に `ベースカラー` を選択し、色選択ポップアップが出るので青を入力します。
+
+![](11.png)
+
+次に `メタリック` の値を `0.5` に設定します。
+
+![](12.png)
+
+このモデルをVRMとして保存します。メニューの `ファイル` → `エクスポート` →
+`VRM (.vrm)` を選択します。
+
+![](13.png)
+
+ファイル保存用のウィンドウが出るので、ファイル名と保存先を入力し
+`VRMをエクスポート` を押します。
+
+![](14.png)
+
+成功するとVRMファイルが指定された場所に保存されます。
+
+![](/assets/images/material_pbr.gif)
+
+こちらのページで動作確認ができます。
+
+- https://hub.vroid.com/characters/3819557420301868457/models/3988362170085862123

package/browser/addons/vrm/documentation/ja-jp/scripting-api/index.md

@@ -0,0 +1,389 @@
+---
+title: "Pythonスクリプトによる自動化サンプル"
+description: "Pythonスクリプトを利用してVRM関連処理を自動化するサンプルです。"
+---
+
+Pythonスクリプトを利用してVRM関連処理を自動化するサンプルです。
+
+![](/assets/images/scripting_api.gif)
+
+## VRMファイルのインポート
+
+```python
+import bpy
+
+result = bpy.ops.import_scene.vrm(filepath="path_to_your_vrm_model.vrm")
+if result != {"FINISHED"}:
+    raise Exception(f"Failed to import vrm: {result}")
+```
+
+## VRMファイルのエクスポート
+
+```python
+import bpy
+from pathlib import Path
+
+output_filepath = str(Path.home() / "path_to_your_new_vrm_model.vrm")
+result = bpy.ops.export_scene.vrm(filepath=output_filepath)
+if result != {"FINISHED"}:
+    raise Exception(f"Failed to export vrm: {result}")
+
+print(f"{output_filepath=}")
+```
+
+## VRMメタデータの設定
+
+VRM 1.0のモデルを想定します。
+
+```python
+import bpy
+
+context = bpy.context
+
+bpy.ops.object.add(type="ARMATURE", location=(0, 0, 0))
+
+armature = context.object
+armature.data.vrm_addon_extension.spec_version = "1.0"
+
+meta = armature.data.vrm_addon_extension.vrm1.meta
+meta.vrm_name = "Your Model Name"
+meta.version = "1.0.0"
+meta.authors.add().value = "Author 1"
+meta.copyright_information = "Copyright Information"
+meta.contact_information = "Contact Information"
+meta.references.add().value = "https://example.com"
+meta.third_party_licenses = "Third Party Licenses"
+thumbnail_image = context.blend_data.images.new(name="New Image", width=32, height=32)
+meta.thumbnail_image = thumbnail_image
+meta.avatar_permission = "onlyAuthor"  # or "onlySeparatelyLicensedPerson", "everyone"
+meta.allow_excessively_violent_usage = False
+meta.allow_excessively_sexual_usage = False
+meta.commercial_usage = "personalNonProfit"  # or "personalProfit", "corporation"
+meta.allow_political_or_religious_usage = False
+meta.allow_antisocial_or_hate_usage = False
+meta.credit_notation = "required"  # or "unnecessary"
+meta.allow_redistribution = False
+meta.modification = (
+    "prohibited"  # or "allowModification", "allowModificationRedistribution"
+)
+meta.other_license_url = ""
+```
+
+## VRMヒューマンボーンの設定
+
+VRM 1.0のモデルを想定します。
+
+```python
+import bpy
+
+context = bpy.context
+
+bpy.ops.object.add(type="ARMATURE", location=(0, 0, 0))
+armature = context.object
+armature.data.vrm_addon_extension.spec_version = "1.0"
+
+bpy.ops.object.mode_set(mode="EDIT")
+
+hips_bone = armature.data.edit_bones.new("hips")
+hips_bone.head = (0, 0, 0.5)
+hips_bone.tail = (0, 0, 0.75)
+
+spine_bone = armature.data.edit_bones.new("spine")
+spine_bone.parent = hips_bone
+spine_bone.head = (0, 0, 0.75)
+spine_bone.tail = (0, 0, 1)
+
+bpy.ops.object.mode_set(mode="OBJECT")
+
+armature.data.vrm_addon_extension.vrm1.humanoid.human_bones.hips.node.bone_name = "hips"
+armature.data.vrm_addon_extension.vrm1.humanoid.human_bones.spine.node.bone_name = (
+    "spine"
+)
+```
+
+## VRM MToonマテリアルの値を設定
+
+```python
+import bpy
+
+context = bpy.context
+
+image = context.blend_data.images.new(name="New Image", width=32, height=32)
+
+material = context.blend_data.materials.new("New MToon Material")
+material.vrm_addon_extension.mtoon1.enabled = True
+
+gltf = material.vrm_addon_extension.mtoon1
+gltf.pbr_metallic_roughness.base_color_factor = (0, 1, 0, 1)
+gltf.pbr_metallic_roughness.base_color_texture.index.source = image
+
+# base_color_texture以外のテクスチャにも同様の設定が可能
+gltf.pbr_metallic_roughness.base_color_texture.index.sampler.mag_filter = (
+    "NEAREST"  # or "LINEAR"
+)
+gltf.pbr_metallic_roughness.base_color_texture.index.sampler.min_filter = "NEAREST"  # or "LINEAR", "NEAREST_MIPMAP_NEAREST", "LINEAR_MIPMAP_NEAREST", "NEAREST_MIPMAP_LINEAR", "LINEAR_MIPMAP_LINEAR"
+gltf.pbr_metallic_roughness.base_color_texture.index.sampler.wrap_s = (
+    "REPEAT"  # or "CLAMP_TO_EDGE", "MIRRORED_REPEAT"
+)
+gltf.pbr_metallic_roughness.base_color_texture.index.sampler.wrap_t = (
+    "REPEAT"  # or "CLAMP_TO_EDGE", "MIRRORED_REPEAT"
+)
+gltf.pbr_metallic_roughness.base_color_texture.extensions.khr_texture_transform.offset = (
+    0,
+    0,
+)
+gltf.pbr_metallic_roughness.base_color_texture.extensions.khr_texture_transform.scale = (
+    1,
+    1,
+)
+
+gltf.alpha_mode = "OPAQUE"  # or "MASK", "BLEND"
+gltf.double_sided = False
+gltf.alpha_cutoff = 0.5
+gltf.normal_texture.index.source = image
+gltf.normal_texture.scale = 1
+gltf.emissive_texture.index.source = image
+gltf.emissive_factor = (0, 0, 0)
+gltf.extensions.khr_materials_emissive_strength.emissive_strength = 1.0
+
+mtoon = gltf.extensions.vrmc_materials_mtoon
+mtoon.transparent_with_z_write = False
+mtoon.render_queue_offset_number = 0
+mtoon.shade_multiply_texture.index.source = image
+mtoon.shade_color_factor = (0, 0, 1)
+mtoon.shading_shift_texture.index.source = image
+mtoon.shading_shift_texture.scale = 1
+mtoon.shading_shift_factor = 0
+mtoon.shading_toony_factor = 0
+mtoon.gi_equalization_factor = 0
+mtoon.matcap_factor = (1, 1, 1)
+mtoon.matcap_texture.index.source = image
+mtoon.parametric_rim_color_factor = (0, 0, 0)
+mtoon.rim_multiply_texture.index.source = image
+mtoon.rim_lighting_mix_factor = 0
+mtoon.parametric_rim_fresnel_power_factor = 1.0
+mtoon.parametric_rim_lift_factor = 1.0
+mtoon.outline_width_mode = "worldCoordinates"  # or "none", "screenCoordinates"
+mtoon.outline_width_factor = 0.01
+mtoon.outline_width_multiply_texture.index.source = image
+mtoon.outline_color_factor = (0, 0, 0)
+mtoon.outline_lighting_mix_factor = 0
+mtoon.uv_animation_mask_texture.index.source = image
+mtoon.uv_animation_scroll_x_speed_factor = 0
+mtoon.uv_animation_scroll_y_speed_factor = 0
+mtoon.uv_animation_rotation_speed_factor = 0
+```
+
+## VRMのキャラクターを動的に生成しファイルにエクスポート
+
+![](/assets/images/humanoid.gif)
+
+[人型のVRMモデルを作る](../create-humanoid-vrm-from-scratch/)の手順をスクリプトで自動化し、VRMとしてエクスポートします。
+
+```python
+from pathlib import Path
+
+import bpy
+
+# 初期化
+
+if bpy.app.module:
+    bpy.ops.preferences.addon_enable(module="io_scene_vrm")
+
+# アーマチュアを作成
+
+armature_data = bpy.data.armatures.new("Armature")
+armature_object = bpy.data.objects.new("Armature", armature_data)
+bpy.context.scene.collection.objects.link(armature_object)
+bpy.context.view_layer.objects.active = armature_object
+
+bpy.ops.object.mode_set(mode="EDIT")
+
+hips_bone = armature_data.edit_bones.new("hips")
+hips_bone.head = (0, 0, 0.5)
+hips_bone.tail = (0, 1, 0.5)
+hips_bone_name = hips_bone.name
+
+right_upper_leg_bone = armature_data.edit_bones.new("upper_leg.R")
+right_upper_leg_bone.head = (-0.125, 0, 0.5)
+right_upper_leg_bone.tail = (-0.125, 1, 0.5)
+right_upper_leg_bone.parent = hips_bone
+right_upper_leg_bone_name = right_upper_leg_bone.name
+
+right_lower_leg_bone = armature_data.edit_bones.new("lower_leg.R")
+right_lower_leg_bone.head = (-0.125, 0, 0.25)
+right_lower_leg_bone.tail = (-0.125, 1, 0.25)
+right_lower_leg_bone.parent = right_upper_leg_bone
+right_lower_leg_bone_name = right_lower_leg_bone.name
+
+right_foot_bone = armature_data.edit_bones.new("foot.R")
+right_foot_bone.head = (-0.125, 0, 0)
+right_foot_bone.tail = (-0.125, 1, 0)
+right_foot_bone.parent = right_lower_leg_bone
+right_foot_bone_name = right_foot_bone.name
+
+left_upper_leg_bone = armature_data.edit_bones.new("upper_leg.L")
+left_upper_leg_bone.head = (0.125, 0, 0.5)
+left_upper_leg_bone.tail = (0.125, 1, 0.5)
+left_upper_leg_bone.parent = hips_bone
+left_upper_leg_bone_name = left_upper_leg_bone.name
+
+left_lower_leg_bone = armature_data.edit_bones.new("lower_leg.L")
+left_lower_leg_bone.head = (0.125, 0, 0.25)
+left_lower_leg_bone.tail = (0.125, 1, 0.25)
+left_lower_leg_bone.parent = left_upper_leg_bone
+left_lower_leg_bone_name = left_lower_leg_bone.name
+
+left_foot_bone = armature_data.edit_bones.new("foot.L")
+left_foot_bone.head = (0.125, 0, 0)
+left_foot_bone.tail = (0.125, 1, 0)
+left_foot_bone.parent = left_lower_leg_bone
+left_foot_bone_name = left_foot_bone.name
+
+spine_bone = armature_data.edit_bones.new("spine")
+spine_bone.head = (0, 0, 0.625)
+spine_bone.tail = (0, 1, 0.625)
+spine_bone.parent = hips_bone
+spine_bone_name = spine_bone.name
+
+right_upper_arm_bone = armature_data.edit_bones.new("upper_arm.R")
+right_upper_arm_bone.head = (-0.125, 0, 0.75)
+right_upper_arm_bone.tail = (-0.125, 1, 0.75)
+right_upper_arm_bone.parent = spine_bone
+right_upper_arm_bone_name = right_upper_arm_bone.name
+
+right_lower_arm_bone = armature_data.edit_bones.new("lower_arm.R")
+right_lower_arm_bone.head = (-0.25, 0, 0.75)
+right_lower_arm_bone.tail = (-0.25, 1, 0.75)
+right_lower_arm_bone.parent = right_upper_arm_bone
+right_lower_arm_bone_name = right_lower_arm_bone.name
+
+right_hand_bone = armature_data.edit_bones.new("hand.R")
+right_hand_bone.head = (-0.375, 0, 0.75)
+right_hand_bone.tail = (-0.375, 1, 0.75)
+right_hand_bone.parent = right_lower_arm_bone
+right_hand_bone_name = right_hand_bone.name
+
+left_upper_arm_bone = armature_data.edit_bones.new("upper_arm.L")
+left_upper_arm_bone.head = (0.125, 0, 0.75)
+left_upper_arm_bone.tail = (0.125, 1, 0.75)
+left_upper_arm_bone.parent = spine_bone
+left_upper_arm_bone_name = left_upper_arm_bone.name
+
+left_lower_arm_bone = armature_data.edit_bones.new("lower_arm.L")
+left_lower_arm_bone.head = (0.25, 0, 0.75)
+left_lower_arm_bone.tail = (0.25, 1, 0.75)
+left_lower_arm_bone.parent = left_upper_arm_bone
+left_lower_arm_bone_name = left_lower_arm_bone.name
+
+left_hand_bone = armature_data.edit_bones.new("hand.L")
+left_hand_bone.head = (0.375, 0, 0.75)
+left_hand_bone.tail = (0.375, 1, 0.75)
+left_hand_bone.parent = left_lower_arm_bone
+left_hand_bone_name = left_hand_bone.name
+
+head_bone = armature_data.edit_bones.new("head")
+head_bone.head = (0, 0, 0.75)
+head_bone.tail = (0, 1, 0.75)
+head_bone.parent = spine_bone
+head_bone_name = head_bone.name
+
+bpy.ops.object.mode_set(mode="OBJECT")
+
+# VRM Human Boneを割り当て
+
+humanoid = armature_data.vrm_addon_extension.vrm1.humanoid
+humanoid.human_bones.head.node.bone_name = head_bone_name
+humanoid.human_bones.spine.node.bone_name = spine_bone_name
+humanoid.human_bones.hips.node.bone_name = hips_bone_name
+humanoid.human_bones.right_upper_arm.node.bone_name = right_upper_arm_bone_name
+humanoid.human_bones.right_lower_arm.node.bone_name = right_lower_arm_bone_name
+humanoid.human_bones.right_hand.node.bone_name = right_hand_bone_name
+humanoid.human_bones.left_upper_arm.node.bone_name = left_upper_arm_bone_name
+humanoid.human_bones.left_lower_arm.node.bone_name = left_lower_arm_bone_name
+humanoid.human_bones.left_hand.node.bone_name = left_hand_bone_name
+humanoid.human_bones.right_upper_leg.node.bone_name = right_upper_leg_bone_name
+humanoid.human_bones.right_lower_leg.node.bone_name = right_lower_leg_bone_name
+humanoid.human_bones.right_foot.node.bone_name = right_foot_bone_name
+humanoid.human_bones.left_upper_leg.node.bone_name = left_upper_leg_bone_name
+humanoid.human_bones.left_lower_leg.node.bone_name = left_lower_leg_bone_name
+humanoid.human_bones.left_foot.node.bone_name = left_foot_bone_name
+
+# メッシュを追加
+
+bpy.ops.mesh.primitive_uv_sphere_add(radius=0.25)
+head = bpy.context.active_object
+head.parent = armature_object
+head.parent_bone = humanoid.human_bones.head.node.bone_name
+head.parent_type = "BONE"
+
+bpy.ops.mesh.primitive_cube_add(size=0.4)
+spine = bpy.context.active_object
+spine.parent = armature_object
+spine.parent_bone = humanoid.human_bones.spine.node.bone_name
+spine.parent_type = "BONE"
+
+bpy.ops.mesh.primitive_ico_sphere_add(radius=0.1)
+left_upper_arm = bpy.context.active_object
+left_upper_arm.parent = armature_object
+left_upper_arm.parent_bone = humanoid.human_bones.left_upper_arm.node.bone_name
+left_upper_arm.parent_type = "BONE"
+
+bpy.ops.mesh.primitive_ico_sphere_add(radius=0.1)
+left_hand = bpy.context.active_object
+left_hand.parent = armature_object
+left_hand.parent_bone = humanoid.human_bones.left_hand.node.bone_name
+left_hand.parent_type = "BONE"
+
+bpy.ops.mesh.primitive_ico_sphere_add(radius=0.1)
+right_upper_arm = bpy.context.active_object
+right_upper_arm.parent = armature_object
+right_upper_arm.parent_bone = humanoid.human_bones.right_upper_arm.node.bone_name
+right_upper_arm.parent_type = "BONE"
+
+bpy.ops.mesh.primitive_ico_sphere_add(radius=0.1)
+right_hand = bpy.context.active_object
+right_hand.parent = armature_object
+right_hand.parent_bone = humanoid.human_bones.right_hand.node.bone_name
+right_hand.parent_type = "BONE"
+
+bpy.ops.mesh.primitive_ico_sphere_add(radius=0.1)
+left_upper_leg = bpy.context.active_object
+left_upper_leg.parent = armature_object
+left_upper_leg.parent_bone = humanoid.human_bones.left_upper_leg.node.bone_name
+left_upper_leg.parent_type = "BONE"
+
+bpy.ops.mesh.primitive_ico_sphere_add(radius=0.1)
+right_upper_leg = bpy.context.active_object
+right_upper_leg.parent = armature_object
+right_upper_leg.parent_bone = humanoid.human_bones.right_upper_leg.node.bone_name
+right_upper_leg.parent_type = "BONE"
+
+bpy.ops.mesh.primitive_ico_sphere_add(radius=0.1)
+left_lower_leg = bpy.context.active_object
+left_lower_leg.parent = armature_object
+left_lower_leg.parent_bone = humanoid.human_bones.left_lower_leg.node.bone_name
+left_lower_leg.parent_type = "BONE"
+
+bpy.ops.mesh.primitive_ico_sphere_add(radius=0.1)
+right_lower_leg = bpy.context.active_object
+right_lower_leg.parent = armature_object
+right_lower_leg.parent_bone = humanoid.human_bones.right_lower_leg.node.bone_name
+right_lower_leg.parent_type = "BONE"
+
+# メタデータを設定
+
+meta = armature_data.vrm_addon_extension.vrm1.meta
+meta.vrm_name = "Your Model Name"
+meta.version = "1.0.0"
+
+# ファイルに保存
+
+output_filepath = str(Path(__file__).parent / "path_to_your_vrm_model.vrm")
+result = bpy.ops.export_scene.vrm(filepath=output_filepath)
+if result != {"FINISHED"}:
+    message = f"Failed to export vrm: {result}"
+    raise RuntimeError(message)
+
+print(f'Saved the VRM file to "{output_filepath}"')
+```

package/browser/addons/vrm/documentation/ja-jp/ui/export_scene.vrm/index.md

@@ -0,0 +1,55 @@
+---
+title: "VRM（.vrm）のエクスポート"
+description: "BlenderからVRM（.vrm）を書き出す手順と各オプションを説明します。"
+---
+
+メニューの `ファイル` → `エクスポート` → `VRM (.vrm)`
+を選択することで、VRMのエクスポートダイアログが表示されます。 `保存`
+ボタンを押すと、現在編集中のアーマチュアがVRMファイルとしてエクスポートされます。
+
+![](1.png)
+
+## オプション
+
+### ✅ 非表示のオブジェクトを含める
+
+エクスポート時に非表示のオブジェクトを含めます。
+例外的に、エクスポート対象のアーマチュアだけは非表示でもエクスポートします。
+
+### ✅ 選択されたオブジェクトのみ
+
+選択中のオブジェクトのみエクスポートします。
+
+### ✅ 高度なオプションを有効にする
+
+【高度なオプション】の項目を有効にします。
+これらの項目を変更すると、VRMファイルのアプリケーション間の互換性が失われることがあるので注意してください。
+
+### ✅ 【高度なオプション】【VRM 1.0のみ】スパースアクセッサを利用する
+
+シェイプキーのエクスポート時にスパースアクセッサを利用します。
+シェイプキーを利用しているモデルでファイルサイズが削減される可能性がありますが、
+[UniVRM 0.115.0以下](https://github.com/saturday06/VRM-Addon-for-Blender/issues/381#issuecomment-1838365762)を利用している古いアプリでVRMファイルが読めなくなります。
+
+### ✅ 【高度なオプション】【VRM 1.0のみ】全てのボーンウェイトをエクスポートする
+
+全てのボーンウェイトをエクスポートします。VRMは仕様上は、
+1つの頂点に対して255個までのボーンウェイトを割り当てることができます。
+しかし、ほとんどのVRMを扱うアプリケーションは、1つの頂点にあたり4つのウェイトまでしか解釈しません。
+そのため、デフォルトでは表示互換性のためエクスポートするウェイトは4つまでに制限しています。
+この制限を外し、すべてのボーンウェイトをエクスポートするようにします。
+アプリケーションによってメッシュが大きく崩れることがあるため、慎重にウェイトを設定するか、
+エクスポート結果を特定のアプリケーションのみで利用する場合にご利用ください。
+
+### ✅ 【高度なオプション】【VRM 1.0のみ】ライトをエクスポートする
+
+ライトオブジェクトをエクスポート対象に含めます。VRMにおけるライトの扱いは現在コンセンサスが無く、
+どのような結果になるかが予測できません。ライトを扱えるアプリケーションのみで利用する場合にご利用ください。
+
+### ✅ 【高度なオプション】【VRM 1.0のみ】glTFアニメーションをエクスポートする
+
+glTFアニメーションをエクスポートします。デフォルトではglTFアニメーションはエクスポートしません。
+VRMファイルはモーションのリターゲッティングをすることが前提のフォーマットのため、
+そのままglTFのアニメーションがそのまま適用できないことが多いです。 代わりに
+[VRM Animation](https://vrm-addon-for-blender.info/ja-jp/animation/)
+の利用を検討してください。

package/browser/addons/vrm/documentation/ja-jp/ui/export_scene.vrma/index.md

@@ -0,0 +1,19 @@
+---
+title: "VRM Animation（.vrma）のエクスポート"
+description: "BlenderからVRM Animation（.vrma）を書き出す方法と含まれるデータを説明します。"
+---
+
+メニューの `ファイル` → `エクスポート` → `VRM Animation (.vrma)`
+を選択することで、 [VRM Animation](../../animation/)
+のエクスポートダイアログが表示されます。
+
+![](1.png)
+
+`保存` ボタンを押すと、シーンに配置されているVRM
+1.0に割り当てられているアニメーションのうち、
+次に条件に当てはまるものがVRMAファイルとしてエクスポートされます。
+
+- VRM Humanoidボーンに割り当てられているボーンの回転値
+- VRM Humanoidボーンのうち、Hipsボーンに割り当てられているボーンの移動値
+- VRM Expressionsのプレビューの値
+- VRM Look AtのPreview Targetに指定されているオブジェクトの移動値

package/browser/addons/vrm/documentation/ja-jp/ui/import_scene.vrm/index.md

@@ -0,0 +1,56 @@
+---
+title: "VRM（.vrm）のインポート"
+description: "BlenderにVRM（.vrm）を読み込み、インポート設定を調整する方法を説明します。"
+---
+
+メニューの `ファイル` → `インポート` → `VRM (.vrm)`
+を選択することで、VRMのインポートダイアログが表示されます。VRMファイルを選択して
+`開く` ボタンを押すとシーンにVRMファイルが展開されます。
+
+![](1.png)
+
+## オプション
+
+### ✅ テクスチャ画像をフォルダに展開
+
+VRMファイルの配置場所と同じ場所にフォルダを作成し、VRMファイル内に存在するテクスチャを展開します。
+チェックをしない場合、テクスチャは現在編集中の `.blend`
+ファイル内に埋め込まれます。
+
+### ✅ 既に存在するテクスチャ画像のフォルダを上書きしない
+
+テクスチャ画像用のフォルダ作成時に、既にフォルダが存在している場合は連番を付与し、
+フォルダの上書きが発生しないようにします。
+
+### ✅ 3Dビューをマテリアルプレビューに設定
+
+VRMファイルの読み込み後、3Dビューポートのシェーディング設定をマテリアルプレビューに設定します。
+こちら、Blenderに慣れている人にとってはあまり意味のない設定ではありますが、
+まだ慣れていない人がインポート直後に、別プラットフォームでの表示とほぼ同じ表示を再現することによって、
+テンションを上げて欲しいという思いがあります。
+
+### ✅ ビュー変換を「標準」に設定
+
+VRMファイルの読み込み後、カラーマネージメントのビュー変換を「標準」に設定します。
+VRMファイルはBlenderのデフォルトのビュー変換設定と相性が悪く、若干くすんだ表示になることが多いです。
+ビュー変換を「標準」にすることで、この問題を解決します。
+
+### ✅ アーマチュアのビューポート表示を「ワイヤーフレーム」に設定
+
+VRMファイルの読み込み後、アーマチュアのビューポート表示を「ワイヤーフレーム」に設定します。
+
+### ✅ アーマチュアを最前面に表示
+
+VRMファイルの読み込み後、アーマチュアを最前面に表示します。
+
+### ✅ ボーンの形状表示をデフォルトのものにする
+
+VRMの親仕様であるglTF形式の公式インポーターは、ボーンの形状表示をICO球などに自動で変更することがあります。
+しかし、アドオン作者としては、主に人型のアーマチュアが展開されるVRMファイルに対してはこの動作は不自然に感じています。
+これを抑制し、デフォルトの角錐に設定します。
+
+### ✅ MToonアウトラインのプレビューを有効にする
+
+VRMに含まれるトゥーンシェーダーである「MToon」は、アニメ風のアウトラインの描画機能を含みます。
+こちらは背面法により実装されているため、有効にすると統計オーバーレイに表示される頂点数が増えたり、
+ビューポートの動作負荷が高まることがあります。無効にすることで、これらの問題を解決できます。

package/browser/addons/vrm/documentation/ja-jp/ui/import_scene.vrma/index.md

@@ -0,0 +1,14 @@
+---
+title: "VRM Animation（.vrma）のインポート"
+description: "VRM 1.0モデルにVRM Animation（.vrma）を読み込む手順を説明します。"
+---
+
+メニューの `ファイル` → `インポート` → `VRM Animation (.vrma)`
+を選択することで、 [VRM Animation](../../animation/)
+のインポートダイアログが表示されます。
+
+![](1.png)
+
+VRMAファイルを選択して `開く` ボタンを押すと、 現在のシーンのVRM
+1.0モデルにアニメーションが反映されます。 現在のシーンにVRM
+1.0モデルが存在しない場合、最小のモデルを自動生成します。

package/browser/addons/vrm/editor/__init__.py

@@ -0,0 +1 @@
+# SPDX-License-Identifier: MIT OR GPL-3.0-or-later