UT/UT_NoiseBasis.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 * Produced by:
 *      Mark Elendt
 *      Side Effects Software Inc
 *      477 Richmond Street West
 *      Toronto, Ontario
 *      Canada   M5V 3E7
 *      416-504-9876
 *
 * NAME:        UT_NoiseBasis.h ( UT Library, C++)
 *
 * COMMENTS:    Low level noise generation using cellular basis functions
 *              This is based off:  "A Cellular Texture Basis Function",
 *              Siggraph 1996, pg. 291.  It can provide noise similar to
 *              alligator noise (which was developed independently).
 *
 * NOTES:       This noise type can be considered a super-set of alligator and
 *              sparse convolution noise.  Alligator noise is created using a
 *              simple linear combination of (1-F(0)) - (1-F(3)) or something
 *              to that effect.  Sparse convolution on the other hand can be
 *              generated by:
 *                      sum(.5*cos(F(i)*FACTOR)+.5)
 */

#ifndef __UT_NoiseBasis__
#define __UT_NoiseBasis__

#include "UT_API.h"
#include <SYS/SYS_Types.h>

class UT_API UT_NoiseValue {
public:
    union {
        float           myDistance;
        int             myIDistance;            // Used internally
    };
    uint                mySeed;
};

class UT_API UT_NoiseBasis {
public:
    static void         initNoise();

    static void noise1D(float pos, UT_NoiseValue vals[], int nvals);
    static void noise2D(const float pos[2], UT_NoiseValue vals[], int nvals);
    static void noise3D(const float pos[3], UT_NoiseValue vals[], int nvals);
    static void noise4D(const float pos[4], UT_NoiseValue vals[], int nvals);

    // For periodic noise, the period should contain dimension values (one for
    // each dimension)
    static void noise1D(float pos, UT_NoiseValue vals[], int nvals,
                        uint period);
    static void noise2D(const float pos[2], UT_NoiseValue vals[], int nvals,
                        const uint period[2])
                        { noise2D(pos, vals, nvals, period[0], period[1]); }
    static void noise2D(const float pos[2], UT_NoiseValue vals[], int nvals,
                        uint periodx, uint periody);
    static void noise3D(const float pos[3], UT_NoiseValue vals[], int nvals,
                        const uint period[3])
                        {
                            noise3D(pos, vals, nvals, period[0], period[1],
                                                      period[2]);
                        }
    static void noise3D(const float pos[3], UT_NoiseValue vals[], int nvals,
                        uint periodx, uint periody, uint periodz);
    static void noise4D(const float pos[4], UT_NoiseValue vals[], int nvals,
                        const uint period[4])
                        {
                            noise4D(pos, vals, nvals, period[0], period[1],
                                                      period[2], period[3]);
                        }
    static void noise4D(const float pos[4], UT_NoiseValue vals[], int nvals,
                        uint periodx, uint periody, uint periodz,
                        uint periodw);

    static void noise1D(const float P[1], const float *jitter, int *period,
                    int &seed, float &f1, float &f2, float p0[1], float p1[1]);
    static void noise2D(const float P[2], const float *jitter, int *period,
                    int &seed, float &f1, float &f2, float p0[2], float p1[2]);
    static void noise3D(const float P[3], const float *jitter, int *period,
                    int &seed, float &f1, float &f2, float p0[3], float p1[3]);
    static void noise4D(const float P[4], const float *jitter, int *period,
                    int &seed, float &f1, float &f2, float p0[4], float p1[4]);
private:
};

#endif

---