QImageReader Class

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

QImageReader::QImageReader()

空の QImageReader オブジェクトを構築します。画像を読み込む前に、setDevice() またはsetFileName() をコールします。

[explicit] QImageReader::QImageReader(QIODevice *device, const QByteArray &format = QByteArray())

デバイスdevice と画像フォーマットformat で QImageReader オブジェクトを構築します。

[explicit] QImageReader::QImageReader(const QString &fileName, const QByteArray &format = QByteArray())

ファイル名fileName と画像フォーマットformat を持つ QImageReader オブジェクトを構築します。

setFileName()も参照してください 。

[noexcept] QImageReader::~QImageReader()

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

[static, since 6.0] int QImageReader::allocationLimit()

現在の割り当て上限をメガバイト単位で返します。

この関数は Qt 6.0 で導入されました。

setAllocationLimit()も参照してください 。

bool QImageReader::autoDetectImageFormat() const

この画像リーダーで画像フォーマットの自動検出が有効であればtrue を返し、そうでなければfalse を返す。デフォルトでは、自動検出は有効です。

setAutoDetectImageFormat()も参照 。

bool QImageReader::autoTransform() const

画像ハンドラがread() の変換メタデータを適用する場合はtrue を返す。

setAutoTransform(),transformation(),read()も参照 ください。

QColor QImageReader::backgroundColor() const

画像を読み込む際に使用する背景色を返します。画像フォーマットが背景色の設定をサポートしていない場合は、無効な色が返されます。

setBackgroundColor() およびread()も参照 ください。

bool QImageReader::canRead() const

デバイスに対して画像を読み込むことができる場合（すなわち、画像フォーマットがサポー トされており、デバイスに有効なデータが含まれていると思われる場合）はtrue を返し、そうでない場合はfalse を返す。

canRead()は軽量な関数で、画像データが有効かどうかを素早くテストするだけです。read画像データが破損している場合、canRead() がtrue を返した後でも、() が偽を返すことがあります。

アニメーションをサポートする画像の場合、canRead() は、すべてのフレームの読み込みが完了するとfalse を返します。

read()、supportedImageFormats()、QMimeDatabaseも参照 。

QRect QImageReader::clipRect() const

画像の ク リ ッ プ矩形 （ROI （Region Of Interest） と も い う ） を返 し ます。クリップ矩形が設定されていない場合は、無効なQRect が返されます。

setClipRect()も参照して ください。

int QImageReader::currentImageNumber() const

アニメーションをサポートしている画像フォーマットの場合、この関数は現在のフレームのシーケンス番号を返します。画像フォーマットがアニメーションをサポートしていない場合、0が返される。

エラーが発生した場合、この関数は -1 を返す。

supportsAnimation(),QImageIOHandler::currentImageNumber(),canRead()も参照 。

QRect QImageReader::currentImageRect() const

アニメーションをサポートする画像フォーマットの場合、この関数は現在のフレームのrectを返します。そうでない場合は null rect が返されます。

supportsAnimation() およびQImageIOHandler::currentImageRect()も参照してください 。

bool QImageReader::decideFormatFromContent() const

画像リーダーが、ファイルの拡張子ではなくデータストリームの内容のみに基づいて使用するプラグインを決定すべきかどうかを返します。

setDecideFormatFromContent()も参照 。

QIODevice *QImageReader::device() const

QImageReader に現在割り当てられているデバイス、またはデバイスが割り当てられていない場合はnullptr を返す。

setDevice()も参照のこと 。

QImageReader::ImageReaderError QImageReader::error() const

最後に発生したエラーのタイプを返す。

ImageReaderError およびerrorString()も参照 。

QString QImageReader::errorString() const

最後に発生したエラーについて、人間が読める説明を返す。

error()も参照 。

QString QImageReader::fileName() const

現在割り当てられているデバイスがQFile の場合、またはsetFileName() が呼び出された場合、この関数はQImageReader が読み込んだファイル名を返す。そうでない場合（つまり、デバイスが割り当てられていないか、デバイスがQFile でない場合）、空のQString が返される。

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

