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 4 値 （QRgb ） と し て指定 さ れます。色値の構成要素を取得するには、qAlpha(),qRed(),qGreen(),qBlue() 関数を使用します。

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

int QImage::colorCount() const

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

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

size： 画像のサイズを、デバイスに依存しないピクセル単位で返します。

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

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

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

qreal QImage::devicePixelRatio() const

画像のデバイスピクセル比率を返します。これはデバイスピクセルと デバイス非依存ピクセルの比率です。

この関数は、画像サイズに基づいてレイアウトのジオメトリを計算するときに使用します。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)

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

与えられた反転mode は、画像の深度が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 を返す．

null 画像は，すべてのパラメータが 0 に設定され，割り当てられているデータもありません．

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() を使って調べることができます。例を挙げましょう：

    QImageWriter writer;
    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=()も参照 。