Change Log

Changes in Blender’s Python API between releases.

4.1 to 4.2

bpy.types.AnimVizMotionPaths

Renamed

• bake_in_camera_space -> bpy.types.AnimVizMotionPaths.use_camera_space_bake

bpy.types.AreaLight

Added

• bpy.types.AreaLight.shadow_filter_radius

• bpy.types.AreaLight.shadow_jitter_overblur

• bpy.types.AreaLight.shadow_maximum_resolution

• bpy.types.AreaLight.use_absolute_resolution

• bpy.types.AreaLight.use_shadow_jitter

Removed

• shadow_softness_factor

• use_shadow

bpy.types.AssetShelf

Added

• bpy.types.AssetShelf.bl_activate_operator

• bpy.types.AssetShelf.bl_default_preview_size

• bpy.types.AssetShelf.get_active_asset

bpy.types.Brush

Removed

• uv_sculpt_tool

bpy.types.BrushCurvesSculptSettings

Added

• bpy.types.BrushCurvesSculptSettings.curve_radius

• bpy.types.BrushCurvesSculptSettings.use_radius_interpolate

Removed

• interpolate_length

• interpolate_point_count

• interpolate_shape

Renamed

• scale_uniform -> bpy.types.BrushCurvesSculptSettings.use_length_interpolate

• scale_uniform -> bpy.types.BrushCurvesSculptSettings.use_point_count_interpolate

• scale_uniform -> bpy.types.BrushCurvesSculptSettings.use_shape_interpolate

• scale_uniform -> bpy.types.BrushCurvesSculptSettings.use_uniform_scale

bpy.types.Collection

Added

• bpy.types.Collection.active_exporter_index

• bpy.types.Collection.exporters

bpy.types.CompositorNodeBoxMask

Renamed

• height -> bpy.types.CompositorNodeBoxMask.mask_height

• width -> bpy.types.CompositorNodeBoxMask.mask_width

bpy.types.CompositorNodeEllipseMask

Renamed

• height -> bpy.types.CompositorNodeEllipseMask.mask_height

• width -> bpy.types.CompositorNodeEllipseMask.mask_width

bpy.types.CompositorNodeTranslate

Added

• bpy.types.CompositorNodeTranslate.interpolation

bpy.types.CompositorNodeTree

Removed

• chunk_size

• edit_quality

• execution_mode

• precision

• render_quality

• use_groupnode_buffer

• use_opencl

• use_two_pass

bpy.types.CompositorNodeViewer

Removed

• center_x

• center_y

• tile_order

bpy.types.Context

Added

• bpy.types.Context.region_popup

bpy.types.CurvePaintSettings

Added

• bpy.types.CurvePaintSettings.use_project_only_selected

bpy.types.CyclesLightSettings

Removed

• cast_shadow

bpy.types.CyclesPreferences

Added

• bpy.types.CyclesPreferences.default_device

• bpy.types.CyclesPreferences.get_device_list

• bpy.types.CyclesPreferences.has_optixdenoiser_gpu_devices

bpy.types.CyclesRenderSettings

Added

• bpy.types.CyclesRenderSettings.denoising_quality

• bpy.types.CyclesRenderSettings.preview_denoising_quality

Removed

• debug_use_cpu_sse41

• motion_blur_position

Renamed

• debug_use_cpu_sse2 -> bpy.types.CyclesRenderSettings.debug_use_cpu_sse42

bpy.types.FCurve

Added

• bpy.types.FCurve.bake

bpy.types.FileHandler

Added

• bpy.types.FileHandler.bl_export_operator

bpy.types.FunctionNodeInputColor

Renamed

• color -> bpy.types.FunctionNodeInputColor.value

bpy.types.GeometryNodeCaptureAttribute

Added

• bpy.types.GeometryNodeCaptureAttribute.active_index

• bpy.types.GeometryNodeCaptureAttribute.active_item

• bpy.types.GeometryNodeCaptureAttribute.capture_items

Removed

• data_type

bpy.types.GeometryNodeMenuSwitch

Added

• bpy.types.GeometryNodeMenuSwitch.active_index

• bpy.types.GeometryNodeMenuSwitch.active_item

• bpy.types.GeometryNodeMenuSwitch.enum_items

bpy.types.GeometryNodeMeshBoolean

Added

• bpy.types.GeometryNodeMeshBoolean.solver

bpy.types.GeometryNodeRemoveAttribute

Added

• bpy.types.GeometryNodeRemoveAttribute.pattern_mode

bpy.types.GeometryNodeTransform

Added

• bpy.types.GeometryNodeTransform.mode

bpy.types.GeometryNodeTree

Added

• bpy.types.GeometryNodeTree.use_wait_for_click

bpy.types.GizmoGroup

Removed

• has_reports

