Difference between revisions of "Unroll"
(Created page with "== Menu == This tool is accessible via the 'Tools > Projection > Unroll' menu. == Description == This method 'unrolls' a point cloud from a cylindrical (or conical) shape o...") |
|||
(8 intermediate revisions by the same user not shown) | |||
Line 9: | Line 9: | ||
[[Image:Cc_unroll_input.jpg|frame|center|Cylindrical shape to unroll]] | [[Image:Cc_unroll_input.jpg|frame|center|Cylindrical shape to unroll]] | ||
[[Image:Cc_unroll_result.jpg|frame|center|Cylindrical shape unrolled]] | [[Image:Cc_unroll_result.jpg|frame|center|Cylindrical shape unrolled]] | ||
+ | [[Image:Cc_unroll_cone_example.jpg|frame|center|Unrolled cone]] | ||
== Procedure == | == Procedure == | ||
− | Select a cloud then start this tool. | + | Select a single cloud then start this tool. |
=== Cylinder === | === Cylinder === | ||
− | [[Image: | + | [[Image:Cc_unroll_cylinder_dialog.jpg|frame|center|'Unroll cylinder' dialog]] |
To unroll a cylindrical shape, the parameters are: | To unroll a cylindrical shape, the parameters are: | ||
* axis of revolution (X, Y or Z) | * axis of revolution (X, Y or Z) | ||
− | * radius | + | * 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. | ||
+ | |||
+ | [[Image:Unroll_angles.JPG|frame|center|'Unroll angular zero and sign' dialog]] | ||
=== Cone === | === Cone === | ||
− | [[Image: | + | 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]] | ||
To unroll a conical shape, the parameters are: | 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. | ||
+ | |||
+ | [[Image:Cc_unroll_straightened_cone_dialog.jpg|frame|center|'Unroll straightened cone' dialog]] | ||
+ | |||
+ | To unroll a straightened conical shape, the parameters are: | ||
* axis of revolution (X, Y or Z) | * axis of revolution (X, Y or Z) | ||
* half angle (this is the ''aperture'' angle at the cone apex - in degrees) | * half angle (this is the ''aperture'' angle at the cone apex - in degrees) | ||
* the cone apex position | * 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. |
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:
Procedure
Select a single cloud then start this tool.
Cylinder
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.
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).
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.
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.