iJewel3D Docs

Appearance

Changelog for @ijewel3d/web-vto ​

[0.2.9] - 2026-07-20 ​

Changed ​

  • Internal improvements.

[0.2.8] - 2026-07-13 ​

Changed ​

  • Internal improvements.

[0.2.7] - 2026-06-18 ​

Added ​

  • TryonUIPlugin (RingTryonUIPlugin) is now fully configurable via a TryonUIConfig object - pass it to the constructor (new RingTryonUIPlugin({ ... })) or update it at runtime with uiPlugin.configure({ ... }), which re-applies to the live DOM.
    • Loading box: enabled (disable entirely), title, subText (null/'' hides the subheader), logo (image URL/data-URI or raw SVG/HTML), size ('card' | 'half' | 'full'), width (custom CSS override), align ('start' | 'center' | 'end' for logo/title/subheader), background, textColor, subTextColor, showProgressBar, progressColor.
    • Hand prompt: enabled (show/hide the "show your hand" overlay), text (null/'' for outline only), showHandOutline, handSvg (override the outline markup), color.
    • Customizable messages strings (initialization, save error, and all camera/error messages).
  • TryonUIPlugin.showHandPrompt() / hideHandPrompt() to imperatively control the hand-prompt overlay.

Changed ​

  • TryonUIPlugin no longer hardcodes loading text, logo, box size/background, alignment, hand SVG, or prompt text - all driven by config (existing defaults preserved when no config is passed).

[0.2.6] - 2026-06-18 ​

Changed ​

  • Fade shader: ring distance fade-out with more smoothness; reduced finger fade occlusion factor and increased circle fade factor.

Fixed ​

  • Fade shader circle fade-out being incorrect during zoom.
  • Ring non-uniform rotation depending on aspect ratio.
  • Reset on window resize.

[0.2.5] - 2026-06-12 ​

Fixed ​

  • SSAO options not properly resetting when entering and then exiting the try-on.

[0.2.4] - 2026-06-10 ​

Added ​

  • shadowColor for SSS contact shadows.

Fixed ​

  • apply/restore zoom in _setCameraSettings()

[0.2.3] - 2026-06-04 ​

Added ​

  • enterSetupMode({ showGizmos: false }): enter setup mode with the transform gizmo created but hidden/disabled. Calling setTransformMode() re-shows it.

Fixed ​

  • Auto-fit: original child transforms now restored when fit fails (no inner boundary or validation failure) instead of leaving them zeroed.
  • Setup mode: camera position is now saved on enter and restored on exit.

[0.2.2] - 2026-05-29 ​

Fixed ​

  • Set webcam state throwing error if camera background plugin is not set.

[0.2.1] - 2026-05-29 ​

Fixed ​

  • Setting video scale changed video aspect ratio unexpectedly.

[0.2.0] - 2026-05-28 ​

Fixed ​

  • offsetRotation was incorrectly displacing ring position.
  • Incorrect transform where only the ring model was scaled, not the full setup.
  • Ring alignment now uses a single reference edge for consistent placement.
  • Occluded ring finger now shows an explicit error instead of silently failing.
  • Auto-fit placement accuracy.
  • Various setup mode issues and toolbar regressions.

[0.1.11] - 2026-05-04 ​

Added ​

  • Setup mode: shift key snapping override for transform controls.
  • Setup mode: reset functionality for all transform modes.
  • Setup mode: transform mode selector and auto-fit controls exposed in viewer setup.
  • Improved occluder accuracy for ring auto-fit, using a top-down depth-map approach.

Changed ​

  • Pose landmarker: reduced smoothing for faster response; disabled for back camera to save resources.
  • Pose landmarker: slightly faster convergence for still poses.
  • Default videoScale changed from 1.0 to 1.35.
  • Wrist width calculation in HandAnalyzer refined for better size estimation.
  • SSAO power no longer influences SSS gamma (separated concerns).
  • Occluder estimation rewritten using circle-fitting for improved auto-centering and scaling.

Fixed ​

  • Severe animation lag in TryonUIPlugin animations.
  • Transform gizmo rendering artifacts caused by FadeShaderExtension.
  • Camera depth alignment in setup mode auto-fit.

[0.1.9] - 2026-05-01 ​

Added ​

  • canRunVTO() pre-flight helper exported from the lib. Returns WebGL2/GPU/device capability check plus an optional warning for Chrome/Windows on integrated GPUs.

Removed ​

  • License/key system removed from BaseTryonPlugin; licensing is now handled solely by the underlying webgi runtime.

[0.1.8] - 2026-04-21 ​

Fixed ​

  • Fix race condition in stop method by setting _running to false right away.

[0.1.7] - 2026-04-16 ​

Changed ​

  • Hand analyzer resets on window resize to prevent stale tracking state.

[0.1.6] - 2026-04-09 ​

Added ​

  • Side fade-out at cylinder edges in live try-on mode to prevent floating shadow artifacts.

Changed ​

  • Unified SSAO and contact shadows into a single SSS computation pipeline - both now drive the same warm-skin shading path independently.
  • Improved orbit-normal line smoothing (irregularSmoothing) with a refined distance mapping function.
  • Refactored SSSFingerCylinderShadow: eliminated duplicated material/uniform/extension blocks; added updateRingTransform() for a single-call per-frame update.
  • Removed SSS wrap strength and saturation boost config parameters; simplified shader accordingly.

