world.H

/*
 * This file is part of the "Archon" framework.
 * (http://files3d.sourceforge.net)
 *
 * Copyright © 2002 by Kristian Spangsege and Brian Kristiansen.
 *
 * Permission to use, copy, modify, and distribute this software and
 * its documentation under the terms of the GNU General Public License is
 * hereby granted. No representations are made about the suitability of
 * this software for any purpose. It is provided "as is" without express
 * or implied warranty. See the GNU General Public License
 * (http://www.gnu.org/copyleft/gpl.html) for more details.
 *
 * The characters in this file are ISO8859-1 encoded.
 *
 * The documentation in this file is in "Doxygen" style
 * (http://www.doxygen.org).
 */

#ifndef ARCHON_RAYTRACER_WORLD_H
#define ARCHON_RAYTRACER_WORLD_H

#include <exception>
#include <string>
#include <vector>

#include <archon/math/vector.H>
#include <archon/util/color.H>
#include <archon/util/image.H>
#include <archon/util/kdtree.H>

#include "object.H"
#include "light.H"

namespace Archon
{
  namespace Raytracer
  {
    using namespace Utilities;
    using namespace Math;

    struct Photon: public KDTree::Element 
    {
      Vector3 position;
      Vector3 power; // Color
      Vector3 getPosition() const { return position; }
      Photon(const Vector3 &position, const Vector3 &power):
        position(position), power(power) {}
    };

    class World
    {
    private:
      const double globalAmbientIntencity;
      const Vector4 backgroundColor;
      const double significanceThreshold;
      const int maxDepth;
      const bool enableTransmission;
      const unsigned photonsInEstimate;
      const bool showOnlyPhotonMap;

      std::vector<Image>     textureList;
      std::vector<Surface *> surfaceList;
      std::vector<Vector3 *> vertexList;
      std::vector<Object *>  objectList;
      std::vector<Light *>   lightList;

      std::vector<Photon> photons;
      KDTree causticPhotonMap;

      Vector4 trace(const Line3 &ray,
                  const Object *originObject,
                  const Object::Part * originPart,
                  int depth, double significance,
                  bool transmission);

    public:
      World(const Vector4 &backgroundColor = ColorRGBA(Color::black),
            double significanceThreshold = 0.01,
            int maxDepth = 10,
            bool enableTransmission = true,
            unsigned photonsInEstimate = 30,
            bool showOnlyPhotonMap = false);

      World(double globalAmbientIntencity = 0.1,
            const Vector4 &backgroundColor = ColorRGBA(Color::black),
            double significanceThreshold = 0.01,
            int maxDepth = 10,
            bool enableTransmission = true,
            unsigned photonsInEstimate = 30,
            bool showOnlyPhotonMap = false);
      ~World();

      void addTexture(Image t)    { textureList.push_back(t); }
      void addSurface(Surface *s) { surfaceList.push_back(s); }
      void addVertex(Vector3 *v)  { vertexList.push_back(v);  }
      void addObject(Object *o)   { objectList.push_back(o);  }
      void addLight(Light *l)     { lightList.push_back(l);   }

      Vector4 trace(const Line3 &ray) { return trace(ray, 0, 0, 1, 1, false); }

      void photonTrace(unsigned);

      void photonTrace(const Line3 &ray, std::vector<Photon> &photons,
                       const Object *originObject,
                       const Object::Part *originPart,
                       int depth, bool transmission, 
                       bool caustic, const Vector3 &power);

      class InternalErrorException
      {
        const std::string message;
      public:
        InternalErrorException(std::string m): message(m) {}
      };
    };
  }
}

#endif // ARCHON_RAYTRACER_WORLD_H

---