shader: "wrapped image"

"wrapped image"

ShaderColour

"wrapped image"( "file name" LtString ""
"image" LtGenericPtr NULL
"scale" LtFloat 1.0
"aspect ratio" LtFloat 1.0
"softness" LtFloat 1.0
)
Synopsis A wrapped texture to provide image colour mapping.
Locationlishslte
Description A wrapped texture that provides image mapping. The name of the file containing the image data is provided as a string to parameter "file name". The file must contain image data in a format for which an appropriate image driver is currently installed.

Alternatively a pointer to a valid LtImage data structure may be given via parameter "image". If the value NULL is given then the image will be extracted from the file represented by "file name", otherwise the "image" parameter takes precedence. Note that the shader does not maintain a copy of the LtImage specified in this way, so it is the responsibility of the developer to ensure that this image data remains valid for as long as the shader references it.

\begin{SevenOneFeature} The "scale" parameter controls how many times the image texture will repeat (over a given area), while the "aspect ratio" parameter allows the aspect ratio (the width divided by the height) of the texture to be altered (this should normally be the aspect ratio of the original image to avoid it appearing squashed when rendered).

Note that the `given area' over which the image will repeat will depend on several things. In applications based on LightWorks Session Manager, it will be a one metre square; in other applications it will be one unit of texture space, the meaning of which in terms of world units will depend on the texture space used and the model units. \end{SevenOneFeature}

The parameter "softness" controls the degree of blurring on the image texture.

Previous page alphabetically (wrappedheightmap)
Next page alphabetically (wrappedimagetransparency)
Index


Copyright © 1990-2004, 2005 LightWork Design Limited. All rights reserved