Package bpy :: Module types :: Class World :: Class WorldAmbientOcclusion
[hide private]
[frames] | no frames]

Class WorldAmbientOcclusion

The Ambient Occlusion Object

Ambient occlusion settings for a World datablock.

References

Instance Variables [hide private]
float in [0, 1] adapt_to_speed
Use the speed vector pass to reduce AO samples in fast moving pixels.
float in [0, 0.5] bias
Bias (in radians) to prevent smoothed faces from showing banding (for Raytrace Constant Jittered).
enum blend_mode
Defines how AO mixes with material shading.
enum color
Defines the color of the AO light in...
float in [0, 1] correction
Ad-hoc correction for over-occlusion due to the approximation (for Approximate).
float in [-inf, inf] distance
Length of rays, defines how far away other faces give occlusion effect.
boolean enabled
Use Ambient Occlusion to add light based on distance between elements, creating the illusion of omnipresent light
float in [-inf, inf] energy
Amount of enerygy generated by ambient occlusion.
float in [0.0001, 10] error_tolerance
Low values are slower and higher quality (for Approximate).
boolean falloff
Falloff
float in [-inf, inf] falloff_strength
Distance attenuation factor, the higher, the 'shorter' the shadows.
enum gather_method
Gather Method in...
int in [0, 32767] indirect_bounces
Number of indirect diffuse light bounces to use for approximate ambient occlusion.
float in [0, inf] indirect_energy
Use approximate ambient occlusion for indirect diffuse lighting.
int in [0, 10] passes
Number of preprocessing passes to reduce overocclusion (for Approximate).
boolean pixel_cache
Cache AO results in pixels and interpolate over neighbouring pixels for speedup (for Approximate).
enum sample_method
Method for generating shadow samples (for Raytrace).
int in [1, 32] samples
Amount of ray samples.
float in [0, 1] threshold
Samples below this threshold will be considered fully shadowed/unshadowed and skipped (for Raytrace Adaptive QMC).
Instance Variable Details [hide private]

adapt_to_speed

Use the speed vector pass to reduce AO samples in fast moving pixels. Higher values result in more aggressive sample reduction. Requires Vec pass enabled (for Raytrace Adaptive QMC).
Type:
float in [0, 1]

blend_mode

Defines how AO mixes with material shading. in...
  • ADD
  • SUBTRACT
  • BOTH
Type:
enum

color

Defines the color of the AO light in...
  • PLAIN
  • SKY_COLOR
  • SKY_TEXTURE
Type:
enum

gather_method

Gather Method in...
  • RAYTRACE
  • APPROXIMATE
Type:
enum

sample_method

Method for generating shadow samples (for Raytrace). in...
  • CONSTANT_JITTERED
  • ADAPTIVE_QMC
  • CONSTANT_QMC
Type:
enum

samples

Amount of ray samples. Higher values give smoother results and longer rendering times
Type:
int in [1, 32]