First pass at Comment API

gm/rects.cpp

 /*
  * Copyright 2013 Google Inc.
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 #include "gm.h"
 #include "SkTArray.h"
 #include "SkMatrix.h"
@@ skipping 189 matching lines @@
         }
     }
 
     // position the current test on the canvas
     static void position(SkCanvas* canvas, int testCount) {
         canvas->translate(SK_Scalar1 * 100 * (testCount % 10) + SK_Scalar1 / 4,
                           SK_Scalar1 * 100 * (testCount / 10) + 3 * SK_Scalar1 / 4);
     }
 
     virtual void onDraw(SkCanvas* canvas) SK_OVERRIDE {
+        SkAutoCommentBlock acb(canvas, "onDraw");
+
         canvas->translate(20 * SK_Scalar1, 20 * SK_Scalar1);
 
         int testCount = 0;
 
+        canvas->addComment("Test", "Various Paints");
+
         for (int i = 0; i < fPaints.count(); ++i) {
             for (int j = 0; j < fRects.count(); ++j, ++testCount) {
                 canvas->save();
                 this->position(canvas, testCount);
                 canvas->drawRect(fRects[j], fPaints[i]);
                 canvas->restore();
             }
         }
 
+        canvas->addComment("Test", "Matrices");
+
         SkPaint paint;
         paint.setColor(SK_ColorWHITE);
         paint.setAntiAlias(true);
 
         for (int i = 0; i < fMatrices.count(); ++i) {
             for (int j = 0; j < fRects.count(); ++j, ++testCount) {
                 canvas->save();
                 this->position(canvas, testCount);
                 canvas->concat(fMatrices[i]);
                 canvas->drawRect(fRects[j], paint);
                 canvas->restore();
             }
         }
     }
 
 private:
     SkTArray<SkPaint>  fPaints;
     SkTArray<SkMatrix> fMatrices;
     SkTArray<SkRect>   fRects;
 
     typedef GM INHERITED;
 };
 
 //////////////////////////////////////////////////////////////////////////////
 
 static GM* MyFactory(void*) { return new RectsGM; }
 static GMRegistry reg(MyFactory);
 
 }