blob: 734aec3023c9a4f627b727fdce2bf7d34de87808 [file] [log] [blame]
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001/*
2 * Copyright (C) 2008 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
Daniel Sandler325dc232013-06-05 22:57:57 -040017package com.android.launcher3;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080018
Joe Onorato4be866d2010-10-10 11:26:02 -070019import android.animation.Animator;
Michael Jurka629758f2012-06-14 16:18:21 -070020import android.animation.AnimatorListenerAdapter;
Chet Haase00397b12010-10-07 11:13:10 -070021import android.animation.TimeInterpolator;
Patrick Dubroyde7658b2010-09-27 11:15:43 -070022import android.animation.ValueAnimator;
23import android.animation.ValueAnimator.AnimatorUpdateListener;
Sunny Goyal726bee72018-03-05 12:54:24 -080024import android.annotation.SuppressLint;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080025import android.content.Context;
Joe Onorato79e56262009-09-21 15:23:04 -040026import android.content.res.Resources;
Sunny Goyalc13403c2016-11-18 23:44:48 -080027import android.content.res.TypedArray;
Joe Onorato4be866d2010-10-10 11:26:02 -070028import android.graphics.Bitmap;
Winson Chungaafa03c2010-06-11 17:34:16 -070029import android.graphics.Canvas;
Andrew Flynn0dca1ec2012-02-29 13:33:22 -080030import android.graphics.Color;
Joe Onorato4be866d2010-10-10 11:26:02 -070031import android.graphics.Paint;
Patrick Dubroyde7658b2010-09-27 11:15:43 -070032import android.graphics.Point;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080033import android.graphics.Rect;
Adam Cohen482ed822012-03-02 14:15:13 -080034import android.graphics.drawable.ColorDrawable;
Patrick Dubroy6569f2c2010-07-12 14:25:18 -070035import android.graphics.drawable.Drawable;
Adam Cohen1462de32012-07-24 22:34:36 -070036import android.os.Parcelable;
Sunny Goyalc13403c2016-11-18 23:44:48 -080037import android.support.annotation.IntDef;
Adam Cohenc9735cf2015-01-23 16:11:55 -080038import android.support.v4.view.ViewCompat;
Rajeev Kumar9962dbe2017-06-12 12:16:20 -070039import android.util.ArrayMap;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080040import android.util.AttributeSet;
Joe Onorato4be866d2010-10-10 11:26:02 -070041import android.util.Log;
Adam Cohen1462de32012-07-24 22:34:36 -070042import android.util.SparseArray;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080043import android.view.MotionEvent;
44import android.view.View;
45import android.view.ViewDebug;
46import android.view.ViewGroup;
Adam Cohenc9735cf2015-01-23 16:11:55 -080047import android.view.accessibility.AccessibilityEvent;
Sunny Goyal5bc6b6f2017-10-26 15:36:10 -070048
Sunny Goyalaa8ef112015-06-12 20:04:41 -070049import com.android.launcher3.LauncherSettings.Favorites;
Sunny Goyale9b651e2015-04-24 11:44:51 -070050import com.android.launcher3.accessibility.DragAndDropAccessibilityDelegate;
51import com.android.launcher3.accessibility.FolderAccessibilityHelper;
52import com.android.launcher3.accessibility.WorkspaceAccessibilityHelper;
Sunny Goyal5bc6b6f2017-10-26 15:36:10 -070053import com.android.launcher3.anim.Interpolators;
Sunny Goyal9e76f682017-02-13 12:13:43 -080054import com.android.launcher3.anim.PropertyListBuilder;
Sunny Goyal3d706ad2017-03-06 16:56:39 -080055import com.android.launcher3.config.FeatureFlags;
Jon Mirandaa0233f72017-06-22 18:34:45 -070056import com.android.launcher3.folder.PreviewBackground;
Sunny Goyal06e21a22016-08-11 16:02:02 -070057import com.android.launcher3.graphics.DragPreviewProvider;
Sunny Goyalff4ba2d2016-04-02 14:12:34 -070058import com.android.launcher3.util.CellAndSpan;
59import com.android.launcher3.util.GridOccupancy;
Sunny Goyale2fd14b2015-08-27 17:45:46 -070060import com.android.launcher3.util.ParcelableSparseArray;
Sunny Goyal9b29ca52017-02-17 10:39:44 -080061import com.android.launcher3.util.Themes;
Adam Cohen091440a2015-03-18 14:16:05 -070062import com.android.launcher3.util.Thunk;
Sunny Goyal29947f02017-12-18 13:49:44 -080063import com.android.launcher3.widget.LauncherAppWidgetHostView;
Sunny Goyal5bc6b6f2017-10-26 15:36:10 -070064
Sunny Goyalc13403c2016-11-18 23:44:48 -080065import java.lang.annotation.Retention;
66import java.lang.annotation.RetentionPolicy;
Adam Cohen69ce2e52011-07-03 19:25:21 -070067import java.util.ArrayList;
Adam Cohenc0dcf592011-06-01 15:30:43 -070068import java.util.Arrays;
Adam Cohenf3900c22012-11-16 18:28:11 -080069import java.util.Collections;
70import java.util.Comparator;
Adam Cohend41fbf52012-02-16 23:53:59 -080071import java.util.Stack;
Adam Cohenc0dcf592011-06-01 15:30:43 -070072
Sunny Goyal726bee72018-03-05 12:54:24 -080073public class CellLayout extends ViewGroup {
Sunny Goyale9b651e2015-04-24 11:44:51 -070074 public static final int WORKSPACE_ACCESSIBILITY_DRAG = 2;
75 public static final int FOLDER_ACCESSIBILITY_DRAG = 1;
76
Tony Wickhama0628cc2015-10-14 15:23:04 -070077 private static final String TAG = "CellLayout";
78 private static final boolean LOGD = false;
Winson Chungaafa03c2010-06-11 17:34:16 -070079
Rajeev Kumar9962dbe2017-06-12 12:16:20 -070080 private final Launcher mLauncher;
Sunny Goyal4ffec482016-02-09 11:28:52 -080081 @ViewDebug.ExportedProperty(category = "launcher")
Adam Cohen091440a2015-03-18 14:16:05 -070082 @Thunk int mCellWidth;
Sunny Goyal4ffec482016-02-09 11:28:52 -080083 @ViewDebug.ExportedProperty(category = "launcher")
Adam Cohen091440a2015-03-18 14:16:05 -070084 @Thunk int mCellHeight;
Winson Chung11a1a532013-09-13 11:14:45 -070085 private int mFixedCellWidth;
86 private int mFixedCellHeight;
Winson Chungaafa03c2010-06-11 17:34:16 -070087
Sunny Goyal4ffec482016-02-09 11:28:52 -080088 @ViewDebug.ExportedProperty(category = "launcher")
Sunny Goyalff4ba2d2016-04-02 14:12:34 -070089 private int mCountX;
Sunny Goyal4ffec482016-02-09 11:28:52 -080090 @ViewDebug.ExportedProperty(category = "launcher")
Sunny Goyalff4ba2d2016-04-02 14:12:34 -070091 private int mCountY;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080092
Adam Cohen917e3882013-10-31 15:03:35 -070093 private boolean mDropPending = false;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080094
Patrick Dubroyde7658b2010-09-27 11:15:43 -070095 // These are temporary variables to prevent having to allocate a new object just to
96 // return an (x, y) value from helper functions. Do NOT use them to maintain other state.
Adam Cohen091440a2015-03-18 14:16:05 -070097 @Thunk final int[] mTmpPoint = new int[2];
Sunny Goyal2805e632015-05-20 15:35:32 -070098 @Thunk final int[] mTempLocation = new int[2];
Patrick Dubroy6569f2c2010-07-12 14:25:18 -070099
Sunny Goyalff4ba2d2016-04-02 14:12:34 -0700100 private GridOccupancy mOccupied;
101 private GridOccupancy mTmpOccupied;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800102
Michael Jurkadee05892010-07-27 10:01:56 -0700103 private OnTouchListener mInterceptTouchListener;
Rajeev Kumar9962dbe2017-06-12 12:16:20 -0700104 private final StylusEventHelper mStylusEventHelper;
Michael Jurkadee05892010-07-27 10:01:56 -0700105
Jon Mirandaa0233f72017-06-22 18:34:45 -0700106 private final ArrayList<PreviewBackground> mFolderBackgrounds = new ArrayList<>();
107 final PreviewBackground mFolderLeaveBehind = new PreviewBackground();
Adam Cohen69ce2e52011-07-03 19:25:21 -0700108
Sunny Goyalf5440cb2016-12-14 15:13:00 -0800109 private static final int[] BACKGROUND_STATE_ACTIVE = new int[] { android.R.attr.state_active };
Sunny Goyale15e2a82017-12-15 13:05:42 -0800110 private static final int[] BACKGROUND_STATE_DEFAULT = EMPTY_STATE_SET;
Sunny Goyalf5440cb2016-12-14 15:13:00 -0800111 private final Drawable mBackground;
Sunny Goyal2805e632015-05-20 15:35:32 -0700112
Adam Cohenf0f4eda2013-06-06 21:27:03 -0700113 // These values allow a fixed measurement to be set on the CellLayout.
114 private int mFixedWidth = -1;
115 private int mFixedHeight = -1;
116
Michael Jurka33945b22010-12-21 18:19:38 -0800117 // If we're actively dragging something over this screen, mIsDragOverlapping is true
118 private boolean mIsDragOverlapping = false;
Patrick Dubroy6569f2c2010-07-12 14:25:18 -0700119
Winson Chung150fbab2010-09-29 17:14:26 -0700120 // These arrays are used to implement the drag visualization on x-large screens.
Joe Onorato4be866d2010-10-10 11:26:02 -0700121 // They are used as circular arrays, indexed by mDragOutlineCurrent.
Rajeev Kumar9962dbe2017-06-12 12:16:20 -0700122 @Thunk final Rect[] mDragOutlines = new Rect[4];
123 @Thunk final float[] mDragOutlineAlphas = new float[mDragOutlines.length];
124 private final InterruptibleInOutAnimator[] mDragOutlineAnims =
Joe Onorato4be866d2010-10-10 11:26:02 -0700125 new InterruptibleInOutAnimator[mDragOutlines.length];
Winson Chung150fbab2010-09-29 17:14:26 -0700126
127 // Used as an index into the above 3 arrays; indicates which is the most current value.
Joe Onorato4be866d2010-10-10 11:26:02 -0700128 private int mDragOutlineCurrent = 0;
Patrick Dubroy8e58e912010-10-14 13:21:48 -0700129 private final Paint mDragOutlinePaint = new Paint();
Winson Chung150fbab2010-09-29 17:14:26 -0700130
Rajeev Kumar9962dbe2017-06-12 12:16:20 -0700131 @Thunk final ArrayMap<LayoutParams, Animator> mReorderAnimators = new ArrayMap<>();
132 @Thunk final ArrayMap<View, ReorderPreviewAnimation> mShakeAnimators = new ArrayMap<>();
Adam Cohen19f37922012-03-21 11:59:11 -0700133
134 private boolean mItemPlacementDirty = false;
Adam Cohenbfbfd262011-06-13 16:55:12 -0700135
Patrick Dubroy6569f2c2010-07-12 14:25:18 -0700136 // When a drag operation is in progress, holds the nearest cell to the touch point
137 private final int[] mDragCell = new int[2];
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800138
Joe Onorato4be866d2010-10-10 11:26:02 -0700139 private boolean mDragging = false;
140
Rajeev Kumar9962dbe2017-06-12 12:16:20 -0700141 private final TimeInterpolator mEaseOutInterpolator;
142 private final ShortcutAndWidgetContainer mShortcutsAndWidgets;
Patrick Dubroyce34a972010-10-19 10:34:32 -0700143
Sunny Goyalc13403c2016-11-18 23:44:48 -0800144 @Retention(RetentionPolicy.SOURCE)
145 @IntDef({WORKSPACE, HOTSEAT, FOLDER})
146 public @interface ContainerType{}
147 public static final int WORKSPACE = 0;
148 public static final int HOTSEAT = 1;
149 public static final int FOLDER = 2;
150
151 @ContainerType private final int mContainerType;
152
Jon Mirandab28c4fc2017-06-20 10:58:36 -0700153 private final float mChildScale = 1f;
Andrew Flynn0dca1ec2012-02-29 13:33:22 -0800154
Adam Cohenfa3c58f2013-12-06 16:10:55 -0800155 public static final int MODE_SHOW_REORDER_HINT = 0;
156 public static final int MODE_DRAG_OVER = 1;
157 public static final int MODE_ON_DROP = 2;
158 public static final int MODE_ON_DROP_EXTERNAL = 3;
159 public static final int MODE_ACCEPT_DROP = 4;
Adam Cohen19f37922012-03-21 11:59:11 -0700160 private static final boolean DESTRUCTIVE_REORDER = false;
Adam Cohen482ed822012-03-02 14:15:13 -0800161 private static final boolean DEBUG_VISUALIZE_OCCUPIED = false;
162
Adam Cohenfa3c58f2013-12-06 16:10:55 -0800163 private static final float REORDER_PREVIEW_MAGNITUDE = 0.12f;
Adam Cohen19f37922012-03-21 11:59:11 -0700164 private static final int REORDER_ANIMATION_DURATION = 150;
Sunny Goyalc13403c2016-11-18 23:44:48 -0800165 @Thunk final float mReorderPreviewAnimationMagnitude;
Adam Cohen19f37922012-03-21 11:59:11 -0700166
Rajeev Kumar9962dbe2017-06-12 12:16:20 -0700167 private final ArrayList<View> mIntersectingViews = new ArrayList<>();
168 private final Rect mOccupiedRect = new Rect();
169 private final int[] mDirectionVector = new int[2];
170 final int[] mPreviousReorderDirection = new int[2];
Adam Cohenb209e632012-03-27 17:09:36 -0700171 private static final int INVALID_DIRECTION = -100;
Adam Cohen482ed822012-03-02 14:15:13 -0800172
Sunny Goyal2805e632015-05-20 15:35:32 -0700173 private final Rect mTempRect = new Rect();
Winson Chung3a6e7f32013-10-09 15:50:52 -0700174
Michael Jurkaca993832012-06-29 15:17:04 -0700175 private final static Paint sPaint = new Paint();
Romain Guy8a0bff52012-05-06 13:14:33 -0700176
Adam Cohenc9735cf2015-01-23 16:11:55 -0800177 // Related to accessible drag and drop
Sunny Goyale9b651e2015-04-24 11:44:51 -0700178 private DragAndDropAccessibilityDelegate mTouchHelper;
Adam Cohenc9735cf2015-01-23 16:11:55 -0800179 private boolean mUseTouchHelper = false;
Adam Cohenc9735cf2015-01-23 16:11:55 -0800180
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800181 public CellLayout(Context context) {
182 this(context, null);
183 }
184
185 public CellLayout(Context context, AttributeSet attrs) {
186 this(context, attrs, 0);
187 }
188
189 public CellLayout(Context context, AttributeSet attrs, int defStyle) {
190 super(context, attrs, defStyle);
Sunny Goyalc13403c2016-11-18 23:44:48 -0800191 TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.CellLayout, defStyle, 0);
192 mContainerType = a.getInteger(R.styleable.CellLayout_containerType, WORKSPACE);
193 a.recycle();
Patrick Dubroy6569f2c2010-07-12 14:25:18 -0700194
195 // A ViewGroup usually does not draw, but CellLayout needs to draw a rectangle to show
196 // the user where a dragged item will land when dropped.
197 setWillNotDraw(false);
Romain Guyce3cbd12013-02-25 15:00:36 -0800198 setClipToPadding(false);
Tony2fd02082016-10-07 12:50:01 -0700199 mLauncher = Launcher.getLauncher(context);
Michael Jurkaa63c4522010-08-19 13:52:27 -0700200
Adam Cohen2e6da152015-05-06 11:42:25 -0700201 DeviceProfile grid = mLauncher.getDeviceProfile();
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800202
Winson Chung11a1a532013-09-13 11:14:45 -0700203 mCellWidth = mCellHeight = -1;
Nilesh Agrawal5f7099a2014-01-02 15:54:57 -0800204 mFixedCellWidth = mFixedCellHeight = -1;
Sunny Goyalff4ba2d2016-04-02 14:12:34 -0700205
206 mCountX = grid.inv.numColumns;
207 mCountY = grid.inv.numRows;
208 mOccupied = new GridOccupancy(mCountX, mCountY);
209 mTmpOccupied = new GridOccupancy(mCountX, mCountY);
210
Adam Cohen5b53f292012-03-29 14:30:35 -0700211 mPreviousReorderDirection[0] = INVALID_DIRECTION;
212 mPreviousReorderDirection[1] = INVALID_DIRECTION;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800213
Adam Cohenefca0272016-02-24 19:19:06 -0800214 mFolderLeaveBehind.delegateCellX = -1;
215 mFolderLeaveBehind.delegateCellY = -1;
216
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800217 setAlwaysDrawnWithCacheEnabled(false);
Patrick Dubroy046e7eb2010-10-06 12:14:43 -0700218 final Resources res = getResources();
Patrick Dubroyde7658b2010-09-27 11:15:43 -0700219
Sunny Goyalf5440cb2016-12-14 15:13:00 -0800220 mBackground = res.getDrawable(R.drawable.bg_celllayout);
Sunny Goyal2805e632015-05-20 15:35:32 -0700221 mBackground.setCallback(this);
Sunny Goyalaeb16432017-10-16 11:46:41 -0700222 mBackground.setAlpha(0);
Michael Jurka33945b22010-12-21 18:19:38 -0800223
Sunny Goyalc13403c2016-11-18 23:44:48 -0800224 mReorderPreviewAnimationMagnitude = (REORDER_PREVIEW_MAGNITUDE * grid.iconSizePx);
Adam Cohen19f37922012-03-21 11:59:11 -0700225
Patrick Dubroy046e7eb2010-10-06 12:14:43 -0700226 // Initialize the data structures used for the drag visualization.
Sunny Goyal5bc6b6f2017-10-26 15:36:10 -0700227 mEaseOutInterpolator = Interpolators.DEACCEL_2_5; // Quint ease out
Winson Chungb8c69f32011-10-19 21:36:08 -0700228 mDragCell[0] = mDragCell[1] = -1;
Joe Onorato4be866d2010-10-10 11:26:02 -0700229 for (int i = 0; i < mDragOutlines.length; i++) {
Adam Cohend41fbf52012-02-16 23:53:59 -0800230 mDragOutlines[i] = new Rect(-1, -1, -1, -1);
Patrick Dubroy046e7eb2010-10-06 12:14:43 -0700231 }
Mario Bertschler54ba6012017-06-08 10:53:53 -0700232 mDragOutlinePaint.setColor(Themes.getAttrColor(context, R.attr.workspaceTextColor));
Patrick Dubroy046e7eb2010-10-06 12:14:43 -0700233
234 // When dragging things around the home screens, we show a green outline of
235 // where the item will land. The outlines gradually fade out, leaving a trail
236 // behind the drag path.
237 // Set up all the animations that are used to implement this fading.
238 final int duration = res.getInteger(R.integer.config_dragOutlineFadeTime);
Chet Haase472b2812010-10-14 07:02:04 -0700239 final float fromAlphaValue = 0;
240 final float toAlphaValue = (float)res.getInteger(R.integer.config_dragOutlineMaxAlpha);
Joe Onorato4be866d2010-10-10 11:26:02 -0700241
Patrick Dubroy8e58e912010-10-14 13:21:48 -0700242 Arrays.fill(mDragOutlineAlphas, fromAlphaValue);
Joe Onorato4be866d2010-10-10 11:26:02 -0700243
244 for (int i = 0; i < mDragOutlineAnims.length; i++) {
Patrick Dubroy046e7eb2010-10-06 12:14:43 -0700245 final InterruptibleInOutAnimator anim =
Michael Jurkaf1ad6082013-03-13 12:55:46 +0100246 new InterruptibleInOutAnimator(this, duration, fromAlphaValue, toAlphaValue);
Patrick Dubroyce34a972010-10-19 10:34:32 -0700247 anim.getAnimator().setInterpolator(mEaseOutInterpolator);
Patrick Dubroy046e7eb2010-10-06 12:14:43 -0700248 final int thisIndex = i;
Chet Haase472b2812010-10-14 07:02:04 -0700249 anim.getAnimator().addUpdateListener(new AnimatorUpdateListener() {
Patrick Dubroyde7658b2010-09-27 11:15:43 -0700250 public void onAnimationUpdate(ValueAnimator animation) {
Joe Onorato4be866d2010-10-10 11:26:02 -0700251 final Bitmap outline = (Bitmap)anim.getTag();
252
253 // If an animation is started and then stopped very quickly, we can still
254 // get spurious updates we've cleared the tag. Guard against this.
255 if (outline == null) {
Tony Wickhama0628cc2015-10-14 15:23:04 -0700256 if (LOGD) {
Patrick Dubroyfe6bd872010-10-13 17:32:10 -0700257 Object val = animation.getAnimatedValue();
258 Log.d(TAG, "anim " + thisIndex + " update: " + val +
259 ", isStopped " + anim.isStopped());
260 }
Joe Onorato4be866d2010-10-10 11:26:02 -0700261 // Try to prevent it from continuing to run
262 animation.cancel();
263 } else {
Chet Haase472b2812010-10-14 07:02:04 -0700264 mDragOutlineAlphas[thisIndex] = (Float) animation.getAnimatedValue();
Adam Cohend41fbf52012-02-16 23:53:59 -0800265 CellLayout.this.invalidate(mDragOutlines[thisIndex]);
Joe Onorato4be866d2010-10-10 11:26:02 -0700266 }
Patrick Dubroyde7658b2010-09-27 11:15:43 -0700267 }
268 });
Joe Onorato4be866d2010-10-10 11:26:02 -0700269 // The animation holds a reference to the drag outline bitmap as long is it's
270 // running. This way the bitmap can be GCed when the animations are complete.
Chet Haase472b2812010-10-14 07:02:04 -0700271 anim.getAnimator().addListener(new AnimatorListenerAdapter() {
Michael Jurka3c4c20f2010-10-28 15:36:06 -0700272 @Override
Joe Onorato4be866d2010-10-10 11:26:02 -0700273 public void onAnimationEnd(Animator animation) {
Chet Haase472b2812010-10-14 07:02:04 -0700274 if ((Float) ((ValueAnimator) animation).getAnimatedValue() == 0f) {
Joe Onorato4be866d2010-10-10 11:26:02 -0700275 anim.setTag(null);
276 }
277 }
278 });
279 mDragOutlineAnims[i] = anim;
Patrick Dubroyde7658b2010-09-27 11:15:43 -0700280 }
Patrick Dubroyce34a972010-10-19 10:34:32 -0700281
Sunny Goyalc13403c2016-11-18 23:44:48 -0800282 mShortcutsAndWidgets = new ShortcutAndWidgetContainer(context, mContainerType);
Sunny Goyalaa8a8712016-11-20 15:26:01 +0530283 mShortcutsAndWidgets.setCellDimensions(mCellWidth, mCellHeight, mCountX, mCountY);
Adam Cohen2374abf2013-04-16 14:56:57 -0700284
Mady Mellorbb835202015-07-15 16:34:34 -0700285 mStylusEventHelper = new StylusEventHelper(new SimpleOnStylusPressListener(this), this);
Michael Jurkaa52570f2012-03-20 03:18:20 -0700286 addView(mShortcutsAndWidgets);
Michael Jurka18014792010-10-14 09:01:34 -0700287 }
288
Sunny Goyale9b651e2015-04-24 11:44:51 -0700289 public void enableAccessibleDrag(boolean enable, int dragType) {
Adam Cohenc9735cf2015-01-23 16:11:55 -0800290 mUseTouchHelper = enable;
291 if (!enable) {
292 ViewCompat.setAccessibilityDelegate(this, null);
293 setImportantForAccessibility(IMPORTANT_FOR_ACCESSIBILITY_NO);
294 getShortcutsAndWidgets().setImportantForAccessibility(IMPORTANT_FOR_ACCESSIBILITY_NO);
295 setOnClickListener(mLauncher);
296 } else {
Sunny Goyale9b651e2015-04-24 11:44:51 -0700297 if (dragType == WORKSPACE_ACCESSIBILITY_DRAG &&
298 !(mTouchHelper instanceof WorkspaceAccessibilityHelper)) {
299 mTouchHelper = new WorkspaceAccessibilityHelper(this);
300 } else if (dragType == FOLDER_ACCESSIBILITY_DRAG &&
301 !(mTouchHelper instanceof FolderAccessibilityHelper)) {
302 mTouchHelper = new FolderAccessibilityHelper(this);
303 }
Adam Cohenc9735cf2015-01-23 16:11:55 -0800304 ViewCompat.setAccessibilityDelegate(this, mTouchHelper);
305 setImportantForAccessibility(IMPORTANT_FOR_ACCESSIBILITY_YES);
306 getShortcutsAndWidgets().setImportantForAccessibility(IMPORTANT_FOR_ACCESSIBILITY_YES);
307 setOnClickListener(mTouchHelper);
308 }
309
310 // Invalidate the accessibility hierarchy
311 if (getParent() != null) {
312 getParent().notifySubtreeAccessibilityStateChanged(
313 this, this, AccessibilityEvent.CONTENT_CHANGE_TYPE_SUBTREE);
314 }
315 }
316
317 @Override
318 public boolean dispatchHoverEvent(MotionEvent event) {
319 // Always attempt to dispatch hover events to accessibility first.
320 if (mUseTouchHelper && mTouchHelper.dispatchHoverEvent(event)) {
321 return true;
322 }
323 return super.dispatchHoverEvent(event);
324 }
325
326 @Override
Adam Cohenc9735cf2015-01-23 16:11:55 -0800327 public boolean onInterceptTouchEvent(MotionEvent ev) {
328 if (mUseTouchHelper ||
329 (mInterceptTouchListener != null && mInterceptTouchListener.onTouch(this, ev))) {
330 return true;
331 }
332 return false;
333 }
334
Mady Melloref044dd2015-06-02 15:35:07 -0700335 @Override
336 public boolean onTouchEvent(MotionEvent ev) {
337 boolean handled = super.onTouchEvent(ev);
338 // Stylus button press on a home screen should not switch between overview mode and
339 // the home screen mode, however, once in overview mode stylus button press should be
340 // enabled to allow rearranging the different home screens. So check what mode
341 // the workspace is in, and only perform stylus button presses while in overview mode.
Sunny Goyalf9403d92017-10-18 10:55:56 -0700342 if (mLauncher.isInState(LauncherState.OVERVIEW)
Mady Mellorbb835202015-07-15 16:34:34 -0700343 && mStylusEventHelper.onMotionEvent(ev)) {
Mady Melloref044dd2015-06-02 15:35:07 -0700344 return true;
345 }
346 return handled;
347 }
348
Chris Craik01f2d7f2013-10-01 14:41:56 -0700349 public void enableHardwareLayer(boolean hasLayer) {
350 mShortcutsAndWidgets.setLayerType(hasLayer ? LAYER_TYPE_HARDWARE : LAYER_TYPE_NONE, sPaint);
Michael Jurkad51f33a2012-06-28 15:35:26 -0700351 }
352
Winson Chung5f8afe62013-08-12 16:19:28 -0700353 public void setCellDimensions(int width, int height) {
Winson Chung11a1a532013-09-13 11:14:45 -0700354 mFixedCellWidth = mCellWidth = width;
355 mFixedCellHeight = mCellHeight = height;
Sunny Goyalaa8a8712016-11-20 15:26:01 +0530356 mShortcutsAndWidgets.setCellDimensions(mCellWidth, mCellHeight, mCountX, mCountY);
Winson Chung5f8afe62013-08-12 16:19:28 -0700357 }
358
Adam Cohen2801caf2011-05-13 20:57:39 -0700359 public void setGridSize(int x, int y) {
360 mCountX = x;
361 mCountY = y;
Sunny Goyalff4ba2d2016-04-02 14:12:34 -0700362 mOccupied = new GridOccupancy(mCountX, mCountY);
363 mTmpOccupied = new GridOccupancy(mCountX, mCountY);
Adam Cohen7fbec102012-03-27 12:42:19 -0700364 mTempRectStack.clear();
Sunny Goyalaa8a8712016-11-20 15:26:01 +0530365 mShortcutsAndWidgets.setCellDimensions(mCellWidth, mCellHeight, mCountX, mCountY);
Adam Cohen76fc0852011-06-17 13:26:23 -0700366 requestLayout();
Adam Cohen2801caf2011-05-13 20:57:39 -0700367 }
368
Adam Cohen2374abf2013-04-16 14:56:57 -0700369 // Set whether or not to invert the layout horizontally if the layout is in RTL mode.
370 public void setInvertIfRtl(boolean invert) {
371 mShortcutsAndWidgets.setInvertIfRtl(invert);
372 }
373
Adam Cohen917e3882013-10-31 15:03:35 -0700374 public void setDropPending(boolean pending) {
375 mDropPending = pending;
376 }
377
378 public boolean isDropPending() {
379 return mDropPending;
380 }
381
Adam Cohenc50438c2014-08-19 17:43:05 -0700382 void setIsDragOverlapping(boolean isDragOverlapping) {
383 if (mIsDragOverlapping != isDragOverlapping) {
384 mIsDragOverlapping = isDragOverlapping;
Sunny Goyalf5440cb2016-12-14 15:13:00 -0800385 mBackground.setState(mIsDragOverlapping
386 ? BACKGROUND_STATE_ACTIVE : BACKGROUND_STATE_DEFAULT);
Adam Cohenc50438c2014-08-19 17:43:05 -0700387 invalidate();
388 }
389 }
390
Sunny Goyale2fd14b2015-08-27 17:45:46 -0700391 @Override
392 protected void dispatchSaveInstanceState(SparseArray<Parcelable> container) {
Sunny Goyal7ce471b2017-08-02 03:37:39 -0700393 ParcelableSparseArray jail = getJailedArray(container);
394 super.dispatchSaveInstanceState(jail);
395 container.put(R.id.cell_layout_jail_id, jail);
Sunny Goyale2fd14b2015-08-27 17:45:46 -0700396 }
397
398 @Override
399 protected void dispatchRestoreInstanceState(SparseArray<Parcelable> container) {
Sunny Goyal7ce471b2017-08-02 03:37:39 -0700400 super.dispatchRestoreInstanceState(getJailedArray(container));
Sunny Goyale2fd14b2015-08-27 17:45:46 -0700401 }
402
Sunny Goyal7ce471b2017-08-02 03:37:39 -0700403 /**
404 * Wrap the SparseArray in another Parcelable so that the item ids do not conflict with our
405 * our internal resource ids
406 */
Sunny Goyale2fd14b2015-08-27 17:45:46 -0700407 private ParcelableSparseArray getJailedArray(SparseArray<Parcelable> container) {
408 final Parcelable parcelable = container.get(R.id.cell_layout_jail_id);
409 return parcelable instanceof ParcelableSparseArray ?
410 (ParcelableSparseArray) parcelable : new ParcelableSparseArray();
411 }
412
Tony Wickham0f97b782015-12-02 17:55:07 -0800413 public boolean getIsDragOverlapping() {
414 return mIsDragOverlapping;
415 }
416
Jeff Sharkey83f111d2009-04-20 21:03:13 -0700417 @Override
Patrick Dubroy1262e362010-10-06 15:49:50 -0700418 protected void onDraw(Canvas canvas) {
Michael Jurka3e7c7632010-10-02 16:01:03 -0700419 // When we're large, we are either drawn in a "hover" state (ie when dragging an item to
420 // a neighboring page) or with just a normal background (if backgroundAlpha > 0.0f)
421 // When we're small, we are either drawn normally or in the "accepts drops" state (during
422 // a drag). However, we also drag the mini hover background *over* one of those two
423 // backgrounds
Sunny Goyalaeb16432017-10-16 11:46:41 -0700424 if (mBackground.getAlpha() > 0) {
Sunny Goyal2805e632015-05-20 15:35:32 -0700425 mBackground.draw(canvas);
Michael Jurkaa63c4522010-08-19 13:52:27 -0700426 }
Romain Guya6abce82009-11-10 02:54:41 -0800427
Patrick Dubroy8e58e912010-10-14 13:21:48 -0700428 final Paint paint = mDragOutlinePaint;
Joe Onorato4be866d2010-10-10 11:26:02 -0700429 for (int i = 0; i < mDragOutlines.length; i++) {
Chet Haase472b2812010-10-14 07:02:04 -0700430 final float alpha = mDragOutlineAlphas[i];
Joe Onorato4be866d2010-10-10 11:26:02 -0700431 if (alpha > 0) {
Joe Onorato4be866d2010-10-10 11:26:02 -0700432 final Bitmap b = (Bitmap) mDragOutlineAnims[i].getTag();
Chet Haase472b2812010-10-14 07:02:04 -0700433 paint.setAlpha((int)(alpha + .5f));
Sunny Goyal106bf642015-07-16 12:18:06 -0700434 canvas.drawBitmap(b, null, mDragOutlines[i], paint);
Winson Chung150fbab2010-09-29 17:14:26 -0700435 }
Patrick Dubroy6569f2c2010-07-12 14:25:18 -0700436 }
Patrick Dubroy96864c32011-03-10 17:17:23 -0800437
Adam Cohen482ed822012-03-02 14:15:13 -0800438 if (DEBUG_VISUALIZE_OCCUPIED) {
439 int[] pt = new int[2];
440 ColorDrawable cd = new ColorDrawable(Color.RED);
Adam Cohene7587d22012-05-24 18:50:02 -0700441 cd.setBounds(0, 0, mCellWidth, mCellHeight);
Adam Cohen482ed822012-03-02 14:15:13 -0800442 for (int i = 0; i < mCountX; i++) {
443 for (int j = 0; j < mCountY; j++) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -0700444 if (mOccupied.cells[i][j]) {
Adam Cohen482ed822012-03-02 14:15:13 -0800445 cellToPoint(i, j, pt);
446 canvas.save();
447 canvas.translate(pt[0], pt[1]);
448 cd.draw(canvas);
449 canvas.restore();
450 }
451 }
452 }
453 }
454
Adam Cohenefca0272016-02-24 19:19:06 -0800455 for (int i = 0; i < mFolderBackgrounds.size(); i++) {
Jon Mirandaa0233f72017-06-22 18:34:45 -0700456 PreviewBackground bg = mFolderBackgrounds.get(i);
Adam Cohenefca0272016-02-24 19:19:06 -0800457 cellToPoint(bg.delegateCellX, bg.delegateCellY, mTempLocation);
458 canvas.save();
459 canvas.translate(mTempLocation[0], mTempLocation[1]);
Sunny Goyal19b93b72017-02-19 20:21:37 -0800460 bg.drawBackground(canvas);
Adam Cohenf172b742016-03-30 19:28:34 -0700461 if (!bg.isClipping) {
Sunny Goyal19b93b72017-02-19 20:21:37 -0800462 bg.drawBackgroundStroke(canvas);
Adam Cohenf172b742016-03-30 19:28:34 -0700463 }
Adam Cohenefca0272016-02-24 19:19:06 -0800464 canvas.restore();
Adam Cohen69ce2e52011-07-03 19:25:21 -0700465 }
Adam Cohenc51934b2011-07-26 21:07:43 -0700466
Adam Cohenefca0272016-02-24 19:19:06 -0800467 if (mFolderLeaveBehind.delegateCellX >= 0 && mFolderLeaveBehind.delegateCellY >= 0) {
468 cellToPoint(mFolderLeaveBehind.delegateCellX,
469 mFolderLeaveBehind.delegateCellY, mTempLocation);
470 canvas.save();
471 canvas.translate(mTempLocation[0], mTempLocation[1]);
Sunny Goyal19b93b72017-02-19 20:21:37 -0800472 mFolderLeaveBehind.drawLeaveBehind(canvas);
Adam Cohenefca0272016-02-24 19:19:06 -0800473 canvas.restore();
Adam Cohenc51934b2011-07-26 21:07:43 -0700474 }
Adam Cohen69ce2e52011-07-03 19:25:21 -0700475 }
476
Adam Cohenefca0272016-02-24 19:19:06 -0800477 @Override
478 protected void dispatchDraw(Canvas canvas) {
479 super.dispatchDraw(canvas);
480
481 for (int i = 0; i < mFolderBackgrounds.size(); i++) {
Jon Mirandaa0233f72017-06-22 18:34:45 -0700482 PreviewBackground bg = mFolderBackgrounds.get(i);
Adam Cohenf172b742016-03-30 19:28:34 -0700483 if (bg.isClipping) {
484 cellToPoint(bg.delegateCellX, bg.delegateCellY, mTempLocation);
485 canvas.save();
486 canvas.translate(mTempLocation[0], mTempLocation[1]);
Sunny Goyal19b93b72017-02-19 20:21:37 -0800487 bg.drawBackgroundStroke(canvas);
Adam Cohenf172b742016-03-30 19:28:34 -0700488 canvas.restore();
489 }
Adam Cohenefca0272016-02-24 19:19:06 -0800490 }
Adam Cohen69ce2e52011-07-03 19:25:21 -0700491 }
492
Jon Mirandaa0233f72017-06-22 18:34:45 -0700493 public void addFolderBackground(PreviewBackground bg) {
Adam Cohenefca0272016-02-24 19:19:06 -0800494 mFolderBackgrounds.add(bg);
495 }
Jon Mirandaa0233f72017-06-22 18:34:45 -0700496 public void removeFolderBackground(PreviewBackground bg) {
Adam Cohenefca0272016-02-24 19:19:06 -0800497 mFolderBackgrounds.remove(bg);
Patrick Dubroy6569f2c2010-07-12 14:25:18 -0700498 }
499
Adam Cohenc51934b2011-07-26 21:07:43 -0700500 public void setFolderLeaveBehindCell(int x, int y) {
Adam Cohenefca0272016-02-24 19:19:06 -0800501 View child = getChildAt(x, y);
Sunny Goyal368ae772017-05-24 13:19:15 -0700502 mFolderLeaveBehind.setup(mLauncher, null,
Adam Cohenefca0272016-02-24 19:19:06 -0800503 child.getMeasuredWidth(), child.getPaddingTop());
504
505 mFolderLeaveBehind.delegateCellX = x;
506 mFolderLeaveBehind.delegateCellY = y;
Adam Cohenc51934b2011-07-26 21:07:43 -0700507 invalidate();
508 }
509
510 public void clearFolderLeaveBehind() {
Adam Cohenefca0272016-02-24 19:19:06 -0800511 mFolderLeaveBehind.delegateCellX = -1;
512 mFolderLeaveBehind.delegateCellY = -1;
Adam Cohenc51934b2011-07-26 21:07:43 -0700513 invalidate();
514 }
515
Patrick Dubroy6569f2c2010-07-12 14:25:18 -0700516 @Override
Michael Jurkae6235dd2011-10-04 15:02:05 -0700517 public boolean shouldDelayChildPressedState() {
518 return false;
519 }
520
Adam Cohen1462de32012-07-24 22:34:36 -0700521 public void restoreInstanceState(SparseArray<Parcelable> states) {
Sunny Goyal33a152f2014-07-22 12:13:14 -0700522 try {
523 dispatchRestoreInstanceState(states);
524 } catch (IllegalArgumentException ex) {
Sunny Goyal3d706ad2017-03-06 16:56:39 -0800525 if (FeatureFlags.IS_DOGFOOD_BUILD) {
Sunny Goyal33a152f2014-07-22 12:13:14 -0700526 throw ex;
527 }
528 // Mismatched viewId / viewType preventing restore. Skip restore on production builds.
529 Log.e(TAG, "Ignoring an error while restoring a view instance state", ex);
530 }
Adam Cohen1462de32012-07-24 22:34:36 -0700531 }
532
Michael Jurkae6235dd2011-10-04 15:02:05 -0700533 @Override
Jeff Sharkey83f111d2009-04-20 21:03:13 -0700534 public void cancelLongPress() {
535 super.cancelLongPress();
536
537 // Cancel long press for all children
538 final int count = getChildCount();
539 for (int i = 0; i < count; i++) {
540 final View child = getChildAt(i);
541 child.cancelLongPress();
542 }
543 }
544
Michael Jurkadee05892010-07-27 10:01:56 -0700545 public void setOnInterceptTouchListener(View.OnTouchListener listener) {
546 mInterceptTouchListener = listener;
547 }
548
Hyunyoung Songee3e6a72015-02-20 14:25:27 -0800549 public int getCountX() {
Adam Cohend22015c2010-07-26 22:02:18 -0700550 return mCountX;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800551 }
552
Hyunyoung Songee3e6a72015-02-20 14:25:27 -0800553 public int getCountY() {
Adam Cohend22015c2010-07-26 22:02:18 -0700554 return mCountY;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800555 }
556
Sunny Goyalc13403c2016-11-18 23:44:48 -0800557 public boolean acceptsWidget() {
558 return mContainerType == WORKSPACE;
Sunny Goyale9b651e2015-04-24 11:44:51 -0700559 }
560
Andrew Flynn0dca1ec2012-02-29 13:33:22 -0800561 public boolean addViewToCellLayout(View child, int index, int childId, LayoutParams params,
Sunny Goyalf7a29e82015-04-24 15:20:43 -0700562 boolean markCells) {
Winson Chungaafa03c2010-06-11 17:34:16 -0700563 final LayoutParams lp = params;
564
Andrew Flynnde38e422012-05-08 11:22:15 -0700565 // Hotseat icons - remove text
Andrew Flynn0dca1ec2012-02-29 13:33:22 -0800566 if (child instanceof BubbleTextView) {
567 BubbleTextView bubbleChild = (BubbleTextView) child;
Jon Mirandaf1eae802017-10-04 11:23:33 -0700568 bubbleChild.setTextVisibility(mContainerType != HOTSEAT);
Andrew Flynn0dca1ec2012-02-29 13:33:22 -0800569 }
570
Sunny Goyalc13403c2016-11-18 23:44:48 -0800571 child.setScaleX(mChildScale);
572 child.setScaleY(mChildScale);
Adam Cohen307fe232012-08-16 17:55:58 -0700573
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800574 // Generate an id for each view, this assumes we have at most 256x256 cells
575 // per workspace screen
Adam Cohend22015c2010-07-26 22:02:18 -0700576 if (lp.cellX >= 0 && lp.cellX <= mCountX - 1 && lp.cellY >= 0 && lp.cellY <= mCountY - 1) {
Winson Chungaafa03c2010-06-11 17:34:16 -0700577 // If the horizontal or vertical span is set to -1, it is taken to
578 // mean that it spans the extent of the CellLayout
Adam Cohend22015c2010-07-26 22:02:18 -0700579 if (lp.cellHSpan < 0) lp.cellHSpan = mCountX;
580 if (lp.cellVSpan < 0) lp.cellVSpan = mCountY;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800581
Winson Chungaafa03c2010-06-11 17:34:16 -0700582 child.setId(childId);
Tony Wickhama0628cc2015-10-14 15:23:04 -0700583 if (LOGD) {
584 Log.d(TAG, "Adding view to ShortcutsAndWidgetsContainer: " + child);
585 }
Sunny Goyalf7a29e82015-04-24 15:20:43 -0700586 mShortcutsAndWidgets.addView(child, index, lp);
Michael Jurkadee05892010-07-27 10:01:56 -0700587
Michael Jurkaf3ca3ab2010-10-20 17:08:24 -0700588 if (markCells) markCellsAsOccupiedForView(child);
Michael Jurka0280c3b2010-09-17 15:00:07 -0700589
Winson Chungaafa03c2010-06-11 17:34:16 -0700590 return true;
591 }
592 return false;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800593 }
Michael Jurka3e7c7632010-10-02 16:01:03 -0700594
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800595 @Override
Michael Jurka0280c3b2010-09-17 15:00:07 -0700596 public void removeAllViews() {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -0700597 mOccupied.clear();
Michael Jurkaa52570f2012-03-20 03:18:20 -0700598 mShortcutsAndWidgets.removeAllViews();
Michael Jurka0280c3b2010-09-17 15:00:07 -0700599 }
600
601 @Override
602 public void removeAllViewsInLayout() {
Michael Jurkaa52570f2012-03-20 03:18:20 -0700603 if (mShortcutsAndWidgets.getChildCount() > 0) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -0700604 mOccupied.clear();
Michael Jurkaa52570f2012-03-20 03:18:20 -0700605 mShortcutsAndWidgets.removeAllViewsInLayout();
Michael Jurka7cfc2822011-08-02 20:19:24 -0700606 }
Michael Jurka0280c3b2010-09-17 15:00:07 -0700607 }
608
609 @Override
610 public void removeView(View view) {
611 markCellsAsUnoccupiedForView(view);
Michael Jurkaa52570f2012-03-20 03:18:20 -0700612 mShortcutsAndWidgets.removeView(view);
Michael Jurka0280c3b2010-09-17 15:00:07 -0700613 }
614
615 @Override
616 public void removeViewAt(int index) {
Michael Jurkaa52570f2012-03-20 03:18:20 -0700617 markCellsAsUnoccupiedForView(mShortcutsAndWidgets.getChildAt(index));
618 mShortcutsAndWidgets.removeViewAt(index);
Michael Jurka0280c3b2010-09-17 15:00:07 -0700619 }
620
621 @Override
622 public void removeViewInLayout(View view) {
623 markCellsAsUnoccupiedForView(view);
Michael Jurkaa52570f2012-03-20 03:18:20 -0700624 mShortcutsAndWidgets.removeViewInLayout(view);
Michael Jurka0280c3b2010-09-17 15:00:07 -0700625 }
626
627 @Override
628 public void removeViews(int start, int count) {
629 for (int i = start; i < start + count; i++) {
Michael Jurkaa52570f2012-03-20 03:18:20 -0700630 markCellsAsUnoccupiedForView(mShortcutsAndWidgets.getChildAt(i));
Michael Jurka0280c3b2010-09-17 15:00:07 -0700631 }
Michael Jurkaa52570f2012-03-20 03:18:20 -0700632 mShortcutsAndWidgets.removeViews(start, count);
Michael Jurka0280c3b2010-09-17 15:00:07 -0700633 }
634
635 @Override
636 public void removeViewsInLayout(int start, int count) {
637 for (int i = start; i < start + count; i++) {
Michael Jurkaa52570f2012-03-20 03:18:20 -0700638 markCellsAsUnoccupiedForView(mShortcutsAndWidgets.getChildAt(i));
Michael Jurka0280c3b2010-09-17 15:00:07 -0700639 }
Michael Jurkaa52570f2012-03-20 03:18:20 -0700640 mShortcutsAndWidgets.removeViewsInLayout(start, count);
Michael Jurkaabded662011-03-04 12:06:57 -0800641 }
642
Patrick Dubroy6569f2c2010-07-12 14:25:18 -0700643 /**
Winson Chungaafa03c2010-06-11 17:34:16 -0700644 * Given a point, return the cell that strictly encloses that point
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800645 * @param x X coordinate of the point
646 * @param y Y coordinate of the point
647 * @param result Array of 2 ints to hold the x and y coordinate of the cell
648 */
Sunny Goyale9b651e2015-04-24 11:44:51 -0700649 public void pointToCellExact(int x, int y, int[] result) {
Winson Chung4b825dcd2011-06-19 12:41:22 -0700650 final int hStartPadding = getPaddingLeft();
651 final int vStartPadding = getPaddingTop();
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800652
Sunny Goyalaa8a8712016-11-20 15:26:01 +0530653 result[0] = (x - hStartPadding) / mCellWidth;
654 result[1] = (y - vStartPadding) / mCellHeight;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800655
Adam Cohend22015c2010-07-26 22:02:18 -0700656 final int xAxis = mCountX;
657 final int yAxis = mCountY;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800658
659 if (result[0] < 0) result[0] = 0;
660 if (result[0] >= xAxis) result[0] = xAxis - 1;
661 if (result[1] < 0) result[1] = 0;
662 if (result[1] >= yAxis) result[1] = yAxis - 1;
663 }
Winson Chungaafa03c2010-06-11 17:34:16 -0700664
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800665 /**
666 * Given a point, return the cell that most closely encloses that point
667 * @param x X coordinate of the point
668 * @param y Y coordinate of the point
669 * @param result Array of 2 ints to hold the x and y coordinate of the cell
670 */
671 void pointToCellRounded(int x, int y, int[] result) {
672 pointToCellExact(x + (mCellWidth / 2), y + (mCellHeight / 2), result);
673 }
674
675 /**
676 * Given a cell coordinate, return the point that represents the upper left corner of that cell
Winson Chungaafa03c2010-06-11 17:34:16 -0700677 *
678 * @param cellX X coordinate of the cell
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800679 * @param cellY Y coordinate of the cell
Winson Chungaafa03c2010-06-11 17:34:16 -0700680 *
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800681 * @param result Array of 2 ints to hold the x and y coordinate of the point
682 */
683 void cellToPoint(int cellX, int cellY, int[] result) {
Winson Chung4b825dcd2011-06-19 12:41:22 -0700684 final int hStartPadding = getPaddingLeft();
685 final int vStartPadding = getPaddingTop();
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800686
Sunny Goyalaa8a8712016-11-20 15:26:01 +0530687 result[0] = hStartPadding + cellX * mCellWidth;
688 result[1] = vStartPadding + cellY * mCellHeight;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800689 }
690
Adam Cohene3e27a82011-04-15 12:07:39 -0700691 /**
Adam Cohen482ed822012-03-02 14:15:13 -0800692 * Given a cell coordinate, return the point that represents the center of the cell
Adam Cohene3e27a82011-04-15 12:07:39 -0700693 *
694 * @param cellX X coordinate of the cell
695 * @param cellY Y coordinate of the cell
696 *
697 * @param result Array of 2 ints to hold the x and y coordinate of the point
698 */
699 void cellToCenterPoint(int cellX, int cellY, int[] result) {
Adam Cohen47a876d2012-03-19 13:21:41 -0700700 regionToCenterPoint(cellX, cellY, 1, 1, result);
701 }
702
703 /**
704 * Given a cell coordinate and span return the point that represents the center of the regio
705 *
706 * @param cellX X coordinate of the cell
707 * @param cellY Y coordinate of the cell
708 *
709 * @param result Array of 2 ints to hold the x and y coordinate of the point
710 */
711 void regionToCenterPoint(int cellX, int cellY, int spanX, int spanY, int[] result) {
Winson Chung4b825dcd2011-06-19 12:41:22 -0700712 final int hStartPadding = getPaddingLeft();
713 final int vStartPadding = getPaddingTop();
Sunny Goyalaa8a8712016-11-20 15:26:01 +0530714 result[0] = hStartPadding + cellX * mCellWidth + (spanX * mCellWidth) / 2;
715 result[1] = vStartPadding + cellY * mCellHeight + (spanY * mCellHeight) / 2;
Adam Cohene3e27a82011-04-15 12:07:39 -0700716 }
717
Adam Cohen19f37922012-03-21 11:59:11 -0700718 /**
719 * Given a cell coordinate and span fills out a corresponding pixel rect
720 *
721 * @param cellX X coordinate of the cell
722 * @param cellY Y coordinate of the cell
723 * @param result Rect in which to write the result
724 */
725 void regionToRect(int cellX, int cellY, int spanX, int spanY, Rect result) {
726 final int hStartPadding = getPaddingLeft();
727 final int vStartPadding = getPaddingTop();
Sunny Goyalaa8a8712016-11-20 15:26:01 +0530728 final int left = hStartPadding + cellX * mCellWidth;
729 final int top = vStartPadding + cellY * mCellHeight;
730 result.set(left, top, left + (spanX * mCellWidth), top + (spanY * mCellHeight));
Adam Cohen19f37922012-03-21 11:59:11 -0700731 }
732
Adam Cohen482ed822012-03-02 14:15:13 -0800733 public float getDistanceFromCell(float x, float y, int[] cell) {
734 cellToCenterPoint(cell[0], cell[1], mTmpPoint);
Sunny Goyalf7a29e82015-04-24 15:20:43 -0700735 return (float) Math.hypot(x - mTmpPoint[0], y - mTmpPoint[1]);
Adam Cohen482ed822012-03-02 14:15:13 -0800736 }
737
Adam Cohenf9c184a2016-01-15 16:47:43 -0800738 public int getCellWidth() {
Romain Guy84f296c2009-11-04 15:00:44 -0800739 return mCellWidth;
740 }
741
Sunny Goyal0b754e52017-08-07 07:42:45 -0700742 public int getCellHeight() {
Romain Guy84f296c2009-11-04 15:00:44 -0800743 return mCellHeight;
744 }
745
Adam Cohenf0f4eda2013-06-06 21:27:03 -0700746 public void setFixedSize(int width, int height) {
747 mFixedWidth = width;
748 mFixedHeight = height;
749 }
750
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800751 @Override
752 protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800753 int widthSpecMode = MeasureSpec.getMode(widthMeasureSpec);
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800754 int heightSpecMode = MeasureSpec.getMode(heightMeasureSpec);
Winson Chung5f8afe62013-08-12 16:19:28 -0700755 int widthSize = MeasureSpec.getSize(widthMeasureSpec);
756 int heightSize = MeasureSpec.getSize(heightMeasureSpec);
Winson Chung2d75f122013-09-23 16:53:31 -0700757 int childWidthSize = widthSize - (getPaddingLeft() + getPaddingRight());
758 int childHeightSize = heightSize - (getPaddingTop() + getPaddingBottom());
Winson Chung11a1a532013-09-13 11:14:45 -0700759 if (mFixedCellWidth < 0 || mFixedCellHeight < 0) {
Sunny Goyalc6205602015-05-21 20:46:33 -0700760 int cw = DeviceProfile.calculateCellWidth(childWidthSize, mCountX);
761 int ch = DeviceProfile.calculateCellHeight(childHeightSize, mCountY);
Winson Chung11a1a532013-09-13 11:14:45 -0700762 if (cw != mCellWidth || ch != mCellHeight) {
763 mCellWidth = cw;
764 mCellHeight = ch;
Sunny Goyalaa8a8712016-11-20 15:26:01 +0530765 mShortcutsAndWidgets.setCellDimensions(mCellWidth, mCellHeight, mCountX, mCountY);
Winson Chung11a1a532013-09-13 11:14:45 -0700766 }
Winson Chung5f8afe62013-08-12 16:19:28 -0700767 }
Winson Chungaafa03c2010-06-11 17:34:16 -0700768
Winson Chung2d75f122013-09-23 16:53:31 -0700769 int newWidth = childWidthSize;
770 int newHeight = childHeightSize;
Adam Cohenf0f4eda2013-06-06 21:27:03 -0700771 if (mFixedWidth > 0 && mFixedHeight > 0) {
772 newWidth = mFixedWidth;
773 newHeight = mFixedHeight;
774 } else if (widthSpecMode == MeasureSpec.UNSPECIFIED || heightSpecMode == MeasureSpec.UNSPECIFIED) {
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800775 throw new RuntimeException("CellLayout cannot have UNSPECIFIED dimensions");
776 }
777
Sunny Goyal4fe5a372015-05-14 19:55:10 -0700778 mShortcutsAndWidgets.measure(
779 MeasureSpec.makeMeasureSpec(newWidth, MeasureSpec.EXACTLY),
780 MeasureSpec.makeMeasureSpec(newHeight, MeasureSpec.EXACTLY));
781
782 int maxWidth = mShortcutsAndWidgets.getMeasuredWidth();
783 int maxHeight = mShortcutsAndWidgets.getMeasuredHeight();
Winson Chung2d75f122013-09-23 16:53:31 -0700784 if (mFixedWidth > 0 && mFixedHeight > 0) {
785 setMeasuredDimension(maxWidth, maxHeight);
786 } else {
787 setMeasuredDimension(widthSize, heightSize);
788 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800789 }
790
791 @Override
Michael Jurka28750fb2010-09-24 17:43:49 -0700792 protected void onLayout(boolean changed, int l, int t, int r, int b) {
Tony Wickham26b01422015-11-10 14:44:32 -0800793 int left = getPaddingLeft();
Sunny Goyal7ce471b2017-08-02 03:37:39 -0700794 left += (int) Math.ceil(getUnusedHorizontalSpace() / 2f);
Sunny Goyal7c786f72016-06-01 14:08:21 -0700795 int right = r - l - getPaddingRight();
Sunny Goyal7ce471b2017-08-02 03:37:39 -0700796 right -= (int) Math.ceil(getUnusedHorizontalSpace() / 2f);
Sunny Goyal7c786f72016-06-01 14:08:21 -0700797
Winson Chung38848ca2013-10-08 12:03:44 -0700798 int top = getPaddingTop();
Sunny Goyal7c786f72016-06-01 14:08:21 -0700799 int bottom = b - t - getPaddingBottom();
Sunny Goyal4fe5a372015-05-14 19:55:10 -0700800
Sunny Goyal7c786f72016-06-01 14:08:21 -0700801 mShortcutsAndWidgets.layout(left, top, right, bottom);
Sunny Goyal7c786f72016-06-01 14:08:21 -0700802 // Expand the background drawing bounds by the padding baked into the background drawable
803 mBackground.getPadding(mTempRect);
804 mBackground.setBounds(
Jon Miranda28032002017-07-13 16:18:56 -0700805 left - mTempRect.left - getPaddingLeft(),
806 top - mTempRect.top - getPaddingTop(),
807 right + mTempRect.right + getPaddingRight(),
808 bottom + mTempRect.bottom + getPaddingBottom());
Sunny Goyal7c786f72016-06-01 14:08:21 -0700809 }
810
Tony Wickhama501d492015-11-03 18:05:01 -0800811 /**
812 * Returns the amount of space left over after subtracting padding and cells. This space will be
813 * very small, a few pixels at most, and is a result of rounding down when calculating the cell
814 * width in {@link DeviceProfile#calculateCellWidth(int, int)}.
815 */
816 public int getUnusedHorizontalSpace() {
817 return getMeasuredWidth() - getPaddingLeft() - getPaddingRight() - (mCountX * mCellWidth);
818 }
819
Sunny Goyalaeb16432017-10-16 11:46:41 -0700820 public Drawable getScrimBackground() {
821 return mBackground;
Michael Jurkadee05892010-07-27 10:01:56 -0700822 }
823
Sunny Goyal2805e632015-05-20 15:35:32 -0700824 @Override
825 protected boolean verifyDrawable(Drawable who) {
Sunny Goyal7ce471b2017-08-02 03:37:39 -0700826 return super.verifyDrawable(who) || (who == mBackground);
Sunny Goyal2805e632015-05-20 15:35:32 -0700827 }
828
Michael Jurkaa52570f2012-03-20 03:18:20 -0700829 public ShortcutAndWidgetContainer getShortcutsAndWidgets() {
Sunny Goyaldcbcc862014-08-12 15:58:36 -0700830 return mShortcutsAndWidgets;
Michael Jurkaa52570f2012-03-20 03:18:20 -0700831 }
832
Patrick Dubroy440c3602010-07-13 17:50:32 -0700833 public View getChildAt(int x, int y) {
Michael Jurkaa52570f2012-03-20 03:18:20 -0700834 return mShortcutsAndWidgets.getChildAt(x, y);
Patrick Dubroy440c3602010-07-13 17:50:32 -0700835 }
836
Adam Cohen76fc0852011-06-17 13:26:23 -0700837 public boolean animateChildToPosition(final View child, int cellX, int cellY, int duration,
Adam Cohen482ed822012-03-02 14:15:13 -0800838 int delay, boolean permanent, boolean adjustOccupied) {
Michael Jurkaa52570f2012-03-20 03:18:20 -0700839 ShortcutAndWidgetContainer clc = getShortcutsAndWidgets();
Adam Cohen482ed822012-03-02 14:15:13 -0800840
Adam Cohen19f37922012-03-21 11:59:11 -0700841 if (clc.indexOfChild(child) != -1) {
Adam Cohenbfbfd262011-06-13 16:55:12 -0700842 final LayoutParams lp = (LayoutParams) child.getLayoutParams();
843 final ItemInfo info = (ItemInfo) child.getTag();
844
845 // We cancel any existing animations
846 if (mReorderAnimators.containsKey(lp)) {
847 mReorderAnimators.get(lp).cancel();
848 mReorderAnimators.remove(lp);
849 }
850
Adam Cohen482ed822012-03-02 14:15:13 -0800851 final int oldX = lp.x;
852 final int oldY = lp.y;
853 if (adjustOccupied) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -0700854 GridOccupancy occupied = permanent ? mOccupied : mTmpOccupied;
855 occupied.markCells(lp.cellX, lp.cellY, lp.cellHSpan, lp.cellVSpan, false);
856 occupied.markCells(cellX, cellY, lp.cellHSpan, lp.cellVSpan, true);
Adam Cohen482ed822012-03-02 14:15:13 -0800857 }
Adam Cohenbfbfd262011-06-13 16:55:12 -0700858 lp.isLockedToGrid = true;
Adam Cohen482ed822012-03-02 14:15:13 -0800859 if (permanent) {
860 lp.cellX = info.cellX = cellX;
861 lp.cellY = info.cellY = cellY;
862 } else {
863 lp.tmpCellX = cellX;
864 lp.tmpCellY = cellY;
865 }
Jon Mirandae96798e2016-12-07 12:10:44 -0800866 clc.setupLp(child);
Adam Cohenbfbfd262011-06-13 16:55:12 -0700867 lp.isLockedToGrid = false;
Adam Cohen482ed822012-03-02 14:15:13 -0800868 final int newX = lp.x;
869 final int newY = lp.y;
Adam Cohenbfbfd262011-06-13 16:55:12 -0700870
Adam Cohen76fc0852011-06-17 13:26:23 -0700871 lp.x = oldX;
872 lp.y = oldY;
Adam Cohen76fc0852011-06-17 13:26:23 -0700873
Adam Cohen482ed822012-03-02 14:15:13 -0800874 // Exit early if we're not actually moving the view
875 if (oldX == newX && oldY == newY) {
876 lp.isLockedToGrid = true;
877 return true;
878 }
879
Jon Mirandacda3bfb2017-02-06 15:54:41 -0800880 ValueAnimator va = LauncherAnimUtils.ofFloat(0f, 1f);
Adam Cohen482ed822012-03-02 14:15:13 -0800881 va.setDuration(duration);
882 mReorderAnimators.put(lp, va);
883
884 va.addUpdateListener(new AnimatorUpdateListener() {
885 @Override
Adam Cohenbfbfd262011-06-13 16:55:12 -0700886 public void onAnimationUpdate(ValueAnimator animation) {
Jon Mirandae96798e2016-12-07 12:10:44 -0800887 float r = (Float) animation.getAnimatedValue();
Adam Cohen19f37922012-03-21 11:59:11 -0700888 lp.x = (int) ((1 - r) * oldX + r * newX);
889 lp.y = (int) ((1 - r) * oldY + r * newY);
Adam Cohen6b8a02d2012-03-22 15:13:40 -0700890 child.requestLayout();
Adam Cohenbfbfd262011-06-13 16:55:12 -0700891 }
892 });
Adam Cohen482ed822012-03-02 14:15:13 -0800893 va.addListener(new AnimatorListenerAdapter() {
Adam Cohenbfbfd262011-06-13 16:55:12 -0700894 boolean cancelled = false;
895 public void onAnimationEnd(Animator animation) {
896 // If the animation was cancelled, it means that another animation
897 // has interrupted this one, and we don't want to lock the item into
898 // place just yet.
899 if (!cancelled) {
900 lp.isLockedToGrid = true;
Adam Cohen482ed822012-03-02 14:15:13 -0800901 child.requestLayout();
Adam Cohenbfbfd262011-06-13 16:55:12 -0700902 }
903 if (mReorderAnimators.containsKey(lp)) {
904 mReorderAnimators.remove(lp);
905 }
906 }
907 public void onAnimationCancel(Animator animation) {
908 cancelled = true;
909 }
910 });
Adam Cohen482ed822012-03-02 14:15:13 -0800911 va.setStartDelay(delay);
912 va.start();
Adam Cohenbfbfd262011-06-13 16:55:12 -0700913 return true;
914 }
915 return false;
916 }
917
Sunny Goyal06e21a22016-08-11 16:02:02 -0700918 void visualizeDropLocation(View v, DragPreviewProvider outlineProvider, int cellX, int cellY,
919 int spanX, int spanY, boolean resize, DropTarget.DragObject dragObject) {
Patrick Dubroy08ae2ec2010-10-14 23:54:22 -0700920 final int oldDragCellX = mDragCell[0];
921 final int oldDragCellY = mDragCell[1];
Adam Cohen482ed822012-03-02 14:15:13 -0800922
Hyunyoung Song0de01172016-10-05 16:27:48 -0700923 if (outlineProvider == null || outlineProvider.generatedDragOutline == null) {
Adam Cohen2801caf2011-05-13 20:57:39 -0700924 return;
925 }
926
Hyunyoung Song0de01172016-10-05 16:27:48 -0700927 Bitmap dragOutline = outlineProvider.generatedDragOutline;
Adam Cohen482ed822012-03-02 14:15:13 -0800928 if (cellX != oldDragCellX || cellY != oldDragCellY) {
Sunny Goyale78e3d72015-09-24 11:23:31 -0700929 Point dragOffset = dragObject.dragView.getDragVisualizeOffset();
930 Rect dragRegion = dragObject.dragView.getDragRegion();
931
Adam Cohen482ed822012-03-02 14:15:13 -0800932 mDragCell[0] = cellX;
933 mDragCell[1] = cellY;
Patrick Dubroyde7658b2010-09-27 11:15:43 -0700934
Joe Onorato4be866d2010-10-10 11:26:02 -0700935 final int oldIndex = mDragOutlineCurrent;
Patrick Dubroy08ae2ec2010-10-14 23:54:22 -0700936 mDragOutlineAnims[oldIndex].animateOut();
937 mDragOutlineCurrent = (oldIndex + 1) % mDragOutlines.length;
Adam Cohend41fbf52012-02-16 23:53:59 -0800938 Rect r = mDragOutlines[mDragOutlineCurrent];
Sunny Goyal106bf642015-07-16 12:18:06 -0700939
Adam Cohend41fbf52012-02-16 23:53:59 -0800940 if (resize) {
Adam Cohen482ed822012-03-02 14:15:13 -0800941 cellToRect(cellX, cellY, spanX, spanY, r);
Jon Mirandae96798e2016-12-07 12:10:44 -0800942 if (v instanceof LauncherAppWidgetHostView) {
943 DeviceProfile profile = mLauncher.getDeviceProfile();
Jon Miranda6f6a06a2016-12-15 11:24:18 -0800944 Utilities.shrinkRect(r, profile.appWidgetScale.x, profile.appWidgetScale.y);
Jon Mirandae96798e2016-12-07 12:10:44 -0800945 }
Sunny Goyal106bf642015-07-16 12:18:06 -0700946 } else {
947 // Find the top left corner of the rect the object will occupy
948 final int[] topLeft = mTmpPoint;
949 cellToPoint(cellX, cellY, topLeft);
950
951 int left = topLeft[0];
952 int top = topLeft[1];
953
954 if (v != null && dragOffset == null) {
955 // When drawing the drag outline, it did not account for margin offsets
956 // added by the view's parent.
957 MarginLayoutParams lp = (MarginLayoutParams) v.getLayoutParams();
958 left += lp.leftMargin;
959 top += lp.topMargin;
960
961 // Offsets due to the size difference between the View and the dragOutline.
962 // There is a size difference to account for the outer blur, which may lie
963 // outside the bounds of the view.
Jon Mirandaf7ff3fe2016-12-05 12:04:44 -0800964 top += ((mCellHeight * spanY) - dragOutline.getHeight()) / 2;
Sunny Goyal106bf642015-07-16 12:18:06 -0700965 // We center about the x axis
Sunny Goyalaa8a8712016-11-20 15:26:01 +0530966 left += ((mCellWidth * spanX) - dragOutline.getWidth()) / 2;
Sunny Goyal106bf642015-07-16 12:18:06 -0700967 } else {
968 if (dragOffset != null && dragRegion != null) {
969 // Center the drag region *horizontally* in the cell and apply a drag
970 // outline offset
Sunny Goyalaa8a8712016-11-20 15:26:01 +0530971 left += dragOffset.x + ((mCellWidth * spanX) - dragRegion.width()) / 2;
Sunny Goyal106bf642015-07-16 12:18:06 -0700972 int cHeight = getShortcutsAndWidgets().getCellContentHeight();
973 int cellPaddingY = (int) Math.max(0, ((mCellHeight - cHeight) / 2f));
974 top += dragOffset.y + cellPaddingY;
975 } else {
976 // Center the drag outline in the cell
Sunny Goyalaa8a8712016-11-20 15:26:01 +0530977 left += ((mCellWidth * spanX) - dragOutline.getWidth()) / 2;
978 top += ((mCellHeight * spanY) - dragOutline.getHeight()) / 2;
Sunny Goyal106bf642015-07-16 12:18:06 -0700979 }
980 }
981 r.set(left, top, left + dragOutline.getWidth(), top + dragOutline.getHeight());
Adam Cohend41fbf52012-02-16 23:53:59 -0800982 }
Winson Chung150fbab2010-09-29 17:14:26 -0700983
Jon Miranda6f6a06a2016-12-15 11:24:18 -0800984 Utilities.scaleRectAboutCenter(r, mChildScale);
Patrick Dubroy08ae2ec2010-10-14 23:54:22 -0700985 mDragOutlineAnims[mDragOutlineCurrent].setTag(dragOutline);
986 mDragOutlineAnims[mDragOutlineCurrent].animateIn();
Sunny Goyale78e3d72015-09-24 11:23:31 -0700987
988 if (dragObject.stateAnnouncer != null) {
Sunny Goyalc13403c2016-11-18 23:44:48 -0800989 dragObject.stateAnnouncer.announce(getItemMoveDescription(cellX, cellY));
Sunny Goyale78e3d72015-09-24 11:23:31 -0700990 }
Patrick Dubroy6569f2c2010-07-12 14:25:18 -0700991 }
992 }
993
Sunny Goyal726bee72018-03-05 12:54:24 -0800994 @SuppressLint("StringFormatMatches")
Sunny Goyalc13403c2016-11-18 23:44:48 -0800995 public String getItemMoveDescription(int cellX, int cellY) {
996 if (mContainerType == HOTSEAT) {
997 return getContext().getString(R.string.move_to_hotseat_position,
998 Math.max(cellX, cellY) + 1);
999 } else {
1000 return getContext().getString(R.string.move_to_empty_cell,
1001 cellY + 1, cellX + 1);
1002 }
1003 }
1004
Adam Cohene0310962011-04-18 16:15:31 -07001005 public void clearDragOutlines() {
1006 final int oldIndex = mDragOutlineCurrent;
1007 mDragOutlineAnims[oldIndex].animateOut();
Adam Cohend41fbf52012-02-16 23:53:59 -08001008 mDragCell[0] = mDragCell[1] = -1;
Adam Cohene0310962011-04-18 16:15:31 -07001009 }
1010
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001011 /**
Jeff Sharkey70864282009-04-07 21:08:40 -07001012 * Find a vacant area that will fit the given bounds nearest the requested
1013 * cell location. Uses Euclidean distance to score multiple vacant areas.
Winson Chungaafa03c2010-06-11 17:34:16 -07001014 *
Romain Guy51afc022009-05-04 18:03:43 -07001015 * @param pixelX The X location at which you want to search for a vacant area.
1016 * @param pixelY The Y location at which you want to search for a vacant area.
Adam Cohend41fbf52012-02-16 23:53:59 -08001017 * @param minSpanX The minimum horizontal span required
1018 * @param minSpanY The minimum vertical span required
1019 * @param spanX Horizontal span of the object.
1020 * @param spanY Vertical span of the object.
1021 * @param result Array in which to place the result, or null (in which case a new array will
1022 * be allocated)
1023 * @return The X, Y cell of a vacant area that can contain this object,
1024 * nearest the requested location.
1025 */
1026 int[] findNearestVacantArea(int pixelX, int pixelY, int minSpanX, int minSpanY, int spanX,
1027 int spanY, int[] result, int[] resultSpan) {
Sunny Goyalf7a29e82015-04-24 15:20:43 -07001028 return findNearestArea(pixelX, pixelY, minSpanX, minSpanY, spanX, spanY, true,
Adam Cohend41fbf52012-02-16 23:53:59 -08001029 result, resultSpan);
1030 }
1031
Rajeev Kumar9962dbe2017-06-12 12:16:20 -07001032 private final Stack<Rect> mTempRectStack = new Stack<>();
Adam Cohend41fbf52012-02-16 23:53:59 -08001033 private void lazyInitTempRectStack() {
1034 if (mTempRectStack.isEmpty()) {
1035 for (int i = 0; i < mCountX * mCountY; i++) {
1036 mTempRectStack.push(new Rect());
1037 }
1038 }
1039 }
Adam Cohen482ed822012-03-02 14:15:13 -08001040
Adam Cohend41fbf52012-02-16 23:53:59 -08001041 private void recycleTempRects(Stack<Rect> used) {
1042 while (!used.isEmpty()) {
1043 mTempRectStack.push(used.pop());
1044 }
1045 }
1046
1047 /**
1048 * Find a vacant area that will fit the given bounds nearest the requested
1049 * cell location. Uses Euclidean distance to score multiple vacant areas.
1050 *
1051 * @param pixelX The X location at which you want to search for a vacant area.
1052 * @param pixelY The Y location at which you want to search for a vacant area.
1053 * @param minSpanX The minimum horizontal span required
1054 * @param minSpanY The minimum vertical span required
1055 * @param spanX Horizontal span of the object.
1056 * @param spanY Vertical span of the object.
1057 * @param ignoreOccupied If true, the result can be an occupied cell
1058 * @param result Array in which to place the result, or null (in which case a new array will
1059 * be allocated)
1060 * @return The X, Y cell of a vacant area that can contain this object,
1061 * nearest the requested location.
1062 */
Sunny Goyalf7a29e82015-04-24 15:20:43 -07001063 private int[] findNearestArea(int pixelX, int pixelY, int minSpanX, int minSpanY, int spanX,
1064 int spanY, boolean ignoreOccupied, int[] result, int[] resultSpan) {
Adam Cohend41fbf52012-02-16 23:53:59 -08001065 lazyInitTempRectStack();
Michael Jurkac6ee42e2010-09-30 12:04:50 -07001066
Adam Cohene3e27a82011-04-15 12:07:39 -07001067 // For items with a spanX / spanY > 1, the passed in point (pixelX, pixelY) corresponds
1068 // to the center of the item, but we are searching based on the top-left cell, so
1069 // we translate the point over to correspond to the top-left.
Sunny Goyalaa8a8712016-11-20 15:26:01 +05301070 pixelX -= mCellWidth * (spanX - 1) / 2f;
1071 pixelY -= mCellHeight * (spanY - 1) / 2f;
Adam Cohene3e27a82011-04-15 12:07:39 -07001072
Jeff Sharkey70864282009-04-07 21:08:40 -07001073 // Keep track of best-scoring drop area
Patrick Dubroyde7658b2010-09-27 11:15:43 -07001074 final int[] bestXY = result != null ? result : new int[2];
Jeff Sharkey70864282009-04-07 21:08:40 -07001075 double bestDistance = Double.MAX_VALUE;
Adam Cohend41fbf52012-02-16 23:53:59 -08001076 final Rect bestRect = new Rect(-1, -1, -1, -1);
Rajeev Kumar9962dbe2017-06-12 12:16:20 -07001077 final Stack<Rect> validRegions = new Stack<>();
Winson Chungaafa03c2010-06-11 17:34:16 -07001078
Patrick Dubroyde7658b2010-09-27 11:15:43 -07001079 final int countX = mCountX;
1080 final int countY = mCountY;
Patrick Dubroyde7658b2010-09-27 11:15:43 -07001081
Adam Cohend41fbf52012-02-16 23:53:59 -08001082 if (minSpanX <= 0 || minSpanY <= 0 || spanX <= 0 || spanY <= 0 ||
1083 spanX < minSpanX || spanY < minSpanY) {
1084 return bestXY;
1085 }
1086
1087 for (int y = 0; y < countY - (minSpanY - 1); y++) {
Michael Jurkac28de512010-08-13 11:27:44 -07001088 inner:
Adam Cohend41fbf52012-02-16 23:53:59 -08001089 for (int x = 0; x < countX - (minSpanX - 1); x++) {
1090 int ySize = -1;
1091 int xSize = -1;
Adam Cohendf035382011-04-11 17:22:04 -07001092 if (ignoreOccupied) {
Adam Cohend41fbf52012-02-16 23:53:59 -08001093 // First, let's see if this thing fits anywhere
1094 for (int i = 0; i < minSpanX; i++) {
1095 for (int j = 0; j < minSpanY; j++) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001096 if (mOccupied.cells[x + i][y + j]) {
Adam Cohendf035382011-04-11 17:22:04 -07001097 continue inner;
1098 }
Michael Jurkac28de512010-08-13 11:27:44 -07001099 }
1100 }
Adam Cohend41fbf52012-02-16 23:53:59 -08001101 xSize = minSpanX;
1102 ySize = minSpanY;
1103
1104 // We know that the item will fit at _some_ acceptable size, now let's see
1105 // how big we can make it. We'll alternate between incrementing x and y spans
1106 // until we hit a limit.
1107 boolean incX = true;
1108 boolean hitMaxX = xSize >= spanX;
1109 boolean hitMaxY = ySize >= spanY;
1110 while (!(hitMaxX && hitMaxY)) {
1111 if (incX && !hitMaxX) {
1112 for (int j = 0; j < ySize; j++) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001113 if (x + xSize > countX -1 || mOccupied.cells[x + xSize][y + j]) {
Adam Cohend41fbf52012-02-16 23:53:59 -08001114 // We can't move out horizontally
1115 hitMaxX = true;
1116 }
1117 }
1118 if (!hitMaxX) {
1119 xSize++;
1120 }
1121 } else if (!hitMaxY) {
1122 for (int i = 0; i < xSize; i++) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001123 if (y + ySize > countY - 1 || mOccupied.cells[x + i][y + ySize]) {
Adam Cohend41fbf52012-02-16 23:53:59 -08001124 // We can't move out vertically
1125 hitMaxY = true;
1126 }
1127 }
1128 if (!hitMaxY) {
1129 ySize++;
1130 }
1131 }
1132 hitMaxX |= xSize >= spanX;
1133 hitMaxY |= ySize >= spanY;
1134 incX = !incX;
1135 }
1136 incX = true;
1137 hitMaxX = xSize >= spanX;
1138 hitMaxY = ySize >= spanY;
Michael Jurkac28de512010-08-13 11:27:44 -07001139 }
Sunny Goyal2805e632015-05-20 15:35:32 -07001140 final int[] cellXY = mTmpPoint;
Adam Cohene3e27a82011-04-15 12:07:39 -07001141 cellToCenterPoint(x, y, cellXY);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001142
Adam Cohend41fbf52012-02-16 23:53:59 -08001143 // We verify that the current rect is not a sub-rect of any of our previous
1144 // candidates. In this case, the current rect is disqualified in favour of the
1145 // containing rect.
1146 Rect currentRect = mTempRectStack.pop();
1147 currentRect.set(x, y, x + xSize, y + ySize);
1148 boolean contained = false;
1149 for (Rect r : validRegions) {
1150 if (r.contains(currentRect)) {
1151 contained = true;
1152 break;
1153 }
1154 }
1155 validRegions.push(currentRect);
Sunny Goyalf7a29e82015-04-24 15:20:43 -07001156 double distance = Math.hypot(cellXY[0] - pixelX, cellXY[1] - pixelY);
Adam Cohen482ed822012-03-02 14:15:13 -08001157
Adam Cohend41fbf52012-02-16 23:53:59 -08001158 if ((distance <= bestDistance && !contained) ||
1159 currentRect.contains(bestRect)) {
Michael Jurkac28de512010-08-13 11:27:44 -07001160 bestDistance = distance;
1161 bestXY[0] = x;
1162 bestXY[1] = y;
Adam Cohend41fbf52012-02-16 23:53:59 -08001163 if (resultSpan != null) {
1164 resultSpan[0] = xSize;
1165 resultSpan[1] = ySize;
1166 }
1167 bestRect.set(currentRect);
Michael Jurkac28de512010-08-13 11:27:44 -07001168 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001169 }
1170 }
1171
Adam Cohenc0dcf592011-06-01 15:30:43 -07001172 // Return -1, -1 if no suitable location found
1173 if (bestDistance == Double.MAX_VALUE) {
1174 bestXY[0] = -1;
1175 bestXY[1] = -1;
Jeff Sharkey70864282009-04-07 21:08:40 -07001176 }
Adam Cohend41fbf52012-02-16 23:53:59 -08001177 recycleTempRects(validRegions);
Adam Cohenc0dcf592011-06-01 15:30:43 -07001178 return bestXY;
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001179 }
Winson Chungaafa03c2010-06-11 17:34:16 -07001180
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001181 /**
Adam Cohen482ed822012-03-02 14:15:13 -08001182 * Find a vacant area that will fit the given bounds nearest the requested
1183 * cell location, and will also weigh in a suggested direction vector of the
1184 * desired location. This method computers distance based on unit grid distances,
1185 * not pixel distances.
1186 *
Adam Cohen47a876d2012-03-19 13:21:41 -07001187 * @param cellX The X cell nearest to which you want to search for a vacant area.
1188 * @param cellY The Y cell nearest which you want to search for a vacant area.
Adam Cohen482ed822012-03-02 14:15:13 -08001189 * @param spanX Horizontal span of the object.
1190 * @param spanY Vertical span of the object.
Adam Cohen47a876d2012-03-19 13:21:41 -07001191 * @param direction The favored direction in which the views should move from x, y
Sunny Goyal9eba1fd2015-10-16 08:58:57 -07001192 * @param occupied The array which represents which cells in the CellLayout are occupied
Adam Cohen47a876d2012-03-19 13:21:41 -07001193 * @param blockOccupied The array which represents which cells in the specified block (cellX,
Winson Chung5f8afe62013-08-12 16:19:28 -07001194 * cellY, spanX, spanY) are occupied. This is used when try to move a group of views.
Adam Cohen482ed822012-03-02 14:15:13 -08001195 * @param result Array in which to place the result, or null (in which case a new array will
1196 * be allocated)
1197 * @return The X, Y cell of a vacant area that can contain this object,
1198 * nearest the requested location.
1199 */
1200 private int[] findNearestArea(int cellX, int cellY, int spanX, int spanY, int[] direction,
Adam Cohen47a876d2012-03-19 13:21:41 -07001201 boolean[][] occupied, boolean blockOccupied[][], int[] result) {
Adam Cohen482ed822012-03-02 14:15:13 -08001202 // Keep track of best-scoring drop area
1203 final int[] bestXY = result != null ? result : new int[2];
1204 float bestDistance = Float.MAX_VALUE;
1205 int bestDirectionScore = Integer.MIN_VALUE;
1206
1207 final int countX = mCountX;
1208 final int countY = mCountY;
1209
1210 for (int y = 0; y < countY - (spanY - 1); y++) {
1211 inner:
1212 for (int x = 0; x < countX - (spanX - 1); x++) {
1213 // First, let's see if this thing fits anywhere
1214 for (int i = 0; i < spanX; i++) {
1215 for (int j = 0; j < spanY; j++) {
Adam Cohen47a876d2012-03-19 13:21:41 -07001216 if (occupied[x + i][y + j] && (blockOccupied == null || blockOccupied[i][j])) {
Adam Cohen482ed822012-03-02 14:15:13 -08001217 continue inner;
1218 }
1219 }
1220 }
1221
Sunny Goyalf7a29e82015-04-24 15:20:43 -07001222 float distance = (float) Math.hypot(x - cellX, y - cellY);
Adam Cohen482ed822012-03-02 14:15:13 -08001223 int[] curDirection = mTmpPoint;
Adam Cohen47a876d2012-03-19 13:21:41 -07001224 computeDirectionVector(x - cellX, y - cellY, curDirection);
1225 // The direction score is just the dot product of the two candidate direction
1226 // and that passed in.
Adam Cohen482ed822012-03-02 14:15:13 -08001227 int curDirectionScore = direction[0] * curDirection[0] +
1228 direction[1] * curDirection[1];
Sunny Goyal8f90dcf2016-08-18 15:01:11 -07001229 if (Float.compare(distance, bestDistance) < 0 ||
1230 (Float.compare(distance, bestDistance) == 0
1231 && curDirectionScore > bestDirectionScore)) {
Adam Cohen482ed822012-03-02 14:15:13 -08001232 bestDistance = distance;
1233 bestDirectionScore = curDirectionScore;
1234 bestXY[0] = x;
1235 bestXY[1] = y;
1236 }
1237 }
1238 }
1239
1240 // Return -1, -1 if no suitable location found
1241 if (bestDistance == Float.MAX_VALUE) {
1242 bestXY[0] = -1;
1243 bestXY[1] = -1;
1244 }
1245 return bestXY;
1246 }
1247
1248 private boolean addViewToTempLocation(View v, Rect rectOccupiedByPotentialDrop,
Adam Cohen8baab352012-03-20 17:39:21 -07001249 int[] direction, ItemConfiguration currentState) {
1250 CellAndSpan c = currentState.map.get(v);
Adam Cohen482ed822012-03-02 14:15:13 -08001251 boolean success = false;
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001252 mTmpOccupied.markCells(c, false);
1253 mTmpOccupied.markCells(rectOccupiedByPotentialDrop, true);
Adam Cohen482ed822012-03-02 14:15:13 -08001254
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001255 findNearestArea(c.cellX, c.cellY, c.spanX, c.spanY, direction,
1256 mTmpOccupied.cells, null, mTempLocation);
Adam Cohen482ed822012-03-02 14:15:13 -08001257
1258 if (mTempLocation[0] >= 0 && mTempLocation[1] >= 0) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001259 c.cellX = mTempLocation[0];
1260 c.cellY = mTempLocation[1];
Adam Cohen482ed822012-03-02 14:15:13 -08001261 success = true;
Adam Cohen482ed822012-03-02 14:15:13 -08001262 }
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001263 mTmpOccupied.markCells(c, true);
Adam Cohen482ed822012-03-02 14:15:13 -08001264 return success;
1265 }
1266
Adam Cohenf3900c22012-11-16 18:28:11 -08001267 /**
1268 * This helper class defines a cluster of views. It helps with defining complex edges
1269 * of the cluster and determining how those edges interact with other views. The edges
1270 * essentially define a fine-grained boundary around the cluster of views -- like a more
1271 * precise version of a bounding box.
1272 */
1273 private class ViewCluster {
Sunny Goyal6dc98b92016-04-03 15:25:29 -07001274 final static int LEFT = 1 << 0;
1275 final static int TOP = 1 << 1;
1276 final static int RIGHT = 1 << 2;
1277 final static int BOTTOM = 1 << 3;
Adam Cohen47a876d2012-03-19 13:21:41 -07001278
Rajeev Kumar9962dbe2017-06-12 12:16:20 -07001279 final ArrayList<View> views;
1280 final ItemConfiguration config;
1281 final Rect boundingRect = new Rect();
Adam Cohen47a876d2012-03-19 13:21:41 -07001282
Rajeev Kumar9962dbe2017-06-12 12:16:20 -07001283 final int[] leftEdge = new int[mCountY];
1284 final int[] rightEdge = new int[mCountY];
1285 final int[] topEdge = new int[mCountX];
1286 final int[] bottomEdge = new int[mCountX];
Sunny Goyal6dc98b92016-04-03 15:25:29 -07001287 int dirtyEdges;
1288 boolean boundingRectDirty;
Adam Cohenf3900c22012-11-16 18:28:11 -08001289
1290 @SuppressWarnings("unchecked")
1291 public ViewCluster(ArrayList<View> views, ItemConfiguration config) {
1292 this.views = (ArrayList<View>) views.clone();
1293 this.config = config;
1294 resetEdges();
Adam Cohen47a876d2012-03-19 13:21:41 -07001295 }
1296
Adam Cohenf3900c22012-11-16 18:28:11 -08001297 void resetEdges() {
1298 for (int i = 0; i < mCountX; i++) {
1299 topEdge[i] = -1;
1300 bottomEdge[i] = -1;
1301 }
1302 for (int i = 0; i < mCountY; i++) {
1303 leftEdge[i] = -1;
1304 rightEdge[i] = -1;
1305 }
Sunny Goyal6dc98b92016-04-03 15:25:29 -07001306 dirtyEdges = LEFT | TOP | RIGHT | BOTTOM;
Adam Cohenf3900c22012-11-16 18:28:11 -08001307 boundingRectDirty = true;
1308 }
Adam Cohen47a876d2012-03-19 13:21:41 -07001309
Sunny Goyal6dc98b92016-04-03 15:25:29 -07001310 void computeEdge(int which) {
Adam Cohenf3900c22012-11-16 18:28:11 -08001311 int count = views.size();
1312 for (int i = 0; i < count; i++) {
1313 CellAndSpan cs = config.map.get(views.get(i));
1314 switch (which) {
1315 case LEFT:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001316 int left = cs.cellX;
1317 for (int j = cs.cellY; j < cs.cellY + cs.spanY; j++) {
Sunny Goyal6dc98b92016-04-03 15:25:29 -07001318 if (left < leftEdge[j] || leftEdge[j] < 0) {
1319 leftEdge[j] = left;
Adam Cohena56dc102012-07-13 13:41:42 -07001320 }
Adam Cohen47a876d2012-03-19 13:21:41 -07001321 }
Adam Cohenf3900c22012-11-16 18:28:11 -08001322 break;
1323 case RIGHT:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001324 int right = cs.cellX + cs.spanX;
1325 for (int j = cs.cellY; j < cs.cellY + cs.spanY; j++) {
Sunny Goyal6dc98b92016-04-03 15:25:29 -07001326 if (right > rightEdge[j]) {
1327 rightEdge[j] = right;
Adam Cohenf3900c22012-11-16 18:28:11 -08001328 }
1329 }
1330 break;
1331 case TOP:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001332 int top = cs.cellY;
1333 for (int j = cs.cellX; j < cs.cellX + cs.spanX; j++) {
Sunny Goyal6dc98b92016-04-03 15:25:29 -07001334 if (top < topEdge[j] || topEdge[j] < 0) {
1335 topEdge[j] = top;
Adam Cohenf3900c22012-11-16 18:28:11 -08001336 }
1337 }
1338 break;
1339 case BOTTOM:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001340 int bottom = cs.cellY + cs.spanY;
1341 for (int j = cs.cellX; j < cs.cellX + cs.spanX; j++) {
Sunny Goyal6dc98b92016-04-03 15:25:29 -07001342 if (bottom > bottomEdge[j]) {
1343 bottomEdge[j] = bottom;
Adam Cohenf3900c22012-11-16 18:28:11 -08001344 }
1345 }
1346 break;
Adam Cohen47a876d2012-03-19 13:21:41 -07001347 }
1348 }
1349 }
Adam Cohenf3900c22012-11-16 18:28:11 -08001350
1351 boolean isViewTouchingEdge(View v, int whichEdge) {
1352 CellAndSpan cs = config.map.get(v);
1353
Sunny Goyal6dc98b92016-04-03 15:25:29 -07001354 if ((dirtyEdges & whichEdge) == whichEdge) {
1355 computeEdge(whichEdge);
1356 dirtyEdges &= ~whichEdge;
1357 }
Adam Cohenf3900c22012-11-16 18:28:11 -08001358
1359 switch (whichEdge) {
1360 case LEFT:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001361 for (int i = cs.cellY; i < cs.cellY + cs.spanY; i++) {
1362 if (leftEdge[i] == cs.cellX + cs.spanX) {
Adam Cohenf3900c22012-11-16 18:28:11 -08001363 return true;
1364 }
1365 }
1366 break;
1367 case RIGHT:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001368 for (int i = cs.cellY; i < cs.cellY + cs.spanY; i++) {
1369 if (rightEdge[i] == cs.cellX) {
Adam Cohenf3900c22012-11-16 18:28:11 -08001370 return true;
1371 }
1372 }
1373 break;
1374 case TOP:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001375 for (int i = cs.cellX; i < cs.cellX + cs.spanX; i++) {
1376 if (topEdge[i] == cs.cellY + cs.spanY) {
Adam Cohenf3900c22012-11-16 18:28:11 -08001377 return true;
1378 }
1379 }
1380 break;
1381 case BOTTOM:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001382 for (int i = cs.cellX; i < cs.cellX + cs.spanX; i++) {
1383 if (bottomEdge[i] == cs.cellY) {
Adam Cohenf3900c22012-11-16 18:28:11 -08001384 return true;
1385 }
1386 }
1387 break;
1388 }
1389 return false;
1390 }
1391
1392 void shift(int whichEdge, int delta) {
1393 for (View v: views) {
1394 CellAndSpan c = config.map.get(v);
1395 switch (whichEdge) {
1396 case LEFT:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001397 c.cellX -= delta;
Adam Cohenf3900c22012-11-16 18:28:11 -08001398 break;
1399 case RIGHT:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001400 c.cellX += delta;
Adam Cohenf3900c22012-11-16 18:28:11 -08001401 break;
1402 case TOP:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001403 c.cellY -= delta;
Adam Cohenf3900c22012-11-16 18:28:11 -08001404 break;
1405 case BOTTOM:
1406 default:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001407 c.cellY += delta;
Adam Cohenf3900c22012-11-16 18:28:11 -08001408 break;
1409 }
1410 }
1411 resetEdges();
1412 }
1413
1414 public void addView(View v) {
1415 views.add(v);
1416 resetEdges();
1417 }
1418
1419 public Rect getBoundingRect() {
1420 if (boundingRectDirty) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001421 config.getBoundingRectForViews(views, boundingRect);
Adam Cohenf3900c22012-11-16 18:28:11 -08001422 }
1423 return boundingRect;
1424 }
1425
Rajeev Kumar9962dbe2017-06-12 12:16:20 -07001426 final PositionComparator comparator = new PositionComparator();
Adam Cohenf3900c22012-11-16 18:28:11 -08001427 class PositionComparator implements Comparator<View> {
1428 int whichEdge = 0;
1429 public int compare(View left, View right) {
1430 CellAndSpan l = config.map.get(left);
1431 CellAndSpan r = config.map.get(right);
1432 switch (whichEdge) {
1433 case LEFT:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001434 return (r.cellX + r.spanX) - (l.cellX + l.spanX);
Adam Cohenf3900c22012-11-16 18:28:11 -08001435 case RIGHT:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001436 return l.cellX - r.cellX;
Adam Cohenf3900c22012-11-16 18:28:11 -08001437 case TOP:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001438 return (r.cellY + r.spanY) - (l.cellY + l.spanY);
Adam Cohenf3900c22012-11-16 18:28:11 -08001439 case BOTTOM:
1440 default:
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001441 return l.cellY - r.cellY;
Adam Cohenf3900c22012-11-16 18:28:11 -08001442 }
1443 }
1444 }
1445
1446 public void sortConfigurationForEdgePush(int edge) {
1447 comparator.whichEdge = edge;
1448 Collections.sort(config.sortedViews, comparator);
1449 }
Adam Cohen47a876d2012-03-19 13:21:41 -07001450 }
1451
Adam Cohenf3900c22012-11-16 18:28:11 -08001452 private boolean pushViewsToTempLocation(ArrayList<View> views, Rect rectOccupiedByPotentialDrop,
1453 int[] direction, View dragView, ItemConfiguration currentState) {
Adam Cohene0489502012-08-27 15:18:53 -07001454
Adam Cohenf3900c22012-11-16 18:28:11 -08001455 ViewCluster cluster = new ViewCluster(views, currentState);
1456 Rect clusterRect = cluster.getBoundingRect();
1457 int whichEdge;
1458 int pushDistance;
1459 boolean fail = false;
1460
1461 // Determine the edge of the cluster that will be leading the push and how far
1462 // the cluster must be shifted.
1463 if (direction[0] < 0) {
1464 whichEdge = ViewCluster.LEFT;
1465 pushDistance = clusterRect.right - rectOccupiedByPotentialDrop.left;
Adam Cohene0489502012-08-27 15:18:53 -07001466 } else if (direction[0] > 0) {
Adam Cohenf3900c22012-11-16 18:28:11 -08001467 whichEdge = ViewCluster.RIGHT;
1468 pushDistance = rectOccupiedByPotentialDrop.right - clusterRect.left;
1469 } else if (direction[1] < 0) {
1470 whichEdge = ViewCluster.TOP;
1471 pushDistance = clusterRect.bottom - rectOccupiedByPotentialDrop.top;
1472 } else {
1473 whichEdge = ViewCluster.BOTTOM;
1474 pushDistance = rectOccupiedByPotentialDrop.bottom - clusterRect.top;
Adam Cohene0489502012-08-27 15:18:53 -07001475 }
1476
Adam Cohenf3900c22012-11-16 18:28:11 -08001477 // Break early for invalid push distance.
1478 if (pushDistance <= 0) {
1479 return false;
Adam Cohene0489502012-08-27 15:18:53 -07001480 }
Adam Cohenf3900c22012-11-16 18:28:11 -08001481
1482 // Mark the occupied state as false for the group of views we want to move.
1483 for (View v: views) {
1484 CellAndSpan c = currentState.map.get(v);
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001485 mTmpOccupied.markCells(c, false);
Adam Cohenf3900c22012-11-16 18:28:11 -08001486 }
1487
1488 // We save the current configuration -- if we fail to find a solution we will revert
1489 // to the initial state. The process of finding a solution modifies the configuration
1490 // in place, hence the need for revert in the failure case.
1491 currentState.save();
1492
1493 // The pushing algorithm is simplified by considering the views in the order in which
1494 // they would be pushed by the cluster. For example, if the cluster is leading with its
1495 // left edge, we consider sort the views by their right edge, from right to left.
1496 cluster.sortConfigurationForEdgePush(whichEdge);
1497
1498 while (pushDistance > 0 && !fail) {
1499 for (View v: currentState.sortedViews) {
1500 // For each view that isn't in the cluster, we see if the leading edge of the
1501 // cluster is contacting the edge of that view. If so, we add that view to the
1502 // cluster.
1503 if (!cluster.views.contains(v) && v != dragView) {
1504 if (cluster.isViewTouchingEdge(v, whichEdge)) {
1505 LayoutParams lp = (LayoutParams) v.getLayoutParams();
1506 if (!lp.canReorder) {
1507 // The push solution includes the all apps button, this is not viable.
1508 fail = true;
1509 break;
1510 }
1511 cluster.addView(v);
1512 CellAndSpan c = currentState.map.get(v);
1513
1514 // Adding view to cluster, mark it as not occupied.
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001515 mTmpOccupied.markCells(c, false);
Adam Cohenf3900c22012-11-16 18:28:11 -08001516 }
1517 }
1518 }
1519 pushDistance--;
1520
1521 // The cluster has been completed, now we move the whole thing over in the appropriate
1522 // direction.
1523 cluster.shift(whichEdge, 1);
1524 }
1525
1526 boolean foundSolution = false;
1527 clusterRect = cluster.getBoundingRect();
1528
1529 // Due to the nature of the algorithm, the only check required to verify a valid solution
1530 // is to ensure that completed shifted cluster lies completely within the cell layout.
1531 if (!fail && clusterRect.left >= 0 && clusterRect.right <= mCountX && clusterRect.top >= 0 &&
1532 clusterRect.bottom <= mCountY) {
1533 foundSolution = true;
1534 } else {
1535 currentState.restore();
1536 }
1537
1538 // In either case, we set the occupied array as marked for the location of the views
1539 for (View v: cluster.views) {
1540 CellAndSpan c = currentState.map.get(v);
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001541 mTmpOccupied.markCells(c, true);
Adam Cohenf3900c22012-11-16 18:28:11 -08001542 }
1543
1544 return foundSolution;
Adam Cohene0489502012-08-27 15:18:53 -07001545 }
1546
Adam Cohen482ed822012-03-02 14:15:13 -08001547 private boolean addViewsToTempLocation(ArrayList<View> views, Rect rectOccupiedByPotentialDrop,
Adam Cohenf3900c22012-11-16 18:28:11 -08001548 int[] direction, View dragView, ItemConfiguration currentState) {
Adam Cohen482ed822012-03-02 14:15:13 -08001549 if (views.size() == 0) return true;
Adam Cohen482ed822012-03-02 14:15:13 -08001550
Adam Cohen8baab352012-03-20 17:39:21 -07001551 boolean success = false;
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001552 Rect boundingRect = new Rect();
Adam Cohen8baab352012-03-20 17:39:21 -07001553 // We construct a rect which represents the entire group of views passed in
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001554 currentState.getBoundingRectForViews(views, boundingRect);
Adam Cohen8baab352012-03-20 17:39:21 -07001555
Adam Cohen8baab352012-03-20 17:39:21 -07001556 // Mark the occupied state as false for the group of views we want to move.
Adam Cohenf3900c22012-11-16 18:28:11 -08001557 for (View v: views) {
Adam Cohen8baab352012-03-20 17:39:21 -07001558 CellAndSpan c = currentState.map.get(v);
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001559 mTmpOccupied.markCells(c, false);
Adam Cohen8baab352012-03-20 17:39:21 -07001560 }
1561
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001562 GridOccupancy blockOccupied = new GridOccupancy(boundingRect.width(), boundingRect.height());
Adam Cohen47a876d2012-03-19 13:21:41 -07001563 int top = boundingRect.top;
1564 int left = boundingRect.left;
Adam Cohen8baab352012-03-20 17:39:21 -07001565 // We mark more precisely which parts of the bounding rect are truly occupied, allowing
Adam Cohena56dc102012-07-13 13:41:42 -07001566 // for interlocking.
Adam Cohenf3900c22012-11-16 18:28:11 -08001567 for (View v: views) {
Adam Cohen8baab352012-03-20 17:39:21 -07001568 CellAndSpan c = currentState.map.get(v);
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001569 blockOccupied.markCells(c.cellX - left, c.cellY - top, c.spanX, c.spanY, true);
Adam Cohen47a876d2012-03-19 13:21:41 -07001570 }
1571
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001572 mTmpOccupied.markCells(rectOccupiedByPotentialDrop, true);
Adam Cohen482ed822012-03-02 14:15:13 -08001573
Adam Cohenf3900c22012-11-16 18:28:11 -08001574 findNearestArea(boundingRect.left, boundingRect.top, boundingRect.width(),
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001575 boundingRect.height(), direction,
1576 mTmpOccupied.cells, blockOccupied.cells, mTempLocation);
Adam Cohen482ed822012-03-02 14:15:13 -08001577
Adam Cohen8baab352012-03-20 17:39:21 -07001578 // If we successfuly found a location by pushing the block of views, we commit it
Adam Cohen482ed822012-03-02 14:15:13 -08001579 if (mTempLocation[0] >= 0 && mTempLocation[1] >= 0) {
Adam Cohen8baab352012-03-20 17:39:21 -07001580 int deltaX = mTempLocation[0] - boundingRect.left;
1581 int deltaY = mTempLocation[1] - boundingRect.top;
Adam Cohenf3900c22012-11-16 18:28:11 -08001582 for (View v: views) {
Adam Cohen8baab352012-03-20 17:39:21 -07001583 CellAndSpan c = currentState.map.get(v);
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001584 c.cellX += deltaX;
1585 c.cellY += deltaY;
Adam Cohen482ed822012-03-02 14:15:13 -08001586 }
1587 success = true;
1588 }
Adam Cohen8baab352012-03-20 17:39:21 -07001589
1590 // In either case, we set the occupied array as marked for the location of the views
Adam Cohenf3900c22012-11-16 18:28:11 -08001591 for (View v: views) {
Adam Cohen8baab352012-03-20 17:39:21 -07001592 CellAndSpan c = currentState.map.get(v);
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001593 mTmpOccupied.markCells(c, true);
Adam Cohen482ed822012-03-02 14:15:13 -08001594 }
1595 return success;
1596 }
1597
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001598 // This method tries to find a reordering solution which satisfies the push mechanic by trying
1599 // to push items in each of the cardinal directions, in an order based on the direction vector
1600 // passed.
1601 private boolean attemptPushInDirection(ArrayList<View> intersectingViews, Rect occupied,
1602 int[] direction, View ignoreView, ItemConfiguration solution) {
1603 if ((Math.abs(direction[0]) + Math.abs(direction[1])) > 1) {
Winson Chung5f8afe62013-08-12 16:19:28 -07001604 // If the direction vector has two non-zero components, we try pushing
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001605 // separately in each of the components.
1606 int temp = direction[1];
1607 direction[1] = 0;
Adam Cohenf3900c22012-11-16 18:28:11 -08001608
1609 if (pushViewsToTempLocation(intersectingViews, occupied, direction,
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001610 ignoreView, solution)) {
1611 return true;
1612 }
1613 direction[1] = temp;
1614 temp = direction[0];
1615 direction[0] = 0;
Adam Cohenf3900c22012-11-16 18:28:11 -08001616
1617 if (pushViewsToTempLocation(intersectingViews, occupied, direction,
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001618 ignoreView, solution)) {
1619 return true;
1620 }
1621 // Revert the direction
1622 direction[0] = temp;
1623
1624 // Now we try pushing in each component of the opposite direction
1625 direction[0] *= -1;
1626 direction[1] *= -1;
1627 temp = direction[1];
1628 direction[1] = 0;
Adam Cohenf3900c22012-11-16 18:28:11 -08001629 if (pushViewsToTempLocation(intersectingViews, occupied, direction,
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001630 ignoreView, solution)) {
1631 return true;
1632 }
1633
1634 direction[1] = temp;
1635 temp = direction[0];
1636 direction[0] = 0;
Adam Cohenf3900c22012-11-16 18:28:11 -08001637 if (pushViewsToTempLocation(intersectingViews, occupied, direction,
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001638 ignoreView, solution)) {
1639 return true;
1640 }
1641 // revert the direction
1642 direction[0] = temp;
1643 direction[0] *= -1;
1644 direction[1] *= -1;
Winson Chung5f8afe62013-08-12 16:19:28 -07001645
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001646 } else {
1647 // If the direction vector has a single non-zero component, we push first in the
1648 // direction of the vector
Adam Cohenf3900c22012-11-16 18:28:11 -08001649 if (pushViewsToTempLocation(intersectingViews, occupied, direction,
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001650 ignoreView, solution)) {
1651 return true;
1652 }
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001653 // Then we try the opposite direction
1654 direction[0] *= -1;
1655 direction[1] *= -1;
Adam Cohenf3900c22012-11-16 18:28:11 -08001656 if (pushViewsToTempLocation(intersectingViews, occupied, direction,
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001657 ignoreView, solution)) {
1658 return true;
1659 }
1660 // Switch the direction back
1661 direction[0] *= -1;
1662 direction[1] *= -1;
Winson Chung5f8afe62013-08-12 16:19:28 -07001663
1664 // If we have failed to find a push solution with the above, then we try
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001665 // to find a solution by pushing along the perpendicular axis.
1666
1667 // Swap the components
1668 int temp = direction[1];
1669 direction[1] = direction[0];
1670 direction[0] = temp;
Adam Cohenf3900c22012-11-16 18:28:11 -08001671 if (pushViewsToTempLocation(intersectingViews, occupied, direction,
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001672 ignoreView, solution)) {
1673 return true;
1674 }
1675
1676 // Then we try the opposite direction
1677 direction[0] *= -1;
1678 direction[1] *= -1;
Adam Cohenf3900c22012-11-16 18:28:11 -08001679 if (pushViewsToTempLocation(intersectingViews, occupied, direction,
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001680 ignoreView, solution)) {
1681 return true;
1682 }
1683 // Switch the direction back
1684 direction[0] *= -1;
1685 direction[1] *= -1;
1686
1687 // Swap the components back
1688 temp = direction[1];
1689 direction[1] = direction[0];
1690 direction[0] = temp;
1691 }
1692 return false;
1693 }
1694
Adam Cohen482ed822012-03-02 14:15:13 -08001695 private boolean rearrangementExists(int cellX, int cellY, int spanX, int spanY, int[] direction,
Adam Cohen8baab352012-03-20 17:39:21 -07001696 View ignoreView, ItemConfiguration solution) {
Winson Chunge3e03bc2012-05-01 15:10:11 -07001697 // Return early if get invalid cell positions
1698 if (cellX < 0 || cellY < 0) return false;
Adam Cohen482ed822012-03-02 14:15:13 -08001699
Adam Cohen8baab352012-03-20 17:39:21 -07001700 mIntersectingViews.clear();
Adam Cohen482ed822012-03-02 14:15:13 -08001701 mOccupiedRect.set(cellX, cellY, cellX + spanX, cellY + spanY);
Adam Cohen482ed822012-03-02 14:15:13 -08001702
Adam Cohen8baab352012-03-20 17:39:21 -07001703 // Mark the desired location of the view currently being dragged.
Adam Cohen482ed822012-03-02 14:15:13 -08001704 if (ignoreView != null) {
Adam Cohen8baab352012-03-20 17:39:21 -07001705 CellAndSpan c = solution.map.get(ignoreView);
Adam Cohen19f37922012-03-21 11:59:11 -07001706 if (c != null) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001707 c.cellX = cellX;
1708 c.cellY = cellY;
Adam Cohen19f37922012-03-21 11:59:11 -07001709 }
Adam Cohen482ed822012-03-02 14:15:13 -08001710 }
Adam Cohen482ed822012-03-02 14:15:13 -08001711 Rect r0 = new Rect(cellX, cellY, cellX + spanX, cellY + spanY);
1712 Rect r1 = new Rect();
Adam Cohen8baab352012-03-20 17:39:21 -07001713 for (View child: solution.map.keySet()) {
Adam Cohen482ed822012-03-02 14:15:13 -08001714 if (child == ignoreView) continue;
Adam Cohen8baab352012-03-20 17:39:21 -07001715 CellAndSpan c = solution.map.get(child);
Adam Cohen482ed822012-03-02 14:15:13 -08001716 LayoutParams lp = (LayoutParams) child.getLayoutParams();
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001717 r1.set(c.cellX, c.cellY, c.cellX + c.spanX, c.cellY + c.spanY);
Adam Cohen482ed822012-03-02 14:15:13 -08001718 if (Rect.intersects(r0, r1)) {
1719 if (!lp.canReorder) {
1720 return false;
1721 }
1722 mIntersectingViews.add(child);
1723 }
1724 }
Adam Cohen47a876d2012-03-19 13:21:41 -07001725
Rajeev Kumar9962dbe2017-06-12 12:16:20 -07001726 solution.intersectingViews = new ArrayList<>(mIntersectingViews);
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001727
Winson Chung5f8afe62013-08-12 16:19:28 -07001728 // First we try to find a solution which respects the push mechanic. That is,
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001729 // we try to find a solution such that no displaced item travels through another item
1730 // without also displacing that item.
1731 if (attemptPushInDirection(mIntersectingViews, mOccupiedRect, direction, ignoreView,
Adam Cohen19f37922012-03-21 11:59:11 -07001732 solution)) {
Adam Cohen47a876d2012-03-19 13:21:41 -07001733 return true;
1734 }
Adam Cohen47a876d2012-03-19 13:21:41 -07001735
Adam Cohen4abc5bd2012-05-29 21:06:03 -07001736 // Next we try moving the views as a block, but without requiring the push mechanic.
Adam Cohenf3900c22012-11-16 18:28:11 -08001737 if (addViewsToTempLocation(mIntersectingViews, mOccupiedRect, direction, ignoreView,
Adam Cohen19f37922012-03-21 11:59:11 -07001738 solution)) {
Adam Cohen482ed822012-03-02 14:15:13 -08001739 return true;
1740 }
Adam Cohen47a876d2012-03-19 13:21:41 -07001741
Adam Cohen482ed822012-03-02 14:15:13 -08001742 // Ok, they couldn't move as a block, let's move them individually
1743 for (View v : mIntersectingViews) {
Adam Cohen8baab352012-03-20 17:39:21 -07001744 if (!addViewToTempLocation(v, mOccupiedRect, direction, solution)) {
Adam Cohen482ed822012-03-02 14:15:13 -08001745 return false;
1746 }
1747 }
1748 return true;
1749 }
1750
1751 /*
1752 * Returns a pair (x, y), where x,y are in {-1, 0, 1} corresponding to vector between
1753 * the provided point and the provided cell
1754 */
Adam Cohen47a876d2012-03-19 13:21:41 -07001755 private void computeDirectionVector(float deltaX, float deltaY, int[] result) {
Jon Mirandae96798e2016-12-07 12:10:44 -08001756 double angle = Math.atan(deltaY / deltaX);
Adam Cohen482ed822012-03-02 14:15:13 -08001757
1758 result[0] = 0;
1759 result[1] = 0;
1760 if (Math.abs(Math.cos(angle)) > 0.5f) {
1761 result[0] = (int) Math.signum(deltaX);
1762 }
1763 if (Math.abs(Math.sin(angle)) > 0.5f) {
1764 result[1] = (int) Math.signum(deltaY);
1765 }
1766 }
1767
Sunny Goyalf7a29e82015-04-24 15:20:43 -07001768 private ItemConfiguration findReorderSolution(int pixelX, int pixelY, int minSpanX, int minSpanY,
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001769 int spanX, int spanY, int[] direction, View dragView, boolean decX,
1770 ItemConfiguration solution) {
Adam Cohen8baab352012-03-20 17:39:21 -07001771 // Copy the current state into the solution. This solution will be manipulated as necessary.
1772 copyCurrentStateToSolution(solution, false);
1773 // Copy the current occupied array into the temporary occupied array. This array will be
1774 // manipulated as necessary to find a solution.
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001775 mOccupied.copyTo(mTmpOccupied);
Adam Cohen482ed822012-03-02 14:15:13 -08001776
1777 // We find the nearest cell into which we would place the dragged item, assuming there's
1778 // nothing in its way.
1779 int result[] = new int[2];
1780 result = findNearestArea(pixelX, pixelY, spanX, spanY, result);
1781
Rajeev Kumar9962dbe2017-06-12 12:16:20 -07001782 boolean success;
Adam Cohen482ed822012-03-02 14:15:13 -08001783 // First we try the exact nearest position of the item being dragged,
1784 // we will then want to try to move this around to other neighbouring positions
Adam Cohen8baab352012-03-20 17:39:21 -07001785 success = rearrangementExists(result[0], result[1], spanX, spanY, direction, dragView,
1786 solution);
Adam Cohen482ed822012-03-02 14:15:13 -08001787
1788 if (!success) {
1789 // We try shrinking the widget down to size in an alternating pattern, shrink 1 in
1790 // x, then 1 in y etc.
1791 if (spanX > minSpanX && (minSpanY == spanY || decX)) {
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001792 return findReorderSolution(pixelX, pixelY, minSpanX, minSpanY, spanX - 1, spanY,
1793 direction, dragView, false, solution);
Adam Cohen482ed822012-03-02 14:15:13 -08001794 } else if (spanY > minSpanY) {
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001795 return findReorderSolution(pixelX, pixelY, minSpanX, minSpanY, spanX, spanY - 1,
1796 direction, dragView, true, solution);
Adam Cohen482ed822012-03-02 14:15:13 -08001797 }
1798 solution.isSolution = false;
1799 } else {
1800 solution.isSolution = true;
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001801 solution.cellX = result[0];
1802 solution.cellY = result[1];
1803 solution.spanX = spanX;
1804 solution.spanY = spanY;
Adam Cohen482ed822012-03-02 14:15:13 -08001805 }
1806 return solution;
1807 }
1808
1809 private void copyCurrentStateToSolution(ItemConfiguration solution, boolean temp) {
Michael Jurkaa52570f2012-03-20 03:18:20 -07001810 int childCount = mShortcutsAndWidgets.getChildCount();
Adam Cohen482ed822012-03-02 14:15:13 -08001811 for (int i = 0; i < childCount; i++) {
Michael Jurkaa52570f2012-03-20 03:18:20 -07001812 View child = mShortcutsAndWidgets.getChildAt(i);
Adam Cohen482ed822012-03-02 14:15:13 -08001813 LayoutParams lp = (LayoutParams) child.getLayoutParams();
Adam Cohen8baab352012-03-20 17:39:21 -07001814 CellAndSpan c;
Adam Cohen482ed822012-03-02 14:15:13 -08001815 if (temp) {
Adam Cohen8baab352012-03-20 17:39:21 -07001816 c = new CellAndSpan(lp.tmpCellX, lp.tmpCellY, lp.cellHSpan, lp.cellVSpan);
Adam Cohen482ed822012-03-02 14:15:13 -08001817 } else {
Adam Cohen8baab352012-03-20 17:39:21 -07001818 c = new CellAndSpan(lp.cellX, lp.cellY, lp.cellHSpan, lp.cellVSpan);
Adam Cohen482ed822012-03-02 14:15:13 -08001819 }
Adam Cohenf3900c22012-11-16 18:28:11 -08001820 solution.add(child, c);
Adam Cohen482ed822012-03-02 14:15:13 -08001821 }
1822 }
1823
1824 private void copySolutionToTempState(ItemConfiguration solution, View dragView) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001825 mTmpOccupied.clear();
Adam Cohen482ed822012-03-02 14:15:13 -08001826
Michael Jurkaa52570f2012-03-20 03:18:20 -07001827 int childCount = mShortcutsAndWidgets.getChildCount();
Adam Cohen482ed822012-03-02 14:15:13 -08001828 for (int i = 0; i < childCount; i++) {
Michael Jurkaa52570f2012-03-20 03:18:20 -07001829 View child = mShortcutsAndWidgets.getChildAt(i);
Adam Cohen482ed822012-03-02 14:15:13 -08001830 if (child == dragView) continue;
1831 LayoutParams lp = (LayoutParams) child.getLayoutParams();
Adam Cohen8baab352012-03-20 17:39:21 -07001832 CellAndSpan c = solution.map.get(child);
1833 if (c != null) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001834 lp.tmpCellX = c.cellX;
1835 lp.tmpCellY = c.cellY;
Adam Cohen8baab352012-03-20 17:39:21 -07001836 lp.cellHSpan = c.spanX;
1837 lp.cellVSpan = c.spanY;
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001838 mTmpOccupied.markCells(c, true);
Adam Cohen482ed822012-03-02 14:15:13 -08001839 }
1840 }
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001841 mTmpOccupied.markCells(solution, true);
Adam Cohen482ed822012-03-02 14:15:13 -08001842 }
1843
1844 private void animateItemsToSolution(ItemConfiguration solution, View dragView, boolean
1845 commitDragView) {
1846
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001847 GridOccupancy occupied = DESTRUCTIVE_REORDER ? mOccupied : mTmpOccupied;
1848 occupied.clear();
Adam Cohen482ed822012-03-02 14:15:13 -08001849
Michael Jurkaa52570f2012-03-20 03:18:20 -07001850 int childCount = mShortcutsAndWidgets.getChildCount();
Adam Cohen482ed822012-03-02 14:15:13 -08001851 for (int i = 0; i < childCount; i++) {
Michael Jurkaa52570f2012-03-20 03:18:20 -07001852 View child = mShortcutsAndWidgets.getChildAt(i);
Adam Cohen482ed822012-03-02 14:15:13 -08001853 if (child == dragView) continue;
Adam Cohen8baab352012-03-20 17:39:21 -07001854 CellAndSpan c = solution.map.get(child);
1855 if (c != null) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001856 animateChildToPosition(child, c.cellX, c.cellY, REORDER_ANIMATION_DURATION, 0,
Adam Cohen19f37922012-03-21 11:59:11 -07001857 DESTRUCTIVE_REORDER, false);
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001858 occupied.markCells(c, true);
Adam Cohen482ed822012-03-02 14:15:13 -08001859 }
1860 }
1861 if (commitDragView) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001862 occupied.markCells(solution, true);
Adam Cohen482ed822012-03-02 14:15:13 -08001863 }
1864 }
1865
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001866
1867 // This method starts or changes the reorder preview animations
1868 private void beginOrAdjustReorderPreviewAnimations(ItemConfiguration solution,
1869 View dragView, int delay, int mode) {
Adam Cohen19f37922012-03-21 11:59:11 -07001870 int childCount = mShortcutsAndWidgets.getChildCount();
Adam Cohen19f37922012-03-21 11:59:11 -07001871 for (int i = 0; i < childCount; i++) {
1872 View child = mShortcutsAndWidgets.getChildAt(i);
1873 if (child == dragView) continue;
1874 CellAndSpan c = solution.map.get(child);
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001875 boolean skip = mode == ReorderPreviewAnimation.MODE_HINT && solution.intersectingViews
1876 != null && !solution.intersectingViews.contains(child);
1877
Adam Cohen19f37922012-03-21 11:59:11 -07001878 LayoutParams lp = (LayoutParams) child.getLayoutParams();
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001879 if (c != null && !skip) {
1880 ReorderPreviewAnimation rha = new ReorderPreviewAnimation(child, mode, lp.cellX,
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07001881 lp.cellY, c.cellX, c.cellY, c.spanX, c.spanY);
Adam Cohend024f982012-05-23 18:26:45 -07001882 rha.animate();
Adam Cohen19f37922012-03-21 11:59:11 -07001883 }
1884 }
1885 }
1886
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001887 // Class which represents the reorder preview animations. These animations show that an item is
Adam Cohen19f37922012-03-21 11:59:11 -07001888 // in a temporary state, and hint at where the item will return to.
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001889 class ReorderPreviewAnimation {
Rajeev Kumar9962dbe2017-06-12 12:16:20 -07001890 final View child;
Adam Cohend024f982012-05-23 18:26:45 -07001891 float finalDeltaX;
1892 float finalDeltaY;
1893 float initDeltaX;
1894 float initDeltaY;
Rajeev Kumar9962dbe2017-06-12 12:16:20 -07001895 final float finalScale;
Adam Cohend024f982012-05-23 18:26:45 -07001896 float initScale;
Rajeev Kumar9962dbe2017-06-12 12:16:20 -07001897 final int mode;
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001898 boolean repeating = false;
1899 private static final int PREVIEW_DURATION = 300;
1900 private static final int HINT_DURATION = Workspace.REORDER_TIMEOUT;
1901
Jon Miranda21266912016-12-19 14:12:05 -08001902 private static final float CHILD_DIVIDEND = 4.0f;
1903
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001904 public static final int MODE_HINT = 0;
1905 public static final int MODE_PREVIEW = 1;
1906
Adam Cohene7587d22012-05-24 18:50:02 -07001907 Animator a;
Adam Cohen19f37922012-03-21 11:59:11 -07001908
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001909 public ReorderPreviewAnimation(View child, int mode, int cellX0, int cellY0, int cellX1,
1910 int cellY1, int spanX, int spanY) {
Adam Cohen19f37922012-03-21 11:59:11 -07001911 regionToCenterPoint(cellX0, cellY0, spanX, spanY, mTmpPoint);
1912 final int x0 = mTmpPoint[0];
1913 final int y0 = mTmpPoint[1];
1914 regionToCenterPoint(cellX1, cellY1, spanX, spanY, mTmpPoint);
1915 final int x1 = mTmpPoint[0];
1916 final int y1 = mTmpPoint[1];
1917 final int dX = x1 - x0;
1918 final int dY = y1 - y0;
Jon Miranda21266912016-12-19 14:12:05 -08001919
1920 this.child = child;
1921 this.mode = mode;
1922 setInitialAnimationValues(false);
1923 finalScale = (mChildScale - (CHILD_DIVIDEND / child.getWidth())) * initScale;
1924 finalDeltaX = initDeltaX;
1925 finalDeltaY = initDeltaY;
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001926 int dir = mode == MODE_HINT ? -1 : 1;
Adam Cohen19f37922012-03-21 11:59:11 -07001927 if (dX == dY && dX == 0) {
1928 } else {
1929 if (dY == 0) {
Jon Miranda21266912016-12-19 14:12:05 -08001930 finalDeltaX += - dir * Math.signum(dX) * mReorderPreviewAnimationMagnitude;
Adam Cohen19f37922012-03-21 11:59:11 -07001931 } else if (dX == 0) {
Jon Miranda21266912016-12-19 14:12:05 -08001932 finalDeltaY += - dir * Math.signum(dY) * mReorderPreviewAnimationMagnitude;
Adam Cohen19f37922012-03-21 11:59:11 -07001933 } else {
1934 double angle = Math.atan( (float) (dY) / dX);
Jon Miranda21266912016-12-19 14:12:05 -08001935 finalDeltaX += (int) (- dir * Math.signum(dX) *
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001936 Math.abs(Math.cos(angle) * mReorderPreviewAnimationMagnitude));
Jon Miranda21266912016-12-19 14:12:05 -08001937 finalDeltaY += (int) (- dir * Math.signum(dY) *
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001938 Math.abs(Math.sin(angle) * mReorderPreviewAnimationMagnitude));
Adam Cohen19f37922012-03-21 11:59:11 -07001939 }
1940 }
Jon Miranda21266912016-12-19 14:12:05 -08001941 }
1942
1943 void setInitialAnimationValues(boolean restoreOriginalValues) {
1944 if (restoreOriginalValues) {
1945 if (child instanceof LauncherAppWidgetHostView) {
1946 LauncherAppWidgetHostView lahv = (LauncherAppWidgetHostView) child;
1947 initScale = lahv.getScaleToFit();
1948 initDeltaX = lahv.getTranslationForCentering().x;
1949 initDeltaY = lahv.getTranslationForCentering().y;
1950 } else {
1951 initScale = mChildScale;
1952 initDeltaX = 0;
1953 initDeltaY = 0;
1954 }
1955 } else {
1956 initScale = child.getScaleX();
1957 initDeltaX = child.getTranslationX();
1958 initDeltaY = child.getTranslationY();
1959 }
Adam Cohen19f37922012-03-21 11:59:11 -07001960 }
1961
Adam Cohend024f982012-05-23 18:26:45 -07001962 void animate() {
Jon Miranda21266912016-12-19 14:12:05 -08001963 boolean noMovement = (finalDeltaX == initDeltaX) && (finalDeltaY == initDeltaY);
1964
Adam Cohen19f37922012-03-21 11:59:11 -07001965 if (mShakeAnimators.containsKey(child)) {
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001966 ReorderPreviewAnimation oldAnimation = mShakeAnimators.get(child);
Adam Cohend024f982012-05-23 18:26:45 -07001967 oldAnimation.cancel();
Adam Cohen19f37922012-03-21 11:59:11 -07001968 mShakeAnimators.remove(child);
Jon Miranda21266912016-12-19 14:12:05 -08001969 if (noMovement) {
Adam Cohene7587d22012-05-24 18:50:02 -07001970 completeAnimationImmediately();
1971 return;
1972 }
Adam Cohen19f37922012-03-21 11:59:11 -07001973 }
Jon Miranda21266912016-12-19 14:12:05 -08001974 if (noMovement) {
Adam Cohen19f37922012-03-21 11:59:11 -07001975 return;
1976 }
Jon Mirandacda3bfb2017-02-06 15:54:41 -08001977 ValueAnimator va = LauncherAnimUtils.ofFloat(0f, 1f);
Adam Cohene7587d22012-05-24 18:50:02 -07001978 a = va;
Tony Wickham9e0702f2015-09-02 14:45:39 -07001979
1980 // Animations are disabled in power save mode, causing the repeated animation to jump
1981 // spastically between beginning and end states. Since this looks bad, we don't repeat
1982 // the animation in power save mode.
Tony Wickham112ac952015-11-12 12:31:50 -08001983 if (!Utilities.isPowerSaverOn(getContext())) {
Tony Wickham9e0702f2015-09-02 14:45:39 -07001984 va.setRepeatMode(ValueAnimator.REVERSE);
1985 va.setRepeatCount(ValueAnimator.INFINITE);
1986 }
1987
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001988 va.setDuration(mode == MODE_HINT ? HINT_DURATION : PREVIEW_DURATION);
Adam Cohend024f982012-05-23 18:26:45 -07001989 va.setStartDelay((int) (Math.random() * 60));
Adam Cohen19f37922012-03-21 11:59:11 -07001990 va.addUpdateListener(new AnimatorUpdateListener() {
1991 @Override
1992 public void onAnimationUpdate(ValueAnimator animation) {
Jon Mirandae96798e2016-12-07 12:10:44 -08001993 float r = (Float) animation.getAnimatedValue();
Adam Cohenfa3c58f2013-12-06 16:10:55 -08001994 float r1 = (mode == MODE_HINT && repeating) ? 1.0f : r;
1995 float x = r1 * finalDeltaX + (1 - r1) * initDeltaX;
1996 float y = r1 * finalDeltaY + (1 - r1) * initDeltaY;
Adam Cohen19f37922012-03-21 11:59:11 -07001997 child.setTranslationX(x);
1998 child.setTranslationY(y);
Adam Cohend024f982012-05-23 18:26:45 -07001999 float s = r * finalScale + (1 - r) * initScale;
Brandon Keely50e6e562012-05-08 16:28:49 -07002000 child.setScaleX(s);
2001 child.setScaleY(s);
Adam Cohen19f37922012-03-21 11:59:11 -07002002 }
2003 });
2004 va.addListener(new AnimatorListenerAdapter() {
2005 public void onAnimationRepeat(Animator animation) {
Adam Cohen19f37922012-03-21 11:59:11 -07002006 // We make sure to end only after a full period
Jon Miranda21266912016-12-19 14:12:05 -08002007 setInitialAnimationValues(true);
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002008 repeating = true;
Adam Cohen19f37922012-03-21 11:59:11 -07002009 }
2010 });
Adam Cohen19f37922012-03-21 11:59:11 -07002011 mShakeAnimators.put(child, this);
2012 va.start();
2013 }
2014
Adam Cohend024f982012-05-23 18:26:45 -07002015 private void cancel() {
Adam Cohene7587d22012-05-24 18:50:02 -07002016 if (a != null) {
2017 a.cancel();
2018 }
Adam Cohen19f37922012-03-21 11:59:11 -07002019 }
Adam Cohene7587d22012-05-24 18:50:02 -07002020
Adam Cohen091440a2015-03-18 14:16:05 -07002021 @Thunk void completeAnimationImmediately() {
Adam Cohene7587d22012-05-24 18:50:02 -07002022 if (a != null) {
2023 a.cancel();
2024 }
Brandon Keely50e6e562012-05-08 16:28:49 -07002025
Jon Miranda72dbd912017-01-04 14:03:07 -08002026 setInitialAnimationValues(true);
Sunny Goyal9e76f682017-02-13 12:13:43 -08002027 a = LauncherAnimUtils.ofPropertyValuesHolder(child,
2028 new PropertyListBuilder()
2029 .scale(initScale)
2030 .translationX(initDeltaX)
2031 .translationY(initDeltaY)
2032 .build())
2033 .setDuration(REORDER_ANIMATION_DURATION);
Sunny Goyal5d2fc322015-07-06 22:52:49 -07002034 a.setInterpolator(new android.view.animation.DecelerateInterpolator(1.5f));
2035 a.start();
Brandon Keely50e6e562012-05-08 16:28:49 -07002036 }
Adam Cohen19f37922012-03-21 11:59:11 -07002037 }
2038
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002039 private void completeAndClearReorderPreviewAnimations() {
2040 for (ReorderPreviewAnimation a: mShakeAnimators.values()) {
Brandon Keely50e6e562012-05-08 16:28:49 -07002041 a.completeAnimationImmediately();
Adam Cohen19f37922012-03-21 11:59:11 -07002042 }
2043 mShakeAnimators.clear();
2044 }
2045
Adam Cohen482ed822012-03-02 14:15:13 -08002046 private void commitTempPlacement() {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002047 mTmpOccupied.copyTo(mOccupied);
Sunny Goyalaa8ef112015-06-12 20:04:41 -07002048
2049 long screenId = mLauncher.getWorkspace().getIdForScreen(this);
2050 int container = Favorites.CONTAINER_DESKTOP;
2051
Sunny Goyalc13403c2016-11-18 23:44:48 -08002052 if (mContainerType == HOTSEAT) {
Sunny Goyalaa8ef112015-06-12 20:04:41 -07002053 screenId = -1;
2054 container = Favorites.CONTAINER_HOTSEAT;
2055 }
2056
Michael Jurkaa52570f2012-03-20 03:18:20 -07002057 int childCount = mShortcutsAndWidgets.getChildCount();
Adam Cohen482ed822012-03-02 14:15:13 -08002058 for (int i = 0; i < childCount; i++) {
Adam Cohenea889a22012-03-27 16:45:39 -07002059 View child = mShortcutsAndWidgets.getChildAt(i);
2060 LayoutParams lp = (LayoutParams) child.getLayoutParams();
2061 ItemInfo info = (ItemInfo) child.getTag();
Adam Cohen2acce882012-03-28 19:03:19 -07002062 // We do a null check here because the item info can be null in the case of the
2063 // AllApps button in the hotseat.
2064 if (info != null) {
Sunny Goyalaa8ef112015-06-12 20:04:41 -07002065 final boolean requiresDbUpdate = (info.cellX != lp.tmpCellX
2066 || info.cellY != lp.tmpCellY || info.spanX != lp.cellHSpan
2067 || info.spanY != lp.cellVSpan);
2068
Adam Cohen2acce882012-03-28 19:03:19 -07002069 info.cellX = lp.cellX = lp.tmpCellX;
2070 info.cellY = lp.cellY = lp.tmpCellY;
Adam Cohenbebf0422012-04-11 18:06:28 -07002071 info.spanX = lp.cellHSpan;
2072 info.spanY = lp.cellVSpan;
Sunny Goyalaa8ef112015-06-12 20:04:41 -07002073
2074 if (requiresDbUpdate) {
Sunny Goyal43bf11d2017-02-02 13:52:53 -08002075 mLauncher.getModelWriter().modifyItemInDatabase(info, container, screenId,
Sunny Goyalaa8ef112015-06-12 20:04:41 -07002076 info.cellX, info.cellY, info.spanX, info.spanY);
2077 }
Adam Cohen2acce882012-03-28 19:03:19 -07002078 }
Adam Cohen482ed822012-03-02 14:15:13 -08002079 }
2080 }
2081
Sunny Goyalf7a29e82015-04-24 15:20:43 -07002082 private void setUseTempCoords(boolean useTempCoords) {
Michael Jurkaa52570f2012-03-20 03:18:20 -07002083 int childCount = mShortcutsAndWidgets.getChildCount();
Adam Cohen482ed822012-03-02 14:15:13 -08002084 for (int i = 0; i < childCount; i++) {
Michael Jurkaa52570f2012-03-20 03:18:20 -07002085 LayoutParams lp = (LayoutParams) mShortcutsAndWidgets.getChildAt(i).getLayoutParams();
Adam Cohen482ed822012-03-02 14:15:13 -08002086 lp.useTmpCoords = useTempCoords;
2087 }
2088 }
2089
Sunny Goyalf7a29e82015-04-24 15:20:43 -07002090 private ItemConfiguration findConfigurationNoShuffle(int pixelX, int pixelY, int minSpanX, int minSpanY,
Adam Cohen482ed822012-03-02 14:15:13 -08002091 int spanX, int spanY, View dragView, ItemConfiguration solution) {
2092 int[] result = new int[2];
2093 int[] resultSpan = new int[2];
Sunny Goyalf7a29e82015-04-24 15:20:43 -07002094 findNearestVacantArea(pixelX, pixelY, minSpanX, minSpanY, spanX, spanY, result,
Adam Cohen482ed822012-03-02 14:15:13 -08002095 resultSpan);
2096 if (result[0] >= 0 && result[1] >= 0) {
2097 copyCurrentStateToSolution(solution, false);
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002098 solution.cellX = result[0];
2099 solution.cellY = result[1];
2100 solution.spanX = resultSpan[0];
2101 solution.spanY = resultSpan[1];
Adam Cohen482ed822012-03-02 14:15:13 -08002102 solution.isSolution = true;
2103 } else {
2104 solution.isSolution = false;
2105 }
2106 return solution;
2107 }
2108
Adam Cohen19f37922012-03-21 11:59:11 -07002109 /* This seems like it should be obvious and straight-forward, but when the direction vector
2110 needs to match with the notion of the dragView pushing other views, we have to employ
2111 a slightly more subtle notion of the direction vector. The question is what two points is
2112 the vector between? The center of the dragView and its desired destination? Not quite, as
2113 this doesn't necessarily coincide with the interaction of the dragView and items occupying
2114 those cells. Instead we use some heuristics to often lock the vector to up, down, left
2115 or right, which helps make pushing feel right.
2116 */
2117 private void getDirectionVectorForDrop(int dragViewCenterX, int dragViewCenterY, int spanX,
2118 int spanY, View dragView, int[] resultDirection) {
2119 int[] targetDestination = new int[2];
2120
2121 findNearestArea(dragViewCenterX, dragViewCenterY, spanX, spanY, targetDestination);
2122 Rect dragRect = new Rect();
2123 regionToRect(targetDestination[0], targetDestination[1], spanX, spanY, dragRect);
2124 dragRect.offset(dragViewCenterX - dragRect.centerX(), dragViewCenterY - dragRect.centerY());
2125
2126 Rect dropRegionRect = new Rect();
2127 getViewsIntersectingRegion(targetDestination[0], targetDestination[1], spanX, spanY,
2128 dragView, dropRegionRect, mIntersectingViews);
2129
2130 int dropRegionSpanX = dropRegionRect.width();
2131 int dropRegionSpanY = dropRegionRect.height();
2132
2133 regionToRect(dropRegionRect.left, dropRegionRect.top, dropRegionRect.width(),
2134 dropRegionRect.height(), dropRegionRect);
2135
2136 int deltaX = (dropRegionRect.centerX() - dragViewCenterX) / spanX;
2137 int deltaY = (dropRegionRect.centerY() - dragViewCenterY) / spanY;
2138
2139 if (dropRegionSpanX == mCountX || spanX == mCountX) {
2140 deltaX = 0;
2141 }
2142 if (dropRegionSpanY == mCountY || spanY == mCountY) {
2143 deltaY = 0;
2144 }
2145
2146 if (deltaX == 0 && deltaY == 0) {
2147 // No idea what to do, give a random direction.
2148 resultDirection[0] = 1;
2149 resultDirection[1] = 0;
2150 } else {
2151 computeDirectionVector(deltaX, deltaY, resultDirection);
2152 }
2153 }
2154
2155 // For a given cell and span, fetch the set of views intersecting the region.
2156 private void getViewsIntersectingRegion(int cellX, int cellY, int spanX, int spanY,
2157 View dragView, Rect boundingRect, ArrayList<View> intersectingViews) {
2158 if (boundingRect != null) {
2159 boundingRect.set(cellX, cellY, cellX + spanX, cellY + spanY);
2160 }
2161 intersectingViews.clear();
2162 Rect r0 = new Rect(cellX, cellY, cellX + spanX, cellY + spanY);
2163 Rect r1 = new Rect();
2164 final int count = mShortcutsAndWidgets.getChildCount();
2165 for (int i = 0; i < count; i++) {
2166 View child = mShortcutsAndWidgets.getChildAt(i);
2167 if (child == dragView) continue;
2168 LayoutParams lp = (LayoutParams) child.getLayoutParams();
2169 r1.set(lp.cellX, lp.cellY, lp.cellX + lp.cellHSpan, lp.cellY + lp.cellVSpan);
2170 if (Rect.intersects(r0, r1)) {
2171 mIntersectingViews.add(child);
2172 if (boundingRect != null) {
2173 boundingRect.union(r1);
2174 }
2175 }
2176 }
2177 }
2178
2179 boolean isNearestDropLocationOccupied(int pixelX, int pixelY, int spanX, int spanY,
2180 View dragView, int[] result) {
2181 result = findNearestArea(pixelX, pixelY, spanX, spanY, result);
2182 getViewsIntersectingRegion(result[0], result[1], spanX, spanY, dragView, null,
2183 mIntersectingViews);
2184 return !mIntersectingViews.isEmpty();
2185 }
2186
2187 void revertTempState() {
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002188 completeAndClearReorderPreviewAnimations();
2189 if (isItemPlacementDirty() && !DESTRUCTIVE_REORDER) {
2190 final int count = mShortcutsAndWidgets.getChildCount();
2191 for (int i = 0; i < count; i++) {
2192 View child = mShortcutsAndWidgets.getChildAt(i);
2193 LayoutParams lp = (LayoutParams) child.getLayoutParams();
2194 if (lp.tmpCellX != lp.cellX || lp.tmpCellY != lp.cellY) {
2195 lp.tmpCellX = lp.cellX;
2196 lp.tmpCellY = lp.cellY;
2197 animateChildToPosition(child, lp.cellX, lp.cellY, REORDER_ANIMATION_DURATION,
2198 0, false, false);
2199 }
Adam Cohen19f37922012-03-21 11:59:11 -07002200 }
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002201 setItemPlacementDirty(false);
Adam Cohen19f37922012-03-21 11:59:11 -07002202 }
Adam Cohen19f37922012-03-21 11:59:11 -07002203 }
2204
Adam Cohenbebf0422012-04-11 18:06:28 -07002205 boolean createAreaForResize(int cellX, int cellY, int spanX, int spanY,
2206 View dragView, int[] direction, boolean commit) {
2207 int[] pixelXY = new int[2];
2208 regionToCenterPoint(cellX, cellY, spanX, spanY, pixelXY);
2209
2210 // First we determine if things have moved enough to cause a different layout
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002211 ItemConfiguration swapSolution = findReorderSolution(pixelXY[0], pixelXY[1], spanX, spanY,
Adam Cohenbebf0422012-04-11 18:06:28 -07002212 spanX, spanY, direction, dragView, true, new ItemConfiguration());
2213
2214 setUseTempCoords(true);
2215 if (swapSolution != null && swapSolution.isSolution) {
2216 // If we're just testing for a possible location (MODE_ACCEPT_DROP), we don't bother
2217 // committing anything or animating anything as we just want to determine if a solution
2218 // exists
2219 copySolutionToTempState(swapSolution, dragView);
2220 setItemPlacementDirty(true);
2221 animateItemsToSolution(swapSolution, dragView, commit);
2222
2223 if (commit) {
2224 commitTempPlacement();
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002225 completeAndClearReorderPreviewAnimations();
Adam Cohenbebf0422012-04-11 18:06:28 -07002226 setItemPlacementDirty(false);
2227 } else {
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002228 beginOrAdjustReorderPreviewAnimations(swapSolution, dragView,
2229 REORDER_ANIMATION_DURATION, ReorderPreviewAnimation.MODE_PREVIEW);
Adam Cohenbebf0422012-04-11 18:06:28 -07002230 }
2231 mShortcutsAndWidgets.requestLayout();
2232 }
2233 return swapSolution.isSolution;
2234 }
2235
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002236 int[] performReorder(int pixelX, int pixelY, int minSpanX, int minSpanY, int spanX, int spanY,
Adam Cohen482ed822012-03-02 14:15:13 -08002237 View dragView, int[] result, int resultSpan[], int mode) {
Adam Cohen482ed822012-03-02 14:15:13 -08002238 // First we determine if things have moved enough to cause a different layout
Adam Cohen47a876d2012-03-19 13:21:41 -07002239 result = findNearestArea(pixelX, pixelY, spanX, spanY, result);
Adam Cohen482ed822012-03-02 14:15:13 -08002240
2241 if (resultSpan == null) {
2242 resultSpan = new int[2];
2243 }
2244
Adam Cohen19f37922012-03-21 11:59:11 -07002245 // When we are checking drop validity or actually dropping, we don't recompute the
2246 // direction vector, since we want the solution to match the preview, and it's possible
2247 // that the exact position of the item has changed to result in a new reordering outcome.
Adam Cohenb209e632012-03-27 17:09:36 -07002248 if ((mode == MODE_ON_DROP || mode == MODE_ON_DROP_EXTERNAL || mode == MODE_ACCEPT_DROP)
2249 && mPreviousReorderDirection[0] != INVALID_DIRECTION) {
Adam Cohen19f37922012-03-21 11:59:11 -07002250 mDirectionVector[0] = mPreviousReorderDirection[0];
2251 mDirectionVector[1] = mPreviousReorderDirection[1];
2252 // We reset this vector after drop
Adam Cohenb209e632012-03-27 17:09:36 -07002253 if (mode == MODE_ON_DROP || mode == MODE_ON_DROP_EXTERNAL) {
2254 mPreviousReorderDirection[0] = INVALID_DIRECTION;
2255 mPreviousReorderDirection[1] = INVALID_DIRECTION;
Adam Cohen19f37922012-03-21 11:59:11 -07002256 }
2257 } else {
2258 getDirectionVectorForDrop(pixelX, pixelY, spanX, spanY, dragView, mDirectionVector);
2259 mPreviousReorderDirection[0] = mDirectionVector[0];
2260 mPreviousReorderDirection[1] = mDirectionVector[1];
2261 }
2262
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002263 // Find a solution involving pushing / displacing any items in the way
2264 ItemConfiguration swapSolution = findReorderSolution(pixelX, pixelY, minSpanX, minSpanY,
Adam Cohen482ed822012-03-02 14:15:13 -08002265 spanX, spanY, mDirectionVector, dragView, true, new ItemConfiguration());
2266
2267 // We attempt the approach which doesn't shuffle views at all
2268 ItemConfiguration noShuffleSolution = findConfigurationNoShuffle(pixelX, pixelY, minSpanX,
2269 minSpanY, spanX, spanY, dragView, new ItemConfiguration());
2270
2271 ItemConfiguration finalSolution = null;
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002272
2273 // If the reorder solution requires resizing (shrinking) the item being dropped, we instead
2274 // favor a solution in which the item is not resized, but
Adam Cohen482ed822012-03-02 14:15:13 -08002275 if (swapSolution.isSolution && swapSolution.area() >= noShuffleSolution.area()) {
2276 finalSolution = swapSolution;
2277 } else if (noShuffleSolution.isSolution) {
2278 finalSolution = noShuffleSolution;
2279 }
2280
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002281 if (mode == MODE_SHOW_REORDER_HINT) {
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002282 if (finalSolution != null) {
Adam Cohenfe692872013-12-11 14:47:23 -08002283 beginOrAdjustReorderPreviewAnimations(finalSolution, dragView, 0,
2284 ReorderPreviewAnimation.MODE_HINT);
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002285 result[0] = finalSolution.cellX;
2286 result[1] = finalSolution.cellY;
2287 resultSpan[0] = finalSolution.spanX;
2288 resultSpan[1] = finalSolution.spanY;
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002289 } else {
2290 result[0] = result[1] = resultSpan[0] = resultSpan[1] = -1;
2291 }
2292 return result;
2293 }
2294
Adam Cohen482ed822012-03-02 14:15:13 -08002295 boolean foundSolution = true;
2296 if (!DESTRUCTIVE_REORDER) {
2297 setUseTempCoords(true);
2298 }
2299
2300 if (finalSolution != null) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002301 result[0] = finalSolution.cellX;
2302 result[1] = finalSolution.cellY;
2303 resultSpan[0] = finalSolution.spanX;
2304 resultSpan[1] = finalSolution.spanY;
Adam Cohen482ed822012-03-02 14:15:13 -08002305
2306 // If we're just testing for a possible location (MODE_ACCEPT_DROP), we don't bother
2307 // committing anything or animating anything as we just want to determine if a solution
2308 // exists
2309 if (mode == MODE_DRAG_OVER || mode == MODE_ON_DROP || mode == MODE_ON_DROP_EXTERNAL) {
2310 if (!DESTRUCTIVE_REORDER) {
2311 copySolutionToTempState(finalSolution, dragView);
2312 }
2313 setItemPlacementDirty(true);
2314 animateItemsToSolution(finalSolution, dragView, mode == MODE_ON_DROP);
2315
Adam Cohen19f37922012-03-21 11:59:11 -07002316 if (!DESTRUCTIVE_REORDER &&
2317 (mode == MODE_ON_DROP || mode == MODE_ON_DROP_EXTERNAL)) {
Adam Cohen482ed822012-03-02 14:15:13 -08002318 commitTempPlacement();
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002319 completeAndClearReorderPreviewAnimations();
Adam Cohen19f37922012-03-21 11:59:11 -07002320 setItemPlacementDirty(false);
2321 } else {
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002322 beginOrAdjustReorderPreviewAnimations(finalSolution, dragView,
2323 REORDER_ANIMATION_DURATION, ReorderPreviewAnimation.MODE_PREVIEW);
Adam Cohen482ed822012-03-02 14:15:13 -08002324 }
2325 }
2326 } else {
2327 foundSolution = false;
2328 result[0] = result[1] = resultSpan[0] = resultSpan[1] = -1;
2329 }
2330
2331 if ((mode == MODE_ON_DROP || !foundSolution) && !DESTRUCTIVE_REORDER) {
2332 setUseTempCoords(false);
2333 }
Adam Cohen482ed822012-03-02 14:15:13 -08002334
Michael Jurkaa52570f2012-03-20 03:18:20 -07002335 mShortcutsAndWidgets.requestLayout();
Adam Cohen482ed822012-03-02 14:15:13 -08002336 return result;
2337 }
2338
Adam Cohen19f37922012-03-21 11:59:11 -07002339 void setItemPlacementDirty(boolean dirty) {
2340 mItemPlacementDirty = dirty;
Adam Cohen482ed822012-03-02 14:15:13 -08002341 }
Adam Cohen19f37922012-03-21 11:59:11 -07002342 boolean isItemPlacementDirty() {
2343 return mItemPlacementDirty;
Adam Cohen482ed822012-03-02 14:15:13 -08002344 }
2345
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002346 private static class ItemConfiguration extends CellAndSpan {
Rajeev Kumar9962dbe2017-06-12 12:16:20 -07002347 final ArrayMap<View, CellAndSpan> map = new ArrayMap<>();
2348 private final ArrayMap<View, CellAndSpan> savedMap = new ArrayMap<>();
2349 final ArrayList<View> sortedViews = new ArrayList<>();
Adam Cohenfa3c58f2013-12-06 16:10:55 -08002350 ArrayList<View> intersectingViews;
Adam Cohen482ed822012-03-02 14:15:13 -08002351 boolean isSolution = false;
Adam Cohen482ed822012-03-02 14:15:13 -08002352
Adam Cohenf3900c22012-11-16 18:28:11 -08002353 void save() {
2354 // Copy current state into savedMap
2355 for (View v: map.keySet()) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002356 savedMap.get(v).copyFrom(map.get(v));
Adam Cohenf3900c22012-11-16 18:28:11 -08002357 }
2358 }
2359
2360 void restore() {
2361 // Restore current state from savedMap
2362 for (View v: savedMap.keySet()) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002363 map.get(v).copyFrom(savedMap.get(v));
Adam Cohenf3900c22012-11-16 18:28:11 -08002364 }
2365 }
2366
2367 void add(View v, CellAndSpan cs) {
2368 map.put(v, cs);
2369 savedMap.put(v, new CellAndSpan());
2370 sortedViews.add(v);
2371 }
2372
Adam Cohen482ed822012-03-02 14:15:13 -08002373 int area() {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002374 return spanX * spanY;
Adam Cohenf3900c22012-11-16 18:28:11 -08002375 }
2376
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002377 void getBoundingRectForViews(ArrayList<View> views, Rect outRect) {
2378 boolean first = true;
2379 for (View v: views) {
2380 CellAndSpan c = map.get(v);
2381 if (first) {
2382 outRect.set(c.cellX, c.cellY, c.cellX + c.spanX, c.cellY + c.spanY);
2383 first = false;
2384 } else {
2385 outRect.union(c.cellX, c.cellY, c.cellX + c.spanX, c.cellY + c.spanY);
2386 }
2387 }
Adam Cohenf3900c22012-11-16 18:28:11 -08002388 }
Adam Cohen482ed822012-03-02 14:15:13 -08002389 }
2390
Adam Cohendf035382011-04-11 17:22:04 -07002391 /**
Adam Cohendf035382011-04-11 17:22:04 -07002392 * Find a starting cell position that will fit the given bounds nearest the requested
2393 * cell location. Uses Euclidean distance to score multiple vacant areas.
2394 *
2395 * @param pixelX The X location at which you want to search for a vacant area.
2396 * @param pixelY The Y location at which you want to search for a vacant area.
2397 * @param spanX Horizontal span of the object.
2398 * @param spanY Vertical span of the object.
Adam Cohendf035382011-04-11 17:22:04 -07002399 * @param result Previously returned value to possibly recycle.
2400 * @return The X, Y cell of a vacant area that can contain this object,
2401 * nearest the requested location.
2402 */
Adam Cohenf9c184a2016-01-15 16:47:43 -08002403 public int[] findNearestArea(int pixelX, int pixelY, int spanX, int spanY, int[] result) {
Sunny Goyalf7a29e82015-04-24 15:20:43 -07002404 return findNearestArea(pixelX, pixelY, spanX, spanY, spanX, spanY, false, result, null);
Adam Cohendf035382011-04-11 17:22:04 -07002405 }
2406
Michael Jurka0280c3b2010-09-17 15:00:07 -07002407 boolean existsEmptyCell() {
2408 return findCellForSpan(null, 1, 1);
2409 }
2410
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002411 /**
Michael Jurka0280c3b2010-09-17 15:00:07 -07002412 * Finds the upper-left coordinate of the first rectangle in the grid that can
2413 * hold a cell of the specified dimensions. If intersectX and intersectY are not -1,
2414 * then this method will only return coordinates for rectangles that contain the cell
2415 * (intersectX, intersectY)
2416 *
2417 * @param cellXY The array that will contain the position of a vacant cell if such a cell
2418 * can be found.
2419 * @param spanX The horizontal span of the cell we want to find.
2420 * @param spanY The vertical span of the cell we want to find.
2421 *
2422 * @return True if a vacant cell of the specified dimension was found, false otherwise.
Patrick Dubroy6569f2c2010-07-12 14:25:18 -07002423 */
Hyunyoung Song3f471442015-04-08 19:01:34 -07002424 public boolean findCellForSpan(int[] cellXY, int spanX, int spanY) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002425 if (cellXY == null) {
2426 cellXY = new int[2];
Michael Jurka0280c3b2010-09-17 15:00:07 -07002427 }
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002428 return mOccupied.findVacantCell(cellXY, spanX, spanY);
Michael Jurka0280c3b2010-09-17 15:00:07 -07002429 }
2430
2431 /**
Winson Chungc07918d2011-07-01 15:35:26 -07002432 * A drag event has begun over this layout.
2433 * It may have begun over this layout (in which case onDragChild is called first),
2434 * or it may have begun on another layout.
2435 */
2436 void onDragEnter() {
Winson Chungc07918d2011-07-01 15:35:26 -07002437 mDragging = true;
2438 }
2439
2440 /**
Michael Jurka0280c3b2010-09-17 15:00:07 -07002441 * Called when drag has left this CellLayout or has been completed (successfully or not)
2442 */
2443 void onDragExit() {
Joe Onorato4be866d2010-10-10 11:26:02 -07002444 // This can actually be called when we aren't in a drag, e.g. when adding a new
2445 // item to this layout via the customize drawer.
2446 // Guard against that case.
2447 if (mDragging) {
2448 mDragging = false;
Patrick Dubroyde7658b2010-09-27 11:15:43 -07002449 }
Patrick Dubroy08ae2ec2010-10-14 23:54:22 -07002450
2451 // Invalidate the drag data
Adam Cohend41fbf52012-02-16 23:53:59 -08002452 mDragCell[0] = mDragCell[1] = -1;
Patrick Dubroy08ae2ec2010-10-14 23:54:22 -07002453 mDragOutlineAnims[mDragOutlineCurrent].animateOut();
2454 mDragOutlineCurrent = (mDragOutlineCurrent + 1) % mDragOutlineAnims.length;
Adam Cohen19f37922012-03-21 11:59:11 -07002455 revertTempState();
Michael Jurka33945b22010-12-21 18:19:38 -08002456 setIsDragOverlapping(false);
Patrick Dubroy6569f2c2010-07-12 14:25:18 -07002457 }
2458
2459 /**
Winson Chungaafa03c2010-06-11 17:34:16 -07002460 * Mark a child as having been dropped.
Patrick Dubroyde7658b2010-09-27 11:15:43 -07002461 * At the beginning of the drag operation, the child may have been on another
Patrick Dubroyce34a972010-10-19 10:34:32 -07002462 * screen, but it is re-parented before this method is called.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002463 *
2464 * @param child The child that is being dropped
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002465 */
Adam Cohen716b51e2011-06-30 12:09:54 -07002466 void onDropChild(View child) {
Romain Guyd94533d2009-08-17 10:01:15 -07002467 if (child != null) {
2468 LayoutParams lp = (LayoutParams) child.getLayoutParams();
Romain Guy84f296c2009-11-04 15:00:44 -08002469 lp.dropped = true;
Romain Guyd94533d2009-08-17 10:01:15 -07002470 child.requestLayout();
Tony Wickham1cdb6d02015-09-17 11:08:27 -07002471 markCellsAsOccupiedForView(child);
Romain Guyd94533d2009-08-17 10:01:15 -07002472 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002473 }
2474
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002475 /**
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002476 * Computes a bounding rectangle for a range of cells
Winson Chungaafa03c2010-06-11 17:34:16 -07002477 *
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002478 * @param cellX X coordinate of upper left corner expressed as a cell position
2479 * @param cellY Y coordinate of upper left corner expressed as a cell position
Winson Chungaafa03c2010-06-11 17:34:16 -07002480 * @param cellHSpan Width in cells
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002481 * @param cellVSpan Height in cells
Patrick Dubroy6569f2c2010-07-12 14:25:18 -07002482 * @param resultRect Rect into which to put the results
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002483 */
Adam Cohend41fbf52012-02-16 23:53:59 -08002484 public void cellToRect(int cellX, int cellY, int cellHSpan, int cellVSpan, Rect resultRect) {
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002485 final int cellWidth = mCellWidth;
2486 final int cellHeight = mCellHeight;
Winson Chungaafa03c2010-06-11 17:34:16 -07002487
Winson Chung4b825dcd2011-06-19 12:41:22 -07002488 final int hStartPadding = getPaddingLeft();
2489 final int vStartPadding = getPaddingTop();
Winson Chungaafa03c2010-06-11 17:34:16 -07002490
Sunny Goyalaa8a8712016-11-20 15:26:01 +05302491 int width = cellHSpan * cellWidth;
2492 int height = cellVSpan * cellHeight;
2493 int x = hStartPadding + cellX * cellWidth;
2494 int y = vStartPadding + cellY * cellHeight;
Winson Chungaafa03c2010-06-11 17:34:16 -07002495
Patrick Dubroy6569f2c2010-07-12 14:25:18 -07002496 resultRect.set(x, y, x + width, y + height);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002497 }
Winson Chungaafa03c2010-06-11 17:34:16 -07002498
Adam Cohend4844c32011-02-18 19:25:06 -08002499 public void markCellsAsOccupiedForView(View view) {
Michael Jurkaa52570f2012-03-20 03:18:20 -07002500 if (view == null || view.getParent() != mShortcutsAndWidgets) return;
Michael Jurka0280c3b2010-09-17 15:00:07 -07002501 LayoutParams lp = (LayoutParams) view.getLayoutParams();
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002502 mOccupied.markCells(lp.cellX, lp.cellY, lp.cellHSpan, lp.cellVSpan, true);
Michael Jurka0280c3b2010-09-17 15:00:07 -07002503 }
2504
Adam Cohend4844c32011-02-18 19:25:06 -08002505 public void markCellsAsUnoccupiedForView(View view) {
Michael Jurkaa52570f2012-03-20 03:18:20 -07002506 if (view == null || view.getParent() != mShortcutsAndWidgets) return;
Michael Jurka0280c3b2010-09-17 15:00:07 -07002507 LayoutParams lp = (LayoutParams) view.getLayoutParams();
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002508 mOccupied.markCells(lp.cellX, lp.cellY, lp.cellHSpan, lp.cellVSpan, false);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002509 }
2510
Adam Cohen2801caf2011-05-13 20:57:39 -07002511 public int getDesiredWidth() {
Sunny Goyalaa8a8712016-11-20 15:26:01 +05302512 return getPaddingLeft() + getPaddingRight() + (mCountX * mCellWidth);
Adam Cohen2801caf2011-05-13 20:57:39 -07002513 }
2514
2515 public int getDesiredHeight() {
Sunny Goyalaa8a8712016-11-20 15:26:01 +05302516 return getPaddingTop() + getPaddingBottom() + (mCountY * mCellHeight);
Adam Cohen2801caf2011-05-13 20:57:39 -07002517 }
2518
Michael Jurka66d72172011-04-12 16:29:25 -07002519 public boolean isOccupied(int x, int y) {
2520 if (x < mCountX && y < mCountY) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002521 return mOccupied.cells[x][y];
Michael Jurka66d72172011-04-12 16:29:25 -07002522 } else {
2523 throw new RuntimeException("Position exceeds the bound of this CellLayout");
2524 }
2525 }
2526
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002527 @Override
2528 public ViewGroup.LayoutParams generateLayoutParams(AttributeSet attrs) {
2529 return new CellLayout.LayoutParams(getContext(), attrs);
2530 }
2531
2532 @Override
2533 protected boolean checkLayoutParams(ViewGroup.LayoutParams p) {
2534 return p instanceof CellLayout.LayoutParams;
2535 }
2536
2537 @Override
2538 protected ViewGroup.LayoutParams generateLayoutParams(ViewGroup.LayoutParams p) {
2539 return new CellLayout.LayoutParams(p);
2540 }
2541
2542 public static class LayoutParams extends ViewGroup.MarginLayoutParams {
2543 /**
2544 * Horizontal location of the item in the grid.
2545 */
2546 @ViewDebug.ExportedProperty
2547 public int cellX;
2548
2549 /**
2550 * Vertical location of the item in the grid.
2551 */
2552 @ViewDebug.ExportedProperty
2553 public int cellY;
2554
2555 /**
Adam Cohen482ed822012-03-02 14:15:13 -08002556 * Temporary horizontal location of the item in the grid during reorder
2557 */
2558 public int tmpCellX;
2559
2560 /**
2561 * Temporary vertical location of the item in the grid during reorder
2562 */
2563 public int tmpCellY;
2564
2565 /**
2566 * Indicates that the temporary coordinates should be used to layout the items
2567 */
2568 public boolean useTmpCoords;
2569
2570 /**
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002571 * Number of cells spanned horizontally by the item.
2572 */
2573 @ViewDebug.ExportedProperty
2574 public int cellHSpan;
2575
2576 /**
2577 * Number of cells spanned vertically by the item.
2578 */
2579 @ViewDebug.ExportedProperty
2580 public int cellVSpan;
Winson Chungaafa03c2010-06-11 17:34:16 -07002581
Adam Cohen1b607ed2011-03-03 17:26:50 -08002582 /**
2583 * Indicates whether the item will set its x, y, width and height parameters freely,
2584 * or whether these will be computed based on cellX, cellY, cellHSpan and cellVSpan.
2585 */
Adam Cohend4844c32011-02-18 19:25:06 -08002586 public boolean isLockedToGrid = true;
2587
Adam Cohen482ed822012-03-02 14:15:13 -08002588 /**
2589 * Indicates whether this item can be reordered. Always true except in the case of the
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002590 * the AllApps button and QSB place holder.
Adam Cohen482ed822012-03-02 14:15:13 -08002591 */
2592 public boolean canReorder = true;
2593
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002594 // X coordinate of the view in the layout.
2595 @ViewDebug.ExportedProperty
Vadim Tryshevfedca432015-08-19 17:55:02 -07002596 public int x;
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002597 // Y coordinate of the view in the layout.
2598 @ViewDebug.ExportedProperty
Vadim Tryshevfedca432015-08-19 17:55:02 -07002599 public int y;
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002600
Romain Guy84f296c2009-11-04 15:00:44 -08002601 boolean dropped;
Romain Guyfcb9e712009-10-02 16:06:52 -07002602
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002603 public LayoutParams(Context c, AttributeSet attrs) {
2604 super(c, attrs);
2605 cellHSpan = 1;
2606 cellVSpan = 1;
2607 }
2608
2609 public LayoutParams(ViewGroup.LayoutParams source) {
2610 super(source);
2611 cellHSpan = 1;
2612 cellVSpan = 1;
2613 }
Winson Chungaafa03c2010-06-11 17:34:16 -07002614
2615 public LayoutParams(LayoutParams source) {
2616 super(source);
2617 this.cellX = source.cellX;
2618 this.cellY = source.cellY;
2619 this.cellHSpan = source.cellHSpan;
2620 this.cellVSpan = source.cellVSpan;
2621 }
2622
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002623 public LayoutParams(int cellX, int cellY, int cellHSpan, int cellVSpan) {
Romain Guy8f19cdd2010-01-08 15:07:00 -08002624 super(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002625 this.cellX = cellX;
2626 this.cellY = cellY;
2627 this.cellHSpan = cellHSpan;
2628 this.cellVSpan = cellVSpan;
2629 }
2630
Sunny Goyalaa8a8712016-11-20 15:26:01 +05302631 public void setup(int cellWidth, int cellHeight, boolean invertHorizontally, int colCount) {
Jon Miranda7ae64ff2016-11-21 16:18:46 -08002632 setup(cellWidth, cellHeight, invertHorizontally, colCount, 1.0f, 1.0f);
2633 }
2634
2635 /**
2636 * Use this method, as opposed to {@link #setup(int, int, boolean, int)}, if the view needs
2637 * to be scaled.
2638 *
2639 * ie. In multi-window mode, we setup widgets so that they are measured and laid out
2640 * using their full/invariant device profile sizes.
2641 */
2642 public void setup(int cellWidth, int cellHeight, boolean invertHorizontally, int colCount,
2643 float cellScaleX, float cellScaleY) {
Adam Cohend4844c32011-02-18 19:25:06 -08002644 if (isLockedToGrid) {
2645 final int myCellHSpan = cellHSpan;
2646 final int myCellVSpan = cellVSpan;
Adam Cohen2374abf2013-04-16 14:56:57 -07002647 int myCellX = useTmpCoords ? tmpCellX : cellX;
2648 int myCellY = useTmpCoords ? tmpCellY : cellY;
2649
2650 if (invertHorizontally) {
2651 myCellX = colCount - myCellX - cellHSpan;
2652 }
Adam Cohen1b607ed2011-03-03 17:26:50 -08002653
Jon Miranda7ae64ff2016-11-21 16:18:46 -08002654 width = (int) (myCellHSpan * cellWidth / cellScaleX - leftMargin - rightMargin);
2655 height = (int) (myCellVSpan * cellHeight / cellScaleY - topMargin - bottomMargin);
Sunny Goyalaa8a8712016-11-20 15:26:01 +05302656 x = (myCellX * cellWidth + leftMargin);
2657 y = (myCellY * cellHeight + topMargin);
Adam Cohend4844c32011-02-18 19:25:06 -08002658 }
2659 }
Winson Chungaafa03c2010-06-11 17:34:16 -07002660
Winson Chungaafa03c2010-06-11 17:34:16 -07002661 public String toString() {
2662 return "(" + this.cellX + ", " + this.cellY + ")";
2663 }
Adam Cohen7f4eabe2011-04-21 16:19:16 -07002664
2665 public void setWidth(int width) {
2666 this.width = width;
2667 }
2668
2669 public int getWidth() {
2670 return width;
2671 }
2672
2673 public void setHeight(int height) {
2674 this.height = height;
2675 }
2676
2677 public int getHeight() {
2678 return height;
2679 }
2680
2681 public void setX(int x) {
2682 this.x = x;
2683 }
2684
2685 public int getX() {
2686 return x;
2687 }
2688
2689 public void setY(int y) {
2690 this.y = y;
2691 }
2692
2693 public int getY() {
2694 return y;
2695 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002696 }
2697
Michael Jurka0280c3b2010-09-17 15:00:07 -07002698 // This class stores info for two purposes:
2699 // 1. When dragging items (mDragInfo in Workspace), we store the View, its cellX & cellY,
2700 // its spanX, spanY, and the screen it is on
2701 // 2. When long clicking on an empty cell in a CellLayout, we save information about the
2702 // cellX and cellY coordinates and which page was clicked. We then set this as a tag on
2703 // the CellLayout that was long clicked
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002704 public static final class CellInfo extends CellAndSpan {
Rajeev Kumar9962dbe2017-06-12 12:16:20 -07002705 public final View cell;
2706 final long screenId;
2707 final long container;
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002708
Sunny Goyal83a8f042015-05-19 12:52:12 -07002709 public CellInfo(View v, ItemInfo info) {
Adam Cohene0aaa0d2014-05-12 12:44:22 -07002710 cellX = info.cellX;
2711 cellY = info.cellY;
2712 spanX = info.spanX;
2713 spanY = info.spanY;
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002714 cell = v;
Adam Cohene0aaa0d2014-05-12 12:44:22 -07002715 screenId = info.screenId;
2716 container = info.container;
2717 }
2718
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002719 @Override
2720 public String toString() {
Winson Chungaafa03c2010-06-11 17:34:16 -07002721 return "Cell[view=" + (cell == null ? "null" : cell.getClass())
2722 + ", x=" + cellX + ", y=" + cellY + "]";
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002723 }
2724 }
Michael Jurkad771c962011-08-09 15:00:48 -07002725
Tony Wickham86930612015-09-09 13:50:40 -07002726 /**
2727 * Returns whether an item can be placed in this CellLayout (after rearranging and/or resizing
2728 * if necessary).
2729 */
2730 public boolean hasReorderSolution(ItemInfo itemInfo) {
2731 int[] cellPoint = new int[2];
2732 // Check for a solution starting at every cell.
2733 for (int cellX = 0; cellX < getCountX(); cellX++) {
2734 for (int cellY = 0; cellY < getCountY(); cellY++) {
2735 cellToPoint(cellX, cellY, cellPoint);
2736 if (findReorderSolution(cellPoint[0], cellPoint[1], itemInfo.minSpanX,
2737 itemInfo.minSpanY, itemInfo.spanX, itemInfo.spanY, mDirectionVector, null,
2738 true, new ItemConfiguration()).isSolution) {
2739 return true;
2740 }
2741 }
2742 }
2743 return false;
2744 }
2745
Sunny Goyal9ca9c132015-04-29 14:57:22 -07002746 public boolean isRegionVacant(int x, int y, int spanX, int spanY) {
Sunny Goyalff4ba2d2016-04-02 14:12:34 -07002747 return mOccupied.isRegionVacant(x, y, spanX, spanY);
Sunny Goyal9ca9c132015-04-29 14:57:22 -07002748 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002749}