roImageWidget

Este objeto se puede usar en lugar de roImagePlayer en los casos en que la imagen se muestra dentro de un rectángulo. El uso de un roImageWidget puede dar como resultado una estética más agradable para la creación de reproductores de imágenes; también se puede usar para mostrar imágenes en una matriz multipantalla. Más allá de esto, roImageWidget se comporta de manera idéntica a roImagePlayer. El equivalente en JavaScript es la etiqueta <img> en HTML

Creación de objetos: el área del widget de imagen se genera usando un objeto roRectangle.

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 una matriz asociativa de parámetros de visualización:

Consulte la descripción de Descifrado de imágenesImage Decryption en la entrada de roImagePlayer 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 están determinadas por una matriz asociativa 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() se puede llamar varias veces antes de que DisplayPreload() sea llamado, 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á ningún efecto.

Elimina una imagen de la pantalla.

Establece el modo predeterminado de visualización de imágenes para DisplayFile() y PreloadFile(). Si no se llama a SetDefaultMode(), entonces el modo predeterminado se establece en 0 (equivalente a que la imagen esté centrada 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. Están disponibles las siguientes transiciones:

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 acomodar la nueva relación entre altura y ancho de una imagen transformada. Este método puede llamarse por separado en múltiples instancias de roImagePlayer o roImageWidget .

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

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

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 dimensiones especificadas en la instancia de roRectangle pasada. Cualquier ventana de video ubicada directamente debajo de la imagen será visible a través de ella. Este método interrumpirá la reproducción de imágenes y debe utilizarse solo 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 está mostrando actualmente mediante la instancia de roImageWidget .

Muestra la imagen que se está mostrando actualmente mediante la instancia de roImageWidget .

Este objeto incluye métodos sobrecargados PreloadFile() y DisplayFile() . Estos métodos reciben un objeto roAssociativeArray que almacena varias opciones que se pasarán. Deben utilizarse al mostrar imágenes en varias pantallas de una matriz, o al mostrar una parte de una imagen, aunque también pueden utilizarse en lugar de las llamadas al método original en todos los casos.

El siguiente código utiliza el método PreloadFile() para una visualización multipantalla:

Los valores de nombre de archivo, modo, y transición son los mismos que los documentados para los métodos DisplayFile() y PreloadFile() anteriores. Los parámetros AnchoMultiventana y AlturaMultiventana especifican el ancho y la altura de la matriz multipantalla. Por ejemplo, 3x2 serían tres pantallas de ancho y dos pantallas de alto. MultiscreenX y MultiscreenY especifican la posición de la pantalla actual dentro de esa matriz.

En el caso anterior, en promedio solo se dibuja 1/6 de la imagen en cada pantalla, aunque el modo de imagen sigue aplicándose, por lo que, dependiendo de la forma de la imagen, puede tener barras negras en las pantallas laterales. Por lo tanto, es relativamente sencillo que un widget de imagen muestre parte de una imagen según su posición en la matriz multipantalla. Los siguientes son valores predeterminados para los parámetros:

Este código utiliza DisplayFile() para mostrar una parte de una imagen:

Esto muestra solo una parte de la imagen test JPG comenzando en las coordenadas SourceX, SourceY, y con un tamaño de Ancho de origen por Altura de origen . El viewmode sigue respetándose como si estuviera mostrando el archivo completo.