[handle] = DisplayBGPicPartFX(id, x, y, width, height[, table])
If layers are enabled, this command will add a new layer of the type
#BGPICPART
to the layer stack.
Starting with Hollywood 4.0 this function uses a new syntax with just a single table as an optional argument. The old syntax is still supported for compatibility reasons. The optional table argument can be used to configure the transition effect. The following options are possible:
Type:
#RANDOMEFFECT
)
Speed:
#NORMALSPEED
)
Parameter:
#RANDOMPARAMETER
)
Async:
True
here DisplayBGPicPartFX()
will exit immediately, returning a handle to an asynchronous
draw object which you can then draw using AsyncDrawFrame().
See AsyncDrawFrame for more information on asynchronous draw objects.
DX:
DY:
Layers:
True
here if the layers of the background picture
shall also be displayed (requires enabled layers).
(defaults to False
)
Async
has been set to True
(see above)DisplayBGPicPartFX(2, 0, 0, 100, 100, #HSTRIPES32, 10) ; old syntax OR DisplayBGPicPartFX(2, 0, 0, 100, 100, {Type = #HSTRIPES32, Speed = 10}) ; new syntaxDisplay the first 100 pixels and rows from background picture 2 on the screen with the transition effect
#HSTRIPES32
at speed 10.