Scene(ID)¶
base classes — bpy_struct
, ID
- class bpy.types.Scene(ID)¶
Scene data-block, consisting in objects and defining time and render related settings
- active_clip¶
Active Movie Clip that can be used by motion tracking constraints or as a camera’s background image
- Type:
- audio_distance_model¶
Distance model for distance attenuation calculation
NONE
None – No distance attenuation.INVERSE
Inverse – Inverse distance model.INVERSE_CLAMPED
Inverse Clamped – Inverse distance model with clamping.LINEAR
Linear – Linear distance model.LINEAR_CLAMPED
Linear Clamped – Linear distance model with clamping.EXPONENT
Exponential – Exponential distance model.EXPONENT_CLAMPED
Exponential Clamped – Exponential distance model with clamping.
- 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 1.0
- audio_doppler_speed¶
Speed of sound for Doppler effect calculation
- Type:
float in [0.01, inf], default 343.3
- audio_volume¶
Audio volume
- Type:
float in [0, 100], default 1.0
- collection¶
Scene root collection that owns all the objects and other collections instantiated in the scene
- Type:
Collection
, (readonly, never None)
- cursor¶
- Type:
View3DCursor
, (readonly, never None)
- display¶
Scene display settings for 3D viewport
- Type:
SceneDisplay
, (readonly)
- display_settings¶
Settings of device saved image would be displayed on
- Type:
ColorManagedDisplaySettings
, (readonly)
- eevee¶
EEVEE settings for the scene
- Type:
SceneEEVEE
, (readonly)
- frame_current¶
Current frame, to update animation data from Python frame_set() instead
- Type:
int in [-1048574, 1048574], default 1
- frame_current_final¶
Current frame with subframe and time remapping applied
- Type:
float in [-1.04857e+06, 1.04857e+06], default 0.0, (readonly)
- frame_end¶
Final frame of the playback/rendering range
- Type:
int in [0, 1048574], default 250
- frame_float¶
- Type:
float in [-1.04857e+06, 1.04857e+06], default 0.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, 1048574], default 1
- frame_step¶
Number of frames to skip forward while rendering/playing back each frame
- Type:
int in [0, 1048574], default 1
- frame_subframe¶
- Type:
float in [0, 1], default 0.0
- game_settings¶
- Type:
SceneGameData
, (readonly, never None)
- gravity¶
Constant acceleration in a given direction
- Type:
mathutils.Vector
of 3 items in [-inf, inf], default (0.0, 0.0, -9.81)
- grease_pencil¶
Grease Pencil data-block used for annotations in the 3D view
- Type:
- grease_pencil_settings¶
Grease Pencil settings for the scene
- Type:
SceneGpencil
, (readonly)
- hydra¶
Hydra settings for the scene
- Type:
SceneHydra
, (readonly)
- is_nla_tweakmode¶
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
bpy_prop_collection
ofKeyingSet
, (readonly)
- keying_sets_all¶
All Keying Sets available for use (Builtins and Absolute Keying Sets for this Scene)
- Type:
KeyingSetsAll
bpy_prop_collection
ofKeyingSet
, (readonly)
- lock_frame_selection_to_range¶
Don’t allow frame to be selected with mouse outside of frame range
- Type:
boolean, default False
- objects¶
- Type:
SceneObjects
bpy_prop_collection
ofObject
, (readonly)
- render¶
- Type:
RenderSettings
, (readonly, never None)
- rigidbody_world¶
- Type:
RigidBodyWorld
, (readonly)
- safe_areas¶
- Type:
DisplaySafeAreas
, (readonly, never None)
- sequence_editor¶
- Type:
SequenceEditor
, (readonly)
- sequencer_colorspace_settings¶
Settings of color space sequencer is working in
- Type:
ColorManagedSequencerColorspaceSettings
, (readonly)
- show_keys_from_selected_only¶
Only include channels relating to selected objects and data
- Type:
boolean, default False
- show_subframe¶
Display and allow setting fractional frame values for the current frame
- Type:
boolean, default False
- simulation_frame_end¶
Frame at which simulations end
- Type:
int in [-inf, inf], default 250
- simulation_frame_start¶
Frame at which simulations start
- Type:
int in [-inf, inf], default 1
- sync_mode¶
How to sync playback
NONE
Play Every Frame – Do not sync, play every frame.FRAME_DROP
Frame Dropping – Drop frames if playback is too slow.AUDIO_SYNC
Sync to Audio – Sync to audio playback, dropping frames.
- Type:
enum in [‘NONE’, ‘FRAME_DROP’, ‘AUDIO_SYNC’], default ‘AUDIO_SYNC’
- timeline_markers¶
Markers used in all timelines for the current scene
- Type:
TimelineMarkers
bpy_prop_collection
ofTimelineMarker
, (readonly)
- tool_settings¶
- Type:
ToolSettings
, (readonly, never None)
- transform_orientation_slots¶
- Type:
bpy_prop_collection
ofTransformOrientationSlot
, (readonly)
- unit_settings¶
Unit editing settings
- Type:
UnitSettings
, (readonly, never None)
- use_audio¶
Play back of audio from Sequence Editor, otherwise mute audio
- Type:
boolean, default False
- use_audio_scrub¶
Play audio from Sequence Editor while scrubbing
- Type:
boolean, default False
- use_custom_simulation_range¶
Use a simulation range that is different from the scene range for simulation nodes that don’t override the frame range themselves
- Type:
boolean, default False
- use_gravity¶
Use global gravity for all dynamics
- Type:
boolean, default True
- use_nodes¶
Enable the compositing node tree
- Type:
boolean, default False
- use_preview_range¶
Use an alternative start/end frame range for animation playback and view renders
- Type:
boolean, default False
- use_stamp_note¶
User defined note for the render stamping
- Type:
string, default “”, (never None)
- view_layers¶
- Type:
ViewLayers
bpy_prop_collection
ofViewLayer
, (readonly)
- view_settings¶
Color management settings applied on image before saving
- Type:
ColorManagedViewSettings
, (readonly)
- classmethod update_render_engine()¶
Trigger a render engine update
- statistics(view_layer)¶
statistics
- Parameters:
view_layer (
ViewLayer
, (never None)) – View Layer- Returns:
Statistics
- Return type:
string, (never None)
- frame_set(frame, *, subframe=0.0)¶
Set scene frame updating all objects immediately
- Parameters:
frame (int in [-1048574, 1048574]) – Frame number to set
subframe (float in [0, 1], (optional)) – Subframe time, between 0.0 and 1.0
- uvedit_aspect(object)¶
Get uv aspect for current object
- Parameters:
object (
Object
, (never None)) – Object- Returns:
aspect
- Return type:
mathutils.Vector
of 2 items in [0, inf]
- ray_cast(depsgraph, origin, direction, *, distance=1.70141e+38)¶
Cast a ray onto in object space
- Parameters:
depsgraph (
Depsgraph
, (never None)) – The current dependency graphdistance (float in [0, inf], (optional)) – Maximum distance
- Return (result, location, normal, index, object, matrix):
result, boolean
location, The hit location of this ray cast,
mathutils.Vector
of 3 items in [-inf, inf]normal, The face normal at the ray cast hit location,
mathutils.Vector
of 3 items in [-inf, inf]index, The face index, -1 when original data isn’t available, int in [-inf, inf]
object, Ray cast object,
Object
matrix, Matrix,
mathutils.Matrix
of 4 * 4 items in [-inf, inf]
- sequence_editor_create()¶
Ensure sequence editor is valid in this scene
- Returns:
New sequence editor data or nullptr
- Return type:
- sequence_editor_clear()¶
Clear sequence editor in this scene
- alembic_export(filepath, *, frame_start=1, frame_end=1, xform_samples=1, geom_samples=1, shutter_open=0.0, shutter_close=1.0, selected_only=False, uvs=True, normals=True, vcolors=False, apply_subdiv=True, flatten=False, visible_objects_only=False, face_sets=False, subdiv_schema=False, export_hair=True, export_particles=True, packuv=False, scale=1.0, triangulate=False, quad_method='BEAUTY', ngon_method='BEAUTY')¶
Export to Alembic file (deprecated, use the Alembic export operator)
- Parameters:
filepath (string, (never None)) – File Path, File path to write Alembic file
frame_start (int in [-inf, inf], (optional)) – Start, Start Frame
frame_end (int in [-inf, inf], (optional)) – End, End Frame
xform_samples (int in [1, 128], (optional)) – Xform samples, Transform samples per frame
geom_samples (int in [1, 128], (optional)) – Geom samples, Geometry samples per frame
shutter_open (float in [-1, 1], (optional)) – Shutter open
shutter_close (float in [-1, 1], (optional)) – Shutter close
selected_only (boolean, (optional)) – Selected only, Export only selected objects
uvs (boolean, (optional)) – UVs, Export UVs
normals (boolean, (optional)) – Normals, Export normals
vcolors (boolean, (optional)) – Color Attributes, Export color attributes
apply_subdiv (boolean, (optional)) – Subsurfs as meshes, Export subdivision surfaces as meshes
flatten (boolean, (optional)) – Flatten hierarchy, Flatten hierarchy
visible_objects_only (boolean, (optional)) – Visible layers only, Export only objects in visible layers
face_sets (boolean, (optional)) – Facesets, Export face sets
subdiv_schema (boolean, (optional)) – Use Alembic subdivision Schema, Use Alembic subdivision Schema
export_hair (boolean, (optional)) – Export Hair, Exports hair particle systems as animated curves
export_particles (boolean, (optional)) – Export Particles, Exports non-hair particle systems
packuv (boolean, (optional)) – Export with packed UV islands, Export with packed UV islands
scale (float in [0.0001, 1000], (optional)) – Scale, Value by which to enlarge or shrink the objects with respect to the world’s origin
triangulate (boolean, (optional)) – Triangulate, Export polygons (quads and n-gons) as triangles
quad_method (enum in Modifier Triangulate Quad Method Items, (optional)) – Quad Method, Method for splitting the quads into triangles
ngon_method (enum in Modifier Triangulate Ngon Method Items, (optional)) – N-gon Method, Method for splitting the n-gons into triangles
- classmethod bl_rna_get_subclass(id, default=None)¶
- Parameters:
id (str) – 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 (str) – The RNA type identifier.
- Returns:
The class or default when not found.
- Return type:
type