[id] = LoadBGPic(id, filename$[, table])

Bildformate, die auf allen Plattformen unterstützt werden, sind PNG, JPEG, BMP, IFF ILBM, GIF und Plugins für Bilder. Je nach Plattform, worauf Hollywood ausgeführt wird, können mehr Bildformate unterstützt werden. Zum Beispiel auf den Amigakompatiblen Systemen wird Hollywood in der Lage sein, alle Formate über Bilddatatypes zu öffnen. Unter Windows kann LoadBGPic() auch Bildformate laden, die von der Windows-Imaging-Komponente unterstützt werden.

Ab Hollywood 5.0 kann dieser Befehl auch Vektorformate wie SVG laden, wenn Sie eine entsprechendes Plugin installieren. Die Verwendung eines Vektorbildes als BGPic hat den Vorteil, dass wenn sich die Größe des Displays ändert (z.B. weil der Benutzer das Fenster in der Größe ändert) kann das BGPic ohne Einbußen in der Qualität an die neue Größe angepasst werden, da Vektor-BGPics ohne Qualitätsverluste stufenlos skaliert werden können. Siehe Vektor-BGPics für weitere Informationen zu Vektor-BGPics.

Das dritte Argument table ist optional. Es ist eine Tabelle, die weitere Möglichkeiten für den Ladevorgang verwendet werden können. Die folgenden Tags stehen dafür zur Verfügung:

Transparency:

Dieser Tag kann verwendet werden, um eine Farbe in RGB-Notation, anzugeben, die im BGPic transparent erscheinen soll.

LoadAlpha:

Setzen Sie diesen Tag auf True, wenn der Alpha-Kanal des Bildes auch geladen werden soll. Bitte beachten Sie, dass nicht alle Bilder einen Alpha-Kanal haben und dass nicht alle Bildformate in der Lage sind, Alphakanaldaten zu speichern. Es wird vorgeschlagen, dass Sie das PNG-Format verwenden, wenn Sie Alphakanaldaten benötigen. Dieser Tag ist standardmäßig False. (V4.5)

FillStyle:

Dieser Tag ermöglicht es Ihnen, einen gefüllten Hintergrund mit einem Füllstil für dieses BGPic zu definieren. Dieser Füllstil wird nur verwendet, wenn das BGPic transparente Bereiche hat, das heißt, wenn Sie entweder die Tags Transparency oder LoadAlpha verwenden oder wenn Sie ein Bild in einem Format laden, die einen Alphakanal enthält. FillStyle ist nützlich, vor allem im letzteren Fall, weil einige Formate immer einen Alpha-Kanal zurückgeben, aber die meiste Zeit werden Sie diesen Alphakanal nicht verwenden, wenn ein solches Bild als ein Hintergrundbild geladen wird. Siehe SetFillStyle für Informationen über alle verfügbaren Füllstile. (V5.0)

FillColor:

Wenn beim Tag FillStyle #FILLCOLOR gesetzt wurde, können Sie mit diesem Tag die RGB-Farbe definieren, die zur Füllung verwendet werden soll. (V5.0)

TextureBrush:

Wenn beim Tag FillStyle #FILLTEXTURE gesetzt wurde, können Sie mit diesem Tag die ID des Pinsels angeben, die für die Texturierung verwendet werden soll. (V5.0)

TextureX, TextureY:

Diese Tags steuern den Startpunkt innerhalb des Texturpinsels und werden nur unterstützt, wenn FillStyle auf #FILLTEXTURE gesetzt wurde. Siehe SetFillStyle für Details. (V5.0)

GradientStyle:

Wenn FillStyle auf #FILLGRADIENT gesetzt wurde, können Sie diesen Tag nutzen, um den Farbverlauftyp anzugeben. Dies kann #LINEAR, #RADIAL oder #CONICAL sein. (V5.0)

GradientAngle:

