Provide some debug-mode time hooks to visually debug painting and layout.

sky/sdk/lib/rendering/box.dart

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 import 'dart:math' as math;
 import 'dart:sky' as sky;
 
 import 'package:sky/base/debug.dart';
 import 'package:sky/painting/box_painter.dart';
 import 'package:sky/rendering/object.dart';
@@ skipping 283 matching lines @@
   static bool _debugDoingBaseline = false;
   static bool _debugSetDoingBaseline(bool value) {
     _debugDoingBaseline = value;
     return true;
   }
   // getDistanceToBaseline() returns the distance from the
   // y-coordinate of the position of the box to the y-coordinate of
   // the first given baseline in the box's contents. This is used by
   // certain layout models to align adjacent boxes on a common
   // baseline, regardless of padding, font size differences, etc. If
-  // there is no baseline, then it returns the distance from the
-  // y-coordinate of the position of the box to the y-coordinate of
-  // the bottom of the box, i.e., the height of the box. Only call
-  // this after layout has been performed. You are only allowed to
-  // call this from the parent of this node during that parent's
-  // performLayout() or paint().
-  double getDistanceToBaseline(TextBaseline baseline) {
+  // there is no baseline, and the 'onlyReal' argument was not set to
+  // true, then it returns the distance from the y-coordinate of the
+  // position of the box to the y-coordinate of the bottom of the box,
+  // i.e., the height of the box. Only call this after layout has been
+  // performed. You are only allowed to call this from the parent of
+  // this node during that parent's performLayout() or paint().
+  double getDistanceToBaseline(TextBaseline baseline, { bool onlyReal: false }) {
     assert(!needsLayout);
     assert(!_debugDoingBaseline);
     final parent = this.parent; // TODO(ianh): Remove this once the analyzer is cleverer
     assert(parent is RenderObject);
     assert(() {
       if (RenderObject.debugDoingLayout)
-        return (parent == RenderObject.debugActiveLayout) && parent.debugDoingThisLayout;
+        return (RenderObject.debugActiveLayout == parent) && parent.debugDoingThisLayout;
       if (RenderObject.debugDoingPaint)
-        return (parent == RenderObject.debugActivePaint) && parent.debugDoingThisPaint;
+        return ((RenderObject.debugActivePaint == parent) && parent.debugDoingThisPaint) ||
+               ((RenderObject.debugActivePaint == this) && debugDoingThisPaint);
       return false;
     });
     assert(_debugSetDoingBaseline(true));
     double result = getDistanceToActualBaseline(baseline);
     assert(_debugSetDoingBaseline(false));
     assert(parent == this.parent); // TODO(ianh): Remove this once the analyzer is cleverer
-    if (result == null)
+    if (result == null && !onlyReal)
       return size.height;
     return result;
   }
   // getDistanceToActualBaseline() must only be called from
   // getDistanceToBaseline() and computeDistanceToActualBaseline(). Do
   // not call it directly from outside those two methods. It just
   // calls computeDistanceToActualBaseline() and caches the result.
   double getDistanceToActualBaseline(TextBaseline baseline) {
     assert(_debugDoingBaseline);
     _ancestorUsesBaseline = true;
@@ skipping 90 matching lines @@
     assert((sizedByParent && debugDoingThisResize) ||
            (!sizedByParent && debugDoingThisLayout));
     if (value is _DebugSize) {
       assert(value._canBeUsedByParent);
       assert(value._owner.parent == this);
     }
     _size = inDebugBuild ? new _DebugSize(value, this, debugCanParentUseSize) : value;
   }
 
   Rect get paintBounds => Point.origin & size;
+  void debugPaint(PaintingCanvas canvas, Offset offset) {
+    if (debugPaintSizeEnabled)
+      debugPaintSize(canvas, offset);
+    if (debugPaintBaselinesEnabled)
+      debugPaintBaselines(canvas, offset);
+  }
+  void debugPaintSize(PaintingCanvas canvas, Offset offset) {
+    Paint paint = new Paint();
+    paint.setStyle(sky.PaintingStyle.stroke);
+    paint.strokeWidth = 1.0;
+    paint.color = debugPaintSizeColor;
+    canvas.drawRect(offset & size, paint);
+  }
+  void debugPaintBaselines(PaintingCanvas canvas, Offset offset) {
+    Paint paint = new Paint();
+    paint.setStyle(sky.PaintingStyle.stroke);
+    paint.strokeWidth = 0.25;
+    Path path;
+    // ideographic baseline
+    double baselineI = getDistanceToBaseline(TextBaseline.ideographic, onlyReal: true);
+    if (baselineI != null) {
+      paint.color = debugPaintIdeographicBaselineColor;
+      path = new Path();
+      path.moveTo(offset.dx, offset.dy + baselineI);
+      path.lineTo(offset.dx + size.width, offset.dy + baselineI);
+      canvas.drawPath(path, paint);
+    }
+    // alphabetic baseline
+    double baselineA = getDistanceToBaseline(TextBaseline.alphabetic, onlyReal: true);
+    if (baselineA != null) {
+      paint.color = debugPaintAlphabeticBaselineColor;
+      path = new Path();
+      path.moveTo(offset.dx, offset.dy + baselineA);
+      path.lineTo(offset.dx + size.width, offset.dy + baselineA);
+      canvas.drawPath(path, paint);
+    }
+  }
 
   String debugDescribeSettings(String prefix) => '${super.debugDescribeSettings(prefix)}${prefix}size: ${size}\n';
 }
 
 class RenderProxyBox extends RenderBox with RenderObjectWithChildMixin<RenderBox> {
 
   // ProxyBox assumes the child will be at 0,0 and will have the same size
 
   RenderProxyBox([RenderBox child = null]) {
     this.child = child;
@@ skipping 1137 matching lines @@
 
   void defaultPaint(PaintingCanvas canvas, Offset offset) {
     RenderBox child = firstChild;
     while (child != null) {
       assert(child.parentData is ParentDataType);
       canvas.paintChild(child, child.parentData.position + offset);
       child = child.parentData.nextSibling;
     }
   }
 }