Add motion blur support

COPYRIGHT.txt

@@ -198,6 +198,16 @@ Copyright: 2013, Jorge Jimenez
  2013, Diego Gutierrez
 License: Expat
 
+Files: servers/rendering/renderer_rd/shaders/effects/motion_blur_blur.glsl
+  servers/rendering/renderer_rd/shaders/effects/motion_blur_preprocess.glsl
+  servers/rendering/renderer_rd/shaders/effects/motion_blur_tile_max_x.glsl
+  servers/rendering/renderer_rd/shaders/effects/motion_blur_tile_max_y.glsl
+  servers/rendering/renderer_rd/shaders/effects/motion_blur_neighbor_max.glsl
+Comment: sphynx-owner's motion blur effect
+Copyright: 2025, sphynx-owner
+License: MIT
+
+
 Files: thirdparty/accesskit/*
 Comment: AccessKit
 Copyright: 2023, The AccessKit Authors.

doc/classes/CameraAttributesPractical.xml

@@ -42,6 +42,33 @@
 		</member>
 		<member name="dof_blur_near_transition" type="float" setter="set_dof_blur_near_transition" getter="get_dof_blur_near_transition" default="1.0">
 			When positive, distance over which blur effect will scale from 0 to [member dof_blur_amount], ending at [member dof_blur_near_distance]. When negative, uses physically-based scaling so depth of field effect will scale from 0 at [member dof_blur_near_distance] and will increase in a physically accurate way as objects get closer to the [Camera3D].
+		</member>
+				<member name="motion_blur_clamp_velocities_to_tile" type="bool" setter="set_motion_blur_clamp_velocities_to_tile" getter="is_motion_blur_clamp_velocities_to_tile" default="true">
+			When true, object blur will be clamped to the motion blur tile size (configurable in project settings) as to not reveal the edges of motion blur tiles.
+		</member>
+		<member name="motion_blur_enabled" type="bool" setter="set_motion_blur_enabled" getter="is_motion_blur_enabled" default="false">
+		</member>
+		<member name="motion_blur_intensity" type="float" setter="set_motion_blur_intensity" getter="get_motion_blur_intensity" default="1.0">
+			Defines the amount of motion blur to apply given the object's velocity. At 1.0, the object's velocity will be blurred verbatim. An intensity of 0.5 can be interpreted as a 180 degrees shutter.
+		</member>
+		<member name="motion_blur_movement_velocity_multiplier" type="float" setter="set_motion_blur_movement_velocity_multiplier" getter="get_motion_blur_movement_velocity_multiplier" default="1.0">
+			Defines the intensity of blur similar to [member motion_blur_intensity], but only for the part of the motion caused by camera movement.
+		</member>
+		<member name="motion_blur_object_velocity_multiplier" type="float" setter="set_motion_blur_object_velocity_multiplier" getter="get_motion_blur_object_velocity_multiplier" default="1.0">
+			Defines the intensity of blur similar to [member motion_blur_intensity], but only for the part of the motion caused by object movement.
+		</member>
+		<member name="motion_blur_rotation_velocity_multiplier" type="float" setter="set_motion_blur_rotation_velocity_multiplier" getter="get_motion_blur_rotation_velocity_multiplier" default="1.0">
+			Defines the intensity of blur similar to [member motion_blur_intensity], but only for the part of the motion caused by camera rotation.
+		</member>
+		<member name="motion_blur_velocity_lower_threshold" type="float" setter="set_motion_blur_velocity_lower_threshold" getter="get_motion_blur_velocity_lower_threshold" default="0.0">
+			Defines a magnitude of motion that beyond which motion would start getting blurred. Works in tandem with [member motion_blur_velocity_upper_threshold] to define a seamless transition between non-blurred motion, and a fully blurred motion given the motion's magnitude.
+			The value is treated in terms of screen portion.
+			You can use these thresholds to create a less intrusive motion blur effect, where below certain movement speeds details stay crisp.
+		</member>
+		<member name="motion_blur_velocity_upper_threshold" type="float" setter="set_motion_blur_velocity_upper_threshold" getter="get_motion_blur_velocity_upper_threshold" default="0.0">
+			Defines a magnitude of motion that beyond which motion will be blurred in full. Works in tandem with [member motion_blur_velocity_lower_threshold] to define a seamless transition between non-blurred motion, and a fully blurred motion given the motion's magnitude.
+			The value is treated in terms of screen portion.
+			You can use these thresholds to create a less intrusive motion blur effect, where below certain movement speeds details stay crisp.
 		</member>
 	</members>
 </class>

doc/classes/ProjectSettings.xml

@@ -2802,6 +2802,30 @@
 		</member>
 		<member name="rendering/camera/depth_of_field/depth_of_field_use_jitter" type="bool" setter="" getter="" default="false">
 			If [code]true[/code], jitters DOF samples to make effect slightly blurrier and hide lines created from low sample rates. This can result in a slightly grainy appearance when used with a low number of samples.
+		</member>
+				<member name="rendering/camera/motion_blur/motion_blur_framerate_mode" type="int" setter="" getter="" default="1">
+			Defines framerate-based behavior of the motion blur. Uses [member motion_blur_reference_framerate] as the reference framerate for the different modes.
+			MOTION_BLUR_FRAMERATE_MODE_NATIVE applies the blur based on the game's framerate as is, and does not use the reference framerate.
+			MOTION_BLUR_FRAMERATE_MODE_CAPPED applies the blur based on the game's framerate, but below a certain framerate (which means larger time gap and thus larger blur) it will cap the blur to emulate the blur that will be generated at the reference framerate. This is the default value, and it means that if the game lags, the blur will be kept under control.
+			MOTION_BLUR_FRAMERATE_MODE_FIXED enforces the reference framerate blur regardless of the game's framerate. This can lead to overblurring when the game's framerate is higher than the reference framerate.
+		</member>
+		<member name="rendering/camera/motion_blur/motion_blur_quality" type="int" setter="" getter="" default="1">
+			Controls the quality of the motion blur. The motion blur uses noise to smoothen the transition between samples to prevent banding, but it can only do so much. Larger sample counts will mitigate the perceivable noise, at the cost of performance. The sample counts are as follows:
+			MOTION_BLUR_QUALITY_LOW = 4 samples
+			MOTION_BLUR_QUALITY_MEDIUM = 8 samples
+			MOTION_BLUR_QUALITY_HIGH = 16 samples
+		</member>
+		<member name="rendering/camera/motion_blur/motion_blur_reference_framerate" type="int" setter="" getter="" default="30">
+			Defines a framerate to be used as reference by [member motion_blur_framerate_mode].
+		</member>
+		<member name="rendering/camera/motion_blur/motion_blur_show_in_editor" type="bool" setter="" getter="" default="true">
+		</member>
+		<member name="rendering/camera/motion_blur/motion_blur_tile_size" type="int" setter="" getter="" default="1">
+			Defines, in pixels, the size of velocity dilation tiles to be used by the motion blur. These tiles collect dominant velocities from neighboring tiles so that fast moving objects can be blurred beyond their original silhouettes. Changing the tile size has little performance cost, rather the cost and effect come in the form of detail vs range. Large tile sizes can blur objects further, but will do so in less detail. The sizes are:
+			MOTION_BLUR_TILE_SIZE_SMALL = 20 pixels
+			MOTION_BLUR_TILE_SIZE_MEDIUM = 40 pixels
+			MOTION_BLUR_TILE_SIZE_LARGE = 60 pixels
+			MOTION_BLUR_TILE_SIZE_EXTRA_LARGE = 80 pixels
 		</member>
 		<member name="rendering/driver/depth_prepass/disable_for_vendors" type="String" setter="" getter="" default="&quot;PowerVR,Mali,Adreno,Apple&quot;">
 			Disables [member rendering/driver/depth_prepass/enable] conditionally for certain vendors. By default, disables the depth prepass for mobile devices as mobile devices do not benefit from the depth prepass due to their unique architecture.

doc/classes/RenderingServer.xml

@@ -101,6 +101,45 @@
 					return log((aperture * aperture) / shutter_speed * (100.0 / sensitivity)) / log(2)
 				[/codeblock]
 			</description>
+		</method>
+				<method name="camera_attributes_set_motion_blur">
+			<return type="void" />
+			<param index="0" name="camera_attributes" type="RID" />
+			<param index="1" name="enabled" type="bool" />
+			<param index="2" name="intensity" type="float" />
+			<param index="3" name="clamp_velocities_to_tile" type="bool" />
+			<param index="4" name="object_velocity_multiplier" type="float" />
+			<param index="5" name="movement_velocity_multiplier" type="float" />
+			<param index="6" name="rotation_velocity_multiplier" type="float" />
+			<param index="7" name="velocity_lower_threshold" type="float" />
+			<param index="8" name="velocity_upper_threshold" type="float" />
+			<description>
+			</description>
+		</method>
+		<method name="camera_attributes_set_motion_blur_framerate_mode">
+			<return type="void" />
+			<param index="0" name="mode" type="int" enum="RenderingServer.MotionBlurFramerateMode" />
+			<param index="1" name="reference_framerate" type="int" />
+			<description>
+			</description>
+		</method>
+		<method name="camera_attributes_set_motion_blur_quality">
+			<return type="void" />
+			<param index="0" name="quality" type="int" enum="RenderingServer.MotionBlurQuality" />
+			<description>
+			</description>
+		</method>
+		<method name="camera_attributes_set_motion_blur_show_in_editor">
+			<return type="void" />
+			<param index="0" name="enabled" type="bool" />
+			<description>
+			</description>
+		</method>
+		<method name="camera_attributes_set_motion_blur_tile_size">
+			<return type="void" />
+			<param index="0" name="tile_size" type="int" enum="RenderingServer.MotionBlurTileSize" />
+			<description>
+			</description>
 		</method>
 		<method name="camera_create">
 			<return type="RID" />
@@ -5609,6 +5648,20 @@
 		</constant>
 		<constant name="DOF_BLUR_QUALITY_HIGH" value="3" enum="DOFBlurQuality">
 			Highest quality DOF blur. Results in the smoothest looking blur by taking the most samples, but is also significantly slower.
+		</constant>
+				<constant name="MOTION_BLUR_QUALITY_LOW" value="0" enum="MotionBlurQuality">
+		</constant>
+		<constant name="MOTION_BLUR_QUALITY_MEDIUM" value="1" enum="MotionBlurQuality">
+		</constant>
+		<constant name="MOTION_BLUR_QUALITY_HIGH" value="2" enum="MotionBlurQuality">
+		</constant>
+		<constant name="MOTION_BLUR_TILE_SIZE_SMALL" value="0" enum="MotionBlurTileSize">
+		</constant>
+		<constant name="MOTION_BLUR_TILE_SIZE_MEDIUM" value="1" enum="MotionBlurTileSize">
+		</constant>
+		<constant name="MOTION_BLUR_TILE_SIZE_LARGE" value="2" enum="MotionBlurTileSize">
+		</constant>
+		<constant name="MOTION_BLUR_TILE_SIZE_EXTRA_LARGE" value="3" enum="MotionBlurTileSize">
 		</constant>
 		<constant name="INSTANCE_NONE" value="0" enum="InstanceType">
 			The instance does not have a type.

editor/editor_node.cpp

@@ -464,6 +464,16 @@ void EditorNode::_update_from_settings() {
 		scene_root->propagate_notification(Control::NOTIFICATION_LAYOUT_DIRECTION_CHANGED);
 	}
 
+	RS::MotionBlurFramerateMode motion_blur_framerate_mode = RS::MotionBlurFramerateMode(int(GLOBAL_GET("rendering/camera/motion_blur/motion_blur_framerate_mode")));
+	int motion_blur_reference_framerate = GLOBAL_GET("rendering/camera/motion_blur/motion_blur_reference_framerate");
+	RS::get_singleton()->camera_attributes_set_motion_blur_framerate_mode(motion_blur_framerate_mode, motion_blur_reference_framerate);
+	bool editor_mb_enabled = bool(GLOBAL_GET("rendering/camera/motion_blur/motion_blur_show_in_editor"));
+	RS::get_singleton()->camera_attributes_set_motion_blur_show_in_editor(editor_mb_enabled);
+	RS::MotionBlurQuality motion_blur_quality = RS::MotionBlurQuality(int(GLOBAL_GET("rendering/camera/motion_blur/motion_blur_quality")));
+	RS::get_singleton()->camera_attributes_set_motion_blur_quality(motion_blur_quality);
+	RS::MotionBlurTileSize motion_blur_tile_size = RS::MotionBlurTileSize(int(GLOBAL_GET("rendering/camera/motion_blur/motion_blur_tile_size")));
+	RS::get_singleton()->camera_attributes_set_motion_blur_tile_size(motion_blur_tile_size);
+
 	RS::DOFBokehShape dof_shape = RS::DOFBokehShape(int(GLOBAL_GET("rendering/camera/depth_of_field/depth_of_field_bokeh_shape")));
 	RS::get_singleton()->camera_attributes_set_dof_blur_bokeh_shape(dof_shape);
 	RS::DOFBlurQuality dof_quality = RS::DOFBlurQuality(int(GLOBAL_GET("rendering/camera/depth_of_field/depth_of_field_bokeh_quality")));

scene/resources/camera_attributes.cpp

@@ -147,6 +147,91 @@ CameraAttributes::~CameraAttributes() {
 //////////////////////////////////////////////////////
 /* CameraAttributesPractical */
 
