gecko-dev/gfx/layers/LayersLogging.h

298 строки
11 KiB
C++

/* -*- 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/. */
#ifndef GFX_LAYERSLOGGING_H
#define GFX_LAYERSLOGGING_H
#include "FrameMetrics.h" // for FrameMetrics
#include "mozilla/gfx/Matrix.h" // for Matrix4x4
#include "mozilla/gfx/Point.h" // for IntSize, etc
#include "mozilla/gfx/TiledRegion.h" // for TiledRegion
#include "mozilla/gfx/Types.h" // for SamplingFilter, SurfaceFormat
#include "mozilla/layers/APZTypes.h" // for SLGuidAndRenderRoot
#include "mozilla/layers/CompositorTypes.h" // for TextureFlags
#include "mozilla/layers/WebRenderLayersLogging.h"
#include "mozilla/layers/ZoomConstraints.h"
#include "nsAString.h"
#include "nsPrintfCString.h" // for nsPrintfCString
#include "nsRegion.h" // for nsRegion, nsIntRegion
#include "nscore.h" // for nsACString, etc
struct nsRectAbsolute;
namespace mozilla {
namespace gfx {
template <class units, class F>
struct RectTyped;
} // namespace gfx
enum class ImageFormat;
namespace layers {
struct ZoomConstraints;
void AppendToString(std::stringstream& aStream, const void* p,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, ScrollableLayerGuid::ViewID n,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const gfx::Color& c,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const nsPoint& p,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const nsRect& r,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const nsRectAbsolute& r,
const char* pfx = "", const char* sfx = "");
template <class T>
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::PointTyped<T>& p, const char* pfx = "",
const char* sfx = "") {
aStream << pfx << p << sfx;
}
template <class T>
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::Point3DTyped<T>& p,
const char* pfx = "", const char* sfx = "") {
aStream << pfx << p << sfx;
}
template <class T>
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::IntPointTyped<T>& p,
const char* pfx = "", const char* sfx = "") {
aStream << pfx << p << sfx;
}
template <class T>
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::RectTyped<T>& r, const char* pfx = "",
const char* sfx = "") {
aStream << pfx;
aStream << nsPrintfCString("(x=%f, y=%f, w=%f, h=%f)", r.X(), r.Y(),
r.Width(), r.Height())
.get();
aStream << sfx;
}
template <class T>
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::IntRectTyped<T>& r,
const char* pfx = "", const char* sfx = "") {
aStream << pfx;
aStream << nsPrintfCString("(x=%d, y=%d, w=%d, h=%d)", r.X(), r.Y(),
r.Width(), r.Height())
.get();
aStream << sfx;
}
template <class T>
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::RectAbsoluteTyped<T>& r,
const char* pfx = "", const char* sfx = "") {
aStream << pfx;
aStream << nsPrintfCString("(l=%f, t=%f, r=%f, b=%f)", r.Left(), r.Top(),
r.Right(), r.Bottom())
.get();
aStream << sfx;
}
template <class T>
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::IntRectAbsoluteTyped<T>& r,
const char* pfx = "", const char* sfx = "") {
aStream << pfx;
aStream << nsPrintfCString("(l=%d, t=%d, r=%d, b=%d)", r.Left(), r.Top(),
r.Right(), r.Bottom())
.get();
aStream << sfx;
}
void AppendToString(std::stringstream& aStream, const wr::ColorF& c,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const wr::LayoutRect& r,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const wr::LayoutSize& s,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const nsSize& sz,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const wr::StickyOffsetBounds& s,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const nsRegion& r,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const nsIntRegion& r,
const char* pfx = "", const char* sfx = "");
template <typename units>
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::IntRegionTyped<units>& r,
const char* pfx = "", const char* sfx = "") {
aStream << pfx;
aStream << "< ";
for (auto iter = r.RectIter(); !iter.Done(); iter.Next()) {
AppendToString(aStream, iter.Get());
aStream << "; ";
}
aStream << ">";
aStream << sfx;
}
template <typename T>
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::TiledRegion<T>& r, const char* pfx = "",
const char* sfx = "") {
aStream << pfx;
AppendToString(aStream, r.GetRegion());
aStream << " (bounds=";
AppendToString(aStream, r.GetBounds());
aStream << ", covers=" << r.CoversBounds() << ")" << sfx;
}
void AppendToString(std::stringstream& aStream, const EventRegions& e,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, OverscrollBehavior aBehavior,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const ScrollMetadata& m,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const FrameMetrics& m,
const char* pfx = "", const char* sfx = "",
bool detailed = false);
void AppendToString(std::stringstream& aStream, const ScrollableLayerGuid& s,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const SLGuidAndRenderRoot& s,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, const ZoomConstraints& z,
const char* pfx = "", const char* sfx = "");
template <class T>
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::MarginTyped<T>& m, const char* pfx = "",
const char* sfx = "") {
aStream << pfx;
aStream << nsPrintfCString("(l=%f, t=%f, r=%f, b=%f)", m.left, m.top, m.right,
m.bottom)
.get();
aStream << sfx;
}
template <class T>
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::SizeTyped<T>& sz, const char* pfx = "",
const char* sfx = "") {
aStream << pfx;
aStream << nsPrintfCString("(w=%f, h=%f)", sz.width, sz.height).get();
aStream << sfx;
}
template <class T>
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::IntSizeTyped<T>& sz,
const char* pfx = "", const char* sfx = "") {
aStream << pfx;
aStream << nsPrintfCString("(w=%d, h=%d)", sz.width, sz.height).get();
aStream << sfx;
}
template <class src, class dst>
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::ScaleFactors2D<src, dst>& scale,
const char* pfx = "", const char* sfx = "") {
aStream << pfx;
std::streamsize oldPrecision = aStream.precision(3);
if (scale.AreScalesSame()) {
aStream << scale.xScale;
} else {
aStream << '(' << scale.xScale << ',' << scale.yScale << ')';
}
aStream.precision(oldPrecision);
aStream << sfx;
}
void AppendToString(std::stringstream& aStream, const mozilla::gfx::Matrix& m,
const char* pfx = "", const char* sfx = "");
template <class SourceUnits, class TargetUnits>
void AppendToString(
std::stringstream& aStream,
const mozilla::gfx::Matrix4x4Typed<SourceUnits, TargetUnits>& m,
const char* pfx = "", const char* sfx = "") {
if (m.Is2D()) {
mozilla::gfx::Matrix matrix = m.As2D();
AppendToString(aStream, matrix, pfx, sfx);
return;
}
aStream << pfx;
aStream << nsPrintfCString(
"[ %g %g %g %g; %g %g %g %g; %g %g %g %g; %g %g %g %g; ]",
m._11, m._12, m._13, m._14, m._21, m._22, m._23, m._24, m._31,
m._32, m._33, m._34, m._41, m._42, m._43, m._44)
.get();
aStream << sfx;
}
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::Matrix5x4& m, const char* pfx = "",
const char* sfx = "");
void AppendToString(std::stringstream& aStream,
const mozilla::gfx::SamplingFilter samplingFilter,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream,
mozilla::layers::TextureFlags flags, const char* pfx = "",
const char* sfx = "");
void AppendToString(std::stringstream& aStream,
mozilla::gfx::SurfaceFormat format, const char* pfx = "",
const char* sfx = "");
void AppendToString(std::stringstream& aStream, gfx::SurfaceType format,
const char* pfx = "", const char* sfx = "");
void AppendToString(std::stringstream& aStream, ImageFormat format,
const char* pfx = "", const char* sfx = "");
// Sometimes, you just want a string from a single value.
template <typename T>
std::string Stringify(const T& obj) {
std::stringstream ss;
AppendToString(ss, obj);
return ss.str();
}
} // namespace layers
} // namespace mozilla
// versions of printf_stderr and fprintf_stderr that deal with line
// truncation on android by printing individual lines out of the
// stringstream as separate calls to logcat.
void print_stderr(std::stringstream& aStr);
void fprint_stderr(FILE* aFile, std::stringstream& aStr);
#endif /* GFX_LAYERSLOGGING_H */