Differences

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

--- groimp-platform:graphexplorerstructure [2024/11/07 13:01] – [Class relationships] tim
+++ groimp-platform:graphexplorerstructure [2024/11/26 13:00] (current) – [SecGraph] tim
@@ Line 3: / Line 3: @@
 Following the basics of the Graph Explorer plugin which holds GraphObjects and SecGraphs, are described.
+===== Objects =====
+==== GraphObject ====
+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.
+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 =====
+The plugin creates
 ===== Class relationships =====
@@ Line 9: / 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 29: / Line 110: @@
 Class GraphObjectRef {
 GraphObjectImpl resolve()
-}
-Class SecGraphInitialProducer
-Interface SecGraph {
- toInstance()
- getInitalProducer()
- setCurrent()
- releaseCurrent()
- clear()
 }
 Class SecGraphImpl {
 GraphManager gm
-show()
-show2d()
 }
 Class SecGraphRef {
@@ Line 49: / Line 118: @@
 }
+GraphContext <|-- GraphManagerContext
+GraphManagerContext <|-- GraphObject
 RegistryContext <|-- GraphObject
+ProducingNode <|-- GraphObject
 GraphObject <|-- SecGraph
+Cloneable <|-- SecGraph
 GraphObject <|..GraphObjectImpl
@@ Line 57: / Line 131: @@
 GraphObject <|..GraphObjectRef
 ItemReference <|-- GraphObjectRef
+GraphObjectImpl <|.. Selectable
-GraphObjectImpl --o GraphObjectRef
-SecGraph <|.. SecGraphImpl
-ShareableBase <|-- SecGraphImpl
 SecGraph <|.. SecGraphRef
@@ Line 69: / Line 140: @@
 SecGraphImpl <|.. Selectable
-SecGraphInitialProducer --* SecGraphImpl
+SecGraph <|.. SecGraphImpl
+ShareableBase <|-- EmbeddedSharedObject
+DisposableField <|..EmbeddedSharedObject
+EmbeddedSharedObject <|-- SecGraphImpl
-@enduml
+SecGraphInitialProducer --* SecGraphImpl
+GraphObjectImpl --o GraphObjectRef
 </uml>