GetObject: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
K (Name)
K (hat „getObject“ nach „GetObject“ verschoben: Funktionsname beginnt (in C/C++) mit großem G.)
(kein Unterschied)

Version vom 18. September 2010, 03:49 Uhr

getObject

Name

getObject - Windows-API-Funktion, welche die Pixeldaten für ein TBitmap-Objekt liefert, die dann z.B. für glTexImage2D weiterverwendet werden können.

Delphi-Spezifikation

function getObject(hgdiobj: Cardinal; cbBuffer: Integer; lpvObject: Pointer): Integer;


Parameter

hgdiobj Hier muss ein Handle zu einem Bitmap übergeben werden.
cbBuffer Größe des Puffers für die Rückgabe.
lpvObject Zeiger auf ein windows.BITMAP-Objekt


Beschreibung

getObject liefert zu einem Bitmap-Handle die Windows-Bitmap-Struktur, aus der einfach die Adresse der Pixeldaten gelesen werden kann, um sie z.B. für glTexImage2D weiter zu verwenden.

Anwendungsbeispiel:

var
  bm: tBitmap;  // Delphi-Bitmap
  buffer: windows.BITMAP; 
begin
  bm := tBitmap.Create;
  // Weitere Operationen, wie bm.loadFromFile o.ä.
  getObject(bm.Handle,sizeof(buffer),@buffer);
  // buffer.bmBits enthält nun die Adresse der Pixeldaten, die von glTexImage2D genutzt werden kann.

Alternativen

getObject ist eine Windows-API-Funktion und funktioniert generell mit allen Bitmaps für die ein Bitmap-Handle bekannt ist; für TBitmap im speziellen kann alternativ auch die Property Scanline mit dem Index height-1 aufgerufen werden:

var
  bm: tBitmap;  // Delphi-Bitmap
begin
  bm := tBitmap.Create;
  // Weitere Operationen, wie bm.loadFromFile o.ä.
  // bm.ScanLine[bm.height-1] enthält nun die Adresse der Pixeldaten, die von glTexImage2D genutzt werden kann.