QImage Class

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

与えられたformat の画像のコピーを返します。

指定された画像変換flags は，変換処理中に画像データがどのように扱われるかを制御します。

convertTo() およびImage Formatsも参照してください 。

与えられたformat の画像のコピーを返します。

指定された画像変換flags は、変換処理中に画像データがどのように扱われるかを制御します。

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

convertTo() およびImage Formatsも参照してください 。

horizontal とvertical が true に設定されているか false に設定されているかに応じて、水平方向または垂直方向にミラーされた画像のミラーを返します。

元の画像は変更されないことに注意してください。

mirror() およびImage Transformationsも参照 。

すべてのピクセルの赤成分と青成分の値が入れ替わったQImage を返し、RGB画像をBGR画像に効果的に変換します。

元のQImage は変更されない。

rgbSwap() およびImage Transformationsも参照 。

colorSpace およびformat に変換された画像を返す。

画像に有効な色空間がない場合は、NULLQImage が返されます。

指定された画像変換flags は、フォーマット変換処理中に画像データがどのように扱われるかを制御します。

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

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

[noexcept] QImage::QImage()

null 画像を構築します。

isNull()も参照 。

[explicit] QImage::QImage(const char *const[] xpm)

与えられたxpm 画像から画像を構築する。

画像が有効なXPM画像であることを確認してください。エラーは無視されます。

XPM変数を少し絞ることができることに注意してください：

static const char * const start_xpm[] = {
    "16 15 8 1",
    "a c #cec6bd",
    // etc.
};

余分なconst 、定義全体を読み取り専用にすることで、（コードが共有ライブラリにある場合など）少し効率的になり、アプリケーションと一緒にROMに保存できるようになります。

QImage::QImage(const QSize &size, QImage::Format format)

与えられたsize とformat で画像を構築します。

メモリが確保できない場合はnull の画像が返されます。

[explicit] QImage::QImage(const QString &fileName, const char *format = nullptr)

画像を構築し、与えられたfileName のファイルから画像をロードしようとします。

ローダは、指定されたformat を使って画像の読み込みを試みます。format が指定 さ れていない と き （デフ ォ ル ト ） は、 フ ァ イ ルの接尾辞 と ヘ ッ ダに基づいて自動検出 さ れます。詳しくは {QImageReader::setAutoDetectImageFormat()}{QImageReader} を参照。

画像の読み込みに失敗した場合、このオブジェクトはヌル画像となります。

ファイル名は、ディスク上の実際のファイルを指すことも、アプリケーションの組み込みリソースの1つを指すこともできます。アプリケーションの実行ファイルに画像やその他のリソース・ファイルを埋め込む方法の詳細については、リソース・システムの概要を参照してください。

isNull() およびReading and Writing Image Filesも参照してください 。

QImage::QImage(int width, int height, QImage::Format format)

与えられたwidth 、height 、format で画像を構築します。

メモリが確保できない場合はnull の画像が返されます。

QImage::QImage(const uchar *data, int width, int height, QImage::Format format, QImageCleanupFunction cleanupFunction = nullptr, void *cleanupInfo = nullptr)

与えられたwidth 、height 、format を使って、既存の読み取り専用メモリバッファdata を使う画像を構築します。width とheight はピクセル単位で指定し、data は 32 ビットアライメントでなければならず、画像内の各スキャンラインデータも 32 ビットアライメントでなければなりません。

このバッファは、QImageの寿命が尽きるまで有効であり続けなければならず、元のバッファから変更されたり切り離されたりしていないすべてのコピーが有効でなければなりません。画像は破棄時にバッファを削除しません。最後のコピーが破棄されるときに呼び出される関数ポインタcleanupFunction を，追加ポインタcleanupInfo とともに提供することができます．

format がインデックス付きカラーフォーマットの場合、画像のカラーテーブルは初期状態では空であり、画像を使用する前にsetColorCount() またはsetColorTable() で十分に拡張する必要があります。

non const データバッファを受け取る類似の QImage コンストラクタとは異なり、このバージョンはバッファの内容を決して変更しません。たとえば、QImage::bits() を呼び出すと、コンストラクタに渡されたバッファではなく、画像のディープコピーが返されます。これにより、生データが変更される可能性を排除し、生データから QImage を構築する効率性を得ることができます。

QImage::QImage(uchar *data, int width, int height, QImage::Format format, QImageCleanupFunction cleanupFunction = nullptr, void *cleanupInfo = nullptr)

与えられたwidth 、height 、format を使って、既存のメモリバッファdata を使う画像を構築します。width とheight はピクセル単位で指定し、data は 32 ビットアライメントでなければならず、画像内の各スキャンラインデータも 32 ビットアライメントでなければなりません。

このバッファは、QImageの寿命が尽きるまで有効であり続けなければならず、元のバッファから変更されたり切り離されたりしていないすべてのコピーが有効でなければなりません。画像は破棄時にバッファを削除しません。最後のコピーが破棄されるときに呼び出される関数ポインタcleanupFunction を，追加ポインタcleanupInfo とともに提供することができます．

format が イ ンデ ッ ク ス付き カ ラ ーフ ォーマ ッ ト の場合、 画像のカ ラ ーテーブルは初期状態では空であ り 、 画像を使 う 前にsetColorCount （） かsetColorTable （） で十分拡げてお く 必要があ り ます。

QImage::QImage(const uchar *data, int width, int height, qsizetype bytesPerLine, QImage::Format format, QImageCleanupFunction cleanupFunction = nullptr, void *cleanupInfo = nullptr)

指定されたwidth 、height 、format で画像を構築し、既存のメモリバッファdata を使用する。width とheight はピクセル単位で指定しなければなりません。bytesPerLine は1行あたりのバイト数（ストライド）を指定します。

