// Copyright (C) 2010-2021  CEA/DEN, EDF R&D, OPEN CASCADE
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
//
// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
//
//  Author : Adrien Bruneton (CEA)


#ifndef __PVSERVER_GEN__
#define __PVSERVER_GEN__

#include "SALOME_Exception.idl"

/*!
  PVSERVER interface. This is a standalone service, not inheriting the EngineComponent interfaces. 
  
  The main service provided by the interface is to give to the caller the URL of the pvserver, and to launch it
  if it is not already started.  
  The connection to the ParaView's pvserver should then be done using ParaView's API directly.
*/
module PVSERVER_ORB {

  /*!
   * \brief The main interface class for PVSERVER CORBA service. 
   * Instantiation of this class has to be done before access to any other PARAVIS interfaces
   */
  interface PVSERVER_Gen 
  {
    
    /*!
     * \brief Returns IOR of the current object.
     */
    string GetIOR();
    
    /*! If a pvserver is already started, returns its current URL, regardless of the provided
     * parameters. 
     * If not, start a pvserver on the machine hosting the PARAVIS engine and on the given port.
     * If port <= 0, a free port is automatically detected, starting from the usual 11111 pvserver port.
     */
    string FindOrStartPVServer(in long port);

    /*! Tries to stop the PVserver currently running (send KILL). 
     * @return false if no server was running, true otherwise. 
     */
    boolean StopPVServer();
    
    /*! Indicates if the GUI process is already connected to the pvserver. 
     * This avoids multiple attempts to connect from a single thread (makes ParaView crash). */ 
    void SetGUIConnected(in boolean isConnected);
    
    /*! Indicates if the GUI process is already connected to the pvserver. 
     * This avoids multiple attempts to connect from a single thread (makes ParaView crash). */
    boolean GetGUIConnected();
    
  };

};

#endif