+void CameraAttributesPractical::set_motion_blur_enabled(bool p_enabled) {
+	if (motion_blur_enabled == p_enabled) {
+		return;
+	}
+	motion_blur_enabled = p_enabled;
+	_update_motion_blur();
+	notify_property_list_changed();
+}
+
+bool CameraAttributesPractical::is_motion_blur_enabled() const {
+	return motion_blur_enabled;
+}
+
+void CameraAttributesPractical::set_motion_blur_intensity(float p_intensity) {
+	p_intensity = MAX(0.0f, p_intensity);
+	motion_blur_intensity = p_intensity;
+	_update_motion_blur();
+}
+
+float CameraAttributesPractical::get_motion_blur_intensity() const {
+	return motion_blur_intensity;
+}
+
+void CameraAttributesPractical::set_motion_blur_clamp_velocities_to_tile(bool p_clamp_velocities_to_tile) {
+	if (motion_blur_clamp_velocities_to_tile == p_clamp_velocities_to_tile) {
+		return;
+	}
+	motion_blur_clamp_velocities_to_tile = p_clamp_velocities_to_tile;
+	_update_motion_blur();
+}
+
+bool CameraAttributesPractical::is_motion_blur_clamp_velocities_to_tile() const {
+	return motion_blur_clamp_velocities_to_tile;
+}
+
+void CameraAttributesPractical::set_motion_blur_object_velocity_multiplier(float p_multiplier) {
+	p_multiplier = MAX(0.0f, p_multiplier);
+	motion_blur_object_velocity_multiplier = p_multiplier;
+	_update_motion_blur();
+}
+
+float CameraAttributesPractical::get_motion_blur_object_velocity_multiplier() const {
+	return motion_blur_object_velocity_multiplier;
+}
+
+void CameraAttributesPractical::set_motion_blur_movement_velocity_multiplier(float p_multiplier) {
+	p_multiplier = MAX(0.0f, p_multiplier);
+	motion_blur_movement_velocity_multiplier = p_multiplier;
+	_update_motion_blur();
+}
+
+float CameraAttributesPractical::get_motion_blur_movement_velocity_multiplier() const {
+	return motion_blur_movement_velocity_multiplier;
+}
+
+void CameraAttributesPractical::set_motion_blur_rotation_velocity_multiplier(float p_multiplier) {
+	p_multiplier = MAX(0.0f, p_multiplier);
+	motion_blur_rotation_velocity_multiplier = p_multiplier;
+	_update_motion_blur();
+}
+
+float CameraAttributesPractical::get_motion_blur_rotation_velocity_multiplier() const {
+	return motion_blur_rotation_velocity_multiplier;
+}
+
+void CameraAttributesPractical::set_motion_blur_velocity_lower_threshold(float p_threshold) {
+	p_threshold = MAX(0.0f, p_threshold);
+	motion_blur_velocity_lower_threshold = p_threshold;
+	_update_motion_blur();
+}
+
+float CameraAttributesPractical::get_motion_blur_velocity_lower_threshold() const {
+	return motion_blur_velocity_lower_threshold;
+}
+
+void CameraAttributesPractical::set_motion_blur_velocity_upper_threshold(float p_threshold) {
+	p_threshold = MAX(0.0f, p_threshold);
+	motion_blur_velocity_upper_threshold = p_threshold;
+	_update_motion_blur();
+}
+
+float CameraAttributesPractical::get_motion_blur_velocity_upper_threshold() const {
+	return motion_blur_velocity_upper_threshold;
+}
+
 void CameraAttributesPractical::set_dof_blur_far_enabled(bool p_enabled) {
 	dof_blur_far_enabled = p_enabled;
 	_update_dof_blur();

scene/resources/camera_attributes.h

@@ -80,6 +80,17 @@ class CameraAttributesPractical : public CameraAttributes {
 	GDCLASS(CameraAttributesPractical, CameraAttributes);
 
 private:
+	// Motion blur
+	bool motion_blur_enabled = false;
+	float motion_blur_intensity = 1.0;
+	bool motion_blur_clamp_velocities_to_tile = true;
+	float motion_blur_object_velocity_multiplier = 1.0;
+	float motion_blur_movement_velocity_multiplier = 1.0;
+	float motion_blur_rotation_velocity_multiplier = 1.0;
+	float motion_blur_velocity_lower_threshold = 0.0;
+	float motion_blur_velocity_upper_threshold = 0.0;
+	void _update_motion_blur();
+
 	// DOF blur
 	bool dof_blur_far_enabled = false;
 	float dof_blur_far_distance = 10.0;
@@ -99,6 +110,24 @@ class CameraAttributesPractical : public CameraAttributes {
 	void _validate_property(PropertyInfo &p_property) const;
 
 public:
+	// Motion blur
+	void set_motion_blur_enabled(bool p_enabled);
+	bool is_motion_blur_enabled() const;
+	void set_motion_blur_intensity(float p_intensity);
+	float get_motion_blur_intensity() const;
+	void set_motion_blur_clamp_velocities_to_tile(bool p_clamp_velocities_to_tile);
+	bool is_motion_blur_clamp_velocities_to_tile() const;
+	void set_motion_blur_object_velocity_multiplier(float p_multiplier);
+	float get_motion_blur_object_velocity_multiplier() const;
+	void set_motion_blur_movement_velocity_multiplier(float p_multiplier);
+	float get_motion_blur_movement_velocity_multiplier() const;
+	void set_motion_blur_rotation_velocity_multiplier(float p_multiplier);
+	float get_motion_blur_rotation_velocity_multiplier() const;
+	void set_motion_blur_velocity_lower_threshold(float p_threshold);
+	float get_motion_blur_velocity_lower_threshold() const;
+	void set_motion_blur_velocity_upper_threshold(float p_threshold);
+	float get_motion_blur_velocity_upper_threshold() const;
+
 	// DOF blur
 	void set_dof_blur_far_enabled(bool p_enabled);
 	bool is_dof_blur_far_enabled() const;