// SPDX-FileCopyrightText: Copyright (c) Kitware Inc.
// SPDX-License-Identifier: BSD-3-Clause
/**
 * @class   vtkSMInteractionUndoStackBuilder
 * @brief   builder server manager undo
 * sets for render view interactions and pushes them on the undo stack.
 *
 * vtkSMInteractionUndoStackBuilder specializes in interaction.
 * This class can create undo elements for only one render view
 * at a time.
 */

#ifndef vtkSMInteractionUndoStackBuilder_h
#define vtkSMInteractionUndoStackBuilder_h

#include "vtkRemotingMiscModule.h" //needed for exports
#include "vtkSMObject.h"

class vtkSMInteractionUndoStackBuilderObserver;
class vtkSMRenderViewProxy;
class vtkSMUndoStack;
class vtkUndoSet;

class VTKREMOTINGMISC_EXPORT vtkSMInteractionUndoStackBuilder : public vtkSMObject
{
public:
  static vtkSMInteractionUndoStackBuilder* New();
  vtkTypeMacro(vtkSMInteractionUndoStackBuilder, vtkSMObject);
  void PrintSelf(ostream& os, vtkIndent indent) override;

  ///@{
  /**
   * Get/Set the render view proxy for which we are monitoring the
   * interactions.
   */
  void SetRenderView(vtkSMRenderViewProxy*);
  vtkGetObjectMacro(RenderView, vtkSMRenderViewProxy);
  ///@}

  ///@{
  /**
   * Get/Set the undo stack that this builder will build.
   */
  vtkGetObjectMacro(UndoStack, vtkSMUndoStack);
  virtual void SetUndoStack(vtkSMUndoStack*);
  ///@}

  /**
   * Clear the undo set currently being recorded.
   */
  void Clear();

  /**
   * Called to record the state at the beginning of an interaction.
   * Usually, this method isn't called directly, since the builder
   * listens to interaction events on the interactor and calls it
   * automatically. May be used when changing the camera
   * programmatically.
   */
  void StartInteraction();

  /**
   * Called to record the state at the end of an interaction and push
   * it on the stack.
   * Usually, this method isn't called directly, since the builder
   * listens to interaction events on the interactor and calls it
   * automatically. May be used when changing the camera
   * programmatically.
   */
  void EndInteraction();

protected:
  vtkSMInteractionUndoStackBuilder();
  ~vtkSMInteractionUndoStackBuilder() override;

  vtkSMRenderViewProxy* RenderView;
  vtkSMUndoStack* UndoStack;
  vtkUndoSet* UndoSet;

  /**
   * Event handler.
   */
  void ExecuteEvent(vtkObject* caller, unsigned long event, void* data);

  void PropertyModified(const char* pname);

  friend class vtkSMInteractionUndoStackBuilderObserver;

private:
  vtkSMInteractionUndoStackBuilder(const vtkSMInteractionUndoStackBuilder&) = delete;
  void operator=(const vtkSMInteractionUndoStackBuilder&) = delete;

  vtkSMInteractionUndoStackBuilderObserver* Observer;
};

#endif
