/*
 * 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 android.widget;

import android.animation.ObjectAnimator;
import android.annotation.IntDef;
import android.content.Context;
import android.content.res.ColorStateList;
import android.content.res.Resources;
import android.content.res.TypedArray;
import android.graphics.Canvas;
import android.graphics.Color;
import android.graphics.Paint;
import android.graphics.Path;
import android.graphics.Rect;
import android.graphics.Region;
import android.graphics.Typeface;
import android.os.Bundle;
import android.util.AttributeSet;
import android.util.FloatProperty;
import android.util.IntArray;
import android.util.Log;
import android.util.MathUtils;
import android.util.StateSet;
import android.util.TypedValue;
import android.view.HapticFeedbackConstants;
import android.view.MotionEvent;
import android.view.PointerIcon;
import android.view.View;
import android.view.accessibility.AccessibilityEvent;
import android.view.accessibility.AccessibilityNodeInfo;
import android.view.accessibility.AccessibilityNodeInfo.AccessibilityAction;

import com.android.internal.R;
import com.android.internal.widget.ExploreByTouchHelper;

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.util.Calendar;
import java.util.Locale;

View to show a clock circle picker (with one or two picking circles)
@hide
/** * View to show a clock circle picker (with one or two picking circles) * * @hide */
public class RadialTimePickerView extends View { private static final String TAG = "RadialTimePickerView"; public static final int HOURS = 0; public static final int MINUTES = 1;
@hide
/** @hide */
@IntDef({HOURS, MINUTES}) @Retention(RetentionPolicy.SOURCE) @interface PickerType {} private static final int HOURS_INNER = 2; private static final int SELECTOR_CIRCLE = 0; private static final int SELECTOR_DOT = 1; private static final int SELECTOR_LINE = 2; private static final int AM = 0; private static final int PM = 1; private static final int HOURS_IN_CIRCLE = 12; private static final int MINUTES_IN_CIRCLE = 60; private static final int DEGREES_FOR_ONE_HOUR = 360 / HOURS_IN_CIRCLE; private static final int DEGREES_FOR_ONE_MINUTE = 360 / MINUTES_IN_CIRCLE; private static final int[] HOURS_NUMBERS = {12, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11}; private static final int[] HOURS_NUMBERS_24 = {0, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23}; private static final int[] MINUTES_NUMBERS = {0, 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55}; private static final int ANIM_DURATION_NORMAL = 500; private static final int ANIM_DURATION_TOUCH = 60; private static final int[] SNAP_PREFER_30S_MAP = new int[361]; private static final int NUM_POSITIONS = 12; private static final float[] COS_30 = new float[NUM_POSITIONS]; private static final float[] SIN_30 = new float[NUM_POSITIONS];
"Something is wrong" color used when a color attribute is missing.
/** "Something is wrong" color used when a color attribute is missing. */
private static final int MISSING_COLOR = Color.MAGENTA; static { // Prepare mapping to snap touchable degrees to selectable degrees. preparePrefer30sMap(); final double increment = 2.0 * Math.PI / NUM_POSITIONS; double angle = Math.PI / 2.0; for (int i = 0; i < NUM_POSITIONS; i++) { COS_30[i] = (float) Math.cos(angle); SIN_30[i] = (float) Math.sin(angle); angle += increment; } } private final FloatProperty<RadialTimePickerView> HOURS_TO_MINUTES = new FloatProperty<RadialTimePickerView>("hoursToMinutes") { @Override public Float get(RadialTimePickerView radialTimePickerView) { return radialTimePickerView.mHoursToMinutes; } @Override public void setValue(RadialTimePickerView object, float value) { object.mHoursToMinutes = value; object.invalidate(); } }; private final String[] mHours12Texts = new String[12]; private final String[] mOuterHours24Texts = new String[12]; private final String[] mInnerHours24Texts = new String[12]; private final String[] mMinutesTexts = new String[12]; private final Paint[] mPaint = new Paint[2]; private final Paint mPaintCenter = new Paint(); private final Paint[] mPaintSelector = new Paint[3]; private final Paint mPaintBackground = new Paint(); private final Typeface mTypeface; private final ColorStateList[] mTextColor = new ColorStateList[3]; private final int[] mTextSize = new int[3]; private final int[] mTextInset = new int[3]; private final float[][] mOuterTextX = new float[2][12]; private final float[][] mOuterTextY = new float[2][12]; private final float[] mInnerTextX = new float[12]; private final float[] mInnerTextY = new float[12]; private final int[] mSelectionDegrees = new int[2]; private final RadialPickerTouchHelper mTouchHelper; private final Path mSelectorPath = new Path(); private boolean mIs24HourMode; private boolean mShowHours; private ObjectAnimator mHoursToMinutesAnimator; private float mHoursToMinutes;
When in 24-hour mode, indicates that the current hour is between 1 and 12 (inclusive).
/** * When in 24-hour mode, indicates that the current hour is between * 1 and 12 (inclusive). */
private boolean mIsOnInnerCircle; private int mSelectorRadius; private int mSelectorStroke; private int mSelectorDotRadius; private int mCenterDotRadius; private int mSelectorColor; private int mSelectorDotColor; private int mXCenter; private int mYCenter; private int mCircleRadius; private int mMinDistForInnerNumber; private int mMaxDistForOuterNumber; private int mHalfwayDist; private String[] mOuterTextHours; private String[] mInnerTextHours; private String[] mMinutesText; private int mAmOrPm; private float mDisabledAlpha; private OnValueSelectedListener mListener; private boolean mInputEnabled = true; interface OnValueSelectedListener {
Called when the selected value at a given picker index has changed.
Params:
/** * Called when the selected value at a given picker index has changed. * * @param pickerType the type of value that has changed, one of: * <ul> * <li>{@link #MINUTES} * <li>{@link #HOURS} * </ul> * @param newValue the new value as minute in hour (0-59) or hour in * day (0-23) * @param autoAdvance when the picker type is {@link #HOURS}, * {@code true} to switch to the {@link #MINUTES} * picker or {@code false} to stay on the current * picker. No effect when picker type is * {@link #MINUTES}. */
void onValueSelected(@PickerType int pickerType, int newValue, boolean autoAdvance); }
Split up the 360 degrees of the circle among the 60 selectable values. Assigns a larger selectable area to each of the 12 visible values, such that the ratio of space apportioned to a visible value : space apportioned to a non-visible value will be 14 : 4. E.g. the output of 30 degrees should have a higher range of input associated with it than the output of 24 degrees, because 30 degrees corresponds to a visible number on the clock circle (5 on the minutes, 1 or 13 on the hours).
/** * Split up the 360 degrees of the circle among the 60 selectable values. Assigns a larger * selectable area to each of the 12 visible values, such that the ratio of space apportioned * to a visible value : space apportioned to a non-visible value will be 14 : 4. * E.g. the output of 30 degrees should have a higher range of input associated with it than * the output of 24 degrees, because 30 degrees corresponds to a visible number on the clock * circle (5 on the minutes, 1 or 13 on the hours). */
private static void preparePrefer30sMap() { // We'll split up the visible output and the non-visible output such that each visible // output will correspond to a range of 14 associated input degrees, and each non-visible // output will correspond to a range of 4 associate input degrees, so visible numbers // are more than 3 times easier to get than non-visible numbers: // {354-359,0-7}:0, {8-11}:6, {12-15}:12, {16-19}:18, {20-23}:24, {24-37}:30, etc. // // If an output of 30 degrees should correspond to a range of 14 associated degrees, then // we'll need any input between 24 - 37 to snap to 30. Working out from there, 20-23 should // snap to 24, while 38-41 should snap to 36. This is somewhat counter-intuitive, that you // can be touching 36 degrees but have the selection snapped to 30 degrees; however, this // inconsistency isn't noticeable at such fine-grained degrees, and it affords us the // ability to aggressively prefer the visible values by a factor of more than 3:1, which // greatly contributes to the selectability of these values. // The first output is 0, and each following output will increment by 6 {0, 6, 12, ...}. int snappedOutputDegrees = 0; // Count of how many inputs we've designated to the specified output. int count = 1; // How many input we expect for a specified output. This will be 14 for output divisible // by 30, and 4 for the remaining output. We'll special case the outputs of 0 and 360, so // the caller can decide which they need. int expectedCount = 8; // Iterate through the input. for (int degrees = 0; degrees < 361; degrees++) { // Save the input-output mapping. SNAP_PREFER_30S_MAP[degrees] = snappedOutputDegrees; // If this is the last input for the specified output, calculate the next output and // the next expected count. if (count == expectedCount) { snappedOutputDegrees += 6; if (snappedOutputDegrees == 360) { expectedCount = 7; } else if (snappedOutputDegrees % 30 == 0) { expectedCount = 14; } else { expectedCount = 4; } count = 1; } else { count++; } } }
Returns mapping of any input degrees (0 to 360) to one of 60 selectable output degrees, where the degrees corresponding to visible numbers (i.e. those divisible by 30) will be weighted heavier than the degrees corresponding to non-visible numbers. See preparePrefer30sMap() documentation for the rationale and generation of the mapping.
/** * Returns mapping of any input degrees (0 to 360) to one of 60 selectable output degrees, * where the degrees corresponding to visible numbers (i.e. those divisible by 30) will be * weighted heavier than the degrees corresponding to non-visible numbers. * See {@link #preparePrefer30sMap()} documentation for the rationale and generation of the * mapping. */
private static int snapPrefer30s(int degrees) { if (SNAP_PREFER_30S_MAP == null) { return -1; } return SNAP_PREFER_30S_MAP[degrees]; }
Returns mapping of any input degrees (0 to 360) to one of 12 visible output degrees (all multiples of 30), where the input will be "snapped" to the closest visible degrees.
Params:
  • degrees – The input degrees
  • forceHigherOrLower – The output may be forced to either the higher or lower step, or may be allowed to snap to whichever is closer. Use 1 to force strictly higher, -1 to force strictly lower, and 0 to snap to the closer one.
Returns:output degrees, will be a multiple of 30
/** * Returns mapping of any input degrees (0 to 360) to one of 12 visible output degrees (all * multiples of 30), where the input will be "snapped" to the closest visible degrees. * @param degrees The input degrees * @param forceHigherOrLower The output may be forced to either the higher or lower step, or may * be allowed to snap to whichever is closer. Use 1 to force strictly higher, -1 to force * strictly lower, and 0 to snap to the closer one. * @return output degrees, will be a multiple of 30 */
private static int snapOnly30s(int degrees, int forceHigherOrLower) { final int stepSize = DEGREES_FOR_ONE_HOUR; int floor = (degrees / stepSize) * stepSize; final int ceiling = floor + stepSize; if (forceHigherOrLower == 1) { degrees = ceiling; } else if (forceHigherOrLower == -1) { if (degrees == floor) { floor -= stepSize; } degrees = floor; } else { if ((degrees - floor) < (ceiling - degrees)) { degrees = floor; } else { degrees = ceiling; } } return degrees; } @SuppressWarnings("unused") public RadialTimePickerView(Context context) { this(context, null); } public RadialTimePickerView(Context context, AttributeSet attrs) { this(context, attrs, R.attr.timePickerStyle); } public RadialTimePickerView(Context context, AttributeSet attrs, int defStyleAttr) { this(context, attrs, defStyleAttr, 0); } public RadialTimePickerView( Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) { super(context, attrs); applyAttributes(attrs, defStyleAttr, defStyleRes); // Pull disabled alpha from theme. final TypedValue outValue = new TypedValue(); context.getTheme().resolveAttribute(android.R.attr.disabledAlpha, outValue, true); mDisabledAlpha = outValue.getFloat(); mTypeface = Typeface.create("sans-serif", Typeface.NORMAL); mPaint[HOURS] = new Paint(); mPaint[HOURS].setAntiAlias(true); mPaint[HOURS].setTextAlign(Paint.Align.CENTER); mPaint[MINUTES] = new Paint(); mPaint[MINUTES].setAntiAlias(true); mPaint[MINUTES].setTextAlign(Paint.Align.CENTER); mPaintCenter.setAntiAlias(true); mPaintSelector[SELECTOR_CIRCLE] = new Paint(); mPaintSelector[SELECTOR_CIRCLE].setAntiAlias(true); mPaintSelector[SELECTOR_DOT] = new Paint(); mPaintSelector[SELECTOR_DOT].setAntiAlias(true); mPaintSelector[SELECTOR_LINE] = new Paint(); mPaintSelector[SELECTOR_LINE].setAntiAlias(true); mPaintSelector[SELECTOR_LINE].setStrokeWidth(2); mPaintBackground.setAntiAlias(true); final Resources res = getResources(); mSelectorRadius = res.getDimensionPixelSize(R.dimen.timepicker_selector_radius); mSelectorStroke = res.getDimensionPixelSize(R.dimen.timepicker_selector_stroke); mSelectorDotRadius = res.getDimensionPixelSize(R.dimen.timepicker_selector_dot_radius); mCenterDotRadius = res.getDimensionPixelSize(R.dimen.timepicker_center_dot_radius); mTextSize[HOURS] = res.getDimensionPixelSize(R.dimen.timepicker_text_size_normal); mTextSize[MINUTES] = res.getDimensionPixelSize(R.dimen.timepicker_text_size_normal); mTextSize[HOURS_INNER] = res.getDimensionPixelSize(R.dimen.timepicker_text_size_inner); mTextInset[HOURS] = res.getDimensionPixelSize(R.dimen.timepicker_text_inset_normal); mTextInset[MINUTES] = res.getDimensionPixelSize(R.dimen.timepicker_text_inset_normal); mTextInset[HOURS_INNER] = res.getDimensionPixelSize(R.dimen.timepicker_text_inset_inner); mShowHours = true; mHoursToMinutes = HOURS; mIs24HourMode = false; mAmOrPm = AM; // Set up accessibility components. mTouchHelper = new RadialPickerTouchHelper(); setAccessibilityDelegate(mTouchHelper); if (getImportantForAccessibility() == IMPORTANT_FOR_ACCESSIBILITY_AUTO) { setImportantForAccessibility(IMPORTANT_FOR_ACCESSIBILITY_YES); } initHoursAndMinutesText(); initData(); // Initial values final Calendar calendar = Calendar.getInstance(Locale.getDefault()); final int currentHour = calendar.get(Calendar.HOUR_OF_DAY); final int currentMinute = calendar.get(Calendar.MINUTE); setCurrentHourInternal(currentHour, false, false); setCurrentMinuteInternal(currentMinute, false); setHapticFeedbackEnabled(true); } void applyAttributes(AttributeSet attrs, int defStyleAttr, int defStyleRes) { final Context context = getContext(); final TypedArray a = getContext().obtainStyledAttributes(attrs, R.styleable.TimePicker, defStyleAttr, defStyleRes); final ColorStateList numbersTextColor = a.getColorStateList( R.styleable.TimePicker_numbersTextColor); final ColorStateList numbersInnerTextColor = a.getColorStateList( R.styleable.TimePicker_numbersInnerTextColor); mTextColor[HOURS] = numbersTextColor == null ? ColorStateList.valueOf(MISSING_COLOR) : numbersTextColor; mTextColor[HOURS_INNER] = numbersInnerTextColor == null ? ColorStateList.valueOf(MISSING_COLOR) : numbersInnerTextColor; mTextColor[MINUTES] = mTextColor[HOURS]; // Set up various colors derived from the selector "activated" state. final ColorStateList selectorColors = a.getColorStateList( R.styleable.TimePicker_numbersSelectorColor); final int selectorActivatedColor; if (selectorColors != null) { final int[] stateSetEnabledActivated = StateSet.get( StateSet.VIEW_STATE_ENABLED | StateSet.VIEW_STATE_ACTIVATED); selectorActivatedColor = selectorColors.getColorForState( stateSetEnabledActivated, 0); } else { selectorActivatedColor = MISSING_COLOR; } mPaintCenter.setColor(selectorActivatedColor); final int[] stateSetActivated = StateSet.get( StateSet.VIEW_STATE_ENABLED | StateSet.VIEW_STATE_ACTIVATED); mSelectorColor = selectorActivatedColor; mSelectorDotColor = mTextColor[HOURS].getColorForState(stateSetActivated, 0); mPaintBackground.setColor(a.getColor(R.styleable.TimePicker_numbersBackgroundColor, context.getColor(R.color.timepicker_default_numbers_background_color_material))); a.recycle(); } public void initialize(int hour, int minute, boolean is24HourMode) { if (mIs24HourMode != is24HourMode) { mIs24HourMode = is24HourMode; initData(); } setCurrentHourInternal(hour, false, false); setCurrentMinuteInternal(minute, false); } public void setCurrentItemShowing(int item, boolean animate) { switch (item){ case HOURS: showHours(animate); break; case MINUTES: showMinutes(animate); break; default: Log.e(TAG, "ClockView does not support showing item " + item); } } public int getCurrentItemShowing() { return mShowHours ? HOURS : MINUTES; } public void setOnValueSelectedListener(OnValueSelectedListener listener) { mListener = listener; }
Sets the current hour in 24-hour time.
Params:
  • hour – the current hour between 0 and 23 (inclusive)
/** * Sets the current hour in 24-hour time. * * @param hour the current hour between 0 and 23 (inclusive) */
public void setCurrentHour(int hour) { setCurrentHourInternal(hour, true, false); }
Sets the current hour.
Params:
  • hour – The current hour
  • callback – Whether the value listener should be invoked
  • autoAdvance – Whether the listener should auto-advance to the next selection mode, e.g. hour to minutes
/** * Sets the current hour. * * @param hour The current hour * @param callback Whether the value listener should be invoked * @param autoAdvance Whether the listener should auto-advance to the next * selection mode, e.g. hour to minutes */
private void setCurrentHourInternal(int hour, boolean callback, boolean autoAdvance) { final int degrees = (hour % 12) * DEGREES_FOR_ONE_HOUR; mSelectionDegrees[HOURS] = degrees; // 0 is 12 AM (midnight) and 12 is 12 PM (noon). final int amOrPm = (hour == 0 || (hour % 24) < 12) ? AM : PM; final boolean isOnInnerCircle = getInnerCircleForHour(hour); if (mAmOrPm != amOrPm || mIsOnInnerCircle != isOnInnerCircle) { mAmOrPm = amOrPm; mIsOnInnerCircle = isOnInnerCircle; initData(); mTouchHelper.invalidateRoot(); } invalidate(); if (callback && mListener != null) { mListener.onValueSelected(HOURS, hour, autoAdvance); } }
Returns the current hour in 24-hour time.
Returns:the current hour between 0 and 23 (inclusive)
/** * Returns the current hour in 24-hour time. * * @return the current hour between 0 and 23 (inclusive) */
public int getCurrentHour() { return getHourForDegrees(mSelectionDegrees[HOURS], mIsOnInnerCircle); } private int getHourForDegrees(int degrees, boolean innerCircle) { int hour = (degrees / DEGREES_FOR_ONE_HOUR) % 12; if (mIs24HourMode) { // Convert the 12-hour value into 24-hour time based on where the // selector is positioned. if (!innerCircle && hour == 0) { // Outer circle is 1 through 12. hour = 12; } else if (innerCircle && hour != 0) { // Inner circle is 13 through 23 and 0. hour += 12; } } else if (mAmOrPm == PM) { hour += 12; } return hour; }
Params:
  • hour – the hour in 24-hour time or 12-hour time
/** * @param hour the hour in 24-hour time or 12-hour time */
private int getDegreesForHour(int hour) { // Convert to be 0-11. if (mIs24HourMode) { if (hour >= 12) { hour -= 12; } } else if (hour == 12) { hour = 0; } return hour * DEGREES_FOR_ONE_HOUR; }
Params:
  • hour – the hour in 24-hour time or 12-hour time
/** * @param hour the hour in 24-hour time or 12-hour time */
private boolean getInnerCircleForHour(int hour) { return mIs24HourMode && (hour == 0 || hour > 12); } public void setCurrentMinute(int minute) { setCurrentMinuteInternal(minute, true); } private void setCurrentMinuteInternal(int minute, boolean callback) { mSelectionDegrees[MINUTES] = (minute % MINUTES_IN_CIRCLE) * DEGREES_FOR_ONE_MINUTE; invalidate(); if (callback && mListener != null) { mListener.onValueSelected(MINUTES, minute, false); } } // Returns minutes in 0-59 range public int getCurrentMinute() { return getMinuteForDegrees(mSelectionDegrees[MINUTES]); } private int getMinuteForDegrees(int degrees) { return degrees / DEGREES_FOR_ONE_MINUTE; } private int getDegreesForMinute(int minute) { return minute * DEGREES_FOR_ONE_MINUTE; }
Sets whether the picker is showing AM or PM hours. Has no effect when in 24-hour mode.
Params:
Returns:true if the value changed from what was previously set, or false otherwise
/** * Sets whether the picker is showing AM or PM hours. Has no effect when * in 24-hour mode. * * @param amOrPm {@link #AM} or {@link #PM} * @return {@code true} if the value changed from what was previously set, * or {@code false} otherwise */
public boolean setAmOrPm(int amOrPm) { if (mAmOrPm == amOrPm || mIs24HourMode) { return false; } mAmOrPm = amOrPm; invalidate(); mTouchHelper.invalidateRoot(); return true; } public int getAmOrPm() { return mAmOrPm; } public void showHours(boolean animate) { showPicker(true, animate); } public void showMinutes(boolean animate) { showPicker(false, animate); } private void initHoursAndMinutesText() { // Initialize the hours and minutes numbers. for (int i = 0; i < 12; i++) { mHours12Texts[i] = String.format("%d", HOURS_NUMBERS[i]); mInnerHours24Texts[i] = String.format("%02d", HOURS_NUMBERS_24[i]); mOuterHours24Texts[i] = String.format("%d", HOURS_NUMBERS[i]); mMinutesTexts[i] = String.format("%02d", MINUTES_NUMBERS[i]); } } private void initData() { if (mIs24HourMode) { mOuterTextHours = mOuterHours24Texts; mInnerTextHours = mInnerHours24Texts; } else { mOuterTextHours = mHours12Texts; mInnerTextHours = mHours12Texts; } mMinutesText = mMinutesTexts; } @Override protected void onLayout(boolean changed, int left, int top, int right, int bottom) { if (!changed) { return; } mXCenter = getWidth() / 2; mYCenter = getHeight() / 2; mCircleRadius = Math.min(mXCenter, mYCenter); mMinDistForInnerNumber = mCircleRadius - mTextInset[HOURS_INNER] - mSelectorRadius; mMaxDistForOuterNumber = mCircleRadius - mTextInset[HOURS] + mSelectorRadius; mHalfwayDist = mCircleRadius - (mTextInset[HOURS] + mTextInset[HOURS_INNER]) / 2; calculatePositionsHours(); calculatePositionsMinutes(); mTouchHelper.invalidateRoot(); } @Override public void onDraw(Canvas canvas) { final float alphaMod = mInputEnabled ? 1 : mDisabledAlpha; drawCircleBackground(canvas); final Path selectorPath = mSelectorPath; drawSelector(canvas, selectorPath); drawHours(canvas, selectorPath, alphaMod); drawMinutes(canvas, selectorPath, alphaMod); drawCenter(canvas, alphaMod); } private void showPicker(boolean hours, boolean animate) { if (mShowHours == hours) { return; } mShowHours = hours; if (animate) { animatePicker(hours, ANIM_DURATION_NORMAL); } else { // If we have a pending or running animator, cancel it. if (mHoursToMinutesAnimator != null && mHoursToMinutesAnimator.isStarted()) { mHoursToMinutesAnimator.cancel(); mHoursToMinutesAnimator = null; } mHoursToMinutes = hours ? 0.0f : 1.0f; } initData(); invalidate(); mTouchHelper.invalidateRoot(); } private void animatePicker(boolean hoursToMinutes, long duration) { final float target = hoursToMinutes ? HOURS : MINUTES; if (mHoursToMinutes == target) { // If we have a pending or running animator, cancel it. if (mHoursToMinutesAnimator != null && mHoursToMinutesAnimator.isStarted()) { mHoursToMinutesAnimator.cancel(); mHoursToMinutesAnimator = null; } // We're already showing the correct picker. return; } mHoursToMinutesAnimator = ObjectAnimator.ofFloat(this, HOURS_TO_MINUTES, target); mHoursToMinutesAnimator.setAutoCancel(true); mHoursToMinutesAnimator.setDuration(duration); mHoursToMinutesAnimator.start(); } private void drawCircleBackground(Canvas canvas) { canvas.drawCircle(mXCenter, mYCenter, mCircleRadius, mPaintBackground); } private void drawHours(Canvas canvas, Path selectorPath, float alphaMod) { final int hoursAlpha = (int) (255f * (1f - mHoursToMinutes) * alphaMod + 0.5f); if (hoursAlpha > 0) { // Exclude the selector region, then draw inner/outer hours with no // activated states. canvas.save(Canvas.CLIP_SAVE_FLAG); canvas.clipPath(selectorPath, Region.Op.DIFFERENCE); drawHoursClipped(canvas, hoursAlpha, false); canvas.restore(); // Intersect the selector region, then draw minutes with only // activated states. canvas.save(Canvas.CLIP_SAVE_FLAG); canvas.clipPath(selectorPath, Region.Op.INTERSECT); drawHoursClipped(canvas, hoursAlpha, true); canvas.restore(); } } private void drawHoursClipped(Canvas canvas, int hoursAlpha, boolean showActivated) { // Draw outer hours. drawTextElements(canvas, mTextSize[HOURS], mTypeface, mTextColor[HOURS], mOuterTextHours, mOuterTextX[HOURS], mOuterTextY[HOURS], mPaint[HOURS], hoursAlpha, showActivated && !mIsOnInnerCircle, mSelectionDegrees[HOURS], showActivated); // Draw inner hours (13-00) for 24-hour time. if (mIs24HourMode && mInnerTextHours != null) { drawTextElements(canvas, mTextSize[HOURS_INNER], mTypeface, mTextColor[HOURS_INNER], mInnerTextHours, mInnerTextX, mInnerTextY, mPaint[HOURS], hoursAlpha, showActivated && mIsOnInnerCircle, mSelectionDegrees[HOURS], showActivated); } } private void drawMinutes(Canvas canvas, Path selectorPath, float alphaMod) { final int minutesAlpha = (int) (255f * mHoursToMinutes * alphaMod + 0.5f); if (minutesAlpha > 0) { // Exclude the selector region, then draw minutes with no // activated states. canvas.save(Canvas.CLIP_SAVE_FLAG); canvas.clipPath(selectorPath, Region.Op.DIFFERENCE); drawMinutesClipped(canvas, minutesAlpha, false); canvas.restore(); // Intersect the selector region, then draw minutes with only // activated states. canvas.save(Canvas.CLIP_SAVE_FLAG); canvas.clipPath(selectorPath, Region.Op.INTERSECT); drawMinutesClipped(canvas, minutesAlpha, true); canvas.restore(); } } private void drawMinutesClipped(Canvas canvas, int minutesAlpha, boolean showActivated) { drawTextElements(canvas, mTextSize[MINUTES], mTypeface, mTextColor[MINUTES], mMinutesText, mOuterTextX[MINUTES], mOuterTextY[MINUTES], mPaint[MINUTES], minutesAlpha, showActivated, mSelectionDegrees[MINUTES], showActivated); } private void drawCenter(Canvas canvas, float alphaMod) { mPaintCenter.setAlpha((int) (255 * alphaMod + 0.5f)); canvas.drawCircle(mXCenter, mYCenter, mCenterDotRadius, mPaintCenter); } private int getMultipliedAlpha(int argb, int alpha) { return (int) (Color.alpha(argb) * (alpha / 255.0) + 0.5); } private void drawSelector(Canvas canvas, Path selectorPath) { // Determine the current length, angle, and dot scaling factor. final int hoursIndex = mIsOnInnerCircle ? HOURS_INNER : HOURS; final int hoursInset = mTextInset[hoursIndex]; final int hoursAngleDeg = mSelectionDegrees[hoursIndex % 2]; final float hoursDotScale = mSelectionDegrees[hoursIndex % 2] % 30 != 0 ? 1 : 0; final int minutesIndex = MINUTES; final int minutesInset = mTextInset[minutesIndex]; final int minutesAngleDeg = mSelectionDegrees[minutesIndex]; final float minutesDotScale = mSelectionDegrees[minutesIndex] % 30 != 0 ? 1 : 0; // Calculate the current radius at which to place the selection circle. final int selRadius = mSelectorRadius; final float selLength = mCircleRadius - MathUtils.lerp(hoursInset, minutesInset, mHoursToMinutes); final double selAngleRad = Math.toRadians(MathUtils.lerpDeg(hoursAngleDeg, minutesAngleDeg, mHoursToMinutes)); final float selCenterX = mXCenter + selLength * (float) Math.sin(selAngleRad); final float selCenterY = mYCenter - selLength * (float) Math.cos(selAngleRad); // Draw the selection circle. final Paint paint = mPaintSelector[SELECTOR_CIRCLE]; paint.setColor(mSelectorColor); canvas.drawCircle(selCenterX, selCenterY, selRadius, paint); // If needed, set up the clip path for later. if (selectorPath != null) { selectorPath.reset(); selectorPath.addCircle(selCenterX, selCenterY, selRadius, Path.Direction.CCW); } // Draw the dot if we're between two items. final float dotScale = MathUtils.lerp(hoursDotScale, minutesDotScale, mHoursToMinutes); if (dotScale > 0) { final Paint dotPaint = mPaintSelector[SELECTOR_DOT]; dotPaint.setColor(mSelectorDotColor); canvas.drawCircle(selCenterX, selCenterY, mSelectorDotRadius * dotScale, dotPaint); } // Shorten the line to only go from the edge of the center dot to the // edge of the selection circle. final double sin = Math.sin(selAngleRad); final double cos = Math.cos(selAngleRad); final float lineLength = selLength - selRadius; final int centerX = mXCenter + (int) (mCenterDotRadius * sin); final int centerY = mYCenter - (int) (mCenterDotRadius * cos); final float linePointX = centerX + (int) (lineLength * sin); final float linePointY = centerY - (int) (lineLength * cos); // Draw the line. final Paint linePaint = mPaintSelector[SELECTOR_LINE]; linePaint.setColor(mSelectorColor); linePaint.setStrokeWidth(mSelectorStroke); canvas.drawLine(mXCenter, mYCenter, linePointX, linePointY, linePaint); } private void calculatePositionsHours() { // Calculate the text positions final float numbersRadius = mCircleRadius - mTextInset[HOURS]; // Calculate the positions for the 12 numbers in the main circle. calculatePositions(mPaint[HOURS], numbersRadius, mXCenter, mYCenter, mTextSize[HOURS], mOuterTextX[HOURS], mOuterTextY[HOURS]); // If we have an inner circle, calculate those positions too. if (mIs24HourMode) { final int innerNumbersRadius = mCircleRadius - mTextInset[HOURS_INNER]; calculatePositions(mPaint[HOURS], innerNumbersRadius, mXCenter, mYCenter, mTextSize[HOURS_INNER], mInnerTextX, mInnerTextY); } } private void calculatePositionsMinutes() { // Calculate the text positions final float numbersRadius = mCircleRadius - mTextInset[MINUTES]; // Calculate the positions for the 12 numbers in the main circle. calculatePositions(mPaint[MINUTES], numbersRadius, mXCenter, mYCenter, mTextSize[MINUTES], mOuterTextX[MINUTES], mOuterTextY[MINUTES]); }
Using the trigonometric Unit Circle, calculate the positions that the text will need to be drawn at based on the specified circle radius. Place the values in the textGridHeights and textGridWidths parameters.
/** * Using the trigonometric Unit Circle, calculate the positions that the text will need to be * drawn at based on the specified circle radius. Place the values in the textGridHeights and * textGridWidths parameters. */
private static void calculatePositions(Paint paint, float radius, float xCenter, float yCenter, float textSize, float[] x, float[] y) { // Adjust yCenter to account for the text's baseline. paint.setTextSize(textSize); yCenter -= (paint.descent() + paint.ascent()) / 2; for (int i = 0; i < NUM_POSITIONS; i++) { x[i] = xCenter - radius * COS_30[i]; y[i] = yCenter - radius * SIN_30[i]; } }
Draw the 12 text values at the positions specified by the textGrid parameters.
/** * Draw the 12 text values at the positions specified by the textGrid parameters. */
private void drawTextElements(Canvas canvas, float textSize, Typeface typeface, ColorStateList textColor, String[] texts, float[] textX, float[] textY, Paint paint, int alpha, boolean showActivated, int activatedDegrees, boolean activatedOnly) { paint.setTextSize(textSize); paint.setTypeface(typeface); // The activated index can touch a range of elements. final float activatedIndex = activatedDegrees / (360.0f / NUM_POSITIONS); final int activatedFloor = (int) activatedIndex; final int activatedCeil = ((int) Math.ceil(activatedIndex)) % NUM_POSITIONS; for (int i = 0; i < 12; i++) { final boolean activated = (activatedFloor == i || activatedCeil == i); if (activatedOnly && !activated) { continue; } final int stateMask = StateSet.VIEW_STATE_ENABLED | (showActivated && activated ? StateSet.VIEW_STATE_ACTIVATED : 0); final int color = textColor.getColorForState(StateSet.get(stateMask), 0); paint.setColor(color); paint.setAlpha(getMultipliedAlpha(color, alpha)); canvas.drawText(texts[i], textX[i], textY[i], paint); } } private int getDegreesFromXY(float x, float y, boolean constrainOutside) { // Ensure the point is inside the touchable area. final int innerBound; final int outerBound; if (mIs24HourMode && mShowHours) { innerBound = mMinDistForInnerNumber; outerBound = mMaxDistForOuterNumber; } else { final int index = mShowHours ? HOURS : MINUTES; final int center = mCircleRadius - mTextInset[index]; innerBound = center - mSelectorRadius; outerBound = center + mSelectorRadius; } final double dX = x - mXCenter; final double dY = y - mYCenter; final double distFromCenter = Math.sqrt(dX * dX + dY * dY); if (distFromCenter < innerBound || constrainOutside && distFromCenter > outerBound) { return -1; } // Convert to degrees. final int degrees = (int) (Math.toDegrees(Math.atan2(dY, dX) + Math.PI / 2) + 0.5); if (degrees < 0) { return degrees + 360; } else { return degrees; } } private boolean getInnerCircleFromXY(float x, float y) { if (mIs24HourMode && mShowHours) { final double dX = x - mXCenter; final double dY = y - mYCenter; final double distFromCenter = Math.sqrt(dX * dX + dY * dY); return distFromCenter <= mHalfwayDist; } return false; } boolean mChangedDuringTouch = false; @Override public boolean onTouchEvent(MotionEvent event) { if (!mInputEnabled) { return true; } final int action = event.getActionMasked(); if (action == MotionEvent.ACTION_MOVE || action == MotionEvent.ACTION_UP || action == MotionEvent.ACTION_DOWN) { boolean forceSelection = false; boolean autoAdvance = false; if (action == MotionEvent.ACTION_DOWN) { // This is a new event stream, reset whether the value changed. mChangedDuringTouch = false; } else if (action == MotionEvent.ACTION_UP) { autoAdvance = true; // If we saw a down/up pair without the value changing, assume // this is a single-tap selection and force a change. if (!mChangedDuringTouch) { forceSelection = true; } } mChangedDuringTouch |= handleTouchInput( event.getX(), event.getY(), forceSelection, autoAdvance); } return true; } private boolean handleTouchInput( float x, float y, boolean forceSelection, boolean autoAdvance) { final boolean isOnInnerCircle = getInnerCircleFromXY(x, y); final int degrees = getDegreesFromXY(x, y, false); if (degrees == -1) { return false; } // Ensure we're showing the correct picker. animatePicker(mShowHours, ANIM_DURATION_TOUCH); final @PickerType int type; final int newValue; final boolean valueChanged; if (mShowHours) { final int snapDegrees = snapOnly30s(degrees, 0) % 360; valueChanged = mIsOnInnerCircle != isOnInnerCircle || mSelectionDegrees[HOURS] != snapDegrees; mIsOnInnerCircle = isOnInnerCircle; mSelectionDegrees[HOURS] = snapDegrees; type = HOURS; newValue = getCurrentHour(); } else { final int snapDegrees = snapPrefer30s(degrees) % 360; valueChanged = mSelectionDegrees[MINUTES] != snapDegrees; mSelectionDegrees[MINUTES] = snapDegrees; type = MINUTES; newValue = getCurrentMinute(); } if (valueChanged || forceSelection || autoAdvance) { // Fire the listener even if we just need to auto-advance. if (mListener != null) { mListener.onValueSelected(type, newValue, autoAdvance); } // Only provide feedback if the value actually changed. if (valueChanged || forceSelection) { performHapticFeedback(HapticFeedbackConstants.CLOCK_TICK); invalidate(); } return true; } return false; } @Override public boolean dispatchHoverEvent(MotionEvent event) { // First right-of-refusal goes the touch exploration helper. if (mTouchHelper.dispatchHoverEvent(event)) { return true; } return super.dispatchHoverEvent(event); } public void setInputEnabled(boolean inputEnabled) { mInputEnabled = inputEnabled; invalidate(); } @Override public PointerIcon onResolvePointerIcon(MotionEvent event, int pointerIndex) { if (!isEnabled()) { return null; } final int degrees = getDegreesFromXY(event.getX(), event.getY(), false); if (degrees != -1) { return PointerIcon.getSystemIcon(getContext(), PointerIcon.TYPE_HAND); } return super.onResolvePointerIcon(event, pointerIndex); } private class RadialPickerTouchHelper extends ExploreByTouchHelper { private final Rect mTempRect = new Rect(); private final int TYPE_HOUR = 1; private final int TYPE_MINUTE = 2; private final int SHIFT_TYPE = 0; private final int MASK_TYPE = 0xF; private final int SHIFT_VALUE = 8; private final int MASK_VALUE = 0xFF;
Increment in which virtual views are exposed for minutes.
/** Increment in which virtual views are exposed for minutes. */
private final int MINUTE_INCREMENT = 5; public RadialPickerTouchHelper() { super(RadialTimePickerView.this); } @Override public void onInitializeAccessibilityNodeInfo(View host, AccessibilityNodeInfo info) { super.onInitializeAccessibilityNodeInfo(host, info); info.addAction(AccessibilityNodeInfo.AccessibilityAction.ACTION_SCROLL_FORWARD); info.addAction(AccessibilityNodeInfo.AccessibilityAction.ACTION_SCROLL_BACKWARD); } @Override public boolean performAccessibilityAction(View host, int action, Bundle arguments) { if (super.performAccessibilityAction(host, action, arguments)) { return true; } switch (action) { case AccessibilityNodeInfo.ACTION_SCROLL_FORWARD: adjustPicker(1); return true; case AccessibilityNodeInfo.ACTION_SCROLL_BACKWARD: adjustPicker(-1); return true; } return false; } private void adjustPicker(int step) { final int stepSize; final int initialStep; final int maxValue; final int minValue; if (mShowHours) { stepSize = 1; final int currentHour24 = getCurrentHour(); if (mIs24HourMode) { initialStep = currentHour24; minValue = 0; maxValue = 23; } else { initialStep = hour24To12(currentHour24); minValue = 1; maxValue = 12; } } else { stepSize = 5; initialStep = getCurrentMinute() / stepSize; minValue = 0; maxValue = 55; } final int nextValue = (initialStep + step) * stepSize; final int clampedValue = MathUtils.constrain(nextValue, minValue, maxValue); if (mShowHours) { setCurrentHour(clampedValue); } else { setCurrentMinute(clampedValue); } } @Override protected int getVirtualViewAt(float x, float y) { final int id; final int degrees = getDegreesFromXY(x, y, true); if (degrees != -1) { final int snapDegrees = snapOnly30s(degrees, 0) % 360; if (mShowHours) { final boolean isOnInnerCircle = getInnerCircleFromXY(x, y); final int hour24 = getHourForDegrees(snapDegrees, isOnInnerCircle); final int hour = mIs24HourMode ? hour24 : hour24To12(hour24); id = makeId(TYPE_HOUR, hour); } else { final int current = getCurrentMinute(); final int touched = getMinuteForDegrees(degrees); final int snapped = getMinuteForDegrees(snapDegrees); // If the touched minute is closer to the current minute // than it is to the snapped minute, return current. final int currentOffset = getCircularDiff(current, touched, MINUTES_IN_CIRCLE); final int snappedOffset = getCircularDiff(snapped, touched, MINUTES_IN_CIRCLE); final int minute; if (currentOffset < snappedOffset) { minute = current; } else { minute = snapped; } id = makeId(TYPE_MINUTE, minute); } } else { id = INVALID_ID; } return id; }
Returns the difference in degrees between two values along a circle.
Params:
  • first – value in the range [0,max]
  • second – value in the range [0,max]
  • max – the maximum value along the circle
Returns:the difference in between the two values
/** * Returns the difference in degrees between two values along a circle. * * @param first value in the range [0,max] * @param second value in the range [0,max] * @param max the maximum value along the circle * @return the difference in between the two values */
private int getCircularDiff(int first, int second, int max) { final int diff = Math.abs(first - second); final int midpoint = max / 2; return (diff > midpoint) ? (max - diff) : diff; } @Override protected void getVisibleVirtualViews(IntArray virtualViewIds) { if (mShowHours) { final int min = mIs24HourMode ? 0 : 1; final int max = mIs24HourMode ? 23 : 12; for (int i = min; i <= max ; i++) { virtualViewIds.add(makeId(TYPE_HOUR, i)); } } else { final int current = getCurrentMinute(); for (int i = 0; i < MINUTES_IN_CIRCLE; i += MINUTE_INCREMENT) { virtualViewIds.add(makeId(TYPE_MINUTE, i)); // If the current minute falls between two increments, // insert an extra node for it. if (current > i && current < i + MINUTE_INCREMENT) { virtualViewIds.add(makeId(TYPE_MINUTE, current)); } } } } @Override protected void onPopulateEventForVirtualView(int virtualViewId, AccessibilityEvent event) { event.setClassName(getClass().getName()); final int type = getTypeFromId(virtualViewId); final int value = getValueFromId(virtualViewId); final CharSequence description = getVirtualViewDescription(type, value); event.setContentDescription(description); } @Override protected void onPopulateNodeForVirtualView(int virtualViewId, AccessibilityNodeInfo node) { node.setClassName(getClass().getName()); node.addAction(AccessibilityAction.ACTION_CLICK); final int type = getTypeFromId(virtualViewId); final int value = getValueFromId(virtualViewId); final CharSequence description = getVirtualViewDescription(type, value); node.setContentDescription(description); getBoundsForVirtualView(virtualViewId, mTempRect); node.setBoundsInParent(mTempRect); final boolean selected = isVirtualViewSelected(type, value); node.setSelected(selected); final int nextId = getVirtualViewIdAfter(type, value); if (nextId != INVALID_ID) { node.setTraversalBefore(RadialTimePickerView.this, nextId); } } private int getVirtualViewIdAfter(int type, int value) { if (type == TYPE_HOUR) { final int nextValue = value + 1; final int max = mIs24HourMode ? 23 : 12; if (nextValue <= max) { return makeId(type, nextValue); } } else if (type == TYPE_MINUTE) { final int current = getCurrentMinute(); final int snapValue = value - (value % MINUTE_INCREMENT); final int nextValue = snapValue + MINUTE_INCREMENT; if (value < current && nextValue > current) { // The current value is between two snap values. return makeId(type, current); } else if (nextValue < MINUTES_IN_CIRCLE) { return makeId(type, nextValue); } } return INVALID_ID; } @Override protected boolean onPerformActionForVirtualView(int virtualViewId, int action, Bundle arguments) { if (action == AccessibilityNodeInfo.ACTION_CLICK) { final int type = getTypeFromId(virtualViewId); final int value = getValueFromId(virtualViewId); if (type == TYPE_HOUR) { final int hour = mIs24HourMode ? value : hour12To24(value, mAmOrPm); setCurrentHour(hour); return true; } else if (type == TYPE_MINUTE) { setCurrentMinute(value); return true; } } return false; } private int hour12To24(int hour12, int amOrPm) { int hour24 = hour12; if (hour12 == 12) { if (amOrPm == AM) { hour24 = 0; } } else if (amOrPm == PM) { hour24 += 12; } return hour24; } private int hour24To12(int hour24) { if (hour24 == 0) { return 12; } else if (hour24 > 12) { return hour24 - 12; } else { return hour24; } } private void getBoundsForVirtualView(int virtualViewId, Rect bounds) { final float radius; final int type = getTypeFromId(virtualViewId); final int value = getValueFromId(virtualViewId); final float centerRadius; final float degrees; if (type == TYPE_HOUR) { final boolean innerCircle = getInnerCircleForHour(value); if (innerCircle) { centerRadius = mCircleRadius - mTextInset[HOURS_INNER]; radius = mSelectorRadius; } else { centerRadius = mCircleRadius - mTextInset[HOURS]; radius = mSelectorRadius; } degrees = getDegreesForHour(value); } else if (type == TYPE_MINUTE) { centerRadius = mCircleRadius - mTextInset[MINUTES]; degrees = getDegreesForMinute(value); radius = mSelectorRadius; } else { // This should never happen. centerRadius = 0; degrees = 0; radius = 0; } final double radians = Math.toRadians(degrees); final float xCenter = mXCenter + centerRadius * (float) Math.sin(radians); final float yCenter = mYCenter - centerRadius * (float) Math.cos(radians); bounds.set((int) (xCenter - radius), (int) (yCenter - radius), (int) (xCenter + radius), (int) (yCenter + radius)); } private CharSequence getVirtualViewDescription(int type, int value) { final CharSequence description; if (type == TYPE_HOUR || type == TYPE_MINUTE) { description = Integer.toString(value); } else { description = null; } return description; } private boolean isVirtualViewSelected(int type, int value) { final boolean selected; if (type == TYPE_HOUR) { selected = getCurrentHour() == value; } else if (type == TYPE_MINUTE) { selected = getCurrentMinute() == value; } else { selected = false; } return selected; } private int makeId(int type, int value) { return type << SHIFT_TYPE | value << SHIFT_VALUE; } private int getTypeFromId(int id) { return id >>> SHIFT_TYPE & MASK_TYPE; } private int getValueFromId(int id) { return id >>> SHIFT_VALUE & MASK_VALUE; } } }