Package selection guidance compiled from public package information, community data, and project usage.
A Flutter package that brings the power of Three.js and three_dart to Flutter, enabling developers to render, manipulate, and interact with 3D models across multiple platforms. It provides a familiar API for those experienced with Three.js, allowing seamless integration of 3D graphics into Flutter applications. The package supports real-time rendering and scene management, making it ideal for visualizations, games, and interactive product previews.
Use cases
3D model viewers
Interactive product demos
Educational 3D visualizations
Game development
Virtual tours
Key features
Cross-platform 3D rendering
Familiar Three.js API
Real-time scene manipulation
Support for GLTF and OBJ models
Built-in lighting and camera controls
Suitable for
Developers with Three.js experience
Apps requiring rich 3D content
Prototyping 3D interfaces
Web and mobile apps with 3D elements
Considerations
Higher performance requirements
Limited documentation compared to original Three.js
Potential complexity for beginners
Requires understanding of 3D concepts
Not optimized for low-end devices
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
three_js
A 3D rendering engine for dart (based on three.js and three_dart) that allows users to view, edit and manipulate their 3D objects. The current builds uses angle for desktop and mobile, and WebGL2 for web applications.
Features
This is a dart conversion of three.js and three_dart, originally created by @mrdoob and has a coverted dart fork by @wasabia.
Requirements
MacOS
Minimum os Deployment Target: 10.15
Xcode 13 or newer
Swift 5
Metal supported
iOS
Minimum os Deployment Target: 13.0
Xcode 13 or newer
Swift 5
Metal supported
iOS-Simulator
Minimum os Deployment Target: 13.0
Xcode 13 or newer
Swift 5
Metal supported
Android
compileSdkVersion: 34
minSdk: 21
OpenGL supported
Vulkan supported
Android Emulator
compileSdkVersion: 34
minSdk: 21
OpenGL supported
Windows
Intel supported
AMD supported
Qualcom supported
Direct3D 11 supported
OpenGL supported
Web
WebGL2 supported. please add <script src="https://cdn.jsdelivr.net/gh/Knightro63/flutter_angle/assets/gles_bindings.js"></script> to your index.html to load the js_interop file.
WASM
WebGL2 supported. please add <script src="https://cdn.jsdelivr.net/gh/Knightro63/flutter_angle/assets/gles_bindings.js"></script> to your index.html to load the js_interop file.
Linux
Currenlty only works for flutter < 3.27
Ubuntu supported (Tested on Linux Mint)
OpenGL supported
Getting started
To get started add three_js to your pubspec.yaml file. Adding permissions for audio and video is required if using either item.
Please use Permission Handler package to help with this.
Usage
This project is a simple 3D rendering engine for flutter to view, edit, or manipulate 3D models.
As this project moves twards impeller renderer google's ANGLE will be removed and this version will be moved to three_js_angle, which currenly does not exists.
Example
Find the example for this API here, for more examples you can click here, and for a preview go here.
Know Issues
All
MD2 annimations do not work
Collada animations do not work
Collada kinnametics does not work
PMREM gives weird artifacts or is completely black
Contributions are welcome.
In case of any problems look at existing issues, if you cannot find anything related to your problem then open an issue.
Create an issue before opening a pull request for non trivial fixes.
In case of trivial fixes open a pull request directly.
Supported Features
All of the current webgl2 core features are supported at this time.
GPU is currently under development, so it is currently not supported.
Please review the following table for all the supported Modules.
