Method invoke

crates/optix/src/denoiser.rs:259–404

(
        &self,
        stream: &Stream,
        guide_images: DenoiserGuideImages,
        input_image: Image,
        parameters: DenoiserParams,
        out_buffer: &mut impl GpuBuffer<T>,
    )

    /// - `input_image` was larger than the dimensions specified in [`setup_state`].
    #[track_caller]
    pub fn invoke<T: DeviceCopy>(
        &self,
        stream: &Stream,
        guide_images: DenoiserGuideImages,
        input_image: Image,
        parameters: DenoiserParams,
        out_buffer: &mut impl GpuBuffer<T>,
    ) -> Result<()> {
        let state_lock = self.state.lock().unwrap();
        let state = state_lock.as_ref().expect(
            "State was not initialized before invoking the denoiser, call Denoiser::setup_state first"
        );
        let state_width = state.width;
        let state_height = state.height;

        assert!(
            state_width >= input_image.width,
            "State was created with an image width of {} but the input image had a width of {}",
            state_width,
            input_image.width
        );

        assert!(
            state_height >= input_image.height,
            "State was created with an image height of {} but the input image had a height of {}",
            state_height,
            input_image.height
        );

        assert_ne!(
            self.kind,
            DenoiserModelKind::Aov,
            "Use Denoiser::invoke_aov for AOV models, not invoke"
        );

        let input_bytes = input_image.bytes_used();
        let buf_len_bytes = out_buffer.len() * std::mem::size_of::<T>();
        assert!(
            buf_len_bytes >= input_bytes as usize,
            "Denoiser out_buffer not large enough, expected at least {} bytes, but found {}",
            input_bytes,
            buf_len_bytes
        );

        if self.options.guide_albedo {
            assert!(
                guide_images.albedo.is_some(),
                "Denoiser was created with guide_albedo but a guide image was not provided during invocation"
            );
        }

        if self.options.guide_normal {
            assert!(
                guide_images.normal.is_some(),
                "Denoiser was created with guide_normal but a guide image was not provided during invocation"
            );
        }