Change Log

Changes in Blender’s Python API between releases.

3.6 to 4.0

bpy.types.AreaLight

Removed

• constant_coefficient

• falloff_curve

• falloff_type

• linear_attenuation

• linear_coefficient

• quadratic_coefficient

• shadow_buffer_samples

• shadow_buffer_size

Renamed

• quadratic_attenuation -> bpy.types.AreaLight.shadow_softness_factor

bpy.types.Armature

Added

• bpy.types.Armature.collections

Removed

• layers

• layers_protected

Renamed

• show_group_colors -> bpy.types.Armature.show_bone_colors

bpy.types.AssetHandle

Removed

• get_full_library_path

• local_id

bpy.types.AssetRepresentation

Added

• bpy.types.AssetRepresentation.full_library_path

• bpy.types.AssetRepresentation.full_path

• bpy.types.AssetRepresentation.id_type

• bpy.types.AssetRepresentation.local_id

• bpy.types.AssetRepresentation.metadata

• bpy.types.AssetRepresentation.name

bpy.types.Attribute

Added

• bpy.types.Attribute.is_required

bpy.types.Bone

Added

• bpy.types.Bone.bbone_mapping_mode

• bpy.types.Bone.collections

• bpy.types.Bone.color

Removed

• layers

• use_inherit_scale

bpy.types.BrushGpencilSettings

Added

• bpy.types.BrushGpencilSettings.use_active_layer_only

• bpy.types.BrushGpencilSettings.use_keep_caps_eraser

bpy.types.Camera

Added

• bpy.types.Camera.fisheye_fov

• bpy.types.Camera.fisheye_lens

• bpy.types.Camera.fisheye_polynomial_k0

• bpy.types.Camera.fisheye_polynomial_k1

• bpy.types.Camera.fisheye_polynomial_k2

• bpy.types.Camera.fisheye_polynomial_k3

• bpy.types.Camera.fisheye_polynomial_k4

• bpy.types.Camera.latitude_max

• bpy.types.Camera.latitude_min

• bpy.types.Camera.longitude_max

• bpy.types.Camera.longitude_min

• bpy.types.Camera.panorama_type

Removed

• cycles

bpy.types.Collection

Added

• bpy.types.Collection.collection_children

• bpy.types.Collection.collection_objects

bpy.types.ColorManagedViewSettings

Added

• bpy.types.ColorManagedViewSettings.use_hdr_view

bpy.types.Context

Renamed

• asset_file_handle -> bpy.types.Context.asset

bpy.types.Curves

Added

• bpy.types.Curves.add_curves

bpy.types.CyclesPreferences

Added

• bpy.types.CyclesPreferences.metalrt

Removed

• use_metalrt

bpy.types.CyclesRenderSettings

Added

• bpy.types.CyclesRenderSettings.guiding_directional_sampling_type

• bpy.types.CyclesRenderSettings.guiding_roughness_threshold

bpy.types.Depsgraph

Function Arguments

• bpy.types.Depsgraph.debug_relations_graphviz (filepath), was (filename)

• bpy.types.Depsgraph.debug_stats_gnuplot (filepath, output_filepath), was (filename, output_filename)

bpy.types.EditBone

Added

• bpy.types.EditBone.bbone_mapping_mode

• bpy.types.EditBone.collections

• bpy.types.EditBone.color

Removed

• layers

• use_inherit_scale

bpy.types.EffectSequence

Added

• bpy.types.EffectSequence.multiply_alpha

bpy.types.FileAssetSelectIDFilter

Removed

• experimental_filter_simulation

bpy.types.FileAssetSelectParams

Renamed

• asset_library_ref -> bpy.types.FileAssetSelectParams.asset_library_reference

• import_type -> bpy.types.FileAssetSelectParams.import_method

bpy.types.FileSelectEntry

Removed

• id_type

• local_id

bpy.types.FileSelectIDFilter

Removed

• filter_simulation

bpy.types.FileSelectParams

Added

• bpy.types.FileSelectParams.display_size_discrete

bpy.types.GeometryNodeRealizeInstances

Removed

• legacy_behavior

bpy.types.GeometryNodeSetShadeSmooth

Added

• bpy.types.GeometryNodeSetShadeSmooth.domain

bpy.types.GeometryNodeTree

Added

• bpy.types.GeometryNodeTree.is_mode_edit

• bpy.types.GeometryNodeTree.is_mode_sculpt

