==== Point cloud fitting functions ====

All functions described here require one or multiple point clouds selected in the current 3D view. Otherwise, an error dialog is shown. If point clouds are selected, a dialog box asks for the fitting mode. In case of a cylinder, a frustum, a cone, and the automatic mode also the precision parameter is requested. Another dialog box asks whether the selected point clouds should be kept or removed. After confirming one of the options, the objects are created, displayed in the 3D view and get selected.

The differences are as follows:

  * The **fit sphere to point cloud** function does not request for the precision parameter. The precision parameter is not used since the sphere fitting does not use the Fibonacci sphere fitting algorithm. After the fitting was executed, spheres are added to the 3D view.
  * The **fit cylinder to point cloud** function adds cylinders to the 3D view.
  * The **fit frustum to point cloud** function adds frustums to the 3D view.
  * The **fit cone to point cloud** function adds cones to the 3D view.
  * The **fit automatic object to point cloud** function adds automatically selected objects to the 3D view. If multiple point clouds are fitted, different objects can be created.

In the first dialog box, the fitting parameters can be set. For cylinders, frustums, and cones, the precision and the fitting mode can be selected. The precision must be a positive integer value. It is used as the number of points in the internally used Fibonacci sphere. The points of a Fibonacci sphere are then used as possible direction vectors for the fitted object. Spheres do not need a direction vector and do not request the precision parameter. The fitting mode can be selected to either "average", or "maximum". It is available for all types of fittable objects and is used to set its radius. In case of a sphere, the radius is determined by the average or maximum distance of all points in the point cloud to the center position of the fitted sphere. In case of a cylinder, frustum, or cone, the radius is determined by the average or maximum distance of all points in the point cloud to the principal axis of the respective object.

**Note:** All texts in the user interface are provided in English by default. They can be translated with language depending resource files. Some of the dialog boxes of Java are translated automatically and can differ from the GroIMP language.

The second dialog box is always shown after the parameters have been entered successfully. Here, the user is asked whether the point cloud should be removed during the fitting process. This can be useful in some cases, but it can also be disturbing in some other cases. If the fitting function was selected accidentally, it can also be canceled here. With the function in the graphical user interface, it is possible to fit one or more point clouds at the same time. If only one point cloud is selected (and fitted later), the texts are written in singular in this dialog box. Otherwise, plural is used.