Package Exports
- glaciall-bitmap
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (glaciall-bitmap) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
jsBitmap
基于Javascript的bitmap处理,并且将位图输出为base64编码以便于浏览器进行显示,代码超精简,低内存占用。
Install
npm install --save glaciall-bitmap
Usage
import {
BitMap,
} from 'glaciall-bitmap';
export class YourReactClass extends React.PureComponent {
constructor(props, ctx) {
super(props, ctx);
this.bmp = new BitMap();
this.bmp.fromBase64(props.base64Bmp.replace(/^data:image\/bmp;base64,/, ''));
}
}
API参考
一、Bitmap.create(width, height, bgcolor)
创建一个width x height像素大小的位图,底色为bgcolor所代表的颜色。
如:bitmap.create(10, 10, 0xff0000); // 创建一个10 x 10像素的底色为红色的位图
二、Bitmap.toBase64()
将位图输出为base64编码的带datauri头(data:image/bmp;base64,)的字符串,以便于在浏览器里显示。
如:document.getElementById('img1').src = bitmap.toBase64();
三、Bitmap.fromBase64()
自图像的BASE64编码中恢复位图数据,目前只支持24位色的BMP位图数据。
如:bitmap.fromBase64('Qk06AAAAAAAAADYAAAAoAAAAAQAAAAEAAAABABgAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA==');
四、Bitmap.setBitmapBytes(val, idx, length)
修改bitmap位图数据的第idx位置起的length字节为val值。
五、Bitmap.getBitmapBytes(idx, length)
获取bitmap位图数据的第idx位置起的length个字节的值,返回值为数组。
六、Bitmap.setHeaderValue(attribute, headerValue)
设置attribute头属性的值为headerValue,attribute必须为BitMapFormat的成员属性,需要提供offset、length等属性值。
如:bitmap.setHeaderValue(BitmapFormat.biWidth, 500); // 设置位图的宽度为500像素值
七、Bitmap.getHeaderValue(attribute)
获取位图attribute头属性的值,attribute必须为BitmapFormat的成员属性,需要提供offset、length等属性值,返回的是经过Endian转换后的实际整数值。
八、Bitmap.setPixel(x, y, color)
设置位图的(x, y)位置的像素值为color。
九、Bitmap.getPixel(x, y)
获取位图的(x, y)位置的RGB值,返回的内容为[ rr, gg, bb ]的数组内容
十、Bitmap.getRgbRect()
预先使用 getPixel() 生成RGB数值的二维数组,便于调用者稍后以之快速定位像素,因为查表的速度远高于即时计算 getPixel()
返回的内容为[ [0xrrggbb, 0xrrggbb], [0xrrggbb, 0xrrggbb] ]的[[x维],[x维]]二维数组内容
如果位图原始数据被比如 setPixel() 修改了,则需要重新调用本函数来更新RGB二维数组
十一、Bitmap.rgbToHexString(rgb)
将 0xrrggbb 转换为 '#rrggbb'
PS
glaciall authorized flyskywhy to publish glaciall-bitmap on npm.