Difference between revisions of "Unroll"

From CloudCompareWiki
Jump to navigation Jump to search
 
(5 intermediate revisions by the same user not shown)
Line 22: Line 22:
 
* axis of revolution (X, Y or Z)
 
* axis of revolution (X, Y or Z)
 
* cylinder radius
 
* cylinder radius
* and optionally a point on the axis (''otherwise CloudCompare can try to guess it by computing the gravity center of the point cloud'')
+
* optionally a point on the axis (''otherwise CloudCompare can try to guess it by computing the gravity center of the point cloud'')
 +
* since version 2.11, it is also possible to specify the angular range. By default it's [0-360], but you can input any angular value, and even multiple revolutions.
 +
 
 +
[[Image:Unroll_angles.JPG|frame|center|'Unroll angular zero and sign' dialog]]
  
 
=== Cone ===
 
=== Cone ===
  
This method unrolls a cone in a way that preserves surfaces (as if the cone was 'rolling' on a planar surface).
+
Since version 2.9, this method unrolls a cone in a way that preserves surfaces (as if the cone was 'rolling' on a planar surface).
  
 
[[Image:Cc_unroll_cone_dialog.jpg|frame|center|'Unroll cone' dialog]]
 
[[Image:Cc_unroll_cone_dialog.jpg|frame|center|'Unroll cone' dialog]]
Line 36: Line 39:
  
 
=== Straightened cone ===
 
=== Straightened cone ===
 +
 +
This mode was corresponding to the 'Cone' unrolling mode in version 2.8 and prior.
  
 
This method unrolls a cone-shaped cloud as if it was a cylinder, by first 'straightening' the cone walls.
 
This method unrolls a cone-shaped cloud as if it was a cylinder, by first 'straightening' the cone walls.
Line 46: Line 51:
 
* the cone apex position
 
* the cone apex position
 
* the base radius of the 'straightened' cone (= cylinder)
 
* the base radius of the 'straightened' cone (= cylinder)
 +
 +
== Export deviation scalar field ==
 +
 +
A checkbox named 'Export deviation scalar field' allows to compute for each point its radial distance to the theoretical unrolling shape (cylinder or cone). A new scalar field will be added to the output cloud.

Latest revision as of 15:03, 28 September 2022

Menu

This tool is accessible via the 'Tools > Projection > Unroll' menu.

Description

This method 'unrolls' a point cloud from a cylindrical (or conical) shape onto a plane:

Cylindrical shape to unroll
Cylindrical shape unrolled
Unrolled cone

Procedure

Select a single cloud then start this tool.

Cylinder

'Unroll cylinder' dialog

To unroll a cylindrical shape, the parameters are:

  • axis of revolution (X, Y or Z)
  • cylinder radius
  • optionally a point on the axis (otherwise CloudCompare can try to guess it by computing the gravity center of the point cloud)
  • since version 2.11, it is also possible to specify the angular range. By default it's [0-360], but you can input any angular value, and even multiple revolutions.
'Unroll angular zero and sign' dialog

Cone

Since version 2.9, this method unrolls a cone in a way that preserves surfaces (as if the cone was 'rolling' on a planar surface).

'Unroll cone' dialog

To unroll a conical shape, the parameters are:

  • axis of revolution (X, Y or Z)
  • half angle (this is the aperture angle at the cone apex) in degrees
  • the cone apex position in 3D

Straightened cone

This mode was corresponding to the 'Cone' unrolling mode in version 2.8 and prior.

This method unrolls a cone-shaped cloud as if it was a cylinder, by first 'straightening' the cone walls.

'Unroll straightened cone' dialog

To unroll a straightened conical shape, the parameters are:

  • axis of revolution (X, Y or Z)
  • half angle (this is the aperture angle at the cone apex - in degrees)
  • the cone apex position
  • the base radius of the 'straightened' cone (= cylinder)

Export deviation scalar field

A checkbox named 'Export deviation scalar field' allows to compute for each point its radial distance to the theoretical unrolling shape (cylinder or cone). A new scalar field will be added to the output cloud.