@depup/sharp-cli 5.2.0-depup.0

package/cmd/channel-manipulation/join-channel.js

@@ -0,0 +1,60 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2019 Mark van Seventer
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.pixelplumbing.com/api-channel#joinchannel
+
+// Strict mode.
+'use strict'
+
+// Local modules.
+const queue = require('../../lib/queue')
+
+// Configure.
+const positionals = {
+  images: {
+    desc: 'One or more images',
+    normalize: true,
+    type: 'array'
+  }
+}
+
+// Command builder.
+const builder = (yargs) => {
+  return yargs
+    .strict()
+    .epilog('For more information on available options, please visit https://sharp.pixelplumbing.com/api-channel#joinchannel')
+    .positional('images', positionals.images)
+}
+
+// Command handler.
+const handler = (args) => {
+  return queue.push(['joinChannel', (sharp) => sharp.joinChannel(args.images)])
+}
+
+// Exports.
+module.exports = {
+  command: 'joinChannel <images..>',
+  describe: 'Join one or more channels to the image',
+  builder,
+  handler
+}

package/cmd/channel-manipulation/remove-alpha.js

@@ -0,0 +1,49 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2019 Mark van Seventer
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.pixelplumbing.com/api-channel#removealpha
+
+// Strict mode.
+'use strict'
+
+// Local modules.
+const queue = require('../../lib/queue')
+
+// Command builder.
+const builder = (yargs) => {
+  return yargs
+    .strict()
+    .example('$0 removeAlpha', 'The output will be without an alpha channel')
+    .epilog('For more information on available options, please visit https://sharp.pixelplumbing.com/api-channel#removealpha')
+}
+
+// Command handler.
+const handler = (args) => queue.push(['removeAlpha', (sharp) => sharp.removeAlpha()])
+
+// Exports.
+module.exports = {
+  command: 'removeAlpha',
+  describe: 'Remove alpha channel, if any',
+  builder,
+  handler
+}

package/cmd/colour-manipulation/greyscale.js

@@ -0,0 +1,50 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2019 Mark van Seventer
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.pixelplumbing.com/api-colour#greyscale
+
+// Strict mode.
+'use strict'
+
+// Local modules.
+const queue = require('../../lib/queue')
+
+// Command builder.
+const builder = (yargs) => {
+  return yargs
+    .strict()
+    .example('$0 greyscale', 'The output will contain three identical color channels')
+    .epilog('For more information on available options, please visit https://sharp.pixelplumbing.com/api-colour#greyscale')
+}
+
+// Command handler.
+const handler = (args) => queue.push(['greyscale', (sharp) => sharp.greyscale()])
+
+// Exports.
+module.exports = {
+  command: 'greyscale',
+  aliases: 'grayscale',
+  describe: 'Convert to 8-bit greyscale; 256 shades of grey',
+  builder,
+  handler
+}

package/cmd/colour-manipulation/pipeline-colourspace.js

@@ -0,0 +1,63 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2022 Mark van Seventer
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.pixelplumbing.com/api-colour#tocolourspace
+
+// Strict mode.
+'use strict'
+
+// Local modules.
+const constants = require('../../lib/constants')
+const queue = require('../../lib/queue')
+
+// Configure.
+const positionals = {
+  colourspace: {
+    alias: 'colorspace',
+    choices: constants.COLOURSPACE,
+    desc: 'Pipeline colourspace'
+  }
+}
+
+// Command builder.
+const builder = (yargs) => {
+  return yargs
+    .strict()
+    .example('$0 pipelineColourspace rgb16', 'Run the pipeline in 16 bits per channel RGB')
+    .epilog('For more information on available options, please visit https://sharp.pixelplumbing.com/api-colour#tocolourspace')
+    .positional('colourspacae', positionals.colourspace)
+}
+
+// Command handler.
+const handler = (args) => {
+  return queue.push(['pipelineColourspace', (sharp) => sharp.pipelineColourspace(args.colourspace)])
+}
+
+// Exports.
+module.exports = {
+  command: 'pipelineColourspace <colourspace>',
+  aliases: 'pipelineColorspace',
+  describe: 'Set the pipeline colourspace',
+  builder,
+  handler
+}

package/cmd/colour-manipulation/tint.js

@@ -0,0 +1,58 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2019 Mark van Seventer
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.pixelplumbing.com/api-colour#tint
+
+// Strict mode.
+'use strict'
+
+// Local modules.
+const queue = require('../../lib/queue')
+
+// Configure.
+const positionals = {
+  rgb: {
+    desc: 'Parsed by the color module to extract chroma values',
+    type: 'string'
+  }
+}
+
+// Command builder.
+const builder = (yargs) => {
+  return yargs
+    .strict()
+    .example('$0 tint "rgb(255, 240, 16)"')
+    .epilog('For more information on available options, please visit https://sharp.pixelplumbing.com/api-colour#tint')
+    .positional('rgb', positionals.rgb)
+}
+
+// Command handler.
+const handler = (args) => queue.push(['tint', (sharp) => sharp.tint(args.rgb)])
+
+// Exports.
+module.exports = {
+  command: 'tint <rgb>',
+  describe: 'Tint the image using the provided chroma while preserving the image luminance',
+  builder,
+  handler
+}

