Skip to content

UIImage:prepareForDisplay() 方法 ​

prepareForDisplay() 方法在后台把图片解码成像素,完成后给出一张可以直接显示的图。

图片对象取到时还没有解码。不调用这个方法时,解码发生在图片第一次显示的时候,和界面更新在同一个线程上进行。从网络下载的图片推荐都先调用它再显示,小图标不需要。

语法 ​

prepareForDisplay()

参数 ​

无。

返回值 ​

Promise,兑现成一张已经解码的 UIImage,尺寸和原图相同。系统解码失败时兑现成 null,所以使用前要判空,null 时退回使用原图。原图不变。

是动图时,所有的帧都被解码,结果仍然是动图,帧数、每帧时长、播放遍数和原图相同。

异常 ​

无。

示例 ​

js
async function decode() {
  const dot = UIImage.imageNamed('JS/assets/dot');
  if (dot === null) return;

  const ready = await dot.prepareForDisplay();
  if (ready) {
    console.log(ready.size.width === dot.size.width);
  }
}

decode();

结果:控制台输出 true。

对应的 iOS API ​

-[UIImage prepareForDisplayWithCompletionHandler:]。completion handler 换成了 Promise。

参见 ​