Syntax
INT is_EnableDDOverlay (HIDS hf)
Beschreibung
is_EnableDDOverlay() aktiviert im DirectDraw Back-Buffer-Modus den Live-Overlay-Modus. Im Overlay-Modus werden 3 nichtsichtbare Bild-Buffer verwendet: Back-Buffer, Overlay-Buffer, Mix-Buffer. Das Videobild wird in den Back-Buffer digitalisiert. In den Overlay-Buffer können die Grafikdaten geschrieben werden. Der Back-Buffer und der Overlay-Buffer werden dann zusammen in den Mix-Buffer geschrieben. Dabei werden die Overlay-Daten dem Videobild überlagert. Der Mix-Buffer wird dann in den sichtbaren Bereich der VGA-Karte kopiert. Die drei Buffer besitzen jeweils die Größe: Video_X * Video_Y * Farbtiefe (in Bytes pro Pixel) Der Treiber versucht die Buffer direkt in der VGA-Karte zu allozieren, um den Hochgeschwindigkeits-Bildtransfer der VGA-Karte beim Mischen der drei Buffer auszunutzen. Können die Buffer nicht in der VGA-Karte alloziert werden, muss auf den Systemspeicher ausgewichen werden. Der Bildtransfer aus dem Systemspeicher ist jedoch langsamer oder unter Umständen (abhängig von der Grafikkarte) auch gar nicht möglich. Das Overlay wird nicht direkt eingeblendet. Es muss zuvor mit is_ShowDDOverlay() sichtbar gemacht werden. Das Overlay benutzt als Color-Key die Farbe Schwarz, so dass eine Overlay-Grafik keine schwarze Farbe enthalten kann (Behelf über eine nahezu schwarze Farbe, z.B. Dunkelblau).
Übergabeparameter
hf: Handle auf Frame Grabber
Rückgabewert
IS_SUCCESS, IS_NO_SUCCESS
