WHAT IS
3D RAD?
CLICK HERE
TO FIND OUT!

ValueLabelBar

Attach bar-shaped labels to any 3d object and display its internal values. Bar size, color, transparency and range values are definable.


USAGE
Add the ValueLabelBar object to your project, link it to all the object you want to read the values from and also to all 3d objects you want to attach a bar-label to.

You link objects together in the Object List (left side of 3D Rad main screen), by selecting an object and then checking the other objects you want to link to it.

To configure the ValueLabelBar object, double-click it in the Object List to open the following property dialog:



Bar width & height
Any size is allowed, but too big values may affect rendering quality.

Bar location offset
The current screen location of the target object center is used as a reference. The offset is in screen units.

Bar orientation (in degrees)
Default orientation (zero degrees) is for a vertical bar.

Color & opacity (filled bar)
Click the color button to select the color of the bar filler. Opacity must be between 0.0 (invisible) and 1.0 (fully visible).

Color & opacity (empty bar)
Click the color button to select the color of the empty part of the bar.

Color & opacity (frame)
Click the color button to select the color of the bar's frame.

Value range
The source value can be clamped or wrapped within a specified range. For example, if the source value is 48 and the range is 50,100, in clamp-mode the actual value used for the bar is 50 and in wrap mode it is 98.

Bar range
The bar is displayed properly only if these two values match the minimum and maximum values that source value can be.

Relationships
This list defines how the ValueLabelBar object relates to the object linked to it. The following relationship types are supported:

IGNORE. Do nothing.

[parameter] is displayed as a BAR. Display the specified internal value of the 3d object as a bar-label attached to it.

[parameter] is displayed as another object's BAR. Read the specified internal value of the object but attach the resulting bar-label to the object marked as ATTACH BAR-LABEL (see below).

Please see linked object's documentation (INTERNAL PARAMETERS section) for details on the internal parameters it supports.

NOTE: if you specify two or more objects as source, the displayed result is the average of all source parameters.

ATTACH BAR-LABEL. Attach to this object the numeric label generated from the '[parameter] is displayed as another object's BAR' object (see above).

Visible at start
Whether to show the bars when the project is run. If this option is unchecked, you will have to link this object to an event object like for example EventTimer in order to visualize them.

For information about the remaining controls, please click here.