JSPM

glaciall-bitmap

1.1.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 30
  • Score
    100M100P100Q49714F
  • License SEE LICENSE IN LICENSE

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

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.