Librería de visualizaciones

Table of Content

Table of Content

Table of Content

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.