CImage::Create

CImage ビットマップを作成し、構築済みの CImage オブジェクトに割り当てます。

BOOL Create(
   int nWidth,
   int nHeight,
   int nBPP,
   DWORD dwFlags = 0 
) throw( );

パラメーター

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

  • nHeight
    CImage ビットマップの高さ (ピクセル単位)。 nHeight に正の値を指定すると、CImage オブジェクトに割り当てられるビットマップは、左下隅を起点とする逆方向 (下から上) の DIB になります。 nHeight に負の値を指定すると、CImage オブジェクトに割り当てられるビットマップは、左上隅を起点とする順方向 (上から下) の DIB になります。

  • nBPP
    ビットマップの 1 ピクセルあたりのビット数。 この値は通常、4、8、16、24、または 32 です。 モノクロ ビットマップやマスクの場合は 1 も指定できます。

  • dwFlags
    ビットマップ オブジェクトのアルファ チャネルの有無を指定します。 次の値を 0 個以上組み合わせて指定できます。

    • createAlphaChannel場合にのみ使用することができますnBPP32 です。 この値を指定すると、作成されたイメージにアルファ (透明度) 値が設定され、そのアルファ値が各ピクセルの 4 番目のバイトに格納されます (このバイトは、アルファ チャネルを使用しない 32 ビット イメージでは使用されません)。 このアルファ チャネルは、CImage::AlphaBlend を呼び出すときに自動的に使用されます。

    注意

    アルファ チャネルを持つイメージは、CImage::Draw を呼び出すときに自動的にアルファ ブレンドされて対象のイメージに描画されます。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

必要条件

**ヘッダー:**atlimage.h

参照

参照

CImage クラス

CImage::CImage

CImage::AlphaBlend

CImage::CreateEx

その他の技術情報

CImage のメンバー