Protocolos

⌘K
  1. Inicio
  2. Protocolos
  3. Script DTPM
  4. VARIABLES EXTENDIDAS
  5. Variables numéricas

Variables numéricas

Las variables numéricas (identificadas con el formato 61) son específicamente para mostrar valores matemáticos que cambian constantemente. Son perfectas para representar datos como el peso registrado en una báscula, la velocidad actual de un vehículo, la puntuación en un marcador deportivo o la lectura de un sensor industrial.

Tienen una capacidad máxima de 15 cifras en total y pueden llegar a mostrar hasta 10 posiciones decimales.

Configuración de la Variable Numérica

Para definir exactamente cómo queremos que se dibuje el número en pantalla, disponemos de una serie de parámetros de configuración. A excepción del tipo de variable (61), todos los demás parámetros son completamente opcionales. El orden en el que se envían dentro de la declaración de la variable debe ser el siguiente:

FUNCIÓN DESCRIPCIÓN TOKEN HEX
Tipo Numérico Define que la variable va a tratar con números. (Obligatorio) 61
Signo Positivo Fuerza a la pantalla a dibujar el símbolo ‘+’ delante de los números que sean positivos. (Opcional) 2B
Alineación Izquierda Alinea el número a la izquierda de la zona reservada. Si no se incluye este token, el número se alineará por defecto a la derecha. (Opcional) 2D
Rellenar con 0 Se rellenarán visualmente los espacios vacíos sobrantes en la variable con «0». (Opcional) 30
Longitud Mínima Dos cifras que reservan un espacio o «caja» de un tamaño fijo para la variable. Evita que el texto baile cuando el número cambia de tamaño. (Opcional) 3x 3x
Decimales Define la cantidad exacta de números decimales que se mostrarán tras la coma. (Opcional) 2E 3x
Umbrales Permite definir límites de valor para que la pantalla cambie automáticamente el color del número (Efecto semáforo) sin intervención externa. (Opcional)
Ver más información sobre Umbrales
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: Variable Numérica Básica

El siguiente ejemplo muestra la declaración más sencilla y común para una variable numérica. Vamos a crear la Variable ‘A’, le diremos que es de tipo numérico (61) y configuraremos únicamente el parámetro opcional de decimales (2E 32) para que siempre nos muestre 2 posiciones decimales. Al no especificar longitud ni alineación, la cifra se ajustará por defecto a la derecha de la ventana usando solo el espacio que estrictamente necesite.

Ejemplo de trama visual: Variable Básica con Decimales
T. VARIABLE 03 AC Token Variable
Inicia la declaración
ID VARIABLE 41 Identificador
Variable ‘A’ (ASCII 41)
TIPO 61 Numérica
Formato de la variable
DECIMALES 2E 32 ASCII ‘.’ y ‘2’
Muestra 2 decimales
CIERRE 1F Token Cierre
Finaliza la variable
Pasa el ratón sobre un bloque para ver su significado.

Ejemplo 2: Variable Numérica Completa (Todos los opcionales)

Este segundo ejemplo construye una variable altamente configurada (Variable ‘B’). En ella activamos todos los parámetros opcionales en cadena: obligamos a que se muestre el signo positivo (2B), forzamos la alineación del texto hacia la izquierda (2D), le pedimos que rellene los huecos vacíos con el número cero (30), le reservamos un bloque fijo de 10 caracteres de longitud en pantalla (31 30), fijamos la precisión en 3 decimales (2E 33) y finalmente, abrimos el bloque de umbrales lógicos (2A ...) antes de finalizar la declaración.

Ejemplo de trama visual: Variable Numérica Avanzada
T. VARIABLE 03 AC Token Variable
Inicia la declaración
ID VARIABLE 42 Identificador
Variable ‘B’ (ASCII 42)
TIPO 61 Numérica
Formato de la variable
SIGNO 2B ASCII ‘+’
Muestra signo positivo
RELLENO 30 ASCII ‘0’
Rellena vacíos con ceros
LONGITUD 31 30 10 Espacios
Reserva de tamaño
DECIMALES 2E 32 ASCII ‘.’ y ‘3’
Muestra 3 decimales
UMBRALES 2A Lógicas de Color
Abre bloque condicional.
CIERRE 1F Token Cierre
Finaliza la variable
Pasa el ratón sobre un bloque para ver su significado.