Add support for light dumps in SkTraceMemoryDump interface.

include/core/SkTraceMemoryDump.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 SkTraceMemoryDump_DEFINED
 #define SkTraceMemoryDump_DEFINED
 
 #include "SkTypes.h"
 
 class SkDiscardableMemory;
 
 /**
  * Interface for memory tracing.
  * This interface is meant to be passed as argument to the memory dump methods of Skia objects.
  * The implementation of this interface is provided by the embedder.
  */
 class SK_API SkTraceMemoryDump {
 public:
     /**
+     * Enum of bit fields to specify the requested details for the dump from the Skia objects.
+     */
+    enum RequestedDetails {
+        kMemoryTotals = 1 << 0,
+        kMallocDetails = 1 << 1,
+        kDiscardableDetails = 1 << 2,
+        kGpuMemoryDetails = 1 << 3
+    };
+
+    /**
      *  Appends a new memory dump (i.e. a row) to the trace memory infrastructure.
      *  If dumpName does not exist yet, a new one is created. Otherwise, a new column is appended to
      *  the previously created dump.
      *  Arguments:
      *    dumpName: an absolute, slash-separated, name for the item being dumped
      *        e.g., "skia/CacheX/EntryY".
      *    valueName: a string indicating the name of the column.
      *        e.g., "size", "active_size", "number_of_objects".
      *        This string is supposed to be long lived and is NOT copied.
      *    units: a string indicating the units for the value.
@@ skipping 15 matching lines @@
                                   const char* backingType,
                                   const char* backingObjectId) = 0;
 
     /**
      * Specialization for memory backed by discardable memory.
      */
     virtual void setDiscardableMemoryBacking(
         const char* dumpName,
         const SkDiscardableMemory& discardableMemoryObject) = 0;
 
+    /**
+     * Returns a bit mask of RequestedDetails enum. The embedder can request only the details
+       required in the dump. It is expected that the skia objects can add extra details if one mask
+       field is related to the other.
+     */
+    virtual int getRequestedDetails() const = 0;

[Primiano Tucci (use gerrit), 2015/09/11 12:16:16]

I'd probably make this uint and fixed size (uint32_t)?

+
 protected:
     virtual ~SkTraceMemoryDump() { }
 };
 
 #endif