Rotation_Handler.hxx

// 
// Copyright (C) 2006 James M. Lawrence.  All rights reserved.
// 
// software: esve-1.0.3
// file: esve/components/dim4/Rotation_Handler.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.
// 
//
// This class deals only with rotations, and will in fact normalize
// the transformation it is given.
//

#ifndef esve_components_dim4_Rotation_Handler_hxx
#define esve_components_dim4_Rotation_Handler_hxx

#include <esve/components/dimn/Differential_Motion_Handler.hxx>
#include <esve/engine/dim4/impl/Transform.hxx>
#include <esve/types/pure.hxx>
#include <memory>

namespace esve { namespace components { namespace dim4 {


class Rotation_Handler
    : public components::dimn::Differential_Motion_Handler
             <
                 engine::dim4::Transform,
                 engine::dim4::impl::Transform
             >
{
private:
    typedef
    components::dimn::Differential_Motion_Handler
             <
                 engine::dim4::Transform,
                 engine::dim4::impl::Transform
             >
    super ;

    Rotation_Handler( const Rotation_Handler & ) ;
    Rotation_Handler & operator=( const Rotation_Handler & ) ;

    class Private ;
    const std::auto_ptr<Private> m ;

public:
    enum Mapping
    {
        ROTATE_K_TOWARD_U,

        ROTATE_K_TOWARD_U_PERP,

        ROTATE_1_TOWARD_U,

        ROTATE_1_TOWARD_U_PERP,

        LEFT_HOPF_ROTATION,

        RIGHT_HOPF_ROTATION,

        NEG_LEFT_HOPF_ROTATION,

        NEG_RIGHT_HOPF_ROTATION,

        DOUBLE_ROTATE_1IJK,

        DOUBLE_ROTATE_1JKI,


        DOUBLE_ROTATE_1KIJ,

        DOUBLE_ROTATE_IJ1K,

        DO_NOTHING
    } ;

    explicit Rotation_Handler( engine::dim4::Transform & ) ;

    virtual Mapping mapping( Button ) const ;
    virtual void mapping( Button, Mapping ) ;

    ~Rotation_Handler() ;

protected:
    void create_motion( Button, const types::pure & du_dt ) ;
    engine::dim4::impl::Transform
    differential_motion( Button button, types::real dt ) ;
    void stop_motion( Button ) ;
    bool has_motion( Button ) ;
} ;

}}} // namespace esve::components::dim4

#endif

---