Protocolos

⌘K
  1. Inicio
  2. Protocolos
  3. Script DTPM
  4. VARIABLES EXTENDIDAS
  5. Variables tipo barra

Variables tipo barra

Las variables de tipo barra (identificadas con el formato 64) nos permiten representar gráficamente el valor de un dato numérico simulando una barra de progreso que se llena o se vacía.

Son ideales para proporcionar una referencia visual rápida sobre el estado de un proceso, por ejemplo: mostrar el nivel de llenado de un depósito (de 0 a 100%), la temperatura de un motor respecto a su límite de sobrecalentamiento, o el porcentaje de carga de una batería. La pantalla calculará automáticamente qué porción de la barra debe pintar basándose en un límite inferior y un límite superior que nosotros le definiremos.

Configuración de la Variable de Barra

Debido a que requiere trazar un gráfico, este tipo de variable es el que más parámetros de configuración necesita. El orden de los parámetros es estrictamente el siguiente:

FUNCIÓN DESCRIPCIÓN TOKEN HEX
Tipo Barra Define el formato visual de barra de progreso. (Obligatorio) 64
Límite Superior Valor máximo de la barra sin incluir los decimales. 3x ...
Decim. Lím. Superior Cantidad de decimales que tiene el límite superior. 3x
Límite Inferior Valor mínimo de la barra sin incluir los decimales. 3x ...
Decim. Lím. Inferior Cantidad de decimales que tiene el límite inferior. 3x
Orientación / Tamaño Para barra Vertical se usa 56. Para Horizontal, se indica el número de píxeles ocupados. 56 ó 3x ...
Alineación Izquierda Alineamiento a la izquierda (solo si es horizontal). (Opcional) 2D
Color del Borde Color del borde exterior de la barra. 3x
Color Interno / Umbrales Color de relleno interno, o llamada a los umbrales lógicos. 3x ó 2A ...

Ejemplos de uso

ℹ️ Nota Técnica
Estos ejemplos de trama hexadecimal estan trabajando sobre una pantalla de 16×96 píxeles. La implementación del script en una pantalla de diferentes proporciones requerirá reajustar los parametros de las ventanas. En los siguientes ejemplos solo se muestra la parte del texto, asumiendo que ya se definió la ventana con alto y ancho total y en modo de entrada inmediato.

Ejemplo 1: Barra Vertical (0 a 100)

En este primer caso, declaramos la Variable ‘E’ (45) como Barra (64). Establecemos un límite superior de 100 con 0 decimales (31 30 30 + 2E 30) y un límite inferior de 0 con 0 decimales (30 + 2E 30). La orientamos de forma Vertical (56), con el borde en el color 4 (34) y el relleno en el color 6 (36).

Ejemplo de trama visual: Texto + Barra Vertical de 0 a 100
TEXTO 44 45 50 4F 53 49 54 4F 20 Cadena ASCII
«DEPOSITO »
T. VARIABLE 03 AC Token Variable
Inicia la declaración
ID VAR 44 Identificador
Variable ‘D’ (ASCII 44)
TIPO 64 Barra
Formato visual de progreso
LÍM. SUP 31 30 30 ASCII «100»
Límite superior entero
DEC. SUP 2E 30 ASCII «.0»
Cero decimales
LÍM. INF 30 ASCII «0»
Límite inferior entero
DEC. INF 2E 30 ASCII «.0»
Cero decimales
ORIENT. 56 ASCII «V»
Barra Vertical
BORDE 34 Color Borde
Color externo (4)
RELLENO 36 Color Interno
Color de la barra (6)
CIERRE 1F Token Cierre
Finaliza la variable
Pasa el ratón sobre un bloque para ver su significado.

Ejemplo 2: Barra Horizontal Avanzada (115.00 a 155.00)

En este segundo caso declaramos la Variable ‘F’ (46) como Barra (64). Fijamos el límite superior en 155 con 2 decimales (31 35 35 + 2E 32) y el inferior en 115 con 2 decimales (31 31 35 + 2E 32). A diferencia del ejemplo anterior, indicamos que será una barra Horizontal reservándole una longitud de 096 píxeles (30 39 36). Finalmente le asignamos el color de borde 4 (34) y de relleno 6 (36).

Ejemplo de trama visual: Barra Horizontal Avanzada (96px)
T. VARIABLE 03 AC Token Variable
Inicia la declaración
ID VAR 44 Identificador
Variable ‘D’ (ASCII 44)
TIPO 64 Barra
Formato visual de progreso
LÍM. SUP 31 35 35 ASCII «155»
Límite superior entero
DEC. SUP 2E 32 ASCII «.2»
Dos decimales
LÍM. INF 31 31 35 ASCII «115»
Límite inferior entero
DEC. INF 2E 32 ASCII «.2»
Dos decimales
LONGITUD 30 39 36 ASCII «096»
Ocupa 96 píxeles (Horizontal)
ALIN. 2D Alineación izquierda
La barra empieza a llenarse desde la izquierda.
BORDE 34 Color Borde
Color externo (4)
RELLENO 36 Color Interno
Color de la barra (6)
CIERRE 1F Token Cierre
Finaliza la variable
Pasa el ratón sobre un bloque para ver su significado.