Scene Inspector Dialog: Difference between revisions

From Resonite Wiki
Rewrote more things, and removed references to (most of the) buttons on the right side as it's a bit redundant to have the function told to you, and then later in the article the button functions are shown.
 
add alt text to images
Line 1: Line 1:
[[File: SceneInspector.png|frame|500px|<center>The '''Scene Inspector''' as seen in Resonite, with a slot containing a [[BoxMesh (Component)|Box Mesh]] selected</center>]]
[[File: SceneInspector.png|frame|500px|<center>The '''Scene Inspector''' as seen in Resonite, with a slot containing a [[BoxMesh (Component)|Box Mesh]] selected</center>|alt=Scene inspector window being divided in two columns. On the left the hierarchy of the object and the right showing all the components on the selected slot]]
==Scene Inspector== <!--T:1-->
==Scene Inspector== <!--T:1-->


Line 41: Line 41:
|Icon||Name||Use
|Icon||Name||Use
|-
|-
|[[File:Remove-RemoveAssets.png|50x50px]]
|[[File:Remove-RemoveAssets.png|50x50px|Red trash bin]]
|Destroy
|Destroy
|Destroys the slot and its children
|Destroys the slot and its children
|-
|-
|[[File:Remove-PreserveAssets.png|50x50px]]
|[[File:Remove-PreserveAssets.png|50x50px|Red recycling icon]]
|Destroy Preserving Assets
|Destroy Preserving Assets
|Destroys the slot and its children, but moves things like materials and meshes out first so that they aren't lost
|Destroys the slot and its children, but moves things like materials and meshes out first so that they aren't lost
|-
|-
|[[File:CreateParent.png|50x50px]]
|[[File:CreateParent.png|50x50px|Green arrow pointing up then right to a purple line with a green plus]]
|Insert Parent
|Insert Parent
|Inserts an empty slot as a parent of the currently selected slot. The parent gets the position, rotation, and scale of the slot, and the slot's position, rotation and scale are reset.
|Inserts an empty slot as a parent of the currently selected slot. The parent gets the position, rotation, and scale of the slot, and the slot's position, rotation and scale are reset.
|-
|-
|[[File:CreateChild.png|50x50px]]
|[[File:CreateChild.png|50x50px|Green arrow pointing down then right to a purple line with a green plus]]
|Add Child
|Add Child
|Adds an empty slot as a child of the currently selected slot
|Adds an empty slot as a child of the currently selected slot
|-
|-
|[[File:Duplicate.png|50x50px]]
|[[File:Duplicate.png|50x50px|Green copy icon]]
|Duplicate
|Duplicate
|Creates a copy of the currently selected slot
|Creates a copy of the currently selected slot
|-
|-
|[[File:Inspector-SetRoot.png|50x50px]]
|[[File:Inspector-SetRoot.png|50x50px|Two white arrows pointing to a purple line from above and below]]
|Set Root
|Set Root
|Sets the currently selected slot as the root of the hierarchy view. Useful for drilling down into deeply nested hierarchies.
|Sets the currently selected slot as the root of the hierarchy view. Useful for drilling down into deeply nested hierarchies.
|-
|-
|[[File:Pin.png|50x50px]]
|[[File:Pin.png|50x50px|Orange pin]]
|Pin
|Pin
|Pins the inspector to you, making it move when you move around (excluding movement around your playspace)
|Pins the inspector to you, making it move when you move around (excluding movement around your playspace)
|-
|-
|[[File:Close.png|50x50px]]
|[[File:Close.png|50x50px|Red circle X mark]]
|Close
|Close
|Closes the inspector
|Closes the inspector
|-
|-
|[[File:Goto-ObjectRoot.png|50x50px]]
|[[File:Goto-ObjectRoot.png|50x50px|White arrow pointing up with two purple lines on its side]]
|Object Root
|Object Root
|Focuses the hierarchy on the object root for the current selected slot (e.g. a User slot, an avatar root slot, etc.)
|Focuses the hierarchy on the object root for the current selected slot (e.g. a User slot, an avatar root slot, etc.)
|-
|-
|[[File:Goto-Parent.png|50x50px]]
|[[File:Goto-Parent.png|50x50px|Small white arrow with a purple line on top and a white line on the bottom]]
|Root Up
|Root Up
|Focuses the hierarchy on the parent of the current root, thus moving up one level
|Focuses the hierarchy on the parent of the current root, thus moving up one level
|}
|}

