SetCreateGraphColorBitDepth

作成するグラフィックのビット深度を設定する

SetCreateGraphColorBitDepth BitDepth

int BitDepth ： ビット深度（ 16 又は 32 ）

(プラグイン / モジュール : DxLibW)

解説

関数 LoadGraph や MakeScreen などの関数で作成するグラフィックハンドルが持つ画像の１ピクセル辺りのビット数を設定する関数です。

ビット数が多いほど色の階調が増えて綺麗になりますが、その分ＶＲＡＭを多く消費します。

例えば縦横２５６ピクセルの画像を読み込んだ場合、色ビット数が32の場合に消費するＶＲＡＭの容量は

２５６×２５６×３２＝２０９７１５２


２０９７１５２ビットになります。（単位をバイトにすると１バイトは８ビットなので、2097152 / 8 = 262144バイト、
単位をキロバイトにすると１キロバイトは１０２４バイトなので、262144 / 1024 = 256キロバイト）

色ビット数を16にすると、画質が悪くなる代わりに丁度半分の１０４８５７６ビット（１２８キロバイト）に抑えることができます。

使い方は LoadGraph や LoadDivGraph、MakeScreen などの画像を作成する関数を呼ぶ前に SetCreateGraphColorBitDepth でビット数を設定すると、
その後に作成されるグラフィックハンドルにその値が適用されます。

作成した後のグラフィックハンドルのビット数を変更することはできません。

＜例＞

// ビット深度３２の設定で Test1.bmp を読み込む

SetCreateGraphColorBitDepth( 32 ) ;

GraphHandle = LoadGraph( "Test1.bmp" ) ;

// ビット深度１６の設定で縦横５１２ピクセルの描画可能画像を作成する

SetCreateGraphColorBitDepth( 16 ) ;

ScreenHandle = MakeScreen( 512, 512 ) ;

＜浮動小数点型画像の場合＞

SetDrawValidFloatTypeGraphCreateFlag で浮動小数点型の画像を持つグラフィックハンドルを作成するように設定している場合は
SetCreateGraphColorBitDepth で設定する値は「１ピクセル辺りのビット数」ではなく「１ピクセル内の１チャンネル辺りのビット数」になります。

つまり設定が１６の時にＲＧＢＡの４チャンネルを持った画像を作成すると１ピクセル辺りのサイズは１６×４＝６４ビットになります。

戻り値:
  ０：成功

関連項目

情報