このバッファは，QImage の寿命が尽きるまで，また，元のバッファから変更されたり切り離されたりしていないすべてのコピーに対して，有効であり続けなければなりません．イメージは破棄時にバッファを削除しません。最後のコピーが破棄されたときに呼び出される関数ポインタcleanupFunction を，追加ポインタcleanupInfo とともに提供することができます．

format がインデックス付きカラーフォーマットの場合、画像のカラーテーブルは初期状態では空であり、画像を使用する前にsetColorCount() またはsetColorTable() で十分に拡張する必要があります。

non-const データバッファを受け取る類似の QImage コンストラクタとは異なり、このバージョンはバッファの内容を決して変更しません。たとえば、QImage::bits() を呼び出すと、コンストラクタに渡されたバッファではなく、画像のディープコピーが返されます。これにより、生データが変更される可能性を排除し、生データから QImage を構築する効率を高めることができます。

QImage::QImage(uchar *data, int width, int height, qsizetype bytesPerLine, QImage::Format format, QImageCleanupFunction cleanupFunction = nullptr, void *cleanupInfo = nullptr)

指定されたwidth 、height 、format で画像を構築し、既存のメモリバッファdata を使用する。width とheight はピクセル単位で指定しなければなりません。bytesPerLine は1行あたりのバイト数（ストライド）を指定します。

このバッファは，QImage の寿命が尽きるまで，また，元のバッファから変更されたり切り離されたりしていないすべてのコピーに対して，有効であり続けなければなりません．イメージは破棄時にバッファを削除しません。最後のコピーが破棄されたときに呼び出される関数ポインタcleanupFunction を，追加ポインタcleanupInfo とともに提供することができます．

format が イ ンデ ッ ク ス付き カ ラ ーフ ォーマ ッ ト の場合、 画像のカ ラ ーテーブルは初期状態では空であ り 、 画像を使 う 前にsetColorCount （） かsetColorTable （） で十分拡げてお く 必要があ り ます。

QImage::QImage(const QImage &image)

与えられたimage のシャローコピーを構築する。

シャローコピーの詳細については、暗黙的データ共有のドキュメントを参照ください。

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

[noexcept] QImage::QImage(QImage &&other)

Move-QImageインスタンスを構築し、other が指していたのと同じオブジェクトを指すようにする。

[virtual noexcept] QImage::~QImage()

イメージを破壊し、クリーンアップする。

bool QImage::allGray() const

画像のすべての色がグレーの濃淡である（つまり、赤、緑、青の成分が等しい）場合はtrue を返し、そうでない場合は false を返します。

そうでない場合は false。 この関数は，色テーブルを持たない画像に対しては遅いことに注意してください。

isGrayscale()も参照 。

void QImage::applyColorTransform(const QColorTransform &transform)

画像のすべてのピクセルに色変換transform を適用する。

[since 6.8] void QImage::applyColorTransform(const QColorTransform &transform, QImage::Format toFormat, Qt::ImageConversionFlags flags = Qt::AutoColor)

画像のすべてのピクセルに色変換transform を適用し、画像のフォーマットをtoFormat に変換します。

指定された画像変換flags は、フォーマット変換処理中に画像データがどのように扱われるかを制御します。

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

int QImage::bitPlaneCount() const

画像のビットプレーン数を返す。

ビットプレーン数とは、各ピクセルの色情報と透明度情報のビット数である。これは、画像フォーマットに未使用ビットが含まれている場合の深度とは異なります（つまり、深度よりも小さくなります）。

depth(),format(),Image Formatsも参照 。

uchar *QImage::bits()

最初のピクセルデータへのポインタを返す。これはscanLine(0) と等価である。

QImage は暗黙のデータ共有を使っていることに注意。この関数は、共有ピクセルデータのディープコピーを実行するため、このQImage が現在の戻り値を使用する唯一のものであることを保証する。

scanLine()、sizeInBytes()、constBits()も参照 。

const uchar *QImage::bits() const

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

QImage は暗黙的なデータ共有を使っているが、返されるデータは const なので、この関数は共有ピクセルデータのディープコピーを行わないことに注意。

qsizetype QImage::bytesPerLine() const

画像の走査線あたりのバイト数を返す。

これは、height() がゼロでない場合、sizeInBytes() /height() と等価である。

scanLine()も参照 。

qint64 QImage::cacheKey() const

このQImage オブジェクトのコンテンツを識別する番号を返します。異なるQImage オブジェクトが同じキーを持つことができるのは、それらが同じコンテンツを参照している場合のみです。

キーは、画像が変更されたときに変更されます。

QRgb QImage::color(int i) const

カラーテーブルのインデックスi にある色を返す。最初の色はインデックス 0 です。

画像のカラーテーブルの色は、ARGB の四分値 (QRgb) として指定されます。色値の構成要素を取得するには、qAlpha(),qRed(),qGreen(),qBlue() 関数を使用します。

setColor(),pixelIndex(),Pixel Manipulationも参照 。

int QImage::colorCount() const

画像のカラーテーブルのサイズを返します。

32-bpp 画像の場合、 colorCount() は 0 を返す こ と に注意 し て く だ さ い。 こ れは、 こ れ ら の画像はカ ラ ーテーブルを使わず、 ピ ク セル値を ARGB 4 分割子 と し てエン コ ー ド し てい る か ら です。

setColorCount() およびImage Informationも参照 。

QColorSpace QImage::colorSpace() const

色空間が定義されている場合に、画像の色空間を返します。

setColorSpace()も参照 ください。

QList<QRgb> QImage::colorTable() const