QByteArray QImageReader::format() const

QImageReader が画像の読み取りに使用しているフォーマットを返します。

リーダにデバイスを割り当てた後でこの関数を呼び出すと、デバイスのフォーマットを決定することができます。例えば

QImageReader reader("image.png");
// reader.format() == "png"

リーダがデバイスから画像を読み取れない場合（例えば、そこに画像がない、または画像が既に読み取られている）、またはフォーマットがサポートされていない場合、この関数は空のQByteArray()を返します。

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

int QImageReader::imageCount() const

アニメーションをサポートしている画像フォーマットの場合、この関数はアニメーション内の画像の総数を返します。そのフォーマットがアニメーションをサポートしていない場合は、0が返される。

エラーが発生した場合、この関数は -1 を返す。

supportsAnimation(),QImageIOHandler::imageCount(),canRead()も参照 。

QImage::Format QImageReader::imageFormat() const

画像の内容を実際に読み込むことなく、画像のフォーマットを返します。フォーマットは、実際の画像のフォーマットではなく、QImageReader::read() が返す画像のフォーマットを表します。

画像フォーマットがこの機能をサポートしていない場合、この関数は無効なフォーマットを返します。

QImageIOHandler::ImageOption 、QImageIOHandler::option()、QImageIOHandler::supportsOption()も参照 。

[static] QByteArray QImageReader::imageFormat(QIODevice *device)

サポートされている場合、この関数はデバイスの画像フォーマットを返すdevice 。そうでない場合は、空の文字列が返される。

QImageReader::autoDetectImageFormat()も参照のこと 。

[static] QByteArray QImageReader::imageFormat(const QString &fileName)

サポートされている場合、この関数はファイルfileName の画像フォーマットを返す。そうでない場合は、空の文字列が返されます。

[static] QList<QByteArray> QImageReader::imageFormatsForMimeType(const QByteArray &mimeType)

mimeType に対応する画像フォーマットのリストを返す。

この関数を呼び出す前に、QGuiApplication インスタンスを作成しておく必要があることに注意。

supportedImageFormats() およびsupportedMimeTypes()も参照 。

bool QImageReader::jumpToImage(int imageNumber)

アニメーションをサポートする画像フォーマットの場合、この関数は、シーケンス番号がimageNumber である画像までスキップし、成功すればtrueを返し、該当する画像が見つからなければfalseを返します。

次にread() を呼び出すと、この画像の読み込みが試行される。

jumpToNextImage() およびQImageIOHandler::jumpToImage()も参照 。

bool QImageReader::jumpToNextImage()

アニメーションをサポートする画像フォーマットの場合、この関数は現在の画像をステップオーバーし、成功した場合はtrueを返し、アニメーションの次の画像がない場合はfalseを返します。

デフォルトの実装では、read() を呼び出した後、結果の画像を破棄しますが、 画像ハンドラには、この操作をより効率的に実装する方法があるかもしれません。

jumpToImage() およびQImageIOHandler::jumpToNextImage()も参照して ください。

int QImageReader::loopCount() const

アニメーションをサポートする画像フォーマットの場合、この関数はアニメーションがループする回数を返します。この関数が -1 を返した場合は、アニメーションが永遠にループするか、エラーが発生したことを意味します。エラーが発生した場合、canRead() は false を返します。

supportsAnimation()、QImageIOHandler::loopCount()、canRead()も参照 。

int QImageReader::nextImageDelay() const

アニメーションをサポートしている画像フォーマットの場合、この関数はアニメーションの次のフレームを表示するまでの待ち時間をミリ秒単位で返します。画像フォーマットがアニメーションをサポートしていない場合は、0が返されます。

エラーが発生した場合、この関数は -1 を返す。

supportsAnimation()、QImageIOHandler::nextImageDelay()、canRead()も参照 。

int QImageReader::quality() const

画像フォーマットの画質設定を返す。

setQuality()も参照 。

