1/*
2 *  Copyright 2011 The LibYuv Project Authors. All rights reserved.
3 *
4 *  Use of this source code is governed by a BSD-style license
5 *  that can be found in the LICENSE file in the root of the source
6 *  tree. An additional intellectual property rights grant can be found
7 *  in the file PATENTS. All contributing project authors may
8 *  be found in the AUTHORS file in the root of the source tree.
9 */
10
11#ifndef INCLUDE_LIBYUV_SCALE_H_  // NOLINT
12#define INCLUDE_LIBYUV_SCALE_H_
13
14#include "libyuv/basic_types.h"
15
16#ifdef __cplusplus
17namespace libyuv {
18extern "C" {
19#endif
20
21// Supported filtering.
22typedef enum FilterMode {
23  kFilterNone = 0,  // Point sample; Fastest.
24  kFilterLinear = 1,  // Filter horizontally only.
25  kFilterBilinear = 2,  // Faster than box, but lower quality scaling down.
26  kFilterBox = 3  // Highest quality.
27} FilterModeEnum;
28
29// Scale a YUV plane.
30LIBYUV_API
31void ScalePlane(const uint8* src, int src_stride,
32                int src_width, int src_height,
33                uint8* dst, int dst_stride,
34                int dst_width, int dst_height,
35                enum FilterMode filtering);
36
37void ScalePlane_16(const uint16* src, int src_stride,
38                   int src_width, int src_height,
39                   uint16* dst, int dst_stride,
40                   int dst_width, int dst_height,
41                   enum FilterMode filtering);
42
43// Scales a YUV 4:2:0 image from the src width and height to the
44// dst width and height.
45// If filtering is kFilterNone, a simple nearest-neighbor algorithm is
46// used. This produces basic (blocky) quality at the fastest speed.
47// If filtering is kFilterBilinear, interpolation is used to produce a better
48// quality image, at the expense of speed.
49// If filtering is kFilterBox, averaging is used to produce ever better
50// quality image, at further expense of speed.
51// Returns 0 if successful.
52
53LIBYUV_API
54int I420Scale(const uint8* src_y, int src_stride_y,
55              const uint8* src_u, int src_stride_u,
56              const uint8* src_v, int src_stride_v,
57              int src_width, int src_height,
58              uint8* dst_y, int dst_stride_y,
59              uint8* dst_u, int dst_stride_u,
60              uint8* dst_v, int dst_stride_v,
61              int dst_width, int dst_height,
62              enum FilterMode filtering);
63
64LIBYUV_API
65int I420Scale_16(const uint16* src_y, int src_stride_y,
66                 const uint16* src_u, int src_stride_u,
67                 const uint16* src_v, int src_stride_v,
68                 int src_width, int src_height,
69                 uint16* dst_y, int dst_stride_y,
70                 uint16* dst_u, int dst_stride_u,
71                 uint16* dst_v, int dst_stride_v,
72                 int dst_width, int dst_height,
73                 enum FilterMode filtering);
74
75#ifdef __cplusplus
76// Legacy API.  Deprecated.
77LIBYUV_API
78int Scale(const uint8* src_y, const uint8* src_u, const uint8* src_v,
79          int src_stride_y, int src_stride_u, int src_stride_v,
80          int src_width, int src_height,
81          uint8* dst_y, uint8* dst_u, uint8* dst_v,
82          int dst_stride_y, int dst_stride_u, int dst_stride_v,
83          int dst_width, int dst_height,
84          LIBYUV_BOOL interpolate);
85
86// Legacy API.  Deprecated.
87LIBYUV_API
88int ScaleOffset(const uint8* src_i420, int src_width, int src_height,
89                uint8* dst_i420, int dst_width, int dst_height, int dst_yoffset,
90                LIBYUV_BOOL interpolate);
91
92// For testing, allow disabling of specialized scalers.
93LIBYUV_API
94void SetUseReferenceImpl(LIBYUV_BOOL use);
95#endif  // __cplusplus
96
97#ifdef __cplusplus
98}  // extern "C"
99}  // namespace libyuv
100#endif
101
102#endif  // INCLUDE_LIBYUV_SCALE_H_  NOLINT
103