Unroll - Revision history

Daniel at 15:47, 6 February 2025

2025-02-06T15:47:04Z

← Older revision		Revision as of 17:47, 6 February 2025
Line 10:		Line 10:
	[[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]]		[[Image:Cc_unroll_cone_example.jpg\|frame\|center\|Unrolled cone]]

	~~Since version 2.13, it is now possible to:~~
	* define a custom 3D axis
	* init the unrolling parameters with an existing cylinder or cone entity present in the database
	* output the unrolled cloud in an arbitrary coordinate system

	== Procedure ==		== Procedure ==
Line 54:		Line 49:
	Most of these parameters can be populated by choosing an existing cone primitive already loaded in the database.		Most of these parameters can be populated by choosing an existing cone primitive already loaded in the database.

	==~~= Straightened cone =~~==		== Export deviation scalar field ==

	~~This mode was corresponding~~ to the ~~'Cone'~~ unrolling ~~mode in version 2.8 and prior.~~		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.

	~~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)
	* 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~~ ==		== Output unrolled cloud in an arbitrary coordinate system ==

	~~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.		Since version 2.13, it is now possible to output the unrolled cloud in an arbitrary coordinate system:
			* X: unroll angle
			* Y: distance to primitive
			* Z: longitude

Daniel: /* Cone */

2025-02-06T15:45:07Z

Cone

← Older revision		Revision as of 17:45, 6 February 2025
Line 40:		Line 40:
	* Conical		* Conical
	* Cylindrical (fixed radius)		* Cylindrical (fixed radius)
			** this mode corresponds to the old 'Cone' unrolling mode in version 2.8 and prior. It unrolls a cone-shaped cloud as if it was a cylinder, by first 'straightening' the cone walls.
	* Cylindrical (adaptive radius)		* Cylindrical (adaptive radius)

Daniel: /* Cylinder */

2025-02-06T15:43:58Z

Cylinder

← Older revision		Revision as of 17:43, 6 February 2025
Line 24:		Line 24:
	[[Image:Cc_unroll_cylinder_dialog.jpg\|frame\|center\|'Unroll cylinder' dialog]]		[[Image:Cc_unroll_cylinder_dialog.jpg\|frame\|center\|'Unroll cylinder' dialog]]

	~~To unroll a cylindrical shape, the~~ parameters are:		Main parameters are:
	* axis of revolution (X, Y or Z)		* axis of revolution (X, Y, Z, or a custom 3D axis)
	* cylinder 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'')		* 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.		* 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.

			Most of these parameters can be populated by choosing an existing cylinder primitive already loaded in the database.

	[[Image:Unroll_angles.JPG\|frame\|center\|'Unroll angular zero and sign' dialog]]		[[Image:Unroll_angles.JPG\|frame\|center\|'Unroll angular zero and sign' dialog]]

Daniel: /* Cone */

2025-02-06T15:42:29Z

Cone

← Older revision		Revision as of 17:42, 6 February 2025
Line 35:		Line 35:

	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).		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).
			And since version 2.13, a sub-option 'Projection' allows to choose the type of conical projection among:
			* Conical
			* Cylindrical (fixed radius)
			* Cylindrical (adaptive radius)

	[[Image:Cc_unroll_cone_dialog.jpg\|frame\|center\|'Unroll cone' dialog]]		[[Image:Cc_unroll_cone_dialog.jpg\|frame\|center\|'Unroll cone' dialog]]

	~~To unroll a conical shape, the~~ parameters are:		Main parameters are:
	* axis of revolution (X, Y or Z)		* axis of revolution (X, Y, Z or a custom 3D axis)
	* 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 in 3D		* the cone apex position in 3D
			* span ratio
			* start and stop angles

			Most of these parameters can be populated by choosing an existing cone primitive already loaded in the database.

	=== Straightened cone ===		=== Straightened cone ===

Daniel at 15:36, 6 February 2025

2025-02-06T15:36:07Z

← Older revision		Revision as of 17:36, 6 February 2025
Line 10:		Line 10:
	[[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]]		[[Image:Cc_unroll_cone_example.jpg\|frame\|center\|Unrolled cone]]

			Since version 2.13, it is now possible to:
			* define a custom 3D axis
			* init the unrolling parameters with an existing cylinder or cone entity present in the database
			* output the unrolled cloud in an arbitrary coordinate system

	== Procedure ==		== Procedure ==

Daniel at 21:03, 28 September 2022

2022-09-28T21:03:13Z

← Older revision		Revision as of 23:03, 28 September 2022
Line 51:		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.

Daniel: /* Cylinder */

2022-09-28T21:00:46Z

Cylinder

← Older revision		Revision as of 23:00, 28 September 2022
Line 23:		Line 23:
	* cylinder 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'')		* 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)		* 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]]		[[Image:Unroll_angles.JPG\|frame\|center\|'Unroll angular zero and sign' dialog]]

Daniel: /* Cylinder */

2022-09-28T20:58:51Z

Cylinder

← Older revision		Revision as of 22:58, 28 September 2022
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]]		[[Image:Unroll_angles.JPG\|frame\|center\|'Unroll angular zero and sign' dialog]]

Daniel: /* Cylinder */

2022-09-28T20:57:36Z

Cylinder

← Older revision		Revision as of 22:57, 28 September 2022
Line 23:		Line 23:
	* 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'')		* and optionally a point on the axis (''otherwise CloudCompare can try to guess it by computing the gravity center of the point cloud'')

			[[Image:Unroll_angles.JPG\|frame\|center\|'Unroll angular zero and sign' dialog]]

	=== Cone ===		=== Cone ===

Daniel: /* Straightened cone */

2017-01-14T14:02:03Z

Straightened cone

← Older revision		Revision as of 16:02, 14 January 2017
Line 36:		Line 36:

	=== 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.