2 * Copyright (c) 2016-2018 ARM Limited.
4 * SPDX-License-Identifier: MIT
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to
8 * deal in the Software without restriction, including without limitation the
9 * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
10 * sell copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in all
14 * copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24 #ifndef __ARM_COMPUTE_NEWARPKERNEL_H__
25 #define __ARM_COMPUTE_NEWARPKERNEL_H__
27 #include "arm_compute/core/NEON/INEKernel.h"
28 #include "arm_compute/core/Types.h"
36 /** Common interface for warp affine and warp perspective */
37 class INEWarpKernel : public INEKernel
40 /** Default constructor */
42 /** Prevent instances of this class from being copied (As this class contains pointers) */
43 INEWarpKernel(const INEWarpKernel &) = delete;
44 /** Prevent instances of this class from being copied (As this class contains pointers) */
45 INEWarpKernel &operator=(const INEWarpKernel &) = delete;
46 /** Allow instances of this class to be moved */
47 INEWarpKernel(INEWarpKernel &&) = default;
48 /** Allow instances of this class to be moved */
49 INEWarpKernel &operator=(INEWarpKernel &&) = default;
50 /** Initialise the kernel's input, output and border mode.
52 * @param[in] input Source tensor. Data type supported: U8.
53 * @param[out] output Destination tensor. Data type supported: U8.
54 * @param[in] matrix The perspective or affine matrix to use. Must be 2x3 for affine and 3x3 for perspective of type float.
55 * @param[in] border_mode Strategy to use for borders
56 * @param[in] constant_border_value Constant value used for filling the border.
58 virtual void configure(const ITensor *input, ITensor *output, const float *matrix, BorderMode border_mode, uint8_t constant_border_value);
60 // Inherited methods overridden:
61 void run(const Window &window, const ThreadInfo &info) override;
63 // Inherited methods overridden:
64 BorderSize border_size() const override;
67 /** function to perform warp affine or warp perspective on the given window when border mode == UNDEFINED
69 * @param[in] window Region on which to execute the kernel
71 virtual void warp_undefined(const Window &window) = 0;
72 /** function to perform warp affine or warp perspective on the given window when border mode == CONSTANT
74 * @param[in] window Region on which to execute the kernel
76 virtual void warp_constant(const Window &window) = 0;
77 /** function to perform warp affine or warp perspective on the given window when border mode == REPLICATE
79 * @param[in] window Region on which to execute the kernel
81 virtual void warp_replicate(const Window &window) = 0;
82 /** Common signature for all the specialised warp functions
84 * @param[in] window Region on which to execute the kernel.
86 void (INEWarpKernel::*_func)(const Window &window);
88 const ITensor *_input; /**< Input Tensor */
89 ITensor *_output; /**< Output Tensor */
90 uint8_t _constant_border_value; /**< Constant value used for filling the border. This value is used for those pixels out of the ROI when the border mode is CONSTANT */
91 const float *_matrix; /**< The affine or perspective matrix. Must be 2x3 for warp affine or 3x3 for warp perspective of type float. */
94 /** Template interface for the kernel to compute warp affine
97 template <InterpolationPolicy interpolation>
98 class NEWarpAffineKernel : public INEWarpKernel
101 const char *name() const override
103 return "NEWarpAffineKernel";
105 // Inherited methods overridden:
106 void warp_undefined(const Window &window) override;
107 void warp_constant(const Window &window) override;
108 void warp_replicate(const Window &window) override;
111 /** Template interface for the kernel to compute warp perspective
114 template <InterpolationPolicy interpolation>
115 class NEWarpPerspectiveKernel : public INEWarpKernel
118 const char *name() const override
120 return "NEWarpPerspectiveKernel";
122 // Inherited methods overridden:
123 void warp_undefined(const Window &window) override;
124 void warp_constant(const Window &window) override;
125 void warp_replicate(const Window &window) override;
127 } // namespace arm_compute
128 #endif /*__ARM_COMPUTE_NEWARPKERNEL_H__ */