QImage QImageReader::read()

デバイスから画像を読み込む。成功した場合は、読み込んだ画像が返される。失敗した場合は、NULLQImage が返される。その後、error() をコールして発生したエラーの種類を調べたり、errorString() をコールしてエラーの説明を読み取ったりすることができる。

アニメーションをサポートする画像フォーマットの場合、read() を繰り返し呼び出すと、次のフレームが返されます。すべてのフレームが読み込まれると、NULL 画像が返されます。

canRead()、supportedImageFormats()、supportsAnimation()、QMovieも参照 。

bool QImageReader::read(QImage *image)

これはオーバーロードされた関数である。

デバイスから画像をimage に読み込みます。 はQImage を指す必要があります。成功すればtrue を返し、そうでなければfalse を返します。

image が読み込もうとしている画像データと同じフォーマットとサイズを持っている場合、この関数は読み込む前に新しい画像を割り当てる必要がないかもしれません。こ のため、 こ の関数は、 つねに新 し い画像を構築す る 他の read() オーバーロー ド よ り も高速です。

QImage icon(64, 64, QImage::Format_RGB32);
QImageReader reader("icon_64x64.bmp");
if (reader.read(&icon)) {
    // Display icon
}

アニメーションをサポートしている画像フォーマットでは、 read() を繰り返しコールすると次のフレームが返されます。すべてのフレームの読み込みが終了すると、NULL 画像が返されます。

canRead(),supportedImageFormats(),supportsAnimation(),QMovieも参照 。

QRect QImageReader::scaledClipRect() const

画像の拡大縮小されたクリップ矩形を返します。

setScaledClipRect()も参照 ください。

QSize QImageReader::scaledSize() const

画像の拡大縮小サイズを返します。

setScaledSize()も参照 ください。

[static, since 6.0] void QImageReader::setAllocationLimit(int mbLimit)

割り当ての上限をmbLimit メガバイトに設定します。この制限を超えてQImage のメモリ割り当てを必要とする画像は拒否されます。mbLimit が 0 の場合、割り当てサイズのチェックは無効になります。

この制限は、アプリケーションが破損した画像ファイルを読み込むことで予期せぬ大きなメモリ使用を避けるのに役立ちます。通常は変更する必要はありません。デフォルトの制限値は、一般的に使用されるすべての画像サイズに対して十分な大きさです。

実行時に、この値は環境変数QT_IMAGEIO_MAXALLOC で上書きできます。

この関数は Qt 6.0 で導入されました。

allocationLimit()も参照してください 。

void QImageReader::setAutoDetectImageFormat(bool enabled)

enabled がtrueの場合、画像フォーマットの自動検出が有効になり、そうでない場合は無効になる。デフォルトでは、自動検出は有効です。

QImageReader まず、 にファイル名を渡すと、与えられたファイル名が既存のファイルを指していない場合、サポートされているデフォルトの拡張子を与えられたファイル名に1つずつ付加することで、ファイル拡張子の検出を試みます。次に、以下の方法で画像フォーマットを検出します：QImageReader

• 画像プラグインは、オプションのフォーマット文字列か、ファイル名の接尾辞（ソースデバイスがファイルの場合）のどちらかに基づいて、最初に照会されます。QImageReader は、このフォーマットの読み込みをサポートしている最初のプラグインを選択します。
• サポートしているプラグインがない場合は、Qt の組み込みハンドラが、オプションのフォーマット文字列かファイル名の接尾辞に基づいてチェックされます。
• 対応するプラグインや組み込みハンドラが見つからない場合は、データストリームの内容を検査して各プラグインをテストします。
• データの内容から画像フォーマットを検出できるプラグインがない場合、各ビルトイン画像ハンドラは、内容を検査することによってテストされます。
• 最後に、上記のアプローチがすべて失敗した場合、QImageReader 、画像を読み込もうとすると失敗が報告されます。

画像フォーマットの自動検出を無効にすることで、QImageReader は、フォーマット文字列に基づいてプラグインと組み込みハンドラに問い合わせるだけとなります（つまり、ファイル名の拡張子はテストされません）。

