maobo/cup_edit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update README

Browse Source
This commit is contained in:
Nick Fisher
2023-10-03 17:21:24 +11:00
parent 9e903bc4f6
commit bdd3afedd6
1 changed files with 11 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
README.md
View File

@@ -119,13 +119,13 @@ a) the backing textures needed to insert a `Texture` widget into
b) a rendering thread b) a rendering thread
c) a `FilamentViewer` and an `AssetManager`, which will allow you to load assets/cameras/lighting/etc via the `FilamentController` c) a `FilamentViewer` and an `AssetManager`, which will allow you to load assets/cameras/lighting/etc via the `FilamentController`
If this was successful, you should see a black screen If this was successful, the viewport should turn from red to black.
### Rendering ### Rendering
By default, the FilamentController will only render into the viewport by manually calling `render()` on the FilamentController. This is to avoid needlessly running a render loop when there is nothing to display. By default, the FilamentController will only render into the viewport by manually calling `render()` on the FilamentController. This is to avoid needlessly running a render loop when there is nothing to display.
If you want to render at 60fps, call `setRendering(true)` on `FilamentController`. To automatically render at 60fps, call `setRendering(true)` on `FilamentController`.
### Assets ### Assets
@@ -142,7 +142,6 @@ Then you would call the following
``` ```
var entity = _filamentController.loadGlb("assets/models/bob.glb"); var entity = _filamentController.loadGlb("assets/models/bob.glb");
``` ```
You can also pass a URI to indicate that the glTF file should be loaded from the filesystem: You can also pass a URI to indicate that the glTF file should be loaded from the filesystem:
``` ```
var entity = _filamentController.loadGlb("file:///tmp/bob.glb"); var entity = _filamentController.loadGlb("file:///tmp/bob.glb");
@@ -170,15 +169,17 @@ class MyApp extends StatelessWidget {
color: Colors.white, color: Colors.white,
home: Scaffold(backgroundColor: Colors.white, body: Stack(children:[ home: Scaffold(backgroundColor: Colors.white, body: Stack(children:[
Container(color:Colors.green, height:100, width:100), Container(color:Colors.green, height:100, width:100),
Positioned.fill(top:100, left:100child:FilamentWidget(controller:_filamentController)), Positioned.fill(top:100, left:100,child:FilamentGestureDetector(
controller: _filamentController,
child:FilamentWidget(
controller:_filamentController
))),
Positioned(right:0, bottom:0, child:Container(color:Colors.purple, height:100, width:100)) Positioned(right:0, bottom:0, child:Container(color:Colors.purple, height:100, width:100))
]))); ])));
} }
} }
``` ```
# Building Filament from source # Building Filament from source
``` ```
@@ -239,7 +240,10 @@ filament/out/release/filament/bin/resgen -c -p image -x ios/include/material/ ma
``` ```
# Known issues
On Windows, loading a glTF (but NOT a glb) may crash due to a race condition between uploading resource data to GPU memory and being freed on the host side.
This has been fixed in recent versions of Filament, but other bugs on Windows prevent upgrading.
Only workaround is to load a .glb file.