arm_compute/core/NEON/kernels/assembly/transform.hpp

   1 /*
   2  * Copyright (c) 2017 ARM Limited.
   3  *
   4  * SPDX-License-Identifier: MIT
   5  *
   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:
  12  *
  13  * The above copyright notice and this permission notice shall be included in all
  14  * copies or substantial portions of the Software.
  15  *
  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
  22  * SOFTWARE.
  23  */
  24 #pragma once
  25
  26 /*
  27  * Generic transform.
  28  *
  29  * Assuming the untransposed case, this works by first reading <BlockBy>
  30  * consecutive values from the first input row.  This same number of values
  31  * are then read from the next <IntBy-1> rows.  Now return to the first
  32  * input row and repeat.
  33  *
  34  * Need to cope with the work requested in either dimension not actually
  35  * being a multiple of the block sizes.
  36  */
  37 template <unsigned IntBy, unsigned int BlockBy, bool Transposed, size_t TOutSize, size_t TInSize>
  38 struct TransformImpl {
  39     template <typename TOut, typename TIn>
  40     static void Transform(TOut* out, const TIn* const in, const int stride,
  41                           const int y0, const int ymax, const int x0, const int xmax) {
  42         const int n_whole_y_blocks = (ymax - y0) / IntBy;
  43         const int y_remainders = (ymax - y0) % IntBy;
  44         const int n_y_blocks = n_whole_y_blocks + (y_remainders ? 1 : 0);
  45
  46         const int n_whole_x_blocks = (xmax - x0) / BlockBy;
  47         const int x_remainders = (xmax - x0) % BlockBy;
  48         const int n_x_blocks = n_whole_x_blocks + (x_remainders ? 1 : 0);
  49
  50         // "Y" loop: advance down the rows of the source IntBy rows at a time.
  51         // Set up fill_rows to show the number rows to copy from, and blank_rows
  52         // for the number of blank rows to add.
  53         for (int y_block=0 ; y_block < n_y_blocks; y_block++) {
  54             int fill_rows = (y_block < n_whole_y_blocks) ? IntBy : y_remainders;
  55             int blank_rows = IntBy - fill_rows;
  56
  57             int y_base = y0 + (y_block * IntBy);
  58
  59             // So now advance along this block of rows, BlockBy columns at a time.
  60             for (int x_block=0 ; x_block < n_x_blocks; x_block++) {
  61                 int fill_cols = (x_block < n_whole_x_blocks) ? BlockBy : x_remainders;
  62                 int blank_cols = BlockBy - fill_cols;
  63
  64                 int x_base = x0 + (x_block * BlockBy);
  65
  66                 for (int row = 0; row < fill_rows; row++) {
  67                     for (int col = 0; col < fill_cols; col++) {
  68                         // In-range copy.  If it's transposed, we reverse the sense of rows and columns here.
  69                         if (Transposed) {
  70                             *out++ = static_cast<TOut>(in[(x_base + col) * stride + y_base + row]);
  71                         } else {
  72                             *out++ = static_cast<TOut>(in[(y_base + row) * stride + x_base + col]);
  73                         }
  74                     }
  75                     // "col" tail - row is in range but column is out of range.
  76                     for (int col=0; col < blank_cols; col++) {
  77                         *out++ = static_cast<TOut>(0);
  78                     }
  79                 }
  80                 // "row" tail - row is out of range so fill with zeros always.
  81                 for (int row = 0; row < blank_rows; row++) {
  82                     for (int col=0; col < (fill_cols + blank_cols); col++) {
  83                         *out++ = static_cast<TOut>(0);
  84                     }
  85                 }
  86             }
  87         }
  88     }
  89
  90     template <typename T>
  91     static inline void Transform(T* out, const T* const in, const int stride,
  92                                  const int k0, const int kmax, const int x0, const int xmax) {
  93         Transform<T, T>(out, in, stride, k0, kmax, x0, xmax);
  94     }
  95 };
  96
  97 /*****************************************************************************/
  98 template <unsigned int IntBy, unsigned int BlockBy, bool Transposed, typename TOut, typename TIn>
  99 void Transform(
 100   TOut* out, const TIn* const in, const int stride,
 101   const int k0, const int kmax, const int x0, const int xmax
 102 ) {
 103   // Redirect to a specialised implementation predicated on argument size.
 104   TransformImpl<IntBy, BlockBy, Transposed, sizeof(TOut), sizeof(TIn)>::Transform(
 105     out, in, stride, k0, kmax, x0, xmax
 106   );
 107 }
 108 /*****************************************************************************/
 109
 110 #include "transforms/list.hpp"