CreateImage

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 Hintergrundfarbe.
Bei 24-Bit-Bildern verwenden Sie RGB(), um eine gültige Farbe zu erhalten.
Bei 32-Bit-Bildern verwenden Sie RGBA(), um eine gültige Farbe zu erhalten. Für 32-Bit-Bilder können auch spezielle Konstanten verwendet werden:
- #PB_Image_Transparent ist ähnlich zu RGBA(255,255,255,0) mit einem weißen Hintergrund, der für leichtes Antialiasing geeignet ist.
- #PB_Image_TransparentBlack ist ähnlich RGBA(0,0,0,0) mit einem schwarzen Hintergrund, der für starkes Antialiasing geeignet ist.
Die Standard-Hintergrundfarbe ist Schwarz, sofern 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() ->

#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 Hintergrundfarbe. Bei 24-Bit-Bildern verwenden Sie RGB(), um eine gültige Farbe zu erhalten. Bei 32-Bit-Bildern verwenden Sie RGBA(), um eine gültige Farbe zu erhalten. Für 32-Bit-Bilder können auch spezielle Konstanten verwendet werden: - #PB_Image_Transparent ist ähnlich zu RGBA(255,255,255,0) mit einem weißen Hintergrund, der für leichtes Antialiasing geeignet ist. - #PB_Image_TransparentBlack ist ähnlich RGBA(0,0,0,0) mit einem schwarzen Hintergrund, der für starkes Antialiasing geeignet ist. Die Standard-Hintergrundfarbe ist Schwarz, sofern dieser Parameter nicht angegeben wird.