diff --git a/docs/locale/en/LC_MESSAGES/release_template.po b/docs/locale/en/LC_MESSAGES/release_template.po index f0ed65740..53acc77b5 100644 --- a/docs/locale/en/LC_MESSAGES/release_template.po +++ b/docs/locale/en/LC_MESSAGES/release_template.po @@ -9,77 +9,95 @@ msgid "" msgstr "" "Project-Id-Version: UniVRM Programming \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-27 17:53+0900\n" +"POT-Creation-Date: 2022-12-19 15:03+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.11.0\n" #: ../../release_template.md:1 -msgid "Download" +msgid "Release Notes" msgstr "" #: ../../release_template.md:3 -msgid "for `Unity-2020.3 LTS` or later" -msgstr "" - -#: ../../release_template.md:5 -msgid "" -"`for vrm-0.x` " -"[UniVRM-{version_hash}.unitypackage](https://github.com/vrm-c/UniVRM/releases/download/v{version}/UniVRM-{version_hash}.unitypackage)" -msgstr "" - -#: ../../release_template.md:6 -msgid "" -"`for vrm-1.0` " -"[VRM-{version_hash}.unitypackage](https://github.com/vrm-c/UniVRM/releases/download/v{version}/VRM-{version_hash}.unitypackage)" -msgstr "" - -#: ../../release_template.md:8 -msgid "ReleaseNote" -msgstr "" - -#: ../../release_template.md:9 msgid "[日本語](https://vrm-c.github.io/UniVRM/ja/release/100/v{version}.html)" msgstr "" -#: ../../release_template.md:10 +#: ../../release_template.md:4 msgid "[English](https://vrm-c.github.io/UniVRM/en/release/100/v{version}.html)" msgstr "" -#: ../../release_template.md:12 -msgid "other unitypackage" +#: ../../release_template.md:6 +msgid "Installation" msgstr "" -#: ../../release_template.md:14 -msgid "" -"`VRM-0.x API sample` " -"[UniVRM_Samples-{version_hash}.unitypackage](https://github.com/vrm-c/UniVRM/releases/download/v{version}/UniVRM_Samples-{version_hash}.unitypackage)" +#: ../../release_template.md:8 +msgid "The UniVRM supports Unity 2020.3 LTS or later." +msgstr "" + +#: ../../release_template.md:10 +msgid "You can install UniVRM using the UnityPackage or the UPM Package." +msgstr "" + +#: ../../release_template.md:12 +msgid "VRM 1.0 Import/Export" +msgstr "" + +#: ../../release_template.md:14 ../../release_template.md:24 +#: ../../release_template.md:62 +msgid "via UnityPackage" msgstr "" #: ../../release_template.md:15 msgid "" -"`VRM-1.0 API sample` " -"[VRM_Samples-{version_hash}.unitypackage](https://github.com/vrm-c/UniVRM/releases/download/v{version}/VRM_Samples-{version_hash}.unitypackage)" +"**Download " +"[VRM-{version_hash}.unitypackage](https://github.com/vrm-c/UniVRM/releases/download/v{version}/VRM-{version_hash}.unitypackage)**" msgstr "" -#: ../../release_template.md:17 -msgid "1.0 development (1.0 開発ドキュメント)" +#: ../../release_template.md:17 ../../release_template.md:27 +#: ../../release_template.md:67 +msgid "via UPM Package" msgstr "" -#: ../../release_template.md:19 -msgid "[日本語](https://vrm-c.github.io/UniVRM/ja/vrm1/index.html)" +#: ../../release_template.md:18 ../../release_template.md:28 +msgid "`com.vrmc.vrmshaders`" +msgstr "" + +#: ../../release_template.md:19 ../../release_template.md:29 +msgid "`com.vrmc.gltf`" msgstr "" #: ../../release_template.md:20 -msgid "[English](https://vrm-c.github.io/UniVRM/en/vrm1/index.html)" +msgid "`com.vrmc.vrm`" msgstr "" #: ../../release_template.md:22 -msgid "UPM" +msgid "VRM 0.x Import/Export" +msgstr "" + +#: ../../release_template.md:25 +msgid "" +"**Download " +"[UniVRM-{version_hash}.unitypackage](https://github.com/vrm-c/UniVRM/releases/download/v{version}/UniVRM-{version_hash}.unitypackage)**" +msgstr "" + +#: ../../release_template.md:30 +msgid "`com.vrmc.univrm`" +msgstr "" + +#: ../../release_template.md:32 +msgid "UPM Package Information" +msgstr "" + +#: ../../release_template.md:33 +msgid "You can install these UPM packages via Package Manager in UnityEditor." +msgstr "" + +#: ../../release_template.md:35 +msgid "`Window` -> `Package Manager` -> `+` -> `Add package from git URL...`" msgstr "" #: ../../release_template.md @@ -87,11 +105,7 @@ msgid "UPM package" msgstr "" #: ../../release_template.md -msgid "rename" -msgstr "" - -#: ../../release_template.md -msgid "UPM url" +msgid "git URL" msgstr "" #: ../../release_template.md @@ -106,10 +120,6 @@ msgstr "" msgid "com.vrmc.gltf" msgstr "" -#: ../../release_template.md -msgid "com.vrmc.unigltf" -msgstr "" - #: ../../release_template.md msgid "https://github.com/vrm-c/UniVRM.git?path=/Assets/UniGLTF#v{version}" msgstr "" @@ -126,68 +136,60 @@ msgstr "" msgid "com.vrmc.vrm" msgstr "" -#: ../../release_template.md -msgid "com.vrmc.univrm1" -msgstr "" - #: ../../release_template.md msgid "https://github.com/vrm-c/UniVRM.git?path=/Assets/VRM10#v{version}" msgstr "" -#: ../../release_template.md:45 -msgid "UPM packages and folders and unitypackage" +#: ../../release_template.md:44 +msgid "You can also install via editing `Packages/manifest.json` directly." msgstr "" -#: ../../release_template.md -msgid "folder" +#: ../../release_template.md:60 +msgid "Development" msgstr "" -#: ../../release_template.md -msgid "unitypackage" +#: ../../release_template.md:61 +msgid "Samples" msgstr "" -#: ../../release_template.md -msgid "note" +#: ../../release_template.md:63 +msgid "VRM 1.0 Development Samples" msgstr "" -#: ../../release_template.md -msgid "Assets/VRMShaders" +#: ../../release_template.md:64 +msgid "[VRM_Samples-{version_hash}.unitypackage](https://github.com/vrm-c/UniVRM/releases/download/v{version}/VRM_Samples-{version_hash}.unitypackage)" msgstr "" -#: ../../release_template.md -msgid "UniVRM-XXX, VRM-XXX" +#: ../../release_template.md:65 +msgid "VRM 0.x Development Samples" msgstr "" -#: ../../release_template.md -msgid "0.x and 1.0 shared" +#: ../../release_template.md:66 +msgid "[UniVRM_Samples-{version_hash}.unitypackage](https://github.com/vrm-c/UniVRM/releases/download/v{version}/UniVRM_Samples-{version_hash}.unitypackage)" msgstr "" -#: ../../release_template.md -msgid "Assets/UniGLTF" +#: ../../release_template.md:68 +msgid "" +"You can find `Samples` in the Package Manager and then submit `Import` " +"button." msgstr "" -#: ../../release_template.md -msgid "Assets/VRM" +#: ../../release_template.md:69 +msgid "" +"`Window` -> `Package Manager` -> `Packages: In Project` -> `VRM-1.0` or " +"`VRM`" msgstr "" -#: ../../release_template.md -msgid "UniVRM-XXX" +#: ../../release_template.md:71 +msgid "Documentation" msgstr "" -#: ../../release_template.md -msgid "import/export 0.x" +#: ../../release_template.md:73 +msgid "[日本語](https://vrm-c.github.io/UniVRM/ja/vrm1/index.html)" msgstr "" -#: ../../release_template.md -msgid "Assets/VRM10" -msgstr "" - -#: ../../release_template.md -msgid "VRM-XXX" -msgstr "" - -#: ../../release_template.md -msgid "import/export 1.0 and import 0.x" +#: ../../release_template.md:74 +msgid "[English](https://vrm-c.github.io/UniVRM/en/vrm1/index.html)" msgstr "" #~ msgid "[日本語](https://vrm-c.github.io/UniVRM/ja/release/079/v{version}.html)" @@ -196,3 +198,95 @@ msgstr "" #~ msgid "[English](https://vrm-c.github.io/UniVRM/en/release/079/v{version}.html)" #~ msgstr "" +#~ msgid "Download" +#~ msgstr "" + +#~ msgid "for `Unity-2020.3 LTS` or later" +#~ msgstr "" + +#~ msgid "" +#~ "`for vrm-0.x` " +#~ "[UniVRM-{version_hash}.unitypackage](https://github.com/vrm-c/UniVRM/releases/download/v{version}/UniVRM-{version_hash}.unitypackage)" +#~ msgstr "" + +#~ msgid "" +#~ "`for vrm-1.0` " +#~ "[VRM-{version_hash}.unitypackage](https://github.com/vrm-c/UniVRM/releases/download/v{version}/VRM-{version_hash}.unitypackage)" +#~ msgstr "" + +#~ msgid "ReleaseNote" +#~ msgstr "" + +#~ msgid "other unitypackage" +#~ msgstr "" + +#~ msgid "" +#~ "`VRM-0.x API sample` " +#~ "[UniVRM_Samples-{version_hash}.unitypackage](https://github.com/vrm-c/UniVRM/releases/download/v{version}/UniVRM_Samples-{version_hash}.unitypackage)" +#~ msgstr "" + +#~ msgid "" +#~ "`VRM-1.0 API sample` " +#~ "[VRM_Samples-{version_hash}.unitypackage](https://github.com/vrm-c/UniVRM/releases/download/v{version}/VRM_Samples-{version_hash}.unitypackage)" +#~ msgstr "" + +#~ msgid "1.0 development (1.0 開発ドキュメント)" +#~ msgstr "" + +#~ msgid "UPM" +#~ msgstr "" + +#~ msgid "rename" +#~ msgstr "" + +#~ msgid "UPM url" +#~ msgstr "" + +#~ msgid "com.vrmc.unigltf" +#~ msgstr "" + +#~ msgid "com.vrmc.univrm1" +#~ msgstr "" + +#~ msgid "UPM packages and folders and unitypackage" +#~ msgstr "" + +#~ msgid "folder" +#~ msgstr "" + +#~ msgid "unitypackage" +#~ msgstr "" + +#~ msgid "note" +#~ msgstr "" + +#~ msgid "Assets/VRMShaders" +#~ msgstr "" + +#~ msgid "UniVRM-XXX, VRM-XXX" +#~ msgstr "" + +#~ msgid "0.x and 1.0 shared" +#~ msgstr "" + +#~ msgid "Assets/UniGLTF" +#~ msgstr "" + +#~ msgid "Assets/VRM" +#~ msgstr "" + +#~ msgid "UniVRM-XXX" +#~ msgstr "" + +#~ msgid "import/export 0.x" +#~ msgstr "" + +#~ msgid "Assets/VRM10" +#~ msgstr "" + +#~ msgid "VRM-XXX" +#~ msgstr "" + +#~ msgid "import/export 1.0 and import 0.x" +#~ msgstr "" + diff --git a/docs/locale/en/LC_MESSAGES/vrm1/vrm1_firstperson.po b/docs/locale/en/LC_MESSAGES/vrm1/vrm1_firstperson.po index 49605455f..8ecd76ba8 100644 --- a/docs/locale/en/LC_MESSAGES/vrm1/vrm1_firstperson.po +++ b/docs/locale/en/LC_MESSAGES/vrm1/vrm1_firstperson.po @@ -9,105 +9,182 @@ msgid "" msgstr "" "Project-Id-Version: UniVRM Programming Document \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-10-11 16:50+0900\n" +"POT-Creation-Date: 2022-12-27 14:54+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.11.0\n" -#: ../../vrm1/vrm1_firstperson.md:1 +#: ../../vrm1/vrm1_firstperson.md:1 ../../vrm1/vrm1_firstperson.md:67 +#: ../../vrm1/vrm1_firstperson.md:81 msgid "FirstPerson" msgstr "" #: ../../vrm1/vrm1_firstperson.md:3 msgid "{doc}`FirstPerson と Renderer の可視制御 `" msgstr "" +"{doc}`FirstPerson and Renderer visibility control " +"`" #: ../../vrm1/vrm1_firstperson.md:5 -msgid "Runtime に FirstPerson 機能を有効にする" -msgstr "Enable FirstPerson function at runtime." +msgid "VR用の機能です" +msgstr "It is a function for VR" -#: ../../vrm1/vrm1_firstperson.md:7 -msgid "VR向け FirstPerson 設定の初期化手順です。" -msgstr "The VR First Person settings." - -#: ../../vrm1/vrm1_firstperson.md:9 -msgid "Load する" -msgstr "Load" - -#: ../../vrm1/vrm1_firstperson.md:10 -msgid "Vrm10Instance を取得する" -msgstr "Get Vrm10Instance" - -#: ../../vrm1/vrm1_firstperson.md:11 -msgid "`controller.Vrm.FirstPerson.SetupAsync` を呼び出す" -msgstr "Call `controller.Vrm.FirstPerson.SetupAsync`" +#: ../../vrm1/vrm1_firstperson.md:8 +msgid "" +"VRM モデルを VR アバターとして使用する場合、一人称視点でモデルの頭メッシュが見えてしまうと視界を遮ってしまいます。 これを解決するために、" +" VRHMD Camera の一人称視点 (FirstPerson) とそれ以外 (ThirdPerson) " +"でメッシュの可視属性を変更する機能になります。" +msgstr "" +"When using a VRM model as a VR avatar, the view is obstructed if the " +"model's head mesh is visible in the first person view.To solve this, it " +"becomes a function to change the visibility attribute of the mesh in the " +"VRHMD Camera's first person perspective (FirstPerson) and other " +"perspectives (ThirdPerson)." #: ../../vrm1/vrm1_firstperson.md:12 -msgid "ShowMeshes" +msgid "Project設定" +msgstr "Project Settings" + +#: ../../vrm1/vrm1_firstperson.md:14 +msgid "UniVRMの推奨する VR 向けのカメラ構成です。" msgstr "" -#: ../../vrm1/vrm1_firstperson.md:41 -msgid "VRMの推奨する VR 向けのカメラ構成" -msgstr "Recommended camera layer settings" - -#: ../../vrm1/vrm1_firstperson.md:43 -msgid "ヘッドマウントディスプレイを表すカメラ と その他のカメラという２種類のカメラを想定ます。 それぞれに対して、" +#: ../../vrm1/vrm1_firstperson.md:16 +msgid "" +"ヘッドマウントディスプレイを表すカメラ と その他のカメラという２種類のカメラを想定ます。 UniVRMは、レイヤー9 " +"`VRMFirstPersonOnly` と レイヤー10 `VRMThirdPersonOnly` をデフォルト値にしています。 " +"２つのレイヤーは、ランタイムロード時の引数で任意のレイヤを指定することも可能です。" msgstr "" -"Suppose your scene has a camera that represents a head-mounted display " -"and other cameras." +"Consider two types of cameras: cameras representing head-mounted displays and other cameras." +"UniVRM defaults to Layer 9 `VRMFirstPersonOnly` and Layer 10 `VRMThirdPersonOnly`." +"The two layers can also be specified with an argument when loading the runtime." -#: ../../vrm1/vrm1_firstperson.md:46 -msgid "FIRSTPERSON_ONLY_LAYER(このレイヤーを指定した gameObject はその他のカメラから消えます)" +#: ../../vrm1/vrm1_firstperson.md:20 +msgid "VRMFirstPersonOnly" +msgstr "" + +#: ../../vrm1/vrm1_firstperson.md:21 +msgid "このレイヤーを指定した gameObject はその他のカメラから消えます" msgstr "" "FIRSTPERSON_ONLY_LAYER(The gameObject that specifies this layer " "disappears from other cameras)" -#: ../../vrm1/vrm1_firstperson.md:47 -msgid "THIRDPERSON_ONLY_LAYER(このレイヤーを指定した gameObject はヘッドマウントディスプレイから消えます)" +#: ../../vrm1/vrm1_firstperson.md:23 +msgid "例: カンペなど特殊用途？" +msgstr "Example: Special use such as a competition?" + +#: ../../vrm1/vrm1_firstperson.md:26 +msgid "VRMThirdPersonOnly" +msgstr "" + +#: ../../vrm1/vrm1_firstperson.md:28 +msgid "このレイヤーを指定した gameObject はヘッドマウントディスプレイから消えます" msgstr "" "THIRDPERSON_ONLY_LAYER(The gameObject that specifies this layer " "disappears from the head-mounted display)" -#: ../../vrm1/vrm1_firstperson.md:49 -msgid "を定義します。 これにより、ヘッドマウント視点のアバターの描画を抑止しつつ、他者からは見えるようにします。" -msgstr "" -"Stops drawing the avatar from the head-mounted display perspective and " -"makes it visible to other cameras." +#: ../../vrm1/vrm1_firstperson.md:30 +msgid "例: アバターの頭、髪の毛、メガネなどの描画を抑止して前が見えるようにする" +msgstr "Example: Suppress the drawing of the avatar's head, hair, glasses, etc. so that the front can be seen" -#: ../../vrm1/vrm1_firstperson.md:52 -msgid "例: アバターの頭の描画を抑止して前が見えるようにする" -msgstr "Example: Stop drawing the avatar's head so you can see the front" - -#: ../../vrm1/vrm1_firstperson.md:54 -msgid "VRMは、`VRMFirstPersonOnly` と `VRMThirdPersonOnly` という名前のレイヤーを予約しています。" -msgstr "VRM reserves layers named `VRMFirstPersonOnly` and` VRMThirdPersonOnly`." - -#: ../../vrm1/vrm1_firstperson.md:56 +#: ../../vrm1/vrm1_firstperson.md:33 msgid "" "`Project Settings` - `Tags and Layers` に `VRMFirstPersonOnly` と " -"`VRMThirdPersonOnly` を 設定してください。 サンプルでは、それぞれに `9` と `10` を割り当ています。" +"`VRMThirdPersonOnly` を 設定してください。" msgstr "" "Please set `VRMFirstPersonOnly` and` VRMThirdPersonOnly` to `Project " -"Settings`-`Tags and Layers`. In the sample, we assign `9` and` 10` to " -"each." +"Settings`-`Tags and Layers`." -#: ../../vrm1/vrm1_firstperson.md:60 -msgid "初期化時に layer を明示する" -msgstr "Specify layer at initialization" +#: ../../vrm1/vrm1_firstperson.md:37 +msgid "Tags & Layers" +msgstr "" + +#: ../../vrm1/vrm1_firstperson.md:40 +msgid "デフォルトのレイヤー番号" +msgstr "Default layer number" + +#: ../../vrm1/vrm1_firstperson.md:44 +msgid "デフォルトは `FirstPerson = 9`, `ThirdPerson = 10` です。" +msgstr "The default is `FirstPerson = 9`, `ThirdPerson = 10`." + +#: ../../vrm1/vrm1_firstperson.md:46 +msgid "`FirstPerson.SetupAsync` の引数で指定できます。" +msgstr "Can be specified as an argument to `FirstPerson.SetupAsync`." + +#: ../../vrm1/vrm1_firstperson.md:54 +msgid "カメラ構成" +msgstr "Camera configuration" + +#: ../../vrm1/vrm1_firstperson.md:55 +msgid "FirstPerson: MainCamera の CullingMask" +msgstr "" + +#: ../../vrm1/vrm1_firstperson.md:57 +msgid "シーンに VR 用のカメラ(HMD)を配置して `CullingMask` の FirstPerson をチェックします。" +msgstr "Place a VR camera (HMD) in the scene and check FirstPerson of `CullingMask`." + +#: ../../vrm1/vrm1_firstperson.md:59 +msgid "VR用のカメラ" +msgstr "Camera for VR" #: ../../vrm1/vrm1_firstperson.md:62 -msgid "追加の引数で指定できます。" -msgstr "It can be specified with an additional argument." +msgid "XRRig など VR向けの1人称描画のカメラです。 通常、 `main` カメラになります。" +msgstr "" +"A first-person rendering camera for VR. This is usually the `main` " +"camera.. This is usually the `main` camera." -#~ msgid "" -#~ "`controller.Vrm.FirstPerson.SetupAsync` した結果新規に作成されたモデルを " -#~ "`RuntimeGltfInstance` に渡す" -#~ msgstr "" -#~ "Add the result of " -#~ "`controller.Vrm.FirstPerson.SetupAsync` to " -#~ "`RuntimeGltfInstance`" +#: ../../vrm1/vrm1_firstperson.md:70 +msgid "ThirdPerson: OtherCamera の CullingMask" +msgstr "" +#: ../../vrm1/vrm1_firstperson.md:72 +msgid "シーンに HMD 以外の追加のカメラを配置して `CullingMask` の ThirdPerson をチェックします。" +msgstr "Place an additional camera in the scene other than the HMD and check ThirdPerson for `CullingMask`." + +#: ../../vrm1/vrm1_firstperson.md:74 +msgid "三人称用のカメラ" +msgstr "Third person camera" + +#: ../../vrm1/vrm1_firstperson.md:77 +msgid "鏡や配信用の RenderTexture のカメラです。" +msgstr "RenderTexture cameras for mirrors and streams." + +#: ../../vrm1/vrm1_firstperson.md:84 +msgid "Runtime に FirstPerson 機能を有効にする" +msgstr "Enable FirstPerson function at runtime." + +#: ../../vrm1/vrm1_firstperson.md:86 +msgid "VR向け FirstPerson 設定の初期化手順です。" +msgstr "The VR First Person settings." + +#: ../../vrm1/vrm1_firstperson.md:88 +msgid "Load する" +msgstr "Load" + +#: ../../vrm1/vrm1_firstperson.md:89 +msgid "Vrm10Instance を取得する" +msgstr "Get Vrm10Instance" + +#: ../../vrm1/vrm1_firstperson.md:90 +msgid "`Vrm10Instance.Vrm.FirstPerson.SetupAsync` を呼び出す" +msgstr "Call `Vrm10Instance.Vrm.FirstPerson.SetupAsync`" + +#: ../../vrm1/vrm1_firstperson.md:91 +msgid "ShowMeshes" +msgstr "" + +#: ../../vrm1/vrm1_firstperson.md:120 +msgid "Sample" +msgstr "" + +#: ../../vrm1/vrm1_firstperson.md:122 +msgid "複数のカメラを配置したサンプルシーンがあります。" +msgstr "" + +#: ../../vrm1/vrm1_firstperson.md:124 +msgid "`Assets/VRM10_Samples/VRM10FirstPersonSample`" +msgstr "" diff --git a/docs/release/100/v0.108.0.md b/docs/release/100/v0.108.0.md index 1f36bed84..75160495f 100644 --- a/docs/release/100/v0.108.0.md +++ b/docs/release/100/v0.108.0.md @@ -1,16 +1,16 @@ # v0.108.0: Assets直下の Import がエラーになるバグの修正 -# 🐛 バグ修正 +## 🐛 バグ修正 * [[\#1941](https://github.com/vrm-c/UniVRM/pull/1941)] [107] Assets 直下に vrm を配置すると例外になるのを修正 -# gltf +## gltf * [[\#1949](https://github.com/vrm-c/UniVRM/pull/1949)] Implement interleaved vertex layout with byteStride -# openxr +## openxr * [[\#1937](https://github.com/vrm-c/UniVRM/pull/1937)] Fix10/fix openxr rig * [[\#1933](https://github.com/vrm-c/UniVRM/pull/1933)] [1.0] XR_EXT_hand_tracking の Rotation に対応した ControlRig の生成 -# materialリファクタリング +## materialリファクタリング * [[\#1945](https://github.com/vrm-c/UniVRM/pull/1945)] Specify a Shader instead of a string in MaterialDescriptor. * [[\#1944](https://github.com/vrm-c/UniVRM/pull/1944)] Remove concrete VRM shader's info from UniGLTF. * [[\#1942](https://github.com/vrm-c/UniVRM/pull/1942)] Refactor MaterialDesciptorGenerator @@ -19,7 +19,7 @@ * Merge branch 'master' of https://github.com/vrm-c/UniVRM into refactorMaterialImport * [[\#1920](https://github.com/vrm-c/UniVRM/pull/1920)] Fix the error of emissiveFactor when importing into URP Lit shader. -# その他 +## その他 * [[\#1943](https://github.com/vrm-c/UniVRM/pull/1943)] UniVRM-0.108.0 * [[\#1946](https://github.com/vrm-c/UniVRM/pull/1946)] fix test * [[\#1947](https://github.com/vrm-c/UniVRM/pull/1947)] `help wanted` ラベルを時限クローズ diff --git a/docs/vrm1/check_firstperson.jpg b/docs/vrm1/check_firstperson.jpg new file mode 100644 index 000000000..d1393b733 Binary files /dev/null and b/docs/vrm1/check_firstperson.jpg differ diff --git a/docs/vrm1/check_thirdperson.jpg b/docs/vrm1/check_thirdperson.jpg new file mode 100644 index 000000000..c6be3f60e Binary files /dev/null and b/docs/vrm1/check_thirdperson.jpg differ diff --git a/docs/vrm1/tags_layers.jpg b/docs/vrm1/tags_layers.jpg new file mode 100644 index 000000000..7350879c5 Binary files /dev/null and b/docs/vrm1/tags_layers.jpg differ diff --git a/docs/vrm1/vrm1_firstperson.md b/docs/vrm1/vrm1_firstperson.md index ad119eb48..1181e8da8 100644 --- a/docs/vrm1/vrm1_firstperson.md +++ b/docs/vrm1/vrm1_firstperson.md @@ -2,13 +2,92 @@ {doc}`FirstPerson と Renderer の可視制御 ` +```{admonition} VR用の機能です +:class: warning + +VRM モデルを VR アバターとして使用する場合、一人称視点でモデルの頭メッシュが見えてしまうと視界を遮ってしまいます。 +これを解決するために、 VRHMD Camera の一人称視点 (FirstPerson) とそれ以外 (ThirdPerson) でメッシュの可視属性を変更する機能になります。 +``` + +## Project設定 + +UniVRMの推奨する VR 向けのカメラ構成です。 + +ヘッドマウントディスプレイを表すカメラ と その他のカメラという２種類のカメラを想定ます。 +UniVRMは、レイヤー9 `VRMFirstPersonOnly` と レイヤー10 `VRMThirdPersonOnly` をデフォルト値にしています。 +２つのレイヤーは、ランタイムロード時の引数で任意のレイヤを指定することも可能です。 + +```{admonition} VRMFirstPersonOnly +このレイヤーを指定した gameObject はその他のカメラから消えます + +例: カンペなど特殊用途？ +``` + +```{admonition} VRMThirdPersonOnly + +このレイヤーを指定した gameObject はヘッドマウントディスプレイから消えます + +例: アバターの頭、髪の毛、メガネなどの描画を抑止して前が見えるようにする +``` + +`Project Settings` - `Tags and Layers` に `VRMFirstPersonOnly` と `VRMThirdPersonOnly` を +設定してください。 + +```{figure} ./tags_layers.jpg +Tags & Layers +``` + +````{admonition} デフォルトのレイヤー番号 +:class: info + +デフォルトは `FirstPerson = 9`, `ThirdPerson = 10` です。 + +`FirstPerson.SetupAsync` の引数で指定できます。 + +```csharp +var created = await controller.Vrm.FirstPerson.SetupAsync( + controller.gameObject, firstPersonOnlyLayer: 9, thirdPersonOnlyLayer: 10); +``` + +```` + +## カメラ構成 +### FirstPerson: MainCamera の CullingMask + +シーンに VR 用のカメラ(HMD)を配置して `CullingMask` の FirstPerson をチェックします。 + +```{admonition} VR用のカメラ +:class: info + +XRRig など VR向けの1人称描画のカメラです。 +通常、 `main` カメラになります。 +``` + +```{figure} ./check_firstperson.jpg +FirstPerson +``` + +### ThirdPerson: OtherCamera の CullingMask + +シーンに HMD 以外の追加のカメラを配置して `CullingMask` の ThirdPerson をチェックします。 + +```{admonition} 三人称用のカメラ +:class: info + +鏡や配信用の RenderTexture のカメラです。 +``` + +```{figure} ./check_thirdperson.jpg +FirstPerson +``` + ## Runtime に FirstPerson 機能を有効にする VR向け FirstPerson 設定の初期化手順です。 1. Load する 2. Vrm10Instance を取得する -3. `controller.Vrm.FirstPerson.SetupAsync` を呼び出す +3. `Vrm10Instance.Vrm.FirstPerson.SetupAsync` を呼び出す 4. ShowMeshes ```csharp @@ -38,29 +117,8 @@ async Task LoadAsync(string path) } ``` -## VRMの推奨する VR 向けのカメラ構成 +## Sample -ヘッドマウントディスプレイを表すカメラ と その他のカメラという２種類のカメラを想定ます。 -それぞれに対して、 +複数のカメラを配置したサンプルシーンがあります。 -* FIRSTPERSON_ONLY_LAYER(このレイヤーを指定した gameObject はその他のカメラから消えます) -* THIRDPERSON_ONLY_LAYER(このレイヤーを指定した gameObject はヘッドマウントディスプレイから消えます) - -を定義します。 -これにより、ヘッドマウント視点のアバターの描画を抑止しつつ、他者からは見えるようにします。 - -例: アバターの頭の描画を抑止して前が見えるようにする - -VRMは、`VRMFirstPersonOnly` と `VRMThirdPersonOnly` という名前のレイヤーを予約しています。 - -`Project Settings` - `Tags and Layers` に `VRMFirstPersonOnly` と `VRMThirdPersonOnly` を -設定してください。 -サンプルでは、それぞれに `9` と `10` を割り当ています。 - -## 初期化時に layer を明示する - -追加の引数で指定できます。 - -```csharp -var created = await controller.Vrm.FirstPerson.SetupAsync(controller.gameObject, firstPersonOnlyLayer: 9, thirdPersonOnlyLayer: 10); -``` +- `Assets/VRM10_Samples/VRM10FirstPersonSample`