画像のカラーテーブルに含まれる色のリストを返します。 画像にカラーテーブルがない場合は空のリストを返します。

setColorTable()、colorCount() およびcolor()も参照 ください。

[since 6.4] QImage QImage::colorTransformed(const QColorTransform &transform) const &

画像の全ピクセルをtransform で色変換した画像を返します。

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

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

[since 6.8] QImage QImage::colorTransformed(const QColorTransform &transform, QImage::Format toFormat, Qt::ImageConversionFlags flags = Qt::AutoColor) const &

画像の全ピクセルをtransform で色変換し、toFormat 形式の画像を返します。

指定された画像変換flags は、フォーマット変換処理中に画像データがどのように扱われるかを制御します。

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

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

[since 6.4] QImage QImage::colorTransformed(const QColorTransform &transform) &&

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

画像内のすべてのピクセルに対してtransform を使って変換された画像の色を返します。

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

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

[since 6.8] QImage QImage::colorTransformed(const QColorTransform &transform, QImage::Format format, Qt::ImageConversionFlags flags = Qt::AutoColor) &&

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

画像内のすべてのピクセルに対してtransform を使って変換された画像の色を返します。

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

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

const uchar *QImage::constBits() const

最初のピクセルデータへのポインタを返す。

QImage は暗黙的なデータ共有を使っているが、返されるデータは const なので、この関数は共有ピクセルデータのディープコピーを行わないことに注意。

bits() およびconstScanLine()も参照 。

const uchar *QImage::constScanLine(int i) const

インデックスi のスキャンラインのピクセルデータへのポインタを返す。最初のスキャンラインはインデックス0である。

スキャンラインデータは最小32ビットアラインメントである。64ビットフォーマットでは、64ビット整数のネイティブアライメントに従います（ほとんどのプラットフォームでは64ビットですが、特にi386では32ビットです）。

QImage は暗黙のデータ共有を使っているが、返されるデータは const なので、この関数は共有ピクセルデータのディープコピーを行わないことに注意。

scanLine() およびconstBits()も参照 。

void QImage::convertTo(QImage::Format format, Qt::ImageConversionFlags flags = Qt::AutoColor)

画像を，与えられたformat の場所に変換し，必要なら切り離す。

指定された画像変換flags は，変換処理中に画像データがどのように扱われるかを制御します。

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

void QImage::convertToColorSpace(const QColorSpace &colorSpace)

画像をcolorSpace に変換します。

画像に有効な色空間がない場合、このメソッドは何もしません。

convertedToColorSpace() およびsetColorSpace()も参照 。

[since 6.8] void QImage::convertToColorSpace(const QColorSpace &colorSpace, QImage::Format format, Qt::ImageConversionFlags flags = Qt::AutoColor)

画像をcolorSpace とformat に変換します。

画像に有効な色空間がない場合、このメソッドは何もせず、色空間がフォーマットと互換性がない場合も何もしません。

指定された画像変換flags は、フォーマット変換処理中に画像データがどのように扱われるかを制御します。

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

convertedToColorSpace() およびsetColorSpace()も参照してください 。

QImage QImage::convertToFormat(QImage::Format format, const QList<QRgb> &colorTable, Qt::ImageConversionFlags flags = Qt::AutoColor) const

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

指定されたcolorTable を用いて，与えられたformat に変換された画像のコピーを返します。

RGBフォーマットからインデックス付きフォーマットへの変換は遅い処理であり、ディザリングは行わず、単純な最近接色アプローチを使用します。

QImage QImage::convertedToColorSpace(const QColorSpace &colorSpace) const

colorSpace に変換した画像を返す。

画像に有効な色空間がない場合は、NULLQImage が返されます。

convertToColorSpace() およびcolorTransformed()も参照 。

QImage QImage::copy(const QRect &rectangle = QRect()) const

画像のサブ領域を新しい画像として返します。

返 さ れ る 画像は、 こ の画像内の位置 （rectangle.x(),rectangle.y() ）か ら コ ピー さ れ、 与え ら れたrectangle のサ イ ズ を必ず持ち ます。

Qt::color032 ビット RGB 画像の場合、 こ れは黒を意味 し 、 32 ビ ッ ト ARGB 画像の場合、 こ れは透過な黒を意味 し ます。 8 ビ ッ ト 画像の場合、 こ れはカ ラ ーテーブルの添字 0 の色を意味 し 、 何であってもかまいません。

与えられたrectangle がヌル矩形の場合，画像全体がコピーされます。

QImage （）も参照してください 。

QImage QImage::copy(int x, int y, int width, int height) const

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

返される画像は、この画像内の位置 (x,y) からコピーされ、常に与えられたwidth とheight を持ちます。 この画像を超える領域では、ピクセルは 0 に設定されます。

QImage QImage::createAlphaMask(Qt::ImageConversionFlags flags = Qt::AutoColor) const

この画像のアルファバッファから 1-bpp マスクを構築して返します。画像のフォーマットがQImage::Format_RGB32 の場合、NULL 画像を返します。

引数flags は、Qt::ImageConversionFlags のビット OR であり、変換処理を制御します。flags に 0 を渡すと，すべてのデフォルトオプションが設定されます。

返される画像のビット順序はリトルエンディアン（つまり、画像のフォーマットはQImage::Format_MonoLSB ）です。convertToFormat （）関数を使うことで、ビッグエンディアン（QImage::Format_Mono ）に変換することができます。

createHeuristicMask() およびImage Transformationsも参照して ください。

QImage QImage::createHeuristicMask(bool clipTight = true) const

この画像に対して1-bppのヒューリスティックマスクを作成して返します。

