/*=========================================================================

  Program:   ParaView
  Module:    $RCSfile$

  Copyright (c) Kitware, Inc.
  All rights reserved.
  See Copyright.txt or http://www.paraview.org/HTML/Copyright.html for details.

     This software is distributed WITHOUT ANY WARRANTY; without even
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
     PURPOSE.  See the above copyright notice for more information.

=========================================================================*/
/**
 * @class   vtkSMDataDeliveryManager
 * @brief   server-manager class for
 * vtkPVDataDeliveryManager.
 *
 * vtkSMDataDeliveryManager is the server-manager wrapper for
 * vtkPVDataDeliveryManager. It manages calling on methods on instances of
 * vtkPVDataDeliveryManager. Before every render call, vtkSMRenderViewProxy
 * calls vtkSMDataDeliveryManager::Deliver() to ensure that any geometries that
 * need to be delivered are explicitly delivered. This separating into
 * Update-Deliver-Render calls ensures makes it possible to extend the framework
 * for streaming, in future.
 *
 * The streaming components of this class are experimental and will be changed.
*/

#ifndef vtkSMDataDeliveryManager_h
#define vtkSMDataDeliveryManager_h

#include "vtkPVServerManagerRenderingModule.h" //needed for exports
#include "vtkSMObject.h"
#include "vtkWeakPointer.h" // needed for iVars
class vtkSMViewProxy;

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

  /**
   * Get/Set the view proxy for whom we are delivering the data.
   */
  void SetViewProxy(vtkSMViewProxy*);

  /**
   * Called to request delivery of the geometry. This checks the client-side
   * vtkPVDataDeliveryManager instance to see if any geometries need to be
   * delivered and then requests delivery for those.
   */
  void Deliver(bool interactive);

  /**
   * EXPERIMEMTAL: Delivery when streaming is enabled.
   * Returns true when some new data was streamed. When this returns false, it
   * implies that there is no more data to stream or streaming is not enabled.
   */
  bool DeliverStreamedPieces();

protected:
  vtkSMDataDeliveryManager();
  ~vtkSMDataDeliveryManager();

  vtkWeakPointer<vtkSMViewProxy> ViewProxy;

  enum
  {
    LOCAL_RENDERING_AND_FULL_RES = 0,
    LOCAL_RENDERING_AND_LOW_RES = 1,
    REMOTE_RENDERING_AND_FULL_RES = 2,
    REMOTE_RENDERING_AND_LOW_RES = 3,
  };
  vtkTimeStamp DeliveryTimestamps[4];

private:
  vtkSMDataDeliveryManager(const vtkSMDataDeliveryManager&) VTK_DELETE_FUNCTION;
  void operator=(const vtkSMDataDeliveryManager&) VTK_DELETE_FUNCTION;
};

#endif