bpy.types.GreasePencilOffsetModifier

Added

• bpy.types.GreasePencilOffsetModifier.open_general_panel

bpy.types.GreasePencilSubdivModifier

Removed

• invert_vertex_group

• vertex_group_name

bpy.types.ID

Added

• bpy.types.ID.is_editable

Function Arguments

• bpy.types.ID.make_local (clear_proxy, clear_liboverride, clear_asset_data), was (clear_proxy, clear_liboverride)

bpy.types.Library

Added

• bpy.types.Library.is_editable

bpy.types.Light

Added

• bpy.types.Light.transmission_factor

• bpy.types.Light.use_shadow

bpy.types.LightProbe

Removed

• clip_end

• falloff

• grid_bake_samples

• grid_capture_emission

• grid_capture_indirect

• grid_capture_world

• grid_clamp_direct

• grid_clamp_indirect

• grid_dilation_radius

• grid_dilation_threshold

• grid_escape_bias

• grid_irradiance_smoothing

• grid_normal_bias

• grid_resolution_x

• grid_resolution_y

• grid_resolution_z

• grid_surface_bias

• grid_validity_threshold

• grid_view_bias

• influence_type

• intensity

• parallax_distance

• parallax_type

• show_parallax

• surfel_density

• use_custom_parallax

bpy.types.LimitRotationConstraint

Added

• bpy.types.LimitRotationConstraint.use_legacy_behavior

bpy.types.Macro

Function Arguments

• bpy.types.Macro.define (operator), was (opname)

bpy.types.Material

Added

• bpy.types.Material.thickness_mode

Renamed

• lightprobe_volume_single_sided -> bpy.types.Material.use_backface_culling_lightprobe_volume

• lightprobe_volume_single_sided -> bpy.types.Material.use_raytrace_refraction

• lightprobe_volume_single_sided -> bpy.types.Material.use_thickness_from_shadow

• lightprobe_volume_single_sided -> bpy.types.Material.use_transparency_overlap

bpy.types.Menu

Function Arguments

• bpy.types.Menu.path_menu (self, searchpaths, operator, props_default, prop_filepath, filter_ext, filter_path, display_name, add_operator, add_operator_props), was (self, searchpaths, operator, props_default, prop_filepath, filter_ext, filter_path, display_name, add_operator)

bpy.types.Modifier

Added

• bpy.types.Modifier.use_pin_to_last

bpy.types.MotionPath

Added

• bpy.types.MotionPath.color_post

bpy.types.MovieClipProxy

Removed

• build_free_run

• build_free_run_rec_date

bpy.types.NodeInputs

Function Arguments

• bpy.types.NodeInputs.new (type, name, identifier, use_multi_input), was (type, name, identifier)

bpy.types.NodeOutputs

Function Arguments

• bpy.types.NodeOutputs.new (type, name, identifier, use_multi_input), was (type, name, identifier)

bpy.types.NodeTree

Added

• bpy.types.NodeTree.color_tag

• bpy.types.NodeTree.description

bpy.types.NodeTreeInterface

Function Arguments

• bpy.types.NodeTreeInterface.new_panel (name, description, default_closed), was (name, description, default_closed, parent)

bpy.types.NodeTreeInterfaceSocket

Added

• bpy.types.NodeTreeInterfaceSocket.is_inspect_output

bpy.types.Object

Added

• bpy.types.Object.active_selection_set

• bpy.types.Object.selection_sets

bpy.types.OperatorStrokeElement

Removed

• pen_flip

bpy.types.PointLight

Added

• bpy.types.PointLight.shadow_filter_radius

• bpy.types.PointLight.shadow_jitter_overblur

• bpy.types.PointLight.shadow_maximum_resolution

• bpy.types.PointLight.use_absolute_resolution

• bpy.types.PointLight.use_shadow_jitter

Removed

• shadow_softness_factor

• use_shadow

bpy.types.PoseBone

Added

• bpy.types.PoseBone.custom_shape_wire_width

bpy.types.Preferences

Added

• bpy.types.Preferences.extensions

bpy.types.PreferencesEdit

Added

• bpy.types.PreferencesEdit.use_sequencer_simplified_tweaking

bpy.types.PreferencesExperimental

Removed

• use_extension_repos

Renamed

• use_experimental_compositors -> bpy.types.PreferencesExperimental.use_animation_baklava

• use_experimental_compositors -> bpy.types.PreferencesExperimental.use_extensions_debug

• use_experimental_compositors -> bpy.types.PreferencesExperimental.use_grease_pencil_version3_convert_on_load

• use_experimental_compositors -> bpy.types.PreferencesExperimental.use_recompute_usercount_on_save_debug

bpy.types.PreferencesFilePaths

Added

• bpy.types.PreferencesFilePaths.use_extension_online_access_handled