autoDetectImageFormat()、QImageIOHandler::canRead()、QImageIOPlugin::capabilities()も参照 。

void QImageReader::setAutoTransform(bool enabled)

enabled がtrue の場合に、read() が返す画像に変換メタデータが自動的に適用されるようにします。

autoTransform()、transformation() およびread()も参照 。

void QImageReader::setBackgroundColor(const QColor &color)

背景色をcolor に設定する。 この操作をサポートする画像フォーマットは、画像を読み込む前に背景をcolor に初期化することが期待されている。

backgroundColor() およびread()も参照 。

void QImageReader::setClipRect(const QRect &rect)

画像クリップ矩形（ROI，Region Of Interest としても知られる）をrect に設定する。rect の座標は，size() が返す，変換前の画像サイズからの相対座標である。

clipRect(),setScaledSize(),setScaledClipRect()も参照 。

void QImageReader::setDecideFormatFromContent(bool ignored)

ignored を true に設定すると、画像リーダーは指定されたフォーマットやファイル拡張子を無視し、データストリームの内容のみに基づいて使用するプラグインを決定します。

このフラグを設定すると、すべての画像プラグインが読み込まれます。各プラグインは画像データの最初のバイトを読み込み、プラグインが互換性があるかどうかを判断します。

これは、画像フォーマットの自動検出も無効にします。

decideFormatFromContent()も参照 。

void QImageReader::setDevice(QIODevice *device)

QImageReader deviceすでにデバイスが設定されている場合、古いデバイスはQImageReader から削除され、それ以外は変更されない。

デバイスがまだオープンされていない場合、QImageReader は open()を呼び出して、ReadOnly モードでデバイスをオープンしようとする。これは、QProcess 、QTcpSocket 、QUdpSocket など、デバイスをオープンするために多くのロジックが必要な特定のデバイスでは機能しないことに注意。

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

void QImageReader::setFileName(const QString &fileName)

QImageReader のファイル名をfileName に設定します。 内部的には、QImageReader はQFile オブジェクトを作成し、ReadOnly モードで開き、画像を読み込むときにこれを使用します。

fileName にファイル拡張子（.pngや.bmpなど）が含まれていない場合、QImageReader は、一致するファイルが見つかるまで、サポートされているすべての拡張子を循環させる。

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

void QImageReader::setFormat(const QByteArray &format)

画像を読み込むときにQImageReader が使う書式をformat に設定します。format は大文字小文字を区別しないテキスト文字列です。例

QImageReader reader;
reader.setFormat("png"); // same as reader.setFormat("PNG");

supportedImageFormats() をコールすると、QImageReader がサポートする書式の全リストを見ることができます。

format()も参照 ください。

void QImageReader::setQuality(int quality)

画像フォーマットの品質設定をquality に設定する。

画像フォーマットによっては、特に非可逆なものでは、a) 結果画像の視覚的品質と b) デコード実行時間との間のトレードオフを伴います。この関数は、それをサポートする画像フォーマットに対して、そのトレードオフのレベルを設定します。

スケーリングされた画像を読み取る場合、品質設定は、視覚的品質とスケーリングアルゴリズムの実行速度との間のトレードオフレベルにも影響する可能性があります。

quality の値域は画像フォーマットに依存します。例えば、"jpeg "フォーマットは、0（低画質）から100（高画質）までの画質範囲をサポートしています。

quality() およびsetScaledSize()も参照 。

void QImageReader::setScaledClipRect(const QRect &rect)

scaled clip rect をrect に設定します。 scaled clip rect は、 画像が拡大縮小された後に適用されるクリップ矩形 （ROI （Region Of Interest） とも呼ばれます） です。

scaledClipRect() およびsetScaledSize()も参照 。

void QImageReader::setScaledSize(const QSize &size)

