Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
1.0.0:models [2023/02/23 11:43] – [The Better Loading] admin1.0.0:models [2023/02/28 15:21] (current) – [Sketchfab Import] admin
Line 57: Line 57:
   - All model data will be stored inside the *.fmx file of your form   - All model data will be stored inside the *.fmx file of your form
  
-The IDE will show up a loading window while it's setting up the model.+{{:1.0.0:g3d-ide-loadopts.jpg?nolink|}} 
 + 
 +When the loading options dialog appears you can configure the import process.  
 +But not all options are available for all formats. 
 + 
 +  * Ignore importing animations 
 +  * Animation caching settings 
 +  * Ignore importing lights or cameras 
 +  * Directly import additional animation files without an extra call 
 +  * Limit texture size, in case you have a memory-sensitive application 
 + 
 +Afterwards the IDE will show up a loading window while importing. 
 Because the data + textures are stored in the *.fmx of your form, it can become very large. Because the data + textures are stored in the *.fmx of your form, it can become very large.
 This may slow down the performance of the IDE. This may slow down the performance of the IDE.
  
-**WARNING***: Your IDE memory is limited to 3GB, which can be exceeded very fast due to cached data by the IDE and model data with textures.+**WARNING***: Your IDE memory is limited to 3GB, which can be exceeded very fast due to cached model data with textures.
  
 ==== Using Packages ==== ==== Using Packages ====
Line 85: Line 97:
 The data is not stored again in the formular *.fmx file, it only restores it from package information. The data is not stored again in the formular *.fmx file, it only restores it from package information.
  
-**WARNING***: Your IDE memory is limited to 3GB, which can be exceeded very fast due to cached data by the IDE.+**WARNING***: Your IDE memory is limited to 3GB, which can be exceeded very fast due to cached model data.
  
  
Line 113: Line 125:
  
 __NOTICE:__ Not all models on Sketchfab are fully compatible. The platform automatically converts models to glTF format, which sometimes destroys the model data. __NOTICE:__ Not all models on Sketchfab are fully compatible. The platform automatically converts models to glTF format, which sometimes destroys the model data.
 +
 +
 +<WRAP center round alert 60%>
 +**WARNING**: (2023-02-28) Due to some security issues we had to disable the Sketchfab plugin. We are sorry and we will try to fix the problem with the next update.
 +</WRAP>
 ===== Runtime ===== ===== Runtime =====
  
Line 262: Line 279:
 Configured loading is the better way of loading model data into your application at runtime. Configured loading is the better way of loading model data into your application at runtime.
  
-It gives you the opportunity to prepare settings what and how it should import data.+It gives you the opportunity to tell the loader how to import data.
  
-For example, you can choose to ignore importing lights and cameras. You can directly tell the loader to import additional animation files or you can limit texture size, in case you have a memory sensitive application.+For example:  
 +  * You can choose to ignore importing lights or cameras 
 +  * You can directly import additional animation files without an extra call 
 +  * You can limit texture size, in case you have a memory-sensitive application 
 +  * You can define a status callback function ("TGorillaLoadingStatus = procedure(ALoader : TObject) of object;") 
 +  * You can link to a specific model asset inside of package for fast model data reusage 
 + 
 +Loading options can be submitted as argument to the LoadNewModelFromFile() or LoadFromFile() method. 
 + 
 +In the following example we demonstrate the usage at runtime:
  
 <file pascal> <file pascal>
Line 277: Line 303:
   LMdlPath := IncludeTrailingPathDelimiter('C:\Temp\PACKAGETEST\ASSETS\Astronaut');   LMdlPath := IncludeTrailingPathDelimiter('C:\Temp\PACKAGETEST\ASSETS\Astronaut');
   LOpts := TGorillaLoadOptions.Create(LMdlPath + 'Astronaut.fbx');   LOpts := TGorillaLoadOptions.Create(LMdlPath + 'Astronaut.fbx');
 +  
 +  // only allow this exact filename and no automated lookup
 +  LOpts.FileInfo.StrictFilename := true;
 +  
 +  // link to a package and/or to a specific asset inside of a package
 +  LOpts.Package := nil;
 +  LOpts.Asset := nil;
 +  
 +  // limit to a max. size of textures (textures will be resized in aspect ratio)
 +  LOpts.TextureLimits := Point(512, 512);
 +  
 +  // ignore lights and camera for import
   LOpts.ImportLights := false;   LOpts.ImportLights := false;
   LOpts.ImportCameras := false;   LOpts.ImportCameras := false;
 +  
 +  // user defined animation import
   LOpts.ImportAnimations := true;   LOpts.ImportAnimations := true;
   LOpts.AddAnimation(LMdlPath + 'Astronaut-idle.fbx');   LOpts.AddAnimation(LMdlPath + 'Astronaut-idle.fbx');
Line 302: Line 342:
 To adopt the behaviour used in the IDE at design time, you can load model data from assets package To adopt the behaviour used in the IDE at design time, you can load model data from assets package
 also at runtime by the following method. also at runtime by the following method.
 +
 +__NOTICE:__ This will trigger design time dialogs on loading data. If you don't want that dialogs to appear, please use LoadNewModelFromFile() or LoadFromFile().
  
 <file pascal Form1.pas> <file pascal Form1.pas>