Removed

• active_extension_repo

• extension_repos

bpy.types.PreferencesInput

Added

• bpy.types.PreferencesInput.touchpad_scroll_direction

Removed

• use_ndof

bpy.types.PreferencesSystem

Added

• bpy.types.PreferencesSystem.max_shader_compilation_subprocesses

• bpy.types.PreferencesSystem.network_connection_limit

• bpy.types.PreferencesSystem.network_timeout

• bpy.types.PreferencesSystem.use_online_access

bpy.types.PreferencesView

Added

• bpy.types.PreferencesView.show_extensions_updates

bpy.types.RaytraceEEVEE

Added

• bpy.types.RaytraceEEVEE.trace_max_roughness

Removed

• sample_clamp

• screen_trace_max_roughness

bpy.types.Region

Added

• bpy.types.Region.tag_refresh_ui

bpy.types.RenderSettings

Added

• bpy.types.RenderSettings.compositor_device

• bpy.types.RenderSettings.compositor_precision

• bpy.types.RenderSettings.motion_blur_position

Removed

• simplify_shadows

• simplify_shadows_render

bpy.types.SceneEEVEE

Added

• bpy.types.SceneEEVEE.clamp_surface_direct

• bpy.types.SceneEEVEE.clamp_surface_indirect

• bpy.types.SceneEEVEE.clamp_volume_direct

• bpy.types.SceneEEVEE.clamp_volume_indirect

• bpy.types.SceneEEVEE.fast_gi_distance

• bpy.types.SceneEEVEE.fast_gi_method

• bpy.types.SceneEEVEE.fast_gi_ray_count

• bpy.types.SceneEEVEE.fast_gi_resolution

• bpy.types.SceneEEVEE.fast_gi_step_count

• bpy.types.SceneEEVEE.fast_gi_thickness_far

• bpy.types.SceneEEVEE.fast_gi_thickness_near

• bpy.types.SceneEEVEE.shadow_resolution_scale

Removed

• gi_auto_bake

• gi_cache_info

• horizon_thickness

• motion_blur_position

• motion_blur_shutter

• shadow_normal_bias

Renamed

• horizon_bias -> bpy.types.SceneEEVEE.fast_gi_bias

• horizon_quality -> bpy.types.SceneEEVEE.fast_gi_quality

• use_motion_blur -> bpy.types.SceneEEVEE.use_shadow_jitter_viewport

• use_motion_blur -> bpy.types.SceneEEVEE.use_volume_custom_range

bpy.types.SequenceEditor

Removed

• show_cache

• show_cache_final_out

• show_cache_preprocessed

• show_cache_raw

Renamed

• show_cache_composite -> bpy.types.SequenceEditor.show_missing_media

bpy.types.SequenceProxy

Removed

• build_free_run

• build_free_run_rec_date

bpy.types.SequencerToolSettings

Added

• bpy.types.SequencerToolSettings.snap_to_markers

bpy.types.ShaderNodeOutputAOV

Renamed

• name -> bpy.types.ShaderNodeOutputAOV.aov_name

bpy.types.SpaceClipEditor

Added

• bpy.types.SpaceClipEditor.zoom_percentage

bpy.types.SpaceGraphEditor

Renamed

• autolock_translation_axis -> bpy.types.SpaceGraphEditor.use_auto_lock_translation_axis

bpy.types.SpaceImageEditor

Added

• bpy.types.SpaceImageEditor.show_region_asset_shelf

• bpy.types.SpaceImageEditor.zoom_percentage

bpy.types.SpaceNodeOverlay

Added

• bpy.types.SpaceNodeOverlay.show_reroute_auto_labels

bpy.types.SpaceSequenceEditor

Added

• bpy.types.SpaceSequenceEditor.cache_overlay

• bpy.types.SpaceSequenceEditor.zoom_percentage

Removed

• show_separate_color

bpy.types.SpaceUVEditor

Added

• bpy.types.SpaceUVEditor.stretch_opacity

bpy.types.SpotLight

Added

• bpy.types.SpotLight.shadow_filter_radius

• bpy.types.SpotLight.shadow_jitter_overblur

• bpy.types.SpotLight.shadow_maximum_resolution

• bpy.types.SpotLight.use_absolute_resolution

• bpy.types.SpotLight.use_shadow_jitter

Removed

• shadow_softness_factor

• use_shadow

bpy.types.SunLight

Added

• bpy.types.SunLight.shadow_filter_radius

• bpy.types.SunLight.shadow_jitter_overblur

• bpy.types.SunLight.shadow_maximum_resolution

• bpy.types.SunLight.use_shadow_jitter

Removed

• shadow_softness_factor

• shadow_trace_distance

• use_shadow

bpy.types.TextSequence

Added

