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

メンバー関数ドキュメント

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

QMovie オブジェクトを構築します。parent オブジェクトをQObject のコンストラクタに渡します。

setFileName(),setDevice(),setFormat()も参照 。

[explicit] QMovie::QMovie(QIODevice *device, const QByteArray &format = QByteArray(), QObject *parent = nullptr)

QMovie オブジェクトを構築します。QMovieはdevice から画像データを読み込みます。format が空でない場合、QMovie は画像データのデコードに画像フォーマットformat を使用します。そうでない場合、QMovie はフォーマットの推測を試みます。

parent オブジェクトはQObject のコンストラクタに渡されます。

[explicit] QMovie::QMovie(const QString &fileName, const QByteArray &format = QByteArray(), QObject *parent = nullptr)

QMovie オブジェクトを構築します。QMovie はfileName から読み込んだ画像データを使用します。format が空でない場合、QMovie は画像データのデコードに画像フォーマットformat を使用します。そうでない場合、QMovieはフォーマットの推測を試みます。

parent オブジェクトはQObject のコンストラクタに渡されます。

[virtual noexcept] QMovie::~QMovie()

QMovie オブジェクトを破棄します。

QColor QMovie::backgroundColor() const

ムービーの背景色を返します。背景色が割り当てられていない場合は、無効なQColor が返されます。

setBackgroundColor()も参照 。

int QMovie::currentFrameNumber() const

現在のフレームのシーケンス番号を返す。ムービーの最初のフレームの番号は 0 です。

QImage QMovie::currentImage() const

現在のフレームをQImage として返す。

currentPixmap() およびupdated()も参照 。

QPixmap QMovie::currentPixmap() const

現在のフレームをQPixmap として返す。

currentImage() およびupdated()も参照 。

QIODevice *QMovie::device() const

QMovie が画像データを読み込むデバイスを返す。現在割り当てられているデバイスがない場合は、nullptr が返される。

setDevice() およびfileName()も参照のこと 。

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

このシグナルは、再生中にエラーerror が発生したときにQMovie から発せられる。QMovie はムービーを停止し、QMovie::NotRunning の状態になる。

lastError() およびlastErrorString()も参照のこと 。

QString QMovie::fileName() const

QMovie が画像データを読み込むファイル名を返す。ファイル名が割り当てられていない場合、または割り当てられたデバイスがファイルでない場合は、空のQString が返される。

setFileName() およびdevice()も参照 。

[signal] void QMovie::finished()

このシグナルはムービーが終了したときに発せられる。

QMovie::stop()も参照 。

QByteArray QMovie::format() const

画像データのデコード時にQMovie が使用するフォーマットを返します。フォーマットが割り当てられていない場合は、空の QByteArray() が返されます。

setFormat()も参照 。

[signal] void QMovie::frameChanged(int frameNumber)

このシグナルは、フレーム番号がframeNumber に変更されたときに発せられる。currentImage() またはcurrentPixmap() を呼び出すことで、フレームのコピーを取得できる。

int QMovie::frameCount() const

ムービーのフレーム数を返します。

この機能をサポートしていないアニメーションフォーマットもあり、その場合は 0 が返されます。

QRect QMovie::frameRect() const

最後のフレームの rect を返す。まだフレームが更新されていない場合は、無効なQRect が返されます。

currentImage() およびcurrentPixmap()も参照 。

bool QMovie::isValid() const

ムービーが有効な場合（例えば、画像データが読み取り可能で、画像フォーマットが サポートされている場合）にはtrue を返し、そうでない場合はfalse を返す。

ムービーが有効でない理由についてはlastError() を参照。

bool QMovie::jumpToFrame(int frameNumber)

フレーム番号frameNumber にジャンプします。成功した場合はtrue を返し、そうでない場合はfalse を返す。

[slot] bool QMovie::jumpToNextFrame()

次のフレームにジャンプする。成功すればtrue を返し、そうでなければfalse を返す。

QImageReader::ImageReaderError QMovie::lastError() const

画像データを読み込もうとして発生した直近のエラーを返す。

