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"/>
  • 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" />
  • 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"/>
  • 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"/>
  • 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.