grunt-gm v0.4.3

Batch process your images with gm.

Getting Started

This plugin requires Grunt ~0.4.0

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-gm --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-gm');

Overview

At the moment the task is pretty much just a simple grunt wrapper to gm.

Before start, please verify your GraphicsMagick or ImageMagick installation by running convert -vsersion.

If the task ran into error Fatal error: Maximum call stack size exceeded, it's probably because the files array is too long. To resolve this, try:

• Run grunt with custom stack size node --stack-size=9999 node_modules/grunt-cli/bin/grunt gm
• Check default by node --v8-options | grep -B0 -A1 stack_size

If your are on OSX, and the task ended with:

dyld: Library not loaded: /usr/local/lib/libfreetype.6.dylib
  Referenced from: /usr/local/bin/gm
  Reason: image not found

try brew unlink freetype && brew link freetype

The Task

See basic usages.

grunt.initConfig({
  gm: {
    test: {
      options: {
        // default: false, check if dest file exists and size > 0
        skipExisting: false,
        // default: false
        stopOnError: false,
        // task options will also be passed to arg callback
        yourcustomopt: {
          'test/gruntjs.png': '"JavaScript Task Runner"',
          'test/nodejs.png': '"JavaScript Runtime"'
        }
      },
      files: [
        {
          cwd: 'test',
          dest: 'test/out',
          expand: true,
          filter: 'isFile',
          src: ['**/*', '!**/out/*', '!{film,sample}.png'],
          options: {
            skipExisting: true,
            stopOnError: true
          }
          // image is passed as stream beteen tasks
          tasks: [
            {
              // resize and watermark
              resize: [200],
              command: ['composite'],
              in: ['test/sample.png']
            }, {
              // extent and center the image with padding arund it
              gravity: ['Center'],
              extent: [400, 360]
            }, {
              // frame it
              command: ['composite'],
              in: ['test/film.png']
            }, {
              // watermark text
              gravity: ['North'],
              font: ['arial', 30],
              draw: [
                'skewX', -13,
                // function in arg list will be called with current file object
                'fill', '#999', 'text', 2, 67, function (f) {return f.options.yourcustomopt[f.src[0]]},
                'fill', '#000', 'text', 0, 65, function (f) {return f.options.yourcustomopt[f.src[0]]}
              ]
            }
          ]
        }
      ]
    }
  }
});

Original|After Task #1|After Task #2|After Task #3|After Task #4 :------:|:---------------------:|:---------------------:|:---------------------:|:---------------------: |||| ||||

• Options precedence:
  1. CLI, eg. --skipExising
  • File, eg. files:[{options:{skipExising:true}}]
  • Task, eg. gm:{task1:{options:{skipExising:true}}
• Task will traverse the file list and execute gm tasks one by one, top down
• Grunt with --verbose flag to print out corresponding gm argument list

TODO

Release History

• 2014-10-03   v0.4.3   Add js build, update log dump
• 2014-08-11   v0.4.1   Rebuild broken release
• 2014-08-08   v0.4.0   Support function in task argument list
• 2014-07-30   v0.3.0   Support multiple gm tasks
• 2014-07-29   v0.2.1   Reimplement the task
• 2014-07-28   v0.2.0   Add options skipExisting and stopOnError
• 2014-07-27   v0.1.2   Temp fix require
• 2014-07-27   v0.1.1   Fix log dump and mkdir -p dest if not exists
• 2014-07-27   v0.1.0   Initial release