BITMAPV5HEADER構造体 (wingdi.h)

BITMAPV5HEADER構造体は、ビットマップ情報ヘッダー ファイルです。 BITMAPINFOHEADER 構造体の拡張バージョンです。

構文

typedef struct {
  DWORD        bV5Size;
  LONG         bV5Width;
  LONG         bV5Height;
  WORD         bV5Planes;
  WORD         bV5BitCount;
  DWORD        bV5Compression;
  DWORD        bV5SizeImage;
  LONG         bV5XPelsPerMeter;
  LONG         bV5YPelsPerMeter;
  DWORD        bV5ClrUsed;
  DWORD        bV5ClrImportant;
  DWORD        bV5RedMask;
  DWORD        bV5GreenMask;
  DWORD        bV5BlueMask;
  DWORD        bV5AlphaMask;
  DWORD        bV5CSType;
  CIEXYZTRIPLE bV5Endpoints;
  DWORD        bV5GammaRed;
  DWORD        bV5GammaGreen;
  DWORD        bV5GammaBlue;
  DWORD        bV5Intent;
  DWORD        bV5ProfileData;
  DWORD        bV5ProfileSize;
  DWORD        bV5Reserved;
} BITMAPV5HEADER, *LPBITMAPV5HEADER, *PBITMAPV5HEADER;

メンバー

bV5Size

構造体に必要なバイト数。 アプリケーションでは、このメンバーを使用して、使用されているビットマップ情報ヘッダー構造を決定する必要があります。

bV5Width

ビットマップの幅 (ピクセル単位)。

bV5Compression がBI_JPEGまたはBI_PNG場合、bV5Width メンバーは圧縮解除された JPEG または PNG イメージの幅をピクセル単位で指定します。

bV5Height

ビットマップの高さ (ピクセル単位)。 bV5Height の値が正の場合、ビットマップはボトムアップ DIB になり、原点は左下隅になります。 bV5Height 値が負の場合、ビットマップはトップダウン DIB になり、原点は左上隅になります。

bV5Height が負の場合、トップダウン DIB を示す bV5Compression は、BI_RGBまたはBI_BITFIELDSである必要があります。 トップダウン DIB は圧縮できません。

bV5Compression がBI_JPEGまたはBI_PNG場合、bV5Height メンバーは圧縮解除された JPEG または PNG イメージの高さをピクセル単位で指定します。

bV5Planes

ターゲット デバイスの平面の数。 この値は 1 に設定する必要があります。

bV5BitCount

各ピクセルを定義するビット数と、ビットマップ内の色の最大数。

このメンバーには、次のいずれかの値を指定できます。

bV5Compression

ビットマップが圧縮されないことを指定します。 bV5RedMask、bV5GreenMask、および bV5BlueMask メンバーは、各ピクセルの赤、緑、青の各コンポーネントを指定します。 これは、16 および 32 bpp のビットマップで使用する場合に有効です。 このメンバーには、次のいずれかの値を指定できます。

bV5SizeImage

イメージのサイズ (バイト単位)。 これは、BI_RGBビットマップの場合は 0 に設定できます。

bV5Compression がBI_JPEGまたはBI_PNG場合、bV5SizeImage は JPEG または PNG イメージ バッファーのサイズです。

bV5XPelsPerMeter

ビットマップのターゲット デバイスの水平方向の解像度 (ピクセル単位)。 アプリケーションでは、この値を使用して、現在のデバイスの特性に最も一致するビットマップをリソース グループから選択できます。

bV5YPelsPerMeter

ビットマップのターゲット デバイスの垂直方向の解像度 (ピクセル単位)。

bV5ClrUsed

ビットマップで実際に使用されるカラー テーブル内のカラー インデックスの数。 この値が 0 の場合、ビットマップは、bV5Compression で指定された圧縮モードの bV5BitCount メンバーの値に対応する色の最大数を使用します。

bV5ClrUsed が 0 以外で、bV5BitCount が 16 未満の場合、bV5ClrUsed メンバーは、グラフィックス エンジンまたはデバイス ドライバーがアクセスする色の実際の数を指定します。 bV5BitCount が 16 以上の場合、bV5ClrUsed メンバーは、システム カラー パレットのパフォーマンスを最適化するために使用されるカラー テーブルのサイズを指定します。 bV5BitCount が 16 または 32 の場合、最適なカラー パレットはBITMAPV5HEADERの直後に開始されます。 bV5ClrUsed が 0 以外の場合、カラー テーブルは淡色化されたデバイスで使用され、bV5ClrUsed はエントリの数を指定します。

bV5ClrImportant

ビットマップを表示するために必要なカラー インデックスの数。 この値が 0 の場合は、すべての色が必要です。

bV5RedMask

各ピクセルの赤の成分を指定するカラー マスク。 bV5Compression が BI_BITFIELDS に設定されている場合にのみ有効です。

