Pano2VR 8.1 Docs / Interactive 3D Object
This is beta documentation. View the latest stable documentation.

Create an Interactive 3D Object

Make the parts of a 3D model react to visitors. A click on an object can play one of the model's animations, and pointing at it can show a label, all set up in the Skin Editor with the object's name as a Proxy ID.

A 3D model in your tour does not have to be a static backdrop. The objects a model is built from, like a door, a drawer, or a machine part, can react when visitors click them or point at them. In this example, a click on a door plays the model’s door animation, and a label appears while the mouse is over the door.

Any skin element can listen to the objects of a model, the same way it listens to hotspots: put the object’s name in the element’s Proxy ID, and the element’s mouse actions run when a visitor clicks, double-clicks, or points at that object.

Prepare the Model

This works with 3D meshes in GLB or glTF format, because their objects have names. Before you export the model from your 3D software:

  1. Give each part that should react its own object with a clear name, for example Door.

  2. Add the animations you want to play, for example DoorOpen.

  3. Export the model as GLB.

Find the Object and Animation Names

  1. Drag the model into the Tour Browser and select it.

  2. Open the Overview panel. It lists the model’s Object Names and Animations.

  3. Right-click the object you want to use and choose Copy Text.

Play an Animation on Click

  1. Open the Skin Editor for your web output.

  2. Add a Container to the skin.

  3. In the container’s Advanced properties, paste the object name into the Proxy ID field.

  4. Double-click in the Actions panel to add a new action.

  5. Set Source to Mouse Click and Action to 3D Models.

  6. Choose Play Animation as the Type.

  7. Choose the animation from the Animation menu, or type its name.

  8. Set Loops to 1 to play the animation once, or to 0 to repeat it endlessly.

  9. Save the skin, then generate the output and test it in the browser.

A click on the door now plays the animation. A drag that starts on the door still turns the view; only a click runs the action. On touch screens, a tap counts as a click.

★ Tip  To stop or pause the animation again, add a second action with Stop Active Animation or Play/Pause Active Animation as the Type.

Show a Label While Pointing at the Object

  1. Add a Text element inside the container, enter the label, and deselect Visible.

  2. Select the container and add an action with Source set to Mouse Enter, Action set to Visibility, Type set to Show Element, and the text element as the Target.

  3. Add a second action with Source set to Mouse Leave and Type set to Hide Element for the same target.

  4. Save the skin and generate the output.

Mouse Enter and Mouse Leave need a mouse, so on touch screens the label does not appear.

React to Several Objects

To let one element react to several objects, start the Proxy ID with # and follow it with a regular expression. For example, #Door matches every object whose name contains Door, such as Door_Kitchen and Door_Hall. A Proxy ID of * matches every object of the model, and every hotspot as well.

See also…

Last modified: Sep 23, 2026