Image

Reference
Index

    The Image component loads an external image/bitmap file.

How Does It Work?

    When you load a bitmap file, it's rendered differently depending on whether you use a color, percent or bump Image component (you can, of course, use the same bitmap for all three component types). A color Image component simply loads the bitmap "as is". If you use a percent type Image component, it will convert the bitmap to grayscale based on the brightness of the image colors. And finally if you use a bump type Image component, it will interpret the brightness of the color values as elevations.

    Using the Tile check box, you have the option of tiling the bitmap as well, causing it to repeat forever.  If Tile isn't checked, you'll see a background texture in the areas that surround the bitmap. If the bitmap includes an alpha channel, the background color will be seen through the transparent areas of the bitmap.

    The Width and Height parameters are strictly for your own information and give you the size of the loaded bitmap in pixel coordinates.  When a bitmap is loaded, it is automatically scaled so that it's largest dimension fits perfectly in the viewing area.  The Mapping Type specifies how the bitmap is projected in 3D space.  You will usually want a Planar 2D mapping unless you are using the bitmap as an environment in which case you will want Spherical 2D.

Hints!

    A bitmap that's loaded into a percent Image component can provide some very unique and interesting results when it's used as a control for another texture. For example, linking the Width parameter of the Stripes component to a percent Image will make a horizontal line interpretation of the original image. Be sure that the Stripes component is scaled in such a way that there are a lot of stripes, otherwise there won't be sufficient resolution to make the image effects visible.

    The Image component can function as a way to provide hand painted masks within a DarkTree as well. For example, you could load some hand painted text into an Image component, then use it to control the Puff Size parameter of an animated Clouds component. This, in effect, will create moving/rolling "cloud writing". If you want to create this effect, the text works best if it has a very diffuse, airbrushed edge.

Common Parameters

 

 

 

 

Filename

The path and name of the bitmap file to load.  If the file couldn't be successfully loaded, this parameter becomes blank and only background will show.

 

 

 

 

Width

The width of the loaded bitmap in pixels.

 

 

 

 

Height

The height of the loaded bitmap in pixels.

 

 

 

 

Interpolate

When checked, smoothly interpolates colors between pixels.

 

 

 

 

Tile

When checked, tiles the image.

 

 

 

 

Mapping Type

This parameter specifies how the image is projected in 3D space.

Color Component Parameters

 

 

Background

Background is the texture behind the bitmap.

Percent Component Parameters

 

 

Background

Background is the texture behind the bitmap.

Bump Component Parameters

 

 

Background

Background is the texture behind the bitmap.

 

 

Bump Scale

Controls both the background bump (linked or not) and the height of the loaded image.

Darkling Simulations
Copyright 1996-2003