この関数は，四隅の1つから色を選択し，その色のピクセルをすべての辺から削っていきます．4つの角は、どの色をマスクするか投票する。引き分け（これは一般に、この関数が画像に適用できないことを意味する）の場合、結果は任意である。

返 さ れ る 画像のビ ッ ト 順序は リ ト ルエンデ ィ ア ンです （すなわち、 画像のフォーマ ッ ト はQImage::Format_MonoLSB ）。convertToFormat （）関数を使っ て、 ビ ッ グエンデ ィ ア ン （QImage::Format_Mono ）に変換す る こ と がで き ます。

clipTight が true の場合（デフォルト）、マスクはピクセルをカバーするのに十分な大きさになります。

この関数はアルファバッファを無視することに注意。

createAlphaMask() およびImage Transformationsも参照のこと 。

QImage QImage::createMaskFromColor(QRgb color, Qt::MaskMode mode = Qt::MaskInColor) const

与えられたcolor の値に基づいて、この画像のマスクを作成して返します。mode が MaskInColor （デフォルト値）の場合、color にマッチするすべてのピクセルがマスク内の不透明ピクセルになります。mode が MaskOutColor の場合，与えられた色にマッチするすべてのピクセルは透明になります。

createAlphaMask() およびcreateHeuristicMask()も参照 。

int QImage::depth() const

画像の深度を返します。

画像の深度とは、1つのピクセルを格納するのに使われるビット数のことで、bpp（bits per pixel）とも呼ばれます。

サポートされる深度は、1、8、16、24、32、64 です。

bitPlaneCount()、convertToFormat()、Image Formats 、およびImage Informationも参照 。

[since 6.2] QSizeF QImage::deviceIndependentSize() const

デバイス非依存のピクセル単位で画像のサイズを返します。

この値は、ユーザーインターフェイスのサイズ計算で画像サイズを使用するときに使用する必要があります。

戻り値は image.size() / image.devicePixelRatio() と等価です。

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

qreal QImage::devicePixelRatio() const

device pixel ratio 画像のデバイスピクセル比率を返します。こ れは、デバ イ ス ピ ク セルとデバ イ ス独立ピ ク セルの比率です。

この関数は、画像サイズに基づいてレイアウトのジオメトリを計算するときに使用します。QSize layoutSize = image.size() / image.devicePixelRatio()

デフ ォル ト 値は 1.0 です。

setDevicePixelRatio() およびQImageReaderも参照 。

int QImage::dotsPerMeterX() const

物理メータに水平に収まるピクセル数を返す。dotsPerMeterY() とともに、この数値は、画像の意図するスケールとアスペクト比を定義する。

setDotsPerMeterX() およびImage Informationも参照 。

int QImage::dotsPerMeterY() const

物理メータに縦に収まるピクセル数を返す。dotsPerMeterX() とともに、この数値は画像の意図するスケールとアスペクト比を定義する。

setDotsPerMeterY() およびImage Informationも参照 。

void QImage::fill(uint pixelValue)

画像全体を，与えられたpixelValue で埋めます。

この画像の深度が1の場合、最下位ビットのみが使用される。fill(0)、fill(2) などと指定すると、画像は 0 で塗りつぶされる。fill(1)、fill(3) などとすると、画像は 1 で塗りつぶされる。深度が8の場合、最下位の8ビットが使用され、深度が16の場合、最下位の16ビットが使用される。

画像の深度が32ビットより大きい場合、結果は未定義である。

depth() およびImage Transformationsも参照 。

void QImage::fill(Qt::GlobalColor color)

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

与えられたcolor で画像を塗りつぶします。

void QImage::fill(const QColor &color)

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

画像全体を，与えられたcolor で埋めます。

画像の深度が 1 の場合，color がQt::color1 と等しければ，画像は 1 で塗りつぶされます； そうでなければ 0 で塗りつぶされます。

画像の深度が 8 の場合，カラーテーブルcolor が存在すれば，それに対応するインデックスで塗りつぶされます．

QImage::Format QImage::format() const

画像のフォーマットを返します。

Image Formatsも参照ください 。

[static, since 6.2] QImage QImage::fromData(QByteArrayView data, const char *format = nullptr)

与えられたQByteArrayView data から画像を構築する。ローダーは、指定されたformat を使って画像の読み込みを試みます。format が指定されていない場合 (デフォルト)、ローダーはファイル形式を推測するためのヘッダーをデータから探します。

format が指定された場合、QImageReader::supportedImageFormats() が返す値のいずれかでなければならない。

画像の読み込みに失敗した場合、返される画像はヌル画像になります。

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

load()、save()、Reading and Writing Image Filesも参照してください 。

[static] QImage QImage::fromData(const QByteArray &data, const char *format = nullptr)

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

与えられたQByteArray data からQImage を構築する。

[static] QImage QImage::fromData(const uchar *data, int size, const char *format = nullptr)

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

与えられたバイナリdata の最初のsize バイトからQImage を構築する。

[static, since 6.0] QImage QImage::fromHBITMAP(HBITMAP hbitmap)

与えられたhbitmap と等価なQImage を返す。

HBITMAP はアルファチャンネルに関する情報を保存しません。

標準的な場合、アルファチャンネルは無視され、完全に不透明な画像が作成されます（通常、QImage::Format_RGB32 の形式）。

しかし、アプリケーションアイコンやシストレイアイコンなど、アルファチャンネルを使用する場合もあります。その場合、reinterpretAsFormat(QImage::Format_ARGB32) を呼び出して、返される画像のフォーマットが正しいことを確認する必要があります。

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

toHBITMAP() およびreinterpretAsFormat()も参照してください 。

[static, since 6.0] QImage QImage::fromHICON(HICON icon)

