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

rename numInstances to initialInstances in loadGltf methods.

Browse Source 
when initialInstances > 0, don't wait for createInstance to be called to create corresponding GltfSceneAsset
This commit is contained in:
Nick Fisher
2025-06-26 09:20:37 +08:00
parent b983c6bb90
commit ccc0a53abc
9 changed files with 49 additions and 46 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
thermion_dart/lib/src/filament/src/implementation/ffi_filament_app.dart
View File

@@ -890,7 +890,7 @@ class FFIFilamentApp extends FilamentApp<Pointer> {
///
Future<ThermionAsset> loadGltfFromBuffer(
Uint8List data, Pointer animationManager,
{int numInstances = 1,
{int initialInstances = 1,
bool keepData = false,
int priority = 4,
int layer = 0,
@@ -914,7 +914,7 @@ class FFIFilamentApp extends FilamentApp<Pointer> {
var filamentAsset = await withPointerCallback<TFilamentAsset>((cb) =>
GltfAssetLoader_loadRenderThread(engine, gltfAssetLoader,
data.address, data.length, numInstances, cb));
data.address, data.length, initialInstances, cb));
if (filamentAsset == nullptr) {
throw Exception("An error occurred loading the asset");

1
thermion_dart/lib/src/filament/src/interface/asset.dart
View File

@@ -6,7 +6,6 @@ import 'package:thermion_dart/src/filament/src/interface/scene.dart';
import 'package:thermion_dart/thermion_dart.dart';
export 'geometry.dart';
export 'gltf.dart';
///
/// A high-level interface for a renderable object

4
thermion_dart/lib/src/filament/src/interface/filament_app.dart
View File

@@ -291,11 +291,11 @@ abstract class FilamentApp<T> {
Future setClearOptions(double r, double g, double b, double a,
{int clearStencil = 0, bool discard = false, bool clear = true});
///
/// See [FilamentViewerFFI.loadGltf] for details.
///
///
Future<ThermionAsset> loadGltfFromBuffer(Uint8List data, T animationManager,
{int numInstances = 1,
{int initialInstances = 1,
bool keepData = false,
int priority = 4,
int layer = 0,

6
thermion_dart/lib/src/filament/src/interface/gltf.dart
View File

@@ -1,6 +0,0 @@
class GLTF {
final String uri;
final int numInstances;
GLTF(this.uri, this.numInstances);
}

8
thermion_dart/lib/src/viewer/src/ffi/src/thermion_viewer_ffi.dart
View File

@@ -457,7 +457,7 @@ class ThermionViewerFFI extends ThermionViewer {
Future<ThermionAsset> loadGltf(
String path, {
bool addToScene = true,
int numInstances = 1,
int initialInstances = 1,
bool keepData = false,
String? resourceUri,
bool loadAsync = false,
@@ -475,7 +475,7 @@ class ThermionViewerFFI extends ThermionViewer {
return loadGltfFromBuffer(
data,
addToScene: addToScene,
numInstances: numInstances,
initialInstances: initialInstances,
keepData: keepData,
resourceUri: resourceUri,
loadResourcesAsync: loadAsync,
@@ -489,7 +489,7 @@ class ThermionViewerFFI extends ThermionViewer {
Future<ThermionAsset> loadGltfFromBuffer(
Uint8List data, {
bool addToScene = true,
int numInstances = 1,
int initialInstances = 1,
bool keepData = false,
int priority = 4,
int layer = 0,
@@ -499,7 +499,7 @@ class ThermionViewerFFI extends ThermionViewer {
var asset = await FilamentApp.instance!.loadGltfFromBuffer(
data,
animationManager,
numInstances: numInstances,
initialInstances: initialInstances,
keepData: keepData,
priority: priority,
layer: layer,

37
thermion_dart/lib/src/viewer/src/thermion_viewer_base.dart
View File

@@ -151,37 +151,38 @@ abstract class ThermionViewer {
/// If [addToScene] is [true], all renderable entities (including lights)
/// in the asset will be added to the scene.
///
/// If you want to dynamically create instances of this asset after it is
/// instantiated, pass [kee]
/// Alternatively, specifying [numInstances] will pre-allocate the specified
/// number of instances. This is more efficient than dynamically instantating at a later time.
/// You can then retrieve the created instances with [getInstances].
///
/// If [keepData] is false and [numInstances] is 1,
/// the source glTF data will be released and [createInstance]
/// will throw an exception.
/// The [initialInstances] argument determines the number of
/// instances created when the asset is first instantiated. If [keepData] is
/// false, no further instances will be able to be created.
///
/// If [keepData] is true, additional instances can be created by calling
/// [createInstance] on the returned asset.
///
/// Creating instances at asset load time is more efficient than dynamically
/// instantating at a later time.
///
/// Instances can be retrieved with [getInstances].
///
/// If [loadResourcesAsync] is true, resources (textures, materials, etc) will
/// be loaded asynchronously. Some material/texture pop-in is expected.
///
Future<ThermionAsset> loadGltf(String uri,
{bool addToScene = true,
int numInstances = 1,
int initialInstances = 1,
bool keepData = false,
String? resourceUri,
bool loadAsync = false});
///
/// Load the .glb asset from the specified buffer, adding all entities to the scene.
/// Specify [numInstances] to create multiple instances (this is more efficient than dynamically instantating at a later time). You can then retrieve the created instances with [getInstances].
/// If you want to be able to call [createInstance] at a later time, you must pass true for [keepData].
/// If [keepData] is false, the source glTF data will be released and [createInstance] will throw an exception.
/// If [loadResourcesAsync] is true, resources (textures, materials, etc) will
/// be loaded asynchronously (so expect some material/texture pop-in);
/// Loads a gltf asset from the specified buffer (which contains the contents
/// of a .glb file).
///
/// See the [loadGltf] method for documentation on arguments.
///
///
Future<ThermionAsset> loadGltfFromBuffer(Uint8List data,
{String? resourceUri,
int numInstances = 1,
int initialInstances = 1,
bool keepData = false,
int priority = 4,
int layer = 0,