# Indicador analógico

> Referencia del componente de panel de control Indicador analógico radial, la geometría de su carátula, sus conjuntos, su indicación, sus bandas de escala y todas sus propiedades del editor.

El **Indicador analógico** dibuja un punto numérico sobre una carátula radial. Todo en él es una
declaración de lo que la carátula *es*: su barrido, qué apunta a la lectura, qué partes de la
escala se dibujan, qué dice la lectura y con qué está pintada. Cuando el punto no tiene lectura
(mala calidad, una dirección sin resolver), la aguja, el relleno y el valor desaparecen juntos y
la carátula muestra la marca de hueco (`—`) en lugar de un número; la pista con bandas se queda,
porque las bandas son una declaración y no una medición. `NaN` es una lectura, no un hueco: la
carátula escribe esa palabra junto a su unidad y no apunta a nada, porque `NaN` no tiene lugar en
la escala.

## Contenido y datos {#content-and-data}

| Propiedad | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Etiqueta | Rótulo opcional escrito bajo la lectura. | texto | vacío |
| Dirección | La dirección de Logic con raíz del punto numérico que se muestra. El campo sugiere desde la lista viva de puntos, filtrada a puntos numéricos, y muestra la lectura actual del punto en cuanto se nombra. | dirección | vacía |

## Formato {#format}

| Propiedad | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Mín | Dónde empieza la escala, en la unidad de ingeniería del punto. | número | 0 |
| Máx | Dónde termina la escala. | número | 100 |
| Unidad | Sufijo de unidad opcional escrito junto al valor. | texto | vacía |
| Decimales | Decimales fijos para el visor. En blanco, un punto cuyo tipo es un número entero se escribe sin fracción, y cualquier otro número con los decimales de la estación. Los decimales de la lectura son también lo más que lleva un número alrededor del arco: los que se escriben aquí o, con el campo en blanco, los del propio punto (ninguno en un número entero, los de la estación en cualquier otro, y los de la estación hasta que el punto contesta por primera vez). Cada número del arco lleva solo los decimales que necesita, así que una carátula de divisiones enteras lee 30 y 60, no 30.0 y 60.0. | De 0 a 15 | en blanco usa la preferencia de la estación |
| Dígitos | Cuántas posiciones reserva la lectura central antes del separador decimal. Decide además cuándo un valor se marca como demasiado ancho para su campo (`####`, con la lectura completa en la información emergente). Un punto que contesta con palabras (una orden, un lote, una bandera) nunca lleva esa marca: lo que el centro de la carátula no puede sostener termina en puntos suspensivos (…), con la lectura completa en la información emergente. | De 1 a 20 | en blanco lo deriva del mayor entre Mín y Máx |
| Tamaño de letra | Si la celda decide el tamaño de letra o si el operador lo indica. Un tamaño indicado es literal: se dibuja a ese tamaño en cualquier celda y nunca se reduce para que quepa. Si decide la celda, la lectura se escribe tan grande como lo permite el espacio entre el arco y sus números, y nunca por debajo de 11 píxeles. Donde la lectura es más ancha que el espacio que le deja la carátula, al tamaño indicado o, si decide la celda, incluso a 11 píxeles, la carátula escribe `####` en lugar del número, con la lectura completa en la información emergente. Una lectura en palabras nunca lleva esa marca y conserva sus puntos suspensivos. | Tan grande como permita la celda · Un tamaño que yo indico | Tan grande como permita la celda |
| Puntos | El tamaño indicado. Sale solo en el modo indicado. | De 9 a 144 | 12 |
| Se lee como | Cómo se escribe la lectura. | Número · Porcentaje · Duración | Número |
| El valor cuenta | Qué significa una unidad del valor mientras el formato es una duración. | Segundos · Milisegundos · Minutos | Segundos |
| Escribir la lectura | Si la lectura se escribe dentro de la carátula. | encendido / apagado | encendido |
| Escribir la etiqueta | Si la etiqueta va montada bajo la lectura. | encendido / apagado | encendido |

## Carátula {#dial}

Los ángulos corren en sentido contrario a las manecillas desde las tres en punto, así que de
225° a −45° pone la mitad de la escala arriba. Un **conjunto** es un atajo, no una identidad:
aplicar uno escribe los campos de geometría y de indicación de abajo y después se olvida, así que
cada campo se queda editable uno por uno después. Lo que un conjunto no dice nada (la dirección,
los extremos de la escala, el formato, las bandas, la referencia, el acento, si se escriben la
lectura y la etiqueta) sobrevive sin tocarse.

