File: vtkClientServerInterpreterInitializer.h

package info (click to toggle)
paraview 5.4.1%2Bdfsg4-3.1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 218,616 kB
  • sloc: cpp: 2,331,508; ansic: 322,365; python: 111,051; xml: 79,203; tcl: 47,013; yacc: 4,877; java: 4,438; perl: 3,238; sh: 2,920; lex: 1,908; f90: 748; makefile: 273; pascal: 228; objc: 83; fortran: 31
file content (95 lines) | stat: -rw-r--r-- 3,553 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
/*=========================================================================

  Program:   ParaView
  Module:    vtkClientServerInterpreterInitializer.h

  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   vtkClientServerInterpreterInitializer
 *
 * vtkClientServerInterpreterInitializer initializes and maintains the global
 * vtkClientServerInterpreter instance for the processes. Use RegisterCallback()
 * to register initialization routines for the interpreter. Use GetInterpreter()
 * to access the interpreter.
 *
 * This class was originally designed to support and maintain multiple
 * interpreter instances. However ParaView no longer has need for that and hence
 * that functionality is no longer made public.
*/

#ifndef vtkClientServerInterpreterInitializer_h
#define vtkClientServerInterpreterInitializer_h

#include "vtkObject.h"
#include "vtkPVCommonModule.h" // needed for export macro

class vtkClientServerInterpreter;

class VTKPVCOMMON_EXPORT vtkClientServerInterpreterInitializer : public vtkObject
{
public:
  vtkTypeMacro(vtkClientServerInterpreterInitializer, vtkObject);
  void PrintSelf(ostream& os, vtkIndent indent) VTK_OVERRIDE;

  /**
   * Creates (and registers) a new interpreter.
   */
  vtkClientServerInterpreter* NewInterpreter();

  /**
   * Get the interpreter for this process. Initializing a new interpreter is
   * expensive. So filters that need to use interpreter temporarily to call
   * methods on a vtkObject can simply use the global interpreter. As a rule,
   * if you need to assign ID's to objects, then you're probably better off
   * creating a new interpreter using NewInterpreter() and using it rather than
   * the global interpreter.
   */
  static vtkClientServerInterpreter* GetGlobalInterpreter();

  /**
   * Provides access to the singleton. This will instantiate
   * vtkClientServerInterpreterInitializer the first time it is called.
   */
  static vtkClientServerInterpreterInitializer* GetInitializer();

  typedef void (*InterpreterInitializationCallback)(vtkClientServerInterpreter*);

  /**
   * Use this method register an interpreter initializer function. Registering
   * such a callback makes it possible to initialize interpreters created in the
   * lifetime of the application, including those that have already been
   * created (but not destroyed). One cannot unregister a callback. The only
   * reason for doing so would be un-loading a plugin, but that's not supported
   * and never will be :).
   */
  void RegisterCallback(InterpreterInitializationCallback callback);

protected:
  static vtkClientServerInterpreterInitializer* New();
  vtkClientServerInterpreterInitializer();
  ~vtkClientServerInterpreterInitializer();

  /**
   * Registers an interpreter. This DOES NOT affect the reference count of the
   * interpreter (hence there's no UnRegister).
   */
  void RegisterInterpreter(vtkClientServerInterpreter*);

private:
  vtkClientServerInterpreterInitializer(
    const vtkClientServerInterpreterInitializer&) VTK_DELETE_FUNCTION;
  void operator=(const vtkClientServerInterpreterInitializer&) VTK_DELETE_FUNCTION;

  class vtkInternals;
  vtkInternals* Internals;
};

#endif