与えられたicon と等価なQImage を返します。

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

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

bool QImage::hasAlphaChannel() const

画像がアルフ ァ チ ャ ン ネルを尊重 し た形式であ る と き はtrue を返し、 そ う でなければfalse を返します。

Image Informationも参照してください 。

int QImage::height() const

画像の高さを返します。

Image Informationも参照ください 。

void QImage::invertPixels(QImage::InvertMode mode = InvertRgb)

画像のすべてのピクセル値を反転します。

与えられた invertmode は、画像の深度が 32 のときのみ意味を持ちます。デフォルトのmode はInvertRgb で、 アルファチャンネルは変更されません。mode がInvertRgba の場合、 アルフ ァ ビ ッ ト も 反転 さ れます。

8 ビ ッ ト 画像を反転 さ せ る と い う こ と は、 色インデ ッ ク スiを用い る すべての画素を、 色イ ンデ ッ ク ス 255 からi を引いた画素で置き換えることを意味します。カラーテーブルは変更されないことに注意。

アルフ ァ チ ャ ン ネルが事前に乗算 さ れてい る 画像の場合、 その画像はまず、 乗算 さ れていない画像形式に変換 さ れて反転 さ れ、 そ し て再び変換 さ れます。

Image Transformationsも参照 。

bool QImage::isGrayscale() const

32 ビ ッ ト 画像の場合、 こ の関数はallGray （） と 等価です。

カラーインデックス付き画像の場合，この関数は，カラーテーブルのすべてのインデックスに対して color(i) がQRgb(i, i, i) であればtrue を返し，そうでなければfalse を返します．

allGray() およびImage Formatsも参照 。

bool QImage::isNull() const

ヌル画像の場合はtrue を返し、そうでない場合はfalse を返す。

ヌル画像は、すべてのパラメータがゼロに設定され、割り当てられたデータはありません。

bool QImage::load(const QString &fileName, const char *format = nullptr)

与えられたfileName のファイルから画像を読み込みます。画像の読み込みに成功した場合はtrue を返し、失敗した場合は画像を無効にしてfalse を返します。

ローダーは、指定されたformat （PNG や JPG など）を使って画像の読み込みを試みます。format が指定されていない場合（デフォルト）、ファイルの接尾辞とヘッダーから自動検出される。詳細については、QImageReader::setAutoDetectImageFormat()を参照のこと。

ファイル名は、ディスク上の実際のファイル、またはアプリケーションの組み込みリソースのいずれかを参照することができます。アプリケーションの実行ファイルに画像やその他のリソース・ファイルを埋め込む方法の詳細については、リソース・システムの概要を参照してください。

Reading and Writing Image Filesも参照してください 。

bool QImage::load(QIODevice *device, const char *format)

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

この関数は、与えられたdevice からQImage を読み込みます。これは例えば、画像をQByteArray に直接読み込むために使用することができます。

[since 6.2] bool QImage::loadFromData(QByteArrayView data, const char *format = nullptr)

与えられたQByteArrayView data から画像を読み込みます。画像の読み込みに成功した場合はtrue を返し、失敗した場合は画像を無効にしてfalse を返します。

ローダーは、指定されたformat （PNGやJPGなど）を使って画像の読み込みを試みます。format が指定されていない場合（デフォルト）、ローダーはファイル形式を推測するためにファイルにヘッダーをプローブします。

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

Reading and Writing Image Filesも参照してください 。

bool QImage::loadFromData(const QByteArray &data, const char *format = nullptr)

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

与えられたQByteArray data から画像を読み込みます。

bool QImage::loadFromData(const uchar *data, int len, const char *format = nullptr)

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

与えられたバイナリdata の最初のlen バイトから画像を読み込みます。

[since 6.0] void QImage::mirror(bool horizontal = false, bool vertical = true)

horizontal とvertical が true に設定されているか false に設定されているかに応じて、水平方向と垂直方向に画像をミラーします。

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

mirrored() およびImage Transformationsも参照してください 。

QPoint QImage::offset() const

他の画像との相対位置合わせの際に、 画像がオフセットされるピクセル数を返します。

setOffset() およびImage Informationも参照 。

QRgb QImage::pixel(const QPoint &position) const

与えられたposition のピクセルの色を返す。

position が有効でない場合、結果は未定義である。

setPixel(),valid(),constBits(),constScanLine(),Pixel Manipulationも参照 。

QRgb QImage::pixel(int x, int y) const

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

座標 (x,y) にあるピクセルの色を返す。

QColor QImage::pixelColor(const QPoint &position) const

与えられたposition のピクセルの色をQColor として返す。

position が有効でない場合、無効なQColor が返される。

setPixelColor()、setPixel()、valid()、constBits()、constScanLine()、Pixel Manipulationも参照 。

QColor QImage::pixelColor(int x, int y) const

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

座標 (x,y) にあるピクセルの色をQColor として返します。

[noexcept] QPixelFormat QImage::pixelFormat() const

QImage::Format をQPixelFormat

int QImage::pixelIndex(const QPoint &position) const

与えられたposition のピクセルインデックスを返す。

position が有効でない場合、あるいは画像がパレット画像でない場合 (depth() > 8)、結果は未定義。

valid(),depth(),Pixel Manipulationも参照 。

int QImage::pixelIndex(int x, int y) const

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

(x,y) におけるピクセルインデックスを返す。

QRect QImage::rect() const

画像を囲む矩形 (0, 0,width(),height()) を返します。

Image Informationも参照してください ．

bool QImage::reinterpretAsFormat(QImage::Format format)

データを変更せずに画像のフォーマットをformat に変更します。同じ深さのフォーマット間でのみ動作します。

成功した場合はtrue を返します。

