include/eq/fabric/view.h

/* Copyright (c) 2008-2012, Stefan Eilemann <eile@equalizergraphics.com>
 *                    2010, Cedric Stalder <cedric.stalder@gmail.com>
 *
 * This library is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License version 2.1 as published
 * by the Free Software Foundation.
 *  
 * This library 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 Lesser General Public License for more
 * details.
 * 
 * You should have received a copy of the GNU Lesser General Public License
 * along with this library; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */

#ifndef EQFABRIC_VIEW_H
#define EQFABRIC_VIEW_H

#include <eq/fabric/api.h>
#include <eq/fabric/frustum.h>        // base class
#include <eq/fabric/object.h>         // base class
#include <eq/fabric/types.h>
#include <eq/fabric/viewport.h>       // member
#include <eq/fabric/visitorResult.h>  // enum

#define EQ_MM 1000.f
#define EQ_CM 100.f
#define EQ_DM 10.f
#define EQ_M  1.f
#define EQ_KM 0.001f
#define EQ_UNDEFINED_UNIT -1.f

namespace eq
{
namespace fabric
{
    template< class L, class V, class O >
    class View : public Object, public Frustum
    {
    public:
        enum Mode
        {
            MODE_MONO = 1,   
            MODE_STEREO      
        };

        EQFABRIC_INL const Viewport& getViewport() const;

        L* getLayout() { return _layout; }

        const L* getLayout() const { return _layout; }

        EQFABRIC_INL void setObserver( O* observer );
        
        O* getObserver() { return _observer; }

        const O* getObserver() const { return _observer; }

        EQFABRIC_INL virtual void setWall( const Wall& wall );
        
        EQFABRIC_INL virtual void setProjection( const Projection& );

        EQFABRIC_INL virtual void unsetFrustum();

        EQFABRIC_INL void setOverdraw( const Vector2i& pixels );

        const Vector2i& getOverdraw() const { return _data.overdraw; }

        EQFABRIC_INL void useEqualizer( uint32_t equalizerMask );

        uint32_t getEqualizers() const { return _data.equalizers; }

        EQFABRIC_INL void setTileSize( const Vector2i& size );

        const Vector2i& getTileSize() const { return _data.tileSize; }

        EQFABRIC_INL void setViewport( const Viewport& viewport );

        Mode getMode() const { return _data.mode; }
        
        EQFABRIC_INL virtual void changeMode( const Mode mode );
        
        virtual void activateMode( const Mode mode ){ _data.mode = mode; }

        EQFABRIC_INL bool isActive() const;

        EQFABRIC_INL bool setModelUnit( const float modelUnit );

        EQFABRIC_INL float getModelUnit() const;

        EQFABRIC_INL VisitorResult accept( LeafVisitor< V >& visitor );

        EQFABRIC_INL VisitorResult accept( LeafVisitor< V >& visitor ) const;

        virtual EQFABRIC_INL void backup(); 
        virtual EQFABRIC_INL void restore(); 

        EQFABRIC_INL void setMinimumCapabilities( const uint64_t bitmask );

        EQFABRIC_INL uint64_t getMinimumCapabilities() const;

        EQFABRIC_INL void setMaximumCapabilities(const uint64_t bitmask);

        EQFABRIC_INL uint64_t getMaximumCapabilities() const;

        EQFABRIC_INL uint64_t getCapabilities() const;

        void setCapabilities( const uint64_t bitmask ); 
        virtual void updateCapabilities() {} 

        enum DirtyBits
        {
            DIRTY_VIEWPORT      = Object::DIRTY_CUSTOM << 0,
            DIRTY_OBSERVER      = Object::DIRTY_CUSTOM << 1,
            DIRTY_OVERDRAW      = Object::DIRTY_CUSTOM << 2,
            DIRTY_FRUSTUM       = Object::DIRTY_CUSTOM << 3,
            DIRTY_MODE          = Object::DIRTY_CUSTOM << 4,
            DIRTY_MINCAPS       = Object::DIRTY_CUSTOM << 5,
            DIRTY_MAXCAPS       = Object::DIRTY_CUSTOM << 6,
            DIRTY_CAPABILITIES  = Object::DIRTY_CUSTOM << 7,
            DIRTY_TILESIZE      = Object::DIRTY_CUSTOM << 8,
            DIRTY_EQUALIZERS    = Object::DIRTY_CUSTOM << 9,
            DIRTY_MODELUNIT     = Object::DIRTY_CUSTOM << 10,
            DIRTY_VIEW_BITS =
                DIRTY_VIEWPORT | DIRTY_OBSERVER | DIRTY_OVERDRAW |
                DIRTY_FRUSTUM | DIRTY_MODE | DIRTY_MINCAPS | DIRTY_MAXCAPS |
                DIRTY_CAPABILITIES | DIRTY_OBJECT_BITS | DIRTY_TILESIZE |
                DIRTY_EQUALIZERS | DIRTY_MODELUNIT
        };

    protected:
        EQFABRIC_INL View( L* layout );

        EQFABRIC_INL virtual ~View();

        virtual bool hasMasterUserData() { return getLayout() != 0; }

        EQFABRIC_INL virtual uint32_t getUserDataLatency() const;

        EQFABRIC_INL virtual void serialize( co::DataOStream& os,
                                             const uint64_t dirtyBits );

        EQFABRIC_INL virtual void deserialize( co::DataIStream& is, 
                                               const uint64_t dirtyBits );

        EQFABRIC_INL virtual void setDirty( const uint64_t bits );

        virtual uint64_t getRedistributableBits() const
            { return DIRTY_VIEW_BITS; }

    private:
        L* const _layout;

        O* _observer;

        struct BackupData
        {
            BackupData();

            Viewport viewport;

            Vector2i overdraw;

            Vector2i tileSize; 

            uint64_t minimumCapabilities; 
            uint64_t maximumCapabilities; 
            uint64_t capabilities; 
        
            Mode mode; 
            uint32_t equalizers; 

            float modelUnit;
        }
            _data, _backup;

        struct Private;
        Private* _private; // placeholder for binary-compatible changes
    };

    template< class L, class V, class O >
    EQFABRIC_INL std::ostream& operator << ( std::ostream& os,
                                             const View< L, V, O >& view );
}
}
#endif // EQFABRIC_VIEW_H