3.48.0

Needle Engine

• Add: Logitech MX Ink controller support
• Add: Quest menu button now shows Needle Menu in immersive-ar and immersive-vr
• Fix: Improved USDZ code generation regarding transformations/matrices
• Fix: USDZ multi-channel attribute export
• Fix: Minor jsdoc comment error
• Fix: Postprocessing Volume removeEffect does now also remove effects from assigned sharedProfile
• Internal: Warn if Rigidbody physics object could not be created due to a missing collider

Unity Integration

• Change: Update scene templates
• Internal: menu item order fix

---

Links

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

3.47.9

Unity Integration

• Change how helper tool commands are invoked and some minor fixes

---

Links

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

3.47.8

Needle Engine

• Fix: LookAt orientation fixed when both copyRotation and keepUp are active
  • If you have both options enabled and rely on the previous behaviour, toggle invertForward to get the same result as before.
• Fix: USDZExporter correctly applying arScale again
• Fix: Issue with Needle Menu buttons preventing AR or VR to start in certain cases/devices
• Fix: BatchedMesh/Instancing error after adding/removing many instances and growing the batched mesh buffers where internal state was not properly reset causing an error
• Change: Make Needle Menu text not selectable
• Change:NeedleXRSession.start("immersive-ar") now exports to USDZ when called on iOS (experimental)
• Change: Needle Menu foldout is now closed when entering XR
• Change: Remove Quit XR button for screen based AR experiences (in favor of the X icon at the top right corner)
• Change: Needle Menu foldout button has now an larger click area to avoid accidental clicks on the Needle logo
• Change: LookAt copyTargetRotation is now disabled automatically during VR/passthrough AR session

Additional changes for Needle Engine 3.47.7

• Fix: Support loading FBX files in ASCII format
• Fix: Support loading OBJ files starting with # Alias OBJ
• Change: Needle Menu buttons height adjusted for mobile

Unity Integration

• Change: OrbitControls range sliders for minAzimuthAngle and maxAzimuthAngle
• Change: Click Open Workspace button on npmdef asset will now open the vscode workspace directly (instead of the main web project workspace)
• Change: Minor USDZExporter branding wording fix

---

Links

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

Needle Engine Blender Addon 0.51.3

• Revert change in gather_animation_channel_hook method signature causing export error due to inconsistent hook in Blender's glTF exporter #2337

🎯 Download Addon 💡 Download Samples

3.47.6-pre

Needle Engine

• Add: Mathf.random() can now also accept an array to randomly select an element
• Add: AudioSource pitch property
• Add: SpriteRenderer addSprite method
• Add: SpriteRenderer texture setter to change the texture of the currently rendered sprite
• Fix: SpriteRenderer sprite setter
• Fix: OrbitControls double click to focus should not focus if the click was already used (e.g. by a button)
• Fix: XR screenshot() support
• Fix: DragControls now work with physical objects again e.g. Rigidbodies that react to gravity

Unity Integration

• Add: SkyboxGradient shader Softness property to adjust the softness of the color transition
• Add: Few more Gradient Skybox Materials
• Fix: Custom Cubemap export validation
• Fix: Npmdef component generation should allow abstract classes

---

Links

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

3.47.6

Needle Engine

• Fix: USDZ animation interpolation. We're now using timesamples for translation, orientation and scale separately. This fixes an issue with animation optimization (optimization removing redundant keyframes) to just 2 keyframes where matrix timesamples would produce unexpected interpolations
• Change: inline mesh bvh worker

Unity Integration

• Minor console log fix

---

Links

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

Needle Engine Blender Addon 0.51.2

• Fix: Export issue if addon gets disabled and user tries to export a glTF
• Update: Needle Engine to 3.47.6-beta

🎯 Download Addon 💡 Download Samples

3.47.5-pre.1

Needle Engine

• Add: screenshot option to output a texture
• Fix: screenshot method when using a camera with a RenderTexture assigned
• Fix: ObjectUtils.createPrimitive option linting
• Change: Addressables instantiate method now returns Object3D type

---

Links

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

3.47.5-pre

Needle Engine

• Fix: Shader warmup when loading glTF file containing only materials (no scenes)
• Fix: OrbitControls autoTarget option causing setLookTargetPosition to be overriden during the first frame
• Fix: Compressed RenderTexture not being updated on objects in the scene
• Fix: Physics mesh BVH generation on worker caused raycasts during processing to not work until the BVH was ready

Additional changes for Needle Engine 3.47.4-beta

• Add: Support loading of glTF files in <needle-engine src="..."> that don't contain any objects/scenes but just materials. These glTF files will be rendered with a shaderball
• Fix: three.js changing environment texture while in XR
• Fix: three.js OrbitControls zoom damping
• Fix: GroundProjectedEnv error when setting height as part of init properties as part of addComponent(..., { height: 4 })
• Fix: OrbitControls minZoom and maxZoom should be applied during update
• Fix: Regression in ParticleSystem trail rendering where mode was not set correctly
• Change: Camera backgroundBlurriness and backgroundIntensity should be undefined by default
• Change: OrbitControls fitCamera can now also take a single object as a first parameter

---

Links

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

3.47.4-pre

Needle Engine

• Add: OrbitControls fitCamera method overload which can directly take an options parameter. E.g. it can be invoked with fitCamera({ immediate: false })
• Fix: Lifecycle hooks like onStart and onInitialized are now properly called again for new subscribers
• Fix: Regression in raycasting with multi-material objects
• Fix: <needle-engine> canvas highlighting with touch on iOS
• Fix: Issue where automatic camera change stopped working
• Fix: screenshot should update the camera aspect ratio before rendering
• Fix: Physics raycasts do now run basic geometry validation
• Change: The WebGL context is now automatically restored when lost

Unity Integration

• Fix: OSX commands using npx
• Fix: Needle Engine classes declared like export default class are now automatically picked-up as well
• Internal: OSX bugreports now include the Editor.log files

---

Links

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