google/model-viewer
Model Viewer
model-viewer is a web-based 3D model viewer provided as a web component for rendering interactive three-dimensional assets and animations directly in a browser. It functions as a specialized GLTF web renderer designed to display GLTF and GLB files with settings optimized for performance and quality.
The project includes a WebXR augmented reality player that projects 3D models into real-world environments using mobile device cameras and spatial tracking. It also features a visual regression testing tool capable of generating golden images and comparing renders to detect visual regressions in 3D assets.
The system covers a broader range of capabilities including interactive 3D web display, visual post-processing effects, and automated render fidelity verification.
Features
- 3D Scene Renderers - Provides a hardware-accelerated 3D scene renderer for interactive model viewing and manipulation in the browser.
- Augmented Reality Frameworks - Implements spatial tracking and rendering to project 3D models into real-world environments.
- Interactive Web Experiences - Enables embedding interactive 3D assets in websites for user rotation, zooming, and interaction.
- GLTF Renderers - Functions as a specialized GLTF and GLB web renderer optimized for performance and quality.
- Scene Graphs - Manages a hierarchical tree of 3D objects to synchronize visual properties with HTML attributes.
- WebXR Integrations - Provides a built-in player that utilizes WebXR to project 3D models into real-world environments via mobile browsers.
- Rendering Performance Optimizations - Optimizes 3D asset rendering in the browser to balance high visual quality with performance.
- Web 3D Frameworks - Provides a high-performance web component for rendering interactive 3D assets and animations.
- Web Components - Encapsulates 3D rendering logic within a custom HTML element for a declarative developer API.
- Visual Baseline Generation - Includes a utility to create reference images for establishing visual baselines in 3D model testing.
- Post-Processing Pipelines - Implements a pipeline of shaders to apply visual filters and effects to the final rendered frame.
- Post-Processing Effects - Provides a compositing system for applying full-screen filters and effects to enhance 3D renders.
- Automated Regression Verification - Automates the verification of 3D renders against references to detect visual regressions.
- Visual Regression Testing - Provides automated comparison of current renders against golden images to ensure visual consistency.
- Visual Regression Tests - Compares 3D model renders against reference images to detect visual bugs and quality drops.
- Utility Components - Component for rendering interactive 3D models.
