xref: /aosp_15_r20/external/libaom/av1/decoder/grain_synthesis.h (revision 77c1e3ccc04c968bd2bc212e87364f250e820521)
1*77c1e3ccSAndroid Build Coastguard Worker /*
2*77c1e3ccSAndroid Build Coastguard Worker  * Copyright (c) 2016, Alliance for Open Media. All rights reserved.
3*77c1e3ccSAndroid Build Coastguard Worker  *
4*77c1e3ccSAndroid Build Coastguard Worker  * This source code is subject to the terms of the BSD 2 Clause License and
5*77c1e3ccSAndroid Build Coastguard Worker  * the Alliance for Open Media Patent License 1.0. If the BSD 2 Clause License
6*77c1e3ccSAndroid Build Coastguard Worker  * was not distributed with this source code in the LICENSE file, you can
7*77c1e3ccSAndroid Build Coastguard Worker  * obtain it at www.aomedia.org/license/software. If the Alliance for Open
8*77c1e3ccSAndroid Build Coastguard Worker  * Media Patent License 1.0 was not distributed with this source code in the
9*77c1e3ccSAndroid Build Coastguard Worker  * PATENTS file, you can obtain it at www.aomedia.org/license/patent.
10*77c1e3ccSAndroid Build Coastguard Worker  */
11*77c1e3ccSAndroid Build Coastguard Worker 
12*77c1e3ccSAndroid Build Coastguard Worker /*!\file
13*77c1e3ccSAndroid Build Coastguard Worker  * \brief Describes film grain synthesis
14*77c1e3ccSAndroid Build Coastguard Worker  *
15*77c1e3ccSAndroid Build Coastguard Worker  */
16*77c1e3ccSAndroid Build Coastguard Worker #ifndef AOM_AV1_DECODER_GRAIN_SYNTHESIS_H_
17*77c1e3ccSAndroid Build Coastguard Worker #define AOM_AV1_DECODER_GRAIN_SYNTHESIS_H_
18*77c1e3ccSAndroid Build Coastguard Worker 
19*77c1e3ccSAndroid Build Coastguard Worker #ifdef __cplusplus
20*77c1e3ccSAndroid Build Coastguard Worker extern "C" {
21*77c1e3ccSAndroid Build Coastguard Worker #endif
22*77c1e3ccSAndroid Build Coastguard Worker 
23*77c1e3ccSAndroid Build Coastguard Worker #include <stdint.h>
24*77c1e3ccSAndroid Build Coastguard Worker 
25*77c1e3ccSAndroid Build Coastguard Worker #include "aom_dsp/grain_params.h"
26*77c1e3ccSAndroid Build Coastguard Worker #include "aom/aom_image.h"
27*77c1e3ccSAndroid Build Coastguard Worker 
28*77c1e3ccSAndroid Build Coastguard Worker /*!\brief Add film grain
29*77c1e3ccSAndroid Build Coastguard Worker  *
30*77c1e3ccSAndroid Build Coastguard Worker  * Add film grain to an image
31*77c1e3ccSAndroid Build Coastguard Worker  *
32*77c1e3ccSAndroid Build Coastguard Worker  * Returns 0 for success, -1 for failure
33*77c1e3ccSAndroid Build Coastguard Worker  *
34*77c1e3ccSAndroid Build Coastguard Worker  * \param[in]    grain_params     Grain parameters
35*77c1e3ccSAndroid Build Coastguard Worker  * \param[in]    luma             luma plane
36*77c1e3ccSAndroid Build Coastguard Worker  * \param[in]    cb               cb plane
37*77c1e3ccSAndroid Build Coastguard Worker  * \param[in]    cr               cr plane
38*77c1e3ccSAndroid Build Coastguard Worker  * \param[in]    height           luma plane height
39*77c1e3ccSAndroid Build Coastguard Worker  * \param[in]    width            luma plane width
40*77c1e3ccSAndroid Build Coastguard Worker  * \param[in]    luma_stride      luma plane stride
41*77c1e3ccSAndroid Build Coastguard Worker  * \param[in]    chroma_stride    chroma plane stride
42*77c1e3ccSAndroid Build Coastguard Worker  */
43*77c1e3ccSAndroid Build Coastguard Worker int av1_add_film_grain_run(const aom_film_grain_t *grain_params, uint8_t *luma,
44*77c1e3ccSAndroid Build Coastguard Worker                            uint8_t *cb, uint8_t *cr, int height, int width,
45*77c1e3ccSAndroid Build Coastguard Worker                            int luma_stride, int chroma_stride,
46*77c1e3ccSAndroid Build Coastguard Worker                            int use_high_bit_depth, int chroma_subsamp_y,
47*77c1e3ccSAndroid Build Coastguard Worker                            int chroma_subsamp_x, int mc_identity);
48*77c1e3ccSAndroid Build Coastguard Worker 
49*77c1e3ccSAndroid Build Coastguard Worker /*!\brief Add film grain
50*77c1e3ccSAndroid Build Coastguard Worker  *
51*77c1e3ccSAndroid Build Coastguard Worker  * Add film grain to an image
52*77c1e3ccSAndroid Build Coastguard Worker  *
53*77c1e3ccSAndroid Build Coastguard Worker  * Returns 0 for success, -1 for failure
54*77c1e3ccSAndroid Build Coastguard Worker  *
55*77c1e3ccSAndroid Build Coastguard Worker  * \param[in]    grain_params     Grain parameters
56*77c1e3ccSAndroid Build Coastguard Worker  * \param[in]    src              Source image
57*77c1e3ccSAndroid Build Coastguard Worker  * \param[out]   dst              Resulting image with grain
58*77c1e3ccSAndroid Build Coastguard Worker  */
59*77c1e3ccSAndroid Build Coastguard Worker int av1_add_film_grain(const aom_film_grain_t *grain_params,
60*77c1e3ccSAndroid Build Coastguard Worker                        const aom_image_t *src, aom_image_t *dst);
61*77c1e3ccSAndroid Build Coastguard Worker 
62*77c1e3ccSAndroid Build Coastguard Worker #ifdef __cplusplus
63*77c1e3ccSAndroid Build Coastguard Worker }  // extern "C"
64*77c1e3ccSAndroid Build Coastguard Worker #endif
65*77c1e3ccSAndroid Build Coastguard Worker 
66*77c1e3ccSAndroid Build Coastguard Worker #endif  // AOM_AV1_DECODER_GRAIN_SYNTHESIS_H_
67