Name
CreateTexturedBGPic -- create a new background picture textured with a brush
Synopsis
[id] = CreateTexturedBGPic(id, brushid[, width, height, x, y])
Function
This function will create a new background picture for you and it will texture it with the brush specified by brushid. If you specify Nil in the id argument, this function will choose a vacant identifier for this background picture automatically and return it to you. If width and height are omitted, the dimensions will be the same as the current display.

The optional x and y parameters are new in Hollywood 4.6. They allow you to specify an offset into the texture brush. Texturing will then start from this offset in the brush. The default for these arguments is 0/0 which means start at the top-left corner inside the texture brush.

Inputs
id
id for the new background picture or Nil for auto ID select
brushid
identifier of the brush to be used as the texture
width
optional: desired width for the background picture (default: current display width)
height
optional: desired height for the background picture (default: current display height)
x
optional: start x offset in the texture brush (V4.6)
y
optional: start y offset in the texture brush (V4.6)
Results
id
optional: identifier of the BGPic; will only be returned when you pass Nil as argument 1 (see above)
Example
CreateTexturedBGPic(2,1)
DisplayBGPic(2)
Creates a background picture that will be textured with brush 1 and displays it.

Show TOC