Protocolos

⌘K
  1. Inicio
  2. Protocolos
  3. Script DTPM
  4. VARIABLES EXTENDIDAS
  5. Descripción

Descripción

Las variables extendidas son espacios de memoria reservados dentro de la pantalla que nos permiten actualizar información de forma dinámica. En lugar de tener que reescribir y enviar toda la trama gráfica de la ventana cada vez que cambia un dato (como un marcador deportivo, el peso de una báscula o el progreso de una máquina), simplemente dejamos «huecos» preparados (las variables) y luego enviamos únicamente el nuevo valor que debe ocupar ese hueco.

Para trabajar correctamente con las variables extendidas, es fundamental entender que se dividen en dos partes básicas que debemos diferenciar en nuestra trama:

  1. El Formato: Es la configuración inicial. Define cómo se va a mostrar la información (si es un simple número, un texto, o una barra de progreso gráfica) y cuánto espacio va a ocupar.
  2. El Valor: Es el dato real y dinámico que inyectamos dentro de ese formato para que se muestre en pantalla.

Para indicar a la pantalla que vamos a declarar una de estas variables, utilizamos un token maestro específico:

FUNCIÓN DESCRIPCIÓN TOKEN HEX
Token de Variable Indica el inicio de la declaración o llamada a una variable extendida dentro de la ventana. 03 AC

Formato

Inmediatamente después de colocar el token de variable (03 AC), debemos especificar qué formato o tipo de variable vamos a utilizar. Es importante destacar que toda declaración de variable debe finalizar siempre con el token de cierre 1F:

FORMATO DESCRIPCIÓN TOKEN
Numérica Diseñadas para representar valores numéricos que varían a lo largo del tiempo. Por ejemplo: marcadores deportivos, el peso registrado en una báscula, contadores de turnos o precios. 61
Alfanumérica Ideales para mostrar cadenas de texto y letras que se actualizan dinámicamente. Por ejemplo: nombres de jugadores, mensajes de alerta, destinos de autobuses o matrículas. 62
Estado Se emplea en situaciones lógicas donde únicamente existen dos condiciones posibles (por ejemplo: Libre/Ocupado, Encendido/Apagado, Play/Pause). El sistema traducirá este estado mostrando iconos o gráficos sencillos asociados. 63
Tipo Barra Representa de forma visual y gráfica la situación actual de una variable en relación a dos límites definidos (un mínimo y un máximo), simulando una barra de progreso o un nivel de carga. 64
Porcentaje Calcula y muestra el valor de la variable interpolado entre un límite inferior y uno superior predefinidos, añadiendo automáticamente el símbolo de porcentaje (%) al final de la cifra. 65

Ejemplo básico

A continuación, se muestra la estructura básica de una trama de variable, omitiendo la parte de definición de formato (que representaremos con ...) para entender su esqueleto principal:

Ejemplo de trama visual: Estructura básica de Variable
T. VARIABLE 03 AC Token Variable
Inicia la declaración
ID VARIABLE 41 Identificador
Variable ‘A’ (ASCII 41)
FORMATO 61 Configuración
Tipo (Ej. Numérica 61) y parámetros
CIERRE 1F Token Cierre
Finaliza la variable
Pasa el ratón sobre un bloque para ver su significado.