之前的圖片瀏覽器一直都是壓縮過的bitmap，在顯示一些長圖、高清原圖的時候就杯具了，全是馬賽克，後來需求來了，只好藉助第三方庫，功夫不負有心人，找到一個不錯的庫，功能也齊全，效果也好，現在就推薦給大家。

該庫的名字：SubsamplingScaleImageView(subsampling-scale-image-view)

下面我們來簡單的說說怎麼使用。

首先我們需要在 build.gradle 裡面加入依賴：

dependencies {

    ...

    compile 'com.davemorrissey.labs:subsampling-scale-image-view:3.6.0'
    
    ...
}
 

接著在佈局 XML 裡面跟普通的 imageview 一樣去使用：

<com.davemorrissey.labs.subscaleview.SubsamplingScaleImageView

    android:id="@+id/iv_pic"

    android:layout_width="match_parent"

    android:layout_height="match_parent"

    android:gravity="center" />
 

跟 imageview 不同的是在程式碼中的操作，先說圖片的載入顯示：

該庫有一個類，ImageSource，調出方法，可以看到有以下幾種：

ImageSource.asset(String assetName)

ImageSource.resource(int resId)

ImageSource.uri(String uri)

ImageSource.uri(Uri uri)

ImageSource.bitmap(Bitmap bitmap)

看方法名字不難理解，第一個是取 asset 目錄裡面的圖片，第二個是取 drawable 目錄裡面的，第三個是通過檔案路徑取，第四個是通過 Uri，最後一個則是直接顯示bitmap。

這裡我們需要注意最後一個，官方給出這樣的提示：

Or, if you have a Bitmap object in memory, load it into the view. This is unsuitable for large images because it bypasses subsampling - you may get an OutOfMemoryError.

大概意思就是說如果你通過 bitmap 的形式去載入顯示圖片，那麼你得處理 OOM ，因為這種形式會繞過該庫本身對圖片的處理，所以如果我們要顯示高清大圖，那麼請不要用最後一種。

接下來我們要把這個 ImageSource 傳給 view ，下面貼出以第三種通過檔案路徑方式的程式碼：

SubsamplingScaleImageView photoView = (SubsamplingScaleImageView) view.findViewById(R.id.iv_pic);
photoView.setImage(ImageSource.uri(fileString));

這時有人問了，要是載入超過該庫所能承受範圍的圖片呢，會不會崩掉？其實該庫有對應的 OOM catch操作，超過其範圍不能顯示的圖片只會造成圖片不顯示，不會造成崩潰，所以不需要再自己寫 try catch 去捕獲 OOM。

當然，如果你不想要縮放功能，那也可以通過 photoView.setZoomEnabled(boolean zoomEnabled) 去開啟或關閉縮放功能。

接下來再說說部分可能會經常用到的其它介面：

1、回收

該庫提供了回收的方法，呼叫也很簡單：photoView.recycle()

當然也要注意，部分情況是不適合回收的，比如第二種取 drawable 目錄裡面的圖片。對於圖片瀏覽器模組，如果圖片瀏覽器是可以左右滑動切換圖片的話那麼建議進行回收處理，至於怎麼判斷是不是適合回收的情況可以通過像 photoView.setContentDescription(String description) 等方法去打上標識，然後回收的時候再根據這個標識去判斷是否要進行回收。

2、旋轉角度

直接呼叫：

photoView.setOrientation(int orientation)

引數分別有：

ORIENTATION_USE_EXIF: Attempt to use the file's EXIF data to automatically rotate it. Supported for files only, not assets or resources.（根據檔案的EXIF，只適用於檔案）
ORIENTATION_0: Display image in its native orientation. （原始的方向）
ORIENTATION_90: Rotate the image 90° clockwise. （順時針 90 度）
ORIENTATION_180: Rotate the image 180°.（順時針 180 度）
ORIENTATION_270: Rotate the image 270° clockwise.（順時針 270 度）

當然還有很多其它的介面，比如圖片偏移、縮放的相關設定等，這裡就不一一列舉，這個得看個人需求去設定了。

另外再補充一點，該庫不支援 GIF，所以如果圖片瀏覽器要同時再處理 GIF 的話那麼建議再留出一個 imageview 單獨進行處理（可以利用像 Glide 之類的庫）。