Differences

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

--- tutorials:import-object-in-groimp [2024/09/27 15:54] – created tim
+++ tutorials:import-object-in-groimp [2025/05/25 12:42] (current) – barley1965
@@ Line 1: / Line 1: @@
-GroIMP can import objects from several 3d or graph formats into the project graph. The imported objects can then be used similar to any other part of the graph.
+With GroIMP it is possible to import objects from several 3d or graph formats into the project graph. The imported objects can then be used similarly to any other part of the graph.
-In the following different way of adding a file will be shown based on {{ :tutorials:cherry_new.dtd | this}} dtd file.
+In the following, a different way of adding a file will be shown based on {{ :tutorials:cherry_new.dtd | this}} dtd file.
@@ Line 12: / Line 12: @@
 The easiest way is to add the object directly, using the main menu: Objects, there you can find the options insert File and insert File to RGG.
-They both work very similar, starting with a file dialog to choose which file to import and then turning this file into a graph and adding it. The only difference is that 'Insert File' adds the loaded graph to the root of the scene and 'Insert File to RGG' to the RGG root. This leads to the difference that a file inserted to RGG will be removed when the model is rested or recompiled.
+They both work very similar, starting with a file dialog to choose which file to import and then turning this file into a graph and adding it. The only difference is that 'Insert File' adds the loaded graph to the root of the scene and 'Insert File to RGG' to the RGG root. This leads to the difference that a file inserted to RGG will be removed when the model is stopped or recompiled.
-In order to remove a object added to the root of the scene the function 'clear project graph' in the main menu: Edit can be used. Additionally it is always possible to select and object in the 2d or 3d view and use the delte key.
+In order to remove an object added to the root of the scene the function 'clear project graph' in the main menu: Edit can be used. Additionally it is always possible to select an object in the 2d or 3d view and use the delete key.
@@ Line 27: / Line 27: @@
 	[f:F,(empty((*f --> Node*)))==>;]
 </code>
+===== Using the Object explorer =====
+A second more reusable way is to add the external objects to the Object explorer. The explorer can be found on the main menu on Panels/Explorers/Objects. In the newly opened panel a menu with the item Object should be visible. Under this item following the path '/new/insert File' we can select the same file as above.
+After selecting the file with the file dialog a popup asks "How should the file be added?" the three options mean:
+__Add the file:__ the file is copied to a folder object in the GSZ or the project directory. This means the file is added to the project and will also be available if the project is moved.
+__Link the file:__ only the path to the current file is added. This can be useful in a more complex pipeline where the external file is updated by another software or another GroIMP project. However, this relays on the file path to the external object.
+__Embed the file:__ The file is read and added to the meta graph. Doing so makes it independent from the format, the file or the import process. However, it is then part of the GroIMP graph and for bigger files this could slow down the simulation.
+The choice really depends on the use case, but in our case the easiest is to add the file.
+After the file has been loaded it can be referenced from the RGG using 'Reference("cherry_new.dtd");'.
+Using this in a XL query will create an instance of the imported object, in the Graph. This means it is not importing the graph structure but only one node representing the 3d structure.
+For example the following code would create three times the same tree in a row:
+<code>
+protected void init ()
+[
+	Axiom ==> for(int i=0; i<3; i++)(
+	Translate(0,1,0)
+		[
+			Reference("cherry_new.dtd")
+		]
+	);
+]
+</code>
+It is also possible to access the graph structure of these referenced objects using the code below but it is more recommended to use the GraphExplorer to do so.
+<code>
+	{
+	Reference ref = new Reference("cherry_new.dtd");
+	Node refRoot = ref.resolveNode();
+	}
+</code>