Scene(ID)

base classes — bpy_struct, ID

class bpy.types.Scene(ID)

Scene consisting objects and defining time and render related settings

animation_data

Animation data for this datablock

Type :AnimData, (readonly)

audio_distance_model

Distance model for distance attenuation calculation

Type :enum in [‘NONE’, ‘INVERSE’, ‘INVERSE_CLAMPED’, ‘LINEAR’, ‘LINEAR_CLAMPED’, ‘EXPONENT’, ‘EXPONENT_CLAMPED’], default ‘NONE’

audio_doppler_factor

Pitch factor for Doppler effect calculation

Type :float in [0, inf], default 0.0

audio_doppler_speed

Speed of sound for Doppler effect calculation

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

background_set

Background set scene

Type :Scene

camera

Active camera used for rendering the scene

Type :Object

cursor_location

3D cursor location

Type :float array of 3 items in [-inf, inf], default (0.0, 0.0, 0.0)

frame_current

Type :int in [-300000, 300000], default 0

frame_end

Final frame of the playback/rendering range

Type :int in [0, 300000], default 0

frame_preview_end

Alternative end frame for UI playback

Type :int in [-inf, inf], default 0

frame_preview_start

Alternative start frame for UI playback

Type :int in [-inf, inf], default 0

frame_start

First frame of the playback/rendering range

Type :int in [0, 300000], default 0

frame_step

Number of frames to skip forward while rendering/playing back each frame

Type :int in [0, 300000], default 0

game_settings

Type :SceneGameData, (readonly, never None)

gravity

Constant acceleration in a given direction

Type :float array of 3 items in [-200, 200], default (0.0, 0.0, 0.0)

grease_pencil

Grease Pencil datablock

Type :GreasePencil

is_nla_tweakmode

Indicates whether there is any action referenced by NLA being edited. Strictly read-only

Type :boolean, default False, (readonly)

keying_sets

Absolute Keying Sets for this Scene

Type :KeyingSets collection of KeyingSet, (readonly)

keying_sets_all

All Keying Sets available for use (Builtins and Absolute Keying Sets for this Scene)

Type :KeyingSetsAll collection of KeyingSet, (readonly)

layers

Layers visible when rendering the scene

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)

network_render

Network Render Settings

Type :NetRenderSettings, (readonly)

nodetree

Compositing node tree

Type :NodeTree, (readonly)

object_bases

Type :SceneBases collection of ObjectBase, (readonly)

objects

Type :SceneObjects collection of Object, (readonly)

orientations

Type :Collection of TransformOrientation, (readonly)

pose_templates

Pose Template Settings

Type :PoseTemplateSettings, (readonly)

render

Type :RenderSettings, (readonly, never None)

renderman

Type :RendermanSceneSettings, (readonly)

sequence_editor

Type :SequenceEditor, (readonly)

sync_mode

How to sync playback

Type :enum in [‘NONE’, ‘FRAME_DROP’, ‘AUDIO_SYNC’], default ‘NONE’

timeline_markers

Markers used in all timelines for the current scene

Type :TimelineMarkers collection of TimelineMarker, (readonly)

tool_settings

Type :ToolSettings, (readonly, never None)

unit_settings

Unit editing settings

Type :UnitSettings, (readonly, never None)

use_audio

Play back of audio from Sequence Editor will be muted

Type :boolean, default False

use_audio_scrub

Play audio from Sequence Editor while scrubbing

Type :boolean, default False

use_audio_sync

Play back and sync with audio clock, dropping frames if frame display is too slow

Type :boolean, default False

use_frame_drop

Play back dropping frames if frame display is too slow

Type :boolean, default False

use_gravity

Use global gravity for all dynamics

Type :boolean, default False

use_nodes

Enable the compositing node tree

Type :boolean, default False

use_preview_range

Use an alternative start/end frame for UI playback, rather than the scene start/end frame

Type :boolean, default False

use_stamp_note

User define note for the render stamping

Type :string, default “”

world

World used for rendering the scene

Type :World

statistics()

statistics

Returns:Statistics Return type:string

frame_set(frame, subframe=0.0)

Set scene frame updating all objects immediately.

Parameters:

• frame (int in [-300000, 300000]) – Frame number to set.
• subframe (float in [0, 1], (optional)) – Sub-frame time, between 0.0 and 1.0

update()

Update data tagged to be updated from previous access to data or operators.

Inherited Properties

bpy_struct.id_data ID.name ID.use_fake_user

ID.library ID.tag ID.users

Inherited Functions

bpy_struct.as_pointer bpy_struct.callback_add bpy_struct.callback_remove bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.is_property_hidden bpy_struct.is_property_set bpy_struct.items bpy_struct.keyframe_delete

bpy_struct.keyframe_insert bpy_struct.keys bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.type_recast bpy_struct.values ID.copy ID.user_clear ID.animation_data_create ID.animation_data_clear

References

BlendData.scenes CompositorNodeRLayers.scene Context.scene Image.save_render MainScenes.new MainScenes.remove Object.create_dupli_list Object.create_mesh

Object.is_visible Object.update RenderEngine.render Scene.background_set SceneActuator.scene SceneSequence.scene Screen.scene