Skip to content

5.1.0-alpha.7

Choose a tag to compare

View all tags
@marwie marwie released this 29 May 14:46
· 42 commits to main since this release
release/5.1.0-alpha.7
e07f728

Highlights:

  • Major DragControls upgrade — new constraint system with scale limits, refined regions, and a dedicated AR drag mode
  • Updated MaterialX runtime with faster environment lighting and PMREM support
  • Updated Unity build pipeline with WAV audio and HDRi (FASTHDR) compression

Needle Engine

Added

  • DragControls received a substantial round of improvements with a new constraint system, including a keepScale option, a two-touch scale constraint with min/max limits, refined hit regions, and a dedicated screen-space AR drag mode
  • Skybox: new background-rotation and environment-rotation HTML attributes, plus background-image-loaded and environment-image-loaded events to react to skybox load completion
  • Input: input cancellation support (e.g. when a pointer is disconnected mid-interaction)
  • loadPMREM: auto-detects image format for extensionless URLs
  • AudioSource: .opus clip URLs are now supported
  • GroundProjectionEnv.applyOnAwake now defaults to true, matching Unity and Blender behaviour

Changed

  • OrbitControls: lockLookAtTarget now preserves the pointer target when double-clicking to focus
  • PostProcessing: pixelation granularity adapts dynamically to device pixel ratio
  • DragControls: rotation is now limited to two-touch and XR controller input for more predictable single-touch dragging
  • Hardened internal logging: secrets (API keys, tokens, JWTs, PEM keys, URL credentials, …) are now redacted before logs are written to disk — a defensive measure so log files shared during debugging never leak credentials

Fixed

  • DragControls: improved reliability across snap points, screen-space AR drag mode, double-click handling, XZPlane side-view and Y-axis behaviour, multi-input rotation, and touch handover (NE-4418, NE-5413, NE-5887, NE-5891)
  • Camera: improved fallback camera and CameraUtils lifecycle handling, and fitCamera stability when meshes are parented to the target camera
  • Context.clear() now resets mainCamera and fallbackCamera so they always point at live cameras after a scene wipe
  • Skybox: more efficient attribute handling — load cycles are deduplicated, background-intensity is honoured, and magic-name skyboxes resolve correctly when attributes are set at mount time
  • VideoPlayer.isPlaying now reports streamed sources and file playback independently and correctly
  • DropListener: loadFromFile now always resolves
  • Progressive LOD: more reliable instancing, request scheduling, vertex count handling, texture LOD tracking, and disposal lifecycle
  • VoIP: better mic stream handling on iOS, accurate setMuted for incoming streams, clamped volume, shared AudioContext, and coalesced concurrent connect() calls
  • Custom model loaders: MIME type check moved earlier so custom loaders reliably take over
  • General reliability improvements across webmanifest handling, dependency watcher, DTS generation, AI helper install, and file logger

MaterialX

  • Updated bundled MaterialX runtime to 1.7.0 with faster environment lighting (new radiance sampling modes, PMREM support), better integration with Three.js (texture sampling, environment rotation, alpha modes), and overall performance improvements
  • Unity: MaterialX export in Needle Engine projects no longer requires a PRO license

Unity Integration

  • Updated to @needle-tools/gltf-build-pipeline 3.0 — a major version bump that adds WAV audio compression and HDRi → PMREM (FASTHDR) compression to the build pipeline
  • Updated to needle-cloud CLI version 2 with security hardening
  • Add: context menu action to compress the output directory (required when a scene uses SceneSwitcher with dependencies)

Links

Download for Unity • Download for Blender • Documentation • API • Live Samples

Assets 2
Loading