MRAppendHistory.h

Go to the documentation of this file.

#pragma once
 
#include "MRHistoryStore.h"
#include <MRMesh/MRHistoryAction.h>
#include <string>
#include <memory>
 
namespace MR
{
 
// This function appends history action to viewers global history store
template<class HistoryActionType, typename... Args>
void AppendHistory( Args&&... args )
{
    static_assert( std::is_base_of_v<HistoryAction, HistoryActionType> );
    if ( const auto & s = HistoryStore::getViewerInstance() )
        s->appendAction( std::make_shared<HistoryActionType>( std::forward<Args>( args )... ) );
}
 
template<class HistoryActionType>
void AppendHistory( std::shared_ptr<HistoryActionType> action )
{
    static_assert( std::is_base_of_v<HistoryAction, HistoryActionType> );
    if ( const auto & s = HistoryStore::getViewerInstance() )
        s->appendAction( action );
}
 
// if undo history is enabled, creates given action in the constructor;
// and always mark the object as dirty in the destructor
template<class HistoryActionType>
class Historian
{
public:
    static_assert( std::is_base_of_v<HistoryAction, HistoryActionType> );
    using Obj = typename HistoryActionType::Obj;
 
    template<typename... Args>
    Historian( std::string name, std::shared_ptr<Obj> obj, Args&&... args ) : obj_( std::move( obj ) )
    {
        if ( HistoryStore::getViewerInstance() )
            action_ = std::make_shared<HistoryActionType>( std::move( name ), obj_, std::forward<Args>( args )... );
    }
 
    void cancelAction()
    {
        if ( action_ )
        {
            action_->action( HistoryAction::Type::Undo );
            action_.reset();
        }
        canceled_ = true;
    }
 
    ~Historian()
    {
        if ( action_ )
            AppendHistory( std::move( action_ ) );
        if ( !canceled_ )
            HistoryActionType::setObjectDirty( obj_ );
    }
private:
    std::shared_ptr<Obj> obj_;
    std::shared_ptr<HistoryActionType> action_;
    bool canceled_{ false };
};
 
MRVIEWER_API void FilterHistoryByCondition( HistoryStackFilter filteringCondition, bool deepFiltering = true );
 
// This class store history actions that are appended to global history stack all together as CombinedHistoryAction in destructor (if scoped stack is not empty)
class ScopeHistory
{
public:
    MRVIEWER_API ScopeHistory( const std::string& name );
    MRVIEWER_API ~ScopeHistory();
 
private:
    std::string name_;
    std::shared_ptr<HistoryStore> store_;
    HistoryActionsVector scope_;
    HistoryActionsVector* parentScopePtr_{ nullptr };
};
 
#define SCOPED_HISTORY(name) MR::ScopeHistory __startScopedHistoryMode(name)
 
}