Protocolos

⌘K
  1. Inicio
  2. Protocolos
  3. Script DTPM
  4. VARIABLES EXTENDIDAS
  5. Variables de porcentaje

Variables de porcentaje

Las variables de porcentaje (identificadas con el formato 65) son herramientas matemáticas automáticas integradas en la pantalla. Su función principal es recibir un valor dinámico, compararlo matemáticamente con un límite mínimo y un límite máximo que hayamos establecido, y mostrar en pantalla qué porcentaje representa ese valor dentro de dicho rango (del 0% al 100%). Además, el sistema se encarga de añadir el símbolo % automáticamente al final de la cifra.

Son muy útiles en situaciones donde el dato bruto no es tan intuitivo como un porcentaje. Por ejemplo:

  • Capacidad de un depósito: Si un depósito tiene su límite inferior en 150 litros (vacío) y superior en 500 litros (lleno), al recibir el valor 325 litros, la variable mostrará automáticamente «50%».
  • Baterías o rendimiento: Convertir un voltaje analógico o unas revoluciones por minuto (RPM) en una barra de porcentaje visual y fácil de entender por el usuario.

Configuración de la Variable de Porcentaje

Para definir los rangos de conversión y el formato del número resultante, disponemos de los siguientes parámetros:

FUNCIÓN DESCRIPCIÓN TOKEN HEX
Tipo Porcentaje Define que la variable calculará y mostrará un porcentaje. (Obligatorio) 65
Límite Sup. (Entero) Valor máximo sin decimales. Se debe cerrar con un punto (2E). 3x ... 2E
Decimales Lím. Sup. Cantidad de decimales que tiene el límite superior. 3x
Límite Inf. (Entero) Valor mínimo sin decimales. Se debe cerrar con un punto (2E). 3x ... 2E
Decimales Lím. Inf. Cantidad de decimales que tiene el límite inferior. 3x
Signo Positivo Hace visible el signo ‘+’ para valores positivos. (Opcional) 2B
Longitud Fija Obliga a la variable a mantener una longitud fija en pantalla. (Opcional) 2C
Decim. de Salida Número de decimales que tendrá el porcentaje resultante final. 3x
Umbrales Abre un bloque lógico de umbrales condicionales. (Opcional)
Ver más información sobre Umbrales
2A {...}

Ejemplo de uso

ℹ️ Nota Técnica
Este ejemplo de trama hexadecimal esta 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 el siguiente ejemplo 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.

En este ejemplo vamos a configurar la Variable ‘G’ (47) como una variable de Porcentaje (65). Le diremos que nuestro límite de trabajo máximo (el 100%) es el valor 155 (31 35 35 2E) con 2 decimales (32); y que nuestro límite mínimo (el 0%) es el valor 115 (31 31 35 2E) con 2 decimales (32). Además, vamos a indicarle opcionalmente que incluya el signo positivo (2B), y que el resultado final del porcentaje queremos que se muestre con 0 decimales de precisión (30). Finalmente, cerramos la declaración (1F).

Ejemplo de trama visual: Variable Porcentaje
T. VARIABLE 03 AC Token Variable
Inicia la declaración
ID VAR 47 Identificador
Variable ‘G’ (ASCII 47)
TIPO 65 Porcentaje
Formato de tipo porcentaje
LÍM. SUP 31 35 35 2E Límite superior
ASCII «155»
DEC. SUP 32 Decimales limite superior
ASCII «2»
LÍM. INF 31 31 35 2E Limite inferior
ASCII «115»
DEC. INF 32 Decimales limite inferior
ASCII «2»
SIGNO + 2B ASCII «+»
Forzar signo positivo
DEC. SALIDA 30 ASCII «0»
0 decimales en el % resultante
CIERRE 1F Token Cierre
Finaliza la variable
Pasa el ratón sobre un bloque para ver su significado.