* Bug #15024 fixed : Xcos labels were not preserved .
[scilab.git] / scilab / modules / xcos / src / java / org / scilab / modules / xcos / graph / model / XcosCellFactory.java
1 /*
2  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
3  * Copyright (C) 2015-2017 - Scilab Enterprises - Clement DAVID
4  * Copyright (C) 2017 - ESI Group - Clement DAVID
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  */
16
17 package org.scilab.modules.xcos.graph.model;
18
19 import static org.scilab.modules.action_binding.highlevel.ScilabInterpreterManagement.buildCall;
20 import static org.scilab.modules.action_binding.highlevel.ScilabInterpreterManagement.synchronousScilabExec;
21
22 import java.lang.reflect.InvocationTargetException;
23 import java.util.ArrayList;
24 import java.util.Arrays;
25 import java.util.EnumSet;
26 import java.util.HashMap;
27 import java.util.Optional;
28 import java.util.logging.Logger;
29
30 import javax.swing.SwingUtilities;
31
32 import org.scilab.modules.action_binding.highlevel.ScilabInterpreterManagement.InterpreterException;
33 import org.scilab.modules.graph.utils.ScilabExported;
34 import org.scilab.modules.xcos.JavaController;
35 import org.scilab.modules.xcos.Kind;
36 import org.scilab.modules.xcos.ObjectProperties;
37 import org.scilab.modules.xcos.VectorOfDouble;
38 import org.scilab.modules.xcos.VectorOfScicosID;
39 import org.scilab.modules.xcos.Xcos;
40 import org.scilab.modules.xcos.XcosView;
41 import org.scilab.modules.xcos.block.BasicBlock;
42 import org.scilab.modules.xcos.graph.XcosDiagram;
43 import org.scilab.modules.xcos.link.BasicLink;
44 import org.scilab.modules.xcos.link.CommandControlLink;
45 import org.scilab.modules.xcos.link.ExplicitLink;
46 import org.scilab.modules.xcos.link.ImplicitLink;
47 import org.scilab.modules.xcos.port.BasicPort;
48 import org.scilab.modules.xcos.port.command.CommandPort;
49 import org.scilab.modules.xcos.port.control.ControlPort;
50 import org.scilab.modules.xcos.port.input.ExplicitInputPort;
51 import org.scilab.modules.xcos.port.input.ImplicitInputPort;
52 import org.scilab.modules.xcos.port.output.ExplicitOutputPort;
53 import org.scilab.modules.xcos.port.output.ImplicitOutputPort;
54 import org.scilab.modules.xcos.utils.BlockPositioning;
55
56 import com.mxgraph.model.mxCell;
57 import com.mxgraph.model.mxGeometry;
58 import com.mxgraph.util.mxPoint;
59 import java.lang.reflect.Constructor;
60 import java.util.EnumMap;
61 import org.scilab.modules.xcos.block.SplitBlock;
62 import org.scilab.modules.xcos.block.custom.RoundBlock;
63 ;
64
65 /**
66  * Ease the creation of any {@link Kind} of graphical object
67  */
68 public final class XcosCellFactory {
69
70     /** Size compatibility for user defined blocks */
71     private static final double DEFAULT_SIZE_FACTOR = 20.0;
72     private static final Logger LOG = Logger.getLogger(XcosCellFactory.class.getName());
73
74     /** Default singleton constructor */
75     private XcosCellFactory() {
76         // This class is a static singleton
77     }
78
79     /**
80      * This is a notify method mapped as a Scilab gateway used to alert with the loaded UID
81      *
82      * @param uid
83      *            the loaded UID
84      * @param kind
85      *            the kind of the created object (as an int)
86      */
87     @ScilabExported(module = "xcos", filename = "XcosCellFactory.giws.xml")
88     public static synchronized void created(long uid, int kind) {
89         lastCreated = new ScicosObjectOwner(uid, Kind.values()[kind]);
90
91     }
92
93     /**
94      * This is a notify method mapped as a Scilab gateway used to update an UID
95      *
96      * @param uid
97      *            the loaded UID
98      * @param kind
99      *            the kind of the created object (as an int)
100      */
101     @ScilabExported(module = "xcos", filename = "XcosCellFactory.giws.xml")
102     public static synchronized void update(long uid, int kind) {
103         lastCreated = new ScicosObjectOwner(uid, Kind.values()[kind]);
104
105         try {
106             SwingUtilities.invokeAndWait(() -> {
107                 if (kind == Kind.BLOCK.ordinal()) {
108                     JavaController controller = new JavaController();
109
110                     XcosDiagram graph = previousDiagram;
111                     graph.getModel().beginUpdate();
112                     try {
113                         BasicBlock block = createBlock(controller, lastCreated);
114                         previousBlock.updateBlockSettings(controller, graph, block);
115                         BlockPositioning.updateBlockView(graph, block);
116                     } finally {
117                         graph.getModel().beginUpdate();
118                     }
119                 }
120             });
121         } catch (InvocationTargetException | InterruptedException e) {
122             e.printStackTrace();
123         }
124     }
125
126     private static ScicosObjectOwner lastCreated = null;
127     private static BasicBlock previousBlock = null;
128     private static XcosDiagram previousDiagram = null;
129
130     /**
131      * Retrieve and clear the last created object (<pre>xcosCellCreated</pre> call)
132      * @return the last created object
133      */
134     public static synchronized ScicosObjectOwner getLastCreated() {
135         ScicosObjectOwner last = lastCreated;
136         lastCreated = null;
137         return last;
138     }
139
140     /**
141      * Set an object available for update (<pre>xcosUpdateBlock</pre> call)
142      * @param previous the object to track for update
143      */
144     public static synchronized void setPrevious(BasicBlock block, XcosDiagram diagram) {
145         previousBlock = block;
146         previousDiagram = diagram;
147     }
148
149     /*
150      * Diagram management
151      */
152
153     /**
154      * Allocate a Java XcosDiagram from a COSF file.
155      *
156      * This method execute the file and register a
157      *
158      * @param controller
159      *            the controller
160      * @param filename
161      *            the file to execute
162      * @return an allocated XcosDiagram
163      */
164     public static XcosDiagram createDiagramFromCOSF(final JavaController controller, String filename) {
165         XcosView view = (XcosView) JavaController.lookup_view(Xcos.class.getName());
166         JavaController.unregister_view(view);
167
168         XcosDiagram diagram;
169         try {
170             synchronousScilabExec(
171                 "function f(), " + buildCall("exec", filename, -1) + "; " + buildCall("xcosCellCreated", "scs_m".toCharArray()) + "endfunction; f();");
172
173             ScicosObjectOwner last = getLastCreated();
174             if (last.getKind() == Kind.DIAGRAM) {
175                 String[] strUID = new String[1];
176                 controller.getObjectProperty(last.getUID(), last.getKind(), ObjectProperties.UID, strUID);
177
178                 diagram = new XcosDiagram(controller, last.getUID(), last.getKind(), strUID[0]);
179                 insertChildren(controller, diagram);
180             } else {
181                 diagram = null;
182             }
183         } catch (InterpreterException e) {
184             diagram = null;
185         } finally {
186             JavaController.register_view(Xcos.class.getName(), view);
187         }
188
189         return diagram;
190     }
191
192     /**
193      * Insert the diagram MVC children into the JGraphX model
194      *
195      * @param controller
196      *            the shared controller
197      * @param diagram
198      *            the current diagram instance
199      */
200     public static void insertChildren(JavaController controller, XcosDiagram diagram) {
201         /*
202          * Retrieve the children
203          */
204         VectorOfScicosID children = new VectorOfScicosID();
205         controller.getObjectProperty(diagram.getUID(), diagram.getKind(), ObjectProperties.CHILDREN, children);
206         final int childrenLen = children.size();
207
208         /*
209          * Allocation some pre-sized stash data
210          */
211         final ArrayList<BasicLink> links = new ArrayList<>(childrenLen / 2);
212         final HashMap<Long, BasicPort> ports = new HashMap<>(childrenLen);
213
214         /*
215          * Create the XcosCell objects and store some of them for later use
216          */
217         XcosCell[] cells = new XcosCell[childrenLen];
218         for (int i = 0; i < childrenLen; i++) {
219             final long uid = children.get(i);
220             final Kind kind = controller.getKind(uid);
221
222             switch (kind) {
223                 case ANNOTATION:
224                 case BLOCK:
225                     BasicBlock b = createBlock(controller, uid, kind);
226                     cells[i] = b;
227                     BlockPositioning.updatePortsPosition(diagram, b);
228                     b.getTypedChildrenIndexes(BasicPort.class).stream()
229                     .map(index -> b.getChildAt(index))
230                     .filter(c -> c instanceof BasicPort)
231                     .map(c -> (BasicPort) c)
232                     .forEach(c -> ports.put(c.getUID(), c));
233                     break;
234                 case LINK:
235                     BasicLink l = createLink(controller, uid, kind);
236                     cells[i] = l;
237                     links.add(l);
238                     break;
239                 default:
240                     break;
241             }
242
243             // add the optionnal label
244             long[] label = { 0 };
245             controller.getObjectProperty(uid, kind, ObjectProperties.LABEL, label);
246             if (label[0] != 0) {
247                 cells[i].insert(createAnnotation(controller, label[0], Kind.ANNOTATION));
248             }
249         }
250
251         /*
252          * Relink the links on the XcosCell part
253          */
254         for (BasicLink l : links) {
255             long[] src = new long[1];
256             controller.getObjectProperty(l.getUID(), l.getKind(), ObjectProperties.SOURCE_PORT, src);
257
258             long[] dest = new long[1];
259             controller.getObjectProperty(l.getUID(), l.getKind(), ObjectProperties.DESTINATION_PORT, dest);
260
261             BasicPort srcPort = ports.get(src[0]);
262             if (srcPort != null) {
263                 l.setSource(srcPort);
264             } else {
265                 LOG.severe("Unable to connect link " + l.getId() + " : invalid source " + src[0]);
266             }
267
268             BasicPort destPort = ports.get(dest[0]);
269             if (destPort != null) {
270                 l.setTarget(destPort);
271             } else {
272                 LOG.severe("Unable to connect link " + l.getId() + " : invalid target " + dest[0]);
273             }
274         }
275
276         // re-add the children cells without duplicating them
277         children.clear();
278         controller.setObjectProperty(diagram.getUID(), diagram.getKind(), ObjectProperties.CHILDREN, children);
279
280         // add all the children using the diagram modification tracking features
281         diagram.addCells(cells);
282
283         // each cell has been referenced twice (CHILDREN insert and addCells), derefence them all by one
284         Arrays.stream(cells).forEach(c -> controller.deleteObject(c.getUID()));
285     }
286
287     /*
288      * Block and Annotation management
289      */
290
291     /**
292      * Instantiate a new block with the specified interface function.
293      *
294      * @param func
295      *            the interface function
296      * @return A new instance of a block.
297      */
298     public static BasicBlock createBlock(BlockInterFunction func) throws InterpreterException {
299         return createBlock(func, func.name());
300     }
301
302     /**
303      * Instantiate a new block with the specified UID value and interface function
304      *
305      * @param uid
306      *            The associated UID value
307      * @param interfaceFunction
308      *            the interface function
309      * @return A new instance of a block.
310      */
311     public static BasicBlock createBlock(String interfaceFunction) throws InterpreterException {
312         Optional<BlockInterFunction> func = EnumSet.allOf(BlockInterFunction.class).stream().filter(f -> f.name().equals(interfaceFunction)).findFirst();
313
314         final BasicBlock block;
315         if (func.isPresent()) {
316             block = createBlock(func.get());
317         } else {
318             block = createBlock(BlockInterFunction.BASIC_BLOCK, interfaceFunction);
319         }
320         block.setStyle(interfaceFunction);
321
322         return block;
323     }
324
325     private static BasicBlock createBlock(BlockInterFunction func, String interfaceFunction) throws InterpreterException {
326         return createBlock(new JavaController(), func, interfaceFunction);
327     }
328
329     private static BasicBlock createBlock(final JavaController controller, BlockInterFunction func, String interfaceFunction) throws InterpreterException {
330         BasicBlock block;
331         ScicosObjectOwner last;
332
333         if (BlockInterFunction.BASIC_BLOCK.name().equals(interfaceFunction)) {
334             // deliver all the MVC speed for the casual case
335             last = new ScicosObjectOwner(controller.createObject(Kind.BLOCK), Kind.BLOCK);
336         } else {
337             // allocate an empty block that will be filled later
338             synchronousScilabExec("xcosCellCreated(" + interfaceFunction + "(\"define\")); ");
339             last = getLastCreated();
340         }
341
342         // defensive programming
343         if (last == null) {
344             throw new InterpreterException("XcosCellFactory#createBlock : unable to allocate " + interfaceFunction);
345         }
346
347         if (EnumSet.of(Kind.BLOCK, Kind.ANNOTATION).contains(last.getKind())) {
348             block = createBlock(controller, func, interfaceFunction, last.getUID(), last.getKind());
349         } else {
350             block = null;
351         }
352
353         return block;
354     }
355
356     public static BasicBlock createBlock(final JavaController controller, long uid, Kind kind) {
357         String[] interfaceFunction = new String[1];
358         if (kind == Kind.BLOCK) {
359             controller.getObjectProperty(uid, kind, ObjectProperties.INTERFACE_FUNCTION, interfaceFunction);
360         } else { // ANNOTATION
361             interfaceFunction[0] = "TEXT_f";
362         }
363
364         final BlockInterFunction func = lookForInterfunction(interfaceFunction[0]);
365
366         return createBlock(controller, func, interfaceFunction[0], uid, kind);
367     }
368
369     public static BlockInterFunction lookForInterfunction(String interfaceFunction) {
370         Optional<BlockInterFunction> optFunc = EnumSet.allOf(BlockInterFunction.class).stream().filter(f -> f.name().equals(interfaceFunction)).findFirst();
371
372         final BlockInterFunction func;
373         if (optFunc.isPresent()) {
374             func = optFunc.get();
375         } else {
376             func = BlockInterFunction.BASIC_BLOCK;
377         }
378         return func;
379     }
380
381     /**
382      * Instantiate a new block with the specified interface function and uid.
383      *
384      * @param controller
385      *            the Java controller to use
386      * @param func
387      *            the interface function as an enum
388      * @param interfaceFunction
389      *            the interface function name
390      * @param uid
391      *            the allocated uid
392      * @return A new instance of a block.
393      */
394     public static BasicBlock createBlock(final JavaController controller, BlockInterFunction func, String interfaceFunction, long uid, Kind kind) {
395
396         final EnumMap<ObjectProperties, Integer> properties = new EnumMap<>(ObjectProperties.class);
397         properties.put(ObjectProperties.INPUTS, 0);
398         properties.put(ObjectProperties.OUTPUTS, 0);
399         properties.put(ObjectProperties.EVENT_INPUTS, 0);
400         properties.put(ObjectProperties.EVENT_OUTPUTS, 0);
401
402
403         /*
404          * Retrieve the JGraphX data before cell creation
405          */
406         String[] strUID = new String[1];
407         controller.getObjectProperty(uid, kind, ObjectProperties.UID, strUID);
408
409         String[] style = new String[1];
410         controller.getObjectProperty(uid, kind, ObjectProperties.STYLE, style);
411         if (style[0].isEmpty()) {
412             style[0] = interfaceFunction;
413         }
414
415         String value;
416         String[] description = { null };
417         controller.getObjectProperty(uid, kind, ObjectProperties.DESCRIPTION, description);
418         value = description[0];
419
420         VectorOfDouble geom = new VectorOfDouble(4);
421         controller.getObjectProperty(uid, kind, ObjectProperties.GEOMETRY, geom);
422
423         double x = geom.get(0);
424         double y = geom.get(1);
425         double w = geom.get(2);
426         double h = geom.get(3);
427         mxGeometry geometry = new mxGeometry(x, y, w, h);
428
429         /*
430          * Instanciate the block
431          */
432         BasicBlock block = null;
433         try {
434             Constructor<? extends BasicBlock> cstr = func.getKlass().getConstructor(JavaController.class, Long.TYPE, Kind.class, Object.class, mxGeometry.class, String.class, String.class);
435             block = cstr.newInstance(controller, uid, kind, value, geometry, style[0], strUID[0]);
436         } catch (InstantiationException | IllegalAccessException | IllegalArgumentException | InvocationTargetException | NoSuchMethodException
437                      | SecurityException e) {
438             // Something goes wrong, print it.
439             e.printStackTrace();
440             return block;
441         }
442
443         /*
444          * Synchronize model information back to the JGraphX data
445          *
446          * Annotations have no inputs/outputs
447          */
448
449         if (block.getKind() == Kind.BLOCK) {
450             insertPortChildren(controller, properties, block);
451         }
452
453
454         /*
455          * Compatibility to ease user definition :
456          *   * split are not updated as they have an hard-coded fixed-size
457          *   * round blocks : ports globally layout around the block
458          *   * generic case : layout the ports per kind per block-side
459          */
460         boolean convertGeometry;
461         if (block instanceof SplitBlock) {
462             convertGeometry = false;
463         } else if (block instanceof RoundBlock) {
464             int numberOfPorts = properties.get(ObjectProperties.INPUTS) + 1 +
465                                 properties.get(ObjectProperties.OUTPUTS) + 1 +
466                                 properties.get(ObjectProperties.EVENT_INPUTS) + 1 +
467                                 properties.get(ObjectProperties.EVENT_OUTPUTS) + 1;
468             convertGeometry = (2 * w + 2 * h) < (numberOfPorts * BasicPort.DEFAULT_PORTSIZE);
469         } else {
470             double minimalHeight = Math.max((properties.get(ObjectProperties.INPUTS) + 1) * BasicPort.DEFAULT_PORTSIZE, (properties.get(ObjectProperties.OUTPUTS) + 1) * BasicPort.DEFAULT_PORTSIZE);
471             double minimalWidth = Math.max((properties.get(ObjectProperties.EVENT_INPUTS) + 1) * BasicPort.DEFAULT_PORTSIZE, (properties.get(ObjectProperties.EVENT_OUTPUTS) + 1) * BasicPort.DEFAULT_PORTSIZE);
472
473             convertGeometry = h < minimalHeight | w < minimalWidth;
474             convertGeometry |= h * w < minimalHeight * minimalWidth;
475         }
476
477         if (convertGeometry) {
478             w = w * DEFAULT_SIZE_FACTOR;
479             h = h * DEFAULT_SIZE_FACTOR;
480
481             /*
482              * Invert the y-axis value and translate it.
483              */
484             y = -y - h;
485
486             block.setGeometry(new mxGeometry(x, y, w, h));
487         }
488
489         return block;
490     }
491
492     /**
493      * Instantiate a new block for an already created MVC object
494      *
495      * @param lastCreated the owned MVC object
496      * @return a block or null
497      */
498     public static BasicBlock createBlock(final JavaController controller, ScicosObjectOwner lastCreated) {
499         // pre-condition
500         if (lastCreated.getKind() != Kind.ANNOTATION && lastCreated.getKind() != Kind.BLOCK) {
501             return null;
502         }
503
504         String[] interfaceFunction = new String[1];
505         BlockInterFunction func = lookForInterfunction(interfaceFunction[0]);
506
507         return createBlock(controller, func, interfaceFunction[0], lastCreated.getUID(), lastCreated.getKind());
508     }
509
510     /*
511      * Port management
512      */
513
514     /**
515      * Helper used to create port children on a parent block.
516      *
517      * This method does not manage the model transaction and should be used to preset the children of a block out of an {@link XcosDiagram}.
518      *
519      * @param controller
520      *            is the shared controller instance
521      * @param properties
522      *            specify the kind of port to insert and should be some of :
523      *            <UL>
524      *            <LI>{@link ObjectProperties#INPUTS}
525      *            <LI>{@link ObjectProperties#OUTPUTS}
526      *            <LI>{@link ObjectProperties#EVENT_INPUTS}
527      *            <LI>{@link ObjectProperties#EVENT_OUTPUTS}
528      *            </UL>
529      *            This method will fill the value with the number of added ports
530      * @param parent
531      *            is the parent {@link mxCell} to modify
532      */
533     private static void insertPortChildren(final JavaController controller, final EnumMap<ObjectProperties, Integer> properties, final XcosCell parent) {
534         for (ObjectProperties property : properties.keySet()) {
535             properties.put(property, insertPortChildren(controller, property, parent));
536         }
537     }
538
539     /**
540      * Helper used to create port children on a parent block.
541      *
542      * This method does not manage the model transaction and should be used to preset the children of a block out of an {@link XcosDiagram}.
543      *
544      * @param controller
545      *            is the shared controller instance
546      * @param property
547      *            specify the kind of port to insert and should be one of :
548      *            <UL>
549      *            <LI>{@link ObjectProperties#INPUTS}
550      *            <LI>{@link ObjectProperties#OUTPUTS}
551      *            <LI>{@link ObjectProperties#EVENT_INPUTS}
552      *            <LI>{@link ObjectProperties#EVENT_OUTPUTS}
553      *            </UL>
554      * @param parent
555      *            is the parent {@link mxCell} to modify
556      * @return the number of inserted children
557      */
558     private static int insertPortChildren(final JavaController controller, final ObjectProperties property, final XcosCell parent) {
559         VectorOfScicosID modelChildren = new VectorOfScicosID();
560         controller.getObjectProperty(parent.getUID(), parent.getKind(), property, modelChildren);
561
562         XcosCell[] children = new XcosCell[modelChildren.size()];
563         for (int i = 0; i < children.length; i++) {
564             XcosCell child = createPort(controller, modelChildren.get(i), property);
565             children[i] = child;
566         }
567
568         modelChildren.clear();
569         controller.setObjectProperty(parent.getUID(), parent.getKind(), property, modelChildren);
570
571         Arrays.stream(children).forEach(c -> {
572             parent.insert(c);
573             controller.deleteObject(c.getUID());
574         });
575
576         return children.length;
577     }
578
579     /**
580      * Create a port for a specific uid
581      *
582      * @param controller
583      *            is the shared controller instance
584      * @param uid
585      *            represent the allocated UID on the MVC
586      * @param property
587      *            specify the kind of port to create and should be one of :
588      *            <UL>
589      *            <LI>{@link ObjectProperties#INPUTS}
590      *            <LI>{@link ObjectProperties#OUTPUTS}
591      *            <LI>{@link ObjectProperties#EVENT_INPUTS}
592      *            <LI>{@link ObjectProperties#EVENT_OUTPUTS}
593      * @return a newly allocated port
594      */
595     private static final BasicPort createPort(final JavaController controller, long uid, final ObjectProperties property) {
596         BasicPort port;
597         boolean[] isImplicit = { false };
598
599         String[] strUID = new String[] { "" };
600         controller.getObjectProperty(uid, Kind.PORT, ObjectProperties.UID, strUID);
601
602         String[] style = new String[] { "" };
603         controller.getObjectProperty(uid, Kind.PORT, ObjectProperties.STYLE, style);
604
605         String[] value = new String[] { "" };
606         controller.getObjectProperty(uid, Kind.PORT, ObjectProperties.LABEL, value);
607
608         switch (property) {
609             case INPUTS:
610                 controller.getObjectProperty(uid, Kind.PORT, ObjectProperties.IMPLICIT, isImplicit);
611                 if (isImplicit[0]) {
612                     port = new ImplicitInputPort(controller, uid, Kind.PORT, value[0], style[0], strUID[0]);
613                 } else {
614                     port = new ExplicitInputPort(controller, uid, Kind.PORT, value[0], style[0], strUID[0]);
615                 }
616                 break;
617             case OUTPUTS:
618                 controller.getObjectProperty(uid, Kind.PORT, ObjectProperties.IMPLICIT, isImplicit);
619                 if (isImplicit[0]) {
620                     port = new ImplicitOutputPort(controller, uid, Kind.PORT, value[0], style[0], strUID[0]);
621                 } else {
622                     port = new ExplicitOutputPort(controller, uid, Kind.PORT, value[0], style[0], strUID[0]);
623                 }
624                 break;
625             case EVENT_INPUTS:
626                 port = new ControlPort(controller, uid, Kind.PORT, value[0], style[0], strUID[0]);
627                 break;
628             case EVENT_OUTPUTS:
629                 port = new CommandPort(controller, uid, Kind.PORT, value[0], style[0], strUID[0]);
630                 break;
631             default:
632                 return null;
633         }
634
635         /*
636          * Setup JGraphX properties
637          */
638
639         return port;
640     }
641
642     /*
643      * Link management
644      */
645
646     private static BasicLink createLink(JavaController controller, long uid, Kind kind) {
647         int[] type = new int[1];
648         controller.getObjectProperty(uid, kind, ObjectProperties.KIND, type);
649
650         /*
651          * Synchronize model information back to the JGraphX data
652          */
653
654         String value;
655         String[] description = { null };
656         controller.getObjectProperty(uid, kind, ObjectProperties.DESCRIPTION, description);
657         value = description[0];
658
659         String[] style = new String[] { "" };
660         controller.getObjectProperty(uid, kind, ObjectProperties.STYLE, style);
661
662         String[] strUID = new String[] { "" };
663         controller.getObjectProperty(uid, kind, ObjectProperties.UID, strUID);
664
665         VectorOfDouble controlPoints = new VectorOfDouble();
666         controller.getObjectProperty(uid, kind, ObjectProperties.CONTROL_POINTS, controlPoints);
667         final int pointsLen = controlPoints.size() / 2;
668
669         mxGeometry geom = new mxGeometry();
670
671         // as the link is supposed to be connected and accordingly to the JGraphX rules : do not add the origin and destination point
672         ArrayList<mxPoint> points = new ArrayList<>();
673         int i = 0;
674         // ignore origin
675         i++;
676         // loop for points
677         for (; i < pointsLen - 1; i++) {
678             points.add(new mxPoint(controlPoints.get(2 * i), controlPoints.get(2 * i + 1)));
679         }
680         // ignore destination
681         i++;
682
683         geom.setPoints(points);
684
685         /*
686          * Allocate the link
687          */
688         BasicLink link;
689         switch (type[0]) {
690             case -1:
691                 link = new CommandControlLink(controller, uid, kind, value, geom, style[0], strUID[0]);
692                 break;
693             case 1:
694                 link = new ExplicitLink(controller, uid, kind, value, geom, style[0], strUID[0]);
695                 break;
696             case 2:
697                 link = new ImplicitLink(controller, uid, kind, value, geom, style[0], strUID[0]);
698                 break;
699             default:
700                 return null;
701         }
702
703         return link;
704     }
705
706     /*
707      * Annotation management
708      */
709
710     private static XcosCell createAnnotation(JavaController controller, long uid, Kind kind) {
711         String[] description = new String[] { "" };
712         controller.getObjectProperty(uid, kind, ObjectProperties.DESCRIPTION, description);
713
714         VectorOfDouble geom = new VectorOfDouble(4);
715         controller.getObjectProperty(uid, kind, ObjectProperties.GEOMETRY, geom);
716
717         double x = geom.get(0);
718         double y = geom.get(1);
719         double w = geom.get(2);
720         double h = geom.get(3);
721         mxGeometry geometry = new mxGeometry(x, y, w, h);
722
723         String[] strUID = new String[1];
724         controller.getObjectProperty(uid, kind, ObjectProperties.UID, strUID);
725
726         String[] style = new String[1];
727         controller.getObjectProperty(uid, kind, ObjectProperties.STYLE, style);
728
729         XcosCell label = new XcosCell(controller, uid, kind, description[0], geometry, style[0], strUID[0]);
730         label.setConnectable(false);
731         label.setVertex(true);
732
733         return label;
734     }
735 }