既存の Xlib ピクセル転送ルーチンを使用する

Xlib ピクセル転送ルーチン XGetImage、XCopyArea、XCopyPlane も、透明オーバーレイウィンドウに使用できます。

XGetImage

オーバーレイ以外のドロアブル上では、XGetImage ルーチンは X11 仕様で定義されたとおりに動作します。オーバーレイウィンドウについても同じことが言えますが、例外として、これらのウィンドウ上では透明なピクセルについて戻されるカラー情報は未定義になります。画面上の領域の表示カラーを検索するだけの場合は、XReadScreen を使用してください。

XCopyArea および XCopyPlane

ソースと宛先のドロアブルが両方ともオーバーレイ以外の場合、これらのルーチンは X11 仕様で定義されたとおりに動作します。ただし、ソースまたは宛先となるドロアブルがオーバーレイウィンドウの場合は、次の点に注意してください。

• ソースのドロアブルがオーバーレイで、宛先のドロアブルがオーバーレイ以外の場合は、カラー情報だけがコピーされ、ソースのペイント型情報は無視されます。透明なピクセルに関するカラー情報は未定義になります。

• ソースのドロアブルがオーバーレイ以外で、宛先のドロアブルがオーバーレイである場合は、GC のペイント型で指定されたとおりにコピーが実行されます。すなわち、ペイント型が XSolarisOvlPaintOpaque の場合は、不透明なペイントを使用してカラー情報が宛先にコピーされます。ペイント型が XSolarisOvlPaintTransparent の場合は、カラー情報が無視され、宛先のピクセルは透明になります。

• ソースと宛先のドロアブルが両方ともオーバーレイの場合は、ソースのペイント型が無視され、ソースがオーバーレイでない場合と同じ動作になります。カラーとペイント型の両方の情報をコピーしたい場合は、XSolarisOvlCopyAreaAndPaintType を使用してください。