gm().toBuffer()

lib/command.js

@@ -127,6 +127,29 @@ module.exports = function (proto) {
     return throughStream
   }
 
+  /**
+   * Convenience function for `proto.stream`.
+   * Simply returns the buffer instead of the stream.
+   *
+   * @param {String} format (optional)
+   * @param {Function} callback
+   * @return {null}
+   */
+
+  proto.toBuffer = function toBuffer (format, callback) {
+    if (!callback) callback = format, format = null;
+
+    if ("function" !== typeof callback) {
+      throw new Error('gm().toBuffer() expects a callback.');
+    }
+
+    return this.stream(format, function (err, stdout) {
+      if (err) return callback(err);
+
+      utils.streamToBuffer(stdout, callback);
+    })
+  }
+
   /**
     * Run any preProcessor functions in series. Used by autoOrient.
     *

test/toBuffer.js

@@ -0,0 +1,18 @@
+var assert = require('assert');
+var fs = require('fs');
+
+module.exports = function (gm, dir, finish, GM) {
+
+  if (!GM.integration)
+    return finish();
+
+  gm
+  .toBuffer(function (err, buffer) {
+    if (err) return finish(err);
+
+    assert.ok(buffer instanceof Buffer);
+    assert.ok(buffer.length);
+
+    finish();
+  })
+}

test/toBufferFormat.js

@@ -0,0 +1,18 @@
+var assert = require('assert');
+var fs = require('fs');
+
+module.exports = function (gm, dir, finish, GM) {
+
+  if (!GM.integration)
+    return finish();
+
+  gm
+  .toBuffer('PNG', function (err, buffer) {
+    if (err) return finish(err);
+
+    assert.ok(buffer instanceof Buffer);
+    assert.ok(buffer.length);
+
+    finish();
+  })
+}