Movable

The Movable component wraps objects to make them draggable and repositionable. This is essential for:

Creating interactive robot teleoperation interfaces
Building drag-and-drop 3D editors
Allowing users to reposition objects in VR/AR
Implementing interactive demonstrations

Basic Usage

A minimal example that creates a draggable gripper:

python

import asyncio
from vuer import Vuer, VuerSession
from vuer.schemas import DefaultScene, Movable, Gripper, Sphere, OrbitControls

app = Vuer()

@app.add_handler("OBJECT_MOVE")
async def handler(event, session):
    print(f"Movement Event: key-{event.key}", event.value)

@app.spawn(start=True)
async def main(session: VuerSession):
    session.set @ DefaultScene(
        Movable(
            Gripper(key="gripper"),
            Sphere(args=[0.15], position=[0.3, 0, 0], key="sphere"),
            key="movable-gripper",
            position=[0, 0.5, 0],
        ),
        bgChildren=[OrbitControls(key="OrbitControls")]
    )

    while True:
        await asyncio.sleep(1.0)

Key Parameters

Parameter	Type	Default	Description
`key`	str	-	Unique identifier for the movable wrapper
`offset`	list	`[0,0,0]`	Optional [x, y, z] offset from the position
`position`	list	`[0,1,-1]`	Initial [x, y, z] position in world coordinates
`quaternion`	list	-	Optional [x, y, z, w] quaternion rotation
`rotation`	list	-	Optional [x, y, z] Euler rotation
`scale`	float/list	`0.1`	Float or [x, y, z] scale factor
`handle`	float/list	-	Optional handle size (overrides scale for handle geometry)
`showFrame`	bool	`True`	Show coordinate frame visualization
`wireframe`	bool	`False`	Enable wireframe rendering
`localRotation`	bool	`False`	Use local rotation instead of world rotation