`helpsystem` — la barra de ayuda

Los 32 iconos de botones, uno a uno.

La barra de abajo de la pantalla que recuerda para qué sirven los botones. 38 propiedades: seis de formato, y 32 iconos.

Recalbox decide por sí mismo lo que anuncia la barra, pantalla a pantalla, y traduce cada etiqueta. Tu tema solo fija la forma: la colocación, la fuente, los colores, y la imagen de cada pictograma.

<helpsystem name="help">
  <pos>0.02 0.955</pos>
  <fontPath>${root}/data/fonts/Exo2.otf</fontPath>
  <fontSize>0.025</fontSize>
  <textColor>C6CBD8</textColor>
  <iconColor>FFFFFF</iconColor>
  <iconA>${root}/data/arts/boutons/a.svg</iconA>
  <iconB>${root}/data/arts/boutons/b.svg</iconB>
</helpsystem>

El formato

Propiedad	Función
`pos` `size`	colocación
`textColor`	el color de las etiquetas
`iconColor`	el tinte de los iconos — proporciónalos en blanco
`fontPath` `fontSize`	la fuente

Los 32 iconos

Reemplazar un icono es opcional: Recalbox proporciona los suyos. Solo redefines los que quieres.

Direcciones — iconUpDown, iconLeftRight, iconUpDownLeftRight

Botones — iconA, iconB, iconX, iconY

Gatillos — iconL, iconR, iconL2, iconR2, iconL3, iconR3, iconLR, iconL2R2, iconL3R3

Sistema — iconStart, iconSelect, iconHotkey

Combinaciones hotkey — iconHkA, iconHkB, iconHkX, iconHkY, iconHkL, iconHkR, iconHkLeftRight

Joysticks — iconJ1UpDown, iconJ1LeftRight, iconJ1UpDownLeftRight, iconJ2UpDown, iconJ2LeftRight, iconJ2UpDownLeftRight

Una combinación son dos pictogramas

Cuando la ayuda trata de una combinación, Recalbox dibuja iconHotkey, luego la tecla.

[HK] [A]  Lanzar el juego

iconHkA es por tanto la imagen del botón A usado en combinación — no un dibujo de « HK + A ». Pon ahí un botón normal: el atajo ya está delante.

iconHotkey cuenta doble: aparece delante de cada combinación de la barra. Es el icono que pulir primero si tu tema muestra alguna.

El nombre es impuesto: `help`

Recalbox busca el componente llamado help, y solo ese. <helpsystem name="barre"> existirá en tu archivo sin dirigir nunca nada.

La barra se configura vista a vista

Recalbox relee el <helpsystem> de la vista en cada cambio de pantalla, y vuelve a partir de sus propios iconos. Lo que una vista no declara vuelve por tanto al valor por defecto de Recalbox — nunca a lo que otra vista había configurado.

Dos maneras de hacerlo:

el mismo juego de iconos en todas partes — declarar la barra en una vista que lo cubra todo: <view name="system, detailed, menu">;
una barra distinta por pantalla — un <helpsystem> en cada vista, con sus propias imágenes.

Proporciona iconos blancos y usa iconColor: un solo juego de archivos basta entonces para todas las variantes de color de tu tema.

Ofrecer varios juegos de iconos

Es lo que hacen los grandes temas: un juego SNES, un juego Xbox, un juego PlayStation… y el usuario elige en Menú → Interfaz → Tema.

Cada juego es un archivo que solo contiene el <helpsystem> y sus imágenes:

<!-- ./options/icones-snes.xml -->
<theme>
  <view name="system, detailed, menu">
    <helpsystem name="help">
      <iconA>${root}/data/icones/snes/a.svg</iconA>
      <iconB>${root}/data/icones/snes/b.svg</iconB>
    </helpsystem>
  </view>
</theme>

Y se ofrecen así, sin declarar nada más:

<include subset="iconset" name="1 - SNES">${root}/options/icones-snes.xml</include>
<include subset="iconset" name="2 - Xbox">${root}/options/icones-xbox.xml</include>

iconset es un nombre reservado: Recalbox muestra « SELECT THEME'S ICONSET », traducido al idioma de la máquina. No hace falta ninguna etiqueta <subset> para nombrarlo.

helpsystem — la barra de ayuda