Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 | 1x 1x 1x 1x 1x 18x 18x 1x 18x 18x 18x 6x 1x | /*!
* 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/en/v0.21.3/api-composite/#overlaywith
// Strict mode.
'use strict'
// Standard lib.
const path = require('path')
// Local modules.
const constants = require('../../lib/constants')
const queue = require('../../lib/queue')
// Configure.
const options = {
create: {
desc: 'Describes a blank overlay to be created',
defaultDescription: 'width, height, channels, background',
nargs: 4,
type: 'array'
},
cutout: {
desc: 'Apply only the alpha channel of the overlay image to the input image, giving the appearance of one image being cut out of another',
type: 'boolean'
},
gravity: {
choices: constants.GRAVITY,
default: 'centre',
desc: 'Gravity at which to place the overlay',
nargs: 1,
type: 'string'
},
offset: {
desc: 'The pixel offset from the top and left edges',
nargs: 2,
type: 'array'
},
overlay: {
coerce: path.normalize, // Positional arguments need manual normalization.
desc: 'Path to an image file',
normalize: true,
type: 'string'
},
tile: {
desc: 'Repeat the overlay image across the entire image with the given gravity',
type: 'boolean'
}
}
// Command builder.
const builder = (yargs) => {
const optionNames = Object.keys(options)
return yargs
.strict()
.example('$0 overlayWith ./input.png --gravity southeast', 'The output will be the input composited with ./input.png with SE gravity')
.epilog('For more information on available options, please visit http://sharp.pixelplumbing.com/en/v0.21.3/api-composite/#overlaywith')
.options(options)
.global(optionNames, false)
.group(optionNames, 'Command Options')
}
// Command handler.
const handler = (args) => {
const [ top, left ] = args.offset || [ ]
const [ width, height, channels, background ] = args.create || [ ]
// @see http://sharp.pixelplumbing.com/en/v0.21.3/api-composite/#overlaywith
return queue.push([ 'overlayWith', (sharp) => {
return sharp.overlayWith(args.overlay, {
create: args.create && { width, height, channels, background },
gravity: args.gravity,
top,
left,
tile: args.tile,
cutout: args.cutout
})
}])
}
// Exports.
module.exports = {
command: 'overlayWith <overlay>',
describe: '[DEPRECATED] Overlay (composite) an image over the processed (resized, extracted etc.) image',
builder,
handler
}
|