bV5GreenMask

各ピクセルの緑のコンポーネントを指定するカラー マスク。 bV5Compression が BI_BITFIELDS に設定されている場合にのみ有効です。

bV5BlueMask

各ピクセルの青色の成分を指定するカラー マスク。 bV5Compression が BI_BITFIELDS に設定されている場合にのみ有効です。

bV5AlphaMask

各ピクセルのアルファ 成分を指定するカラー マスク。

bV5CSType

DIB の色空間。

次の表では、 bV5CSType の値を指定します。

論理色空間を定義する情報については、 LOGCOLORSPACE 構造体を参照してください。

bV5Endpoints

ビットマップに関連付けられている論理色空間の赤、緑、青の端点に対応する 3 つの色の x、y、z 座標を指定する CIEXYZTRIPLE 構造体。 bV5CSType メンバーがLCS_CALIBRATED_RGBを指定しない限り、このメンバーは無視されます。

bV5GammaRed

赤のトン色の応答曲線。 bV5CSType が LCS_CALIBRATED_RGB に設定されている場合に使用されます。 符号なし固定 16.16 形式で指定します。 上位 16 ビットは符号なし整数値です。 下位 16 ビットは小数部です。

bV5GammaGreen

緑のトン色の応答曲線。 bV5CSType が LCS_CALIBRATED_RGB に設定されている場合に使用されます。 符号なし固定 16.16 形式で指定します。 上位 16 ビットは符号なし整数値です。 下位 16 ビットは小数部です。

bV5GammaBlue

青のトン色の応答曲線。 bV5CSType が LCS_CALIBRATED_RGB に設定されている場合に使用されます。 符号なし固定 16.16 形式で指定します。 上位 16 ビットは符号なし整数値です。 下位 16 ビットは小数部です。

bV5Intent

ビットマップのレンダリング 意図。 次のいずれかの値を指定できます。

bV5ProfileData

BITMAPV5HEADER構造体の先頭からプロファイル データの先頭までのオフセット (バイト単位)。 プロファイルが埋め込まれている場合、プロファイル データは実際のプロファイルであり、リンクされます。 (プロファイル データは、プロファイルの null で終わるファイル名です)。Unicode 文字列にすることはできません。 Windows 文字セットの文字のみで構成する必要があります (コード ページ 1252)。 bV5CSType メンバーがPROFILE_LINKEDまたはPROFILE_EMBEDDEDを指定しない限り、これらのプロファイル メンバーは無視されます。

bV5ProfileSize

埋め込みプロファイル データのサイズ (バイト単位)。

bV5Reserved

このメンバーは予約されています。 その値は 0 に設定する必要があります。

解説

bV5Height が負の場合、トップダウン DIB を示す bV5Compression は、BI_RGBまたはBI_BITFIELDSである必要があります。 トップダウン DIB は圧縮できません。

独立カラー管理インターフェイス (ICM) 2.0 を使用すると、INTERNATIONAL Color Consortium (ICC) カラー プロファイルを DIB (DIB) にリンクまたは埋め込みできます。 詳細については、「 構造の使用 」を参照してください。

DIB がメモリに読み込まれると、プロファイル データ (存在する場合) はカラー テーブルに従う必要があります。 bV5ProfileData は、 BITMAPV5HEADER 構造体の先頭からのプロファイル データのオフセットを提供する必要があります。 bV5ProfileData に格納されている値は、BITMAPV5HEADER引数を指定した sizeof 演算子によって返される値とは異なります。bV5ProfileData は、BITMAPV5HEADER構造体の先頭からプロファイル データの先頭までのオフセット (バイト単位) であるためです。 (ビットマップ ビットはメモリ内のカラー テーブルに従いません)。 DIB をメモリに読み込む後、アプリケーションで bV5ProfileData メンバーを変更する必要があります。

パックされた DIB の場合、プロファイル データは、ファイル形式と同様のビットマップ ビットに従う必要があります。 bV5ProfileData メンバーは、BITMAPV5HEADERの先頭からのプロファイル データのオフセットを引き続き指定する必要があります。

アプリケーションは、bV5Size がBITMAPV5HEADERのサイズと等しく、bV5CSType がPROFILE_EMBEDDEDまたはPROFILE_LINKEDと等しい場合にのみ、プロファイル データにアクセスする必要があります。

プロファイルがリンクされている場合、プロファイルのパスには、 CreateFile 関数を使用して開くことができる完全修飾名 (ネットワーク パスを含む) を指定できます。

要件

関連項目

BITMAPINFO

BITMAPINFOHEADER

BITMAPV4HEADER

ビットマップ構造

ビットマップの概要

CIEXYZTRIPLE

CreateDIBitmap

LOGCOLORSPACE

StretchDIBits