Android開源：SImageView - 方便實用的圖片控件

// 對于圖片網址滿足條件 判斷正則為: "https?://.*?.(jpg|png|bmp|jpeg|gif)" //如果不滿足, 那么會認為是一個錯誤地址, 可動態配置, 后面說明

// 設置全局控件場景圖片, (有默認圖片可以不設置) ImageLoader.getInstance(getApplicationContext()).setLoadErrResId(R.mipmap.icon_test); ImageLoader.getInstance(getApplicationContext()).setLoadingResId(R.mipmap.ic_launcher);</code></pre>

控件其他的方法

對應的 getter() 方法省略.

設置圖片網址匹配

上面提到過默認過濾圖片鏈接的正則判斷為 "https?://.*?.(jpg|png|bmp|jpeg|gif)"

如果需要實現其他的地址規則. 可重定義過濾策略

ImageLoader.getInstance(getApplicationContext()).setPicUrlRegex("RegexStr");

// 如果設置自定義正則之后需要恢復, 那么直接設置空串即可
ImageLoader.getInstance(getApplicationContext()).setPicUrlRegex("");</code></pre> 
  
輸出log開關
 
  
默認類庫 log 是不輸出的, 如果需要打開如下:
 
  
LogUtil.GlobalLogPrint = true;      // 輸出類庫相關log信息
 
  
擴展實現
 
  
控件實現了 measure測量布局 和 draw具體繪圖實現 的功能分離. 你可以任意實現排列規則, 和具體的繪圖顯示的規則.
 
  
自定義measure測量布局
 
  
布局測量接口 ILayoutManager . 相當于 RecyclerView 設置布局管理器. 或者 View#onMeasure() 的作用.
 
  
目前內置了2種布局來實現多張圖片的排列.
 
  
 
   
 
QQLayoutManager : 控件默認排列規則, 效果類似于 qq群組頭像 ,最大支持 5 張圖片
 
 
   
 
WeChatLayoutManager : 效果類似于 微信群組頭像 , 最大支持 9 張圖片
 
 
  
 
  
通過 setLayoutManager(ILayoutManager) 來進行測量規則的具體實現類.
 
  
默認情況下, 如果控件只設置了一張圖片是不會走 測量的流程 . 如果需要一張圖片時也需要不規則的排布. 那么通過 SImageView#setCloseNormalOnePicLoad(true) . 強制關閉.
 
  
自定義實現: 實現 ILayoutManager 接口并在 calculate() 實現具體的排列效果. 并返回一個子圖片的位置信息集合. 接口如下. 可參考已經實現的兩個類.
 
  
public interface ILayoutManager {


/**
 * 布局measure排列計算方法, 具體規則由子類實現
 *
 * @param viewWidth 控件的寬
 * @param viewHeight 控件的高
 * @param viewNum   控件圖片的數量
 * @return  返回一個信息集合, 提供 {@link com.szysky.customize.siv.effect.IDrawingStrategy#algorithm(Canvas, int, int, Bitmap, SImageView.ConfigInfo)}使用
 */
ArrayList<LayoutInfoGroup> calculate(int viewWidth, int viewHeight, int viewNum);


/**
 * 封裝控件內部單個元素顯示的布局信息
 */
class LayoutInfoGroup implements Cloneable{
    /**
     * 組合頭像時, 每個單獨元素可分配的最大寬高
     */
    public int innerWidth;
    public int innerHeight;

    /**
     * 每個單獨元素,左上點和右下點.   可規劃區域
     */
    public Point leftTopPoint = new Point();
    public Point rightBottomPoint = new Point();

    @Override
    protected Object clone() throws CloneNotSupportedException {
        LayoutInfoGroup clone = (LayoutInfoGroup) super.clone();
        clone.leftTopPoint.set(leftTopPoint.x, leftTopPoint.y);
        clone.rightBottomPoint.set(rightBottomPoint.x, rightBottomPoint.y);

        return clone;
    }
}

}</code></pre> 
  
自定義的圖片顯示
 
  
控件內置了兩種圖片顯示. 例如: 橢圓, 圓角矩形, 描邊, 五角星等. 相當于 View#onDraw() 和 Adapter#getView() 作用. 具體顯示分離.
 
  
繪制顯示接口 IDrawingStrategy
 
  
內置實現:
 
  
 
   
 
NormalOnePicStrategy : 當控件設置單張圖片時, 默認都是正中間(矩形除外, 保留了 ImageView 三種常用的縮放). 所以無需進行測量步驟. 直接通過配置的形狀屬性等進行相對應的配置實現效果.
 
 
   
 
ConcreteDrawingStrategy : 當控件圖片為多張的時被觸發. 接收 ILayoutManager#calculate() 測量布局返回的子圖片的信息集合, 進行具體的繪制工作. 可通過 SImageView#setCloseNormalOnePicLoad(true) 強制關閉控件單張圖片執行 NormalOnePicStrategy 的邏輯. 全權由 測量布局 , 繪制顯示 兩個邏輯實現所有圖片數量的處理.
 
 
  
 
  
通過 setDrawStrategy(IDrawingStrategy) 來進行圖片繪制顯示的具體策略類.
 
  
自定義繪制策略類. 實現 IDrawingStrategy 接口并實現對應方法, 方法里面有圖片對應的畫布,和需要顯示的寬高信息等. 接口如下:
 
  
public interface IDrawingStrategy {
    /**


 * 根據提供的畫布, 和可繪制的位置實現具體效果
 *
 * @param canvas    {@link SImageView#onDraw(Canvas)} 中的畫布
 * @param childTotal 圖片的總個數
 * @param curChild  當前圖片是第幾張圖片                  
 * @param opeBitmap 需要操作的圖片                                                  
 * @param info      每個內部元素應該擺放的位置信息類
 */
void algorithm(Canvas canvas, int childTotal, int curChild, Bitmap opeBitmap, SImageView.ConfigInfo info);

}</code></pre> 
  
緩存策略自定義
 
  
這部分寫的自己不是很滿意, 寫著寫著就有點耦合了, 最后精力不夠... 好吧這是借口. 反正也能將就自定義, 用默認的就行.... [捂臉]
 
  
建議
 
  
 
   
 
盡量使控件作為頭像控件顯示, 如果大小低于 100dp , 內部稍微做了一些特別處理. 性能可以好一些.
 
 
   
 
由于內置樣式較多, 導致了 cpu密集處理 . 和一些對象的開銷. 如果項目性能要求較高那么可通過自定義繪圖策略注入控件來優化. 這樣項目中常用的效果就可以得到性能提升.
 
 
   
 
類庫需要 寫外部存儲的權限 , 對于新版本的 動態權限 , 一定要先進行權限判斷, 再對 ImageLoad 進行初始化(控件的網絡圖片設置). 否則可能導致, 磁盤緩存無效只有內存緩存.
 
 
  
 
  
如果發現什么問題, 請提 issue . 作者會抽時間去修補 ^*^.