Преоразмеряване и преобразуване на изображения
Total.js обработва изображенията, като извиква GraphicsMagick (gm) или ImageMagick, които трябва да са инсталирани на сървъра (brew install graphicsmagick, apt install graphicsmagick). Настройката $imageconverter избира програмата: gm (по подразбиране), im или magick.
Image.load(filename) (или Buffer, или поток) връща верига, която записва операциите и ги изпълнява, когато извикате .save(filename, callback). Полезните операции са resize(width, height) (запазва пропорциите в рамката), thumbnail(width, height) (бърз малък преглед), miniature(width, height) (побира изображението в рамката и запълва останалото с фона), crop(width, height, x, y), rotate(degrees), grayscale(), blur(radius), quality(percentage) и output('jpg') за преобразуване на формата. При качените файлове става директно: file.image() в обработчик на @upload маршрути връща същата верига.
За четенето на размера не е нужен GraphicsMagick: Image.measure('png', buffer) връща { width, height } от първите байтове на данни PNG, JPG, GIF и WebP.
$.image(options) е за маршрут, който създава изображение при поискване: ext е форматът, load(next) предава източника (поток или път) с next(...), image(img) описва операциите, а cache е име, под което резултатът се пази в tmp/ за следващите заявки.
const Zlib = require('zlib');
const Fs = require('fs');
exports.install = function() {
ROUTE('GET /resize/', resize);
ROUTE('GET /thumb/', thumb);
};
// Builds a solid red PNG so that the example needs no file
function makepng(width, height) {
function chunk(type, data) {
var length = Buffer.alloc(4);
length.writeUInt32BE(data.length);
var body = Buffer.concat([Buffer.from(type), data]);
var crc = Buffer.alloc(4);
crc.writeUInt32BE(Zlib.crc32(body));
return Buffer.concat([length, body, crc]);
}
var header = Buffer.alloc(13);
header.writeUInt32BE(width, 0);
header.writeUInt32BE(height, 4);
header[8] = 8; // bit depth
header[9] = 2; // RGB
var row = Buffer.alloc(1 + width * 3);
for (var x = 0; x < width; x++)
row[1 + x * 3] = 255;
var raw = Buffer.concat(Array(height).fill(row));
return Buffer.concat([
Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]),
chunk('IHDR', header),
chunk('IDAT', Zlib.deflateSync(raw)),
chunk('IEND', Buffer.alloc(0))
]);
}
function source() {
var filename = PATH.tmp('source.png');
Fs.writeFileSync(filename, makepng(200, 100));
return filename;
}
function resize($) {
var target = PATH.tmp('small.jpg');
Image.load(source()).resize(50, 50).output('jpg').save(target, function(err) {
if (err) {
$.invalid(err);
return;
}
var size = Image.measure('jpg', Fs.readFileSync(target));
$.json({ width: size.width, height: size.height, original: Image.measure('png', Fs.readFileSync(source())) });
});
}
function thumb($) {
$.image({
ext: 'png',
cache: 'thumb-example',
load: function(next) {
next(Fs.createReadStream(source()));
},
image: function(img) {
img.resize(40, 40);
}
});
}