Librería de visualizaciones
Textos
📌 ¿Qué son?
La visualización tipo Textos en TOKII permite mostrar contenido literal (no numérico) de forma directa y sin codificación gráfica adicional. Es ideal para exponer mensajes de estado, nombres, descripciones, etiquetas operativas o cualquier valor alfanumérico relevante. Su propósito es informar de forma textual y contextualizada, sin interpretación gráfica, sobre el modelo 3D del gemelo digital.
Pueden ser textos cortos o descripciones más largas.
🔍 Se usa típicamente para mostrar:
• Estados del sistema (ej. "Activo", "Fuera de servicio")
• Indicadores cualitativos (ej. "Alerta", "Normal")
• Mensajes personalizados
• Información extraída de bases de datos o API

🎯 ¿Cuándo usarlas?
Mostrar texto literal directamente vinculado a un objeto o sección del gemelo.
Transmitir estados cualitativos (descripciones, condiciones, avisos).
Mostrar información contextual sin análisis.
📥 Formatos de Envío de Datos
▸ Desde dataset
Ejemplo de tabla:
La siguiente tabla presenta el formato de un dataset de ejemplo. El valor que se mostrará en el texto será el de la última fila.
id | fecha | texto_corto | texto_largo | otro_campo |
---|---|---|---|---|
1 | 01/01/2025 | lorem ipsum 1 | Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. | Lorem ipsum dolor sit amet 1 |
Se mostrará por defecto el último valor de la columna seleccionada.
En el formulario del KPI:
Value
: columna tipo String (ej.texto_corto
)Value Type
:String
▸ Desde MQTT
Texto simple:
Área de texto:
🖥️ Configuración visual del texto en la App 3D
Dentro de la App de TOKII, al seleccionar un KPI tipo Texto, se despliegan opciones para personalizar su apariencia. Estas opciones permiten adaptar la visualización del texto a nivel de forma, estilo y ubicación, garantizando una lectura clara y estética integrada en el modelo 3D.

🔹 Estructura
Configuración del Nombre
Personalizar Nombre: permite sobrescribir el nombre original del KPI con uno propio.
Campo 'Nombre Personalizado': define el texto alternativo (por ejemplo, “Descripción”).
Ocultar Nombre: elimina el nombre del KPI de la visualización.
Alineación del Nombre:
Izquierda / Centrado / Derecha.
Personalizar Tamaño del Nombre:
Activar para escalar el nombre manualmente.
Tamaño definido (por ejemplo:
0.9
).
🔹 Dimensiones del componente
Ancho: valor proporcional al tamaño horizontal del contenedor del texto (ej.
18
).Altura: valor proporcional a la altura visual del bloque (ej.
11
).
✅ Buenas Prácticas
Recomendación | Por qué es importante |
---|---|
Mantener textos breves y legibles | Favorece la lectura rápida en entornos 3D. |
Evitar saturación visual | Preserva la claridad visual y enfoque. |
Alineación coherente al contexto | Útil para textos junto a objetos o muros. |