package/cmd/colour-manipulation/tocolourspace.js

@@ -0,0 +1,63 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2019 Mark van Seventer
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.pixelplumbing.com/api-colour#tocolourspace
+
+// Strict mode.
+'use strict'
+
+// Local modules.
+const constants = require('../../lib/constants')
+const queue = require('../../lib/queue')
+
+// Configure.
+const positionals = {
+  colourspace: {
+    choices: constants.COLOURSPACE,
+    default: 'srgb',
+    desc: 'The output colourspace'
+  }
+}
+
+// Command builder.
+const builder = (yargs) => {
+  return yargs
+    .strict()
+    .example('$0 toColourspace rgb16', 'Output 16 bits per pixel RGB')
+    .epilog('For more information on available options, please visit https://sharp.pixelplumbing.com/api-colour#tocolourspace')
+    .positional('colourspace', positionals.colourspace)
+}
+
+// Command handler.
+const handler = (args) => {
+  return queue.push(['toColourspace', (sharp) => sharp.toColourspace(args.colourspace)])
+}
+
+// Exports.
+module.exports = {
+  command: 'toColourspace <colourspace>',
+  aliases: 'toColorspace',
+  describe: 'Set the output colourspace',
+  builder,
+  handler
+}

package/cmd/compositing/composite.js

@@ -0,0 +1,187 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2019 Mark van Seventer
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see http://sharp.pixelplumbing.com/api-composite#composite
+
+// Strict mode.
+'use strict'
+
+// Local modules.
+const constants = require('../../lib/constants')
+const queue = require('../../lib/queue')
+
+// Helpers.
+function getValueAt (arrayLike, index) {
+  if (Array.isArray(arrayLike)) {
+    return arrayLike[Math.min(index, arrayLike.length - 1)]
+  }
+  return arrayLike
+}
+
+function hasOwnProperty (obj, prop) {
+  return obj != null && Object.prototype.hasOwnProperty.call(obj, prop)
+}
+
+// Configure.
+const positionals = {
+  images: {
+    desc: 'Path to an image file',
+    normalize: true,
+    type: 'string'
+  }
+}
+
+const options = {
+  blend: {
+    choices: constants.BLEND,
+    defaultDescription: 'over',
+    desc: 'How to blend this image with the image below'
+  },
+  create: {
+    desc: 'Describes a blank overlay to be created',
+    hidden: true,
+    type: 'boolean'
+  },
+  'create.background': {
+    desc: 'Background of the blank overlay to be created, parsed by the color module',
+    type: 'string'
+  },
+  'create.channels': {
+    choices: [3, 4],
+    default: 3,
+    desc: 'Number of channels of the blank overlay to be created'
+  },
+  'create.height': {
+    desc: 'Height of the blank overlay to be created',
+    type: 'number'
+  },
+  'create.width': {
+    desc: 'Width of the blank overlay to be created',
+    type: 'number'
+  },
+  density: {
+    desc: 'Number representing the DPI for vector images',
+    defaultDescription: 72,
+    type: 'number'
+  },
+  gravity: {
+    choices: constants.GRAVITY,
+    defaultDescription: 'centre',
+    desc: 'Gravity at which to place the overlay'
+  },
+  left: {
+    desc: 'The pixel offset from the left edge',
+    implies: 'top',
+    type: 'number'
+  },
+  premultiplied: {
+    desc: 'Avoid premultiplying the image',
+    type: 'boolean'
+  },
+  tile: {
+    desc: 'Repeat the overlay image across the entire image with the given gravity',
+    type: 'boolean'
+  },
+  top: {
+    desc: 'The pixel offset from the top edge',
+    implies: 'left',
+    type: 'number'
+  }
+}
+
+// Command builder.
+const builder = (yargs) => {
+  const optionNames = Object.keys(options)
+  return yargs
+    .strict()
+    .example('$0 composite ./input.png --gravity southeast', 'The output will be the input composited with ./input.png with SE gravity')
+    .example('$0 composite ./layer1.png --gravity northwest ./layer2.png --gravity southeast', 'The output will be the input composited with ./layer1.png with NW gravity and ./layer2.png with SE gravity')
+    .example('$0 composite ./overlay.png --tile --blend saturate', 'The output will be the input composited with ./overlay.png saturated over the entire image')
+    .epilog('For more information on available options, please visit http://sharp.pixelplumbing.com/api-composite#composite')
+    .positional('images', positionals.images)
+    .check(argv => {
+      if ((!argv.images || argv.images.length === 0) && !hasOwnProperty(argv.create, 'width')) {
+        throw new Error('Expected at least one of images positional or create option')
+      }
+      return true
+    })
+    .options(options)
+    .group(optionNames, 'Command Options')
+}
+
+// Command handler.
+const handler = (args) => {
+  if ((hasOwnProperty(args.create, 'width') && !hasOwnProperty(args.create, 'height')) ||
+   (hasOwnProperty(args.create, 'height') && !hasOwnProperty(args.create, 'width'))) {
+    throw new Error('Expected both of create.width and create.height options')
+  }
+
+  const inputs = []
+  if (hasOwnProperty(args.create, 'width')) {
+    const { channels, background, width, height } = args.create
+    const length = Math.max(width.length ?? 0, height.length ?? 0)
+    if (length > 0) { // Width or height (or both) is an array.
+      inputs.push(...Array.from({ length }, (_, idx) => idx).map(idx => ({
+        create: {
+          width: getValueAt(width, idx),
+          height: getValueAt(height, idx),
+          channels: getValueAt(channels, idx),
+          background: getValueAt(background, idx)
+        }
+      })))
+    } else { // Both width and height are numbers.
+      inputs.push({ create: args.create })
+    }
+  }
+  if (args.images) inputs.push(...args.images)
+
+  // @see http://sharp.pixelplumbing.com/api-composite#composite
+  return queue.push(['composite', (sharp) => {
+    return sharp.composite(
+      inputs.map((input, idx) => ({
+        animated: args.animated,
+        autoOrient: args.autoOrient,
+        blend: getValueAt(args.blend, idx),
+        density: getValueAt(args.density, idx),
+        failOn: args.failOn,
+        gravity: getValueAt(args.gravity, idx),
+        ignoreIcc: getValueAt(args.ignoreIcc),
+        input,
+        left: getValueAt(args.left, idx),
+        limitInputPixels: args.limitInputPixels,
+        pdfBackground: args.pdfBackground,
+        premultiplied: getValueAt(args.premultiplied, idx),
+        tile: getValueAt(args.tile, idx),
+        top: getValueAt(args.top, idx)
+      }))
+    )
+  }])
+}
+
+// Exports.
+module.exports = {
+  command: 'composite [images..]',
+  describe: 'Composite image(s) over the processed (resized, extracted etc.) image',
+  builder,
+  handler
+}

