CreateImage

CreateImage()

Syntax

Ergebnis = CreateImage(#Image, Breite, Höhe [, Tiefe])

Beschreibung

Erstellt ein leeres Bild (Image) mit schwarzem Hintergrund, welches zum darauf Zeichnen benutzt werden kann.

Parameter

#Image Gibt eine Nummer an, um das neue Bild zu identifizieren. #PB_Any kann angegeben werden, um diese Nummer automatisch zu generieren.

Breite, Höhe Geben die Abmessungen des neuen Bildes an. Sowohl Breite als auch Höhe müssen größer als Null sein.

Tiefe (optional) Gibt die Farbtiefe des neuen Bildes an. Gültige Tiefen-Werte können sein: 24 Bit und 32 Bit. Der Standard ist 24 Bit, wenn keine Tiefe angegeben wird. Der Tiefen-Wert kann mit #PB_Image_Transparent kombiniert werden (mit dem bitweisen OR-Operator '|'), um ein Bild zu erstellen, bei dem der Alpha-Kanal auf völlige Transparenz gesetzt ist. Dies hat nur einen Effekt bei 32 Bit Bildern.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn das Bild erfolgreich kopiert wurde, und Null wenn das Bild nicht erstellt werden konnte. Wenn #PB_Any als #Image Parameter angegeben wurde, dann wird bei Erfolg die automatisch generierte Nummer zurückgegeben.

Anmerkungen

Das Limit für die Bildgröße, welche verarbeitet werden kann, hängt vom Betriebssystem und dem verfügbaren Speicher ab. Wenn genügend Speicher verfügbar ist, dann können von allen von PureBasic unterstützten Betriebssystemen Bilder bis mindestens 8192x8192 Pixel verarbeitet werden.

Sie können verschiedene andere Funktionen benutzen, um auf das erstellte Bild zuzugreifen:
StartDrawing() mit ImageOutput() zum Zeichnen auf das erstellte Bild
CopyImage() zum Erstellen eines weiteren Bildes vom aktuellen Bild
GrabImage() zum Erstellen eines weiteren Bildes aus einem angegebenen Bildausschnitt des aktuellen Bildes
DrawImage() mit ImageID() zum Zeichnen des Bildes auf dem aktuellen Ausgabekanal
ImageGadget() zum Anzeigen des Bildes auf einem Programmfenster
ButtonImageGadget() zum Erstellen eines Bild-Schalters auf einem Programmfenster

Siehe auch

LoadImage(), CatchImage(), FreeImage()

Unterstützte OS

Alle

<- CopyImage() - Image Inhaltsverzeichnis - FreeImage() ->

#Image	Gibt eine Nummer an, um das neue Bild zu identifizieren. #PB_Any kann angegeben werden, um diese Nummer automatisch zu generieren.
Breite, Höhe	Geben die Abmessungen des neuen Bildes an. Sowohl Breite als auch Höhe müssen größer als Null sein.
Tiefe (optional)	Gibt die Farbtiefe des neuen Bildes an. Gültige Tiefen-Werte können sein: 24 Bit und 32 Bit. Der Standard ist 24 Bit, wenn keine Tiefe angegeben wird. Der Tiefen-Wert kann mit #PB_Image_Transparent kombiniert werden (mit dem bitweisen OR-Operator '\|'), um ein Bild zu erstellen, bei dem der Alpha-Kanal auf völlige Transparenz gesetzt ist. Dies hat nur einen Effekt bei 32 Bit Bildern.