TestNEON.h

Go to the documentation of this file.

/*
 * Copyright (c) Meta Platforms, Inc. and affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 */
 
#ifndef META_OCEAN_TEST_TESTCV_TEST_NEON_H
#define META_OCEAN_TEST_TESTCV_TEST_NEON_H
 
#include "ocean/test/testcv/TestCV.h"
 
#include "ocean/base/RandomGenerator.h"
 
#include "ocean/test/TestSelector.h"
 
#if defined(OCEAN_HARDWARE_NEON_VERSION) && OCEAN_HARDWARE_NEON_VERSION >= 10
 
namespace Ocean
{
 
namespace Test
{
 
namespace TestCV
{
 
/**
 * This class implements a Computer Vision NEON test.
 * @ingroup testcv
 */
class OCEAN_TEST_CV_EXPORT TestNEON
{
    protected:
 
        /**
         * Definition of a pointer to a function allowing to averaging 2x2 pixel blocks.
         * @param source0 The upper source row, must be valid
         * @param source1 The lower source row, must be valid
         * @param target The resulting averaged elements, must be valid
         */
        using AveragingFunction = void (*)(const unsigned char* const source0, const unsigned char* const source1, unsigned char* const target);
 
    public:
 
        /**
         * Invokes all tests of the NEON class.
         * @param testDuration Number of seconds for each test, with range (0, infinity)
         * @param selector The test selector to control which tests to run
         * @return True, if succeeded
         */
        static bool test(const double testDuration, const TestSelector& selector = TestSelector());
 
        /**
         * Tests the NEON-based calculation of 3x3 block sums of 16 bit values.
         * @param testDuration Number of seconds for each test, with range (0, infinity)
         * @return True, if all result are valid
         */
        static bool testSum16Bit4Blocks3x3(const double testDuration);
 
        /**
         * Tests the NEON-based averaging of 2x2 pixel blocks.
         * @param testDuration Number of seconds for each test, with range (0, infinity)
         * @return True, if all result are valid
         */
        static bool testAveragingPixels2x2(const double testDuration);
 
        /**
         * Tests the NEON-based multiply functions.
         * @param testDuration Number of seconds for each test, with range (0, infinity)
         * @return True, if all result are valid
         */
        static bool testMultiply(const double testDuration);
 
        /**
         * Tests the NEON-based copySign functions.
         * @param testDuration Number of seconds for each test, with range (0, infinity)
         * @return True, if all result are valid
         */
        static bool testCopySign(const double testDuration);
 
        /**
         * Tests the NEON-based cast functions.
         * @param testDuration Number of seconds for each test, with range (0, infinity)
         * @return True, if all result are valid
         */
        static bool testCastElements(const double testDuration);
 
        /**
         * Tests the NEON-based sum function for four uint32_t values.
         * @param testDuration Number of seconds for each test, with range (0, infinity)
         * @return True, if all result are valid
         */
        static bool testSumHorizontal_u_32x4(const double testDuration);
 
    protected:
 
        /*
         * Validates the NEON-based averaging of 2x2 pixel blocks.
         * @param averagingFunction The actual averaging function to be tested, must be valid
         * @param randomGenerator The random generator object to be used
         * @return True, if succeeded
         * @tparam tChannels The number of channels to test, with range [1, infinity)
         * @tparam tSourcePixels The number of source pixels to test, with range [2, infinity), must be even
         */
        template <unsigned int tChannels, unsigned int tSourcePixels>
        static bool validateAveragePixels2x2(const AveragingFunction averagingFunction, RandomGenerator& randomGenerator);
};
 
}
 
}
 
}
 
#endif // OCEAN_HARDWARE_NEON_VERSION >= 10
 
#endif // META_OCEAN_TEST_TESTCV_TEST_NEON_H