CreateImage()

Syntax

Ergebnis = CreateImage(#Image, Breite, Höhe [, Tiefe [, HintergrundFarbe]])
Beschreibung
Erstellt ein leeres Bild (englisch "Image", standardmäßig mit schwarzem Hintergrund), welches zum darauf Zeichnen benutzt werden kann.

Parameter

#Image Eine Nummer, um das neue Bild zu identifizieren. #PB_Any kann angegeben werden, um diese Nummer automatisch zu generieren.
Breite, Höhe Die Abmessungen des neuen Bildes. Sowohl Breite als auch Höhe müssen größer als Null sein.
Tiefe (optional) Die Farbtiefe des neuen Bildes. Gültige Werte können sein: 24 und 32. Der Standard ist 24-Bit, wenn keine Tiefe angegeben wird.
HintergrundFarbe (optional) Die beim Erstellen des Bildes verwendete Hintergrund-RGB()-Farbe. Diese Farbe kann auf #PB_Image_Transparent gesetzt werden, 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. Die Standard-Hintergrundfarbe ist schwarz, wenn dieser Parameter nicht angegeben wird.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn das Bild erfolgreich erstellt 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
StartVectorDrawing() mit ImageVectorOutput() zum Zeichnen auf dem erstellten Bild mittels Vektorzeichnen
- 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 - EncodeImage() ->