• bpy.types.TextSequence.outline_color

• bpy.types.TextSequence.outline_width

• bpy.types.TextSequence.shadow_angle

• bpy.types.TextSequence.shadow_blur

• bpy.types.TextSequence.shadow_offset

• bpy.types.TextSequence.use_outline

bpy.types.Theme

Added

• bpy.types.Theme.filepath

bpy.types.ThemeDopeSheet

Added

• bpy.types.ThemeDopeSheet.keyframe_generated

• bpy.types.ThemeDopeSheet.keyframe_generated_selected

bpy.types.ThemeImageEditor

Added

• bpy.types.ThemeImageEditor.asset_shelf

Removed

• vertex_active

bpy.types.ThemeSequenceEditor

Added

• bpy.types.ThemeSequenceEditor.keyframe_generated

• bpy.types.ThemeSequenceEditor.keyframe_generated_selected

bpy.types.ThemeView3D

Removed

• vertex_active

bpy.types.ToolSettings

Added

• bpy.types.ToolSettings.snap_angle_increment_2d

• bpy.types.ToolSettings.snap_angle_increment_2d_precision

• bpy.types.ToolSettings.snap_angle_increment_3d

• bpy.types.ToolSettings.snap_angle_increment_3d_precision

Removed

• use_gpencil_stroke_endpoints

• uv_relax_method

Renamed

• use_snap_uv_grid_absolute -> bpy.types.ToolSettings.use_annotation_project_only_selected

• use_snap_uv_grid_absolute -> bpy.types.ToolSettings.use_annotation_stroke_endpoints

• use_snap_uv_grid_absolute -> bpy.types.ToolSettings.use_gpencil_project_only_selected

bpy.types.UILayout

Added

• bpy.types.UILayout.context_string_set

• bpy.types.UILayout.template_asset_shelf_popover

• bpy.types.UILayout.template_collection_exporters

• bpy.types.UILayout.template_popup_confirm

Function Arguments

• bpy.types.UILayout.operator (operator, text, text_ctxt, translate, icon, emboss, depress, icon_value, search_weight), was (operator, text, text_ctxt, translate, icon, emboss, depress, icon_value)

• bpy.types.UILayout.separator (factor, type), was (factor)

bpy.types.USERPREF_UL_extension_repos

Added

• bpy.types.USERPREF_UL_extension_repos.filter_items

bpy.types.UserExtensionRepo

Added

• bpy.types.UserExtensionRepo.source

Renamed

• remote_path -> bpy.types.UserExtensionRepo.access_token

• remote_path -> bpy.types.UserExtensionRepo.remote_url

• use_remote_path -> bpy.types.UserExtensionRepo.use_access_token

• use_remote_path -> bpy.types.UserExtensionRepo.use_remote_url

• use_remote_path -> bpy.types.UserExtensionRepo.use_sync_on_startup

bpy.types.UserExtensionRepoCollection

Function Arguments

• bpy.types.UserExtensionRepoCollection.new (name, module, custom_directory, remote_url, source), was (name, module, custom_directory, remote_path)

bpy.types.UvSculpt

Added

• bpy.types.UvSculpt.curve_preset

• bpy.types.UvSculpt.size

• bpy.types.UvSculpt.strength

• bpy.types.UvSculpt.strength_curve

bpy.types.View3DOverlay

Added

• bpy.types.View3DOverlay.show_camera_guides

• bpy.types.View3DOverlay.show_camera_passepartout

bpy.types.ViewLayer

Added

• bpy.types.ViewLayer.has_export_collections

• bpy.types.ViewLayer.world_override

bpy.types.Window

Added

• bpy.types.Window.modal_operators

bpy.types.WindowManager

Added

• bpy.types.WindowManager.addon_tags

• bpy.types.WindowManager.extension_search

• bpy.types.WindowManager.extension_show_panel_available

• bpy.types.WindowManager.extension_show_panel_installed

• bpy.types.WindowManager.extension_tags

• bpy.types.WindowManager.extension_type

• bpy.types.WindowManager.extensions_blocked

• bpy.types.WindowManager.extensions_updates

• bpy.types.WindowManager.selected_action

Function Arguments

• bpy.types.WindowManager.invoke_props_dialog (operator, width, title, confirm_text, cancel_default, text_ctxt, translate), was (operator, width, title, confirm_text, text_ctxt, translate)

bpy.types.World

Added

• bpy.types.World.sun_angle

• bpy.types.World.sun_shadow_filter_radius

• bpy.types.World.sun_shadow_jitter_overblur

• bpy.types.World.sun_shadow_maximum_resolution

• bpy.types.World.sun_threshold

• bpy.types.World.use_eevee_finite_volume

• bpy.types.World.use_sun_shadow

• bpy.types.World.use_sun_shadow_jitter