Gibt die Ausrichtung des Farbverlaufs an, wenn bei FillStyle #FILLGRADIENT eingestellt ist. Der Winkel wird in Grad ausgedrückt. Nur für die beiden GradientStyle #LINEAR und #CONICAL. (V5.0)

GradientStartColor, GradientEndColor:

Verwenden Sie diese beiden Farben, um den Farbverlauf zu konfigurieren, wenn FillStyle auf #FILLGRADIENT gesetzt wurde. (V5.0)

GradientCenterX, GradientCenterX:

Legt den Mittelpunkt für die GradientStyle des Typs #RADIAL oder #CONICAL fest. Muss ein Fließkommawert zwischen 0.0 und 1.0 sein. Siehe CreateGradientBGPic für Details. (V5.0)

GradientBalance:

Dieser Tag steuert den Balancepunkt für Farbverläufe des Typs #CONICAL. Muss ein Fließkommawert zwischen 0.0 und 1.0 sein. Siehe CreateGradientBGPic für Details. (V5.0)

GradientBorder:

Dieser Tag steuert die Rahmengröße der Farbverläufe des Typs #RADIAL. Muss ein Fließkommawert zwischen 0.0 und 1.0 und sein. Siehe CreateGradientBGPic für Details. (V5.0)

GradientColors:

Dieser Tag kann verwendet werden, um einen Farbverlauf zwischen mehr als zwei Farben zu erzeugen. Dies muss mit einer Tabelle gesetzt werden, die Sequenzen von abwechselnden Farben und Stoppwerte enthält. Wenn dieser Tag verwendet wird, werden die Tags GradientStartColor und GradientEndColor ignoriert. Siehe CreateGradientBGPic für Details. (V5.0)

ScaleWidth, ScaleHeight:

Diese Tags können verwendet werden, um eine skalierte Version des Bildes zu laden. Wenn der Bildtreiber skaliertes Laden unterstützt, kann das die Geschwindigkeit erheblich steigern, wenn Sie zum Beispiel nur eine Version in Thumbnailgröße eines großen Bildes laden möchten. Wenn der Bildtreiber skaliertes Laden nicht unterstützt, wird zuerst das volle Bild geladen, bevor es skaliert wird. Dies ist nicht wesentlich schneller als das Bild nach dem Laden von Hand zu skalieren. Sie können die Größe entweder als direkter Wert übergeben oder Sie benutzen einen Prozentsatz als Zeichenfolge (z.B. Scalewidth = "200%"). (V5.3)

SmoothScale:

Wenn ScaleWidth oder ScaleHeight eingestellt ist, können Sie mit diesem Tag festlegen, ob Hollywood bei der Skalierung Antialiasing verwenden soll oder nicht. Der Standardwert ist False und bedeutet kein Antialiasing. Beachten Sie, dass Skalierung mit Antialiasing viel langsamer ist als die normale Skalierung. (V5.3)

Loader:

Mit diesem Tag können Sie ein oder mehrere Formatlademodule angeben, die dieses BGPic laden sollen. Dies muss als eine Zeichenkette festgelegt werden, die den/die Namen eines oder mehreren Lademodulen enthält. Standardmäßig wird der mit SetDefaultLoader() eingestellte Lader verwendet. Siehe Lade- und Adaptermodule für Details. (V6.0)

Adapter:

Mit diesem Tag können Sie einen oder mehrere Dateiadapter angeben, die die angegebene Datei öffnen sollen. Dies muss als eine Zeichenkette festgelegt werden, die den/die Namen eines oder mehreren Adaptermodulen enthält. Standardmäßig wird der mit SetDefaultAdapter() eingestellte Adapter verwendet. Siehe Lade- und Adaptermodule für Details. (V6.0)

LoadTransparency:

