New API

Author: tcr

README.md

@@ -9,14 +9,14 @@ var spindrift = require('spindrift');
 
 // Use and chain any of these commands...
 var pdf = spindrift('in.pdf')
-   .pages(7, 24)
-   .page(1)
-   .even()
-   .odd()
-   .rotate(90)
+   .pages(4, 5, 6, 1, 12) // select or reorder individual pages
+   .range(1, 10) // pages 1-10
+   .even() // select even pages
+   .odd() // select odd pages
+   .rotate(90) // 90, 180, 270, 360
    .compress()
    .uncompress()
-   .crop(100, 100, 300, 200) // left, bottom, right, top
+   .crop(100, 100, 300, 200) // offset in points from left, bottom, right, top
 
 // Join multiple files...
 var pdfA = spindrift('1.pdf'), pdfB = spindrift('2.pdf'), pdfC = spindrift('3.pdf')
@@ -43,15 +43,4 @@ pdf.extractImageStream(0)
 
 * Install [PDFTK (http://www.pdflabs.com/docs/install-pdftk/)](http://www.pdflabs.com/docs/install-pdftk/) on your system.
 * Ensure you have Ghostscript installed (check by running `gs --version`).
-* *(optional)* To extract individual images from a page, install `pdfimages` with `brew install xpdf` or `apt-get install poppler-utils`.
-
-## References
-
-* http://hzqtc.github.com/2012/04/pdf-tools-merging-extracting-and-cropping.html
-* http://documentcloud.github.com/docsplit/
-* http://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/
-* http://segfault.in/2010/07/pdf-manipulations-and-conversions-from-linux-command-prompt/
-* http://www.maths.ox.ac.uk/help/faqs/files/manipulating-pdf-files
-* http://stackoverflow.com/questions/11754556/ghostscript-convert-a-pdf-and-output-in-a-textfile
-* http://right-sock.net/linux/better-convert-pdf-to-jpg-using-ghost-script/
-* http://stackoverflow.com/questions/12484353/how-to-crop-a-section-of-a-pdf-file-to-png-using-ghostscript?lq=1
+* *(optional)* To extract individual images from a page, install `pdfimages` with `brew install xpdf` or `apt-get install poppler-utils`.

example/test.js

@@ -2,7 +2,7 @@ var fs = require('fs');
 var spindrift = require('..');
 
 var pdf = spindrift(__dirname + '/test.pdf');
-var page = pdf.page(2);
+var page = pdf.pages(2);
 
 // Streams
 page.pdfStream().pipe(fs.createWriteStream(__dirname + '/test-page.pdf'));

package.json

@@ -1,6 +1,6 @@
 {
   "name": "spindrift",
-  "version": "0.0.6",
+  "version": "0.1.0",
   "description": "PDF manipulation in Node.js! Split, join, crop, read, extract, boil, mash, stick them in a stew. ",
   "main": "spindrift.js",
   "dependencies": {

spindrift.js

@@ -78,7 +78,7 @@ Command.prototype._input = function () {
 
 // Cloning commands.
 
-Command.prototype.pages = function (min, max) {
+Command.prototype.range = function (min, max) {
   var cmd = this._copy();
   return cmd._push([
     'pdftk', cmd._input(),
@@ -87,8 +87,14 @@ Command.prototype.pages = function (min, max) {
     ]);
 };
 
-Command.prototype.page = function (page) {
-  return this.pages(page, page);
+Command.prototype.pages = function () {
+  var args = Array.prototype.slice.call(arguments);
+  var cmd = this._copy();
+  return cmd._push([
+    'pdftk', cmd._input(),
+    'cat'].concat(args.map(Number), [
+      'output', '-'
+      ]));
 };
 
 Command.prototype.odd = function (min, max) {
@@ -396,4 +402,21 @@ spindrift.join = function () {
   return pdf;
 }
 
-module.exports = spindrift;
+module.exports = spindrift;
+
+/*
+
+references
+
+## References
+
+* http://hzqtc.github.com/2012/04/pdf-tools-merging-extracting-and-cropping.html
+* http://documentcloud.github.com/docsplit/
+* http://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/
+* http://segfault.in/2010/07/pdf-manipulations-and-conversions-from-linux-command-prompt/
+* http://www.maths.ox.ac.uk/help/faqs/files/manipulating-pdf-files
+* http://stackoverflow.com/questions/11754556/ghostscript-convert-a-pdf-and-output-in-a-textfile
+* http://right-sock.net/linux/better-convert-pdf-to-jpg-using-ghost-script/
+* http://stackoverflow.com/questions/12484353/how-to-crop-a-section-of-a-pdf-file-to-png-using-ghostscript?lq=1
+
+*/