Cross-platform image decoder(png/jpeg/gif) and encoder(png/jpeg) for Node.js

node.js輕量級(jí)跨平臺(tái)圖像編解碼庫(kù)

var images = require("images");

images("input.jpg")           //Load image from file 
                    //加載圖像文件
  .size(400)             //Geometric scaling the image to 400 pixels width
                    //等比縮放圖像到400像素寬
  .draw(images("logo.png"), 10, 10)  //Drawn logo at coordinates (10,10)
                    //在(10,10)處繪制Logo
  .save("output.jpg", {        //Save the image to a file,whih quality 50
    quality : 50          //保存圖片到文件,圖片質(zhì)量為50
  });

Features 功能特性

1. Lightweight:no need to install any image processing library.
2. 輕量級(jí)：無(wú)需安裝任何圖像處理庫(kù)。
3. Cross-platform: Released a compiled .node file on windows, just download and start.
4. 跨平臺(tái)：Windows下發(fā)布了編譯好的.node文件,下載就能用。
5. Easy-to-use: Provide jQuery-like chaining API.Simple and reliable!
6. 方便用：jQuery風(fēng)格的API，簡(jiǎn)單可依賴。

Installation 安裝

$ npm install images

API 接口

node-images provide jQuery-like Chaining API,You can start the chain like this:

node-images 提供了類似jQuery的鏈?zhǔn)秸{(diào)用API,您可以這樣開始:

/* Load and decode image from file */
/* 從指定文件加載并解碼圖像 */
images(file)

/* Create a new transparent image */
/* 創(chuàng)建一個(gè)指定寬高的透明圖像 */
images(width, height)

/* Load and decode image from a buffer */
/* 從Buffer數(shù)據(jù)中解碼圖像 */
images(buffer[, start[, end]])

/* Copy from another image */
/* 從另一個(gè)圖像中復(fù)制區(qū)域來(lái)創(chuàng)建圖像 */
images(image[, x, y, width, height])

images(file)

Load and decode image from file從指定文件加載并解碼圖像

images(width, height)

Create a new transparent image創(chuàng)建一個(gè)指定寬高的透明圖像

images(buffer[, start[, end]])

Load and decode image from a buffer從Buffer數(shù)據(jù)中解碼圖像

images(image[, x, y, width, height])

Copy from another image從另一個(gè)圖像中復(fù)制區(qū)域來(lái)創(chuàng)建圖像

.fill(red, green, blue[, alpha])

eg:images(200, 100).fill(0xff, 0x00, 0x00, 0.5) Fill image with color以指定顏色填充圖像

.draw(image, x, y)

Draw image on the current image position( x , y )在當(dāng)前圖像( x , y )上繪制 image 圖像

.encode(type[, config])

eg:images("input.png").encode("jpg", {operation:50}) Encode image to buffer, config is image setting.

以指定格式編碼當(dāng)前圖像到Buffer，config為圖片設(shè)置，目前支持設(shè)置JPG圖像質(zhì)量

Return buffer

返回填充好的Buffer

Note:The operation will cut off the chain

注意:該操作將會(huì)切斷調(diào)用鏈

See:.save(file[, type[, config]]) 參考:.save(file[, type[, config]])

.save(file[, type[, config]])

eg:images("input.png").encode("output.jpg", {operation:50}) Encoding and save the current image to a file, if the type is not specified, type well be automatically determined according to the file, config is image setting. eg: { operation:50 }
編碼并保存當(dāng)前圖像到 file ,如果type未指定,則根據(jù) file 自動(dòng)判斷文件類型，config為圖片設(shè)置，目前支持設(shè)置JPG圖像質(zhì)量

.size([width[, height]])

Get size of the image or set the size of the image,if the height is not specified, then scaling based on the current width and height獲取或者設(shè)置圖像寬高，如果height未指定，則根據(jù)當(dāng)前寬高等比縮放

.resize(width[, height])

Set the size of the image,if the height is not specified, then scaling based on the current width and height

設(shè)置圖像寬高，如果height未指定，則根據(jù)當(dāng)前寬高等比縮放, 默認(rèn)采用 bicubic 算法。

.width([width])

Get width for the image or set width of the image獲取或設(shè)置圖像寬度

.height([height])

Get height for the image or set height of the image獲取或設(shè)置圖像高度

images.setLimit(width, height)

Set the limit size of each image  設(shè)置庫(kù)處理圖片的大小限制,設(shè)置后對(duì)所有新的操作生效(如果超限則拋出異常)

images.setGCThreshold(value)

Set the garbage collection threshold   設(shè)置圖像處理庫(kù)自動(dòng)gc的閾值(當(dāng)新增內(nèi)存使用超過該閾值時(shí)，執(zhí)行垃圾回收)

images.getUsedMemory()

Get used memory (in bytes)得到圖像處理庫(kù)占用的內(nèi)存大小(單位為字節(jié))

images.gc()

Forced call garbage collection 強(qiáng)制調(diào)用V8的垃圾回收機(jī)制

https://github.com/zhangyuanwei/node-images

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論