perfectspecularbrdf.h

Go to the documentation of this file.

/*
    toxic - A Global Illumination Renderer
    Copyright (C) 2003-2004 Francois Beaune
    Contact: http://toxicengine.sourceforge.net/

    This file is part of toxic.

    toxic 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.

    toxic is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with toxic; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/

#ifndef TOXIC_RENDERER_PERFECTSPECULARBRDF_H
#define TOXIC_RENDERER_PERFECTSPECULARBRDF_H

#include "common/math/real.h"
#include "common/math/vector3.h"
#include "globals.h"
#include "ibdf.h"

#include <cassert>

namespace toxic {

    class Context;

    class PerfectSpecularBRDF : public IBRDF {
    public:
        //! Incoming and outgoing directions are both always expressed in the upper
        //! part of the unit hemisphere, and they are always unit-length.

        virtual ~PerfectSpecularBRDF() {}

        virtual PerfectSpecularBRDF *Clone() const;

        virtual bool IsDiffuse() const { return false; }
        virtual bool IsSpecular() const { return true; }

        //! Evaluates the function. Both the incoming and outgoing directions are
        //! expressed in local space.
        virtual sheep::Real Evaluate(
            const Context &context,
            const sheep::Vector3 &incoming,
            const sheep::Vector3 &outgoing) const;

        virtual sheep::Real EvaluateSpecular(
            const Context &context,
            const sheep::Vector3 &incoming,
            sheep::Vector3 *outgoing) const;

        //! Samples the function in order to obtain an outgoing direction, given
        //! an incoming direction. The probability with which the direction has
        //! been chosen is also computed. Both incoming and outgoing directions
        //! are expressed in local space.
        virtual void Sample(
            const Context &context,
            const sheep::Vector3 &incoming,
            sheep::Vector3 *outgoing,
            sheep::Real *prob,
            sheep::Real *value) const;

        //! Computes the probability of scattering from 'incoming' direction to
        //! 'outgoing' direction. Both incoming and outgoing directions are
        //! expressed in local space.
        virtual sheep::Real ComputeScatteringProbability(
            const sheep::Vector3 &incoming,
            const sheep::Vector3 &outgoing) const;

        //! Computes and returns the hemispherical hemispherical reflectance.
        virtual sheep::Real ComputeReflectance(const Context &context) const;

        //! Computes and returns the directional hemispherical reflectance. The
        //! incoming direction is expressed in local space.
        virtual sheep::Real ComputeReflectance(
            const Context &context,
            const sheep::Vector3 &incoming) const;
    };

#include "perfectspecularbrdf.inl"

}

#endif  // !TOXIC_RENDERER_PERFECTSPECULARBRDF_H

---