/* * Copyright (C) 2014 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.android.mail.bitmap; import android.content.res.Resources; import android.graphics.Bitmap; import android.graphics.BitmapShader; import android.graphics.Canvas; import android.graphics.Color; import android.graphics.ColorFilter; import android.graphics.Matrix; import android.graphics.Paint; import android.graphics.Rect; import android.graphics.Shader; import android.graphics.drawable.Drawable; import com.android.bitmap.BitmapCache; import com.android.bitmap.RequestKey; import com.android.bitmap.ReusableBitmap; import com.android.mail.R; import com.android.mail.bitmap.ContactResolver.ContactDrawableInterface; /** * A drawable that encapsulates all the functionality needed to display a contact image, * including request creation/cancelling and data unbinding/re-binding. *

* The actual contact resolving and decoding is handled by {@link ContactResolver}. *

* For better performance, you should define a cache with {@link #setBitmapCache(BitmapCache)}. */ public abstract class AbstractAvatarDrawable extends Drawable implements ContactDrawableInterface { protected final Resources mResources; private BitmapCache mCache; private ContactResolver mContactResolver; protected ContactRequest mContactRequest; protected ReusableBitmap mBitmap; protected final float mBorderWidth; protected final Paint mBitmapPaint; protected final Paint mBorderPaint; protected final Matrix mMatrix; private int mDecodedWidth; private int mDecodedHeight; public AbstractAvatarDrawable(final Resources res) { mResources = res; mBitmapPaint = new Paint(); mBitmapPaint.setAntiAlias(true); mBitmapPaint.setFilterBitmap(true); mBitmapPaint.setDither(true); mBorderWidth = res.getDimensionPixelSize(R.dimen.avatar_border_width); mBorderPaint = new Paint(); mBorderPaint.setColor(Color.TRANSPARENT); mBorderPaint.setStyle(Paint.Style.STROKE); mBorderPaint.setStrokeWidth(mBorderWidth); mBorderPaint.setAntiAlias(true); mMatrix = new Matrix(); } public void setBitmapCache(final BitmapCache cache) { mCache = cache; } public void setContactResolver(final ContactResolver contactResolver) { mContactResolver = contactResolver; } @Override public void draw(final Canvas canvas) { final Rect bounds = getBounds(); if (!isVisible() || bounds.isEmpty()) { return; } if (mBitmap != null && mBitmap.bmp != null) { // Draw sender image. drawBitmap(mBitmap.bmp, mBitmap.getLogicalWidth(), mBitmap.getLogicalHeight(), canvas); } else { // Draw the default image drawDefaultAvatar(canvas); } } protected abstract void drawDefaultAvatar(Canvas canvas); /** * Draw the bitmap onto the canvas at the current bounds taking into account the current scale. */ protected void drawBitmap(final Bitmap bitmap, final int width, final int height, final Canvas canvas) { final Rect bounds = getBounds(); // Draw bitmap through shader first. final BitmapShader shader = new BitmapShader(bitmap, Shader.TileMode.CLAMP, Shader.TileMode.CLAMP); mMatrix.reset(); // Fit bitmap to bounds. final float boundsWidth = (float) bounds.width(); final float boundsHeight = (float) bounds.height(); final float scale = Math.max(boundsWidth / width, boundsHeight / height); mMatrix.postScale(scale, scale); // Translate bitmap to dst bounds. mMatrix.postTranslate(bounds.left, bounds.top); shader.setLocalMatrix(mMatrix); mBitmapPaint.setShader(shader); drawCircle(canvas, bounds, mBitmapPaint); // Then draw the border. final float radius = bounds.width() / 2f - mBorderWidth / 2; canvas.drawCircle(bounds.centerX(), bounds.centerY(), radius, mBorderPaint); } /** * Draws the largest circle that fits within the given bounds. * * @param canvas the canvas on which to draw * @param bounds the bounding box of the circle * @param paint the paint with which to draw */ protected static void drawCircle(Canvas canvas, Rect bounds, Paint paint) { canvas.drawCircle(bounds.centerX(), bounds.centerY(), bounds.width() / 2, paint); } @Override public int getDecodeWidth() { return mDecodedWidth; } @Override public int getDecodeHeight() { return mDecodedHeight; } public void setDecodeDimensions(final int decodeWidth, final int decodeHeight) { mDecodedWidth = decodeWidth; mDecodedHeight = decodeHeight; } public void unbind() { setImage(null); } public void bind(final String name, final String email) { setImage(new ContactRequest(name, email)); } private void setImage(final ContactRequest contactRequest) { if (mContactRequest != null && mContactRequest.equals(contactRequest)) { return; } if (mBitmap != null) { mBitmap.releaseReference(); mBitmap = null; } if (mContactResolver != null) { mContactResolver.remove(mContactRequest, this); } mContactRequest = contactRequest; if (contactRequest == null) { invalidateSelf(); return; } ReusableBitmap cached = null; if (mCache != null) { cached = mCache.get(contactRequest, true /* incrementRefCount */); } if (cached != null) { setBitmap(cached); } else { decode(); } } private void decode() { if (mContactRequest == null) { return; } // Add to batch. mContactResolver.add(mContactRequest, this); } private void setBitmap(final ReusableBitmap bmp) { if (mBitmap != null && mBitmap != bmp) { mBitmap.releaseReference(); } mBitmap = bmp; invalidateSelf(); } @Override public void onDecodeComplete(RequestKey key, ReusableBitmap result) { final ContactRequest request = (ContactRequest) key; // Remove from batch. mContactResolver.remove(request, this); if (request.equals(mContactRequest)) { setBitmap(result); } else { // if the requests don't match (i.e. this request is stale), decrement the // ref count to allow the bitmap to be pooled if (result != null) { result.releaseReference(); } } } @Override public void setAlpha(int alpha) { mBitmapPaint.setAlpha(alpha); } @Override public void setColorFilter(ColorFilter cf) { mBitmapPaint.setColorFilter(cf); } @Override public int getOpacity() { return 0; } }