1 files changed, 73 insertions, 0 deletions
diff --git a/gfx/layers/RenderTrace.h b/gfx/layers/RenderTrace.h
new file mode 100644
index 0000000000..404ba1ea1d
--- /dev/null
+++ b/gfx/layers/RenderTrace.h
@@ -0,0 +1,73 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set ts=8 sts=2 et sw=2 tw=80: */
+/* 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/. */
+
+// This is a general tool that will let you visualize platform operation.
+// Currently used for the layer system, the general syntax allows this
+// tools to be adapted to trace other operations.
+//
+// For the front end see: https://github.com/staktrace/rendertrace
+
+// Uncomment this line to enable RENDERTRACE
+//#define MOZ_RENDERTRACE
+
+#ifndef GFX_RENDERTRACE_H
+#define GFX_RENDERTRACE_H
+
+#include "nsRect.h"
+#include "mozilla/gfx/Matrix.h"
+
+namespace mozilla {
+namespace layers {
+
+class Layer;
+
+void RenderTraceLayers(Layer* aLayer, const char* aColor,
+                       const gfx::Matrix4x4 aRootTransform = gfx::Matrix4x4(),
+                       bool aReset = true);
+
+void RenderTraceInvalidateStart(Layer* aLayer, const char* aColor,
+                                const gfx::IntRect aRect);
+void RenderTraceInvalidateEnd(Layer* aLayer, const char* aColor);
+
+void renderTraceEventStart(const char* aComment, const char* aColor);
+void renderTraceEventEnd(const char* aComment, const char* aColor);
+void renderTraceEventEnd(const char* aColor);
+
+struct RenderTraceScope {
+ public:
+  RenderTraceScope(const char* aComment, const char* aColor)
+      : mComment(aComment), mColor(aColor) {
+    renderTraceEventStart(mComment, mColor);
+  }
+  ~RenderTraceScope() { renderTraceEventEnd(mComment, mColor); }
+
+ private:
+  const char* mComment;
+  const char* mColor;
+};
+
+#ifndef MOZ_RENDERTRACE
+inline void RenderTraceLayers(Layer* aLayer, const char* aColor,
+                              const gfx::Matrix4x4 aRootTransform,
+                              bool aReset) {}
+
+inline void RenderTraceInvalidateStart(Layer* aLayer, const char* aColor,
+                                       const gfx::IntRect aRect) {}
+
+inline void RenderTraceInvalidateEnd(Layer* aLayer, const char* aColor) {}
+
+inline void renderTraceEventStart(const char* aComment, const char* aColor) {}
+
+inline void renderTraceEventEnd(const char* aComment, const char* aColor) {}
+
+inline void renderTraceEventEnd(const char* aColor) {}
+
+#endif  // MOZ_RENDERTRACE
+
+}  // namespace layers
+}  // namespace mozilla
+
+#endif  // GFX_RENDERTRACE_H