场景介绍

图像解码就是将所支持格式的存档图片解码成统一的 PixelMap 图像，用于后续图像显示或其他处理，比如旋转、缩放、裁剪等。当前支持格式包括 JPEG、PNG、GIF、HEIF、WebP、BMP。

接口说明

ImageSource 主要用于图像解码。

普通解码开发步骤

1. 创建图像数据源 ImageSource 对象，可以通过 SourceOptions 指定数据源的格式信息，此格式信息仅为给解码器的提示，正确提供能帮助提高解码效率，如果不设置或设置不正确，会自动检测正确的图像格式。不使用该选项时，可以将 create 接口传入的 SourceOptions 设置为 null。

   ImageSource.SourceOptions srcOpts = new ImageSource.SourceOptions();
   srcOpts.formatHint = "image/png";
   String pathName = "/path/to/image.png";
   ImageSource imageSource = ImageSource.create(pathName, srcOpts);
   ImageSource imageSourceNoOptions = ImageSource.create(pathName, null);

1. 设置解码参数，解码获取 PixelMap 图像对象，解码过程中同时支持图像处理操作。设置 desiredRegion 支持按矩形区域裁剪，如果设置为全 0，则不进行裁剪。设置 desiredSize 支持按尺寸缩放，如果设置为全 0，则不进行缩放。设置 rotateDegrees 支持旋转角度，以图像中心点顺时针旋转。如果只需要解码原始图像，不使用该选项时，可将给 createPixelMap 传入的 DecodingOptions 设置为 null。

   // 普通解码叠加旋转、缩放、裁剪
   ImageSource.DecodingOptions decodingOpts = new ImageSource.DecodingOptions();
   decodingOpts.desiredSize = new Size(100, 2000);
   decodingOpts.desiredRegion = new Rect(0, 0, 100, 100);
   decodingOpts.rotateDegrees = 90;
   PixelMap pixelMap = imageSource.createPixelmap(decodingOpts); 

    
   // 普通解码
   PixelMap pixelMapNoOptions = imageSource.createPixelmap(null);

1. 解码完成获取到 PixelMap 对象后，可以进行后续处理，比如渲染显示等。

渐进式解码开发步骤

1. 创建渐进式图像数据源 ImageSource 对象，可以通过 SourceOptions 指定数据源的格式信息，此格式信息仅为提示，如果填写不正确，会自动检测正确的图像格式，使用 IncrementalSourceOptions 指定图像数据的更新方式为渐进式更新。

   ImageSource.SourceOptions srcOpts = new ImageSource.SourceOptions();
   srcOpts.formatHint = "image/jpeg";
   ImageSource.IncrementalSourceOptions incOpts = new ImageSource.IncrementalSourceOptions();
   incOpts.opts = srcOpts;
   incOpts.mode = ImageSource.UpdateMode.INCREMENTAL_DATA;
   imageSource = ImageSource.createIncrementalSource(incOpts);

1. 渐进式更新数据，在未获取到全部图像时，支持先更新部分数据来尝试解码，更新数据时设置 isFinal 为 false，当获取到全部数据后，最后一次更新数据时设置 isFinal 为 true，表示数据更新完毕。设置解码参数同普通解码。

   // 获取到一定的数据时尝试解码
   imageSource.updateData(data, 0, bytes, false);
   ImageSource.DecodingOptions decodingOpts = new ImageSource.DecodingOptions();
   PixelMap pixelMap = imageSource.createPixelmap(decodingOpts);

    
   // 更新数据再次解码，重复调用直到数据全部更新完成
   imageSource.updateData(data, 0, bytes, false);
   PixelMap pixelMap = imageSource.createPixelmap(decodingOpts);

    
   // 数据全部更新完成时需要传入isFinal为true
   imageSource.updateData(data, 0, bytes, true);
   PixelMap pixelMap = imageSource.createPixelmap(decodingOpts);

1. 解码完成获取到 PixelMap 对象后，可以进行后续处理，比如渲染显示等。