package/cmd/operations/affine.js

@@ -0,0 +1,110 @@
+/*!
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2022 Mark van Seventer
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// @see https://sharp.pixelplumbing.com/api-operation#affine
+
+// Strict mode.
+'use strict'
+
+// Package modules.
+const pick = require('lodash.pick')
+
+// Local modules.
+const constants = require('../../lib/constants')
+const queue = require('../../lib/queue')
+
+// Configure.
+const placeholders = {
+  matrix: {
+    desc: 'Affine transformation matrix',
+    nargs: 2 * 2,
+    type: 'number'
+  }
+}
+
+const options = {
+  background: {
+    defaultDescription: '#000000',
+    desc: 'String parsed by the color module to extract values for red, green, blue and alpha',
+    type: 'string'
+  },
+  idx: {
+    defaultDescription: '0',
+    desc: 'The input horizontal offset',
+    type: 'number'
+  },
+  idy: {
+    defaultDescription: '0',
+    desc: 'The input vertical offset',
+    type: 'number'
+  },
+  odx: {
+    defaultDescription: '0',
+    desc: 'The output horizontal offset',
+    type: 'number'
+  },
+  ody: {
+    defaultDescription: '0',
+    desc: 'The output vertical offset',
+    type: 'number'
+  },
+  interpolate: {
+    choices: constants.INTERPOLATORS,
+    defaultDescription: 'bicubic',
+    desc: 'The input horizontal offset'
+  }
+}
+const optionNames = Object.keys(options)
+
+// Command builder.
+const builder = (yargs) => {
+  return yargs
+    .strict()
+    .example('$0 affine 1 0.3 0.1 0.7 --background white --interpolate nohalo')
+    .epilog('For more information on available options, please visit https://sharp.dimens.io/api-operation#affine')
+    .check(argv => {
+      if (!(Array.isArray(argv.matrix) && argv.matrix.length === 4)) {
+        throw new Error('Expected matrix positional to have 4 values')
+      }
+      return true
+    })
+    .positional('matrix', placeholders.matrix)
+    .options(options)
+    .group(optionNames, 'Command Options')
+}
+
+// Command handler.
+const handler = (args) => {
+  return queue.push(['affine', (sharp) => {
+    const { matrix } = args
+    return sharp.affine([matrix.slice(0, 2), matrix.slice(2, 4)], pick(args, optionNames))
+  }])
+}
+
+// Exports.
+module.exports = {
+  command: 'affine <matrix..>',
+  describe: 'Perform an affine transform on an image',
+  builder,
+  handler
+}