Brecht Van Lommel
9cfc7967dd
* Replace license text in headers with SPDX identifiers. * Remove specific license info from outdated readme.txt, instead leave details to the source files. * Add list of SPDX license identifiers used, and corresponding license texts. * Update copyright dates while we're at it. Ref D14069, T95597
102 lines
3.0 KiB
C++
102 lines
3.0 KiB
C++
/* SPDX-License-Identifier: Apache-2.0
|
|
* Copyright 2011-2022 Blender Foundation */
|
|
|
|
#pragma once
|
|
|
|
#include "device/memory.h"
|
|
#include "graph/node.h"
|
|
#include "session/buffers.h"
|
|
|
|
CCL_NAMESPACE_BEGIN
|
|
|
|
enum DenoiserType {
|
|
DENOISER_OPTIX = 2,
|
|
DENOISER_OPENIMAGEDENOISE = 4,
|
|
DENOISER_NUM,
|
|
|
|
DENOISER_NONE = 0,
|
|
DENOISER_ALL = ~0,
|
|
};
|
|
|
|
/* COnstruct human-readable string which denotes the denoiser type. */
|
|
const char *denoiserTypeToHumanReadable(DenoiserType type);
|
|
|
|
typedef int DenoiserTypeMask;
|
|
|
|
enum DenoiserPrefilter {
|
|
/* Best quality of the result without extra processing time, but requires guiding passes to be
|
|
* noise-free. */
|
|
DENOISER_PREFILTER_NONE = 1,
|
|
|
|
/* Denoise color and guiding passes together.
|
|
* Improves quality when guiding passes are noisy using least amount of extra processing time. */
|
|
DENOISER_PREFILTER_FAST = 2,
|
|
|
|
/* Prefilter noisy guiding passes before denoising color.
|
|
* Improves quality when guiding passes are noisy using extra processing time. */
|
|
DENOISER_PREFILTER_ACCURATE = 3,
|
|
|
|
DENOISER_PREFILTER_NUM,
|
|
};
|
|
|
|
/* NOTE: Is not a real scene node. Using Node API for ease of (de)serialization.
|
|
* The default values here do not really matter as they are always initialized from the
|
|
* Integrator node. */
|
|
class DenoiseParams : public Node {
|
|
public:
|
|
NODE_DECLARE
|
|
|
|
/* Apply denoiser to image. */
|
|
bool use = false;
|
|
|
|
/* Denoiser type. */
|
|
DenoiserType type = DENOISER_OPENIMAGEDENOISE;
|
|
|
|
/* Viewport start sample. */
|
|
int start_sample = 0;
|
|
|
|
/* Auxiliary passes. */
|
|
bool use_pass_albedo = true;
|
|
bool use_pass_normal = true;
|
|
|
|
/* Configure the denoiser to use motion vectors, previous image and a temporally stable model. */
|
|
bool temporally_stable = false;
|
|
|
|
DenoiserPrefilter prefilter = DENOISER_PREFILTER_FAST;
|
|
|
|
static const NodeEnum *get_type_enum();
|
|
static const NodeEnum *get_prefilter_enum();
|
|
|
|
DenoiseParams();
|
|
|
|
bool modified(const DenoiseParams &other) const
|
|
{
|
|
return !(use == other.use && type == other.type && start_sample == other.start_sample &&
|
|
use_pass_albedo == other.use_pass_albedo &&
|
|
use_pass_normal == other.use_pass_normal &&
|
|
temporally_stable == other.temporally_stable && prefilter == other.prefilter);
|
|
}
|
|
};
|
|
|
|
/* All the parameters needed to perform buffer denoising on a device.
|
|
* Is not really a task in its canonical terms (as in, is not an asynchronous running task). Is
|
|
* more like a wrapper for all the arguments and parameters needed to perform denoising. Is a
|
|
* single place where they are all listed, so that it's not required to modify all device methods
|
|
* when these parameters do change. */
|
|
class DeviceDenoiseTask {
|
|
public:
|
|
DenoiseParams params;
|
|
|
|
int num_samples;
|
|
|
|
RenderBuffers *render_buffers;
|
|
BufferParams buffer_params;
|
|
|
|
/* Allow to do in-place modification of the input passes (scaling them down i.e.). This will
|
|
* lower the memory footprint of the denoiser but will make input passes "invalid" (from path
|
|
* tracer) point of view. */
|
|
bool allow_inplace_modification;
|
|
};
|
|
|
|
CCL_NAMESPACE_END
|