From 57de35d5a9bdb53a964d7cd7541130e7af1cdbb5 Mon Sep 17 00:00:00 2001 From: bd_ Date: Thu, 20 Oct 2022 21:02:28 -0700 Subject: [PATCH] More docs --- docs/docs/reference/bone-proxy.md | 2 +- docs/docs/reference/merge-animator.md | 2 +- docs/docs/samples/index.md | 23 ++++++++++++++++++++++- docs/docs/samples/wheretofind.png | Bin 0 -> 46578 bytes 4 files changed, 24 insertions(+), 3 deletions(-) create mode 100644 docs/docs/samples/wheretofind.png diff --git a/docs/docs/reference/bone-proxy.md b/docs/docs/reference/bone-proxy.md index ecc161b7..70005dcc 100644 --- a/docs/docs/reference/bone-proxy.md +++ b/docs/docs/reference/bone-proxy.md @@ -3,7 +3,7 @@ ![Bone Proxy](bone-proxy-compare.png) The Bone Proxy allows you to place objects from your prefab inside of objects that are part of the original avatar. -For example, in the Clap sample, this is used to place contacts inside the avatar's hands. +For example, in the [Clap sample](../samples/#clap), this is used to place contacts inside the avatar's hands. Bone Proxy will also adjust any animators referencing the old location of the objects so that they reference the new paths after the objects are moved. diff --git a/docs/docs/reference/merge-animator.md b/docs/docs/reference/merge-animator.md index 3872d08c..bebec213 100644 --- a/docs/docs/reference/merge-animator.md +++ b/docs/docs/reference/merge-animator.md @@ -4,7 +4,7 @@ The merge animator component will add the provided animator to a specified layer of the avatar it is added to. This can be used to make complex AV3 gimmicks that install themselves just by dragging and dropping onto an avatar. -Two samples are included that use this component: A hand-clap effect, and a finger-pen gimmick. +[Two samples](../samples/) are included that use this component: A hand-clap effect, and a finger-pen gimmick. ## When should I use it? diff --git a/docs/docs/samples/index.md b/docs/docs/samples/index.md index ef8ff3a5..2a094407 100644 --- a/docs/docs/samples/index.md +++ b/docs/docs/samples/index.md @@ -5,4 +5,25 @@ sidebar_label: Samples # Samples -Modular Avatar comes with a few sample prefabs to demonstrate its features. +Modular Avatar comes with a few sample prefabs to demonstrate its features. These can be found under "Packages -> Modular Avatar -> Samples" in your project window. + +![Samples](wheretofind.png) + +## Fingerpen + +The fingerpen prefab is a useful pen that can be used anywhere. +Simply drop it onto your avatar, then click the "Select Menu" button in the menu installer component, and double-click the menu you want to install the fingerpen controls to. + +The fingerpen prefab demonstrates: + +* Installing animators using [Merge Animator](../reference/merge-animator.md) +* Automatically configuring [synced parameters](../reference/parameters.md) +* Setting up [menus](../reference/menu-installer.md). +* Using the [Bone Proxy](bone-proxy.md) component to place objects inside of the avatar's bones, in an avatar-agnostic way + +## Clap + +By dragging the Clap prefab onto your avatar, when you bring your hands together, you'll hear a clap sound effect, and some particles will spawn. +As with fingerpen, click the select menu button to select where to put the on/off switch. + +In addition to everything demonstrated in the fingerpen prefab, the clap sample also shows off using internal parameters with Contact Receivers to avoid parameter clashes with other components. \ No newline at end of file diff --git a/docs/docs/samples/wheretofind.png b/docs/docs/samples/wheretofind.png new file mode 100644 index 0000000000000000000000000000000000000000..05ab7cc2237e548b7fd0373cc43350305c5f7a6a GIT binary patch literal 46578 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