Line 432: Line 474:
 ==== TGorillaModel ==== ==== TGorillaModel ====
  
-A TGorillaModel is the head component for loaded models from file/asset. Even it's inherited from TGorillaMesh, it's not renderable. Instead it is just a container, managing+A TGorillaModel is the "head" component for loaded models from file, stream or asset. Even it's inherited from TGorillaMesh, it's not renderable. Instead it is just a container, managing
 sub-meshes, animations and materials. So a TGorillaModel needs to contain at least one TGorillaMesh in it's Meshes list. sub-meshes, animations and materials. So a TGorillaModel needs to contain at least one TGorillaMesh in it's Meshes list.
  
Line 507: Line 549:
  
  
-===== Instancing / Model duplication =====+===== Instancing / Cloning =====
  
 ==== Instanced Rendering ==== ==== Instanced Rendering ====
Line 515: Line 557:
 Use this method to render for example grass or trees. It is not recommended to use it for animated charaters, Use this method to render for example grass or trees. It is not recommended to use it for animated charaters,
 because they would be rendered the same (with the same animation frame). because they would be rendered the same (with the same animation frame).
- 
-You can simply setup instanced rendering in your TGorillaModel or TGorillaMesh object. 
  
 {{youtube>WoJXVVjRHO0?large}} {{youtube>WoJXVVjRHO0?large}}
 +
 +
 +
 +=== At DesignTime ===
 +
 +We offer a collection property called "Instances" in the TGorillaModel/TGorillaMesh component.
 +
 +You can simply add instances at design time with their transformation information.
 +
 +__NOTICE:__ The transformation information (position, rotation and scale) is absolute and not depending on the owner mesh.
 +
 +
 +=== At Runtime ===
 +
 +For better usability TGorillaMesh/TGorillaModel components provide the collection property "Instances".
 +Internally it will be cached in buffer for fast GPU transmission.
 +
 +This brings new opportunities, especially for instancing a very large number, f.e. you don't want to setup a single TCollectionItem to render 100.000 grass blades.
 +
 +In that case you want to ignore the collection and simply add those instances to the buffer. Therefore please use the AddInstance() method
 +
 +<file pascal>
 +function AddInstance(const ATransform : TMatrix3D; const ACreateItem : Boolean;
 +        AName : String = '') : Integer;
 +</file>
  
 <file pascal> <file pascal>
 /// we create 4 instances in a row /// we create 4 instances in a row
-GorillaModel1.AddInstance(TMatrix3D.CreateTranslation(Point3D(-10, 0, 0))); +GorillaModel1.AddInstance(TMatrix3D.CreateTranslation(Point3D(-10, 0, 0)), false); 
-GorillaModel1.AddInstance(TMatrix3D.CreateTranslation(Point3D(-5, 0, 0))); +GorillaModel1.AddInstance(TMatrix3D.CreateTranslation(Point3D(-5, 0, 0)), false); 
-GorillaModel1.AddInstance(TMatrix3D.CreateTranslation(Point3D(5, 0, 0))); +GorillaModel1.AddInstance(TMatrix3D.CreateTranslation(Point3D(5, 0, 0)), false); 
-GorillaModel1.AddInstance(TMatrix3D.CreateTranslation(Point3D(10, 0, 0)));+GorillaModel1.AddInstance(TMatrix3D.CreateTranslation(Point3D(10, 0, 0)), false);
  
 /// afterwards we can modify a specific instance /// afterwards we can modify a specific instance
Line 536: Line 601:
 </file> </file>
  
 +__WARNING:__ Only use one of the functionalities: Collection / Buffering. When adding collection items again, the instance buffer will be refreshed and previously added instances will be cleared.
 +==== Cloning ====
 +
 +Instancing can be done by GPU and providing different transformation matrices like above or by cloning the visual component with all of it's data.
 +Both ways have their advantages and disadvantages.
  
-==== Instancing by template (TModelDef) ====+  * Use instancing if you want to re-render a mesh multiple times 
 +  * Use cloning if you need different visual feedback (like animations or materials), but if you want to reuse the vertex data itself
  
-Since 0.8.3.1966+ we've refactored the way to instanciate models. The previous method was incomplete in handling animated models. 
 In the following example we show how to load a complex animated model with multiple meshes and animations. In the following example we show how to load a complex animated model with multiple meshes and animations.
 We will load up a template (TModelDef), which will be used for duplication. The template (TModelDef) itself will not be rendered in our example, but of course that's possible too. We will load up a template (TModelDef), which will be used for duplication. The template (TModelDef) itself will not be rendered in our example, but of course that's possible too.
Line 613: Line 683:
 end; end;
 </file> </file>
-===== Plugins ===== 
- 
  
  
1.0.0/models.1677149018.txt.gz · Last modified: 2023/02/23 11:43 by admin
Except where otherwise noted, content on this wiki is licensed under the following license: Public Domain


  • Show page
  • Old revisions
  • Backlinks
  • Recent Changes
  • Media Manager
  • Sitemap