HT_Get8BPPFormatPalette

HT_Get8BPPFormatPalette 関数は、標準の 8 ビット/ピクセルデバイス用のハーフトーンパレットを返す。

HT_Get8BPPFormatPalette pPaletteEntry, RedGamma, GreenGamma, BlueGamma

pPaletteEntry : [var] PALETTEENTRY 構造体の配列へのポインタ(Microsoft Windows SDK ドキュメントを参照)。このポインタが NULL でない場合、GDI は 8 ビット/ピクセルのハーフトーンパレット全体を配置できる有効なメモリ領域を指していると想定する。
RedGamma : [int] 赤、緑、青のガンマ値を指定する。この USHORT 値は、暗黙の小数点の右側に下位 4 桁を持つ実数として解釈される。たとえば、ガンマ値 10000 は実数 1.0000 を表し、12345 は 1.2345 を表す。指定可能な最小ガンマ値は 0.0000、最大ガンマ値は 6.5535 である。
GreenGamma : [int] 赤、緑、青のガンマ値を指定する。この USHORT 値は、暗黙の小数点の右側に下位 4 桁を持つ実数として解釈される。たとえば、ガンマ値 10000 は実数 1.0000 を表し、12345 は 1.2345 を表す。指定可能な最小ガンマ値は 0.0000、最大ガンマ値は 6.5535 である。
BlueGamma : [int] 赤、緑、青のガンマ値を指定する。この USHORT 値は、暗黙の小数点の右側に下位 4 桁を持つ実数として解釈される。たとえば、ガンマ値 10000 は実数 1.0000 を表し、12345 は 1.2345 を表す。指定可能な最小ガンマ値は 0.0000、最大ガンマ値は 6.5535 である。

(プラグイン / モジュール : gdi32.dll)

解説

HT_Get8BPPFormatPalette 関数は、標準の 8 ビット/ピクセルデバイス用のハーフトーンパレットを返す。

[戻り値]
pPaletteEntry が NULL でない場合、戻り値は pPaletteEntry が指すメモリ位置から GDI が埋めた
PALETTEENTRY 構造体の数である。pPaletteEntry が NULL の場合、戻り値は 8
ビット/ピクセルのハーフトーンパレットを格納するために必要な PALETTEENTRY 構造体の総数である。

[備考]
HT_Get8BPPFormatPalette は、ドライバがシステム標準の 8
ビット/ピクセルハーフトーンパレットを取得するために使用できる、ハーフトーン関連の GDI サービスである。

情報