Diese Methode ist in FRE für Windows implementiert.
Diese Methode gibt einen Teil des Bildes als Top-down-DIB (Device-Independent Bitmap) zurück. Für Graustufen- und Schwarzweißbilder wird eine Palette verwendet, bei der 0 der Farbe Schwarz entspricht.Die Methode gibt das DIB als Handle-Objekt zurück. Dieses Objekt verwaltet die Speicherbelegung und gibt Ressourcen frei, wenn sie nicht mehr verwendet werden.
Modification[in] Dieser Parameter vom Typ ImageModification definiert die Änderungen, die am Bild vorgenommen werden. Er kann Zuschneiderechtecke enthalten; in diesem Fall werden nur die angegebenen Teile des Bildes übergeben, außerdem ein Streckungsverhältnis, Füllrechtecke zum Füllen von Bildbereichen mit Farbe und so weiter. Dieser Parameter kann 0 sein; in diesem Fall werden keine Änderungen an der Bildseite vorgenommen und sie wird „wie besehen“ übergeben.Result[out, retval] Ein Zeiger auf eine IHandle*-Zeigervariable, die den Schnittstellenzeiger des resultierenden Handle-Objekts erhält, das das Handle für die zugeordnete Bitmap darstellt.
Diese Methode funktioniert nicht, wenn die Engine unter Linux als Out-of-Process-Server geladen wird oder wenn das Objekt unter Windows über das Objekt OutprocLoader erstellt wird.
