阅读(4116) (1)

鸿蒙OS 位图操作开发指导

2020-09-17 09:22:37 更新

场景介绍

位图操作就是指对 PixelMap 图像进行相关的操作,比如创建、查询信息、读写像素数据等。

接口说明

接口名 描述
create(InitializationOptions opts) 根据图像大小、像素格式、alpha 类型等初始化选项创建 PixelMap。
create(int[] colors, InitializationOptions opts) 根据图像大小、像素格式、 alpha 类型等初始化选项,以像素颜色数组为数据源创建PixelMap。
create(int[] colors, int offset, int stride, InitializationOptions opts) 根据图像大小、像素格式、alpha 类型等初始化选项,以像素颜色数组、起始偏移量、行像素大小描述的数据源创建 PixelMap。
create(PixelMap source, InitializationOptions opts) 根据图像大小、像素格式、alpha 类型等初始化选项,以源 PixelMap 为数据源创建 PixelMap。
create(PixelMap source, Rect srcRegion, InitializationOptions opts) 根据图像大小、像素格式、alpha 类型等初始化选项,以源 PixelMap、源裁剪区域描述的数据源创建 PixelMap。
getBytesNumberPerRow() 获取每行像素数据占用的字节数。
getPixelBytesCapacity() 获取存储Pixelmap像素数据的内存容量。
isEditable() 判断 PixelMap 是否允许修改。
isSameImage(PixelMap other) 判断两个图像是否相同,包括 ImageInfo 属性信息和像素数据。
readPixel(Position pos) 读取指定位置像素的颜色值,返回的颜色格式为 PixelFormat.ARGB_8888。
readPixels(int[] pixels, int offset, int stride, Rect region) 读取指定区域像素的颜色值,输出到以起始偏移量、行像素大小描述的像素数组,返回的颜色格式为 PixelFormat.ARGB_8888。
readPixels(Buffer dst) 读取像素的颜色值到缓冲区,返回的数据是 PixelMap 中像素数据的原样拷贝,即返回的颜色数据格式与 PixelMap 中像素格式一致。
resetConfig(Size size, PixelFormat pixelFormat) 重置 PixelMap 的大小和像素格式配置,但不会改变原有的像素数据也不会重新分配像素数据的内存,重置后图像数据的字节数不能超过 PixelMap 的内存容量。
setAlphaType(AlphaType alphaType) 设置PixelMap的Alpha类型。
writePixel(Position pos, int color) 向指定位置像素写入颜色值,写入颜色格式为PixelFormat.ARGB_8888。
writePixels(int[] pixels, int offset, int stride, Rect region) 将像素颜色数组、起始偏移量、行像素的个数描述的源像素数据写入 PixelMap 的指定区域,写入颜色格式为 PixelFormat.ARGB_8888。
writePixels(Buffer src) 将缓冲区描述的源像素数据写入 PixelMap,写入的数据将原样覆盖 PixelMap 中的像素数据,即写入数据的颜色格式应与 PixelMap 的配置兼容。
writePixels(int color) 将所有像素都填充为指定的颜色值,写入颜色格式为 PixelFormat.ARGB_8888。
getPixelBytesNumber() 获取全部像素数据包含的字节数。
setBaseDensity(int baseDensity) 设置 PixelMap 的基础像素密度值。
getBaseDensity() 获取 PixelMap 的基础像素密度值。
setUseMipmap(boolean useMipmap) 设置 PixelMap 渲染是否使用mipmap。
useMipmap() 获取 PixelMap 渲染是否使用mipmap。
getNinePatchChunk() 获取图像的 NinePatchChunk 数据。
getFitDensitySize(int targetDensity) 获取适应目标像素密度的图像缩放的尺寸。
getImageInfo() 获取图像基本信息。
release() 释放对象关联的本地资源。

开发步骤

  1. 创建位图对象 PixelMap。

   // 指定初始化选项创建
   PixelMap pixelMap2 = PixelMap.create(initializationOptions);

    
   // 从像素颜色数组创建
   int[] defaultColors = new int[] {5, 5, 5, 5, 6, 6, 3, 3, 3, 0};
   PixelMap.InitializationOptions initializationOptions = new PixelMap.InitializationOptions();
   initializationOptions.size = new Size(3, 2);
   initializationOptions.pixelFormat = PixelFormat.ARGB_8888;
   PixelMap pixelMap1 = PixelMap.create(defaultColors, initializationOptions);

    
   // 以另外一个PixelMap作为数据源创建
   PixelMap pixelMap3 = PixelMap.create(pixelMap2, initializationOptions);

  1. 从位图对象中获取信息。

   long capacity = pixelMap.getPixelBytesCapacity();
   long bytesNumber = pixelMap.getPixelBytesNumber();
   int rowBytes = pixelMap.getBytesNumberPerRow();
   byte[] ninePatchData = pixelMap.getNinePatchChunk();

  1. 读写位图像素数据。

   // 读取指定位置像素
   int color = pixelMap.readPixel(new Position(1, 1));

    
   // 读取指定区域像素
   int[] pixelArray = new int[50];
   Rect region = new Rect(0, 0, 10, 5);
   pixelMap.readPixels(pixelArray, 0, 10, region);

    
   // 读取像素到Buffer
   IntBuffer pixelBuf = IntBuffer.allocate(50);
   pixelMap.readPixels(pixelBuf);

    
   // 在指定位置写入像素
   pixelMap.writePixel(new Position(1, 1), 0xFF112233);

    
   // 在指定区域写入像素
   pixelMap.writePixels(pixelArray, 0, 10, region);

    
   // 写入Buffer中的像素
   pixelMap.writePixels(intBuf);