lastErrorString()も参照 。

QString QMovie::lastErrorString() const

画像データを読み込もうとした際に発生した直近のエラーを、人間が読める形で返します。

lastError()も参照 。

int QMovie::loopCount() const

ムービーが終了するまでにループする回数を返します。ムービーが1回しか再生されない（ループしない）場合、loopCountは0を返し、ムービーが永遠にループする場合、loopCountは-1を返す。

画像データがシーケンシャルデバイス(ソケットなど)から送られてくる場合、QMovie はcacheMode がQMovie::CacheAll に設定されている場合のみ、ムービーをループさせることができることに注意してください。

int QMovie::nextFrameDelay() const

アニメーションの次のフレームを更新する前にQMovie が待機するミリ秒数を返します。

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

このシグナルは、現在のフレームのサイズがsize に変更されたときに発せられます。この効果は、フレームを置き換える代わりにアニメーションで使用されることがあります。更新されたフレームのコピーを取得するには、currentImage() またはcurrentPixmap() を呼び出します。

QSize QMovie::scaledSize()

フレームの拡大縮小サイズを返します。

setScaledSize() およびQImageReader::scaledSize()も参照 。

void QMovie::setBackgroundColor(const QColor &color)

これをサポートしている画像フォーマットの場合、この関数は背景色をcolor に設定します。

backgroundColor()も参照 。

void QMovie::setDevice(QIODevice *device)

現在のデバイスをdevice に設定する。QMovie は、ムービー実行中にこのデバイスから画像データを読み込む。

device() およびsetFormat()も参照のこと 。

void QMovie::setFileName(const QString &fileName)

QMovie が画像データを読み込むファイル名をfileName に設定する。

fileName()、setDevice()、setFormat()も参照のこと 。

void QMovie::setFormat(const QByteArray &format)

画像データをデコードするときにQMovie が使用するフォーマットをformat に設定する。 デフォルトでは、QMovie は画像データのフォーマットを推測しようとする。

QMovie がサポートするフォーマットの全リストについては、supportedFormats() を呼び出すことができる。

format() およびQImageReader::supportedImageFormats()も参照 。

[slot] void QMovie::setPaused(bool paused)

paused がtrueの場合、QMovie はPaused の状態になり、stateChanged （Paused）を発する。そうでない場合は、Running の状態になり、stateChanged （Running）を発する。

state()も参照のこと 。

void QMovie::setScaledSize(const QSize &size)

スケーリングされたフレームサイズをsize に設定する。

scaledSize() およびQImageReader::setScaledSize()も参照 。

[slot] void QMovie::start()

ムービーを開始する。QMovie はRunning の状態になり、ムービーが進むにつれてupdated() とresized() を発するようになる。

QMovie がPaused 状態の場合、この関数はsetPaused(false) を呼び出すのと同じである。QMovie がすでにRunning の状態にある場合、この関数は何もしない。

stop() およびsetPaused()も参照 。

[signal] void QMovie::started()

このシグナルは、QMovie::start （）が呼び出され、QMovie がQMovie::Running の状態になった後に発せられる。

QMovie::MovieState QMovie::state() const

QMovie の現在の状態を返す。

MovieState およびstateChanged()も参照のこと 。

[signal] void QMovie::stateChanged(QMovie::MovieState state)

このシグナルはムービーの状態が変わるたびに発せられる。新しい状態はstate で指定される。

QMovie::state()も参照のこと 。

[slot] void QMovie::stop()

ムービーを停止する。QMovie はNotRunning の状態になり、updated() とresized() の発光を停止する。start() が再び呼ばれると、ムービーは最初から再開される。

QMovie がすでにNotRunning の状態にある場合、この関数は何もしない。

start() およびsetPaused()も参照 。

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

QMovie がサポートしている画像フォーマットの一覧を返す。

QImageReader::supportedImageFormats()も参照 。

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

このシグナルは、現在のフレームの rectrect が更新されたときに発せられます。更新されたフレームのコピーを取得するには、currentImage() またはcurrentPixmap() を呼び出します。