Flutter的 Image Widget

源碼:image.dart

圖片的顯示

class Image extends StatefulWidget

Image 繼承自 [StatefulWidget],它是具有狀態(tài)的猴蹂,通過

@override///image.dart 574L 
_ImageState createState() => _ImageState();

可以找到 Image對應(yīng)的State類是 _ImageState 桂塞, 那么構(gòu)建Widget的方法就在_ImageStatebuild方法中虑椎,如下:

  @override
  Widget build(BuildContext context) {
    final RawImage image = RawImage(
      image: _imageInfo?.image,
      width: widget.width,
      height: widget.height,
      scale: _imageInfo?.scale ?? 1.0,
      color: widget.color,
      colorBlendMode: widget.colorBlendMode,
      fit: widget.fit,
      alignment: widget.alignment,
      repeat: widget.repeat,
      centerSlice: widget.centerSlice,
      matchTextDirection: widget.matchTextDirection,
      invertColors: _invertColors,
      filterQuality: widget.filterQuality,
    );
    if (widget.excludeFromSemantics)
      return image;
    return Semantics(
      container: widget.semanticLabel != null,
      image: true,
      label: widget.semanticLabel == null ? '' : widget.semanticLabel,
      child: image,
    );
  }

由源碼可以看到瘟芝,在此方法中創(chuàng)建的是 RawImage widget ,傳入 imageInfo.image覆醇,并由 RawImage來渲染圖片數(shù)據(jù)绅喉。

圖片的加載

Image 類有這么幾個構(gòu)造方法,方便開發(fā)者加載顯示本地叫乌,文件,網(wǎng)絡(luò)中的圖片數(shù)據(jù)徽缚。

///  * [new Image], for obtaining an image from an [ImageProvider].
///  * [new Image.asset], for obtaining an image from an [AssetBundle]
///    using a key.
///  * [new Image.network], for obtaining an image from a URL.
///  * [new Image.file], for obtaining an image from a [File].
///  * [new Image.memory], for obtaining an image from a [Uint8List].

Image 加載了圖片數(shù)據(jù)后存儲在 imageInfo.image憨奸。ImageInfo類很簡單,只有兩個屬性:


@immutable
class ImageInfo {
  //圖片像素點陣凿试,
  final ui.Image image;
  //縮放比例排宰,例當(dāng)scale為2時,寬高都將變?yōu)樵瓐D的2倍那婉。
  final double scale;
}

imageInfo又是在哪生成的呢板甘,也就是在哪加載了圖片的數(shù)據(jù)呢?根據(jù) ImageInfo類的注釋详炬, ImageInfo 一旦被獲得盐类,就會被 ImageStream 用來表示為真實的圖片數(shù)據(jù)。

ImageStream的部分源碼如下:

class ImageStream extends Diagnosticable {
  /// Create an initially unbound image stream.
  ///
  /// Once an [ImageStreamCompleter] is available, call [setCompleter].
  ImageStream();

  /// The completer that has been assigned to this image stream.
  ///
  /// Generally there is no need to deal with the completer directly.
  ImageStreamCompleter get completer => _completer;
  ImageStreamCompleter _completer;

可見 ImageStream 主要是由 ImageStreamCompleter 來提供支持呛谜,只是一個 ImageStreamCompleter的包裝類在跳,不過當(dāng)ImageStreamCompleter可用的時候,需調(diào)用ImageStream.setCompleter方法隐岛,以將事件傳遞給ImageStream中的監(jiān)聽者猫妙。

那么 ImageStreamCompleter又是個啥?繼續(xù)往下看聚凹,源碼:

/// Base class for those that manage the loading of [dart:ui.Image] objects for
/// [ImageStream]s.
///
/// [ImageStreamListener] objects are rarely constructed directly. Generally, an
/// [ImageProvider] subclass will return an [ImageStream] and automatically
/// configure it with the right [ImageStreamCompleter] when possible.
abstract class ImageStreamCompleter extends Diagnosticable {
  final List<_ImageListenerPair> _listeners = <_ImageListenerPair>[];
  ImageInfo _currentImage;

