car-apps-common/src/com/android/car/apps/common/LetterTileDrawable.java - platform/packages/apps/Car/libs - Git at Google

 /*
  * Copyright (C) 2016 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.car.apps.common;

 import android.annotation.Nullable;
 import android.content.res.Resources;
 import android.content.res.TypedArray;
 import android.graphics.Bitmap;
 import android.graphics.Canvas;
 import android.graphics.ColorFilter;
 import android.graphics.Paint;
 import android.graphics.Paint.Align;
 import android.graphics.PorterDuff;
 import android.graphics.Rect;
 import android.graphics.Typeface;
 import android.graphics.drawable.Drawable;
 import android.text.TextUtils;

 /**
  * A drawable that encapsulates all the functionality needed to display a letter tile to
  * represent a contact image.
  */
 public class LetterTileDrawable extends Drawable {
     /** Letter tile */
     private static int[] sColors;
     private static int sDefaultColor;
     private static int sTileFontColor;
     private static float sLetterToTileRatio;
     private static Drawable sDefaultPersonAvatar;
     private static Drawable sDefaultBusinessAvatar;
     private static Drawable sDefaultVoicemailAvatar;

     /** Reusable components to avoid new allocations */
     private static final Paint sPaint = new Paint();
     private static final Rect sRect = new Rect();
     private static final char[] sFirstChar = new char[1];

     /** Contact type constants */
     public static final int TYPE_PERSON = 1;
     public static final int TYPE_BUSINESS = 2;
     public static final int TYPE_VOICEMAIL = 3;
     public static final int TYPE_DEFAULT = TYPE_PERSON;

     private final Paint mPaint;

     @Nullable private String mDisplayName;
     private int mColor;
     private int mContactType = TYPE_DEFAULT;
     private float mScale = 1.0f;
     private float mOffset = 0.0f;
     private boolean mIsCircle = false;

     // TODO(rogerxue): the use pattern for this class is always:
     // create LTD, setContactDetails(), setIsCircular(true). merge them into ctor.
     public LetterTileDrawable(final Resources res) {
         mPaint = new Paint();
         mPaint.setFilterBitmap(true);
         mPaint.setDither(true);
         setScale(0.7f);

         if (sColors == null) {
             sDefaultColor = res.getColor(R.color.letter_tile_default_color);
             TypedArray ta = res.obtainTypedArray(R.array.letter_tile_colors);
             if (ta.length() == 0) {
                 // TODO(dnotario). Looks like robolectric shadow doesn't currently support
                 // obtainTypedArray and always returns length 0 array, which will make some code
                 // below that does a division by length of sColors choke. Workaround by creating
                 // an array of length 1. A more proper fix tracked by b/26518438.
                 sColors = new int[] { sDefaultColor };

             } else {
                 sColors = new int[ta.length()];
                 for (int i = ta.length() - 1; i >= 0; i--) {
                     sColors[i] = ta.getColor(i, sDefaultColor);
                 }
                 ta.recycle();
             }

             sTileFontColor = res.getColor(R.color.letter_tile_font_color);
             sLetterToTileRatio = res.getFraction(R.fraction.letter_to_tile_ratio, 1, 1);
             // TODO: get images for business and voicemail
             sDefaultPersonAvatar = res.getDrawable(R.drawable.ic_person, null /* theme */);
             sDefaultBusinessAvatar = res.getDrawable(R.drawable.ic_person, null /* theme */);
             sDefaultVoicemailAvatar = res.getDrawable(R.drawable.ic_person, null /* theme */);
             sPaint.setTypeface(Typeface.create("sans-serif-light", Typeface.NORMAL));
             sPaint.setTextAlign(Align.CENTER);
             sPaint.setAntiAlias(true);
         }
     }

     @Override
     public void draw(final Canvas canvas) {
         final Rect bounds = getBounds();
         if (!isVisible() || bounds.isEmpty()) {
             return;
         }
         // Draw letter tile.
         drawLetterTile(canvas);
     }

     /**
      * Draw the drawable onto the canvas at the current bounds taking into account the current
      * scale.
      */
     private void drawDrawableOnCanvas(final Drawable drawable, final Canvas canvas) {
         // The drawable should be drawn in the middle of the canvas without changing its width to
         // height ratio.
         final Rect destRect = copyBounds();

         // Crop the destination bounds into a square, scaled and offset as appropriate
         final int halfLength = (int) (mScale * Math.min(destRect.width(), destRect.height()) / 2);

         destRect.set(destRect.centerX() - halfLength,
                 (int) (destRect.centerY() - halfLength + mOffset * destRect.height()),
                 destRect.centerX() + halfLength,
                 (int) (destRect.centerY() + halfLength + mOffset * destRect.height()));

         drawable.setAlpha(mPaint.getAlpha());
         drawable.setColorFilter(sTileFontColor, PorterDuff.Mode.SRC_IN);
         drawable.setBounds(destRect);
         drawable.draw(canvas);
     }

     private void drawLetterTile(final Canvas canvas) {
         // Draw background color.
         sPaint.setColor(mColor);

         sPaint.setAlpha(mPaint.getAlpha());
         final Rect bounds = getBounds();
         final int minDimension = Math.min(bounds.width(), bounds.height());

         if (mIsCircle) {
             canvas.drawCircle(bounds.centerX(), bounds.centerY(), minDimension / 2, sPaint);
         } else {
             canvas.drawRect(bounds, sPaint);
         }

         // Draw letter/digit only if the first character is an english letter
         if (!TextUtils.isEmpty(mDisplayName) && isEnglishLetter(mDisplayName.charAt(0))) {
             // Draw letter or digit.
             sFirstChar[0] = Character.toUpperCase(mDisplayName.charAt(0));

             // Scale text by canvas bounds and user selected scaling factor
             sPaint.setTextSize(mScale * sLetterToTileRatio * minDimension);
             //sPaint.setTextSize(sTileLetterFontSize);
             sPaint.getTextBounds(sFirstChar, 0, 1, sRect);
             sPaint.setColor(sTileFontColor);

             // Draw the letter in the canvas, vertically shifted up or down by the user-defined
             // offset
             canvas.drawText(sFirstChar, 0, 1, bounds.centerX(),
                     bounds.centerY() + mOffset * bounds.height() + sRect.height() / 2,
                     sPaint);
         } else {
             // Draw the default image if there is no letter/digit to be drawn
             final Drawable drawable = getDrawablepForContactType(mContactType);
             drawDrawableOnCanvas(drawable, canvas);
         }
     }

     public int getColor() {
         return mColor;
     }

     /**
      * Returns a deterministic color based on the provided contact identifier string.
      */
     private int pickColor(final String identifier) {
         if (TextUtils.isEmpty(identifier) || mContactType == TYPE_VOICEMAIL) {
             return sDefaultColor;
         }
         // String.hashCode() implementation is not supposed to change across java versions, so
         // this should guarantee the same email address always maps to the same color.
         // The email should already have been normalized by the ContactRequest.
         final int color = Math.abs(identifier.hashCode()) % sColors.length;
         return sColors[color];
     }

     private static Drawable getDrawablepForContactType(int contactType) {
         switch (contactType) {
             case TYPE_PERSON:
                 return sDefaultPersonAvatar;
             case TYPE_BUSINESS:
                 return sDefaultBusinessAvatar;
             case TYPE_VOICEMAIL:
                 return sDefaultVoicemailAvatar;
             default:
                 return sDefaultPersonAvatar;
         }
     }

     private static boolean isEnglishLetter(final char c) {
         return ('A' <= c && c <= 'Z') || ('a' <= c && c <= 'z');
     }

     @Override
     public void setAlpha(final int alpha) {
         mPaint.setAlpha(alpha);
     }

     @Override
     public void setColorFilter(final ColorFilter cf) {
         mPaint.setColorFilter(cf);
     }

     @Override
     public int getOpacity() {
         return android.graphics.PixelFormat.OPAQUE;
     }

     /**
      * Scale the drawn letter tile to a ratio of its default size
      *
      * @param scale The ratio the letter tile should be scaled to as a percentage of its default
      * size, from a scale of 0 to 2.0f. The default is 1.0f.
      */
     public void setScale(float scale) {
         mScale = scale;
     }

     /**
      * Assigns the vertical offset of the position of the letter tile to the ContactDrawable
      *
      * @param offset The provided offset must be within the range of -0.5f to 0.5f.
      * If set to -0.5f, the letter will be shifted upwards by 0.5 times the height of the canvas
      * it is being drawn on, which means it will be drawn with the center of the letter starting
      * at the top edge of the canvas.
      * If set to 0.5f, the letter will be shifted downwards by 0.5 times the height of the canvas
      * it is being drawn on, which means it will be drawn with the center of the letter starting
      * at the bottom edge of the canvas.
      * The default is 0.0f.
      */
     public void setOffset(float offset) {
         mOffset = offset;
     }

     public void setContactDetails(@Nullable String displayName, String identifier) {
         mDisplayName = displayName;
         mColor = pickColor(identifier);
     }

     public void setContactType(int contactType) {
         mContactType = contactType;
     }

     public void setIsCircular(boolean isCircle) {
         mIsCircle = isCircle;
     }

     /**
      * Convert the drawable to a bitmap.
      * @param size The target size of the bitmap.
      * @return A bitmap representation of the drawable.
      */
     public Bitmap toBitmap(int size) {
         Bitmap largeIcon = Bitmap.createBitmap(size, size, Bitmap.Config.ARGB_8888);
         Canvas canvas = new Canvas(largeIcon);
         Rect bounds = getBounds();
         setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
         draw(canvas);
         setBounds(bounds);
         return largeIcon;
     }
 }
	/*
	* Copyright (C) 2016 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.car.apps.common;

	import android.annotation.Nullable;
	import android.content.res.Resources;
	import android.content.res.TypedArray;
	import android.graphics.Bitmap;
	import android.graphics.Canvas;
	import android.graphics.ColorFilter;
	import android.graphics.Paint;
	import android.graphics.Paint.Align;
	import android.graphics.PorterDuff;
	import android.graphics.Rect;
	import android.graphics.Typeface;
	import android.graphics.drawable.Drawable;
	import android.text.TextUtils;

	/**
	* A drawable that encapsulates all the functionality needed to display a letter tile to
	* represent a contact image.
	*/
	public class LetterTileDrawable extends Drawable {
	/** Letter tile */
	private static int[] sColors;
	private static int sDefaultColor;
	private static int sTileFontColor;
	private static float sLetterToTileRatio;
	private static Drawable sDefaultPersonAvatar;
	private static Drawable sDefaultBusinessAvatar;
	private static Drawable sDefaultVoicemailAvatar;

	/** Reusable components to avoid new allocations */
	private static final Paint sPaint = new Paint();
	private static final Rect sRect = new Rect();
	private static final char[] sFirstChar = new char[1];

	/** Contact type constants */
	public static final int TYPE_PERSON = 1;
	public static final int TYPE_BUSINESS = 2;
	public static final int TYPE_VOICEMAIL = 3;
	public static final int TYPE_DEFAULT = TYPE_PERSON;

	private final Paint mPaint;

	@Nullable private String mDisplayName;
	private int mColor;
	private int mContactType = TYPE_DEFAULT;
	private float mScale = 1.0f;
	private float mOffset = 0.0f;
	private boolean mIsCircle = false;

	// TODO(rogerxue): the use pattern for this class is always:
	// create LTD, setContactDetails(), setIsCircular(true). merge them into ctor.
	public LetterTileDrawable(final Resources res) {
	mPaint = new Paint();
	mPaint.setFilterBitmap(true);
	mPaint.setDither(true);
	setScale(0.7f);

	if (sColors == null) {
	sDefaultColor = res.getColor(R.color.letter_tile_default_color);
	TypedArray ta = res.obtainTypedArray(R.array.letter_tile_colors);
	if (ta.length() == 0) {
	// TODO(dnotario). Looks like robolectric shadow doesn't currently support
	// obtainTypedArray and always returns length 0 array, which will make some code
	// below that does a division by length of sColors choke. Workaround by creating
	// an array of length 1. A more proper fix tracked by b/26518438.
	sColors = new int[] { sDefaultColor };

	} else {
	sColors = new int[ta.length()];
	for (int i = ta.length() - 1; i >= 0; i--) {
	sColors[i] = ta.getColor(i, sDefaultColor);
	}
	ta.recycle();
	}

	sTileFontColor = res.getColor(R.color.letter_tile_font_color);
	sLetterToTileRatio = res.getFraction(R.fraction.letter_to_tile_ratio, 1, 1);
	// TODO: get images for business and voicemail
	sDefaultPersonAvatar = res.getDrawable(R.drawable.ic_person, null /* theme */);
	sDefaultBusinessAvatar = res.getDrawable(R.drawable.ic_person, null /* theme */);
	sDefaultVoicemailAvatar = res.getDrawable(R.drawable.ic_person, null /* theme */);
	sPaint.setTypeface(Typeface.create("sans-serif-light", Typeface.NORMAL));
	sPaint.setTextAlign(Align.CENTER);
	sPaint.setAntiAlias(true);
	}
	}

	@Override
	public void draw(final Canvas canvas) {
	final Rect bounds = getBounds();
	if (!isVisible() \|\| bounds.isEmpty()) {
	return;
	}
	// Draw letter tile.
	drawLetterTile(canvas);
	}

	/**
	* Draw the drawable onto the canvas at the current bounds taking into account the current
	* scale.
	*/
	private void drawDrawableOnCanvas(final Drawable drawable, final Canvas canvas) {
	// The drawable should be drawn in the middle of the canvas without changing its width to
	// height ratio.
	final Rect destRect = copyBounds();

	// Crop the destination bounds into a square, scaled and offset as appropriate
	final int halfLength = (int) (mScale * Math.min(destRect.width(), destRect.height()) / 2);

	destRect.set(destRect.centerX() - halfLength,
	(int) (destRect.centerY() - halfLength + mOffset * destRect.height()),
	destRect.centerX() + halfLength,
	(int) (destRect.centerY() + halfLength + mOffset * destRect.height()));

	drawable.setAlpha(mPaint.getAlpha());
	drawable.setColorFilter(sTileFontColor, PorterDuff.Mode.SRC_IN);
	drawable.setBounds(destRect);
	drawable.draw(canvas);
	}

	private void drawLetterTile(final Canvas canvas) {
	// Draw background color.
	sPaint.setColor(mColor);

	sPaint.setAlpha(mPaint.getAlpha());
	final Rect bounds = getBounds();
	final int minDimension = Math.min(bounds.width(), bounds.height());

	if (mIsCircle) {
	canvas.drawCircle(bounds.centerX(), bounds.centerY(), minDimension / 2, sPaint);
	} else {
	canvas.drawRect(bounds, sPaint);
	}

	// Draw letter/digit only if the first character is an english letter
	if (!TextUtils.isEmpty(mDisplayName) && isEnglishLetter(mDisplayName.charAt(0))) {
	// Draw letter or digit.
	sFirstChar[0] = Character.toUpperCase(mDisplayName.charAt(0));

	// Scale text by canvas bounds and user selected scaling factor
	sPaint.setTextSize(mScale * sLetterToTileRatio * minDimension);
	//sPaint.setTextSize(sTileLetterFontSize);
	sPaint.getTextBounds(sFirstChar, 0, 1, sRect);
	sPaint.setColor(sTileFontColor);

	// Draw the letter in the canvas, vertically shifted up or down by the user-defined
	// offset
	canvas.drawText(sFirstChar, 0, 1, bounds.centerX(),
	bounds.centerY() + mOffset * bounds.height() + sRect.height() / 2,
	sPaint);
	} else {
	// Draw the default image if there is no letter/digit to be drawn
	final Drawable drawable = getDrawablepForContactType(mContactType);
	drawDrawableOnCanvas(drawable, canvas);
	}
	}

	public int getColor() {
	return mColor;
	}

	/**
	* Returns a deterministic color based on the provided contact identifier string.
	*/
	private int pickColor(final String identifier) {
	if (TextUtils.isEmpty(identifier) \|\| mContactType == TYPE_VOICEMAIL) {
	return sDefaultColor;
	}
	// String.hashCode() implementation is not supposed to change across java versions, so
	// this should guarantee the same email address always maps to the same color.
	// The email should already have been normalized by the ContactRequest.
	final int color = Math.abs(identifier.hashCode()) % sColors.length;
	return sColors[color];
	}

	private static Drawable getDrawablepForContactType(int contactType) {
	switch (contactType) {
	case TYPE_PERSON:
	return sDefaultPersonAvatar;
	case TYPE_BUSINESS:
	return sDefaultBusinessAvatar;
	case TYPE_VOICEMAIL:
	return sDefaultVoicemailAvatar;
	default:
	return sDefaultPersonAvatar;
	}
	}

	private static boolean isEnglishLetter(final char c) {
	return ('A' <= c && c <= 'Z') \|\| ('a' <= c && c <= 'z');
	}

	@Override
	public void setAlpha(final int alpha) {
	mPaint.setAlpha(alpha);
	}

	@Override
	public void setColorFilter(final ColorFilter cf) {
	mPaint.setColorFilter(cf);
	}

	@Override
	public int getOpacity() {
	return android.graphics.PixelFormat.OPAQUE;
	}

	/**
	* Scale the drawn letter tile to a ratio of its default size
	*
	* @param scale The ratio the letter tile should be scaled to as a percentage of its default
	* size, from a scale of 0 to 2.0f. The default is 1.0f.
	*/
	public void setScale(float scale) {
	mScale = scale;
	}

	/**
	* Assigns the vertical offset of the position of the letter tile to the ContactDrawable
	*
	* @param offset The provided offset must be within the range of -0.5f to 0.5f.
	* If set to -0.5f, the letter will be shifted upwards by 0.5 times the height of the canvas
	* it is being drawn on, which means it will be drawn with the center of the letter starting
	* at the top edge of the canvas.
	* If set to 0.5f, the letter will be shifted downwards by 0.5 times the height of the canvas
	* it is being drawn on, which means it will be drawn with the center of the letter starting
	* at the bottom edge of the canvas.
	* The default is 0.0f.
	*/
	public void setOffset(float offset) {
	mOffset = offset;
	}

	public void setContactDetails(@Nullable String displayName, String identifier) {
	mDisplayName = displayName;
	mColor = pickColor(identifier);
	}

	public void setContactType(int contactType) {
	mContactType = contactType;
	}

	public void setIsCircular(boolean isCircle) {
	mIsCircle = isCircle;
	}

	/**
	* Convert the drawable to a bitmap.
	* @param size The target size of the bitmap.
	* @return A bitmap representation of the drawable.
	*/
	public Bitmap toBitmap(int size) {
	Bitmap largeIcon = Bitmap.createBitmap(size, size, Bitmap.Config.ARGB_8888);
	Canvas canvas = new Canvas(largeIcon);
	Rect bounds = getBounds();
	setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
	draw(canvas);
	setBounds(bounds);
	return largeIcon;
	}
	}