TaskScoreGraph
- Last UpdatedDec 16, 2023
- 3 minute read
This topic is part of Specialized 2D Nodes.
TaskScoreGraph node
The TaskScoreGraph node generates a texture that displays a dynamic task performance monitor. Note that the node just creates the texture, which means that the node must be attached somewhere using the syntax: internal:taskScoreGraphName. For example, in an ItemPanelPopup inside a Rect2D.
Platform support
This node is supported on XR-Windows platform only.
|
XR-WIN |
XR-P-WIN |
XR-P-IOS |
XR-P-AND |
XR-P-WASM |
|---|---|---|---|---|
|
Full support |
No support |
No support |
No support |
No support |
|
|
|
|
|
|
Monitor mode
Time
The Time mode plots a line graphic with time on the X axis and points percentage on the Y axis.
currentPoints*100)/maximumPoints
The graph is made up 200 points.
To change the time window, modify the refreshTime parameter.
Set to 0.1 to display the monitor for 20 seconds.
Set to 1.5 means to display the monitor for 5 minutes.
Tasks
In Tasks mode, the graph is an histogram with the first level tasks on the X axis and the accuracy for the task on the Y axis.
taskCurrentPoints*100)/taskMaximumPoints
The color of the bars depends on the task state (running, waiting, success, failed).
Code example
This is a code example for the TaskScoreGraph node.
<TaskScoreGraph name="scoregraphTexture" taskmanagerNode="currentTaskmanager" viewFromTask="mission" backgroundImage="scoregraph_background.png"/>
<rect name="scoregraph" visible="false" image="internal:scoregraphTexture" position="20 660" order="20" size="256 256" bilinear="true"/>
TaskScoreGraph fields
These are the fields for TaskScoreGraph node. Only the node-specific fields are indicated, not fields obtained by inheritance.
Field inheritance: NodeBase > TaskScoreGraph
|
Fields |
Type |
Use |
Default value |
Description |
|---|---|---|---|---|
|
backgroundImage |
sstring |
Mandatory |
Not set |
Name of the image to use for the texture background. |
|
mode |
senum |
Optional |
Time |
Specifies either Time or Tasks as the type of graphic display. |
|
refreshTime |
sfloat |
Optional |
0.1 |
Data sampling time for time graph, expressed in seconds. |
|
taskmanagerNode |
sstring |
Mandatory |
No default |
Name of the TaskManager node to connect for performance evaluation. |
|
textColorFail |
svec3 |
Optional |
1 0 0 |
Text color for tasks in fail status. The color is expressed in normalized (0-1) RGB (0 0 0 for black, 1 1 1 for white). |
|
textColorRunning |
svec3 |
Optional |
1 1 1 |
Text color for tasks in running status. The color is expressed in normalized (0-1) RGB (0 0 0 for black, 1 1 1 for white). |
|
textColorSuccess |
svec3 |
Optional |
0 1 0 |
Text color for tasks in success status. The color is expressed in normalized (0-1) RGB (0 0 0 for black, 1 1 1 for white). |
|
textColorWaiting |
svec3 |
Optional |
0.5 0.5 0.5 |
Text color for tasks in waiting status. The color is expressed in normalized (0-1) RGB (0 0 0 for black, 1 1 1 for white). |
|
textScore |
sstring |
Optional |
Score |
Text displayed on the Y axis in both modes. |
|
textTasks |
sstring |
Optional |
Tasks |
Text displayed on the Y axis in the Tasks mode. |
|
textTime |
sstring |
Time |
Text displayed on the Y axis in the Time mode. |
|
|
viewFromTask |
sstring |
Mandatory |
No default |
Node inside the TaskManager to be used as root for performance evaluation (usually the mission base task). |