• bpy.types.GeometryNodeTree.is_modifier

• bpy.types.GeometryNodeTree.is_tool

• bpy.types.GeometryNodeTree.is_type_curve

• bpy.types.GeometryNodeTree.is_type_mesh

• bpy.types.GeometryNodeTree.is_type_point_cloud

bpy.types.Gizmo

Removed

• draw_preset_facemap

bpy.types.IDOverrideLibrary

Added

• bpy.types.IDOverrideLibrary.resync

bpy.types.IDOverrideLibraryPropertyOperation

Added

• bpy.types.IDOverrideLibraryPropertyOperation.subitem_local_id

• bpy.types.IDOverrideLibraryPropertyOperation.subitem_reference_id

bpy.types.IDOverrideLibraryPropertyOperations

Function Arguments

• bpy.types.IDOverrideLibraryPropertyOperations.add (operation, use_id, subitem_reference_name, subitem_local_name, subitem_reference_id, subitem_local_id, subitem_reference_index, subitem_local_index), was (operation, subitem_reference_name, subitem_local_name, subitem_reference_index, subitem_local_index)

bpy.types.ImageFormatSettings

Removed

• use_zbuffer

bpy.types.ImageSequence

Added

• bpy.types.ImageSequence.multiply_alpha

Removed

• speed_factor

bpy.types.KeyConfigurations

Function Arguments

• bpy.types.KeyConfigurations.update (keep_properties), was ()

bpy.types.KeyMaps

Added

• bpy.types.KeyMaps.clear

bpy.types.Library

Added

• bpy.types.Library.needs_liboverride_resync

bpy.types.Light

Removed

• distance

bpy.types.LightProbe

Added

• bpy.types.LightProbe.grid_bake_samples

• bpy.types.LightProbe.grid_capture_emission

• bpy.types.LightProbe.grid_capture_indirect

• bpy.types.LightProbe.grid_capture_world

• bpy.types.LightProbe.grid_clamp_direct

• bpy.types.LightProbe.grid_clamp_indirect

• bpy.types.LightProbe.grid_dilation_radius

• bpy.types.LightProbe.grid_dilation_threshold

• bpy.types.LightProbe.grid_escape_bias

• bpy.types.LightProbe.grid_irradiance_smoothing

• bpy.types.LightProbe.grid_normal_bias

• bpy.types.LightProbe.grid_surface_bias

• bpy.types.LightProbe.grid_validity_threshold

• bpy.types.LightProbe.grid_view_bias

• bpy.types.LightProbe.resolution

• bpy.types.LightProbe.surfel_density

bpy.types.MaskSequence

Added

• bpy.types.MaskSequence.multiply_alpha

Removed

• speed_factor

bpy.types.Menu

Added

• bpy.types.Menu.bl_options

bpy.types.Mesh

Added

• bpy.types.Mesh.edge_creases_ensure

• bpy.types.Mesh.edge_creases_remove

• bpy.types.Mesh.vertex_creases_ensure

• bpy.types.Mesh.vertex_creases_remove

Removed

• calc_normals

• face_maps

• has_bevel_weight_edge

• has_bevel_weight_vertex

• has_crease_edge

• has_crease_vertex

• polygon_layers_float

• polygon_layers_int

• polygon_layers_string

• sculpt_vertex_colors

• vertex_layers_float

• vertex_layers_int

• vertex_layers_string

Function Arguments

• bpy.types.Mesh.split_faces (), was (free_loop_normals)

bpy.types.MeshEdge

Removed

• bevel_weight

• crease

bpy.types.MeshToVolumeModifier

Removed

• exterior_band_width

• use_fill_volume

bpy.types.MeshVertex

Removed

• bevel_weight

bpy.types.MetaSequence

Added

• bpy.types.MetaSequence.multiply_alpha

Removed

• speed_factor

bpy.types.MovieClipSequence

Added

• bpy.types.MovieClipSequence.multiply_alpha

Removed

• speed_factor

bpy.types.MovieSequence

Added

• bpy.types.MovieSequence.multiply_alpha

• bpy.types.MovieSequence.retiming_keys

Removed

• speed_factor

bpy.types.Node

Removed

• width_hidden

bpy.types.NodeSocket

Added

• bpy.types.NodeSocket.draw_color_simple

bpy.types.NodeSocketStandard

Added

• bpy.types.NodeSocketStandard.draw_color_simple

bpy.types.NodeTree

Added

• bpy.types.NodeTree.interface

