Creating functions for uploading a mipmapped texture.

include/gpu/GrTextureProvider.h

 /*
  * Copyright 2015 Google Inc.
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 #ifndef GrTextureProvider_DEFINED
 #define GrTextureProvider_DEFINED
 
 #include "GrTexture.h"
 #include "SkImageFilter.h"
+#include "SkMipMapLevel.h"
+#include "SkTArray.h"
 
 class GrSingleOwner;
 
 class SK_API GrTextureProvider {
 public:
     ///////////////////////////////////////////////////////////////////////////
     // Textures
 
     /**
      * Creates a new texture in the resource cache and returns it. The caller owns a
      * ref on the returned texture which must be balanced by a call to unref.
      *
-     * @param desc      Description of the texture properties.
-     * @param budgeted  Does the texture count against the resource cache budget?
+     * @param desc     Description of the texture properties.
+     * @param budgeted Does the texture count against the resource cache budget?
+     * @param texels   An array of mipmap levels
+     */
+    GrTexture* createTexture(const GrSurfaceDesc& desc, bool budgeted,
+                             const SkTArray<SkMipMapLevel>& texels);

[reed1, 2016/01/22 16:29:13]

Why is this a TArray, instead of just [],count? In general we try to not require
our contains to be used for our public API.

[Chris Blume, 2016/01/25 08:18:00]

Done.

+
+    /**
+     * This function is a shim which creates a SkTArray<SkMipMapLevel> of size 1.
+     * It then calls createTexture with that SkTArray.
+     *
      * @param srcData   Pointer to the pixel values (optional).
      * @param rowBytes  The number of bytes between rows of the texture. Zero
      *                  implies tightly packed rows. For compressed pixel configs, this
      *                  field is ignored.
      */
     GrTexture* createTexture(const GrSurfaceDesc& desc, bool budgeted, const void* srcData,
                              size_t rowBytes);
 
     /** Shortcut for creating a texture with no initial data to upload. */
     GrTexture* createTexture(const GrSurfaceDesc& desc, bool budgeted) {
@@ skipping 117 matching lines @@
 
 private:
     GrResourceCache* fCache;
     GrGpu* fGpu;
 
     // In debug builds we guard against improper thread handling
     SkDEBUGCODE(mutable GrSingleOwner* fSingleOwner;)
 };
 
 #endif