glaciall-bitmap

Manipulate bitmap image with pure JavaScript, and can be base64 format to display on web

Usage no npm install needed!

<script type="module">
  import glaciallBitmap from 'https://cdn.skypack.dev/glaciall-bitmap';
</script>

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.