Removed

• active_input

• active_output

• inputs

• outputs

bpy.types.NodesModifier

Added

• bpy.types.NodesModifier.bakes

• bpy.types.NodesModifier.show_group_selector

bpy.types.Object

Added

• bpy.types.Object.hide_probe_cubemap

• bpy.types.Object.hide_probe_volume

• bpy.types.Object.light_linking

Removed

• face_maps

bpy.types.ParticleSettings

Renamed

• child_nbr -> bpy.types.ParticleSettings.child_percent

bpy.types.PointLight

Removed

• constant_coefficient

• falloff_curve

• falloff_type

• linear_attenuation

• linear_coefficient

• quadratic_coefficient

• shadow_buffer_samples

• shadow_buffer_size

Renamed

• quadratic_attenuation -> bpy.types.PointLight.shadow_softness_factor

bpy.types.Pose

Removed

• bone_groups

bpy.types.PoseBone

Added

• bpy.types.PoseBone.bbone_segment_index

Removed

• bone_group_index

Renamed

• bone_group -> bpy.types.PoseBone.color

bpy.types.Preferences

Added

• bpy.types.Preferences.use_recent_searches

bpy.types.PreferencesEdit

Added

• bpy.types.PreferencesEdit.node_preview_resolution

• bpy.types.PreferencesEdit.node_use_insert_offset

bpy.types.PreferencesExperimental

Removed

• enable_workbench_next

Renamed

• use_full_frame_compositor -> bpy.types.PreferencesExperimental.enable_overlay_next

• use_full_frame_compositor -> bpy.types.PreferencesExperimental.use_eevee_debug

• use_full_frame_compositor -> bpy.types.PreferencesExperimental.use_experimental_compositors

• use_full_frame_compositor -> bpy.types.PreferencesExperimental.use_extension_repos

• use_full_frame_compositor -> bpy.types.PreferencesExperimental.use_grease_pencil_version3

• use_full_frame_compositor -> bpy.types.PreferencesExperimental.use_shader_node_previews

bpy.types.PreferencesFilePaths

Added

• bpy.types.PreferencesFilePaths.active_extension_repo

• bpy.types.PreferencesFilePaths.extension_repos

• bpy.types.PreferencesFilePaths.text_editor

• bpy.types.PreferencesFilePaths.text_editor_args

bpy.types.PreferencesSystem

Added

• bpy.types.PreferencesSystem.is_microsoft_store_install

• bpy.types.PreferencesSystem.register_all_users

bpy.types.PreferencesView

Added

• bpy.types.PreferencesView.playback_fps_samples

Renamed

• use_directional_menus -> bpy.types.PreferencesView.use_fresnel_edit

• use_directional_menus -> bpy.types.PreferencesView.use_text_render_subpixelaa

bpy.types.RenderEngine

Added

• bpy.types.RenderEngine.bl_use_materialx

bpy.types.RenderLayer

Function Arguments

• bpy.types.RenderLayer.load_from_file (filepath, x, y), was (filename, x, y)

bpy.types.RenderResult

Function Arguments

• bpy.types.RenderResult.load_from_file (filepath), was (filename)

bpy.types.Scene

Added

• bpy.types.Scene.hydra

• bpy.types.Scene.simulation_frame_end

• bpy.types.Scene.simulation_frame_start

• bpy.types.Scene.use_custom_simulation_range

bpy.types.SceneEEVEE

Added

• bpy.types.SceneEEVEE.diffuse_options

• bpy.types.SceneEEVEE.gi_irradiance_pool_size

• bpy.types.SceneEEVEE.ray_split_settings

• bpy.types.SceneEEVEE.ray_tracing_method

• bpy.types.SceneEEVEE.reflection_options

• bpy.types.SceneEEVEE.refraction_options

• bpy.types.SceneEEVEE.shadow_normal_bias

• bpy.types.SceneEEVEE.shadow_ray_count

• bpy.types.SceneEEVEE.shadow_step_count

bpy.types.SceneSequence

Added

• bpy.types.SceneSequence.multiply_alpha

Removed

• speed_factor

bpy.types.Sculpt

Removed

• use_smooth_shading

bpy.types.Sequence

Added

• bpy.types.Sequence.show_retiming_keys

bpy.types.SequenceEditor

Added

• bpy.types.SequenceEditor.selected_retiming_keys

bpy.types.SequencerTimelineOverlay

Added

