Oriented_Rotation_Handler.hxx

// 
// Copyright (C) 2006 James M. Lawrence.  All rights reserved.
// 
// software: esve-1.0.3
// file: esve/components/dim3/Oriented_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.
// 

#ifndef esve_components_dim3_Oriented_Rotation_Handler_hxx
#define esve_components_dim3_Oriented_Rotation_Handler_hxx

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

namespace esve { namespace components { namespace dim3 {


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

    Oriented_Rotation_Handler( const Oriented_Rotation_Handler & ) ;
    Oriented_Rotation_Handler &
    operator=( const Oriented_Rotation_Handler & ) ;

    // axis differential angle
    types::real m_dtheta_dt ;

    // elevation differential angle
    types::real m_dphi_dt ;

    // record whether we are upside down when the mouse push occurs
    types::real m_sign ;

public:
    explicit Oriented_Rotation_Handler( engine::dim3::Transform & ) ;

    ~Oriented_Rotation_Handler() ;

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

    // base override
    bool handle_supermouse_push( Button, const Supermouse & ) ;
} ;

}}} // namespace esve::components::dim3

#endif

---