Edit Documentación ficheros de descripción de iconos del ui

Title:

Last edited: 11:46:41 am on 28 November 2017 by n003-000-000-000.static.ge.com

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 >&gt; Plano zonal

Explicación del contenido:

= NRO_CONTEXTOS 5
Dice el número de contextos en el fichero

<code>START_CONTEXTO PLANO General de Tetuan
...
END_CONTEXTO</code>
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_COMPLETO
Define 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 &nbsp;&nbsp;&nbsp;NRO_VERTICES 2 &nbsp;&nbsp;&nbsp;VERTICE_HOT 504 199 &nbsp;&nbsp;&nbsp;VERTICE_HOT 567 249 &nbsp;&nbsp;&nbsp;RECTANGULO_HOT 504 199 567 249 &nbsp;&nbsp;&nbsp;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&brvbar;V} fuente texto a poner|TEXTO_ASOCIADO 256 311 H lucidasans-bold-14 CAE|

Define los iconos y su posición en cada uno de los contextos.

Explicación del contenido:

= NRO_INSTANCIAS_ICONO 89
Dice el número de iconos en el fichero

<code>START_INSTANCIA_ICONO
...
END_INSTANCIA_ICONO</code>
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|

_
!!! (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

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

- lock this page
- enter new password
- reenter same password

Send e-mail alerts to these addresses upon next save: