@BGPIC id, filename$[, table]

Image formats that are supported on all platforms are PNG, JPEG, BMP, IFF ILBM, GIF, and image formats you have a plugin for. Depending on the platform Hollywood is running on, more image formats might be supported. For example, on Amiga compatible systems Hollywood will be able to open all image formats you have datatypes for as well. On Windows, @BGPIC can also load image formats supported by the Windows Imaging Component.

Starting with Hollywood 5.0, this function can also load vector formats like SVG if you have an appropriate plugin installed. Using a vector image as a BGPic has the advantage that when the size of the display changes (e.g. because the user is resizing the window), the BGPic can be adapted to the new size without any losses in quality because vector BGPics can be infinitely scaled without any sacrifices in quality. See Vector BGPics for more information on vector BGPics.

The third argument is optional. It is a table that can be used to set further options for the loading operation. The following fields of the table can be used:

Transparency:

This field can be used to specify a color in RGB notation that shall appear transparent in the BGPic.

LoadAlpha:

Set this field to True if the alpha channel of the image shall be loaded, too. Please note that not all pictures have an alpha channel and that not all picture formats are capable of storing alpha channel information. It is suggested that you use the PNG format if you need alpha channel data. This tag defaults to False. (V4.5)

Link:

Set this field to False if you do not want to have this BGPic linked to your executable/applet when you compile your script. This field defaults to True which means that the BGPic is linked to your executable/applet when Hollywood is in compile mode.

FillStyle:

See LoadBGPic for details. (V5.0)

FillColor:

See LoadBGPic for details. (V5.0)

TextureBrush:

See LoadBGPic for details. (V5.0)

TextureX, TextureY:

See LoadBGPic for details. (V5.0)

GradientStyle:

See LoadBGPic for details. (V5.0)

GradientAngle:

See LoadBGPic for details. (V5.0)

GradientStartColor, GradientEndColor:

See LoadBGPic for details. (V5.0)

GradientCenterX, GradientCenterY:

See LoadBGPic for details. (V5.0)

GradientBalance:

See LoadBGPic for details. (V5.0)

GradientBorder:

See LoadBGPic for details. (V5.0)

GradientColors:

See LoadBGPic for details. (V5.0)

ScaleWidth, ScaleHeight:

See LoadBGPic for details. (V5.3)

SmoothScale:

See LoadBGPic for details. (V5.3)

Loader:

See LoadBGPic for details. (V6.0)

Adapter:

See LoadBGPic for details. (V6.0)

LoadTransparency:

See LoadBGPic for details. (V6.0)

LoadPalette:

See LoadBGPic for details. (V9.0)

FillPen:

See LoadBGPic for details. (V9.0)

TransparentPen:

See LoadBGPic for details. (V9.0)

UserTags:

See LoadBGPic for details. (V10.0)

If you use Transparency, LoadTransparency or LoadAlpha, your display will automatically adopt the transparency settings of the BGPic when it is displayed. In other words, if you want to have a display with transparency, simply load a transparent BGPic and display it.

If you set the LoadPalette tag to True, your display will become a palette display as soon as the BGPic is shown. Palette displays behave differently than normal true colour displays and there are some things to be considered when using them. See Palette displays for details.

Please note that the Transparency, LoadTransparency and LoadAlpha tags are mutually exclusive. A BGPic can only have one transparency setting!

If you want to load background pictures manually, please use the LoadBGPic() command.

id

a value that is used to identify this background picture later in the code; if this is 1 then the picture will be the initial display background

filename$

the picture file you want to load

table

optional: a table for setting further options; see above for explanation

@BGPIC 1, "MyBG.png"

@BGPIC 1, "MyBG.png", {Transparency = $FF0000}

@BGPIC 1, "4MB_uncompressed_picture.bmp", {Link = False}