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)

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

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

ムービーが終了するまでにループする回数を返します。ムービーが一度しか再生されない (ループしない) 場合は 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() を呼び出します。