Differences

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

--- tutorials:virtual_skeletonization [2025/05/05 16:23] – created gaetan
+++ tutorials:virtual_skeletonization [2025/05/05 17:06] (current) – [Commands] gaetan
@@ Line 19: / Line 19: @@
 VRSPoint have global positions and are updated when their linked Nodes are modified.
+===== IMP interface =====
+The VRS is accessible from the GUI as a [[:dev-guide:add-navigation|navigator]]. It can be selected has follow:
+{{:tutorials:vrs_navigator.png?300|}}
+This navigation keep the [[:3d-guide:view_manipulations#Navigate_in_the_scene|default navigation and selection]]. Additionally it includes three short cuts:
+  - **R** + left click: adds a VRSBase and a VRSPoint to either: the selected Node location, or 0,0,0 by default.
+  - **N** + left click: adds a VRSPoint to the click location. It requires to have an existing VRSPoint selected. A **Node** (Axis of the selected type) using the selected VRSPoint as start, and the newly created one as end.
+  - **B** + left click: adds a VRSPoint as branch to the selected **Node** at the click location. It requires to have a **Node** selected which is part of an existing skeletonization.
+===== Node Type =====
+Between each VRSPoint is added a **Node**. By construction, any de.grogra.graph.impl.Node would work. But currently only the Nodes that extends AxisBase are properly updating their transformation to fit both the local transformation so the branches/successors works without the skeleton; and the global transformations of the VRSPoints so the Node follow the locations of the VRSPoint if modified.
+It is possible to change the type of Node used from the [[:user-guide:panel_options|preferences]] as shown:
+{{:tutorials:vrs_shape.png?400|}}
+By default, only turtle F, M and 3D primitives Parallelogram and Cylinders are listed. Any class or module defined in the current project that extends AxisBase (or any of its sub classes) will be listed here as well.
+===== Commands =====
+If used from another UI than IMP GUI, the commands available are:
+  * /ui/vrs/addroot : it takes as paramters:
+    * context: a context
+    * x: a double
+    * y: a double
+    * z: a double
+    * selected: (optional) a boolean if the added node is selected after being added
+  * /ui/vrs/addpoint : it takes as paramters:
+    * context: a context
+    * x: a double
+    * y: a double
+    * z: a double
+    * selected: (optional) a boolean if the added node is selected after being added
+  * /ui/vrs/addbranch : it takes as paramters:
+    * context: a context
+    * x: a double
+    * y: a double
+    * z: a double
+    * selected: (optional) a boolean if the added node is selected after being added
+  * /ui/vrs/settype
+    * context: a context
+    * newtype: a String that represent the Simple name of the type to use (one of the listed ones in preferences).