Los objetos <image> permiten mostrar una imagen en los lugares deseados.
¶ Atributos
Este objeto puede tener varios atributos.
¶ name
- Obligatorio: sí
El atributo «name» permite indicar sobre qué elemento visual debe actuar el contenido. Puede tener uno o varios de estos valores al mismo tiempo.
Lista de valores utilizables en la lista de sistemas (<view name="system">):
logo: la imagen del logotipo del sistema.
Lista de valores utilizables en la lista de juegos (<view name="detailed">):
console: imagen que muestra la consola del sistema.logo: imagen del logotipo del sistema.md_folder_image_0: en una carpeta, primera miniatura.md_folder_image_1: en una carpeta, segunda miniatura.md_folder_image_2: en una carpeta, tercera miniatura.md_folder_image_3: en una carpeta, cuarta miniatura.md_folder_image_4: en una carpeta, quinta miniatura.md_folder_image_5: en una carpeta, sexta miniatura.md_folder_image_6: en una carpeta, séptima miniatura.md_folder_image_7: en una carpeta, octava miniatura.md_folder_image_8: en una carpeta, novena miniatura.md_image: ubicación de la imagen en miniatura del scrap.md_region1: primera región del juego seleccionado.md_region2: segunda región del juego seleccionado.md_region3: tercera región del juego seleccionado.md_region4: cuarta región del juego seleccionado.
Lista de valores que se pueden utilizar en los clips de juegos (<view name="gameclip">):
favoriteIcon: icono favorito.logo: imagen del logotipo del sistema.md_image: ubicación de la imagen en miniatura del scrap.md_thumbnail: miniatura del scrap.recalboxLogo: logotipo de Recalbox.
<image name="logo">
...
</image>
¶ extra
Puede crear su propio valor para el atributo «name» fuera de la lista anterior, pero deberá añadir el atributo «extra=«true»» para que se tenga en cuenta.
<image name="background" extra="true">
...
</image>
¶ region
Esta propiedad está obsoleta y se eliminará en una versión futura.
Si especificas una imagen para usar en una región específica, puedes utilizar el atributo region.
<image name="logo" region="us">
...
</image>
¶ Propiedades
El objeto <image> puede contener varias propiedades.
¶ <pos>
La propiedad <pos> permite indicar la posición del objeto padre. La posición que se debe indicar corresponde al punto más alto a la izquierda del objeto. Contiene dos valores. El primer valor corresponde a la posición desde la izquierda y el segundo valor a la posición desde la parte superior.
Los valores son porcentajes comprendidos entre 0 (0 %) y 1 (100 %).
<pos>0.33 0.25</pos>
En el ejemplo anterior, se puede ver que la posición indica que el objeto principal debe colocarse al 33 % de la izquierda y al 25 % de la parte superior.
¶ <size>
La propiedad <size> permite definir el tamaño del elemento que contiene el objeto padre.
<size>1 1</size>
¶ <maxSize>
Esta propiedad está obsoleta y se mantiene por motivos de compatibilidad con temas existentes. Se eliminará en una futura versión de Recalbox.
La propiedad <maxSize> permite evitar que el elemento del objeto padre sea demasiado grande en un eje. Por defecto, la imagen se redimensionará lo máximo posible para que se adapte a este tamaño y conserve su relación altura/anchura.
Los valores son porcentajes comprendidos entre 0 (0 %) y 1 (100 %).
<maxSize>0.35 0.1</maxSize>
¶ <keepratio> 
La propiedad <keepratio> permite conservar la proporción del elemento principal. Se utiliza con <size>.
<keepratio>true</keepratio>
¶ <origin>
La propiedad <origin> permite definir un nuevo punto de origen para todos los tamaños del objeto principal.
Los valores son porcentajes comprendidos entre 0 (0 %) y 1 (100 %).
<origin>0.5 0.5</origin>
¶ <rotation>
La propiedad <rotation> permite especificar un ángulo de rotación del objeto principal. Los valores positivos provocarán una rotación en sentido horario y los valores negativos provocarán una rotación en sentido antihorario.
<rotation>90</rotation>
¶ <rotationOrigin>
La propiedad <rotation> permite especificar un ángulo de rotación del objeto principal. Los valores positivos provocarán una rotación en sentido horario y los valores negativos provocarán una rotación en sentido antihorario.
<rotationOrigin>0.5 0.5</rotationOrigin>
¶ <path>
La propiedad <path> permite cargar un archivo de texto en lugar de introducir el texto manualmente.
<path>./chemin/vers/fichier/texte.txt</path>
¶ <tile>
La propiedad <tile> permite definir si la imagen se muestra como un mosaico en lugar de estirarse para adaptarse al tamaño del objeto. Esto resulta útil para los fondos.
<tile>false</tile>
¶ <color>
La propiedad <color> permite indicar el color del texto del objeto padre. Los colores pueden estar en formato RRVVBB o RRVVBBAA (AA para la transparencia, 00 = transparente y ff = opaco).
<color>666666</color>
¶ <colorTop>
La propiedad <colorTop> permite indicar el color de la parte superior del objeto principal. Los colores pueden estar en formato RRVVBB o RRVVBBAA (AA para la transparencia, 00 = transparente y ff = opaco).
<colorTop>666666</colorTop>
¶ <colorBottom>
La propiedad <colorBottom> permite indicar el color de la parte inferior del objeto principal. Los colores pueden estar en formato RRVVBB o RRVVBBAA (AA para la transparencia, 00 = transparente y ff = opaco).
<colorBottom>666666</colorBottom>
¶ <colorLeft>
La propiedad <colorLeft> permite indicar el color izquierdo del objeto padre. Los colores pueden estar en formato RRVVBB o RRVVBBAA (AA para la transparencia, 00 = transparente y ff = opaco).
<colorLeft>666666</colorLeft>
¶ <colorRight>
La propiedad <colorRight> permite indicar el color derecho del objeto padre. Los colores pueden estar en formato RRVVBB o RRVVBBAA (AA para la transparencia, 00 = transparente y ff = opaco).
<colorRight>666666</colorRight>
¶ <colorTopLeft>
La propiedad <colorTopLeft> permite indicar el color en la parte superior izquierda del objeto principal. Los colores pueden estar en formato RRVVBB o RRVVBBAA (AA para la transparencia, 00 = transparente y ff = opaco).
<colorTopLeft>666666</colorTopLeft>
¶ <colorTopRight>
La propiedad <colorTopRight> permite indicar el color en la parte superior derecha del objeto principal. Los colores pueden estar en formato RRVVBB o RRVVBBAA (AA para la transparencia, 00 = transparente y ff = opaco).
<colorTopRight>666666</colorTopRight>
¶ <colorBottomLeft>
La propiedad <colorBottomLeft> permite indicar el color en la parte inferior izquierda del objeto principal. Los colores pueden estar en formato RRVVBB o RRVVBBAA (AA para la transparencia, 00 = transparente y ff = opaco).
<colorBottomLeft>666666</colorBottomLeft>
¶ <colorBottomRight>
La propiedad <colorBottomRight> permite indicar el color en la parte inferior derecha del objeto principal. Los colores pueden estar en formato RRVVBB o RRVVBBAA (AA para la transparencia, 00 = transparente y ff = opaco).
<colorBottomRight>666666</colorBottomRight>
¶ <zIndex>
La propiedad <zIndex> permite ordenar los elementos por profundidad/capa. Cuanto mayor sea su valor, más en primer plano estará. Puede ser negativo.
<zIndex>10</zIndex>
¶ <disabled>
La propiedad <disabled> permite desactivar el objeto padre.
<disabled>true</disabled>
¶ <reflection>
La propiedad <reflection> permite crear efectos de reflejos debajo del objeto principal.
El primer valor corresponde a la parte superior del reflejo, el segundo valor corresponde a la parte inferior del reflejo.
Los valores pueden ir de 0,0 (transparente) a 1,0 (opaco).
<reflection>0.5 0.5</reflection>