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 [2024/09/27 16:22] (current) – [Using the Object explorer] tim
@@ 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 objects 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 softare or another GroIMP project. Yet this relays on the 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. Yet 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 was loaded it can be reference 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. Meaning it is not importing the graph structure but only one node representing the 3d structure.
+For example the following code would create three time 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 this 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>