Background
Prev | Chapter 30. YafRay | Next

## Background

Relevant to Blender v2.31

Adds a background image (environment map), colour or sky to your render.

Pathlight and Hemilight can sample the background colour and intensity to simulate real world lighting.

### Normal Image Background

    <background type="image" name="envnorm" power="1.000000">
      <filename value="C:\directory\image.jpg"/>
    </background>

- `type - image`: Allows you to use a bitmap image of one of the supported texture formats as a background. The image is mapped around the scene as a sphere, so the image should be in latitude/longitude format (ratio 2:1).

- `name`: Background Name.

- `Power`: Level of brightness of the bitmap. 1.0 is default, greater numbers will increase brightness, lower numbers will decrease brightness.

- `filename`: Full path and filename of the image, including the file extension.

### HDRI Background

    <background type = "HDRI" name = "envhdri" exposure_adjust = "0">
      <filename value = "C:\directory\image.hdr" />
    </background>

- `type - HDRI`: Allows you to use an HDR image as a background. The HDRI is mapped around the scene as an angular map, not latitude longitude like the normal image background.

- `name`: Background Name.

- `exposure_adjust`: Similar to 'power' for a normal image background. 0 is default, increasing this will brighten the HDR, decreasing will darken (equivalent to adjusting the f-stop on a physical camera).

- `filename`: Full path and filename of the HDRI, including the file extension.

### Constant Background

    <background type="constant" name = "constbackg">
      <color r="1.000000" g="1.000000" b="1.000000"/>
    </background>

- `type - constant`: Lets you assign a single colour as the background.

- `name`: Background Name.

- `color`: r - red value of color (0.000000 - 1.000000) g - green value of color (0.000000 - 1.000000) g - green value of color (0.000000 - 1.000000). 1/1/1 is white, 0/0/0 is black.

### Sun/Sky Background

    <background type="sunsky" name ="Sun1" turbidity ="4.000000" add_sun="on" sun_power="1.000000"
      a_var="1.000000" b_var="1.000000" c_var="1.000000" d_var="1.000000" e_var="1.000000" >
      <from x="-0.007401" y="8.589217" z="3.737965"/>
    </background>

- `type - sunsky`: Lets you assign a realistic sky background with optional sun.

- `turbidity`: Atmosphere density (eg mist/fog) the lower the number, the less visible the sky is. A value of 4 is a clear sky.

Prev | Up | Next
Lights | Home | Camera