# Valor

> El visor en vivo con formato: un punto escrito con unidad, decimales, un ancho de campo declarado y bandas de significado opcionales.

**Valor** es el visor básico: escribe un punto del espacio de direcciones vivo dentro de su
celda, con el formato que usted declare. La lectura toma la celda entera; un rótulo para ella es
una [Etiqueta](component-label) que usted coloca al lado, o el título de esquina propio del
componente, de la sección Apariencia compartida. Es un componente de *Visualización*; uno nuevo
ocupa 4 × 2 celdas.

Un Valor nunca muestra un número viejo. Un punto que no logra leer dibuja el guion de hueco
(`—`) en la tinta secundaria discreta, y el componente lleva la marca compartida de mala lectura
que se describe en la [página de componentes](components#addresses-and-live-readings). Un punto
que contesta con buena calidad pero que ahora mismo no contiene ningún valor (un banco de pruebas
entre corridas, un contador fuera de ciclo) dibuja ese mismo guion *sin* la marca: ese silencio
es normal, no una falla.

## Datos {#data}

| Campo | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Dirección | La dirección de Logic con raíz del punto que se muestra. La lista sugiere puntos vivos de todas las categorías de valor: un visor le da formato a lo que contenga el punto, sea un número, un texto, una bandera o un instante. | Texto libre; sugerencias de la lista viva de puntos | vacía |

Bajo el campo, el editor muestra qué lee ahora mismo el punto elegido, así que el vínculo se
confirma solo antes de que el sinóptico llegue a correr.

## Formato {#format}

| Campo | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Unidad | Sufijo de unidad escrito junto al valor, en un tamaño menor y en la tinta secundaria. Es parte del ancho de campo reservado, así que nunca se cae de la línea. Se esconde mientras el punto no está leyendo. | Texto libre | vacía |
| Decimales | Decimales fijos para las lecturas numéricas. En blanco sigue la preferencia decimal de la estación (véase la [página Ajustes](settings-localization)), y un punto cuyo tipo es un número entero se escribe entonces sin fracción. Lo que se ingresa fuera de la banda se toma en el extremo más cercano, y el panel lo dice. Los formatos de reloj y de palabras no escriben fracción, así que ahí el conteo no se lee. | De 0 a 15, o en blanco | en blanco (preferencia de la estación) |
| Dígitos / Caracteres | Cuánto sostiene el campo: la declaración que hay detrás del contrato de presentación del valor. Como **Dígitos** (formatos numéricos): las posiciones antes del separador decimal; una lectura que necesita más se *marca*, nunca se escribe corta. Como **Caracteres** (el formato Texto): cuántos caracteres sostiene la línea; una lectura más larga se escribe corta con puntos suspensivos. El campo lleva el nombre de la medida que declare el formato elegido. | Dígitos: de 1 a 20 · Caracteres: de 1 a 40, o en blanco | 5 dígitos · 12 caracteres |
| Tamaño de letra | Si la celda decide el tamaño de letra o si usted lo indica. | `Tan grande como permita la celda` · `Un tamaño que yo indico` | `Tan grande como permita la celda` |
| Puntos | El tamaño de letra indicado. Sale solo en el modo indicado. Un tamaño indicado es literal: se dibuja a ese tamaño en cualquier celda y nunca se reduce para que quepa la lectura; lo que ya no cabe se marca, no se encoge. | De 9 a 144 puntos | 12 |
| Se lee como | Cómo se escribe la lectura. | `Número` · `Porcentaje` · `Duración` · `Texto` | `Número` |
| El valor cuenta | Qué significa una unidad del valor mientras **Se lee como** es `Duración`. El tiempo transcurrido llega como un número pelón, y ese mismo número es milisegundos en un punto y minutos en otro, así que el componente indica cuál. Sale solo en el formato de duración. | `Segundos` · `Milisegundos` · `Minutos` | `Segundos` |

### Los cuatro formatos {#the-four-formats}

- **Número** escribe el número de ingeniería con la preferencia decimal de la estación, o con
  los **Decimales** explícitos. Un número entero sin decimales declarados se escribe sin
  fracción, con todas las cifras que trae, por grande que sea.
- **Porcentaje** escribe ese mismo número seguido de `%`. El valor *no* se reescala: el punto ya
  es un porcentaje; la matemática de la cadena de conversión se queda en las etapas de conversión
  de Connector.
- **Duración** escribe un reloj: `hh:mm:ss`, o `d.hh:mm:ss` a partir de un día. Un conteo
  negativo conserva su signo. Es ese mismo reloj que usan las ocurrencias de una corrida, las
  filas de Históricos y el reporte en PDF.
- **Texto** escribe las palabras con las que contesta el punto (una orden, un lote, el nombre de
  un perfil) exactamente como llegan. Elegirlo es además la declaración de que el ancho del campo
  cuenta **caracteres** en lugar de dígitos, lo que cambia el nombre del campo de ancho, su valor
  predeterminado y su conducta (puntos suspensivos en lugar de la marca de rebase).

Número, Porcentaje y Duración dicen cómo se escribe un *número*, y es el tipo del punto el que
decide si la lectura lo es, igual que en todo el resto de la estación. Una lectura que no es un
número en absoluto (una bandera, un texto, un instante) igual contestó, así que se escribe tal
como es en lugar de dejarse en hueco, sea cual sea el elegido de los tres: una bandera sale como
`true` o `false`, nunca como una cifra con decimales, un porcentaje o un reloj. `NaN` también es
una lectura: se escribe con esa palabra, junto a su unidad, y nunca con el guion de hueco.

## Cómo se dibuja la lectura {#how-the-reading-is-drawn}

El tamaño de letra nunca sigue al valor. En el modo automático la celda decide el tamaño, acotada
por el ancho que reserva la declaración (dígitos + separador + decimales + unidad, o los
caracteres declarados); en el modo indicado el tamaño es exactamente los puntos que usted
escribió. Dos celdas del mismo tamaño con esas mismas declaraciones siempre salen del mismo
tamaño, y un valor que brinca entre cuatro y seis caracteres nunca mueve la letra.

Qué pasa cuando el contenido rebasa su declaración:

| Situación | Qué muestra la celda |
|---|---|
| Un número necesita más dígitos de los declarados | La marca de rebase `####`, con la lectura completa (unidad incluida) en la información emergente. La marca significa exactamente una cosa: este campo no puede sostener este número. |
| Un tamaño indicado necesita más ancho del que tiene la celda | Esa misma marca `####`: un tamaño literal nunca se encoge. Bajo un tamaño indicado, la información emergente siempre lleva la lectura completa. |
| Una lectura de Texto es más larga que los caracteres declarados | Cortada con puntos suspensivos, con el texto completo en la información emergente. Las palabras nunca llevan la marca del número. |
| Una lectura en palabras es más larga que el campo mientras el Valor se lee como Número, Porcentaje o Duración | Cortada con puntos suspensivos, con la lectura completa (unidad incluida) en la información emergente. Las palabras nunca llevan la marca del número, ni siquiera cuando son puras cifras. |
| El punto no está leyendo | El guion de hueco `—`. La ausencia de una lectura y la ausencia de lugar nunca se prestan la marca una a la otra. |

Los números descansan a la derecha de su campo en cifras tabulares, para que una columna de
componentes Valor se alinee consigo misma y el separador conserve su lugar conforme crece la
parte entera.

## Escala {#scale}

La declaración opcional de bandas que comparten las clases de lectura: cada banda cubre el rango
del valor hasta su límite, empezando donde terminó la banda que está encima de ella en la lista,
y una lectura que rebasa el último límite no pertenece a ninguna banda. Las bandas *tiñen* el
número con los tonos de significado propios de la interfaz; una lectura que ninguna banda reclama
conserva la tinta corriente.

| Campo | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Hasta | Dónde termina la banda (inclusive), en la unidad de ingeniería del punto. Una banda nueva empieza con el campo vacío, y un límite vacío no es cero: la banda no reclama nada y no tiñe nada hasta que se escribe un límite. | Cualquier número | vacío |
| Significado | Qué significa una lectura dentro de la banda. El tono nombra el significado; el tema en marcha decide la pintura. | `Neutro` · `Información` · `Correcto` · `Precaución` · `Crítico` | `Neutro` |
| Nombra este estado | Redacción opcional para la banda ("Calentamiento", "Sobrepresión"). Redactar cualquier banda agrega bajo el número una línea de estado que escribe la palabra de la banda actual, en el tono de la banda. | Texto libre | vacía |

La línea de estado existe solo mientras haya al menos una banda redactada. Conserva su altura
mientras no hay nada nombrado, para que el número de arriba nunca se redimensione cuando una
lectura cruza un límite, y se corta con puntos suspensivos, con la palabra completa en su
información emergente. Las flechas de subir y bajar intercambian el significado y la redacción de
una banda con los de su vecina, y dejan en su lugar los límites escritos.

Valor es un componente de visualización: no manda nada, así que nunca lleva la marca de candado.
Las secciones compartidas Apariencia, Identificación, Posición y capa y Acciones se describen en la
[página de componentes](components#the-shared-property-sections).