vtkOutputWindow.h

Go to the documentation of this file.

/*=========================================================================
 
  Program:   Visualization Toolkit
  Module:    vtkOutputWindow.h
 
  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
  All rights reserved.
  See Copyright.txt or http://www.kitware.com/Copyright.htm 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.
 
=========================================================================*/
#ifndef vtkOutputWindow_h
#define vtkOutputWindow_h
 
#include "vtkCommonCoreModule.h"  // For export macro
#include "vtkDebugLeaksManager.h" // Must be included before singletons
#include "vtkDeprecation.h"       // For VTK_DEPRECATED_IN_9_0_0
#include "vtkObject.h"
 
class VTKCOMMONCORE_EXPORT vtkOutputWindowCleanup
{
public:
  vtkOutputWindowCleanup();
  ~vtkOutputWindowCleanup();
 
private:
  vtkOutputWindowCleanup(const vtkOutputWindowCleanup& other) = delete;
  vtkOutputWindowCleanup& operator=(const vtkOutputWindowCleanup& rhs) = delete;
};
 
class vtkOutputWindowPrivateAccessor;
class VTKCOMMONCORE_EXPORT vtkOutputWindow : public vtkObject
{
public:
  // Methods from vtkObject
  vtkTypeMacro(vtkOutputWindow, vtkObject);
  void PrintSelf(ostream& os, vtkIndent indent) override;
 
  static vtkOutputWindow* New();
 
  static vtkOutputWindow* GetInstance();
  static void SetInstance(vtkOutputWindow* instance);
 
 
  virtual void DisplayText(const char*);
  virtual void DisplayErrorText(const char*);
  virtual void DisplayWarningText(const char*);
  virtual void DisplayGenericWarningText(const char*);
  virtual void DisplayDebugText(const char*);
 
 
  vtkBooleanMacro(PromptUser, bool);
  vtkSetMacro(PromptUser, bool);
 
 
  VTK_DEPRECATED_IN_9_0_0("Use vtkOutputWindow::SetDisplayMode")
  void SetUseStdErrorForAllMessages(bool);
  VTK_DEPRECATED_IN_9_0_0("Use vtkOutputWindow::GetDisplayMode")
  bool GetUseStdErrorForAllMessages();
  VTK_DEPRECATED_IN_9_0_0("Use vtkOutputWindow::SetDisplayMode")
  void UseStdErrorForAllMessagesOn();
  VTK_DEPRECATED_IN_9_0_0("Use vtkOutputWindow::SetDisplayMode")
  void UseStdErrorForAllMessagesOff();
 
 
  enum DisplayModes
  {
    DEFAULT = -1,
    NEVER = 0,
    ALWAYS = 1,
    ALWAYS_STDERR = 2
  };
  vtkSetClampMacro(DisplayMode, int, DEFAULT, ALWAYS_STDERR);
  vtkGetMacro(DisplayMode, int);
  void SetDisplayModeToDefault() { this->SetDisplayMode(vtkOutputWindow::DEFAULT); }
  void SetDisplayModeToNever() { this->SetDisplayMode(vtkOutputWindow::NEVER); }
  void SetDisplayModeToAlways() { this->SetDisplayMode(vtkOutputWindow::ALWAYS); }
  void SetDisplayModeToAlwaysStdErr() { this->SetDisplayMode(vtkOutputWindow::ALWAYS_STDERR); }
protected:
  vtkOutputWindow();
  ~vtkOutputWindow() override;
 
  enum MessageTypes
  {
    MESSAGE_TYPE_TEXT,
    MESSAGE_TYPE_ERROR,
    MESSAGE_TYPE_WARNING,
    MESSAGE_TYPE_GENERIC_WARNING,
    MESSAGE_TYPE_DEBUG
  };
 
  vtkGetMacro(CurrentMessageType, MessageTypes);
 
  enum class StreamType
  {
    Null,
    StdOutput,
    StdError,
  };
 
  virtual StreamType GetDisplayStream(MessageTypes msgType) const;
 
  bool PromptUser;
 
private:
  static vtkOutputWindow* Instance;
  MessageTypes CurrentMessageType;
  int DisplayMode;
  int InStandardMacros; // used to suppress display to output streams from standard macros when
                        // logging is enabled.
 
  friend class vtkOutputWindowPrivateAccessor;
 
private:
  vtkOutputWindow(const vtkOutputWindow&) = delete;
  void operator=(const vtkOutputWindow&) = delete;
};
 
// Uses schwartz counter idiom for singleton management
static vtkOutputWindowCleanup vtkOutputWindowCleanupInstance;
 
#endif