この関数は、データが不透明のみであることがわかっている場合に、 アルファチャンネルを持つ画像を対応する不透明なフォーマットに変更したり、 新しいデータで上書きする前に、与えられた画像バッファのフォーマットを変更したりするために使うことができます。

hasAlphaChannel() およびconvertToFormat()も参照 。

[since 6.0] void QImage::rgbSwap()

すべてのピクセルの赤成分と青成分の値を入れ替え、RGB画像をBGR画像に効果的に変換します。

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

rgbSwapped() およびImage Transformationsも参照してください 。

bool QImage::save(const QString &fileName, const char *format = nullptr, int quality = -1) const

指定された画像ファイルformat とquality の要素を用いて、指定されたfileName のファイルに画像を保存します。format がnullptr の場合、QImage はfileName の接尾辞からフォーマットを推測します。

quality 係数は 0 から 100 または -1 の範囲でなければならない。小さな圧縮ファイルを得るには0を、大きな非圧縮ファイルを得るには100を、 デフォルト設定を使うには-1（デフォルト）を指定する。

画像の保存に成功した場合はtrue を返し、失敗した場合はfalse を返す。

Reading and Writing Image Filesも参照のこと 。

bool QImage::save(QIODevice *device, const char *format = nullptr, int quality = -1) const

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

この関数は、与えられたdevice にQImage を書き込む。

これは例えば、画像をQByteArray に直接保存するために使用できます：

QImage image;
QByteArray ba;
QBuffer buffer(&ba);
buffer.open(QIODevice::WriteOnly);
image.save(&buffer, "PNG"); // writes image into ba in PNG format

QImage QImage::scaled(const QSize &size, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio, Qt::TransformationMode transformMode = Qt::FastTransformation) const

与えられたaspectRatioMode とtransformMode に従って、与えられたsize で定義された矩形に拡大縮小された画像のコピーを返します。

• aspectRatioMode がQt::IgnoreAspectRatio の場合，画像はsize に拡大縮小されます．
• aspectRatioMode がQt::KeepAspectRatio の場合，画像はsize 内のできるだけ大きな矩形に，縦横比を保ったまま拡大縮小される。
• aspectRatioMode がQt::KeepAspectRatioByExpanding の場合，画像はsize の外側の，縦横比を保ったまま可能な限り小さな矩形に拡大縮小されます。

与えられたsize が空の場合，この関数は null 画像を返します。

isNull() およびImage Transformationsも参照してください 。

QImage QImage::scaled(int width, int height, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio, Qt::TransformationMode transformMode = Qt::FastTransformation) const

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

与えられたwidth とheight を，与えられたaspectRatioMode とtransformMode に従って矩形にスケーリングした画像のコピーを返します。

width またはheight のいずれかが 0 または負の場合，この関数は null 画像を返します．

QImage QImage::scaledToHeight(int height, Qt::TransformationMode mode = Qt::FastTransformation) const

画像のスケーリングされたコピーを返します。返された画像は，指定された変換mode を用いて，与えられたheight に拡大縮小されます。

この関数は，画像の比率が保たれるように，画像の幅を自動的に計算します。

与えられたheight が0または負の場合，NULL画像が返されます。

Image Transformationsも参照してください 。

QImage QImage::scaledToWidth(int width, Qt::TransformationMode mode = Qt::FastTransformation) const

画像のスケーリングされたコピーを返します。返された画像は，指定された変換mode を用いて，与えられたwidth に拡大縮小されます。

この関数は，縦横比が保たれるように画像の高さを自動的に計算します。

与えられたwidth が 0 または負の場合，NULL画像が返されます。

Image Transformationsも参照してください 。

uchar *QImage::scanLine(int i)

インデックスi のスキャンラインのピクセルデータへのポインタを返す。最初のスキャンラインはインデックス0である。

スキャンラインデータは最小32ビットアラインメントである。64ビットフォーマットでは、64ビット整数のネイティブアライメントに従います（ほとんどのプラットフォームでは64ビットですが、特にi386では32ビットです）。

例えば、画像の各ピクセルの緑成分を除去する：

for (int y = 0; y < image.height(); ++y) {
    QRgb *line = reinterpret_cast<QRgb*>(image.scanLine(y));
    for (int x = 0; x < image.width(); ++x) {
        QRgb &rgb = line[x];
        rgb = qRgba(qRed(rgb), qGreen(0), qBlue(rgb), qAlpha(rgb));
    }
}

bytesPerLine()、bits()、Pixel Manipulation 、およびconstScanLine()も参照 。

const uchar *QImage::scanLine(int i) const

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

void QImage::setAlphaChannel(const QImage &alphaChannel)

この画像のアルファチャンネルを、与えられたalphaChannel に設定します。

alphaChannel が8ビットのアルファ画像の場合は、アルファ値が直接使われます。そうでない場合は，alphaChannel が8ビットグレースケールに変換され，ピクセル値の強度が使われます。

画像にすでにアルファチャンネルがある場合は、 既存のアルファチャンネルと新しいアルファチャンネルが掛け合わされます。画像にアルファチャンネルがない場合は、アルファチャンネルがある形式に変換されます。

この操作は、QPainter::CompositionMode_DestinationIn を使ってこの画像の上にalphaChannel をアルファ画像として描くのと似ています。

hasAlphaChannel()、Image Transformations 、Image Formatsも参照 。

void QImage::setColor(int index, QRgb colorValue)

カラーテーブルの指定されたindex の色を、指定されたcolorValue に設定します。 色の値は ARGB の 4 値です。

index がカラーテーブルの現在のサイズの外側にある場合は、setColorCount() で展開される。