| Conjunto | Qué escribe |
|---|---|
| Carátula | Inicio 225°, fin −45°, sentido de las manecillas, 10 divisiones, aguja como puntero, relleno de progreso, marcas y números de escala encendidos. La forma con la que nace un indicador, y el camino de regreso desde los otros dos. |
| Semicírculo | Inicio 180°, fin 0°, sentido de las manecillas, 5 divisiones (la mitad del arco lleva la mitad del lugar para números), aguja, relleno, marcas y números encendidos. |
| Anillo | Inicio 90°, fin −270° (una vuelta completa), sentido de las manecillas, sin puntero, relleno de progreso encendido, marcas y números apagados: el arco mismo es la indicación. |

| Propiedad | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Inicio | Dónde empieza el barrido, en grados en sentido contrario a las manecillas desde las tres en punto. | De −360 a 360 | 225 |
| Fin | Dónde termina el barrido. Puede ser negativo y puede pasarse una vuelta completa desde el inicio. | De −360 a 360 | −45 |
| Divisiones | En cuántas divisiones se corta la escala y, por lo tanto, cuántas marcas lleva el arco; una carátula chica puede numerar menos de ellas (vea Numerar las divisiones). | De 1 a 50 | 10 |
| El valor crece en sentido horario | En qué extremo del arco se sienta el mínimo: en el ángulo de inicio con el valor creciendo con las manecillas (la dirección en la que se lee normalmente una carátula), o ese mismo arco recorrido al revés. | encendido / apagado | encendido |
| Dibujar las marcas de división | Si las marcas se dibujan sobre el arco. | encendido / apagado | encendido |
| Numerar las divisiones | Si las divisiones se numeran alrededor del arco. Los números se escriben con el separador decimal de la estación y su marca de agrupamiento, cada uno solo con los decimales que necesita, hasta los de la lectura: una carátula de divisiones enteras lee 30 y 60 sean cuales sean los decimales que escribe la lectura, y una división que esos decimales no sostienen se redondea a ellos, así que un conteo de 0 a 100 en tres divisiones se numera 0, 33, 67 y 100. La unidad, el signo de porcentaje y el reloj son de la lectura del centro, nunca del arco. Donde la carátula es demasiado chica para escribir cada número separado del siguiente, numera menos divisiones con un paso parejo (por ejemplo, una de cada dos o una de cada cinco de diez), siempre con los dos extremos de la escala entre ellas, y ninguna donde ni siquiera caben los dos extremos. En una carátula que cierra una vuelta completa, el final de la escala cae donde está su inicio y solo se numera el inicio. | encendido / apagado | encendido |

Un ángulo escrito fuera de su banda se toma en el extremo más cercano y el panel lo dice; un
texto que no es un número deja el ángulo en vigor.

## Indicación {#indication}

Qué apunta al valor, y con qué está pintada esa indicación. El acento es identidad, no
significado: las bandas de abajo dicen qué significa una lectura y se quedan con la última
palabra sobre el color de la lectura.

| Propiedad | Qué hace | Valores | Predeterminado |
|---|---|---|---|
| Puntero | Qué apunta a la lectura sobre el arco. El valor, su calidad y la banda en la que cae son los mismos se dibuje lo que se dibuje. | Aguja · Marca sobre el arco · Sin puntero | Aguja |
| Rellenar el arco hasta la lectura | Si el arco se rellena desde el inicio de la escala hasta la lectura. | encendido / apagado | encendido |
| Acento | De dónde viene el color de la indicación. | La tinta de siempre · Un color · Un punto de color | La tinta de siempre |
| Claro / Oscuro | El acento como un par de tema claro y tema oscuro, los dos indicados porque el tema en marcha decide cuál mitad está en pantalla. Sale solo mientras el acento es un color. | `#RRGGBB` cada uno | `#5470C6` los dos |
| Punto de color | La dirección de Logic con raíz de un punto de Color al que sigue el acento. Sale solo mientras el acento es un punto de color. | dirección | vacía |

## Escala {#scale}

La sección **Escala** compartida declara los tramos de la escala y qué significa cada uno, y la
referencia que marca la carátula.

- Cada **banda** cubre todo hasta su límite, desde donde terminó la banda que está encima de
  ella en la lista, así que el límite es además el lugar de la banda; una lectura que rebasa el
  último límite no pertenece a ninguna banda y toma la tinta corriente. El tono (Neutro,
  Información, Correcto, Precaución, Crítico) es el vocabulario propio de la interfaz, y el tema
  decide la pintura. Redactar una banda nombra el estado, y el indicador puede mostrar esa
  palabra junto a su lectura.
- La **referencia** marca una consigna o un nominal sobre la escala: nada, un valor fijo, o un
  punto que se mueve con la receta. Se dibuja solo mientras la escala llega hasta ella.