QMovie Class

QLabel label;
QMovie *movie = new QMovie("animations/fire.gif");

label.setMovie(movie);
movie->start();

QMovie movie("racecar.gif");
movie.setSpeed(200); // 2x speed

Documentación de funciones miembro

[explicit] QMovie::QMovie(QObject *parent = nullptr)

Construye 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)

Construye un objeto QMovie. QMovie utilizará los datos de imagen leídos de device, que asume que está abierto y es legible. Si format no está vacío, QMovie utilizará el formato de imagen format para decodificar los datos de imagen. En caso 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)

Construye 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. En caso 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 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 marco actual como QImage.

Véase también currentPixmap() y updated().

QPixmap QMovie::currentPixmap() const

Devuelve el marco actual como QPixmap.

Véase también currentImage() y updated().

QIODevice *QMovie::device() const

Devuelve el dispositivo del que QMovie lee datos de imagen. Si no se ha asignado ningún dispositivo, se devuelve nullptr.

Véase también setDevice() y fileName().

[signal] void QMovie::error(QImageReader::ImageReaderError error)

Esta señal es emitida por QMovie cuando se produce un error error durante la reproducción. QMovie detendrá la película y entrará en el estado QMovie::NotRunning.

Véase también lastError() y lastErrorString().

QString QMovie::fileName() const

Devuelve el nombre del archivo del que QMovie lee datos de imagen. Si no se ha asignado ningún nombre de archivo, o si el dispositivo asignado no es un archivo, se devuelve un QString vacío.

Véase 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 descodificar 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. Puede llamar a currentImage() o 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 cuyo 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 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, los datos de imagen son legibles y el formato de imagen es compatible); en caso contrario, devuelve false.

Para obtener información sobre por qué la película no es válida, consulte lastError().

bool QMovie::jumpToFrame(int frameNumber)

Salta al número de fotograma frameNumber. Devuelve true en caso de éxito; en caso contrario devuelve false.

[slot] bool QMovie::jumpToNextFrame()

Salta al siguiente fotograma. Devuelve true en caso de éxito; en caso contrario, devuelve false.

QImageReader::ImageReaderError QMovie::lastError() const

Devuelve el error más reciente que se ha producido al intentar leer datos de imagen.

Véase también lastErrorString().

QString QMovie::lastErrorString() const

Devuelve una representación legible por humanos del error más reciente que se ha producido al intentar leer datos de imagen.

Véase también lastError().

int QMovie::loopCount() const

Devuelve el número de veces que la película se reproducirá en bucle antes de terminar. Si la película sólo se reproduce una vez (sin bucle), loopCount devuelve 0. Si la película se repite para siempre, loopCount devuelve -1.

Tenga en cuenta que, si los datos de la imagen proceden de un dispositivo secuencial (por ejemplo, un socket), QMovie sólo puede reproducir la película en bucle si cacheMode está configurado como QMovie::CacheAll.

int QMovie::nextFrameDelay() const

Devuelve el número de milisegundos que QMovie esperará antes de actualizar el siguiente fotograma de la animación.

[signal] void QMovie::resized(const QSize &size)

Esta señal se emite cuando el fotograma actual se ha redimensionado 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)

Para 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á datos de imagen de este dispositivo cuando la película se esté ejecutando.

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éase también fileName(), setDevice(), y setFormat().

void QMovie::setFormat(const QByteArray &format)

Establece el formato que QMovie utilizará al descodificar los datos de imagen, en format. Por defecto, 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(Pausado); en caso contrario, entrará en el estado Running y emitirá stateChanged(En ejecución).

Véase también state().

void QMovie::setScaledSize(const QSize &size)

Establece el tamaño del marco escalado en size.

Véase también scaledSize() y QImageReader::setScaledSize().

[slot] void QMovie::start()

Inicia la película. QMovie entrará en el estado Running, y empezará a emitir updated() y resized() a medida que avance la película.

Si QMovie está en el estado Paused, esta función equivale a llamar a setPaused(false). Si QMovie ya está en el estado Running, esta función no hace nada.

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 se especifica en state.

Véase también QMovie::state().

[slot] void QMovie::stop()

Detiene la película. QMovie entra en el estado NotRunning, y deja de emitir updated() y resized(). Si se vuelve a llamar a start(), la película se reiniciará desde el principio.

Si QMovie ya está en el estado NotRunning, esta función no hace nada.

Véase también start() y setPaused().

[static] QList<QByteArray> QMovie::supportedFormats()

Devuelve la lista de formatos de imagen soportados por QMovie.

Véase también QImageReader::supportedImageFormats().

[signal] void QMovie::updated(const QRect &rect)

Esta señal se emite cuando el rect rect del fotograma actual ha sido actualizado. Puede llamar a currentImage() o currentPixmap() para obtener una copia del marco actualizado.