color()、colorCount()、setColorTable()、Pixel Manipulationも参照のこと 。

void QImage::setColorCount(int colorCount)

カラーテーブルをリサイズしてcolorCount エントリを含むようにします。

カ ラ ーテーブルが拡張 さ れる と 、 余分な色はすべて透過に設定 さ れます （すなわちqRgba(0, 0, 0, 0)）。

画像を使 う と きは、 カ ラ ーテーブルは、 画像内に存在す る すべての ピ ク セル / イ ンデ ッ ク ス値の項目を持つに足 る 十分な大き さ を持つ必要があ り ます。

colorCount(),colorTable(),setColor(),Image Transformationsも参照 。

void QImage::setColorSpace(const QColorSpace &colorSpace)

画像デー タ を一切変換せずに、 画像色空間をcolorSpace に設定する。

colorSpace()も参照 。

void QImage::setColorTable(const QList<QRgb> &colors)

色イ ンデ ッ ク ス をQRgb 値へ変換する ために用い ら れる カ ラ ーテーブルを、 指定 し たcolors へ設定 し ます。

画像を使用する場合、カラーテーブルは、画像に存在するすべてのピクセル/インデックス値のエントリを持つのに十分な大きさでなければなりません。

colorTable()、setColor()、Image Transformationsも参照 。

void QImage::setDevicePixelRatio(qreal scaleFactor)

画像のデバイスピクセル比を設定する。これは画像のピクセルとデバイスに依存しないピクセルの比率です。

デフォルトのscaleFactor は 1.0 です。これを他の値に設定すると、2つの影響があります：

画像上で開かれたQPainterは拡大縮小されます。例えば、200x200 の画像に 2.0 の比率でペイントすると、有効な（デバイスに依存しない）ペイント境界は 100x100 になります。

QSize layoutSize = image.size() / image.devicePixelRatio() この正味の効果は、画像が大きな画像ではなく、高DPI画像として表示されることです（Drawing High Resolution Versions of Pixmaps and Images を参照）。

devicePixelRatio() およびdeviceIndependentSize()も参照して ください。

void QImage::setDotsPerMeterX(int x)

物理メータに水平に収まるピクセル数をx に設定する。

dotsPerMeterY() と共に、この数値は画像の意図されたスケールとアスペクト比を定義し、QPainter が画像にグラフィックを描画する際のスケールを決定します。この数値は、他の描画デバイスで描画されるときの画像の縮尺や縦横比を変更するものではありません。

dotsPerMeterX() およびImage Informationも参照して ください。

void QImage::setDotsPerMeterY(int y)

物理メータに縦に収まるピクセル数をy に設定する。

dotsPerMeterX() とともに、この数値は画像の意図されたスケールとアスペクト比を定義し、QPainter が画像にグラフィックを描画する際のスケールを決定します。この数値は、他の描画デバイスで描画されるときの画像の縮尺や縦横比を変更するものではありません。

dotsPerMeterY() およびImage Informationも参照して ください。

void QImage::setOffset(const QPoint &offset)

他の画像 と の相対的な位置合わせを行 う 際に、 画像を何 ピ ク セルず ら し たいかを設定 し ます （offset ）。

offset() およびImage Informationも参照してください 。

void QImage::setPixel(const QPoint &position, uint index_or_rgb)

与えられたposition のピクセルインデックスまたは色をindex_or_rgb に設定します。

画像のフ ォーマ ッ ト がモノクロかパレ ッ ト の場合、 与えられたindex_or_rgb の値は、 画像の色テーブルのインデックスでなければな り ません。 それ以外の場合、 引数はQRgb の値でなければな り ません。

position が画像内で有効な座標対でない場合、 またはモノクロ画像やパレット画像の場合にindex_or_rgb >=colorCount （） である場合、 結果は不定です。

pixel() およびPixel Manipulationも参照のこと 。

void QImage::setPixel(int x, int y, uint index_or_rgb)

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

(x,y) のピクセルインデックスまたは色をindex_or_rgb に設定します。

void QImage::setPixelColor(const QPoint &position, const QColor &color)

与えられたposition の色をcolor に設定します。

position が画像内で有効な座標ペアでない場合、 あるいは画像のフォーマットがモノクロかパレット形式である場合、 結果は未定義です。

pixelColor()、pixel()、bits()、scanLine()、Pixel Manipulationも参照 。

void QImage::setPixelColor(int x, int y, const QColor &color)

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

(x,y) のピクセルの色をcolor に設定します。

void QImage::setText(const QString &key, const QString &text)

画像テキストを与えられたtext に設定し、それを与えられたkey に関連付けます。

単一のテキストブロック（つまり「コメント」や単なる説明文）を保存したいだけの場合は、空のキーを渡すか、「Description」のような汎用キーを使用します。

save() やQImageWriter::write() を呼び出すと、画像テキストが画像データに埋め込まれます。

すべての画像フォーマットが埋め込みテキストをサポートしているわけではありません。特定の画像やフォーマットがテキストの埋め込みに対応しているかどうかは、QImageWriter::supportsOption() を使って調べることができます。例を挙げます：

    QImageWriterwriter; writer.setFormat("png");if(writer.supportsOption(QImageIOHandler::Description))        qDebug() << "Png supports embedded text";

QImageWriter::supportedImageFormats() を使えば、利用可能な画像フォーマットを調べることができる。

text() およびtextKeys()も参照 。

QSize QImage::size() const

画像のサイズ、すなわちwidth() およびheight() を返す。

Image Information およびdeviceIndependentSize()も参照 。

qsizetype QImage::sizeInBytes() const

画像データのサイズをバイト単位で返す。

bytesPerLine()、bits() およびImage Informationも参照 。

