Texts

📌 What are they?

The Text type Visualizations in TOKII allows displaying literal (non-numeric) content directly and without additional graphical encoding. It is ideal for exposing status messages, names, descriptions, operational labels, or any relevant alphanumeric value. Its purpose is to inform textually and contextually, without graphical interpretation, about the 3D model of the digital twin.

They can be short texts or longer descriptions.

🔍 It is typically used to show:
• System statuses (e.g. "Active", "Out of service")
• Qualitative indicators (e.g. "Alert", "Normal")
• Custom messages
• Information extracted from databases or APIs

🎯 When to use them?

• Show literal text directly linked to an object or section of the twin.

• Convey qualitative statuses (descriptions, conditions, warnings).

• Display contextual information without analysis.

📥 Data Submission Formats

▸ From dataset

Example table:

The following table presents the format of a sample dataset. The value that will be displayed in the text will be from the last row.

• The last value of the selected column will be displayed by default.

• In the KPI form:

  • Value: column of type String (e.g. short_text)

  • Value Type: String

    

▸ From MQTT

Plain text:

Text area:

🖥️ Visual configuration of text in the 3D App

Within the TOKII App, when selecting a Text type KPI, options appear to customize its appearance. These options allow adapting the text display in terms of shape, style, and location, ensuring a clear reading and aesthetic integration within the 3D model.

🔹 Structure

Name Configuration

• Customize Name: allows overwriting the original name of the KPI with your own.

• 'Custom Name' Field: defines the alternative text (for example, “Description”).

• Hide Name: removes the KPI name from the display.

• Name Alignment:

  • Left / Center / Right.

• Customize Name Size:

  • Activate to scale the name manually.

  • Defined size (e.g.: 0.9).

🔹 Component Dimensions

• Width: proportional value to the horizontal size of the text container (e.g. 18).

• Height: proportional value to the visual height of the block (e.g. 11).

✅ Best Practices