Documentación ficheros de descripción de iconos del ui_plano (Raster, Icons)
Hay tres ficheros que definen los iconos del plano en una estación:- nombreestacion.Raster (FichPlanoEstacion) Define los contextos (pixmaps de fondo, textos asociados y manera de navegar de uno al siguiente)
- nombreestacion.icons (FichIconosEstacion) Define los iconos y su posición en cada uno de los contextos
- FichTextosnombreestacion (FichTextosEstacion) Define textos adicionales
NOTA: El ui_plano busca FichPlanoEstacion, FichIconosEstacion, FichTextosEstacion. Lo que se hace es hacer un enlace simbólico desde los FixhXXXEstacion a los Raster/Icons/Textos.
Además, hay un fichero común para todas las estaciones:
- SicoLibreria.icon Describe la relación entre los iconos y los estados y sus acciones. Se puede hacer un "override" de ellas en el .icons
.Raster
Define cada contexto ("plano"). Dos de los planos tienen nombres "hardcoded":
- "PLANO_COMPLETO": es el plano (contexto) por defecto
- "PLANO_ZONAL": normalmente se define como el último contexto del fichero. Se abre en el ui_plano desde menú Visualizar >> Plano zonal
Explicación del contenido:
NRO_CONTEXTOS 5Dice el número de contextos en el fichero
START_CONTEXTO PLANO General de Tetuan ... END_CONTEXTO
Define uno de los contextos. El texto a continuación de START_CONTEXTO es un comentario (en este caso: "PLANO General de Tetuan")
DEFAULT_CONTEXTO PLANO_COMPLETODefine el contexto inicial a visualizar
Dentro de un contexto están las siguientes claves:
| Clave | Descripción | Ejemplo |
| NOMBRE_CONTEXTO | Comentario o descripción del contexto | NOMBRE_CONTEXTO DETALLE_PCL |
| CLAVE_GEOGRAFICA | El nombre con el que se va a referenciar este contexto desde otros partes | NOMBRE_GEOGRAFICA DETALLE_PCL |
| IMAGEN_XPM | El pixmap a usar para el fondo en este contexto | IMAGEN_XPM PCLtetuan.xpm |
| ACCION_CONTEXTO | Qué sucede cuando se clica sobre una zona del plano en el que no hay ni icono ni "hot area" definida | ACCION_CONTEXTO CAMBIAR_CONTEXTO PLANO_COMPLETO |
| NRO_HOT_AREAS | Núemro de hot areas definidas a continuación | NRO_HOT_AREAS 8 |
| START_HOT_AREA ... END_HOT_AREA | Define una "hot area" (ver más abajo para detalles) | START_HOT_AREA NRO_VERTICES 2 VERTICE_HOT 504 199 VERTICE_HOT 567 249 RECTANGULO_HOT 504 199 567 249 ACCION_HOT_AREA WPRINTF Vestuario END_HOT_AREA |
| NRO_TEXTOS_ASOCIADOS | Indican el número de textos que se van a definir para este contexto | NRO_TEXTOS_ASOCIADOS 6 |
| TEXTO_ASOCIADO | Define un texto. Sintaxis TEXTO_ASOCIADO coordx_centro coordy_centro {H¦V} fuente texto a poner | TEXTO_ASOCIADO 256 311 H lucidasans-bold-14 CAE |
En el plano zonal pueden estar definidos los siguientes elementos adicionales:
| Clave | Descripción | Ejemplo |
| IMAGEN_PDF | (deprecado, ahora está en una BBDD, y solo se usa en tics/operador) Pdf a usar como imagen de fondo | IMAGEN_PDF Tetuan.pdf |
| VALOR_ZOOM | (deprecado, ahora está en una BBDD, y solo se usa en tics/operador) Zoom inicial para el PDF | VALOR_ZOOM 125 |
| VALOR_COORDENADAS | (deprecado, ahora está en una BBDD, y solo se usa en tics/operador) Coordenadas iniciales en el "panning" del PDF | VALOR_COORDENADAS 200 200 |
| VALOR_LINEAS_OP | (deprecado, ahora está en una BBDD, y solo se usa en tics/operador) Workaround para un problema de capas en los pdf | VALOR_LINEAS_OP -1 |
Dentro de las "hot area" pueden definirse los siguientes valores:
| Clave HOT AREA | Descripción | Ejemplo |
| NRO_VERTICES | Define el número de vértices que se van a listar (generalmente 2) | NRO_VERTICES 2 |
| VERTICE_HOT | Defne un vértice del polígono que rodea a la hot area | VERTICE_HOT 544 175 |
| RECTANGULO_HOT | Define un rectángulo que engloba todos los vértices del hot area | RECTANGULO_HOT 544 175 825 569 |
| ACCION_HOT_AREA | Define qué sucede cuando se pulsa sobre la hot area | ACCION_HOT_AREA NINGUNA |
Las acciones soportadas en los campos de ACCION_CONTEXTO/ACCION_HOT_AREA son las siguientes:
| WPRINTF | Imprime el texto que se indica en la barra de estado | ACCION_HOT_AREA WPRINTF Vestuario |
| CAMBIAR_CONTEXTO | Cambia al contexto cuya CLAVE_GEOGRAFICA coincide con el texto indicado | ACCION_CONTEXTO CAMBIAR_CONTEXTO PLANO_COMPLETO |
| NINGUNA | No hace nada | NINGUNA |
.icons
Define los iconos y su posición en cada uno de los contextos.
Explicación del contenido:
NRO_INSTANCIAS_ICONO 89Dice el número de iconos en el fichero
START_INSTANCIA_ICONO ... END_INSTANCIA_ICONO
Define uno de los iconos
Dentro de la definición de un icono están las siguientes claves:
| Clave | Descripción | Ejemplo |
| TIPO_ICONO | identificador del icono (el mismo que se haya usado en SicoLibreria.icon) | TIPO_ICONO CARTEL_TELEINDICADOR_DCHA |
| TEXTO_ICONO | El texto que aparece escrito en una esquina dentro del icono | TEXTO_ICONO PAV |
| NRO_POSICIONES | Número de posiciones del icono que se van a definir (cada posición tiene una máscara de claves funcionales y contextos/claves geográficas para los que aplica) | NRO_POSICIONES 2 |
| START_POSICION ... END_POSICION | Define una posición del icono (para una máscara de claves funcionales y contextos/claves geográficas en los que se aplica) | START_POSICION ... END_POSICION |
| NRO_TEXTOS_ASOCIADOS | Número de textos a dibujar (normalmente debajo del icono) | NRO_TEXTOS_ASOCIADOS 1 |
| TEXTO ASOCIADO | Define un texto asociado, igual que el de los RASTER | TEXTO_ASOCIADO 0 35 H - ALGODONALES |
| ANDEN_ASOCIADO | Datos adicionales usados por el plano | ANDEN_ASOCIADO CARTEL_PAV1 |
| CAMARA_ASOCIADA | Cámara asociada para cuando se pulsa con el modificador adecuado) | CAMARA_ASOCIADA Cam01 |
| MEGAFONIA_ASOCIADA | Megafonía asociada | MEGAFONIA_ASOCIADA nombreinstancia01 |
| ESTADO_FUNCIONAL_INICIAL | Pone un estado funcional al icono en el momento de arrancar el plano (especialmenmte útil para usar iconos para pintar botones sin driver asociado, como "liberar cámaras") | ESTADO_FUNCIONAL_INICIAL NADA_ACTIVADO |
| INDICE_COLOR_INICIAL | Pone un color al icono en el momento de arrancar el plano (especialmenmte útil para usar iconos para pintar botones sin driver asociado, como "liberar cámaras") | INDICE_COLOR_INICIAL COLOR_NORMAL |
| DESCRIPCION_INSTANCIA | Generalmente indica la situación de la instancia | DESCRIPCION_INSTANCIA Cuarto PCI Linea 1 |
| DRIVER | linea est vest nombreproc nombresubs nombreinst | DRIVER 01 03 10 MGF010310 SUBS_CTRL_MEGAFONIA MegafCEst |
Dentro de las posiciones se pueden definir las siguientes claves:
| Clave | Descripción | Ejemplo |
| CLAVE_FUNCIONAL | Lista de claves funciones para los que aplica. Puede ser * para todas, o una lista separada por comas. | CLAVE_FUNCIONAL PCL,SUBS_PUPITRE |
| CLAVE_GEOGRAFICA | Contexto en el que aplica | CLAVE_GEOGRAFICA PLANO_COMPLETO |
| CENTRO | Situar el centro del icono en la posición indicada del xpm | CENTRO 539 235 |
| RAYA | Pintar una línea desde el CENTRO a la posición indicada | RAYA 539 285 |
(A partir de aquí: TODO)
FichTextosEstacion
Este fichero suele usarse para poner textos que hay encima del bloque de iconos del vestíbulo o del PCL.
NRO_INSTANCIAS_TEXTO 2
START_INSTANCIA_TEXTO Texto del vestibulo 1
...
END_INSTANCIA_TEXTO
Dentro de una instancia texto:
NRO_POSICIONES
START_POSICION
...
END_POSICION
NRO_TEXTOS_ASOCIADOS
TEXTO_ASOCIADO
Dentro de una posición:
CLAVE_FUNCIONAL
CLAVE_GEOGRAFICA
CENTRO
SicoLibreria.icon
| NRO_TIPOS_ICONOS | Núemro de iconos en el fichero | NRO_TIPOS_ICONOS 76 |
| DEFAULT_COLOR_NORMAL | Definición del color | DEFAULT_COLOR_NORMAL #B6B6AA |
| DEFAULT_COLOR_SIN_COMUNICACION | Definición del color | DEFAULT_COLOR_SIN_COMUNICACION yellow |
| DEFAULT_COLOR_ALARMA_SUBSISTEMA | Definición del color | DEFAULT_COLOR_ALARMA_SUBSISTEMA blue |
| DEFAULT_COLOR_ALARMA_CONCENTRADOR | Definición del color | DEFAULT_COLOR_ALARMA_CONCENTRADOR cyan |
| DEFAULT_COLOR_FUERA_SERVICIO | Definición del color | DEFAULT_COLOR_FUERA_SERVICIO red |
| DEFAULT_COLOR_MANTENIMIENTO | Definición del color | DEFAULT_COLOR_MANTENIMIENTO green |
| DEFAULT_COLOR_DESCONOCIDO | Definición del color | DEFAULT_COLOR_DESCONOCIDO #FFC000 |
| DEFAULT_FONT_TEXTO | Definición de la fuente por defecto | DEFAULT_FONT_TEXTO lucidasans-bold-10 |
| DEFAULT_OFFSET_TEXTO | Definición del offset por defecto del texto de dentro del icono | DEFAULT_OFFSET_TEXTO +10 -10 |
| DEFAULT_ESTADO_FUNCIONAL | Definición del estado funcional por defecto | * |
| DEFAULT_ACCION | Definición de la acción por defecto | NINGUNA |
| START_DEFINICION_ICONO comentario/descripción ... END_DEFINICION_ICONO | Define uno de los tipo icono | START_DEFINICION_ICONO Tipo Icono PROGRAMADOR ... END_DEFINICION_ICONO |
Para una definición de icono:
TIPO_ICONO
OFFSET_TEXTO
NRO_IMAGENES
START_IMAGEN
...
END_IMAGEN
NRO_MASCARAS
START_MASCARA
...
END_MASCARA
NRO_COMPORTAMIENTOS
START_COMPORTAMIENTO
...
END_COMPORTAMIENTO
Para una imagen:
ESTADO_FUNCIONAL
FICH_ICONO
NOTA: Puede haber varias líneas de ESTADO_FUNCIONAL, simplemente van añadiendo a la lista de estados
Para una máscara (un emblema o tick o algo que se superpone al icono normal; suele ser un tick o un aspa para indicar si se tiene o no el mando, o si está arriba o está abajo):
CLAVE_MASCARA
ACCION_MASCARA
FICH_MASCARA
Para un comportamiento (es la acción del botón derecho)
ESTADO_FUNCIONAL
ACCION