Wireframe Properties Dialog - Labels Tab

Labeling wireframes in VR

Wireframe Properties Dialog - Labels Tab

To access this dialog:

In the Wireframe Properties dialog, select the Labels tab.

The Labels tab of the Wireframe Properties dialog is used to control the formatting of the labels for wireframes in the active 3D window. Click Apply in this dialog to update the active 3D window with your changes.

The settings described here apply to the currently active 3D window and all linked external windows. Independent windows will be unaffected.

A 'label' is represented by one or more text items. These can be freeform text, calculated values or values of point object attributes, or any combination. Labels are first defined by setting up the Text field with one or more text items (over one or multiple lines) and then defining that particular label's visual formatting.

You can define as many labels as you need, with each label supported by its own formatting settings. This means you could have, say, a large green label indicating the XYZ position of one aspect of your data on the left and a smaller label on the right of your data indicating another attribute value, for example:

In the above image, 2 separate labels have been defined for the same object overlay. You can quickly view all labels assigned to a particular overlay using the Label drop-down menu. This lists all labels in a table, letting you enable or disable particular labels as you need to, and even delete unwanted labels, for example:

You can add labels to the list (and format them independently afterwards) by clicking New.

Field details:

Display labels: if selected, then the controls on the Labels tab are activated, and any labels defined in this tab are displayed in the active 3D window when you click Apply

Column: this dropdown list allows you to

You can select a virtual data column for labelling which will be recalculated dynamically during 3D object editing.

Distance (string data only): display the distance along the string that the label appears. Often used in conjunction with the Intervals positional option.

DP: allows you to set the number of decimal places for the column shown in the Column dropdown list. The following options are provided:

- Auto: values are displayed without trailing zeros; for example, '10.5000' is displayed as '10.5'.
- From '0' to '6' decimal places: values are displayed using the number of decimal places that you specify.

Insert: adds the selected column into theText box using the criteria set in the Decimal places dropdown list.

Text: this group in the Labels tab allows you to create the labels that are shown in the active 3D window for the currently active label (the one shown in the Label field above). The content of the labels can either be typed directly into the Text box, or the accompanying buttons can be used. Labels can comprise static text, as well as values associated with the columns that you add.

Text can be entered directly, using the following convention:

Freeform text entry with no further formatting will be appear as typed
[Column name:.n] - adds values associated with the specified Column using n decimal places.
[Column name] - adds values associated with the specified Column.

When creating labels using the Column and Decimal places dropdown lists, you must click Insert to update the contents of the Text box.

Font: this group allows you to set the style of font used by labels.

Type: specify either a 2D or 3D text style for labels.
- 2D: the size of labels remains constant, regardless of the viewing distance. If 2D is selected, then Plane cannot be selected in the Orientation group.
- 3D: the size of labels varies depending on the viewing distance, although when viewed at an excessively long distance, their display is turned off. If 3D is selected, then either Screen or Plane can be selected in the Orientation group.

Font: specify the font style using the accompanying dropdown list.

Size: specify the size of font using the spin buttons.

Alignment: allows you to justify multiple rows of text to the left, right or center.

Position: allows you to label either individual wireframe triangles, or groups of wireframe triangles that have the same value for a specified column.

Triangles: adds a label for each wireframe triangle. This is the only available option, and is selected by default.

Group by: if selected, then labels are displayed by any groups of triangles that have the same value for the column selected in the accompanying dropdown list. Labels are positioned at the center of the groups, calculated as the average position of the relevant triangles.

Offset: allows you to set the position of the label relative to each triangle. By default, the label is positioned at the centre of each triangle. The triangle is represented by the central black box in the grid, and the position of the label is set by clicking the required button. For example, the setting shown below results in the label being positioned above, and to the right of the triangle's center, as shown.

Offset Setting

Position of Labels

Orientation: this group allows you to set the orientation of labels relative to the wireframe triangles. The orientation of 2D labels can only be set as Screen; the orientation of 3D labels can be set as ScreenorPlane. The rotation of both 2D and 3D labels, and the requirement to keep 3D labels upright can also be set, under the conditions described below.

Screen: labels are shown in the plane of the screen, according to their rotation angle, as shown below. This option is available for both 2D and 3D labels.

Plane: labels are orientated in the specified plane, as shown below.

When the Plane option is selected, labels may appear back-to-front and/or upside-down, depending on the viewing angle.

Azimuth and Dip: if selected, then you can define the azimuth of the labels within a range of -360 to 360 degrees, and the Dip within a range of -90 to 90 degrees. In the following example, an azimuth of '45' and a dip of '0' have been set.

Section: if selected, then labels are aligned to the section that you select in the accompanying dropdown list. You can either select the active section, or any currently-loaded section. An example is shown below.

Triangle: labels are orientated in the plane of each wireframe triangle, as shown below.

Rotation: if selected, then labels are rotated about their center within a range of -360 to 360 degrees.

Keep upright: this option is only available if Plane is selected for 3D labels. If set, then the label is drawn in the positive Z direction when looking at the label from above. Labels may still appear upside-down, however, depending on the viewing angle.

Color: allows you to define the color of labels using a standard fixed color, or a display legend that references the attributes of the relevant data type.

Fixed: set this option to select a standard fixed color for all labels from the adjacent dropdown list. If the Legend option is selected, then the fixed color is also used to color labels that cannot be matched to a legend interval.

Legend: allows you to select a predefined, system standard or user-created legend. If data cannot be matched to a legend interval, then the associated label is colored using the color shown in the Fixed dropdown list.

Column dropdown list: after selecting a legend, use the dropdown list to select a data field containing color values to be matched to the legend.

As with all legend dropdown lists, once a legend has been selected, it can then be displayed or edited. A default legend can also be created automatically for any selected field.

	Show the currently-selected legend intervals and display properties.
	Edit the currently-selected legend using the Legends Manager dialog.
	Select a default legend for the selected data column if one already exists, or if no default legend is available, the Create New Legend wizard will appear to let you create a new legend.

The color selected in the Fixed dropdown list is used to color labels whenever a value cannot be found for a selected legend and column.

Options: this group provides the following options that allow you to improve the formatting of labels.

Always on top: set this option to prevent labels being obscured by the displayed data. This is particularly useful when labeling 3D data which may make it difficult to see labels due to their shape.

Group thousands: if labels contain long numbers, selecting this option makes them more readable by separating each group of three digits with a comma.

Hide absent values: if selected, then the '-' character, that is used to denote absent values, is hidden.

	Related Topics
	Wireframe Properties Dialog - General Tab Associated files dialog Info Mode List Dialog