add --readJsonSummaryPath to render_pictures

src/utils/SkDataUtils.h

Index: src/utils/SkDataUtils.h
diff --git a/src/utils/SkDataUtils.h b/src/utils/SkDataUtils.h
new file mode 100644
index 0000000000000000000000000000000000000000..fc237f7b1aaf1bd877eafc844fe57bf6888c24d9
--- /dev/null
+++ b/src/utils/SkDataUtils.h
@@ -0,0 +1,63 @@
+/*
+ * Copyright 2014 Google Inc.
+ *
+ * Use of this source code is governed by a BSD-style license that can be
+ * found in the LICENSE file.
+ */
+
+#ifndef SkDataUtils_DEFINED
+#define SkDataUtils_DEFINED
+
+#include "SkData.h"
+#include "SkStream.h"
+
+/**
+ * Static class that performs various operations on SkData objects.
+ *
+ * EPOGER: Before committing, add unittests for these methods.

[epoger, 2014/05/07 03:15:16]

The "EPOGER" notes within the code are things I intend to fix before committing,
but I wanted to get your feedback on the CL as a whole first...

[borenet, 2014/05/07 18:36:52]

SGTM

+ *
+ * TODO(epoger): Move these methods into SkStream.[cpp|h], as attempted in
+ * https://codereview.appspot.com/7300071 ?
+ */
+class SkDataUtils {
+public:
+    /**
+     * Read as many bytes as possible (up to maxBytes) from the stream into
+     * an SkData object.
+     *
+     * If the returned SkData contains fewer than maxBytes, then EOF has been
+     * reached and no more data would be available from subsequent calls.
+     * (If EOF has already been reached, then this call will return an empty
+     * SkData object immediately.)
+     *
+     * If there are fewer than maxBytes bytes available to read from the
+     * stream, but the stream has not been closed yet, this call will block
+     * until there are enough bytes to read or the stream has been closed.
+     *
+     * It is up to the caller to call unref() on the returned SkData object
+     * once the data is no longer needed, so that the underlying buffer will
+     * be freed.  For example:
+     *
+     * {
+     *   size_t maxBytes = 256;
+     *   SkAutoDataUnref dataRef(readIntoSkData(stream, maxBytes));
+     *   if (NULL != dataRef.get()) {
+     *     size_t bytesActuallyRead = dataRef.get()->size();
+     *     // use the data...
+     *   }
+     * }
+     * // underlying buffer has been freed, thanks to auto unref
+     */
+    static SkData* ReadIntoSkData(SkStream &stream, size_t maxBytes);
+
+    /**
+     * Wrapper around ReadIntoSkData for files: reads the entire file into
+     * an SkData object.
+     */
+    static SkData* ReadFileIntoSkData(SkFILEStream &stream) {
+        return ReadIntoSkData(stream, stream.getLength());
+    }
+
+};
+
+#endif