  void addListener(ImageListener listener, { ImageErrorListener onError }) {
      //省略
  }

  void removeListener(ImageListener listener) {
      //省略
  }

  /// Calls all the registered listeners to notify them of a new image.
  @protected
  void setImage(ImageInfo image) {
    _currentImage = image;
    if (_listeners.isEmpty)
      return;
    final List<ImageListener> localListeners = _listeners.map<ImageListener>(
      (_ImageListenerPair listenerPair) => listenerPair.listener
    ).toList();
    for (ImageListener listener in localListeners) {
      try {
        listener(image, false);
      } catch (exception, stack) {
        reportError(
          context: 'by an image listener',
          exception: exception,
          stack: stack,
        );
      }
    }
  }
}

ImageStreamCompleter是一個抽象類割坠。去掉添加/移除Listener的方法后,還剩一個 [setImage] 方法彼哼,方法內(nèi)部邏輯很簡單对妄,將傳入的參數(shù) ImageInfo 傳遞到各個 ImageListener,然后刷新GUI沪羔。

ImageStreamCompleter有兩個實現(xiàn)類饥伊,分別為

  • OneFrameImageStreamCompleter

  • MultiFrameImageStreamCompleter

那剛才看下來的源碼只是一個監(jiān)聽的設(shè)計而已:

widget監(jiān)聽 ImageStream , 而widget設(shè)置給ImageStreamlistener 被傳遞到 ImageStreamCompleter蔫饰。當(dāng)圖片成功加載時琅豆,ImageStreamCompletersetImage方法被調(diào)用,圖片通過回調(diào)回傳到 widget篓吁。

圖片的加載2

Image類構(gòu)造方法需傳入一個 ImageProvider茫因,圖片應(yīng)便是在這里面被加載的:

abstract class ImageProvider<T> {

  ///根據(jù) configuration 處理 ImagePrivoder,并返回一個 ImageStream對象
  ///子類應(yīng)該實現(xiàn) [obtainKey] 和 [load] 方法,并且這兩個方法在此流程中使用
  ImageStream resolve(ImageConfiguration configuration) {
    assert(configuration != null);
    final ImageStream stream = ImageStream();
    T obtainedKey;
    obtainKey(configuration).then<void>((T key) {
      obtainedKey = key;
      ///當(dāng)拿到KEY時杖剪,查詢緩存
      stream.setCompleter(PaintingBinding.instance.imageCache.putIfAbsent(key, () => load(key)));
    }).catchError(
        //省略錯誤處理...
        return null;
      }
    );
    return stream;
  }

  /// 根據(jù) ImageConfiguration和 ImageProvider 的屬性來生成一個KEY用來標(biāo)識加載的圖片
  /// KEY要求實現(xiàn) '==' 和 hascode 方法冻押,這個KEY主要是用于緩存
  @protected
  Future<T> obtainKey(ImageConfiguration configuration);

  ///開始加載圖片
  @protected
  ImageStreamCompleter load(T key);
}

其中 resolve方法根據(jù)ImageConfiguration來獲取相應(yīng)的ImageStream

到目前為止盛嘿,圖片獲取的流程應(yīng)該差不多可以這樣來表示...

image.png

圖片的緩存

ImageProvider的源碼中能過看到洛巢,圖片的加載是做過緩存處理的。即在ImageProviderresolve方法中次兆,有這么一句:

stream.setCompleter(PaintingBinding.instance.imageCache.putIfAbsent(key, () => load(key)));

1. KEY

image.putIfAbsent傳入的 key 的類型即為ImageProvider<T>中的T稿茉,需是不可改變的(immutable)以及實現(xiàn)[==] 和 [hashcode]方法。并且由 ImageProvider.obtainKey方法生成芥炭,例如NetworkImage中是這么實現(xiàn)的:

class NetworkImage extends ImageProvider<NetworkImage> {
  @override
  Future<NetworkImage> obtainKey(ImageConfiguration configuration) {
    return SynchronousFuture<NetworkImage>(this);
  }
  @override
  bool operator ==(dynamic other) {
    if (other.runtimeType != runtimeType)
      return false;
    final NetworkImage typedOther = other;
    return url == typedOther.url
        && scale == typedOther.scale;
  }

  @override
  int get hashCode => hashValues(url, scale);
}

2.ImageCache

緩存的邏輯主要在 putIfAbent方法中

使用的 LRU漓库,并且默認(rèn)最多存儲 1000個緩存,最大緩存限制為100MiB

const int _kDefaultSize = 1000;
const int _kDefaultSizeBytes = 100 << 20; // 100 MiB

目前的圖片大小是這么計算的:

final int imageSize = info?.image == null ? 0 : info.image.height * info.image.width * 4;

3.緩存

由上代碼可以看出园蝠,flutter 自帶的緩存只會在運行期間生效渺蒿,也就是緩存在內(nèi)存中。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末彪薛,一起剝皮案震驚了整個濱河市茂装,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌善延,老刑警劉巖训唱,帶你破解...
    沈念sama閱讀 217,185評論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異挚冤,居然都是意外死亡况增,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,652評論 3 393
  • 文/潘曉璐 我一進(jìn)店門训挡,熙熙樓的掌柜王于貴愁眉苦臉地迎上來澳骤,“玉大人歧强,你說我怎么就攤上這事∥梗” “怎么了摊册?”我有些...
    開封第一講書人閱讀 163,524評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長颊艳。 經(jīng)常有香客問我茅特,道長,這世上最難降的妖魔是什么棋枕? 我笑而不...
    開封第一講書人閱讀 58,339評論 1 293
  • 正文 為了忘掉前任白修,我火速辦了婚禮,結(jié)果婚禮上重斑,老公的妹妹穿的比我還像新娘兵睛。我一直安慰自己,他們只是感情好窥浪,可當(dāng)我...
    茶點故事閱讀 67,387評論 6 391
  • 文/花漫 我一把揭開白布祖很。 她就那樣靜靜地躺著,像睡著了一般漾脂。 火紅的嫁衣襯著肌膚如雪假颇。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,287評論 1 301
  • 那天骨稿,我揣著相機與錄音笨鸡,去河邊找鬼。 笑死啊终,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的傲须。 我是一名探鬼主播蓝牲,決...
    沈念sama閱讀 40,130評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼泰讽!你這毒婦竟也來了例衍?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 38,985評論 0 275
  • 序言:老撾萬榮一對情侶失蹤已卸,失蹤者是張志新(化名)和其女友劉穎佛玄,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體累澡,經(jīng)...
    沈念sama閱讀 45,420評論 1 313
  • 正文 獨居荒郊野嶺守林人離奇死亡梦抢,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,617評論 3 334
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了愧哟。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片奥吩。...
    茶點故事閱讀 39,779評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡哼蛆,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出霞赫,到底是詐尸還是另有隱情腮介,我是刑警寧澤,帶...
    沈念sama閱讀 35,477評論 5 345
  • 正文 年R本政府宣布端衰,位于F島的核電站叠洗,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏旅东。R本人自食惡果不足惜灭抑,卻給世界環(huán)境...
    茶點故事閱讀 41,088評論 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望玉锌。 院中可真熱鬧名挥,春花似錦、人聲如沸主守。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,716評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽参淫。三九已至救湖,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間涎才,已是汗流浹背鞋既。 一陣腳步聲響...
    開封第一講書人閱讀 32,857評論 1 269
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留耍铜,地道東北人邑闺。 一個月前我還...
    沈念sama閱讀 47,876評論 2 370
  • 正文 我出身青樓,卻偏偏與公主長得像棕兼,于是被迫代替她去往敵國和親陡舅。 傳聞我的和親對象是個殘疾皇子培廓,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,700評論 2 354

推薦閱讀更多精彩內(nèi)容