Revision as of 12:01, 12 January 2024

Scene inspector window being divided in two columns. On the left the hierarchy of the object and the right showing all the components on the selected slot
The Scene Inspector as seen in Resonite, with a slot containing a Box Mesh selected

Scene Inspector

The scene inspector is used to navigate all objects in a world and view and edit the properties of any object. The scene inspector will let you modify absolutely anything in your current world. This includes things that could break how you interact with the world, so use caution when changing things off the root node that you are not familiar with. You can always quit and come back to reset everything though; you won't break anything permanently unless you save changes to the world, so feel free to experiment.

Basic Layout of Scene Inspector:

The left pane contains the scene hierarchy:

  • Double-trigger-click a Slot to select it. The currently selected item's name will be colored Yellow. The item will also be selected in the world.
  • Drag an Slot using the grip button and release it on top of a different item to move it. This re-parents the dragged item.
  • Dragging a Slot with grip can also be used to open a new Scene Inspector by using the grip button on the controller to grab the slot, and then pressing the trigger.
  • You can reference a slot in ProtoFlux by taking a ProtoFlux Tool, grabbing the slot with it, opening the Context Menu, and clicking "Reference".
  • Slots with a filled circle in front of them have no children.
  • Slots with a box with an arrow in front of them have children; click the box to expand the hierarchy at that point.
  • Slots with a downward pointing arrow are expanded; click the arrow to collapse.
  • To go up one level in the hierarchy, click the upward pointing arrow at the top left. Note that this does not change the selected slot, you will have to double-trigger-click to change the selection.
  • To navigate to the root of the current object, click the up arrow with the double tail. The root of an object is defined using components.
  • To set the current slot as the base of the visible hierarchy in the inspector, click the downward pointing arrow at the top right. Viewing the hierarchy from the root can cause lag, so this can help with performance. Also, in deep hierarchies the item names can get small and hard to read, and resetting the visible hierarchy will help with that.
  • Orange colored items are not persistent and won't be saved when the world is saved.

The right pane contains the object properties and components:

  • The basic slot properties like name, position, and rotation are at the top. All attached components will be below this. Trigger-drag to scroll the list.
  • There are many buttons on the top right, which are detailed in Buttons.
  • Trigger-click on any property to edit it.
  • Grip-drag on any property to copy the value, and drop it on any other value to paste. This works between separate scene inspector dialogs and also works on ProtoFlux Nodes.
  • Grip-drag on a property name to get a reference to that property. This is used for certain components.
  • Grip-drag on a component's property with the ProtoFlux Tool and open your Context Menu to create a ProtoFlux node for that component.
  • The trash can next to a component name will delete that component.
  • The green duplicate button next to a component name will duplicate the component.
  • The circle with a slash through it to the right of a reference field will clear that field (change from a reference to null).
  • The upward pointing arrow to the left of a reference field will open a new scene inspector dialog for the referenced object.

Buttons

Icon Name Use
Red trash bin Destroy Destroys the slot and its children
Red recycling icon Destroy Preserving Assets Destroys the slot and its children, but moves things like materials and meshes out first so that they aren't lost
Green arrow pointing up then right to a purple line with a green plus Insert Parent Inserts an empty slot as a parent of the currently selected slot. The parent gets the position, rotation, and scale of the slot, and the slot's position, rotation and scale are reset.
Green arrow pointing down then right to a purple line with a green plus Add Child Adds an empty slot as a child of the currently selected slot
Green copy icon Duplicate Creates a copy of the currently selected slot
Two white arrows pointing to a purple line from above and below Set Root Sets the currently selected slot as the root of the hierarchy view. Useful for drilling down into deeply nested hierarchies.
Orange pin Pin Pins the inspector to you, making it move when you move around (excluding movement around your playspace)
Red circle X mark Close Closes the inspector
White arrow pointing up with two purple lines on its side Object Root Focuses the hierarchy on the object root for the current selected slot (e.g. a User slot, an avatar root slot, etc.)
Small white arrow with a purple line on top and a white line on the bottom Root Up Focuses the hierarchy on the parent of the current root, thus moving up one level