1.1.0 • Published 4 years ago

glaciall-bitmap v1.1.0

Weekly downloads
18
License
SEE LICENSE IN LI...
Repository
github
Last release
4 years ago

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.