Control Points

Control points are the global positions of the target points, and are a sub-item of the Instrument Data folder. There can be only one set of control points for a project. There are two ways to manipulate Control Points:

1. The Right-Click menu
2. Control Point Editor

Right-Click menu

Control Point Editor

The Control Point Editor is activated when the user right-clicks Control Points ⇒ Edit.

Along the top is a toolbar with several icons. The icons and their corresponding functions are as follows:

	Activate Control Point toggles the selected control point(s) to be active in the current project.
	Deactivate Control Point toggles the selected control point(s) to be inactive in the current project.
	New Control Point brings up a dialog that allows you to specify the properties of a new control point to add.
	Edit Control Points brings up the point edit dialog which allows you to change properties of the currently selected Control Point.
	Copy Control Points allows you to copy the currently selected Control points to another point set (such as from the control points to the target points of a scan).
	Delete Control Points deletes the currently selected control points.
	Import Control Points brings up the ASCII file import dialog.
	Export Control Points brings up the ASCII file export dialog.
	Transform Control Points allows you to define a transformation sequence to apply to the control points.
	View Control Points brings up the scene creation dialog to create a scene for viewing the current control point set.
	Coordinate System allows you to choose the coordinate system the positions values are in (Global or any of the current scan positions)
	Settings allow you to configure what properties of the control points are visible in the spreadsheet control.
	Help brings up help documentation.

New Control Point

Name will specify a unique name to be used for the Control Point in the Project.
X, Y and Z may be in feet (ft) or Meters (m) as shown. These are the coordinates of the Control Point.
Description allows you to optionally add information that describes the new Control Point.
Target Points allows the user to specify Target Points from any Scan to be referenced to the new Control Point.

	Adds a new reference Target Point.
	Allows the user to edit the selected reference Target Point
	Deletes the selected reference Target Point

Import Control points

The settings of the import dialog must be configured to match the data ordering of the file being imported. First, ensure that the Delimiter is set to the correct value, if it is there should be multiple columns in the dialog, if it isn't, all of the data should only be in one column. After the delimiter is properly set, the data values for each column must be set. This can be done by clicking the header of each column (which say Click to Set by default) to bring up a menu with all the available values that can be set for that column. After setting these values, toggle the importing of lines you wish to leave out by clicking the green buttons in the Import column to turn them red. At the top of the dialog is the presets panel, which will allow you to save the current settings if you wish to use them again later. After configuring the dialog to match your data, click the green check to import and continue to the next step. The next dialog displayed will allow you to configure the naming conventions for the points to be imported.

Selecting Rename all items will rename all imported points to the settings specified in the options. The Duplicate Entries panel will specify the action to take when a point being imported has a name that already exists in the set of points being imported to. If the Rename all items toggle is not selected the names listed in the file being imported will be used. If there are no names in the file being imported and Rename all items is not selected, the control points will be named using the settings in Project Settings naming conventions.

Exporting Points

Clicking the export button will bring up the export points dialog, which will allow you to export the data to several different file formats.

Simply click the check boxes next to the data elements that you wish to export. To change the order of the data elements in the file, select the data element you wish to move and click the up or down arrow to move it.
The File panel determines which file format to export to and also allows you to specify an extension other than the default for a given file format.
The Text allows you to specify the Delimiter to be used as the divider between data elements in the file and whether to use the Write header to specify whether to write a header line to the file detailing the data ordering of the file.

Transform Points

The Transform Coordinate Points dialog allows specifying a sequence of transformations to apply to the currently selected points.

Initially the transformation list is empty. Press the green plus button to add a new transformation, which will bring up a new dialog.

There are three types of transformations, as well as an advanced transformation where the user can specify the transformation matrix to apply.

1. Translation transformations move the points linearly along the offset values specified.
2. Rotation transformations rotate the points around the axis specified the angle specified.
3. Scaling transformations scales the selected points (using the global origin as the origin for the scaling) in each dimension by the amount specified.

After the transformation's settings have been configured, pressing the green check mark will add it to the current list of transformations. In the Transformation sequence dialog the following functions apply:

	Will allow you to edit the currently selected transformation.
	Will delete the currently selected transformation.
	Will change the order of applications of the transformations. Transformations are applied in top-to-bottom order.

Settings

The Settings button will bring up the Point Editor settings dialog, which will allow the user to configure which data elements of the current point set are visible, as well as the order that they are displayed in.

Display of a property can be changed by toggling the check box next to that property, changing the order can be done by first selecting the property to move and then pressing the green up or down arrows to move the selected property up or down. Saving the current settings can be done clicking the plus button in the Presets panel.

Tab Location(s): Project Tab
Panel and Button: Current Project and Control Points
Prerequisite: None