add SkCanvas::drawAtlas

include/core/SkCanvas.h

 /*
  * Copyright 2006 The Android Open Source Project
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 #ifndef SkCanvas_DEFINED
 #define SkCanvas_DEFINED
 
@@ skipping 10 matching lines @@
 
 class SkBaseDevice;
 class SkCanvasClipVisitor;
 class SkDraw;
 class SkDrawable;
 class SkDrawFilter;
 class SkImage;
 class SkMetaData;
 class SkPicture;
 class SkRRect;
+struct SkRSXform;
 class SkSurface;
 class SkSurface_Base;
 class SkTextBlob;
 class GrContext;
 class GrRenderTarget;
 
 class SkCanvasState;
 
 /** \class SkCanvas
 
@@ skipping 976 matching lines @@
      @param texCoords specifies the texture coordinates that will be bilerp across the patch,
                     their order is the same as the colors.
      @param xmode specifies how are the colors and the textures combined if both of them are
                     present.
      @param paint Specifies the shader/texture if present.
      */
     void drawPatch(const SkPoint cubics[12], const SkColor colors[4],
                    const SkPoint texCoords[4], SkXfermode* xmode, const SkPaint& paint);
 
     /**
+     *  colors, cullRect and paint are all optional.
+     */
+    void drawAtlas(const SkImage* atlas, const SkRSXform[], const SkRect tex[], const SkColor[],

[bsalomon, 2015/06/15 15:44:15]

What does SkRSXform apply to? A standard rectangle?

[reed1, 2015/06/15 18:52:33]

added to dox:

xform maps [0, 0, tex.width, tex.height] -> quad

+                   int count, const SkRect* cullRect, const SkPaint* paint);
+
+    /**
      *  Draw the contents of this drawable into the canvas. If the canvas is async
      *  (e.g. it is recording into a picture) then the drawable will be referenced instead,
      *  to have its draw() method called when the picture is finalized.
      *
      *  If the intent is to force the contents of the drawable into this canvas immediately,
      *  then drawable->draw(canvas) may be called.
      */
     void drawDrawable(SkDrawable* drawable);
 
     /** Add comments. beginCommentGroup/endCommentGroup open/close a new group.
@@ skipping 466 matching lines @@
 
 class SkCanvasClipVisitor {
 public:
     virtual ~SkCanvasClipVisitor();
     virtual void clipRect(const SkRect&, SkRegion::Op, bool antialias) = 0;
     virtual void clipRRect(const SkRRect&, SkRegion::Op, bool antialias) = 0;
     virtual void clipPath(const SkPath&, SkRegion::Op, bool antialias) = 0;
 };
 
 #endif