[noexcept] void QImage::swap(QImage &other)

この画像をother と入れ替える。この操作は非常に速く、失敗することはない。

QString QImage::text(const QString &key = QString()) const

与えられたkey に関連付けられた画像テキストを返します。指定されたkey が空文字列の場合、画像テキスト全体が返され、各キーテキスト対は改行で区切られます。

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

QStringList QImage::textKeys() const

この画像のテキストキーを返します。

これらのキーをtext() と組み合わせて使用すると、 指定したキーの画像テキストを一覧表示することができます。

text()も参照 ください。

CGImageRef QImage::toCGImage() const

このQImage と同等のCGImage を作成し、CGImageRef ハンドルを返す。

返された CGImageRef はQImage の暗黙の共有に参加し、QImage データへの参照を保持する。CGImageは不変であり、QImage をデタッチすることはない。QImage への書き込みは通常通りデタッチされる。

この関数は高速で、画像データをコピーしたり変換したりしません。

以下の画像フォーマットがサポートされており、対応するネイティブ画像タイプにマッピングされます：

その他のフォーマットはサポートされていません。この関数はそのような場合に null CGImageRef を返します。この関数のユーザは、Format_ARGB32_Premultiplied のように、QImage をサポートされている形式に変換することができます。

CGImageRef の色空間は sRGB 色空間に設定されます。

[since 6.0] HBITMAP QImage::toHBITMAP() const

QImage に相当するHBITMAP を作成する。

HBITMAP ハンドルを返す。

使用後にHBITMAP データを解放するのは呼び出し側の責任である。

BitBlt() のような標準的な GDI 呼び出しで使用する場合、画像はQImage::Format_RGB32 の形式でなければなりません。

結果のHBITMAPをAlphaBlend() GDI関数に使用する場合、画像はQImage::Format_ARGB32_Premultiplied （convertToFormat （）を使用）の形式でなければなりません。

結果のHBITMAPをアプリケーションアイコンやシストレイアイコンとして使用する場合、画像はQImage::Format_ARGB32 のフォーマットでなければなりません。

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

fromHBITMAP() およびconvertToFormat()も参照してください 。

[since 6.0] HICON QImage::toHICON(const QImage &mask = {}) const

QPixmap のHICON 相当を作成し、マスクmask を適用する。

mask が NULL でない場合、QImage::Format_Mono の形式である必要がある。HICON ハンドルを返す。

使用後にHICON データを解放するのは呼び出し側の責任です。

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

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

[static noexcept] QImage::Format QImage::toImageFormat(QPixelFormat format)

format をQImage::Format

[static noexcept] QPixelFormat QImage::toPixelFormat(QImage::Format format)

format をQPixelFormat

QImage QImage::transformed(const QTransform &matrix, Qt::TransformationMode mode = Qt::FastTransformation) const

与えられた変換matrix と変換mode を使って変換された画像のコピーを返します。

返される画像は通常，元画像と同じ {Image Formats}{format} を持ちます。し か し 、 複雑な変換を行 う と 、 すべての画素が元画像の変換後の画素で覆われていない画像になる場合があります。こ の よ う な場合、 背景の ピ ク セルには透過色が割 り 当て ら れ、 変換後の画像には、 元の画像にアルフ ァ チ ャ ネルがない と し て も 、 アルフ ァ チ ャ ネルを持つ形式が与え ら れます。

matrix すなわち、生成される画像は、元画像のすべての変換点を含む最小の画像となります。画像の変換に使われる実際の行列を取得するには、trueMatrix() 関数を使います。

他のオーバーロードとは異なり，この関数は，画像に対して透視変換を行うことができます．

trueMatrix() およびImage Transformationsも参照して ください。

[static] QTransform QImage::trueMatrix(const QTransform &matrix, int width, int height)

与えられたwidth,height およびmatrix を用いて画像を変換する際に用いられる実際の行列を返します．

transformedすなわち，transformed （）は，元画像のすべての変換点を含む最小の画像を返します．この関数は，元画像の点を新しい画像に正しく写すように修正された行列を返します．

他のオーバーロードとは異なり，この関数は，画像に対して透視変換を行うための変換行列を作成します．

transformed() およびImage Transformationsも参照して ください．

bool QImage::valid(const QPoint &pos) const

pos が画像内で有効な座標ペアである場合はtrue を返し、 そうでない場合はfalse を返す。

rect() およびQRect::contains()も参照 。

bool QImage::valid(int x, int y) const

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

QPoint(x,y) が画像内で有効な座標ペアである場合はtrue を返し、 そうでない場合はfalse を返します。

int QImage::width() const

画像の幅を返します。

Image Informationも参照ください 。

QVariant QImage::operator QVariant() const

画像をQVariant として返します。

bool QImage::operator!=(const QImage &image) const

この画像と与えられたimage の内容が異なっていればtrue を返し、そうでなければfalse を返す。

幅が異なるなど、明らかな違いがある場合を除き、比較には時間がかかります。

operator=()も参照 。

[noexcept] QImage &QImage::operator=(QImage &&other)

Move-other をこのQImage インスタンスに割り当てる。

QImage &QImage::operator=(const QImage &image)

与えられたimage のシャローコピーをこの画像に割り当て、この画像への参照を返します。

シャローコピーの詳細については、暗黙的データ共有のドキュメントを参照してください。

copy() およびQImage()も参照 ください。

bool QImage::operator==(const QImage &image) const

この画像と与えられたimage の内容が同じであればtrue を返し、そうでなければfalse を返します。

比較には時間がかかりますが、明らかな違い（サイズや形式が異なるなど）がある場合は、この関数はすぐに結果を返します。

operator=()も参照 。