Differences

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

--- groimp-platform:pointcloudtools [2024/11/11 16:53] – [Point cloud tools] gaetan
+++ groimp-platform:pointcloudtools [2024/12/06 12:04] (current) – [Point cloud tools] gaetan
@@ Line 1: / Line 1: @@
 ====== Point cloud tools ======
-To use the GUI-tools two ways are possible, first in the main Menu under Edit you can find a enty for point clouds that contains the functions. The second way is to use the NodeToolBar which can be found under Panels/nodetoolbar3d. The NodeToolBar always shows the function available for the selected object.
+This wiki present the base tools included in the [[https://gitlab.com/grogra/groimp-plugins/Pointcloud|Pointcloud plugin]]. The version used in 1.7.
-In order to select several obejcts please hold the **CTRL** key while clicking on the objects.
+Every tools presented here are available both from GUI or from RGG code. The projects used to create the images are available from the example explorer embedded in GroIMP. The tools consider the local transformation of the point cloud. The coordinate of the Point are local in relatively to the Point cloud Node.
+See more:
+  * [[groimp-platform:pointcloud|Point cloud structure]]
+  * [[tutorials:pointcloud-io|Import/export point clouds]]
+=== Using tools from the GUI ===
+There are two GUI way for accessing the point clouds tools:
+  * The edit menu:
+{{:groimp-platform:gui_pc_tools.png?200|}}
+  * The interactive toolbar (from the [[https://gitlab.com/grogra/groimp-plugins/Coolbar|Coolbar plugin]]), which automatically display usable methods depending on the current selection. See [[groimp-platform:coolbar|here]] for more information.
+{{:groimp-platform:coolbar3d.png?200|}}
+In order to select several objects please hold the **CTRL** key while clicking on the objects.
+=== Using tools from RGG code ===
 To use the tools in RGG you should import the following packages:
 <code java>
-import de.grogra.pointcloud.groimp.*;
-import de.grogra.pointcloud.groimp.PointCloud;
 import de.grogra.pointcloud.objects.impl.*;
 import de.grogra.pointcloud.tools.Tools;
@@ Line 15: / Line 31: @@
+===== Local transformation =====
+It is key to understand that in GroIMP each node have a local transformation, and the global coordinate of a node depends on the resolution of all previous local transformations from its parents in the graph.
+For point clouds nodes, it means that two point clouds with points that have the SAME coordinates, might be displayed at different global coordinates. The coordinates of Points are local by default. For instance, the two following point clouds are imported from the same file (and thus have the same local coordinates):
+{{:groimp-platform:pc_relativepos2.png?200| PC F}} {{ :groimp-platform:pc_relativepos1.png?200|F PC}}
+The first image results from //PointCloud F// and the second from //F PointCloud//.
+It is possible to force a point cloud to have global coordinates by moving it to the root of the graph and transforming it with its globalTransformation with :
+<code java>
+PointCloud myPC = ...;
+Matrix34d transfo = de.grogra.pointcloud.utils.Utils.getGlobalTransform( myPC);
+Matrix4d localT = myPC.getLocalTransformation();
+myPC.setTransform( transfo.transform( localT ) );
+[c:PointCloud ==> ^c;]
+</code>
-==== Split by plane ====
+===== Split by plane =====
 A given point cloud can be split into two point clouds based on a plane object.
@@ Line 43: / Line 78: @@
 //Note: The RGG split only works with a plane added through RGG//
+=== Output ===
+{{:groimp-platform:pc1_merge2.png?200|Before split}} {{ :groimp-platform:pc1_splitplane.png?200|After split}}
-==== Split by leaf ====
+===== Split by leaf =====
 A selection of leafs (points) of a point cloud can be seperated to become their own point cloud.
@@ Line 73: / Line 110: @@
 </code>
-==== Merge ====
+=== Output ===
+{{:groimp-platform:pc1_merge2.png?200| Before split}} {{ :groimp-platform:pc1_splitleaf.png?200|After split}}
+===== Merge =====
 Turning several point clouds into one. The end result will be of the format (graph/list/array) of the first selected point cloud.
+The merge tool is considering the coordinate of the point relatively to the Point cloud Node. For Node added to the root of the project graph, their local transformations are equivalent to a global one. Thus, Point clouds added at the root of the project graph, or having not transforming parent to the root, have "global coordinate".
+However, if the point clouds are under other transformations in the graph, the merged Points will be added to the other Point cloud with their local coordinate.
 === GUI ===
@@ Line 94: / Line 139: @@
+=== Output ===
+Point clouds added to the Project graph root:
+{{:groimp-platform:pc1_merge1.png?200|Before merge}} {{ :groimp-platform:pc1_merge2.png?200|After merge}}
+Point clouds with local transformations (as part branch of Nodes with transformations).
+In the following example, the two point clouds are added each after a F build by the following code (where //PC1// and //PC2// are the Point cloud nodes:
+<code java>
+Axiom ==> F PC1 F PC2 ;
+</code>
+In that example, the points of PC1 are translated by the //F// Node, but their local coordinates do not include this translation. Similarly, the points of PC2 are translated twice, once per F.
+If we merge the //RED// point cloud (PC2) into the //BLACK// one we have the following result (the points of PC2 are translated only by the first F):
+{{:groimp-platform:pc2_merge1.png?200|Before merge}} {{ :groimp-platform:pc2_merge2.png?200|After the merge}}
 ==== Cluster ====