Fixed ​

  • Contact shadow Z-fighting artifacts between shadow cylinder and sphere end-caps.
  • SSAO warm-shading had no effect when contact shadows were disabled; AO now correctly activates the full SSS colour path.

[0.1.5] - 2026-04-07 ​

Added ​

  • Screen-space contact shadows (SSCS) for more realistic shadow rendering.
  • Alternating tracking and model inference for better performance.
  • Preliminary API documentation.

Fixed ​

  • Fix try-on running always in "IMAGE" mode.
  • Fix shadow rendering in wrist wear try-on.
  • Fix static image resize, fade shader, and default transform controls.
  • Fix borderColor and borderImage styling.

Changed ​

  • Use average landmarks for body tracking.
  • UI clean-ups and code refactoring.

[0.1.4] - 2026-03-11 ​

Fixed ​

  • Jewelry object visible in the first frame after entering try-on mode.

[0.1.3] - 2026-03-11 ​

Fixed ​

  • Inconsistent AO setting.

[0.1.2] - 2026-03-08 ​

Fixed ​

  • Video scale not applied correctly.
  • Quaternion filters improved.

[0.1.1] - 2026-03-08 ​

Fixed ​

  • Video texture lagging behind during zoom on invisible elements.
  • Error messages being to short.
  • Restore older hand tracking smoothing functions in MPHand to address degraded tracking.

[0.1.0] - 2026-03-06 ​

Added ​

  • Major refactoring of the codebase.
  • Refactor to support future try-on plugins.
  • Automatic zoom in on interaction (closer zoom of 1.5 for better experience).

Fixed ​

  • Fix occlusion for bigger jewelry like the billion dollar ring demo ring.
  • Various improvements for artifacts in fade shader and motion blur.

[0.0.41] - 2026-03-01 ​

Added ​

  • preferBackCamera option on RingTryonPlugin to allow selecting the back (environment) camera on start.

[0.0.40] - 2026-02-16 ​

Fixed ​

  • Support for larger rings (e.g. billion dollar ring demo ring) with proper occlusion (faded and SSR occluders) and shadow SSAO.
  • Less visual occlusion artifacts for poses like fist.
  • Ring try-on UI: no specific error message for most common error (camera permission denied) shown.
  • Enable quaternion filters for smoothing rotation flickering which was especially noticeable for larger rings like the billion dollar ring demo one.
  • Fix strong display artifacts when entering AR mode due to interpolation with unclamped tonemapped output color.

[0.0.39] - 2026-01-16 ​

Added ​

  • A static preload function to the RingTryonPlugin.

[0.0.38] - 2025-12-26 ​

Fixed ​

  • Disable DollyFov in camera settings.

[0.0.36] - 2025-08-29 ​

Changed ​

  • Demo page: css changes, changed 3d model.
  • minDistance change in RingTryonConfig

[0.0.35] - 2025-08-27 ​

Changed ​

  • Demo page: check for 'edit' query parameter to show UIConfig for TryOn.
  • Removed setup mode UI
  • static variables for mediapipe libraries

[0.0.34] - 2025-08-15 ​

Fixed ​

  • Minor fix: proper button display in demo when try-on start failed.

[0.0.33] - 2025-08-15 ​

Changed ​

  • Demo page: setup mode UI, try-on buttons only showing when try-on running.

Fixed ​

  • Setup mode UI: proper updating in scene when config changed.

[0.0.32] - 2025-08-06 ​

Changed ​

  • Update demo link and WebGi version to 0.15.2.

[0.0.31] - 2025-08-03 ​

Changed ​

  • Disable motion blur by default.
  • Update WebGi version to 0.15.0.

Fix ​

  • Add backwards compatibility for motion blur and WebGi pre-0.11.0.
  • Resolved issues with ring fading and hiding for certain hand poses.

[0.0.30] - 2025-08-03 ​

Changed ​

  • Refactored configuration system for improved structure and maintainability.
  • Improved motion blur effect; cleaned up and refactored related code.

Fixed ​

  • Addressed an issue where the asset was not being hidden entirely, causing an outline to be visible.
  • Camera near/far planes are now constant to address a performance issue and to prevent possible clipping artifacts.

[0.0.29] - 2025-06-17 ​

Fixed ​

  • Fix camera near/far based clipping at close range.

[0.0.28] - 2025-06-17 ​

Fixed ​

  • Revert web camera background plugin to recent version. Fix scene background reset issue introduced by reverting.

[0.0.27] - 2025-06-06 ​

Fixed ​

  • Check first for video full HD resolution.

[0.0.26] - 2025-06-06 ​

Fixed ​

  • Reverted to old web camera plugin for now.

[0.0.25] - 2025-06-06 ​

Fixed ​

  • Reverted to old web camera plugin for now.

[0.0.23] - 2025-06-02 ​

Fixed ​

  • Revert some scene config (SSR, SSAO).

[0.0.21] - 2025-05-31 ​

Fixed ​

  • Integrate latest development changes.
  • Deprecate segmenter hand analyzing. Finger width detection is now based on landmarks.
  • Adjust config and smoothing.