Ist dieser Tag auf True gesetzt, wird die monochrome Transparenz des Bildes geladen. Bitte beachten Sie, dass dieser Tag speziell für monochrome Transparenzkanäle ist, das heißt der transparente Stift ist für ein Palettenbasiertes Bild ausgelegt. Wenn Sie den Alpha-Kanal eines Bildes laden möchten, stellen Sie den Tag LoadAlpha auf True. Dieser Tag ist auf False voreingestellt. (V6.0)

LoadPalette:

Wenn dieser Tag auf True gesetzt ist, lädt Hollywood das BGPic als Paletten-BGPic. Dies bedeutet, dass Sie die Palette des BGPic abrufen und verändern können, was für bestimmte Effekte wie Farbwechsel nützlich ist. Sie können Stifte auch mit dem Tag TransparentPen (siehe unten) oder dem Tag LoadTransparency (siehe oben) transparent machen. Paletten-BGPics haben auch den Vorteil, dass sie weniger Speicher benötigen, da ein Pixel nur 1 Byte Speicher anstelle von 4 Byte für 32-Bit-Bilder benötigt. Beachten Sie, dass wenn Sie den Tag LoadPalette auf True setzen, Ihr Display zu einem Palettenmodus-Display wird, sobald das BGPic angezeigt wird. Palettenmodus-Displays verhalten sich anders als normale True-Color-Displays und bei ihrer Verwendung sind einige Dinge zu beachten. Siehe Palettenmodus-Displays für Details. Dieser Tag ist standardmäßig False. (V9.0)

FillPen:

Wenn der Tag LoadPalette auf True gesetzt wurde (siehe oben) und im Bild ein transparenter Stift vorhanden ist, können Sie mit dem Tag FillPen die Füllfarbe für alle transparenten Bereiche im Bild festlegen. Dies ist die Palette, die dem Tag FillColor entspricht, das nur für Bilder ohne Paletten verwendet wird. (V9.0)

TransparentPen:

Wenn der Tag LoadPalette auf True gesetzt wurde (siehe oben), kann mit dem Tag TransparentPen ein Stift definiert werden, der transparent gemacht werden soll. Stifte werden ab 0 gezählt. Alternativ können Sie auch den Tag LoadTransparency auf True setzen, um Hollywood zu zwingen, den transparenten Stift zu verwenden, der in der Bilddatei gespeichert ist (sofern das Bildformat die Speicherung von transparenten Stiften unterstützt). Dieser Tag ist standardmäßig #NOPEN. (V9.0)

UserTags:

Dieser Tag kann verwendet werden, um zusätzliche Daten anzugeben, die an Lader und Adapter übergeben werden sollen. Wenn Sie diesen Tag verwenden, müssen Sie ihn auf eine Tabelle mit Schlüssel-Wert-Paaren setzen, die die zusätzlichen Daten enthalten, die an Plugins übergeben werden sollen. Siehe Benutzer-Tags für Details. (V10.0)

Wenn Sie Transparency, LoadTransparency oder LoadAlpha verwenden, wird Ihr Display automatisch die Transparenzeinstellungen des BGPic annehmen, wenn es angezeigt wird. Mit anderen Worten, wenn Sie ein Display mit Transparenz haben möchten, laden Sie einfach ein transparentes BGPic und zeigen es an.

Bitte beachten Sie, dass sich die Tags Transparency, LoadTransparency und LoadAlpha gegenseitig ausschließen. Ein BGPic kann nur eine Transparenzeinstellung haben!

Dieser Befehl gibt es auch als Präprozessor: Verwenden Sie @BGPIC, um Hintergrundbilder vorzuladen!

Siehe auch IsPicture().

id

ID des neuen BGPic oder Nil für die automatische ID-Zuweisung

filename$

Datei zum Laden

table

optional: weitere Konfigurationsmöglichkeiten für den Ladevorgang

id

optional: Identifikator des BGPic; Wird nur zurückgegeben werden, wenn Sie Nil als Argument 1 angegeben haben (siehe oben)

LoadBGPic(2, "MyBG.iff", {Transparency = $00FF00})