Sobol.h

Go to the documentation of this file.

// Copyright Epic Games, Inc. All Rights Reserved.
 
#pragma once
 
#include "CoreTypes.h"
#include "Math/MathFwd.h"
#include "Math/Vector.h"
#include "Math/Vector2D.h"
 
class FSobol
{
public:
    // number of Sobol dimensions in DirectionNumbers and GrayNumbers tables (full Joe and Kuo table is 21201)
    static constexpr inline int32 MaxDimension = 15;
 
    // maximum number of bits in a 2D cell coordinate
    // allows cell grids from 1x1 to 2^MaxCell2DBits x 2^MaxCell2DBits
    static constexpr inline int32 MaxCell2DBits = 15;
 
    // maximum number of bits in a 3D cell coordinate
    // allows cell grids from 1x1x1 to 2^MaxCell3DBits x 2^MaxCell3DBits x 2^MaxCell3DBits
    static constexpr inline int32 MaxCell3DBits = 10;
 
private:
    // 24-bit Sobol direction numbers for 32-bit index
    static const int32 DirectionNumbers[MaxDimension + 1][32];
 
    // 24-bit Sobol direction numbers for Gray code order
    static const int32 GrayNumbers[MaxDimension + 1][32];
 
    // 24-bit Sobol direction numbers per cell
    static const int32 Cell2DDirectionNumbers[MaxCell2DBits + 1][32][2];
 
    // 24-bit Sobol direction numbers per cell in Gray-code order
    static const int32 Cell2DGrayNumbers[MaxCell2DBits + 1][32][2];
 
    // 24-bit Sobol direction numbers per cell
    static const int32 Cell3DDirectionNumbers[MaxCell3DBits + 1][32][3];
 
    // 24-bit Sobol direction numbers per cell in Gray-code order
    static const int32 Cell3DGrayNumbers[MaxCell3DBits + 1][32][3];
 
public:
    [[nodiscard]] CORE_API static float Evaluate(int32 Index, int32 Dim, int32 Seed = 0);
 
    [[nodiscard]] CORE_API static float Next(int32 Index, int32 Dim, float Value);
 
 
    [[nodiscard]] CORE_API static FVector2D Evaluate(int32 Index, int32 CellBits, FIntPoint Cell, FIntPoint Seed);
 
    [[nodiscard]] CORE_API static FVector2D Next(int32 Index, int32 CellBits, FVector2D Value);
 
 
    [[nodiscard]] CORE_API static FVector Evaluate(int32 Index, int32 CellBits, FIntVector Cell, FIntVector Seed);
 
    [[nodiscard]] CORE_API static FVector Next(int32 Index, int32 CellBits, FVector Value);
 
    [[nodiscard]] CORE_API static uint16 ComputeGPUSpatialSeed(int32 x, int32 y, int32 Index);
};