total5 0.0.1 → 0.0.2

package/image.js

@@ -0,0 +1,777 @@
+// Total.js Images
+// The MIT License
+// Copyright 2016-2023 (c) Peter Širka <petersirka@gmail.com>
+
+'use strict';
+
+const D = F.iswindows ? '"' : '\'';
+const SOF = { 0xc0: true, 0xc1: true, 0xc2: true, 0xc3: true, 0xc5: true, 0xc6: true, 0xc7: true, 0xc9: true, 0xca: true, 0xcb: true, 0xcd: true, 0xce: true, 0xcf: true };
+const SPAWN_OPT = { shell: true };
+const CMD_CONVERT = { gm: 'gm', im: 'convert', magick: 'magick' };
+const CMD_CONVERT2 = { gm: 'gm convert', im: 'convert', magick: 'magick' };
+const SUPPORTED = { jpg: 1, png: 1, gif: 1, apng: 1, jpeg: 1, heif: 1, heic: 1, webp: 1, ico: 1 };
+
+const REG_SVG = /(width="\d+")+|(height="\d+")+/g;
+const REG_PATH = /\//g;
+const REG_ESCAPE = /'/g;
+
+function u16(buf, o) {
+	return buf[o] << 8 | buf[o + 1];
+}
+
+function u32(buf, o) {
+	return buf[o] << 24 | buf[o + 1] << 16 | buf[o + 2] << 8 | buf[o + 3];
+}
+
+exports.measureGIF = function(buffer) {
+	return { width: buffer.readInt16LE(6), height: buffer.readInt16LE(8) };
+};
+
+// MIT
+// Written by TJ Holowaychuk
+// visionmedia
+exports.measureJPG = function(buffer) {
+
+	var len = buffer.length;
+	var o = 0;
+
+	var jpeg = 0xff == buffer[0] && 0xd8 == buffer[1];
+	if (jpeg) {
+		o += 2;
+		while (o < len) {
+			while (0xff != buffer[o]) o++;
+			while (0xff == buffer[o]) o++;
+			if (SOF[buffer[o]])
+				return { width: u16(buffer, o + 6), height: u16(buffer, o + 4) };
+			else
+				o += u16(buffer, ++o);
+
+		}
+	}
+
+	return null;
+};
+
+// MIT
+// Written by TJ Holowaychuk
+// visionmedia
+exports.measurePNG = function(buffer) {
+	return { width: u32(buffer, 16), height: u32(buffer, 16 + 4) };
+};
+
+exports.measureSVG = function(buffer) {
+
+	var match = buffer.toString('utf8').match(REG_SVG);
+	if (!match)
+		return;
+
+	var width = 0;
+	var height = 0;
+
+	for (var i = 0, length = match.length; i < length; i++) {
+		var value = match[i];
+
+		if (width > 0 && height > 0)
+			break;
+
+		if (!width && value.startsWith('width="'))
+			width = value.parseInt2();
+
+		if (!height && value.startsWith('height="'))
+			height = value.parseInt2();
+	}
+
+	return { width: width, height: height };
+};
+
+// image-size
+// Git: https://github.com/image-size/image-size
+// MIT License
+exports.measureWEBP = function(buffer) {
+
+	var header = buffer.toString('ascii', 12, 16);
+
+	buffer = buffer.slice(20, 30);
+
+	if (header === 'VP8X') {
+		var extendedheader = buffer[0];
+		var start = (extendedheader & 0xc0) === 0;
+		var end = (extendedheader & 0x01) === 0;
+		if (start && end)
+			return { width: 1 + buffer.readUIntLE(7, 3), height: 1 + buffer.readUIntLE(4, 3) };
+	}
+
+	if (header === 'VP8 ' && buffer[0] !== 0x2f)
+		return { width: buffer.readInt16LE(8) & 0x3fff, height: buffer.readInt16LE(6) & 0x3fff };
+
+	var signature = buffer.toString('hex', 3, 6);
+	if (header === 'VP8L' && signature !== '9d012a')
+		return { width: 1 + (((buffer[2] & 0x3F) << 8) | buffer[1]), height: 1 + (((buffer[4] & 0xF) << 10) | (buffer[3] << 2) | ((buffer[2] & 0xC0) >> 6)) };
+};
+
+// image-size
+// Git: https://github.com/image-size/image-size
+// MIT License
+exports.measureBMP = function(buffer) {
+	return { width: buffer.readUInt32LE(18), height: Math.abs(buffer.readInt32LE(22)) };
+};
+
+// image-size
+// Git: https://github.com/image-size/image-size
+// MIT License
+exports.measurePSD = function(buffer) {
+	return { width: buffer.readUInt32BE(18), height: buffer.readUInt32BE(14) };
+};
+
+exports.measure = function(type, buffer) {
+	switch (type) {
+		case '.jpg':
+		case '.jpeg':
+		case 'jpg':
+		case 'jpeg':
+		case 'image/jpeg':
+			return exports.measureJPG(buffer);
+		case '.png':
+		case 'png':
+		case 'image/png':
+			return exports.measurePNG(buffer);
+		case '.svg':
+		case 'svg':
+		case 'image/svg+xml':
+			return exports.measureSVG(buffer);
+		case '.gif':
+		case 'gif':
+		case 'image/gif':
+			return exports.measureGIF(buffer);
+		case '.webp':
+		case 'webp':
+		case 'image/webp':
+			return exports.measureWEBP(buffer);
+		case '.psd':
+		case 'psd':
+		case 'image/vnd.adobe.photoshop':
+			return exports.measurePSD(buffer);
+		case '.bmp':
+		case 'bmp':
+		case 'image/bmp':
+			return exports.measureBMP(buffer);
+	}
+};
+
+function Image(filename, cmd, width, height) {
+	var t = this;
+	var type = typeof(filename);
+	t.width = width;
+	t.height = height;
+	t.builder = [];
+	t.filename = type === 'string' ? filename : null;
+	t.stream = type === 'object' ? filename : null;
+	t.type = type === 'string' ? F.TUtils.getExtension(filename) : 'jpg';
+	t.islimit = false;
+	t.cmdarg = cmd || F.config.$imageconverter;
+}
+
+var ImageProto = Image.prototype;
+
+ImageProto.clear = function() {
+	var self = this;
+	self.builder = [];
+	return self;
+};
+
+ImageProto.measure = function(callback) {
+
+	var self = this;
+	var index = self.filename.lastIndexOf('.');
+
+	if (!self.filename) {
+		callback(new Error('Measure does not support stream.'));
+		return;
+	}
+
+	if (index === -1) {
+		callback(new Error('This type of file is not supported.'));
+		return;
+	}
+
+	F.stats.performance.open++;
+	var extension = self.filename.substring(index).toLowerCase();
+	var stream = F.Fs.createReadStream(self.filename, { start: 0, end: (extension === '.jpg' || extension === '.webp') ? 40000 : 24 });
+
+	stream.on('data', function(buffer) {
+
+		switch (extension) {
+			case '.jpg':
+				callback(null, exports.measureJPG(buffer));
+				return;
+			case '.gif':
+				callback(null, exports.measureGIF(buffer));
+				return;
+			case '.png':
+				callback(null, exports.measurePNG(buffer));
+				return;
+			case '.webp':
+				callback(null, exports.measureWEBP(buffer));
+				return;
+		}
+
+		callback(new Error('This type of file is not supported.'));
+	});
+
+	stream.on('error', callback);
+	return self;
+};
+
+ImageProto.$$measure = function() {
+	var self = this;
+	return function(callback) {
+		self.measure(callback);
+	};
+};
+
+/**
+ * Execute commands
+ * @param {String} filename
+ * @param {Function(err, filename)} callback Optional.
+ * @param {Function(stream)} writer A custom stream writer, optional.
+ * @return {Image}
+ */
+ImageProto.save = function(filename, callback, writer) {
+
+	var self = this;
+
+	if (typeof(filename) === 'function') {
+		callback = filename;
+		filename = null;
+	}
+
+	!self.builder.length && self.minify();
+	filename = filename || self.filename || '';
+
+	var command = self.cmd(self.filename ? self.filename : '-', filename);
+
+	if (F.isWindows)
+		command = command.replace(REG_PATH, '\\');
+
+	var cmd = F.Child.exec(command, function(err) {
+
+		// clean up
+		cmd.kill();
+		cmd = null;
+
+		self.clear();
+
+		if (!callback)
+			return;
+
+		if (err) {
+			callback(err, false);
+			return;
+		}
+
+		var middleware = F.routes.imagemiddleware[self.type];
+		if (!middleware)
+			return callback(null, true);
+
+		F.stats.performance.open++;
+		var reader = F.Fs.createReadStream(filename);
+		var writer = F.Fs.createWriteStream(filename + '_');
+
+		reader.pipe(middleware()).pipe(writer);
+		writer.on('finish', () => F.Fs.rename(filename + '_', filename, () => callback(null, true)));
+	});
+
+	if (self.stream) {
+		if (self.stream instanceof Buffer)
+			cmd.stdin.end(self.stream);
+		else
+			self.stream.pipe(cmd.stdin);
+	}
+
+	F.cleanup(cmd.stdin);
+	writer && writer(cmd.stdin);
+	return self;
+};
+
+ImageProto.$$save = function(filename, writer) {
+	var self = this;
+	return function(callback) {
+		self.save(filename, callback, writer);
+	};
+};
+
+ImageProto.pipe = function(stream, type, options) {
+
+	var self = this;
+
+	if (typeof(type) === 'object') {
+		options = type;
+		type = null;
+	}
+
+	!self.builder.length && self.minify();
+
+	if (!type || !SUPPORTED[type])
+		type = self.type;
+
+	var cmd = F.Child.spawn(CMD_CONVERT[self.cmdarg], self.arg(self.filename ? wrap(self.filename) : '-', (type ? type + ':' : '') + '-'), SPAWN_OPT);
+	cmd.stderr.on('data', stream.emit.bind(stream, 'error'));
+	cmd.stdout.on('data', stream.emit.bind(stream, 'data'));
+	cmd.stdout.on('end', stream.emit.bind(stream, 'end'));
+	cmd.on('error', stream.emit.bind(stream, 'error'));
+
+	var middleware = F.routes.imagemiddleware[type];
+	if (middleware)
+		cmd.stdout.pipe(middleware()).pipe(stream, options);
+	else
+		cmd.stdout.pipe(stream, options);
+
+	if (self.stream) {
+		if (self.stream instanceof Buffer)
+			cmd.stdin.end(self.stream);
+		else
+			self.stream.pipe(cmd.stdin);
+	}
+
+	return self;
+};
+
+/**
+ * Create a stream
+ * @param {String} type File type (png, jpg, gif)
+ * @param {Function(stream)} writer A custom stream writer.
+ * @return {ReadStream}
+ */
+ImageProto.stream = function(type, writer) {
+
+	var self = this;
+
+	!self.builder.length && self.minify();
+
+	if (!type || !SUPPORTED[type])
+		type = self.type;
+
+	F.stats.performance.open++;
+	var cmd = F.Child.spawn(CMD_CONVERT[self.cmdarg], self.arg(self.filename ? wrap(self.filename) : '-', (type ? type + ':' : '') + '-'), SPAWN_OPT);
+	if (self.stream) {
+		if (self.stream instanceof Buffer)
+			cmd.stdin.end(self.stream);
+		else
+			self.stream.pipe(cmd.stdin);
+	}
+
+	writer && writer(cmd.stdin);
+	var middleware = F.routes.imagemiddleware[type];
+	return middleware ? cmd.stdout.pipe(middleware()) : cmd.stdout;
+};
+
+ImageProto.cmd = function(filenameFrom, filenameTo) {
+
+	var self = this;
+	var cmd = '';
+
+	if (!self.islimit) {
+		var tmp = F.config.$imagememory;
+		if (tmp) {
+			self.limit('memory', (1500 / 100) * tmp);
+			self.limit('map', (3000 / 100) * tmp);
+		}
+	}
+
+	self.builder.sort(sort);
+
+	var length = self.builder.length;
+	for (var i = 0; i < length; i++)
+		cmd += (cmd ? ' ' : '') + self.builder[i].cmd;
+
+	return CMD_CONVERT2[self.cmdarg] + wrap(filenameFrom, true) + ' ' + cmd + wrap(filenameTo, true);
+};
+
+function sort(a, b) {
+	return a.priority > b.priority ? 1 : -1;
+}
+
+ImageProto.arg = function(first, last) {
+
+	var self = this;
+	var arr = [];
+
+	if (self.cmdarg === 'gm')
+		arr.push('convert');
+
+	first && arr.push(first);
+
+	if (!self.islimit) {
+		let tmp = F.config.$imagememory;
+		if (tmp) {
+			self.limit('memory', (1500 / 100) * tmp);
+			self.limit('map', (3000 / 100) * tmp);
+		}
+	}
+
+	self.builder.sort(sort);
+
+	for (let o of self.builder) {
+		let index = o.cmd.indexOf(' ');
+		if (index === -1) {
+			arr.push(o.cmd);
+		} else {
+			arr.push(o.cmd.substring(0, index));
+			arr.push(o.cmd.substring(index + 1).replace(/"/g, ''));
+		}
+	}
+
+	last && arr.push(last);
+	return arr;
+};
+
+ImageProto.identify = function(callback) {
+	var self = this;
+	F.Child.exec((self.cmdarg === 'gm' ? 'gm ' : '') + 'identify' + wrap(self.filename, true), function(err, stdout) {
+
+		if (err) {
+			callback(err, null);
+			return;
+		}
+
+		var arr = stdout.split(' ');
+		var size = arr[2].split('x');
+		var obj = { type: arr[1], width: F.TUtils.parseInt(size[0]), height: F.TUtils.parseInt(size[1]) };
+		callback(null, obj);
+	});
+
+	return self;
+};
+
+ImageProto.$$identify = function() {
+	var self = this;
+	return function(callback) {
+		self.identify(callback);
+	};
+};
+
+ImageProto.push = function(key, value, priority, encode) {
+	var self = this;
+	var cmd = key;
+
+	if (value != null) {
+		if (encode && typeof(value) === 'string')
+			cmd += ' ' + D + value.replace(REG_ESCAPE, '') + D;
+		else
+			cmd += ' ' + value;
+	}
+
+	var obj = F.temporary.images[cmd];
+	if (obj) {
+		obj.priority = priority;
+		self.builder.push(obj);
+	} else {
+		F.temporary.images[cmd] = { cmd: cmd, priority: priority };
+		self.builder.push(F.temporary.images[cmd]);
+	}
+
+	return self;
+};
+
+ImageProto.output = function(type) {
+	var self = this;
+	if (type[0] === '.')
+		type = type.substring(1);
+	self.type = type;
+	return self;
+};
+
+ImageProto.resize = function(w, h, options) {
+	options = options || '';
+
+	var self = this;
+	var size = '';
+
+	if (w && h)
+		size = w + 'x' + h;
+	else if (w && !h)
+		size = w + 'x';
+	else if (!w && h)
+		size = 'x' + h;
+
+	return self.push('-resize', size + options, 1, true);
+};
+
+ImageProto.thumbnail = function(w, h, options) {
+	options = options || '';
+
+	var self = this;
+	var size = '';
+
+	if (w && h)
+		size = w + 'x' + h;
+	else if (w && !h)
+		size = w;
+	else if (!w && h)
+		size = 'x' + h;
+
+	return self.push('-thumbnail', size + options, 1, true);
+};
+
+ImageProto.geometry = function(w, h, options) {
+	options = options || '';
+
+	var self = this;
+	var size = '';
+
+	if (w && h)
+		size = w + 'x' + h;
+	else if (w && !h)
+		size = w;
+	else if (!w && h)
+		size = 'x' + h;
+
+	return self.push('-geometry', size + options, 1, true);
+};
+
+
+ImageProto.filter = function(type) {
+	return this.push('-filter', type, 1, true);
+};
+
+ImageProto.trim = function() {
+	return this.push('-trim +repage', 1);
+};
+
+ImageProto.limit = function(type, value) {
+	this.islimit = true;
+	return this.push('-limit', type + ' ' + value, 1);
+};
+
+ImageProto.extent = function(w, h, x, y) {
+
+	var self = this;
+	var size = '';
+
+	if (w && h)
+		size = w + 'x' + h;
+	else if (w && !h)
+		size = w;
+	else if (!w && h)
+		size = 'x' + h;
+
+	if (x || y) {
+		!x && (x = 0);
+		!y && (y = 0);
+		size += (x >= 0 ? '+' : '') + x + (y >= 0 ? '+' : '') + y;
+	}
+
+	return self.push('-extent', size, 4, true);
+};
+
+/**
+ * Resize picture to miniature (full picture)
+ * @param {Number} w
+ * @param {Number} h
+ * @param {String} color Optional, background color.
+ * @param {String} filter Optional, resize filter (default: Box)
+ * @return {Image}
+ */
+ImageProto.miniature = function(w, h, color, filter) {
+	return this.filter(filter || 'Hamming').thumbnail(w, h).background(color ? color : 'white').align('center').extent(w, h);
+};
+
+/**
+ * Resize picture to center
+ * @param {Number} w
+ * @param {Number} h
+ * @param {String} color Optional, background color.
+ * @return {Image}
+ */
+ImageProto.resizeCenter = ImageProto.resize_center = function(w, h, color) {
+	return this.resize(w, h, '^').background(color ? color : 'white').align('center').crop(w, h);
+};
+
+/**
+ * Resize picture to align
+ * @param {Number} w
+ * @param {Number} h
+ * @param {String} align (top, center, bottom)
+ * @param {String} color Optional, background color.
+ * @return {Image}
+ */
+ImageProto.resizeAlign = ImageProto.resize_align = function(w, h, align, color) {
+	return this.resize(w, h, '^').background(color ? color : 'white').align(align || 'center').crop(w, h);
+};
+
+ImageProto.scale = function(w, h, options) {
+	options = options || '';
+
+	var self = this;
+	var size = '';
+
+	if (w && h)
+		size = w + 'x' + h;
+	else if (w && !h)
+		size = w;
+	else if (!w && h)
+		size = 'x' + h;
+
+	return self.push('-scale', size + options, 1, true);
+};
+
+ImageProto.crop = function(w, h, x, y) {
+	return this.push('-crop', w + 'x' + h + '+' + (x || 0) + '+' + (y || 0), 4, true);
+};
+
+ImageProto.quality = function(percentage) {
+	return this.push('-quality', percentage || 80, 5, true);
+};
+
+ImageProto.align = function(type) {
+
+	var output;
+
+	switch (type) {
+		case 'left top':
+		case 'top left':
+			output = 'NorthWest';
+			break;
+		case 'left bottom':
+		case 'bottom left':
+			output = 'SouthWest';
+			break;
+		case 'right top':
+		case 'top right':
+			output = 'NorthEast';
+			break;
+		case 'right bottom':
+		case 'bottom right':
+			output = 'SouthEast';
+			break;
+		case 'left center':
+		case 'center left':
+		case 'left':
+			output = 'West';
+			break;
+		case 'right center':
+		case 'center right':
+		case 'right':
+			output = 'East';
+			break;
+		case 'bottom center':
+		case 'center bottom':
+		case 'bottom':
+			output = 'South';
+			break;
+		case 'top center':
+		case 'center top':
+		case 'top':
+			output = 'North';
+			break;
+		case 'center center':
+		case 'center':
+		case 'middle':
+			output = 'Center';
+			break;
+		default:
+			output = type;
+			break;
+	}
+
+	output && this.push('-gravity', output, 3, true);
+	return this;
+};
+
+ImageProto.gravity = function(type) {
+	return this.align(type);
+};
+
+ImageProto.blur = function(radius) {
+	return this.push('-blur', radius, 10, true);
+};
+
+ImageProto.normalize = function() {
+	return this.push('-normalize', null, 10);
+};
+
+ImageProto.rotate = function(deg) {
+	return this.push('-rotate', deg || 0, 8, true);
+};
+
+ImageProto.flip = function() {
+	return this.push('-flip', null, 10);
+};
+
+ImageProto.flop = function() {
+	return this.push('-flop', null, 10);
+};
+
+ImageProto.define = function(value) {
+	return this.push('-define', value, 10, true);
+};
+
+ImageProto.minify = function() {
+	return this.push('+profile', '*', null, 10, true);
+};
+
+ImageProto.grayscale = function() {
+	return this.push('-colorspace', 'Gray', 10, true);
+};
+
+ImageProto.bitdepth = function(value) {
+	return this.push('-depth', value, 10, true);
+};
+
+ImageProto.colors = function(value) {
+	return this.push('-colors', value, 10, true);
+};
+
+ImageProto.background = function(color) {
+	return this.push('-background', color, 2, true).push('-extent 0x0', null, 2);
+};
+
+ImageProto.fill = function(color) {
+	return this.push('-fill', color, 2, true);
+};
+
+ImageProto.sepia = function() {
+	return this.push('-modulate', '115,0,100', 4).push('-colorize', '7,21,50', 5);
+};
+
+ImageProto.watermark = function(filename, x, y, w, h) {
+	return this.push('-draw', 'image over {1},{2} {3},{4} {5}{0}{5}'.format(filename, x || 0, y || 0, w || 0, h || 0, D), 6, true);
+};
+
+ImageProto.make = function(fn) {
+	fn.call(this, this);
+	return this;
+};
+
+ImageProto.command = function(key, value, priority, esc) {
+
+	if (priority === true) {
+		priority = 0;
+		esc = true;
+	}
+
+	return this.push(key, value, priority || 10, esc);
+};
+
+function wrap(command, empty) {
+	return (empty ? ' ' : '') + (command === '-' ? command : (D + command.replace(REG_ESCAPE, '') + D));
+}
+
+exports.Image = Image;
+exports.Picture = Image;
+
+exports.init = function(filename, cmd, width, height) {
+	return new Image(filename, cmd, width, height);
+};
+
+exports.load = function(filename, cmd, width, height) {
+	return new Image(filename, cmd, width, height);
+};
+
+exports.middleware = function(type, fn) {
+	if (type[0] === '.')
+		type = type.substring(1);
+	F.routes.imagemiddleware[type] = fn;
+};
+
+global.Image = exports;