258 lines
14 KiB
C++
258 lines
14 KiB
C++
/*
|
|
==============================================================================
|
|
|
|
This file is part of the JUCE library.
|
|
Copyright (c) 2017 - ROLI Ltd.
|
|
|
|
JUCE is an open source library subject to commercial or open-source
|
|
licensing.
|
|
|
|
The code included in this file is provided under the terms of the ISC license
|
|
http://www.isc.org/downloads/software-support-policy/isc-license. Permission
|
|
To use, copy, modify, and/or distribute this software for any purpose with or
|
|
without fee is hereby granted provided that the above copyright notice and
|
|
this permission notice appear in all copies.
|
|
|
|
JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
|
|
EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
|
|
DISCLAIMED.
|
|
|
|
==============================================================================
|
|
*/
|
|
|
|
namespace juce
|
|
{
|
|
|
|
#ifndef JUCE_SNAP_TO_ZERO
|
|
#if JUCE_INTEL
|
|
#define JUCE_SNAP_TO_ZERO(n) if (! (n < -1.0e-8f || n > 1.0e-8f)) n = 0;
|
|
#else
|
|
#define JUCE_SNAP_TO_ZERO(n) ignoreUnused (n)
|
|
#endif
|
|
#endif
|
|
class ScopedNoDenormals;
|
|
|
|
//==============================================================================
|
|
/**
|
|
A collection of simple vector operations on arrays of floats, accelerated with
|
|
SIMD instructions where possible.
|
|
|
|
@tags{Audio}
|
|
*/
|
|
class JUCE_API FloatVectorOperations
|
|
{
|
|
public:
|
|
//==============================================================================
|
|
/** Clears a vector of floats. */
|
|
static void JUCE_CALLTYPE clear (float* dest, int numValues) noexcept;
|
|
|
|
/** Clears a vector of doubles. */
|
|
static void JUCE_CALLTYPE clear (double* dest, int numValues) noexcept;
|
|
|
|
/** Copies a repeated value into a vector of floats. */
|
|
static void JUCE_CALLTYPE fill (float* dest, float valueToFill, int numValues) noexcept;
|
|
|
|
/** Copies a repeated value into a vector of doubles. */
|
|
static void JUCE_CALLTYPE fill (double* dest, double valueToFill, int numValues) noexcept;
|
|
|
|
/** Copies a vector of floats. */
|
|
static void JUCE_CALLTYPE copy (float* dest, const float* src, int numValues) noexcept;
|
|
|
|
/** Copies a vector of doubles. */
|
|
static void JUCE_CALLTYPE copy (double* dest, const double* src, int numValues) noexcept;
|
|
|
|
/** Copies a vector of floats, multiplying each value by a given multiplier */
|
|
static void JUCE_CALLTYPE copyWithMultiply (float* dest, const float* src, float multiplier, int numValues) noexcept;
|
|
|
|
/** Copies a vector of doubles, multiplying each value by a given multiplier */
|
|
static void JUCE_CALLTYPE copyWithMultiply (double* dest, const double* src, double multiplier, int numValues) noexcept;
|
|
|
|
/** Adds a fixed value to the destination values. */
|
|
static void JUCE_CALLTYPE add (float* dest, float amountToAdd, int numValues) noexcept;
|
|
|
|
/** Adds a fixed value to the destination values. */
|
|
static void JUCE_CALLTYPE add (double* dest, double amountToAdd, int numValues) noexcept;
|
|
|
|
/** Adds a fixed value to each source value and stores it in the destination array. */
|
|
static void JUCE_CALLTYPE add (float* dest, const float* src, float amount, int numValues) noexcept;
|
|
|
|
/** Adds a fixed value to each source value and stores it in the destination array. */
|
|
static void JUCE_CALLTYPE add (double* dest, const double* src, double amount, int numValues) noexcept;
|
|
|
|
/** Adds the source values to the destination values. */
|
|
static void JUCE_CALLTYPE add (float* dest, const float* src, int numValues) noexcept;
|
|
|
|
/** Adds the source values to the destination values. */
|
|
static void JUCE_CALLTYPE add (double* dest, const double* src, int numValues) noexcept;
|
|
|
|
/** Adds each source1 value to the corresponding source2 value and stores the result in the destination array. */
|
|
static void JUCE_CALLTYPE add (float* dest, const float* src1, const float* src2, int num) noexcept;
|
|
|
|
/** Adds each source1 value to the corresponding source2 value and stores the result in the destination array. */
|
|
static void JUCE_CALLTYPE add (double* dest, const double* src1, const double* src2, int num) noexcept;
|
|
|
|
/** Subtracts the source values from the destination values. */
|
|
static void JUCE_CALLTYPE subtract (float* dest, const float* src, int numValues) noexcept;
|
|
|
|
/** Subtracts the source values from the destination values. */
|
|
static void JUCE_CALLTYPE subtract (double* dest, const double* src, int numValues) noexcept;
|
|
|
|
/** Subtracts each source2 value from the corresponding source1 value and stores the result in the destination array. */
|
|
static void JUCE_CALLTYPE subtract (float* dest, const float* src1, const float* src2, int num) noexcept;
|
|
|
|
/** Subtracts each source2 value from the corresponding source1 value and stores the result in the destination array. */
|
|
static void JUCE_CALLTYPE subtract (double* dest, const double* src1, const double* src2, int num) noexcept;
|
|
|
|
/** Multiplies each source value by the given multiplier, then adds it to the destination value. */
|
|
static void JUCE_CALLTYPE addWithMultiply (float* dest, const float* src, float multiplier, int numValues) noexcept;
|
|
|
|
/** Multiplies each source value by the given multiplier, then adds it to the destination value. */
|
|
static void JUCE_CALLTYPE addWithMultiply (double* dest, const double* src, double multiplier, int numValues) noexcept;
|
|
|
|
/** Multiplies each source1 value by the corresponding source2 value, then adds it to the destination value. */
|
|
static void JUCE_CALLTYPE addWithMultiply (float* dest, const float* src1, const float* src2, int num) noexcept;
|
|
|
|
/** Multiplies each source1 value by the corresponding source2 value, then adds it to the destination value. */
|
|
static void JUCE_CALLTYPE addWithMultiply (double* dest, const double* src1, const double* src2, int num) noexcept;
|
|
|
|
/** Multiplies each source value by the given multiplier, then subtracts it to the destination value. */
|
|
static void JUCE_CALLTYPE subtractWithMultiply (float* dest, const float* src, float multiplier, int numValues) noexcept;
|
|
|
|
/** Multiplies each source value by the given multiplier, then subtracts it to the destination value. */
|
|
static void JUCE_CALLTYPE subtractWithMultiply (double* dest, const double* src, double multiplier, int numValues) noexcept;
|
|
|
|
/** Multiplies each source1 value by the corresponding source2 value, then subtracts it to the destination value. */
|
|
static void JUCE_CALLTYPE subtractWithMultiply (float* dest, const float* src1, const float* src2, int num) noexcept;
|
|
|
|
/** Multiplies each source1 value by the corresponding source2 value, then subtracts it to the destination value. */
|
|
static void JUCE_CALLTYPE subtractWithMultiply (double* dest, const double* src1, const double* src2, int num) noexcept;
|
|
|
|
/** Multiplies the destination values by the source values. */
|
|
static void JUCE_CALLTYPE multiply (float* dest, const float* src, int numValues) noexcept;
|
|
|
|
/** Multiplies the destination values by the source values. */
|
|
static void JUCE_CALLTYPE multiply (double* dest, const double* src, int numValues) noexcept;
|
|
|
|
/** Multiplies each source1 value by the correspinding source2 value, then stores it in the destination array. */
|
|
static void JUCE_CALLTYPE multiply (float* dest, const float* src1, const float* src2, int numValues) noexcept;
|
|
|
|
/** Multiplies each source1 value by the correspinding source2 value, then stores it in the destination array. */
|
|
static void JUCE_CALLTYPE multiply (double* dest, const double* src1, const double* src2, int numValues) noexcept;
|
|
|
|
/** Multiplies each of the destination values by a fixed multiplier. */
|
|
static void JUCE_CALLTYPE multiply (float* dest, float multiplier, int numValues) noexcept;
|
|
|
|
/** Multiplies each of the destination values by a fixed multiplier. */
|
|
static void JUCE_CALLTYPE multiply (double* dest, double multiplier, int numValues) noexcept;
|
|
|
|
/** Multiplies each of the source values by a fixed multiplier and stores the result in the destination array. */
|
|
static void JUCE_CALLTYPE multiply (float* dest, const float* src, float multiplier, int num) noexcept;
|
|
|
|
/** Multiplies each of the source values by a fixed multiplier and stores the result in the destination array. */
|
|
static void JUCE_CALLTYPE multiply (double* dest, const double* src, double multiplier, int num) noexcept;
|
|
|
|
/** Copies a source vector to a destination, negating each value. */
|
|
static void JUCE_CALLTYPE negate (float* dest, const float* src, int numValues) noexcept;
|
|
|
|
/** Copies a source vector to a destination, negating each value. */
|
|
static void JUCE_CALLTYPE negate (double* dest, const double* src, int numValues) noexcept;
|
|
|
|
/** Copies a source vector to a destination, taking the absolute of each value. */
|
|
static void JUCE_CALLTYPE abs (float* dest, const float* src, int numValues) noexcept;
|
|
|
|
/** Copies a source vector to a destination, taking the absolute of each value. */
|
|
static void JUCE_CALLTYPE abs (double* dest, const double* src, int numValues) noexcept;
|
|
|
|
/** Converts a stream of integers to floats, multiplying each one by the given multiplier. */
|
|
static void JUCE_CALLTYPE convertFixedToFloat (float* dest, const int* src, float multiplier, int numValues) noexcept;
|
|
|
|
/** Each element of dest will be the minimum of the corresponding element of the source array and the given comp value. */
|
|
static void JUCE_CALLTYPE min (float* dest, const float* src, float comp, int num) noexcept;
|
|
|
|
/** Each element of dest will be the minimum of the corresponding element of the source array and the given comp value. */
|
|
static void JUCE_CALLTYPE min (double* dest, const double* src, double comp, int num) noexcept;
|
|
|
|
/** Each element of dest will be the minimum of the corresponding source1 and source2 values. */
|
|
static void JUCE_CALLTYPE min (float* dest, const float* src1, const float* src2, int num) noexcept;
|
|
|
|
/** Each element of dest will be the minimum of the corresponding source1 and source2 values. */
|
|
static void JUCE_CALLTYPE min (double* dest, const double* src1, const double* src2, int num) noexcept;
|
|
|
|
/** Each element of dest will be the maximum of the corresponding element of the source array and the given comp value. */
|
|
static void JUCE_CALLTYPE max (float* dest, const float* src, float comp, int num) noexcept;
|
|
|
|
/** Each element of dest will be the maximum of the corresponding element of the source array and the given comp value. */
|
|
static void JUCE_CALLTYPE max (double* dest, const double* src, double comp, int num) noexcept;
|
|
|
|
/** Each element of dest will be the maximum of the corresponding source1 and source2 values. */
|
|
static void JUCE_CALLTYPE max (float* dest, const float* src1, const float* src2, int num) noexcept;
|
|
|
|
/** Each element of dest will be the maximum of the corresponding source1 and source2 values. */
|
|
static void JUCE_CALLTYPE max (double* dest, const double* src1, const double* src2, int num) noexcept;
|
|
|
|
/** Each element of dest is calculated by hard clipping the corresponding src element so that it is in the range specified by the arguments low and high. */
|
|
static void JUCE_CALLTYPE clip (float* dest, const float* src, float low, float high, int num) noexcept;
|
|
|
|
/** Each element of dest is calculated by hard clipping the corresponding src element so that it is in the range specified by the arguments low and high. */
|
|
static void JUCE_CALLTYPE clip (double* dest, const double* src, double low, double high, int num) noexcept;
|
|
|
|
/** Finds the minimum and maximum values in the given array. */
|
|
static Range<float> JUCE_CALLTYPE findMinAndMax (const float* src, int numValues) noexcept;
|
|
|
|
/** Finds the minimum and maximum values in the given array. */
|
|
static Range<double> JUCE_CALLTYPE findMinAndMax (const double* src, int numValues) noexcept;
|
|
|
|
/** Finds the minimum value in the given array. */
|
|
static float JUCE_CALLTYPE findMinimum (const float* src, int numValues) noexcept;
|
|
|
|
/** Finds the minimum value in the given array. */
|
|
static double JUCE_CALLTYPE findMinimum (const double* src, int numValues) noexcept;
|
|
|
|
/** Finds the maximum value in the given array. */
|
|
static float JUCE_CALLTYPE findMaximum (const float* src, int numValues) noexcept;
|
|
|
|
/** Finds the maximum value in the given array. */
|
|
static double JUCE_CALLTYPE findMaximum (const double* src, int numValues) noexcept;
|
|
|
|
/** This method enables or disables the SSE/NEON flush-to-zero mode. */
|
|
static void JUCE_CALLTYPE enableFlushToZeroMode (bool shouldEnable) noexcept;
|
|
|
|
/** On Intel CPUs, this method enables the SSE flush-to-zero and denormalised-are-zero modes.
|
|
This effectively sets the DAZ and FZ bits of the MXCSR register. On arm CPUs this will
|
|
enable flush to zero mode.
|
|
It's a convenient thing to call before audio processing code where you really want to
|
|
avoid denormalisation performance hits.
|
|
*/
|
|
static void JUCE_CALLTYPE disableDenormalisedNumberSupport (bool shouldDisable = true) noexcept;
|
|
|
|
/** This method returns true if denormals are currently disabled. */
|
|
static bool JUCE_CALLTYPE areDenormalsDisabled() noexcept;
|
|
|
|
private:
|
|
friend ScopedNoDenormals;
|
|
|
|
static intptr_t JUCE_CALLTYPE getFpStatusRegister() noexcept;
|
|
static void JUCE_CALLTYPE setFpStatusRegister (intptr_t) noexcept;
|
|
};
|
|
|
|
//==============================================================================
|
|
/**
|
|
Helper class providing an RAII-based mechanism for temporarily disabling
|
|
denormals on your CPU.
|
|
|
|
@tags{Audio}
|
|
*/
|
|
class ScopedNoDenormals
|
|
{
|
|
public:
|
|
ScopedNoDenormals() noexcept;
|
|
~ScopedNoDenormals() noexcept;
|
|
|
|
private:
|
|
#if JUCE_USE_SSE_INTRINSICS || (JUCE_USE_ARM_NEON || defined (__arm64__) || defined (__aarch64__))
|
|
intptr_t fpsr;
|
|
#endif
|
|
};
|
|
|
|
} // namespace juce
|