• bpy.types.SequencerTimelineOverlay.show_strip_retiming

bpy.types.ShaderNodeBsdfHairPrincipled

Added

• bpy.types.ShaderNodeBsdfHairPrincipled.model

bpy.types.ShaderNodeTexNoise

Added

• bpy.types.ShaderNodeTexNoise.normalize

bpy.types.ShaderNodeTexVoronoi

Added

• bpy.types.ShaderNodeTexVoronoi.normalize

bpy.types.SoundSequence

Removed

• speed_factor

bpy.types.SpaceDopeSheetEditor

Added

• bpy.types.SpaceDopeSheetEditor.show_region_channels

Removed

• auto_snap

bpy.types.SpaceGraphEditor

Added

• bpy.types.SpaceGraphEditor.show_region_channels

Removed

• auto_snap

bpy.types.SpaceNLA

Added

• bpy.types.SpaceNLA.show_region_channels

Removed

• auto_snap

bpy.types.SpaceNodeEditor

Added

• bpy.types.SpaceNodeEditor.geometry_nodes_tool_tree

• bpy.types.SpaceNodeEditor.geometry_nodes_type

Renamed

• use_insert_offset -> bpy.types.SpaceNodeEditor.supports_previews

bpy.types.SpaceNodeOverlay

Added

• bpy.types.SpaceNodeOverlay.preview_shape

• bpy.types.SpaceNodeOverlay.show_previews

bpy.types.SpaceSpreadsheet

Added

• bpy.types.SpaceSpreadsheet.show_region_toolbar

bpy.types.SpaceView3D

Added

• bpy.types.SpaceView3D.show_region_asset_shelf

bpy.types.SpotLight

Removed

• constant_coefficient

• falloff_curve

• falloff_type

• linear_attenuation

• linear_coefficient

• quadratic_coefficient

• shadow_buffer_samples

• shadow_buffer_size

Renamed

• quadratic_attenuation -> bpy.types.SpotLight.shadow_softness_factor

bpy.types.SunLight

Added

• bpy.types.SunLight.shadow_softness_factor

• bpy.types.SunLight.shadow_trace_distance

Removed

• shadow_buffer_samples

• shadow_buffer_size

bpy.types.ThemeNLAEditor

Added

• bpy.types.ThemeNLAEditor.dopesheet_subchannel

bpy.types.ThemeNodeEditor

Added

• bpy.types.ThemeNodeEditor.repeat_zone

bpy.types.ThemeSequenceEditor

Added

• bpy.types.ThemeSequenceEditor.keyframe_border

• bpy.types.ThemeSequenceEditor.keyframe_border_selected

• bpy.types.ThemeSequenceEditor.keyframe_breakdown

• bpy.types.ThemeSequenceEditor.keyframe_breakdown_selected

• bpy.types.ThemeSequenceEditor.keyframe_movehold

• bpy.types.ThemeSequenceEditor.keyframe_movehold_selected

• bpy.types.ThemeSequenceEditor.keyframe_selected

• bpy.types.ThemeSequenceEditor.transition_strip

bpy.types.ThemeUserInterface

Removed

• wcol_view_item

bpy.types.ThemeView3D

Added

• bpy.types.ThemeView3D.asset_shelf

bpy.types.ToolSettings

Added

• bpy.types.ToolSettings.snap_anim_element

• bpy.types.ToolSettings.snap_elements_base

• bpy.types.ToolSettings.snap_elements_individual

• bpy.types.ToolSettings.use_snap_anim

Renamed

• use_snap_project -> bpy.types.ToolSettings.use_snap_time_absolute

bpy.types.UILayout

Added

• bpy.types.UILayout.progress

• bpy.types.UILayout.template_light_linking_collection

• bpy.types.UILayout.template_modifier_asset_menu_items

• bpy.types.UILayout.template_node_operator_asset_menu_items

• bpy.types.UILayout.template_node_operator_asset_root_items

• bpy.types.UILayout.template_node_tree_interface

Function Arguments

• bpy.types.UILayout.template_image_settings (image_settings, color_management), was (image_settings, color_management, show_z_buffer)

bpy.types.ViewerPathElem

Added

• bpy.types.ViewerPathElem.ui_name

bpy.types.WorkSpace

Renamed

• asset_library_ref -> bpy.types.WorkSpace.asset_library_reference

bpy.types.World

Added

• bpy.types.World.probe_resolution

bpy.types.WorldLighting

Removed

• use_ambient_occlusion