# Scene Handles

A handle is created for each object that is added to the scene. These can be
used to read and set state, as well as detect clicks.

When a scene node is added to a server (for example, via
:func:`viser.ViserServer.add_frame()`), state is synchronized between all
connected clients. When a scene node is added to a client (for example, via
:func:`viser.ClientHandle.add_frame()`), state is local to a specific client.

The most common attributes to read and write here are
:attr:`viser.SceneNodeHandle.wxyz` and :attr:`viser.SceneNodeHandle.position`.
Each node type also has type-specific attributes that we can read and write.
Many of these are lower-level than their equivalent arguments in factory
methods like :func:`viser.ViserServer.add_frame()` or
:func:`viser.ViserServer.add_image()`.

<!-- prettier-ignore-start -->

.. autoclass:: viser.SceneNodeHandle

.. autoclass:: viser.CameraFrustumHandle

.. autoclass:: viser.FrameHandle

.. autoclass:: viser.BatchedAxesHandle

.. autoclass:: viser.GlbHandle

.. autoclass:: viser.GridHandle

.. autoclass:: viser.Gui3dContainerHandle

.. autoclass:: viser.ImageHandle

.. autoclass:: viser.LabelHandle

.. autoclass:: viser.MeshHandle

.. autoclass:: viser.MeshSkinnedHandle

.. autoclass:: viser.MeshSkinnedBoneHandle

.. autoclass:: viser.PointCloudHandle

.. autoclass:: viser.SplineCatmullRomHandle

.. autoclass:: viser.SplineCubicBezierHandle

.. autoclass:: viser.TransformControlsHandle

.. autoclass:: viser.GaussianSplatHandle

.. autoclass:: viser.DirectionalLightHandle

.. autoclass:: viser.AmbientLightHandle

.. autoclass:: viser.HemisphereLightHandle

.. autoclass:: viser.PointLightHandle

.. autoclass:: viser.RectAreaLightHandle

.. autoclass:: viser.SpotLightHandle

<!-- prettier-ignore-end -->