Camera_Details.hxx

// 
// Copyright (C) 2006 James M. Lawrence.  All rights reserved.
// 
// software: esve-1.0.3
// file: esve/engine/dim3/Camera_Details.hxx
// 
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions
// are met:
// 
// 1. Redistributions of source code must retain the above copyright
//    notice, this list of conditions and the following disclaimer.
// 
// 2. The origin of this software must not be misrepresented; you must
//    not claim that you wrote the original software.  If you use this
//    software in a product, an acknowledgment in the product 
//    documentation would be appreciated but is not required.
// 
// 3. Altered source versions must be plainly marked as such, and must
//    not be misrepresented as being the original software.
// 
// 4. The name of the author may not be used to endorse or promote
//    products derived from this software without specific prior written
//    permission.
// 
// THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY,
// AND WITH NO CLAIM AS TO ITS SUITABILITY FOR ANY PURPOSE.  IN NO EVENT
// SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM WHATSOEVER MADE IN CONNECTION
// TO THIS SOFTWARE.
// 

#ifndef esve_engine_dim3_Camera_Details_hxx
#define esve_engine_dim3_Camera_Details_hxx

#include <esve/types/real.hxx>

namespace esve { namespace engine { namespace dim3 {


class Camera_Details
{
public:
    enum Projection
    {
        ORTHOGONAL,

        PERSPECTIVE,

        CUSTOM
    } ;

    struct Orthogonal_Projection
    {
        types::real frustum_height ;

        types::real near_clip ;
        types::real far_clip ;

        Orthogonal_Projection( types::real frustum_height,
                               types::real near_clip,
                               types::real far_clip ) ;
    } ;

    struct Perspective_Projection
    {
        types::real field_of_view ;

        types::real near_clip ;
        types::real far_clip ;

        Perspective_Projection( types::real field_of_view,
                                types::real near_clip,
                                types::real far_clip ) ;
    } ;

    virtual Projection projection() const = 0 ;


    virtual void orthogonal_projection( const Orthogonal_Projection & ) = 0 ;

    virtual void perspective_projection( const Perspective_Projection & ) = 0 ;

    virtual void custom_projection() = 0 ;



    virtual const Orthogonal_Projection &
    orthogonal_projection_data() const = 0 ;

    virtual const Perspective_Projection &
    perspective_projection_data() const = 0 ;


    virtual types::real far_clip() const = 0 ;
    virtual void far_clip( types::real ) = 0 ;
    virtual types::real near_clip() const = 0 ;
    virtual void near_clip( types::real ) = 0 ;

    virtual ~Camera_Details() = 0 ;

protected:
    Camera_Details() ;

    virtual void compute_perspective_projection() = 0 ;
    virtual void compute_orthogonal_projection() = 0 ;
    virtual void compute_custom_projection() = 0 ;

    // Allow aggregates to call compute_*_projection().
    static void call_compute_projection( Camera_Details & ) ;

private:
    Camera_Details( const Camera_Details & ) ;
    Camera_Details & operator=( const Camera_Details & ) ;
} ;

}}} // namespace esve::engine::dim3

#endif

---