- 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 an 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.