Differences

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

--- groimp-platform:graphexplorerstructure [2024/11/08 10:53] – tim
+++ groimp-platform:graphexplorerstructure [2024/11/26 13:00] (current) – [SecGraph] tim
@@ Line 7: / Line 7: @@
 ==== GraphObject ====
-The GraphObject has a very similar use case as the Object explorer. Both can be used to link reusable assets to a project. Yet while the object explorer resolves the given file and links the root as a node to the reference and therefore in the registry, the GraphObject references to its own GraphManager.
+A GraphObject can be used to load graph structures from file into the GraphObeject explorer and use them as read only assets. The graph structure can either be cloned and then added to the graph or only an instance of it can be used in the graph.
-The usage of an own GraphManager results in the fact that the nodes of the additional graph structure are not placed in the same graph as the simulation, which increases the speed of
+A GraphObject is stored in the original file format and can be viewed from the GraphObjectExplorer. To use it in RGG the class GraphObjectRef with the name if the object.
+<code java>
+GraphObjectRef gr = new GraphObjectRef("myTree");
+[
+A ==> gr.cloneGraph(); // relace A with a clone of the graph
+B ==> gr; // replaces B with an instantiation of the graph
+]
+</code>
 ==== SecGraph ====
+A SecGraph object extends the GraphObject to creates a fully functional secondary graph, that can be manipulated and is stored in the same XML format as the project graph.
+Similar to the ObjectGraph a SecGraph can be used through the SecGraphRef class, either by importing (through the SecGraphExplorer) or by creating in RGG.
+<code java>
+SecGraphRef sgr = new SecGraphRef("test") // a empty SecGraphReference
+sgr ==> F RL(30)F; // add a graph structure to the empty secGraph
+SecGraphRef sgr = new SecGraphRef("tmp",first((*RGGRoot*))); // a new SecGraphRef containing a clone of the subgraph below RGGRoot
+SecGraphRef sgr = new SecGraphRef("tmp",GraphObejctRef("myTree")); // a secGraph contaiing a clone of the GraphObject myTree
+</code>
+Additionally a SecGraph can also be an attribute of a Node (including the rgg classes). In this case the xml file containing the graph is automatically created using the EmbeddedSharedObject-conzept.
+<code java>
+module A (float len) {
+SecGraphImpl sg;
+{
+ sg = new SecGraphImpl(workbench());
+ sg ==> F F RL F;
+}
+}==> sg;
+</code>
+To interact with the SecGraph object through RGG or XL, the function setCurrent and releaseCurrent are implemented. These functions change the currently used lock and RGGGraph in GroIMP, allowing to execute code on another graph. Additionally it is possible to apply a entire RGG function on a SecGraph.
+On the GUI level it is possible to edit the secondary graph on the 2d graph and the 3d view.
 ===== UI =====
@@ Line 23: / Line 60: @@
 <uml>
-scale 600 width
+scale 700 width
-@startuml
 Class ShareableBase
 Interface Selectable {
 toSelection()
 }
-Interface RegistryContext {
+Interface Cloneable{
- getRegistry()
+Object clone()
 }
-Interface GraphObject {
+Interface ProducingNode{
- getGraph()
+Node produceNode()
- getRootNode()
- cloneGraph()
- reload()
 }
+Interface RegistryContext{
+Registry getRegistry()
+}
+Interface GraphContext{
+Graph getGraph()
+}
+Interface GraphManagerContext{
+GraphManager getGraph()
+}
+Interface DisposableField
+Interface GraphObject{
+Node getRootNode()
+Node cloneGraph()
+GraphObject resolve()
+view3d(Context ctx)
+view2d(Context ctx)
+String getName()
+}
+Interface SecGraph{
+clear()
+apply(String name)
+applyXL(String query)
+setAutoRecreate(boolean b)
+Object getInitalProducer()
+setCurrent()
+releaseCurrent()
+add(GraphContext sg)
+}
 Class GraphObjectImpl{
 GraphManager gm
@@ Line 43: / Line 110: @@
 Class GraphObjectRef {
 GraphObjectImpl resolve()
-}
-Class SecGraphInitialProducer
-Interface SecGraph {
- toInstance()
- getInitalProducer()
- setCurrent()
- releaseCurrent()
- clear()
 }
 Class SecGraphImpl {
 GraphManager gm
-show()
-show2d()
 }
 Class SecGraphRef {
@@ Line 63: / Line 118: @@
 }
+GraphContext <|-- GraphManagerContext
+GraphManagerContext <|-- GraphObject
 RegistryContext <|-- GraphObject
+ProducingNode <|-- GraphObject
 GraphObject <|-- SecGraph
+Cloneable <|-- SecGraph
 GraphObject <|..GraphObjectImpl
@@ Line 71: / Line 131: @@
 GraphObject <|..GraphObjectRef
 ItemReference <|-- GraphObjectRef
+GraphObjectImpl <|.. Selectable
-GraphObjectImpl --o GraphObjectRef
-SecGraph <|.. SecGraphImpl
-ShareableBase <|-- SecGraphImpl
 SecGraph <|.. SecGraphRef
@@ Line 83: / Line 140: @@
 SecGraphImpl <|.. Selectable
-SecGraphInitialProducer --* SecGraphImpl
+SecGraph <|.. SecGraphImpl
+ShareableBase <|-- EmbeddedSharedObject
+DisposableField <|..EmbeddedSharedObject
+EmbeddedSharedObject <|-- SecGraphImpl
-@enduml
+SecGraphInitialProducer --* SecGraphImpl
+GraphObjectImpl --o GraphObjectRef
 </uml>