summaryrefslogtreecommitdiff
path: root/java/com/android/contacts/common/lettertiles/LetterTileDrawable.java
diff options
context:
space:
mode:
Diffstat (limited to 'java/com/android/contacts/common/lettertiles/LetterTileDrawable.java')
-rw-r--r--java/com/android/contacts/common/lettertiles/LetterTileDrawable.java409
1 files changed, 0 insertions, 409 deletions
diff --git a/java/com/android/contacts/common/lettertiles/LetterTileDrawable.java b/java/com/android/contacts/common/lettertiles/LetterTileDrawable.java
deleted file mode 100644
index 88522c44b..000000000
--- a/java/com/android/contacts/common/lettertiles/LetterTileDrawable.java
+++ /dev/null
@@ -1,409 +0,0 @@
-/*
- * Copyright (C) 2013 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.contacts.common.lettertiles;
-
-import android.content.res.Resources;
-import android.content.res.TypedArray;
-import android.graphics.Bitmap;
-import android.graphics.Bitmap.Config;
-import android.graphics.Canvas;
-import android.graphics.ColorFilter;
-import android.graphics.Outline;
-import android.graphics.Paint;
-import android.graphics.Paint.Align;
-import android.graphics.Rect;
-import android.graphics.Typeface;
-import android.graphics.drawable.Drawable;
-import android.support.annotation.IntDef;
-import android.support.annotation.Nullable;
-import android.text.TextUtils;
-import com.android.contacts.common.R;
-import com.android.dialer.common.Assert;
-import java.lang.annotation.Retention;
-import java.lang.annotation.RetentionPolicy;
-
-/**
- * A drawable that encapsulates all the functionality needed to display a letter tile to represent a
- * contact image.
- */
-public class LetterTileDrawable extends Drawable {
-
- /**
- * ContactType indicates the avatar type of the contact. For a person or for the default when no
- * name is provided, it is {@link #TYPE_DEFAULT}, otherwise, for a business it is {@link
- * #TYPE_BUSINESS}, and voicemail contacts should use {@link #TYPE_VOICEMAIL}.
- */
- @Retention(RetentionPolicy.SOURCE)
- @IntDef({TYPE_PERSON, TYPE_BUSINESS, TYPE_VOICEMAIL, TYPE_GENERIC_AVATAR, TYPE_SPAM})
- public @interface ContactType {}
-
- /** Contact type constants */
- public static final int TYPE_PERSON = 1;
- public static final int TYPE_BUSINESS = 2;
- public static final int TYPE_VOICEMAIL = 3;
- /**
- * A generic avatar that features the default icon, default color, and no letter. Useful for
- * situations where a contact is anonymous.
- */
- public static final int TYPE_GENERIC_AVATAR = 4;
- public static final int TYPE_SPAM = 5;
- public static final int TYPE_CONFERENCE = 6;
- @ContactType public static final int TYPE_DEFAULT = TYPE_PERSON;
-
- /**
- * Shape indicates the letter tile shape. It can be either a {@link #SHAPE_CIRCLE}, otherwise, it
- * is a {@link #SHAPE_RECTANGLE}.
- */
- @Retention(RetentionPolicy.SOURCE)
- @IntDef({SHAPE_CIRCLE, SHAPE_RECTANGLE})
- public @interface Shape {}
-
- /** Shape constants */
- public static final int SHAPE_CIRCLE = 1;
-
- public static final int SHAPE_RECTANGLE = 2;
-
- /** 54% opacity */
- private static final int ALPHA = 138;
- /** 100% opacity */
- private static final int SPAM_ALPHA = 255;
- /** Default icon scale for vector drawable. */
- private static final float VECTOR_ICON_SCALE = 0.7f;
-
- /** 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];
- /** Letter tile */
- private static TypedArray sColors;
-
- private static int sSpamColor;
- private static int sDefaultColor;
- private static int sTileFontColor;
- private static float sLetterToTileRatio;
- private static Drawable sDefaultPersonAvatar;
- private static Drawable sDefaultBusinessAvatar;
- private static Drawable sDefaultVoicemailAvatar;
- private static Drawable sDefaultSpamAvatar;
- private static Drawable sDefaultConferenceAvatar;
-
- private final Paint mPaint;
- @ContactType private int mContactType = TYPE_DEFAULT;
- private float mScale = 1.0f;
- private float mOffset = 0.0f;
- private boolean mIsCircle = false;
-
- private int mColor;
- private Character mLetter = null;
-
- private String mDisplayName;
-
- public LetterTileDrawable(final Resources res) {
- if (sColors == null) {
- sColors = res.obtainTypedArray(R.array.letter_tile_colors);
- sSpamColor = res.getColor(R.color.spam_contact_background);
- sDefaultColor = res.getColor(R.color.letter_tile_default_color);
- sTileFontColor = res.getColor(R.color.letter_tile_font_color);
- sLetterToTileRatio = res.getFraction(R.dimen.letter_to_tile_ratio, 1, 1);
- sDefaultPersonAvatar =
- res.getDrawable(R.drawable.product_logo_avatar_anonymous_white_color_120, null);
- sDefaultBusinessAvatar = res.getDrawable(R.drawable.quantum_ic_business_vd_theme_24, null);
- sDefaultVoicemailAvatar = res.getDrawable(R.drawable.quantum_ic_voicemail_vd_theme_24, null);
- sDefaultSpamAvatar = res.getDrawable(R.drawable.quantum_ic_report_vd_theme_24, null);
- sDefaultConferenceAvatar = res.getDrawable(R.drawable.quantum_ic_group_vd_theme_24, null);
- sPaint.setTypeface(
- Typeface.create(res.getString(R.string.letter_tile_letter_font_family), Typeface.NORMAL));
- sPaint.setTextAlign(Align.CENTER);
- sPaint.setAntiAlias(true);
- }
- mPaint = new Paint();
- mPaint.setFilterBitmap(true);
- mPaint.setDither(true);
- mColor = sDefaultColor;
- }
-
- private Rect getScaledBounds(float scale, float offset) {
- // 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) (scale * Math.min(destRect.width(), destRect.height()) / 2);
-
- destRect.set(
- destRect.centerX() - halfLength,
- (int) (destRect.centerY() - halfLength + offset * destRect.height()),
- destRect.centerX() + halfLength,
- (int) (destRect.centerY() + halfLength + offset * destRect.height()));
- return destRect;
- }
-
- private Drawable getDrawableForContactType(int contactType) {
- switch (contactType) {
- case TYPE_BUSINESS:
- mScale = VECTOR_ICON_SCALE;
- return sDefaultBusinessAvatar;
- case TYPE_VOICEMAIL:
- mScale = VECTOR_ICON_SCALE;
- return sDefaultVoicemailAvatar;
- case TYPE_SPAM:
- mScale = VECTOR_ICON_SCALE;
- return sDefaultSpamAvatar;
- case TYPE_CONFERENCE:
- mScale = VECTOR_ICON_SCALE;
- return sDefaultConferenceAvatar;
- case TYPE_PERSON:
- case TYPE_GENERIC_AVATAR:
- default:
- return sDefaultPersonAvatar;
- }
- }
-
- private static boolean isEnglishLetter(final char c) {
- return ('A' <= c && c <= 'Z') || ('a' <= c && c <= 'z');
- }
-
- @Override
- public void draw(final Canvas canvas) {
- final Rect bounds = getBounds();
- if (!isVisible() || bounds.isEmpty()) {
- return;
- }
- // Draw letter tile.
- drawLetterTile(canvas);
- }
-
- public Bitmap getBitmap(int width, int height) {
- Bitmap bitmap = Bitmap.createBitmap(width, height, Config.ARGB_8888);
- this.setBounds(0, 0, width, height);
- Canvas canvas = new Canvas(bitmap);
- this.draw(canvas);
- return bitmap;
- }
-
- 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 or there's a override
- if (mLetter != null) {
- // Draw letter or digit.
- sFirstChar[0] = mLetter;
-
- // Scale text by canvas bounds and user selected scaling factor
- sPaint.setTextSize(mScale * sLetterToTileRatio * minDimension);
- sPaint.getTextBounds(sFirstChar, 0, 1, sRect);
- sPaint.setTypeface(Typeface.create("sans-serif", Typeface.NORMAL));
- sPaint.setColor(sTileFontColor);
- sPaint.setAlpha(ALPHA);
-
- // 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.exactCenterY(),
- sPaint);
- } else {
- // Draw the default image if there is no letter/digit to be drawn
- Drawable drawable = getDrawableForContactType(mContactType);
- drawable.setBounds(getScaledBounds(mScale, mOffset));
- drawable.setAlpha(drawable == sDefaultSpamAvatar ? SPAM_ALPHA : ALPHA);
- drawable.draw(canvas);
- }
- }
-
- public int getColor() {
- return mColor;
- }
-
- public LetterTileDrawable setColor(int color) {
- mColor = color;
- return this;
- }
-
- /** Returns a deterministic color based on the provided contact identifier string. */
- private int pickColor(final String identifier) {
- if (mContactType == TYPE_SPAM) {
- return sSpamColor;
- }
-
- if (mContactType == TYPE_VOICEMAIL
- || mContactType == TYPE_BUSINESS
- || TextUtils.isEmpty(identifier)) {
- 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.getColor(color, sDefaultColor);
- }
-
- @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;
- }
-
- @Override
- public void getOutline(Outline outline) {
- if (mIsCircle) {
- outline.setOval(getBounds());
- } else {
- outline.setRect(getBounds());
- }
-
- outline.setAlpha(1);
- }
-
- /**
- * 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 LetterTileDrawable setScale(float scale) {
- mScale = scale;
- return this;
- }
-
- /**
- * 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 LetterTileDrawable setOffset(float offset) {
- Assert.checkArgument(offset >= -0.5f && offset <= 0.5f);
- mOffset = offset;
- return this;
- }
-
- public LetterTileDrawable setLetter(Character letter) {
- mLetter = letter;
- return this;
- }
-
- public Character getLetter() {
- return this.mLetter;
- }
-
- private LetterTileDrawable setLetterAndColorFromContactDetails(
- final String displayName, final String identifier) {
- if (!TextUtils.isEmpty(displayName) && isEnglishLetter(displayName.charAt(0))) {
- mLetter = Character.toUpperCase(displayName.charAt(0));
- } else {
- mLetter = null;
- }
- mColor = pickColor(identifier);
- return this;
- }
-
- public LetterTileDrawable setContactType(@ContactType int contactType) {
- mContactType = contactType;
- return this;
- }
-
- @ContactType
- public int getContactType() {
- return this.mContactType;
- }
-
- public LetterTileDrawable setIsCircular(boolean isCircle) {
- mIsCircle = isCircle;
- return this;
- }
-
- public boolean tileIsCircular() {
- return this.mIsCircle;
- }
-
- /**
- * Creates a canonical letter tile for use across dialer fragments.
- *
- * @param displayName The display name to produce the letter in the tile. Null values or numbers
- * yield no letter.
- * @param identifierForTileColor The string used to produce the tile color.
- * @param shape The shape of the tile.
- * @param contactType The type of contact, e.g. TYPE_VOICEMAIL.
- * @return this
- */
- public LetterTileDrawable setCanonicalDialerLetterTileDetails(
- @Nullable final String displayName,
- @Nullable final String identifierForTileColor,
- @Shape final int shape,
- final int contactType) {
-
- this.setIsCircular(shape == SHAPE_CIRCLE);
-
- /**
- * We return quickly under the following conditions: 1. We are asked to draw a default tile, and
- * no coloring information is provided, meaning no further initialization is necessary OR 2.
- * We've already invoked this method before, set mDisplayName, and found that it has not
- * changed. This is useful during events like hangup, when we lose the call state for special
- * types of contacts, like voicemail. We keep track of the special case until we encounter a new
- * display name.
- */
- if (contactType == TYPE_DEFAULT
- && ((displayName == null && identifierForTileColor == null)
- || (displayName != null && displayName.equals(mDisplayName)))) {
- return this;
- }
-
- this.mDisplayName = displayName;
- setContactType(contactType);
-
- // Special contact types receive default color and no letter tile, but special iconography.
- if (contactType != TYPE_PERSON) {
- this.setLetterAndColorFromContactDetails(null, null);
- } else {
- if (identifierForTileColor != null) {
- this.setLetterAndColorFromContactDetails(displayName, identifierForTileColor);
- } else {
- this.setLetterAndColorFromContactDetails(displayName, displayName);
- }
- }
- return this;
- }
-}