perlin_q16.h

Go to the documentation of this file.

#pragma once
 
// 2D Perlin noise Q16 implementation
// Extracted from animartrix_detail.hpp
//
// Q16 variant: Uses 16 fractional bits instead of 24 for faster arithmetic.
// Trades internal precision for speed: i32 ops instead of i64, smaller LUT.
 
#include "fl/math/fixed_point/s16x16.h"
#include "fl/stl/compiler_control.h"
#include "fl/stl/noexcept.h"
 
namespace fl {
 
struct perlin_q16 {
    static constexpr int HP_BITS = 16;
    static constexpr fl::i32 HP_ONE = static_cast<fl::i32>(1) << HP_BITS; // 65536 = 1.0
 
    // Build 257-entry Perlin fade LUT in Q16 format (16 fractional bits).
    static void init_fade_lut(fl::i32 *table) FL_NO_EXCEPT;
 
    // 2D Perlin noise. Input s16x16, output s16x16 approx [-1, 1].
    static fl::s16x16 pnoise2d(fl::s16x16 fx, fl::s16x16 fy,
                                      const fl::i32 *fade_lut,
                                      const fl::u8 *perm) FL_NO_EXCEPT;
 
    // Raw i32 version using Q16 internal precision.
    static fl::i32 pnoise2d_raw(fl::i32 fx_raw, fl::i32 fy_raw,
                                        const fl::i32 *fade_lut,
                                        const fl::u8 *perm) FL_NO_EXCEPT;
 
  private:
    static constexpr int FP_BITS = fl::s16x16::FRAC_BITS;
    static constexpr fl::i32 FP_ONE = static_cast<fl::i32>(1) << FP_BITS;
 
    // Decompose s16x16 raw value into integer floor and Q16 fractional part.
    static FASTLED_FORCE_INLINE void floor_frac(fl::i32 fp16, int &ifloor,
                                                fl::i32 &frac16) FL_NO_EXCEPT;
 
    // LUT fade: 1 lookup + 1 lerp replaces 5 multiplies.
    static FASTLED_FORCE_INLINE fl::i32 fade(fl::i32 t, const fl::i32 *table) FL_NO_EXCEPT;
 
    static FASTLED_FORCE_INLINE fl::i32 lerp(fl::i32 t, fl::i32 a, fl::i32 b) FL_NO_EXCEPT;
 
    // z=0 gradient via branchless coefficient LUT (Q16 format).
    static FASTLED_FORCE_INLINE fl::i32 grad(int hash, fl::i32 x, fl::i32 y) FL_NO_EXCEPT;
};
 
}  // namespace fl