鴻蒙OS 圖像解碼開(kāi)發(fā)指導(dǎo)

場(chǎng)景介紹

圖像解碼就是將所支持格式的存檔圖片解碼成統(tǒng)一的 PixelMap 圖像，用于后續(xù)圖像顯示或其他處理，比如旋轉(zhuǎn)、縮放、裁剪等。當(dāng)前支持格式包括 JPEG、PNG、GIF、HEIF、WebP、BMP。

接口說(shuō)明

ImageSource 主要用于圖像解碼。

普通解碼開(kāi)發(fā)步驟

1. 創(chuàng)建圖像數(shù)據(jù)源 ImageSource 對(duì)象，可以通過(guò) SourceOptions 指定數(shù)據(jù)源的格式信息，此格式信息僅為給解碼器的提示，正確提供能幫助提高解碼效率，如果不設(shè)置或設(shè)置不正確，會(huì)自動(dòng)檢測(cè)正確的圖像格式。不使用該選項(xiàng)時(shí)，可以將 create 接口傳入的 SourceOptions 設(shè)置為 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. 設(shè)置解碼參數(shù)，解碼獲取 PixelMap 圖像對(duì)象，解碼過(guò)程中同時(shí)支持圖像處理操作。設(shè)置 desiredRegion 支持按矩形區(qū)域裁剪，如果設(shè)置為全 0，則不進(jìn)行裁剪。設(shè)置 desiredSize 支持按尺寸縮放，如果設(shè)置為全 0，則不進(jìn)行縮放。設(shè)置 rotateDegrees 支持旋轉(zhuǎn)角度，以圖像中心點(diǎn)順時(shí)針旋轉(zhuǎn)。如果只需要解碼原始圖像，不使用該選項(xiàng)時(shí)，可將給 createPixelMap 傳入的 DecodingOptions 設(shè)置為 null。

   // 普通解碼疊加旋轉(zhuǎn)、縮放、裁剪
   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 對(duì)象后，可以進(jìn)行后續(xù)處理，比如渲染顯示等。

漸進(jìn)式解碼開(kāi)發(fā)步驟

1. 創(chuàng)建漸進(jìn)式圖像數(shù)據(jù)源 ImageSource 對(duì)象，可以通過(guò) SourceOptions 指定數(shù)據(jù)源的格式信息，此格式信息僅為提示，如果填寫(xiě)不正確，會(huì)自動(dòng)檢測(cè)正確的圖像格式，使用 IncrementalSourceOptions 指定圖像數(shù)據(jù)的更新方式為漸進(jìn)式更新。

   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. 漸進(jìn)式更新數(shù)據(jù)，在未獲取到全部圖像時(shí)，支持先更新部分?jǐn)?shù)據(jù)來(lái)嘗試解碼，更新數(shù)據(jù)時(shí)設(shè)置 isFinal 為 false，當(dāng)獲取到全部數(shù)據(jù)后，最后一次更新數(shù)據(jù)時(shí)設(shè)置 isFinal 為 true，表示數(shù)據(jù)更新完畢。設(shè)置解碼參數(shù)同普通解碼。

   // 獲取到一定的數(shù)據(jù)時(shí)嘗試解碼
   imageSource.updateData(data, 0, bytes, false);
   ImageSource.DecodingOptions decodingOpts = new ImageSource.DecodingOptions();
   PixelMap pixelMap = imageSource.createPixelmap(decodingOpts);

    
   // 更新數(shù)據(jù)再次解碼，重復(fù)調(diào)用直到數(shù)據(jù)全部更新完成
   imageSource.updateData(data, 0, bytes, false);
   PixelMap pixelMap = imageSource.createPixelmap(decodingOpts);

    
   // 數(shù)據(jù)全部更新完成時(shí)需要傳入isFinal為true
   imageSource.updateData(data, 0, bytes, true);
   PixelMap pixelMap = imageSource.createPixelmap(decodingOpts);

1. 解碼完成獲取到 PixelMap 對(duì)象后，可以進(jìn)行后續(xù)處理，比如渲染顯示等。