画像の拡大縮小サ イ ズ をsize に設定 し ます。 こ の拡大縮小は、 最初の ク リ ッ プ矩形の後で、 拡大縮小 さ れた ク リ ッ プ矩形が適用 さ れる 前に行われます。スケーリングに使われるアルゴリズムは画像フォーマットに依存します。デフォルトでは（つまり、画像フォーマットがスケーリングに対応していない場合）、QImageReader は Qt::SmoothScaling を用いて QImage::scale() を使用します。

size で1つの次元しか設定されていない場合、もう1つの次元は、縦横比を維持するように、画像のnatural size から計算されます。

scaledSize(),setClipRect(),setScaledClipRect()も参照してください 。

QSize QImageReader::size() const

画像の内容を実際に読み込むことなく、画像のサイズを返します。

画像フォーマットがこの機能をサポートしていない場合、この関数は無効なサイズを返します。Qt の組み込み画像ハンドラはすべてこの機能をサポートしていますが、カスタム画像フォーマットプラグインはこの機能をサポートしている必要はありません。

QImageIOHandler::ImageOption,QImageIOHandler::option(),QImageIOHandler::supportsOption()も参照してください 。

QByteArray QImageReader::subType() const

画像のサブタイプを返します。

[static] QList<QByteArray> QImageReader::supportedImageFormats()

QImageReader がサポートしている画像フォーマットのリストを返します。

デフォルトでは、Qt は以下のフォーマットを読み込むことができます：

SVGファイルの読み書きは Qt SVGモジュールでサポートされています。この Qt Image Formatsモジュールは追加の画像フォーマットのサポートを提供する。

この関数が呼ばれる前にQCoreApplication インスタンスが生成されていなければならないことに注意。

setFormat(),QImageWriter::supportedImageFormats(),QImageIOPluginも参照 。

[static] QList<QByteArray> QImageReader::supportedMimeTypes()

QImageReader がサポートする MIME タイプのリストを返す。

この関数を呼び出す前にQApplication インスタンスを作成しておく必要があることに注意。

supportedImageFormats() およびQImageWriter::supportedMimeTypes()も参照 。

QList<QByteArray> QImageReader::supportedSubTypes() const

画像がサポートしているサブタイプのリストを返します。

bool QImageReader::supportsAnimation() const

画像フォーマットがアニメーションをサポートしている場合はtrue を返し、そうでない場合は false を返す。

QMovie::supportedFormats()も参照 。

bool QImageReader::supportsOption(QImageIOHandler::ImageOption option) const

リーダーがoption をサポートしていればtrue を返し、そうでなければ false を返す。

画像フォーマットによってサポートするオプションは異なります。あるオプションが現在のフォーマットでサポートされているかどうかを調べるには、この関数を呼び出します。たとえば、PNGフォーマットでは、画像のメタデータにテキストを埋め込むことができますし（text() を参照）、BMPフォーマットでは、画像全体をメモリに読み込むことなく画像のサイズを決定することができます（size() を参照）。

QImageReaderreader(":/image.png");if(reader.supportsOption(QImageIOHandler::Size))    qDebug() << "Size:" << reader.size();

QImageWriter::supportsOption()も参照のこと 。

QString QImageReader::text(const QString &key) const

key に関連付けられた画像テキストを返す。

このオプションのサポートはQImageIOHandler::Description で実装されています。

textKeys() およびQImageWriter::setText()も参照 。

QStringList QImageReader::textKeys() const

この画像のテキストキーを返します。こ れ ら のキーをtext() と 組み合わせて使えば、 特定のキーの画像テ キ ス ト を リ ス ト す る こ と がで き ます。

このオプションのサポートは、QImageIOHandler::Description で実装されています。

text()、QImageWriter::setText()、QImage::textKeys()も参照 。

QImageIOHandler::Transformations QImageReader::transformation() const

画像の向きな ど、 画像の変換 メ タ デー タ を返 し ます。フォーマットが変換メタデータをサポートしていない場合は、QImageIOHandler::TransformationNone が返されます。

setAutoTransform() およびautoTransform()も参照 。