/* -*- Mode: C++; tab-width: 20; indent-tabs-mode: nil; c-basic-offset: 2 -*- * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ #ifndef MOZILLA_GFX_LOGGING_H_ #define MOZILLA_GFX_LOGGING_H_ #include #include #include #ifdef MOZ_LOGGING #include #endif #if defined(MOZ_WIDGET_GONK) || defined(MOZ_WIDGET_ANDROID) #include "nsDebug.h" #endif #include "Point.h" #include "BaseRect.h" #include "Matrix.h" #include "mozilla/TypedEnum.h" #ifdef WIN32 // This file gets included from nsGlobalWindow.cpp, which doesn't like // having windows.h included in it. Since OutputDebugStringA is the only // thing we need from windows.h, we just declare it here directly. // Note: the function's documented signature is // WINBASEAPI void WINAPI OutputDebugStringA(LPCSTR lpOutputString) // but if we don't include windows.h, the macros WINBASEAPI, WINAPI, and // LPCSTR are not defined, so we need to replace them with their expansions. extern "C" __declspec(dllimport) void __stdcall OutputDebugStringA(const char* lpOutputString); #endif #if defined(PR_LOGGING) extern GFX2D_API PRLogModuleInfo *GetGFX2DLog(); #endif namespace mozilla { namespace gfx { // Attempting to be consistent with prlog values, but that isn't critical // (and note that 5 has a special meaning - see the description // with sGfxLogLevel) const int LOG_CRITICAL = 1; const int LOG_WARNING = 2; const int LOG_DEBUG = 3; const int LOG_DEBUG_PRLOG = 4; const int LOG_EVERYTHING = 5; // This needs to be the highest value #if defined(DEBUG) const int LOG_DEFAULT = LOG_EVERYTHING; #else const int LOG_DEFAULT = LOG_CRITICAL; #endif #if defined(PR_LOGGING) inline PRLogModuleLevel PRLogLevelForLevel(int aLevel) { switch (aLevel) { case LOG_CRITICAL: return PR_LOG_ERROR; case LOG_WARNING: return PR_LOG_WARNING; case LOG_DEBUG: return PR_LOG_DEBUG; case LOG_DEBUG_PRLOG: return PR_LOG_DEBUG; case LOG_EVERYTHING: return PR_LOG_ALWAYS; } return PR_LOG_DEBUG; } #endif class PreferenceAccess { public: virtual ~PreferenceAccess(); // This should connect the variable aVar to be updated whenever a preference // aName is modified. aDefault would be used if the preference is undefined, // so that we always get the valid value for aVar. virtual void LivePref(const char* aName, int32_t* aVar, int32_t aDefault); public: static void SetAccess(PreferenceAccess* aAccess); public: // For each preference that needs to be accessed in Moz2D, add a variable // to hold it, as well as the call to LivePref in the RegisterAll() method // below. // Used to choose the level of logging we get. The higher the number, // the more logging we get. Value of zero will give you no logging, // 1 just errors, 2 adds warnings and 3 adds logging/debug. 4 is used to // selectively enable logging on the configurations that // support prlog (on other systems, 3 and 4 are the same.) For prlog, // in addition to setting the value to 4, you will need to set an // environment variable NSPR_LOG_MODULES to gfx:4. See prlog.h for details. static int32_t sGfxLogLevel; private: static void RegisterAll() { // The default values (last parameter) should match the initialization // values in Factory.cpp, otherwise the standalone Moz2D will get different // defaults. sAccess->LivePref("gfx.logging.level", &sGfxLogLevel, LOG_DEFAULT); } static PreferenceAccess* sAccess; }; struct BasicLogger { // For efficiency, this method exists and copies the logic of the // OutputMessage below. If making any changes here, also make it // in the appropriate places in that method. static bool ShouldOutputMessage(int aLevel) { if (PreferenceAccess::sGfxLogLevel >= aLevel) { #if defined(WIN32) && !defined(PR_LOGGING) return true; #elif defined(MOZ_WIDGET_GONK) || defined(MOZ_WIDGET_ANDROID) return true; #elif defined(PR_LOGGING) if (PR_LOG_TEST(GetGFX2DLog(), PRLogLevelForLevel(aLevel))) { return true; } else if ((PreferenceAccess::sGfxLogLevel >= LOG_DEBUG_PRLOG) || (aLevel < LOG_DEBUG)) { return true; } #else return true; #endif } return false; } static void OutputMessage(const std::string &aString, int aLevel, bool aNoNewline) { // This behavior (the higher the preference, the more we log) // is consistent with what prlog does in general. Note that if prlog // is in the build, but disabled, we will printf if the preferences // requires us to log something (see sGfxLogLevel for the special // treatment of LOG_DEBUG and LOG_DEBUG_PRLOG) // // If making any logic changes to this method, you should probably // make the corresponding change in the ShouldOutputMessage method // above. if (PreferenceAccess::sGfxLogLevel >= aLevel) { #if defined(WIN32) && !defined(PR_LOGGING) ::OutputDebugStringA((aNoNewline ? aString : aString+"\n").c_str()); #elif defined(MOZ_WIDGET_GONK) || defined(MOZ_WIDGET_ANDROID) printf_stderr("%s%s", aString.c_str(), aNoNewline ? "" : "\n"); #elif defined(PR_LOGGING) if (PR_LOG_TEST(GetGFX2DLog(), PRLogLevelForLevel(aLevel))) { PR_LogPrint("%s%s", aString.c_str(), aNoNewline ? "" : "\n"); } else if ((PreferenceAccess::sGfxLogLevel >= LOG_DEBUG_PRLOG) || (aLevel < LOG_DEBUG)) { printf("%s%s", aString.c_str(), aNoNewline ? "" : "\n"); } #else printf("%s%s", aString.c_str(), aNoNewline ? "" : "\n"); #endif } } }; struct CriticalLogger { static void OutputMessage(const std::string &aString, int aLevel, bool aNoNewline); }; // Implement this interface and init the Factory with an instance to // forward critical logs. class LogForwarder { public: virtual ~LogForwarder() {} virtual void Log(const std::string &aString) = 0; }; class NoLog { public: NoLog() {} ~NoLog() {} template NoLog &operator <<(const T &aLogText) { return *this; } }; MOZ_BEGIN_ENUM_CLASS(LogOptions, int) NoNewline = 0x01, AutoPrefix = 0x02 MOZ_END_ENUM_CLASS(LogOptions) template struct Hexa { explicit Hexa(T aVal) : mVal(aVal) {} T mVal; }; template Hexa hexa(T val) { return Hexa(val); } template class Log { public: explicit Log(int aOptions = (int)LogOptions::AutoPrefix) : mOptions(aOptions) , mLogIt(BasicLogger::ShouldOutputMessage(L)) { if (mLogIt && AutoPrefix()) { mMessage << "[GFX" << L << "]: "; } } ~Log() { Flush(); } void Flush() { if (MOZ_LIKELY(!LogIt())) return; std::string str = mMessage.str(); if (!str.empty()) { WriteLog(str); } if (AutoPrefix()) { mMessage.str("[GFX"); mMessage << L << "]: "; } else { mMessage.str(""); } mMessage.clear(); } Log &operator <<(char aChar) { if (MOZ_UNLIKELY(LogIt())) { mMessage << aChar; } return *this; } Log &operator <<(const std::string &aLogText) { if (MOZ_UNLIKELY(LogIt())) { mMessage << aLogText; } return *this; } Log &operator <<(const char aStr[]) { if (MOZ_UNLIKELY(LogIt())) { mMessage << static_cast(aStr); } return *this; } Log &operator <<(bool aBool) { if (MOZ_UNLIKELY(LogIt())) { mMessage << (aBool ? "true" : "false"); } return *this; } Log &operator <<(int aInt) { if (MOZ_UNLIKELY(LogIt())) { mMessage << aInt; } return *this; } Log &operator <<(unsigned int aInt) { if (MOZ_UNLIKELY(LogIt())) { mMessage << aInt; } return *this; } Log &operator <<(long aLong) { if (MOZ_UNLIKELY(LogIt())) { mMessage << aLong; } return *this; } Log &operator <<(unsigned long aLong) { if (MOZ_UNLIKELY(LogIt())) { mMessage << aLong; } return *this; } Log &operator <<(long long aLong) { if (MOZ_UNLIKELY(LogIt())) { mMessage << aLong; } return *this; } Log &operator <<(unsigned long long aLong) { if (MOZ_UNLIKELY(LogIt())) { mMessage << aLong; } return *this; } Log &operator <<(Float aFloat) { if (MOZ_UNLIKELY(LogIt())) { mMessage << aFloat; } return *this; } Log &operator <<(double aDouble) { if (MOZ_UNLIKELY(LogIt())) { mMessage << aDouble; } return *this; } template Log &operator <<(const BasePoint& aPoint) { if (MOZ_UNLIKELY(LogIt())) { mMessage << "Point" << aPoint; } return *this; } template Log &operator <<(const BaseSize& aSize) { if (MOZ_UNLIKELY(LogIt())) { mMessage << "Size(" << aSize.width << "," << aSize.height << ")"; } return *this; } template Log &operator <<(const BaseRect& aRect) { if (MOZ_UNLIKELY(LogIt())) { mMessage << "Rect" << aRect; } return *this; } Log &operator<<(const Matrix& aMatrix) { if (MOZ_UNLIKELY(LogIt())) { mMessage << "Matrix(" << aMatrix._11 << " " << aMatrix._12 << " ; " << aMatrix._21 << " " << aMatrix._22 << " ; " << aMatrix._31 << " " << aMatrix._32 << ")"; } return *this; } template Log &operator<<(Hexa aHex) { if (MOZ_UNLIKELY(LogIt())) { mMessage << "0x" << std::hex << aHex.mVal << std::dec; } return *this; } Log& operator<<(SurfaceFormat aFormat) { if (MOZ_UNLIKELY(LogIt())) { switch(aFormat) { case SurfaceFormat::B8G8R8A8: mMessage << "SurfaceFormat::B8G8R8A8"; break; case SurfaceFormat::B8G8R8X8: mMessage << "SurfaceFormat::B8G8R8X8"; break; case SurfaceFormat::R8G8B8A8: mMessage << "SurfaceFormat::R8G8B8A8"; break; case SurfaceFormat::R8G8B8X8: mMessage << "SurfaceFormat::R8G8B8X8"; break; case SurfaceFormat::R5G6B5: mMessage << "SurfaceFormat::R5G6B5"; break; case SurfaceFormat::A8: mMessage << "SurfaceFormat::A8"; break; case SurfaceFormat::YUV: mMessage << "SurfaceFormat::YUV"; break; case SurfaceFormat::UNKNOWN: mMessage << "SurfaceFormat::UNKNOWN"; break; default: mMessage << "Invalid SurfaceFormat (" << (int)aFormat << ")"; break; } } return *this; } Log& operator<<(SurfaceType aType) { if (MOZ_UNLIKELY(LogIt())) { switch(aType) { case SurfaceType::DATA: mMessage << "SurfaceType::DATA"; break; case SurfaceType::D2D1_BITMAP: mMessage << "SurfaceType::D2D1_BITMAP"; break; case SurfaceType::D2D1_DRAWTARGET: mMessage << "SurfaceType::D2D1_DRAWTARGET"; break; case SurfaceType::CAIRO: mMessage << "SurfaceType::CAIRO"; break; case SurfaceType::CAIRO_IMAGE: mMessage << "SurfaceType::CAIRO_IMAGE"; break; case SurfaceType::COREGRAPHICS_IMAGE: mMessage << "SurfaceType::COREGRAPHICS_IMAGE"; break; case SurfaceType::COREGRAPHICS_CGCONTEXT: mMessage << "SurfaceType::COREGRAPHICS_CGCONTEXT"; break; case SurfaceType::SKIA: mMessage << "SurfaceType::SKIA"; break; case SurfaceType::DUAL_DT: mMessage << "SurfaceType::DUAL_DT"; break; case SurfaceType::D2D1_1_IMAGE: mMessage << "SurfaceType::D2D1_1_IMAGE"; break; case SurfaceType::RECORDING: mMessage << "SurfaceType::RECORDING"; break; case SurfaceType::TILED: mMessage << "SurfaceType::TILED"; break; default: mMessage << "Invalid SurfaceType (" << (int)aType << ")"; break; } } return *this; } inline bool LogIt() const { return mLogIt; } inline bool NoNewline() const { return mOptions & int(LogOptions::NoNewline); } inline bool AutoPrefix() const { return mOptions & int(LogOptions::AutoPrefix); } private: void WriteLog(const std::string &aString) { if (MOZ_UNLIKELY(LogIt())) { Logger::OutputMessage(aString, L, NoNewline()); } } std::stringstream mMessage; int mOptions; bool mLogIt; }; typedef Log DebugLog; typedef Log WarningLog; typedef Log CriticalLog; #ifdef GFX_LOG_DEBUG #define gfxDebug mozilla::gfx::DebugLog #else #define gfxDebug if (1) ; else mozilla::gfx::NoLog #endif #ifdef GFX_LOG_WARNING #define gfxWarning mozilla::gfx::WarningLog #else #define gfxWarning if (1) ; else mozilla::gfx::NoLog #endif // This log goes into crash reports, use with care. #define gfxCriticalError mozilla::gfx::CriticalLog // See nsDebug.h and the NS_WARN_IF macro #ifdef __cplusplus #ifdef DEBUG inline bool MOZ2D_warn_if_impl(bool aCondition, const char* aExpr, const char* aFile, int32_t aLine) { if (MOZ_UNLIKELY(aCondition)) { gfxWarning() << aExpr << " at " << aFile << ":" << aLine; } return aCondition; } #define MOZ2D_WARN_IF(condition) \ MOZ2D_warn_if_impl(condition, #condition, __FILE__, __LINE__) #else #define MOZ2D_WARN_IF(condition) (bool)(condition) #endif #endif const int INDENT_PER_LEVEL = 2; class TreeLog { public: explicit TreeLog(const std::string& aPrefix = "") : mLog(int(LogOptions::NoNewline)), mPrefix(aPrefix), mDepth(0), mStartOfLine(true), mConditionedOnPref(false), mPrefFunction(nullptr) {} template TreeLog& operator<<(const T& aObject) { if (mConditionedOnPref && !mPrefFunction()) { return *this; } if (mStartOfLine) { mLog << '[' << mPrefix << "] " << std::string(mDepth * INDENT_PER_LEVEL, ' '); mStartOfLine = false; } mLog << aObject; if (EndsInNewline(aObject)) { // Don't indent right here as the user may change the indent // between now and the first output to the next line. mLog.Flush(); mStartOfLine = true; } return *this; } void IncreaseIndent() { ++mDepth; } void DecreaseIndent() { --mDepth; } void ConditionOnPrefFunction(bool(*aPrefFunction)()) { mConditionedOnPref = true; mPrefFunction = aPrefFunction; } private: Log mLog; std::string mPrefix; uint32_t mDepth; bool mStartOfLine; bool mConditionedOnPref; bool (*mPrefFunction)(); template static bool EndsInNewline(const T& aObject) { return false; } static bool EndsInNewline(const std::string& aString) { return !aString.empty() && aString[aString.length() - 1] == '\n'; } static bool EndsInNewline(char aChar) { return aChar == '\n'; } static bool EndsInNewline(const char* aString) { return EndsInNewline(std::string(aString)); } }; class TreeAutoIndent { public: explicit TreeAutoIndent(TreeLog& aTreeLog) : mTreeLog(aTreeLog) { mTreeLog.IncreaseIndent(); } ~TreeAutoIndent() { mTreeLog.DecreaseIndent(); } private: TreeLog& mTreeLog; }; } } #endif /* MOZILLA_GFX_LOGGING_H_ */