Cycles: add animation denoising Python operator.

This adds a cycles.denoise_animation operator, which denoises an animation
sequence or individual file. Renders must be saved as multilayer EXR files
with denoising data passes.

By default file path and frame range come from the current scene, and EXR
files are denoised in-place. Alternatively, a different input and/or output
file path can be provided.

Denoising settings come from the current view layer. Renders can be denoised
again with different settings, as the original noisy image is preserved along
with other passes and metadata.

There is no user interface yet for this feature, that comes later.

Code by Lukas with modifications by Brecht. This feature was originally
developed for Tangent Animation, thanks for the support!

1 files changed, 27 insertions, 4 deletions

diff --git a/intern/cycles/device/device_task.h b/intern/cycles/device/device_task.h
index 2871bc5761a..f1fd4246868 100644
--- a/intern/cycles/device/device_task.h
+++ b/intern/cycles/device/device_task.h
@@ -32,6 +32,32 @@ class RenderBuffers;
 class RenderTile;
 class Tile;
 
+class DenoiseParams {
+public:
+	/* Pixel radius for neighbouring pixels to take into account. */
+	int radius;
+	/* Controls neighbor pixel weighting for the denoising filter. */
+	float strength;
+	/* Preserve more or less detail based on feature passes. */
+	float feature_strength;
+	/* When removing pixels that don't carry information, use a relative threshold instead of an absolute one. */
+	bool relative_pca;
+	/* How many frames before and after the current center frame are included. */
+	int neighbor_frames;
+	/* Clamp the input to the range of +-1e8. Should be enough for any legitimate data. */
+	bool clamp_input;
+
+	DenoiseParams()
+	{
+		radius = 8;
+		strength = 0.5f;
+		feature_strength = 0.5f;
+		relative_pca = false;
+		neighbor_frames = 2;
+		clamp_input = true;
+	}
+};
+
 class DeviceTask : public Task {
 public:
 	typedef enum { RENDER, FILM_CONVERT, SHADER } Type;
@@ -68,10 +94,7 @@ public:
 	function<void(RenderTile*, Device*)> map_neighbor_tiles;
 	function<void(RenderTile*, Device*)> unmap_neighbor_tiles;
 
-	int denoising_radius;
-	float denoising_strength;
-	float denoising_feature_strength;
-	bool denoising_relative_pca;
+	DenoiseParams denoising;
 	bool denoising_from_render;
 	vector<int> denoising_frames;