pcsx2/common/include/Utilities/Console.h

/*  PCSX2 - PS2 Emulator for PCs
 *  Copyright (C) 2002-2010  PCSX2 Dev Team
 *
 *  PCSX2 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 Found-
 *  ation, either version 3 of the License, or (at your option) any later version.
 *
 *  PCSX2 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 General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License along with PCSX2.
 *  If not, see <http://www.gnu.org/licenses/>.
 */

#pragma once

#include "StringHelpers.h"

enum ConsoleColors
{
	Color_Current = -1,

	Color_Black = 0,
	Color_Green,
	Color_Red,
	Color_Blue,
	Color_Magenta,
	Color_Orange,
	Color_Gray,

	Color_Cyan,			// faint visibility, intended for logging PS2/IOP output
	Color_Yellow,		// faint visibility, intended for logging PS2/IOP output
	Color_White,		// faint visibility, intended for logging PS2/IOP output

	// Strong text *may* result in mis-aligned text in the console, depending on the
	// font and the platform, so use these with caution.
	Color_StrongBlack,
	Color_StrongRed,	// intended for errors
	Color_StrongGreen,	// intended for infrequent state information
	Color_StrongBlue,	// intended for block headings
	Color_StrongMagenta,
	Color_StrongOrange,	// intended for warnings
	Color_StrongGray,

	Color_StrongCyan,
	Color_StrongYellow,
	Color_StrongWhite,

    Color_Default,

	ConsoleColors_Count
};

static const ConsoleColors DefaultConsoleColor = Color_Default;


// Use fastcall for the console; should be helpful in most cases
#define __concall	__fastcall

// ----------------------------------------------------------------------------------------
//  IConsoleWriter -- For printing messages to the console.
// ----------------------------------------------------------------------------------------
// General ConsoleWrite Threading Guideline:
//   PCSX2 is a threaded environment and multiple threads can write to the console asynchronously.
//   Individual calls to ConsoleWriter APIs will be written in atomic fashion, however "partial"
//   logs may end up interrupted by logs on other threads.  This is usually not a problem for
//   WriteLn, but may be undesirable for typical uses of Write.  In cases where you want to
//   print multi-line blocks of uninterrupted logs, compound the entire log into a single large
//   string and issue that to WriteLn.
//
struct IConsoleWriter
{
	// A direct console write, without tabbing or newlines.  Useful to devs who want to do quick
	// logging of various junk; but should *not* be used in production code due.
	void (__concall *WriteRaw)( const wxString& fmt );

	// WriteLn implementation for internal use only.  Bypasses tabbing, prefixing, and other
	// formatting.
	void (__concall *DoWriteLn)( const wxString& fmt );

	// SetColor implementation for internal use only.
	void (__concall *DoSetColor)( ConsoleColors color );

	// Special implementation of DoWrite that's pretty much for MSVC use only.
	// All implementations should map to DoWrite, except Stdio which should map to Null.
	// (This avoids circular/recursive stdio output)
	void (__concall *DoWriteFromStdout)( const wxString& fmt );

	void (__concall *Newline)();
	void (__concall *SetTitle)( const wxString& title );

	// internal value for indentation of individual lines.  Use the Indent() member to invoke.
	int _imm_indentation;

	// For internal use only.
	wxString _addIndentation( const wxString& src, int glob_indent ) const;

	// ----------------------------------------------------------------------------
	// Public members; call these to print stuff to console!
	//
	// All functions always return false.  Return value is provided only so that we can easily
	// disable logs at compile time using the "0&&action" macro trick.

	ConsoleColors GetColor() const;
	const IConsoleWriter& SetColor( ConsoleColors color ) const;
	const IConsoleWriter& ClearColor() const;
	const IConsoleWriter& SetIndent( int tabcount=1 ) const;

	IConsoleWriter Indent( int tabcount=1 ) const;

	bool FormatV( const char* fmt, va_list args ) const;
	bool WriteLn( ConsoleColors color, const char* fmt, ... ) const;
	bool WriteLn( const char* fmt, ... ) const;
	bool Error( const char* fmt, ... ) const;
	bool Warning( const char* fmt, ... ) const;

	bool FormatV( const wxChar* fmt, va_list args ) const;
	bool WriteLn( ConsoleColors color, const wxChar* fmt, ... ) const;
	bool WriteLn( const wxChar* fmt, ... ) const;
	bool Error( const wxChar* fmt, ... ) const;
	bool Warning( const wxChar* fmt, ... ) const;
};

