QMovie Class
La clase QMovie es una clase de utilidad para reproducir vídeos con QImageReader. Más información...
| Encabezado: | #include <QMovie> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado de: | QObject |
Tipos públicos
| enum | CacheMode { CacheNone, CacheAll } |
| enum | MovieState { NotRunning, Paused, Running } |
Propiedades
Funciones públicas
| QMovie(QObject *parent = nullptr) | |
| QMovie(QIODevice *device, const QByteArray &format = QByteArray(), QObject *parent = nullptr) | |
| QMovie(const QString &fileName, const QByteArray &format = QByteArray(), QObject *parent = nullptr) | |
| virtual | ~QMovie() |
| QColor | backgroundColor() const |
| QBindable<QMovie::CacheMode> | bindableCacheMode() |
| QBindable<int> | bindableSpeed() |
| QMovie::CacheMode | cacheMode() const |
| int | currentFrameNumber() const |
| QImage | currentImage() const |
| QPixmap | currentPixmap() const |
| QIODevice * | device() const |
| QString | fileName() const |
| QByteArray | format() const |
| int | frameCount() const |
| QRect | frameRect() const |
| bool | isValid() const |
| bool | jumpToFrame(int frameNumber) |
| QImageReader::ImageReaderError | lastError() const |
| QString | lastErrorString() const |
| int | loopCount() const |
| int | nextFrameDelay() const |
| QSize | scaledSize() |
| void | setBackgroundColor(const QColor &color) |
| void | setCacheMode(QMovie::CacheMode mode) |
| void | setDevice(QIODevice *device) |
| void | setFileName(const QString &fileName) |
| void | setFormat(const QByteArray &format) |
| void | setScaledSize(const QSize &size) |
| int | speed() const |
| QMovie::MovieState | state() const |
Ranuras públicas
| bool | jumpToNextFrame() |
| void | setPaused(bool paused) |
| void | setSpeed(int percentSpeed) |
| void | start() |
| void | stop() |
Señales
| void | error(QImageReader::ImageReaderError error) |
| void | finished() |
| void | frameChanged(int frameNumber) |
| void | resized(const QSize &size) |
| void | started() |
| void | stateChanged(QMovie::MovieState state) |
| void | updated(const QRect &rect) |
Miembros públicos estáticos
| QList<QByteArray> | supportedFormats() |
Descripción detallada
Esta clase se utiliza para mostrar animaciones sencillas sin sonido.
En primer lugar, crea un objeto QMovie pasando al constructor de QMovie el nombre de un archivo o un puntero a un ` QIODevice ` que contenga un formato de imagen animada. Puedes llamar a ` isValid()` para comprobar si los datos de la imagen son válidos antes de iniciar la película. Para iniciar la película, llama a start(). QMovie entrará en el estado « Running » y emitirá started() y stateChanged(). Para obtener el estado actual de la película, llama a state().
Para mostrar la película en tu aplicación, puedes pasar tu objeto QMovie a QLabel::setMovie(). Ejemplo:
QLabel label;
QMovie *movie = new QMovie("animations/fire.gif");
label.setMovie(movie);
movie->start();Cada vez que haya un nuevo fotograma disponible en la película, QMovie emitirá updated(). Si cambia el tamaño del fotograma, se emite resized(). Puedes llamar a currentImage() o a currentPixmap() para obtener una copia del fotograma actual. Cuando finaliza la película, QMovie emite finished(). Si se produce algún error durante la reproducción (por ejemplo, si el archivo de imagen está dañado), QMovie emitirá error().
Puedes controlar la velocidad de reproducción de la película llamando a ` setSpeed()`, que toma como argumento el porcentaje de la velocidad original. Para pausar la película, llama a ` setPaused(true)`. QMovie entrará entonces en el estado ` Paused ` y emitirá ` stateChanged()`. Si llamas a ` setPaused(false)`, QMovie volverá al estado ` Running ` y reiniciará la reproducción de la película. Para detener la película, llama a ` stop()`.
Algunos formatos de animación permiten establecer el color de fondo. Puedes llamar a ` setBackgroundColor()` para establecer el color, o a ` backgroundColor()` para obtener el color de fondo actual.
currentFrameNumber() devuelve el número de secuencia del fotograma actual. El primer fotograma de la animación tiene el número de secuencia 0. frameCount() devuelve el número total de fotogramas de la animación, si el formato de imagen lo admite. Se puede llamar a loopCount() para obtener el número de veces que la película debe reproducirse en bucle antes de finalizar. nextFrameDelay() devuelve el número de milisegundos durante los que debe mostrarse el fotograma actual.
Se puede indicar a QMovie que almacene en caché los fotogramas de una animación llamando a setCacheMode().
Llama a supportedFormats() para obtener una lista de los formatos que admite QMovie.
Véase también QLabel y QImageReader.
Documentación sobre los tipos de miembros
enum QMovie::CacheMode
Esta enumeración describe los diferentes modos de caché de QMovie.
| Constante | Valor | Descripción |
|---|---|---|
QMovie::CacheNone | 0 | No se almacenan fotogramas en caché (valor por defecto). |
QMovie::CacheAll | 1 | Se almacenan todos los fotogramas en caché. |
enum QMovie::MovieState
Esta enumeración describe los diferentes estados de QMovie.
| Constante | Valor | Descripción |
|---|---|---|
QMovie::NotRunning | 0 | La película no se está reproduciendo. Este es el estado inicial de « QMovie », y el estado al que pasa después de que se haya llamado a « stop()» o de que la película haya terminado. |
QMovie::Paused | 1 | La película está en pausa, y QMovie deja de emitir updated() o resized(). Se entra en este estado tras llamar a pause() o a setPaused(true). Se guarda el número del fotograma actual, y la película continuará con el siguiente fotograma cuando se llame a unpause() o a setPaused(false). |
QMovie::Running | 2 | La película se está reproduciendo. |
Documentación de propiedades
[bindable] cacheMode : CacheMode
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad determina el modo de caché de la película
El almacenamiento en caché de fotogramas puede resultar útil cuando el controlador de formato de animación subyacente del que depende QMovie para decodificar los datos de animación no admite el salto a fotogramas concretos de la animación, ni siquiera el «rebobinado» de la animación hasta el principio (para la reproducción en bucle). Además, si los datos de imagen proceden de un dispositivo secuencial, el controlador de animación subyacente no puede retroceder a fotogramas cuyos datos ya se hayan leído (lo que hace que la reproducción en bucle sea totalmente imposible).
Para facilitar estas situaciones, se puede indicar a un objeto QMovie que almacene los fotogramas en caché, con el coste adicional de memoria que supone mantenerlos en memoria durante toda la vida útil del objeto.
Por defecto, esta propiedad está establecida en ` CacheNone`.
Funciones de acceso:
| QMovie::CacheMode | cacheMode() const |
| void | setCacheMode(QMovie::CacheMode mode) |
Véase también QMovie::CacheMode.
[bindable] speed : int
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad determina la velocidad de la película
La velocidad se mide en porcentaje de la velocidad original de la película. La velocidad por defecto es del 100 %. Ejemplo:
QMovie movie("racecar.gif");
movie.setSpeed(200); // 2x speedFunciones de Access:
| int | speed() const |
| void | setSpeed(int percentSpeed) |
Documentación de las funciones de miembro
[explicit] QMovie::QMovie(QObject *parent = nullptr)
Crea un objeto QMovie, pasando el objeto parent al constructor de QObject.
Véase también setFileName(), setDevice() y setFormat().
[explicit] QMovie::QMovie(QIODevice *device, const QByteArray &format = QByteArray(), QObject *parent = nullptr)
Crea un objeto QMovie. QMovie utilizará los datos de imagen leídos de device, que da por supuesto que está abierto y es legible. Si format no está vacío, QMovie utilizará el formato de imagen format para decodificar los datos de la imagen. De lo contrario, QMovie intentará adivinar el formato.
El objeto parent se pasa al constructor de QObject.
[explicit] QMovie::QMovie(const QString &fileName, const QByteArray &format = QByteArray(), QObject *parent = nullptr)
Crea un objeto QMovie. QMovie utilizará los datos de imagen leídos de fileName. Si format no está vacío, QMovie utilizará el formato de imagen format para decodificar los datos de imagen. De lo contrario, QMovie intentará adivinar el formato.
El objeto parent se pasa al constructor de QObject.
[virtual noexcept] QMovie::~QMovie()
Destruye el objeto « QMovie ».
QColor QMovie::backgroundColor() const
Devuelve el color de fondo de la película. Si no se ha asignado ningún color de fondo, se devuelve un objeto ` QColor ` no válido.
Véase también setBackgroundColor().
int QMovie::currentFrameNumber() const
Devuelve el número de secuencia del fotograma actual. El número del primer fotograma de la película es 0.
QImage QMovie::currentImage() const
Devuelve el fotograma actual como un objeto ` QImage`.
Véase también currentPixmap() y updated().
QPixmap QMovie::currentPixmap() const
Devuelve el fotograma actual como un objeto de tipo ` QPixmap`.
Véase también currentImage() y updated().
QIODevice *QMovie::device() const
Devuelve el dispositivo del que « QMovie » lee los datos de imagen. Si actualmente no se ha asignado ningún dispositivo, se devuelve « nullptr ».
Véase también setDevice() y fileName().
[signal] void QMovie::error(QImageReader::ImageReaderError error)
QMovie emite esta señal cuando se produce el error error durante la reproducción. QMovie detendrá la película y pasará al estado QMovie::NotRunning.
Véase también lastError() y lastErrorString().
QString QMovie::fileName() const
Devuelve el nombre del archivo del que QMovie lee los datos de la imagen. Si no se ha asignado ningún nombre de archivo, o si el dispositivo asignado no es un archivo, se devuelve un objeto QString vacío.
Véanse también setFileName() y device().
[signal] void QMovie::finished()
Esta señal se emite cuando la película ha terminado.
Véase también QMovie::stop().
QByteArray QMovie::format() const
Devuelve el formato que utiliza QMovie al decodificar datos de imagen. Si no se ha asignado ningún formato, se devuelve un QByteArray() vacío.
Véase también setFormat().
[signal] void QMovie::frameChanged(int frameNumber)
Esta señal se emite cuando el número de fotograma ha cambiado a frameNumber. Puedes llamar a currentImage() o a currentPixmap() para obtener una copia del fotograma.
int QMovie::frameCount() const
Devuelve el número de fotogramas de la película.
Algunos formatos de animación no admiten esta función; en ese caso, se devuelve 0.
QRect QMovie::frameRect() const
Devuelve el rect del último fotograma. Si aún no se ha actualizado ningún fotograma, se devuelve un objeto ` QRect ` no válido.
Véase también currentImage() y currentPixmap().
bool QMovie::isValid() const
Devuelve « true » si la película es válida (por ejemplo, si los datos de la imagen se pueden leer y el formato de la imagen es compatible); en caso contrario, devuelve « false ».
Para obtener información sobre por qué el vídeo no es válido, consulta lastError().
bool QMovie::jumpToFrame(int frameNumber)
Salta al fotograma número frameNumber. Devuelve true si se realiza correctamente; en caso contrario, devuelve false.
[slot] bool QMovie::jumpToNextFrame()
Pasa al siguiente fotograma. Devuelve « true » si se realiza correctamente; en caso contrario, devuelve « false ».
QImageReader::ImageReaderError QMovie::lastError() const
Devuelve el último error que se ha producido al intentar leer los datos de la imagen.
Véase también lastErrorString().
QString QMovie::lastErrorString() const
Devuelve una representación legible para el usuario del error más reciente que se ha producido al intentar leer los datos de la imagen.
Véase también lastError().
int QMovie::loopCount() const
Devuelve el número de veces que se reproducirá la película en bucle antes de que termine. Si la película solo se reproduce una vez (sin bucle), loopCount devuelve 0. Si la película se reproduce en bucle indefinidamente, loopCount devuelve -1.
Ten en cuenta que, si los datos de la imagen proceden de un dispositivo secuencial (por ejemplo, un socket), ` QMovie ` solo puede reproducir la película en bucle si la opción ` cacheMode ` está establecida en ` QMovie::CacheAll`.
int QMovie::nextFrameDelay() const
Devuelve el número de milisegundos que esperará « QMovie » antes de actualizar el siguiente fotograma de la animación.
[signal] void QMovie::resized(const QSize &size)
Esta señal se emite cuando se ha redimensionado el fotograma actual a size. Este efecto se utiliza a veces en animaciones como alternativa a la sustitución del fotograma. Puedes llamar a currentImage() o currentPixmap() para obtener una copia del fotograma actualizado.
QSize QMovie::scaledSize()
Devuelve el tamaño escalado de los fotogramas.
Véase también setScaledSize() y QImageReader::scaledSize().
void QMovie::setBackgroundColor(const QColor &color)
En los formatos de imagen que lo admiten, esta función establece el color de fondo en color.
Véase también backgroundColor().
void QMovie::setDevice(QIODevice *device)
Establece el dispositivo actual en device. QMovie leerá los datos de imagen de este dispositivo cuando se esté reproduciendo la película.
Véase también device() y setFormat().
void QMovie::setFileName(const QString &fileName)
Establece el nombre del archivo del que QMovie lee los datos de imagen en fileName.
Véanse también fileName(), setDevice() y setFormat().
void QMovie::setFormat(const QByteArray &format)
Establece el formato que utilizará QMovie al decodificar los datos de imagen en format. De forma predeterminada, QMovie intentará adivinar el formato de los datos de imagen.
Puedes llamar a supportedFormats() para obtener la lista completa de formatos que admite QMovie.
Véase también format() y QImageReader::supportedImageFormats().
[slot] void QMovie::setPaused(bool paused)
Si « paused » es verdadero, « QMovie » entrará en el estado « Paused » y emitirá « stateChanged » (Paused); en caso contrario, entrará en el estado « Running » y emitirá « stateChanged » (Running).
Véase también state().
void QMovie::setScaledSize(const QSize &size)
Establece el tamaño escalado del fotograma en size.
Véase también scaledSize() y QImageReader::setScaledSize().
[slot] void QMovie::start()
Inicia la película. « QMovie » pasará al estado « Running » y comenzará a emitir « updated()» y « resized()» a medida que avanza la película.
Si QMovie se encuentra en el estado Paused, esta función equivale a llamar a setPaused(false). Si QMovie ya se encuentra en el estado Running, esta función no realiza ninguna acción.
Véase también stop() y setPaused().
[signal] void QMovie::started()
Esta señal se emite después de que se haya llamado a ` QMovie::start()` y ` QMovie ` haya entrado en el estado « QMovie::Running ».
QMovie::MovieState QMovie::state() const
Devuelve el estado actual de QMovie.
Véase también MovieState y stateChanged().
[signal] void QMovie::stateChanged(QMovie::MovieState state)
Esta señal se emite cada vez que cambia el estado de la película. El nuevo estado viene especificado por state.
Véase también QMovie::state().
[slot] void QMovie::stop()
Detiene la película. « QMovie » pasa al estado « NotRunning » y deja de emitir « updated()» y « resized()». Si se vuelve a llamar a « start()», la película se reanudará desde el principio.
Si QMovie ya se encuentra en el estado NotRunning, esta función no realiza ninguna acción.
Véanse también start() y setPaused().
[static] QList<QByteArray> QMovie::supportedFormats()
Devuelve la lista de formatos de imagen compatibles con QMovie.
Véase también QImageReader::supportedImageFormats().
[signal] void QMovie::updated(const QRect &rect)
Esta señal se emite cuando se ha actualizado el rect rect e del fotograma actual. Puedes llamar a currentImage() o currentPixmap() para obtener una copia del fotograma actualizado.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.