Skip to content

interaction.md

Latest commit

 

History

History
182 lines (129 loc) · 4.65 KB

interaction.md

File metadata and controls

182 lines (129 loc) · 4.65 KB
Raw

Interaction Traits

Part of the HoloScript Traits reference. Browse: Physics · AI & Behavior · Audio · All Traits

Interaction Traits

@grabbable

Category: Interaction Tags: physics, hands, grab, movement

Hand-based grab interactions for VR objects.

object Ball @grabbable {
  geometry: 'sphere'
}

object Ball @grabbable(grab_distance: 0.5, require_trigger: true) {
  geometry: 'sphere'
}
Config Type Default Description
grab_distance number 0.3 Maximum grab distance in meters
require_trigger boolean true Require trigger press to grab
allow_remote_grab boolean false Allow grabbing from distance
highlight_on_hover boolean true Visual feedback on hover
two_hand_mode string 'average' 'average', 'dominant', 'scale'

Events:

  • grab_start - Object grabbed
  • grab_end - Object released
  • grab_switch_hand - Transferred between hands

@throwable

Category: Interaction Tags: physics, throw, velocity, ballistic

Physics-based throwing when released from grab.

object Ball @grabbable @throwable {
  geometry: 'sphere'
}

object Ball @throwable(velocity_multiplier: 1.5, spin_enabled: true) {
  geometry: 'sphere'
}
Config Type Default Description
velocity_multiplier number 1.0 Throw velocity scale
max_velocity number 20.0 Maximum throw speed
spin_enabled boolean true Allow spin on release
angular_velocity_scale number 1.0 Rotation speed scale

Events:

  • throw_start - Object thrown with velocity data
  • throw_end - Object stopped moving

@pointable

Laser pointer/ray interaction.

object Button @pointable {
  geometry: 'cube'

  onPoint: {
    self.color = 'green'
  }
}
Config Type Default Description
pointer_distance number 10.0 Max raycast distance
highlight_color string '#00ff00' Hover highlight color
cursor_type string 'dot' 'dot', 'ring', 'arrow'

Events:

  • point_enter - Pointer enters object
  • point_exit - Pointer leaves object
  • point_click - Pointer activated on object

@hoverable

Hover state and visual feedback.

object MenuItem @hoverable {
  geometry: 'plane'

  onHoverEnter: { self.scale *= 1.1 }
  onHoverExit: { self.scale /= 1.1 }
}
Config Type Default Description
hover_scale number 1.0 Scale change on hover
hover_color string null Color change on hover
hover_sound string null Sound to play on hover

Events:

  • hover_enter - Pointer/hand enters
  • hover_exit - Pointer/hand exits

@draggable

Continuous drag movement on surfaces.

object Slider @draggable(constrain_axis: 'x') {
  geometry: 'cube'
}
Config Type Default Description
constrain_axis string null 'x', 'y', 'z', or null for free
surface_only boolean false Constrain to surface
snap_to_grid number 0 Grid snap size (0 = off)

Events:

  • drag_start - Drag initiated
  • drag_move - Position updated
  • drag_end - Drag released

@scalable

Two-handed scaling gestures.

object Model @grabbable @scalable {
  geometry: 'model/object.glb'
}

object Model @scalable(min_scale: 0.5, max_scale: 3.0) {
  geometry: 'model/object.glb'
}
Config Type Default Description
min_scale number 0.1 Minimum scale limit
max_scale number 10.0 Maximum scale limit
uniform_scale boolean true Scale all axes equally

Events:

  • scale_start - Scaling gesture started
  • scale_change - Scale value changed
  • scale_end - Scaling gesture ended

See Also