// --------------------------------------------------------------------------------------
//  NullConsoleWriter
// --------------------------------------------------------------------------------------
// Used by Release builds for Debug and Devel writes (DbgCon / DevCon).  Inlines to NOPs. :)
//
struct NullConsoleWriter
{
	void WriteRaw( const wxString& fmt ) {}
	void DoWriteLn( const wxString& fmt ) {}
	void DoSetColor( ConsoleColors color ) {}
	void DoWriteFromStdout( const wxString& fmt ) {}
	void Newline() {}
	void SetTitle( const wxString& title ) {}


	ConsoleColors GetColor() const { return Color_Current; }
	const NullConsoleWriter& SetColor( ConsoleColors color ) const { return *this; }
	const NullConsoleWriter& ClearColor() const { return *this; }
	const NullConsoleWriter& SetIndent( int tabcount=1 ) const { return *this; }

	NullConsoleWriter Indent( int tabcount=1 ) const { return NullConsoleWriter(); }

	bool FormatV( const char* fmt, va_list args ) const				{ return false; }
	bool WriteLn( ConsoleColors color, const char* fmt, ... ) const	{ return false; }
	bool WriteLn( const char* fmt, ... ) const						{ return false; }
	bool Error( const char* fmt, ... ) const						{ return false; }
	bool Warning( const char* fmt, ... ) const						{ return false; }

	bool FormatV( const wxChar* fmt, va_list args ) const			{ return false; }
	bool WriteLn( ConsoleColors color, const wxChar* fmt, ... ) const { return false; }
	bool WriteLn( const wxChar* fmt, ... ) const					{ return false; }
	bool Error( const wxChar* fmt, ... ) const						{ return false; }
	bool Warning( const wxChar* fmt, ... ) const					{ return false; }
};

// --------------------------------------------------------------------------------------
//  ConsoleIndentScope
// --------------------------------------------------------------------------------------
// Provides a scoped indentation of the IConsoleWriter interface for the current thread.
// Any console writes performed from this scope will be indented by the specified number
// of tab characters.
//
// Scoped Object Notes:  Like most scoped objects, this is intended to be used as a stack
// or temporary object only.  Using it in a situation where the object's lifespan out-lives
// a scope will almost certainly result in unintended /undefined side effects.
//
class ConsoleIndentScope
{
	DeclareNoncopyableObject( ConsoleIndentScope );

protected:
	int			m_amount;
	bool		m_IsScoped;

public:
	// Constructor: The specified number of tabs will be appended to the current indentation
	// setting.  The tabs will be unrolled when the object leaves scope or is destroyed.
	ConsoleIndentScope( int tabs=1 );
	virtual ~ConsoleIndentScope() throw();	
	void EnterScope();
	void LeaveScope();
};

// --------------------------------------------------------------------------------------
//  ConsoleColorScope
// --------------------------------------------------------------------------------------
class ConsoleColorScope
{
	DeclareNoncopyableObject( ConsoleColorScope );

protected:
	ConsoleColors	m_newcolor;
	ConsoleColors	m_old_color;
	bool			m_IsScoped;

public:
	ConsoleColorScope( ConsoleColors newcolor );
	virtual ~ConsoleColorScope() throw();
	void EnterScope();
	void LeaveScope();
};

// --------------------------------------------------------------------------------------
//  ConsoleAttrScope
// --------------------------------------------------------------------------------------
// Applies both color and tab attributes in a single object constructor.
//
class ConsoleAttrScope
{
	DeclareNoncopyableObject( ConsoleAttrScope );

protected:
	ConsoleColors	m_old_color;
	int				m_tabsize;

public:
	ConsoleAttrScope( ConsoleColors newcolor, int indent=0 );
	virtual ~ConsoleAttrScope() throw();
};

extern const IConsoleWriter	Console;

extern void Console_SetActiveHandler( const IConsoleWriter& writer, FILE* flushfp=NULL );
extern const wxString& ConsoleBuffer_Get();
extern void ConsoleBuffer_Clear();
extern void ConsoleBuffer_FlushToFile( FILE *fp );

extern const IConsoleWriter		ConsoleWriter_Null;
extern const IConsoleWriter		ConsoleWriter_Stdout;
extern const IConsoleWriter		ConsoleWriter_Assert;
extern const IConsoleWriter		ConsoleWriter_Buffered;
extern const IConsoleWriter		ConsoleWriter_wxError;

extern const NullConsoleWriter	NullCon;

extern const IConsoleWriter		DevConWriter;
extern bool						DevConWriterEnabled;

#ifdef PCSX2_DEVBUILD
#	define DevCon DevConWriter
#else
#	define DevCon DevConWriterEnabled && DevConWriter
#endif

#ifdef PCSX2_DEBUG
extern const IConsoleWriter		DbgConWriter;
#	define DbgCon				DbgConWriter
#else
#	define DbgCon				0&&NullCon
#endif