/* 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 . */ #pragma once #include "StringHelpers.h" enum ConsoleColors { Color_Current = -1, Color_Default = 0, Color_Black, 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, 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; bool WriteLn(ConsoleColors color, const wxString fmt, ...) const; bool WriteLn(const wxString fmt, ...) const; bool Error(const wxString fmt, ...) const; bool Warning(const wxString 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; } bool WriteLn(ConsoleColors color, const wxString fmt, ...) const { return false; } bool WriteLn(const wxString fmt, ...) const { return false; } bool Error(const wxString fmt, ...) const { return false; } bool Warning(const wxString 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 IConsoleWriter Console; #if defined(__unix__) extern void Console_SetStdout(FILE *fp); #endif extern void Console_SetActiveHandler(const IConsoleWriter &writer, FILE *flushfp = NULL); extern const IConsoleWriter ConsoleWriter_Null; extern const IConsoleWriter ConsoleWriter_Stdout; extern const IConsoleWriter ConsoleWriter_Assert; extern NullConsoleWriter NullCon; extern IConsoleWriter DevConWriter; extern bool DevConWriterEnabled; #ifdef PCSX2_DEVBUILD #define DevCon DevConWriter #else #define DevCon DevConWriterEnabled &&DevConWriter #endif #ifdef PCSX2_DEBUG extern IConsoleWriter DbgConWriter; #define DbgCon DbgConWriter #else #define DbgCon 0 && NullCon #endif