lightcache.h

/* *************************************************************************
                          lightcache.h  -  description
                             -------------------
    begin                : Wed Oct 16 2002        
    copyright            : (C) 2002 by Micha Riser
    email                : mriser@gmx.net

    $Id: lightcache_8h-source.html,v 1.1 2005/02/04 21:02:27 micha Exp $
    
 ************************************************************************* */

/* *************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ************************************************************************* */

#ifndef LIGHTCACHE_H
#define LIGHTCACHE_H

#include "vector.h"
#include "colour.h"
#include "lightlist.h"
#include "statistics.h"

class Scene;

class LightCache {

public: // Constructors and destructor
    LightCache(const Scene* s);

private:
    LightCache(const LightCache&);
    LightCache& operator=(const LightCache&);

public: // Public methods

    void setType(int size);

    LightList* lookup(const Vector3& location, CLR err, FLT& precision, FLT variance_keep_factor);

    static int sampleCounts() {
        return Hash::insertstat.getEvalCount();
    }

private: // Inner classes

    class MapEntry {

    public: // Public attributes
        Vector3f location;
        LightList* list;
        unsigned int hitcount;

    public: // Constructor and destructor
        MapEntry(const Vector3f& l, LightList* data):
          location(l), list(data), hitcount(initialcount) {}
  
        MapEntry(): list(0), hitcount(0) {}

        ~MapEntry() {}
        
    };


    class Hash {

    public: // Static members

        static HitStatistics hitstat;
        static HitStatistics insertstat;
            
    public: // Constructor and destructor
        Hash();
        ~Hash();
    private:
        Hash(const Hash&);
        Hash& operator=(const Hash&);

    public: // Public methods
        void setSize(int size);
        bool get(const Vector3f& location, LightList*&);
        void put(const Vector3f& location, LightList* l);

    private: // Private attributes
        int size, sondmod;
        MapEntry* data;

    private: // Private methods
        unsigned int calcHashValue(unsigned int);
        unsigned int calcHashValueSond(unsigned int);

    };


    class VarianceMapEntry {
    public:
        Vector3f location; 
        unsigned int gridsize;
        CLR variance;
    public:
        VarianceMapEntry(): location(0), gridsize(0), variance(0) {};
        VarianceMapEntry(const Vector3f& l, unsigned int size, CLR var):
          location(l), gridsize(size), variance(var) {};
    };


    class VarianceHash {

    public:
        static HitStatistics hitstat;
        VarianceHash();
        ~VarianceHash();
    private:
        VarianceHash(const VarianceHash&);
        VarianceHash& operator=(const VarianceHash&);

    public: // Public methods
        void setSize(int size);
        bool get(const Vector3f& location, unsigned int gridsize, CLR& variance);
        void put(const Vector3f& location, unsigned int gridsize, CLR variance);

    private: // Private attributes
        int size, sondmod;
        VarianceMapEntry* data;

    };


private: // Constants
    // these constants are set quite arbitrarly, affect fine-tune of the cache
    static const int sondsize = 3;
    static const unsigned int hitbonus = 1000;
    static const unsigned int initialcount = 1000;

private: // Private methods
    LightList* sample(const Vector3f& p);

private: // Private attributes
    const Scene* scene;
    Hash map;
    VarianceHash varmap;

};

#endif

---