Merge pull request #1962 from ousttrue/doc/update_firstperson

[1.0] FirstPerson セットアップ記事の更新
This commit is contained in:
ousttrue 2022-12-27 15:25:29 +09:00 committed by GitHub
commit 8e89828c41
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
7 changed files with 404 additions and 175 deletions

View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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 ""

View File

@ -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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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 の可視制御 </implementation/first_person>`"
msgstr ""
"{doc}`FirstPerson and Renderer visibility control "
"</implementation/first_person>`"
#: ../../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 "ヘッドマウントディスプレイを表すカメラ と その他のカメラという2種類のカメラを想定ます。 それぞれに対して、"
#: ../../vrm1/vrm1_firstperson.md:16
msgid ""
"ヘッドマウントディスプレイを表すカメラ と その他のカメラという2種類のカメラを想定ます。 UniVRMは、レイヤー9 "
"`VRMFirstPersonOnly` と レイヤー10 `VRMThirdPersonOnly` をデフォルト値にしています。 "
"2つのレイヤーは、ランタイムロード時の引数で任意のレイヤを指定することも可能です。"
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 ""

View File

@ -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` ラベルを時限クローズ

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

BIN
docs/vrm1/tags_layers.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

View File

@ -2,13 +2,92 @@
{doc}`FirstPerson と Renderer の可視制御 </implementation/first_person>`
```{admonition} VR用の機能です
:class: warning
VRM モデルを VR アバターとして使用する場合、一人称視点でモデルの頭メッシュが見えてしまうと視界を遮ってしまいます。
これを解決するために、 VRHMD Camera の一人称視点 (FirstPerson) とそれ以外 (ThirdPerson) でメッシュの可視属性を変更する機能になります。
```
## Project設定
UniVRMの推奨する VR 向けのカメラ構成です。
ヘッドマウントディスプレイを表すカメラ と その他のカメラという2種類のカメラを想定ます。
UniVRMは、レイヤー9 `VRMFirstPersonOnly` と レイヤー10 `VRMThirdPersonOnly` をデフォルト値にしています。
2つのレイヤーは、ランタイムロード時の引数で任意のレイヤを指定することも可能です。
```{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<RuntimeGltfInstance> LoadAsync(string path)
}
```
## VRMの推奨する VR 向けのカメラ構成
## Sample
ヘッドマウントディスプレイを表すカメラ と その他のカメラという2種類のカメラを想定ます。
それぞれに対して、
複数のカメラを配置したサンプルシーンがあります。
* 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`