Blame layout/base/nsLayoutDebugger.cpp

Packit f0b94e
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
Packit f0b94e
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
Packit f0b94e
/* This Source Code Form is subject to the terms of the Mozilla Public
Packit f0b94e
 * License, v. 2.0. If a copy of the MPL was not distributed with this
Packit f0b94e
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
Packit f0b94e
Packit f0b94e
/*
Packit f0b94e
 * implementation of interface that allows layout-debug extension access
Packit f0b94e
 * to some internals of layout
Packit f0b94e
 */
Packit f0b94e
Packit f0b94e
#include "nsILayoutDebugger.h"
Packit f0b94e
Packit f0b94e
#include "nsAttrValue.h"
Packit f0b94e
#include "nsFrame.h"
Packit f0b94e
#include "nsDisplayList.h"
Packit f0b94e
#include "FrameLayerBuilder.h"
Packit f0b94e
#include "nsPrintfCString.h"
Packit f0b94e
Packit f0b94e
#include <stdio.h>
Packit f0b94e
Packit f0b94e
using namespace mozilla;
Packit f0b94e
using namespace mozilla::layers;
Packit f0b94e
Packit f0b94e
#ifdef DEBUG
Packit f0b94e
class nsLayoutDebugger : public nsILayoutDebugger {
Packit f0b94e
 public:
Packit f0b94e
  nsLayoutDebugger();
Packit f0b94e
Packit f0b94e
  NS_DECL_ISUPPORTS
Packit f0b94e
Packit f0b94e
  NS_IMETHOD SetShowFrameBorders(bool aEnable) override;
Packit f0b94e
Packit f0b94e
  NS_IMETHOD GetShowFrameBorders(bool* aResult) override;
Packit f0b94e
Packit f0b94e
  NS_IMETHOD SetShowEventTargetFrameBorder(bool aEnable) override;
Packit f0b94e
Packit f0b94e
  NS_IMETHOD GetShowEventTargetFrameBorder(bool* aResult) override;
Packit f0b94e
Packit f0b94e
 protected:
Packit f0b94e
  virtual ~nsLayoutDebugger();
Packit f0b94e
};
Packit f0b94e
Packit f0b94e
nsresult NS_NewLayoutDebugger(nsILayoutDebugger** aResult) {
Packit f0b94e
  NS_PRECONDITION(aResult, "null OUT ptr");
Packit f0b94e
  if (!aResult) {
Packit f0b94e
    return NS_ERROR_NULL_POINTER;
Packit f0b94e
  }
Packit f0b94e
  nsLayoutDebugger* it = new nsLayoutDebugger();
Packit f0b94e
  return it->QueryInterface(NS_GET_IID(nsILayoutDebugger), (void**)aResult);
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
nsLayoutDebugger::nsLayoutDebugger() {}
Packit f0b94e
Packit f0b94e
nsLayoutDebugger::~nsLayoutDebugger() {}
Packit f0b94e
Packit f0b94e
NS_IMPL_ISUPPORTS(nsLayoutDebugger, nsILayoutDebugger)
Packit f0b94e
Packit f0b94e
NS_IMETHODIMP
Packit f0b94e
nsLayoutDebugger::SetShowFrameBorders(bool aEnable) {
Packit f0b94e
  nsFrame::ShowFrameBorders(aEnable);
Packit f0b94e
  return NS_OK;
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
NS_IMETHODIMP
Packit f0b94e
nsLayoutDebugger::GetShowFrameBorders(bool* aResult) {
Packit f0b94e
  *aResult = nsFrame::GetShowFrameBorders();
Packit f0b94e
  return NS_OK;
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
NS_IMETHODIMP
Packit f0b94e
nsLayoutDebugger::SetShowEventTargetFrameBorder(bool aEnable) {
Packit f0b94e
  nsFrame::ShowEventTargetFrameBorder(aEnable);
Packit f0b94e
  return NS_OK;
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
NS_IMETHODIMP
Packit f0b94e
nsLayoutDebugger::GetShowEventTargetFrameBorder(bool* aResult) {
Packit f0b94e
  *aResult = nsFrame::GetShowEventTargetFrameBorder();
Packit f0b94e
  return NS_OK;
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
#endif
Packit f0b94e
Packit f0b94e
static std::ostream& operator<<(std::ostream& os, const nsPrintfCString& rhs) {
Packit f0b94e
  os << rhs.get();
Packit f0b94e
  return os;
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
static void PrintDisplayListTo(nsDisplayListBuilder* aBuilder,
Packit f0b94e
                               const nsDisplayList& aList,
Packit f0b94e
                               std::stringstream& aStream, uint32_t aIndent,
Packit f0b94e
                               bool aDumpHtml);
Packit f0b94e
Packit f0b94e
static void PrintDisplayItemTo(nsDisplayListBuilder* aBuilder,
Packit f0b94e
                               nsDisplayItem* aItem, std::stringstream& aStream,
Packit f0b94e
                               uint32_t aIndent, bool aDumpSublist,
Packit f0b94e
                               bool aDumpHtml) {
Packit f0b94e
  std::stringstream ss;
Packit f0b94e
Packit f0b94e
  if (!aDumpHtml) {
Packit f0b94e
    for (uint32_t indent = 0; indent < aIndent; indent++) {
Packit f0b94e
      aStream << "  ";
Packit f0b94e
    }
Packit f0b94e
  }
Packit f0b94e
  nsAutoString contentData;
Packit f0b94e
  nsIFrame* f = aItem->Frame();
Packit f0b94e
#ifdef DEBUG_FRAME_DUMP
Packit f0b94e
  f->GetFrameName(contentData);
Packit f0b94e
#endif
Packit f0b94e
  nsIContent* content = f->GetContent();
Packit f0b94e
  if (content) {
Packit f0b94e
    nsString tmp;
Packit f0b94e
    if (content->GetID()) {
Packit f0b94e
      content->GetID()->ToString(tmp);
Packit f0b94e
      contentData.AppendLiteral(" id:");
Packit f0b94e
      contentData.Append(tmp);
Packit f0b94e
    }
Packit f0b94e
    const nsAttrValue* classes =
Packit f0b94e
        content->IsElement() ? content->AsElement()->GetClasses() : nullptr;
Packit f0b94e
    if (classes) {
Packit f0b94e
      classes->ToString(tmp);
Packit f0b94e
      contentData.AppendLiteral(" class:");
Packit f0b94e
      contentData.Append(tmp);
Packit f0b94e
    }
Packit f0b94e
  }
Packit f0b94e
  bool snap;
Packit f0b94e
  nsRect rect = aItem->GetBounds(aBuilder, &snap);
Packit f0b94e
  nsRect layerRect = rect - (*aItem->GetAnimatedGeometryRoot())
Packit f0b94e
                                ->GetOffsetToCrossDoc(aItem->ReferenceFrame());
Packit f0b94e
  nsRect vis = aItem->GetVisibleRect();
Packit f0b94e
  nsRect component = aItem->GetComponentAlphaBounds(aBuilder);
Packit f0b94e
  nsDisplayList* list = aItem->GetChildren();
Packit f0b94e
  const DisplayItemClip& clip = aItem->GetClip();
Packit f0b94e
  nsRegion opaque = aItem->GetOpaqueRegion(aBuilder, &snap);
Packit f0b94e
Packit f0b94e
#ifdef MOZ_DUMP_PAINTING
Packit f0b94e
  if (aDumpHtml && aItem->Painted()) {
Packit f0b94e
    nsCString string(aItem->Name());
Packit f0b94e
    string.Append('-');
Packit f0b94e
    string.AppendInt((uint64_t)aItem);
Packit f0b94e
    aStream << nsPrintfCString("",
Packit f0b94e
                               string.BeginReading());
Packit f0b94e
  }
Packit f0b94e
#endif
Packit f0b94e
Packit f0b94e
  aStream << nsPrintfCString(
Packit f0b94e
      "%s p=0x%p f=0x%p(%s) key=%d %sbounds(%d,%d,%d,%d) "
Packit f0b94e
      "layerBounds(%d,%d,%d,%d) visible(%d,%d,%d,%d) "
Packit f0b94e
      "componentAlpha(%d,%d,%d,%d) clip(%s) asr(%s) clipChain(%s)%s ref=0x%p "
Packit f0b94e
      "agr=0x%p",
Packit f0b94e
      aItem->Name(), aItem, (void*)f, NS_ConvertUTF16toUTF8(contentData).get(),
Packit f0b94e
      aItem->GetPerFrameKey(),
Packit f0b94e
      (aItem->ZIndex() ? nsPrintfCString("z=%d ", aItem->ZIndex()).get() : ""),
Packit f0b94e
      rect.x, rect.y, rect.width, rect.height, layerRect.x, layerRect.y,
Packit f0b94e
      layerRect.width, layerRect.height, vis.x, vis.y, vis.width, vis.height,
Packit f0b94e
      component.x, component.y, component.width, component.height,
Packit f0b94e
      clip.ToString().get(),
Packit f0b94e
      ActiveScrolledRoot::ToString(aItem->GetActiveScrolledRoot()).get(),
Packit f0b94e
      DisplayItemClipChain::ToString(aItem->GetClipChain()).get(),
Packit f0b94e
      aItem->IsUniform(aBuilder) ? " uniform" : "", aItem->ReferenceFrame(),
Packit f0b94e
      aItem->GetAnimatedGeometryRoot()->mFrame);
Packit f0b94e
Packit f0b94e
  for (auto iter = opaque.RectIter(); !iter.Done(); iter.Next()) {
Packit f0b94e
    const nsRect& r = iter.Get();
Packit f0b94e
    aStream << nsPrintfCString(" (opaque %d,%d,%d,%d)", r.x, r.y, r.width,
Packit f0b94e
                               r.height);
Packit f0b94e
  }
Packit f0b94e
Packit f0b94e
  const auto& willChange = aItem->Frame()->StyleDisplay()->mWillChange;
Packit f0b94e
  if (!willChange.IsEmpty()) {
Packit f0b94e
    aStream << " (will-change=";
Packit f0b94e
    for (size_t i = 0; i < willChange.Length(); i++) {
Packit f0b94e
      if (i > 0) {
Packit f0b94e
        aStream << ",";
Packit f0b94e
      }
Packit f0b94e
      nsDependentAtomString buffer(willChange[i]);
Packit f0b94e
      aStream << NS_LossyConvertUTF16toASCII(buffer).get();
Packit f0b94e
    }
Packit f0b94e
    aStream << ")";
Packit f0b94e
  }
Packit f0b94e
Packit f0b94e
  // Display item specific debug info
Packit f0b94e
  aItem->WriteDebugInfo(aStream);
Packit f0b94e
Packit f0b94e
#ifdef MOZ_DUMP_PAINTING
Packit f0b94e
  if (aDumpHtml && aItem->Painted()) {
Packit f0b94e
    aStream << "";
Packit f0b94e
  }
Packit f0b94e
#endif
Packit f0b94e
  DisplayItemData* data = mozilla::FrameLayerBuilder::GetOldDataFor(aItem);
Packit f0b94e
  if (data && data->GetLayer()) {
Packit f0b94e
    if (aDumpHtml) {
Packit f0b94e
      aStream << nsPrintfCString(" layer=%p",
Packit f0b94e
                                 data->GetLayer(), data->GetLayer());
Packit f0b94e
    } else {
Packit f0b94e
      aStream << nsPrintfCString(" layer=0x%p", data->GetLayer());
Packit f0b94e
    }
Packit f0b94e
  }
Packit f0b94e
#ifdef MOZ_DUMP_PAINTING
Packit f0b94e
  if (aItem->GetType() == DisplayItemType::TYPE_MASK) {
Packit f0b94e
    nsCString str;
Packit f0b94e
    (static_cast<nsDisplayMask*>(aItem))->PrintEffects(str);
Packit f0b94e
    aStream << str.get();
Packit f0b94e
  }
Packit f0b94e
Packit f0b94e
  if (aItem->GetType() == DisplayItemType::TYPE_FILTER) {
Packit f0b94e
    nsCString str;
Packit f0b94e
    (static_cast<nsDisplayFilter*>(aItem))->PrintEffects(str);
Packit f0b94e
    aStream << str.get();
Packit f0b94e
  }
Packit f0b94e
#endif
Packit f0b94e
  aStream << "\n";
Packit f0b94e
#ifdef MOZ_DUMP_PAINTING
Packit f0b94e
  if (aDumpHtml && aItem->Painted()) {
Packit f0b94e
    nsCString string(aItem->Name());
Packit f0b94e
    string.Append('-');
Packit f0b94e
    string.AppendInt((uint64_t)aItem);
Packit f0b94e
    aStream << nsPrintfCString("
\n", string.BeginReading());
Packit f0b94e
  }
Packit f0b94e
#endif
Packit f0b94e
Packit f0b94e
  if (aDumpSublist && list) {
Packit f0b94e
    PrintDisplayListTo(aBuilder, *list, aStream, aIndent + 1, aDumpHtml);
Packit f0b94e
  }
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
static void PrintDisplayListTo(nsDisplayListBuilder* aBuilder,
Packit f0b94e
                               const nsDisplayList& aList,
Packit f0b94e
                               std::stringstream& aStream, uint32_t aIndent,
Packit f0b94e
                               bool aDumpHtml) {
Packit f0b94e
  if (aDumpHtml) {
Packit f0b94e
    aStream << "
    ";
Packit f0b94e
  }
Packit f0b94e
Packit f0b94e
  for (nsDisplayItem* i = aList.GetBottom(); i != nullptr; i = i->GetAbove()) {
Packit f0b94e
    if (aDumpHtml) {
Packit f0b94e
      aStream << "
  • ";
  • Packit f0b94e
        }
    Packit f0b94e
        PrintDisplayItemTo(aBuilder, i, aStream, aIndent, true, aDumpHtml);
    Packit f0b94e
        if (aDumpHtml) {
    Packit f0b94e
          aStream << "";
    Packit f0b94e
        }
    Packit f0b94e
      }
    Packit f0b94e
    Packit f0b94e
      if (aDumpHtml) {
    Packit f0b94e
        aStream << "";
    Packit f0b94e
      }
    Packit f0b94e
    }
    Packit f0b94e
    Packit f0b94e
    void nsFrame::PrintDisplayList(nsDisplayListBuilder* aBuilder,
    Packit f0b94e
                                   const nsDisplayList& aList,
    Packit f0b94e
                                   std::stringstream& aStream, bool aDumpHtml) {
    Packit f0b94e
      PrintDisplayListTo(aBuilder, aList, aStream, 0, aDumpHtml);
    Packit f0b94e
    }
    Packit f0b94e
    Packit f0b94e
    /**
    Packit f0b94e
     * The two functions below are intended to be called from a debugger.
    Packit f0b94e
     */
    Packit f0b94e
    void PrintDisplayItemToStdout(nsDisplayListBuilder* aBuilder,
    Packit f0b94e
                                  nsDisplayItem* aItem) {
    Packit f0b94e
      std::stringstream stream;
    Packit f0b94e
      PrintDisplayItemTo(aBuilder, aItem, stream, 0, true, false);
    Packit f0b94e
      puts(stream.str().c_str());
    Packit f0b94e
    }
    Packit f0b94e
    Packit f0b94e
    void PrintDisplayListToStdout(nsDisplayListBuilder* aBuilder,
    Packit f0b94e
                                  const nsDisplayList& aList) {
    Packit f0b94e
      std::stringstream stream;
    Packit f0b94e
      PrintDisplayListTo(aBuilder, aList, stream, 0, false);
    Packit f0b94e
      puts(stream.str().c_str());
    Packit f0b94e
    }
    Packit f0b94e
    Packit f0b94e
    #ifdef MOZ_DUMP_PAINTING
    Packit f0b94e
    static void PrintDisplayListSetItem(nsDisplayListBuilder* aBuilder,
    Packit f0b94e
                                        const char* aItemName,
    Packit f0b94e
                                        const nsDisplayList& aList,
    Packit f0b94e
                                        std::stringstream& aStream,
    Packit f0b94e
                                        bool aDumpHtml) {
    Packit f0b94e
      if (aDumpHtml) {
    Packit f0b94e
        aStream << "
  • ";
  • Packit f0b94e
      }
    Packit f0b94e
      aStream << aItemName << "\n";
    Packit f0b94e
      PrintDisplayListTo(aBuilder, aList, aStream, 0, aDumpHtml);
    Packit f0b94e
      if (aDumpHtml) {
    Packit f0b94e
        aStream << "";
    Packit f0b94e
      }
    Packit f0b94e
    }
    Packit f0b94e
    Packit f0b94e
    void nsFrame::PrintDisplayListSet(nsDisplayListBuilder* aBuilder,
    Packit f0b94e
                                      const nsDisplayListSet& aSet,
    Packit f0b94e
                                      std::stringstream& aStream, bool aDumpHtml) {
    Packit f0b94e
      if (aDumpHtml) {
    Packit f0b94e
        aStream << "
      ";
    Packit f0b94e
      }
    Packit f0b94e
      PrintDisplayListSetItem(aBuilder, "[BorderBackground]",
    Packit f0b94e
                              *(aSet.BorderBackground()), aStream, aDumpHtml);
    Packit f0b94e
      PrintDisplayListSetItem(aBuilder, "[BlockBorderBackgrounds]",
    Packit f0b94e
                              *(aSet.BlockBorderBackgrounds()), aStream, aDumpHtml);
    Packit f0b94e
      PrintDisplayListSetItem(aBuilder, "[Floats]", *(aSet.Floats()), aStream,
    Packit f0b94e
                              aDumpHtml);
    Packit f0b94e
      PrintDisplayListSetItem(aBuilder, "[PositionedDescendants]",
    Packit f0b94e
                              *(aSet.PositionedDescendants()), aStream, aDumpHtml);
    Packit f0b94e
      PrintDisplayListSetItem(aBuilder, "[Outlines]", *(aSet.Outlines()), aStream,
    Packit f0b94e
                              aDumpHtml);
    Packit f0b94e
      PrintDisplayListSetItem(aBuilder, "[Content]", *(aSet.Content()), aStream,
    Packit f0b94e
                              aDumpHtml);
    Packit f0b94e
      if (aDumpHtml) {
    Packit f0b94e
        aStream << "";
    Packit f0b94e
      }
    Packit f0b94e
    }
    Packit f0b94e
    Packit f0b94e
    #endif