Label modes

There are different label visualization modes. They can be mainly divided into two categories: 3D modes and 2D modes.

• In all modes, in third person, labels appear when entering Selection mode and disappear when selecting an item (except labelOld).

• In labelOld mode, the labels are always visible while in Selection mode, even after selecting an item.

• All modes, except labelOld, can be switched at runtime. The labelOld option is not managed by LabelViewer and cannot be set after LabelViewer starts to operate.

• Option label3D is the current EYESIM product standard.

Old 3D labels (labelOld)

• For retro-compatibility reasons, the default label mode is labelOld.

• Labels are 3D billboards. Sometimes, they can be difficult to read, especially in third person view, as they can be distant from the camera.

• In labelOld mode, there is no restriction on the number of displayed labels.

  

3D zoom labels (labelZoom)

• LabelZoom labels are visible only up to the visibleNum value. Most near item labels appear.

• The labels are 3D billboards, but their scale is automatically adapted to the same size in pixels according to labelZoomFactor value.

• The label appears as they would in labelOld mode, which is 1/labelZoomFactor meters from them.

• [0-1] values show smaller labels while (1-inf) show bigger labels.

  

3D labels (label3D)

• 3D labels are visible only up to the visibleNum value. Most near item labels appear.

• The 3D labels option looks similar to labelZoom, but has several differences. The displayed labels are not label meshes, but runtime-created billboard meshes placed at a specific position. The scaling is perfectly smooth and the visual quality of the label text and image is high quality.

• The dimension scale is automatically adapted to have the same size in pixels according to labelZoomFactor value.

• The labels appear as they would in labelOld mode, which is 1/labelZoomFactor meters from them.

• [0-1] values show smaller labels while [1-inf] show bigger labels.

• The label3D mode is the only mode that supports label automatic generation features.

  

Left 2D labels (labelLeft)

• Left 2D labels are visible only up to the visibleNum value. Most near item labels appear.

• Labels are all listed in 2D on the left.

• A line connects a label to the corresponding object.

• Label size is not based on corresponding 3D Label. It is defined by the LabelViewer labelSize2D parameter.

  

Center 2D Labels (labelCenter)

• The labelCenterParams parameter defines a 2D area in which labels appear.

• Labels are placed inside the area on an arc.

• A line connects a label to the corresponding object.

• Smaller or larger labelCenterParams length values are reflected in a mostly curved arc.

• LabelCenter labels are visible only up to the visibleNum value. Most near item labels whose item is placed below the label visualization area appear.

• Label size is not based on corresponding 3D Label. It is defined by the LabelViewer labelSize2D parameter.

  

Over 2D labels (labelOver)

• Label Over labels are visible only up to the visibleNum value. Most near item labels appear.

• 2D labels display near the corresponding object.

• This view maximizes the readability and ease to relate label and corresponding item.

• Label size is not based on corresponding 3D Label. It is defined by the LabelViewer labelSize2D parameter.