EnvironmentMap(bpy_struct)

base class — bpy_struct

class bpy.types.EnvironmentMap(bpy_struct)

Environment map created by the renderer and cached for subsequent renders

auto_update

True if the cube map is updated every frame

Type:boolean, default False
clip_end

Objects further than this are not visible to map

Type:float in [0.01, inf], default 0.0
clip_start

Objects nearer than this are not visible to map

Type:float in [0.001, inf], default 0.0
depth

Number of times a map will be rendered recursively (mirror effects)

Type:int in [0, 5], default 0
filtering

Texture filtering method

  • NONE None, None texture filtering.
  • LINEAR Linear Filtering, Linear texture filtering.
  • MIPMAP Mipmap Filtering, Mipmap texture filtering.
Type:enum in [‘NONE’, ‘LINEAR’, ‘MIPMAP’], default ‘NONE’
is_valid

True if this map is ready for use, False if it needs rendering

Type:boolean, default False, (readonly)
layers_ignore

Hide objects on these layers when generating the Environment Map

Type:boolean array of 20 items, default (False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False)
lod_factor

The factor applied to distance computed in Lod

Type:float in [0, inf], default 1.0
mapping
  • CUBE Cube, Use environment map with six cube sides.
  • PLANE Plane, Only one side is rendered, with Z axis pointing in direction of image.
Type:enum in [‘CUBE’, ‘PLANE’], default ‘CUBE’
mode

Texture rendering method

  • REFLECTION Reflection, Reflection rendering.
  • REFRACTION Refraction, Refraction rendering.
Type:enum in [‘REFLECTION’, ‘REFRACTION’], default ‘REFLECTION’
resolution

Pixel resolution of the rendered environment map

Type:int in [50, 4096], default 0
source
  • STATIC Static, Calculate environment map only once.
  • ANIMATED Animated, Calculate environment map at each rendering.
  • IMAGE_FILE Image File, Load a saved environment map image from disk.
  • REALTIME Realtime, Image generated for realtime reflections in the game engine.
Type:enum in [‘STATIC’, ‘ANIMATED’, ‘IMAGE_FILE’, ‘REALTIME’], default ‘STATIC’
viewpoint_object

Object to use as the environment map’s viewpoint location

Type:Object
zoom
Type:float in [0.1, 5], default 0.0
clear()

Discard the environment map and free it from memory

save(filepath, scene=None, layout=(0.0, 0.0, 1.0, 0.0, 2.0, 0.0, 0.0, 1.0, 1.0, 1.0, 2.0, 1.0))

Save the environment map to disc using the scene render settings

Parameters:
  • filepath (string, (never None)) – File path, Location of the output file
  • scene (Scene, (optional)) – Overrides the scene from which image parameters are taken
  • layout (float array of 12 items in [0, 1000], (optional)) – File layout, Flat array describing the X,Y position of each cube face in the output image, where 1 is the size of a face - order is [+Z -Z +Y -X -Y +X] (use -1 to skip a face)
classmethod bl_rna_get_subclass(id, default=None)
Parameters:id (string) – The RNA type identifier.
Returns:The RNA type or default when not found.
Return type:bpy.types.Struct subclass
classmethod bl_rna_get_subclass_py(id, default=None)
Parameters:id (string) – The RNA type identifier.
Returns:The class or default when not found.
Return type:type

Inherited Properties

Inherited Functions

References