Differences

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

--- 1.0.0:models [2023/02/23 12:03] – [TGorillaModel] admin
+++ 1.0.0:models [2023/02/28 15:21] (current) – [Sketchfab Import] admin
@@ Line 59: / Line 59: @@
 {{:1.0.0:g3d-ide-loadopts.jpg?nolink|}}
-If the loading options dialog appears you can configure the import process.
+When the loading options dialog appears you can configure the import process.
 But not all options are available for all formats.
@@ Line 73: / Line 73: @@
 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 ====
@@ Line 97: / Line 97: @@
 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 125: / 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.
+<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 =====
@@ Line 544: / Line 549: @@
-===== Instancing / Model duplication =====
+===== Instancing / Cloning =====
 ==== Instanced Rendering ====
@@ Line 552: / Line 557: @@
 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).
-You can simply setup instanced rendering in your TGorillaModel or TGorillaMesh object.
 {{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>
 /// 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
@@ Line 573: / Line 601: @@
 </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.
 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 650: / Line 683: @@
 end;
 </file>
-===== Plugins =====