roImagePlayer

Este objeto muestra imágenes de mapa de bits estáticas en la pantalla de video. La forma más sencilla de usar roImagePlayer es realizar llamadas a DisplayFile() con el nombre de archivo como un String. Alternativamente, puede usar PreloadFile() junto con DisplayPreload() para tener más control. Para obtener una estética más agradable al generar un reproductor de imágenes, use el objeto roImageWidget . El equivalente en JavaScript es la etiqueta <img> en HTML.

Creación de objetos: El reproductor de imágenes se muestra creando primero instancias de roRectangle y roImagePlayer y luego llamando a SetRectangle() usando la instancia de roRectangle como argumento.

Muestra la imagen con el nombre de archivo especificado. La cadena image_filename debe apuntar a un archivo .png, .jpeg, o .bmp de 8 bits, 24 bits o 32 bits. Tenga en cuenta que los archivos de imagen .jpeg con perfiles de color CMYK no son compatibles.

Muestra una imagen usando un arreglo asociativo de parámetros de visualización:

Consulte la sección Descifrado de imágenes a continuación para obtener detalles sobre cómo mostrar imágenes cifradas.

Carga el archivo de imagen especificado en un búfer de memoria fuera de pantalla.

Carga un archivo de imagen en un búfer de memoria fuera de pantalla. Las propiedades de visualización de la imagen se determinan mediante un arreglo asociativo de parámetros:

Usa el búfer de memoria en pantalla para mostrar la imagen almacenada en el búfer de memoria fuera de pantalla usando PreloadFile(). Solo hay dos búferes de memoria: uno se muestra en pantalla y el otro se usa para precargar imágenes. PreloadFile() puede llamarse varias veces antes de que se llame a DisplayPreload() y continuará cargando en el mismo búfer fuera de pantalla. El método DisplayFile() llama a PreloadFile() seguido inmediatamente por DisplayPreload(), por lo que cualquier imagen precargada previamente se perderá. Si no hay ninguna imagen precargada, DisplayPreload() no tendrá efecto.

Elimina una imagen de la pantalla.

Establece el modo de visualización de imagen predeterminado para DisplayFile() y PreloadFile(). Si no se llama a SetDefaultMode(), el modo predeterminado se establece en 0 (equivalente a que la imagen se centre sin escalado). Los modos de visualización compatibles se enumeran a continuación:

Establece la transición que se utilizará cuando se muestre la siguiente imagen. Las siguientes transiciones están disponibles:

Aplica una de ocho transformaciones a la imagen. Las llamadas a este método solo tienen efecto cuando se muestra el siguiente archivo. Tenga en cuenta que el rectángulo de la imagen en sí no cambia para adaptarse a la nueva relación de altura y anchura de una imagen transformada. Este método se puede llamar por separado en varias instancias de roImagePlayer o roImageWidget.

Compone la imagen con el nombre de archivo especificado sobre la imagen principal de DisplayFile() . Utilice los enteros x y y para especificar su ubicación dentro del widget de imagen.

Cambia el tamaño y la posición del rectángulo de imagen utilizando el objeto roRectangle.

Devuelve un objeto roRectangle que tiene la misma ubicación y dimensiones que el objeto roRectangle utilizado para definir la ventana de imagen.

Crea un agujero en la imagen con la ubicación y las dimensiones especificadas en la instancia de roRectangle pasada. Cualquier ventana de video ubicada directamente debajo de la imagen se mostrará a través de ella. Este método interrumpirá la reproducción de imágenes y solo debe usarse con fines de prueba.

Establece la cantidad de tiempo que tarda (en milisegundos) en producirse un efecto de transición especificado. La duración predeterminada de la transición es de 1000 milisegundos.

Oculta la imagen que se muestra actualmente mediante el widget roImagePlayer.

Muestra la imagen que se está mostrando actualmente mediante el widget roImagePlayer.

Envía el widget a la parte superior del orden z en el plano gráfico (es decir, delante de todas las demás superficies que implementan la interfaz ifWidget). De forma predeterminada, los widgets nuevos se colocan en la parte superior del orden z gráfico.

Envía el widget a la parte inferior del orden z en el plano gráfico (es decir, detrás de todas las demás superficies que implementan la interfaz ifWidget). De forma predeterminada, los widgets nuevos se colocan en la parte superior del orden z gráfico.

Los valores x e y indican qué posición de la imagen se debe centrar lo más cerca posible, o tanto x como y pueden establecerse en -1, lo que utiliza el centro de la imagen como el punto que se posicionará más cerca del centro.

Para mostrar imágenes en una zona, se debe llamar a SetRectangle() y EnableZoneSupport() debe incluirse en un script para usar la funcionalidad de zonas.

A continuación se muestran algunos comandos de shell de ejemplo que puede usar para probar los diferentes modos de visualización:

El siguiente script de ejemplo utiliza imágenes precargadas para mejorar la velocidad de la interfaz de usuario cuando el usuario presiona una tecla en el teclado. Tan pronto como se presiona una tecla, la pantalla cambia a la nueva imagen, que ya se ha precargado. El único retraso posible ocurre si la tecla se presiona mientras la imagen se está precargando. En este caso, la imagen se mostrará tan pronto como se cargue.

Los objetos roImagePlayer, roImageWidget, roClockWidget, roTextWidget, y roCanvasWidget pueden usarse para mostrar imágenes cifradas. Cada objeto tiene un método de reproducción de imágenes que acepta una matriz asociativa, que puede incluir los parámetros de descifrado EncryptionAlgorithm y EncryptionKey.

Puede llamar a roDeviceInfo.HasFeature("media_decryption") para determinar si un modelo de reproductor y una versión de firmware admiten el descifrado de imágenes.

Ejemplo: