Objects

1. The Objects section, with the number of rows and + Add in its title line.
2. The row's object.
3. The row's Shown or Hidden choice.
4. The × that removes the row.
5. The drop area: drag objects from the Hierarchy onto it, or anywhere on the section.

When to use it

Use the Objects section to show or hide whole parts of the avatar: a hat, a jacket, glasses, a prop. One toggle can show some pieces and hide others in the same press.

• To change a shape of a mesh, such as a smile, use Blend shape rows.
• To change only a colour or a value of a material, use Material properties.

A toggle and a trigger have this section. A radial does not, since it has no on and off. On a toggle, and on a trigger that has effects of its own, the section always shows, even while it is empty. A trigger in Flip mode has none.

Settings

Objects

Shown in: Simple and Advanced, always · Default: no rows · Choices: objects of this avatar

The list of objects. Drag one or more objects from the Hierarchy onto the section to add a row for each. An object the section already lists is not added twice. + Add adds an empty row to fill in. Drag a row by its left edge to change the order. On a narrow inspector, a row's controls wrap onto a second line, and the × that removes the row stays at its top right.

The object

Shown in: Simple and Advanced · Default: empty · Choices: an object of this avatar

The object the row shows or hides. Drag it from the Hierarchy onto the field, or press the small circle at the field's right end. A list opens with the avatar's own objects only, and a search field. An object that is switched off in the Hierarchy is listed too, marked (inactive).

Shown or Hidden

Shown in: Simple and Advanced · Default: Shown · Choices: Shown, Hidden

Shown shows the object while the toggle is on and hides it while it is off. Hidden does the opposite: it hides the object while the toggle is on, for a piece that the new one covers.

AvatarDoc sets the object this way whatever it looks like in the scene, so you do not have to switch pieces on or off in the Hierarchy before you upload. On a trigger, on means while the trigger fires.

Pick by hand when copying

Shown in: Advanced · Default: Off · Choices: On, Off

Right-click a row and choose Pick by hand when copying for the row's object. When you copy the menu to another avatar, the window then has you pick the object to use on the other version instead of looking at the same place, for an object a world drop holds, for example. The component lists every marked object under Pick by hand.

What AvatarDoc builds

Each row switches its object on in one state of the entry's layer and off in the other. A toggle and a trigger that both switch the same object fight over it while both are on. The one AvatarDoc builds later wins, and a note says so. Triggers come after every menu control.

Messages

• A target is missing: a row has no object, or its object is gone. AvatarDoc skips the row.
• A target is not part of the avatar.
• More than one control changes the same thing.

Related

• Toggle clothing and accessories
• Make one-of-many choices
• Your first toggle