using UnityEngine;
|
using UnityEngine.UI;
|
using System.Collections;
|
using System;
|
using System.Collections.Generic;
|
|
namespace EnhancedUI.EnhancedScroller
|
{
|
/// <summary>
|
/// This delegate handles the visibility changes of cell views
|
/// </summary>
|
/// <param name="cellView">The cell view that changed visibility</param>
|
public delegate void CellViewVisibilityChangedDelegate(EnhancedScrollerCellView cellView);
|
//委托 当可见性改变时，传入的是当前改变的CellView对象（对象继承自EnhancedScrollerCellView) 事件在 AddCellView和_RecycleCell中触发
|
|
/// <summary>
|
/// This delegate handles the scrolling callback of the ScrollRect.
|
/// </summary>
|
/// <param name="scroller">The scroller that called the delegate</param>
|
/// <param name="val">The scroll value of the scroll rect</param>
|
/// <param name="scrollPosition">The scroll position in pixels from the start of the scroller</param>
|
public delegate void ScrollerScrolledDelegate(EnhancedScroller scroller, Vector2 val, float scrollPosition);
|
//委托 当scroll valuechange 时，在onvaluechange事件中触发
|
|
/// <summary>
|
/// This delegate handles the snapping of the scroller.
|
/// </summary>
|
/// <param name="scroller">The scroller that called the delegate</param>
|
/// <param name="cellIndex">The index of the cell view snapped on (this may be different than the data index in case of looping)</param>
|
/// <param name="dataIndex">The index of the data the view snapped on</param>
|
public delegate void ScrollerSnappedDelegate(EnhancedScroller scroller, int cellIndex, int dataIndex);
|
//委托 当snap完成时， 在SnapJumpComplete时触发(当开启snap时，每次滑动后都会去进行定位，当定位后就会调用SnapJumpComplete）
|
|
/// <summary>
|
/// This delegate handles the change in state of the scroller (scrolling or not scrolling)
|
/// </summary>
|
/// <param name="scroller">The scroller that changed state</param>
|
/// <param name="scrolling">Whether or not the scroller is scrolling</param>
|
public delegate void ScrollerScrollingChangedDelegate(EnhancedScroller scroller, bool scrolling);
|
//委托 当scroll.velocity开始不为0 或为0 时 ，在Update中触发（即当开始滑动时或当停止滑动时触发，以velocity为基准，为0和不为0时分别触发一次）
|
|
/// <summary>
|
/// This delegate handles the change in state of the scroller (jumping or not jumping)
|
/// </summary>
|
/// <param name="scroller">The scroller that changed state</param>
|
/// <param name="tweening">Whether or not the scroller is tweening</param>
|
public delegate void ScrollerTweeningChangedDelegate(EnhancedScroller scroller, bool tweening);
|
//委托 当开始播放Tween和停止Tween时调用 ，在JumpToDataIndex中如果使用Tween进行过渡定位时，会在开始播放时和结束时各触发一次
|
|
/// <summary>
|
/// The EnhancedScroller allows you to easily set up a dynamic scroller that will recycle views for you. This means
|
/// that using only a handful of views, you can display thousands of rows. This will save memory and processing
|
/// power in your application.
|
/// </summary>
|
[RequireComponent(typeof(ScrollRect))]
|
public class EnhancedScroller : MonoBehaviour
|
{
|
#region Public
|
|
/// <summary>
|
/// The direction this scroller is handling
|
/// </summary>
|
public enum ScrollDirectionEnum//滑动方式
|
{
|
Vertical,
|
Horizontal
|
}
|
|
/// <summary>
|
/// Which side of a cell to reference.
|
/// For vertical scrollers, before means above, after means below.
|
/// For horizontal scrollers, before means to left of, after means to the right of.
|
/// </summary>
|
public enum CellViewPositionEnum//当前CellViewPrefab的上方还是下方
|
{
|
Before,
|
After
|
}
|
|
/// <summary>
|
/// This will set how the scroll bar should be shown based on the data. If no scrollbar
|
/// is attached, then this is ignored. OnlyIfNeeded will hide the scrollbar based on whether
|
/// the scroller is looping or there aren't enough items to scroll.
|
/// </summary>
|
public enum ScrollbarVisibilityEnum//是否有滑动条，在looping模式下是不会显示的
|
{
|
OnlyIfNeeded,
|
Always,
|
Never
|
}
|
|
/// <summary>
|
/// The direction the scroller is handling
|
/// </summary>
|
public ScrollDirectionEnum scrollDirection;
|
|
/// <summary>
|
/// The number of pixels between cell views, starting after the first cell view
|
/// </summary>
|
public float spacing;
|
|
/// <summary>
|
/// The padding inside of the scroller: top, bottom, left, right.
|
/// </summary>
|
public RectOffset padding;
|
|
/// <summary>
|
/// Whether the scroller should loop the cell views
|
/// </summary>
|
[SerializeField]
|
private bool loop;
|
|
/// <summary>
|
/// Whether the scollbar should be shown
|
/// </summary>
|
[SerializeField]
|
private ScrollbarVisibilityEnum scrollbarVisibility;
|
|
/// <summary>
|
/// Whether snapping is turned on
|
/// </summary>
|
public bool snapping;//是否开启定位
|
|
/// <summary>
|
/// This is the speed that will initiate the snap. When the
|
/// scroller slows down to this speed it will snap to the location
|
/// specified.
|
/// </summary>
|
public float snapVelocityThreshold;//检测定位的阀值，当低于这个值的时候就会触发定位
|
|
/// <summary>
|
/// The snap offset to watch for. When the snap occurs, this
|
/// location in the scroller will be how which cell to snap to
|
/// is determined.
|
/// Typically, the offset is in the range 0..1, with 0 being
|
/// the top / left of the scroller and 1 being the bottom / right.
|
/// In most situations the watch offset and the jump offset
|
/// will be the same, they are just separated in case you need
|
/// that added functionality.
|
/// </summary>
|
public float snapWatchOffset;//定位后当前CellVeiw在可视区域内偏移，当为0时定位在最上方，为1时定位在最下方
|
|
/// <summary>
|
/// The snap location to move the cell to. When the snap occurs,
|
/// this location in the scroller will be where the snapped cell
|
/// is moved to.
|
/// Typically, the offset is in the range 0..1, with 0 being
|
/// the top / left of the scroller and 1 being the bottom / right.
|
/// In most situations the watch offset and the jump offset
|
/// will be the same, they are just separated in case you need
|
/// that added functionality.
|
/// </summary>
|
public float snapJumpToOffset;//设置定位的偏移，实质上结果和snapWatchOffset一样，也是在0~1之间，增加这个属性主要是考虑到可能会出现一些特殊情况要使用到它
|
|
/// <summary>
|
/// Once the cell has been snapped to the scroller location, this
|
/// value will determine how the cell is centered on that scroller
|
/// location.
|
/// Typically, the offset is in the range 0..1, with 0 being
|
/// the top / left of the cell and 1 being the bottom / right.
|
/// </summary>
|
public float snapCellCenterOffset;//设置被定位的CellVeiw定位后的中心偏移，0~1之间取值，如果默认的话会以它的上部为基准，不般来说应该设置为0.5，定位到正中心
|
|
/// <summary>
|
/// Whether to include the spacing between cells when determining the
|
/// cell offset centering.
|
/// </summary>
|
public bool snapUseCellSpacing;//开启这个属性的时候，计算定位后的偏移将包括它的上下两个间距，否则即使有间距也不会纳入计算范围内
|
|
/// <summary>
|
/// What function to use when interpolating between the current
|
/// scroll position and the snap location. This is also known as easing.
|
/// If you want to go immediately to the snap location you can either
|
/// set the snapTweenType to immediate or set the snapTweenTime to zero.
|
/// </summary>
|
public TweenType snapTweenType;//定位时播放动画的类型
|
|
/// <summary>
|
/// The time it takes to interpolate between the current scroll
|
/// position and the snap location.
|
/// If you want to go immediately to the snap location you can either
|
/// set the snapTweenType to immediate or set the snapTweenTime to zero.
|
/// </summary>
|
public float snapTweenTime;//播放动画的总时长
|
|
public Action OnCompLoad;
|
|
/// <summary>
|
/// This delegate is called when a cell view is hidden or shown
|
/// </summary>
|
public CellViewVisibilityChangedDelegate cellViewVisibilityChanged;
|
|
/// <summary>
|
/// This delegate is called when the scroll rect scrolls
|
/// </summary>
|
public ScrollerScrolledDelegate scrollerScrolled;
|
|
/// <summary>
|
/// This delegate is called when the scroller has snapped to a position
|
/// </summary>
|
public ScrollerSnappedDelegate scrollerSnapped;
|
|
/// <summary>
|
/// This delegate is called when the scroller has started or stopped scrolling
|
/// </summary>
|
public ScrollerScrollingChangedDelegate scrollerScrollingChanged;
|
|
/// <summary>
|
/// This delegate is called when the scroller has started or stopped tweening
|
/// </summary>
|
public ScrollerTweeningChangedDelegate scrollerTweeningChanged;
|
|
/// <summary>
|
/// The Delegate is what the scroller will call when it needs to know information about
|
/// the underlying data or views. This allows a true MVC process.
|
/// </summary>
|
public IEnhancedScrollerDelegate Delegate { get { return _delegate; } set { _delegate = value; _reloadData = true; } }
|
/*这里要将一个实现了IEnhancedScrollerDelegate接口的类的对象赋值过来，这个对象用于控制整个Scroll,通过实现这个接口的几个方法
|
* 可以定义： 1. 当前CellVeiw的总数目
|
*
|
* 2. 某dataIndex对应的CellView元素的size
|
*
|
* 3.如何获取（从循环池里取，或实例化）一个CellView
|
* 并得到其CellView对象，而这个对象又继承自EnhancedScrollerCellView，
|
* 所以实际上获取了这个CellView的 ：
|
* 1.cellIdentifier（scroll存在不同Prefab时用于区分的字符串）
|
* 2.cellIndex dataIndex （dataIndex代表的是要循环的cellview元素索引，而cellIndex代表的是集合内元素的索引
|
* 当没有开启循环模式的时候，集合和元素是一致的，它们并没有什么不同，都能对应上相应的cellview元素
|
* ，但当开启循环后，集合会被扩充（比如扩充3倍），此时dataIndex的整个周期才是真正对应cellview元素的整个周期）
|
* 3. active 是否是激活状态
|
* 4.提供一个虚方法供子类重写用来实现一些具体的功能
|
* 5.通常这个对象本身也会提供一个方法用于对其进行初始化(比如Start()或者直接提供一个公有方法供外部主动调用）
|
*
|
*这个对象是整个scroll的核心，通过实现它继承的接口，定义了scroll下CellView的总数目，每个CellView的size，
|
* 通过调用 EnhancedScroller 中的 ReloadData()方法来初始化整个Scroll
|
* 通过实现GetCellView方法，可以调用EnhancedScrolelr类下的GetCellView（）方法，传入相应的CellView Prefab，通过定义的cellIdentifier
|
* 来从循环池里取对应的CellVeiw，如果没找到则实例化一个，而得到的这个对象又包含其相关的属性，索引和初始化的方法
|
* 通过声明一系列的事件可以绑定EnhancedScroller中的委托用于各类事件的触发
|
* */
|
|
|
/// <summary>
|
/// The absolute position in pixels from the start of the scroller
|
/// </summary>
|
public float ScrollPosition
|
{
|
get
|
{
|
return _scrollPosition;
|
}
|
set
|
{
|
// make sure the position is in the bounds of the current set of views
|
value = Mathf.Clamp(value, 0, GetScrollPositionForCellViewIndex(_cellViewSizeArray.Count - 1, CellViewPositionEnum.Before));
|
//将传入的Value的大小限制在整个_cellViewSizeArray集合内（注意是最后一个元素的上方，但是这个集合的长度也可能是复制过后的）
|
// only if the value has changed
|
if (_scrollPosition != value)
|
{
|
_scrollPosition = value;
|
if (scrollDirection == ScrollDirectionEnum.Vertical)
|
{
|
// set the vertical position
|
scrollRect.verticalNormalizedPosition = 1f - (_scrollPosition / _ScrollSize);
|
//这里要注意，如果集合进行过复制，那么这里的_scrollSize也一样会比原来的增加，因为_ScrollSize永远比content的总大小小一个可视区大小
|
|
}
|
else
|
{
|
// set the horizontal position
|
scrollRect.horizontalNormalizedPosition = (_scrollPosition / _ScrollSize);
|
}
|
|
// flag that we need to refresh
|
_refreshActive = true;
|
}
|
}
|
}
|
|
/// <summary>
|
/// Whether the scroller should loop the resulting cell views.
|
/// Looping creates three sets of internal size data, attempting
|
/// to keep the scroller in the middle set. If the scroller goes
|
/// outside of this set, it will jump back into the middle set,
|
/// giving the illusion of an infinite set of data.
|
/// </summary>
|
public bool Loop
|
{
|
get
|
{
|
return loop;
|
}
|
set
|
{
|
// only if the value has changed
|
if (loop != value)//如果相关属性发生了变化
|
{
|
// get the original position so that when we turn looping on
|
// we can jump back to this position
|
var originalScrollPosition = _scrollPosition;
|
|
loop = value;
|
|
// call resize to generate more internal elements if loop is on,
|
// remove the elements if loop is off
|
_Resize(false);
|
|
if (loop)
|
{
|
// set the new scroll position based on the middle set of data + the original position
|
ScrollPosition = _loopFirstScrollPosition + originalScrollPosition;
|
}
|
else
|
{
|
// set the new scroll position based on the original position and the first loop position
|
ScrollPosition = originalScrollPosition - _loopFirstScrollPosition;
|
}
|
|
// update the scrollbars
|
ScrollbarVisibility = scrollbarVisibility;
|
}
|
}
|
}
|
|
/// <summary>
|
/// Sets how the visibility of the scrollbars should be handled
|
/// </summary>
|
public ScrollbarVisibilityEnum ScrollbarVisibility
|
{
|
get
|
{
|
return scrollbarVisibility;
|
}
|
set
|
{
|
scrollbarVisibility = value;
|
|
// only if the scrollbar exists
|
if (_scrollbar != null)
|
{
|
// make sure we actually have some cell views
|
if (_cellViewOffsetArray != null && _cellViewOffsetArray.Count > 0)
|
{
|
if (_cellViewOffsetArray.Last() < ScrollRectSize || loop)
|
{
|
// if the size of the scrollable area is smaller than the scroller
|
// or if we have looping on, hide the scrollbar unless the visibility
|
// is set to Always.
|
_scrollbar.SetActive(scrollbarVisibility == ScrollbarVisibilityEnum.Always);
|
}
|
else
|
{
|
// if the size of the scrollable areas is larger than the scroller
|
// or looping is off, then show the scrollbars unless visibility
|
// is set to Never.
|
_scrollbar.SetActive(scrollbarVisibility != ScrollbarVisibilityEnum.Never);
|
}
|
}
|
}
|
}
|
}
|
|
/// <summary>
|
/// This is the velocity of the scroller.
|
/// </summary>
|
public Vector2 Velocity
|
{
|
get
|
{
|
return scrollRect.velocity;
|
}
|
set
|
{
|
scrollRect.velocity = value;
|
}
|
}
|
|
/// <summary>
|
/// The linear velocity is the velocity on one axis.
|
/// The scroller should only be moving one one axix.
|
/// </summary>
|
public float LinearVelocity //实质上是操作ScrollRect.velocity
|
//Get : 将向量转为float类型
|
//Set：用一个float类型构造一个相应的向量
|
//外部方法可以通过访问这个属性来使scroll运动起来
|
{
|
get
|
{
|
// return the velocity component depending on which direction this is scrolling
|
return (scrollDirection == ScrollDirectionEnum.Vertical ? scrollRect.velocity.y : scrollRect.velocity.x);
|
}
|
set
|
{
|
// set the appropriate component of the velocity
|
if (scrollDirection == ScrollDirectionEnum.Vertical)
|
{
|
scrollRect.velocity = new Vector2(0, value);
|
}
|
else
|
{
|
scrollRect.velocity = new Vector2(value, 0);
|
}
|
}
|
}
|
|
/// <summary>
|
/// Whether the scroller is scrolling or not
|
/// </summary>
|
public bool IsScrolling
|
{
|
get; private set;
|
}
|
|
/// <summary>
|
/// Whether the scroller is tweening or not
|
/// </summary>
|
public bool IsTweening
|
{
|
get; private set;
|
}
|
|
/// <summary>
|
/// This is the first cell view index showing in the scroller's visible area
|
/// </summary>
|
public int StartCellViewIndex//可视区内第一个能看到的元素索引（只要能看到就行，不一定要完全能看到）
|
{
|
get
|
{
|
return _activeCellViewsStartIndex;
|
}
|
}
|
|
/// <summary>
|
/// This is the last cell view index showing in the scroller's visible area
|
/// </summary>
|
public int EndCellViewIndex
|
{
|
get
|
{
|
return _activeCellViewsEndIndex;
|
}
|
}
|
|
/// <summary>
|
/// This is the first data index showing in the scroller's visible area
|
/// </summary>
|
public int StartDataIndex//当循环开启时dataIndex代表循环内的索引，当开启新一轮循环时，dataIndex也会重新计数
|
{
|
get
|
{
|
return _activeCellViewsStartIndex % NumberOfCells;
|
}
|
}
|
|
/// <summary>
|
/// This is the last data index showing in the scroller's visible area
|
/// </summary>
|
public int EndDataIndex
|
{
|
get
|
{
|
return _activeCellViewsEndIndex % NumberOfCells;
|
}
|
}
|
|
public int ActiveCellCnt {
|
get {
|
return _activeCellViews.Count;
|
}
|
}
|
|
/// <summary>
|
/// This is the number of cells in the scroller
|
/// </summary>
|
public int NumberOfCells//CellView的总个数，从最上方滑动到最下方总共显示的数目
|
{
|
get
|
{
|
return (_delegate != null ? _delegate.GetNumberOfCells(this) : 0);
|
}
|
}
|
|
/// <summary>
|
/// The size of the visible portion of the scroller
|
/// </summary>
|
public float ScrollRectSize//得到Scroll的高或宽
|
{
|
get
|
{
|
if (scrollDirection == ScrollDirectionEnum.Vertical)
|
return _scrollRectTransform.rect.height;
|
else
|
return _scrollRectTransform.rect.width;
|
}
|
}
|
|
public event Action OnFirstLoadAllEvent;
|
private bool m_IsLoadAll = false;
|
|
/// <summary>
|
/// Create a cell view, or recycle one if it already exists
|
/// </summary>
|
/// <param name="cellPrefab">The prefab to use to create the cell view</param>
|
/// <returns></returns>
|
public EnhancedScrollerCellView GetCellView(EnhancedScrollerCellView cellPrefab)
|
{
|
// see if there is a view to recycle
|
var cellView = _GetRecycledCellView(cellPrefab);
|
if (cellView == null)
|
{
|
// no recyleable cell found, so we create a new view
|
// and attach it to our container
|
var go = Instantiate(cellPrefab.gameObject);
|
cellView = go.GetComponent<EnhancedScrollerCellView>();
|
cellView.transform.SetParent(_container);
|
|
}
|
Vector3 pos = cellView.transform.localPosition;
|
if (pos.x == float.NaN || pos.y == float.NaN)
|
{
|
pos = Vector3.zero;
|
}
|
pos.z = 0;
|
cellView.transform.localPosition = pos;
|
return cellView;
|
/*这个方法会通过一个cellPrefab来取出一个cellView对象，首先会先从缓冲池里取，如果有相同cellIdentifier属性的物体
|
* 就把这个对象从缓冲池取出来，如果没有的话就实例化一个
|
*/
|
}
|
|
/// <summary>
|
/// This resets the internal size list and refreshes the cell views
|
/// </summary>
|
public void ReloadData()
|
{
|
_reloadData = false;
|
|
_scrollPosition = 0;
|
|
// recycle all the active cells so
|
// that we are sure to get fresh views
|
_RecycleAllCells();
|
|
// if we have a delegate handling our data, then
|
// call the resize
|
if (_delegate != null)
|
_Resize(false);
|
//这个方法用于初始化这个组件或重新加载这个组件
|
/*1.将_reloadData置为false，用于标记此组件已经初始化，Update()方法不用再重新执行
|
*2.将_scrollPosition 赋值为 0，当它为0时，后续的可视区域会以它为基准，滑动条将移动到最上边或最左边
|
*3.如果有可见的元素，全部移动到缓冲池
|
*4.执行Resize
|
* 1）循环模式下，扩充循环集合到3倍的大小（实际上在循环模式下，不管怎么滑动都只会在中间那个循环内）
|
* 2）如果传入false则定位到起始点，如果传入true则定位到当前_position（循环模式下定位到中间那个循环的对应点）
|
*/
|
}
|
|
/// <summary>
|
/// This calls the RefreshCellView method on each active cell.
|
/// If you override the RefreshCellView method in your cells
|
/// then you can update the UI without having to reload the data.
|
/// Note: this will not change the cell sizes, you will need
|
/// to call ReloadData for that to work.
|
/// </summary>
|
public void RefreshActiveCellViews() //这是提供给外界的一个方法，用于去主动操作当前Scroll可视区内所有的可见元素
|
{
|
for (var i = 0; i < _activeCellViews.Count; i++)
|
{
|
_activeCellViews[i].RefreshCellView();//每一个可见元素都可以重写这个方法来具体执行某段逻辑
|
}
|
if (this.Delegate != null)
|
{
|
this.Delegate.OnRebuildComplete();
|
}
|
}
|
|
public EnhancedScrollerCellView GetActiveCellView(int _index)
|
{
|
for (int i = 0; i < _activeCellViews.Count; i++)
|
{
|
if (_activeCellViews[i].index == _index)
|
{
|
return _activeCellViews[i];
|
}
|
}
|
return null;
|
}
|
|
public SmallList<EnhancedScrollerCellView> GetActiveCellViews()
|
{
|
return _activeCellViews;
|
}
|
|
internal float GetCellSize(int _dataIndex)
|
{
|
if (_dataIndex >= 0 && _dataIndex < _cellViewSizeArray.Count)
|
{
|
return _cellViewSizeArray[_dataIndex];
|
}
|
return 0;
|
}
|
|
/// <summary>
|
/// Removes all the recycled cell views. This should only be used after you
|
/// load in a completely different set of cell views that will not use the
|
/// recycled views. This will call garbage collection.
|
/// </summary>
|
public void ClearRecycled()//主动调用这个方法会立即清空缓存池并释放掉它占用的内存，可以配合上面的方法动态更新scroll
|
{
|
for (var i = 0; i < _recycledCellViews.Count; i++)
|
{
|
DestroyImmediate(_recycledCellViews[i].gameObject);
|
}
|
_recycledCellViews.Clear();
|
}
|
|
/// <summary>
|
/// Turn looping on or off. This is just a helper function so
|
/// you don't have to keep track of the state of the looping
|
/// in your own scripts.
|
/// </summary>
|
public void ToggleLoop()//主动调用会切换当前的循环模式
|
{
|
Loop = !loop;
|
}
|
|
/// <summary>
|
/// Jump to a position in the scroller based on a dataIndex. This overload allows you
|
/// to specify a specific offset within a cell as well.
|
/// </summary>
|
/// <param name="dataIndex">he data index to jump to</param>
|
/// <param name="scrollerOffset">The offset from the start (top / left) of the scroller in the range 0..1.
|
/// Outside this range will jump to the location before or after the scroller's viewable area</param>
|
/// <param name="cellOffset">The offset from the start (top / left) of the cell in the range 0..1</param>
|
/// <param name="useSpacing">Whether to calculate in the spacing of the scroller in the jump</param>
|
/// <param name="tweenType">What easing to use for the jump</param>
|
/// <param name="tweenTime">How long to interpolate to the jump point</param>
|
/// <param name="jumpComplete">This delegate is fired when the jump completes</param>
|
/// 跳转到dataIndex对应的cellview元素，可以选择相应的tween动画
|
public void JumpToDataIndex(int dataIndex,
|
float scrollerOffset = 0,
|
float cellOffset = 0,
|
bool useSpacing = true,
|
TweenType tweenType = TweenType.immediate,
|
float tweenTime = 0f,
|
Action jumpComplete = null
|
)
|
{
|
var cellOffsetPosition = 0f;
|
|
if (cellOffset != 0)
|
{
|
// calculate the cell offset position
|
|
// get the cell's size
|
var cellSize = (_delegate != null ? _delegate.GetCellViewSize(this, dataIndex) : 0);
|
|
if (useSpacing)
|
{
|
// if using spacing add spacing from one side
|
cellSize += spacing;
|
|
// if this is not a bounday cell, then add spacing from the other side
|
if (dataIndex > 0 && dataIndex < (NumberOfCells - 1)) cellSize += spacing;
|
}
|
|
// calculate the position based on the size of the cell and the offset within that cell
|
cellOffsetPosition = cellSize * cellOffset;
|
}
|
|
var newScrollPosition = 0f;
|
|
// cache the offset for quicker calculation
|
var offset = -(scrollerOffset * ScrollRectSize) + cellOffsetPosition;
|
|
if (loop)
|
{
|
// if looping, then we need to determine the closest jump position.
|
// we do that by checking all three sets of data locations, and returning the closest one
|
|
// get the scroll positions for each data set.
|
// Note: we are calculating the position based on the cell view index, not the data index here
|
var set1Position = GetScrollPositionForCellViewIndex(dataIndex, CellViewPositionEnum.Before) + offset;
|
var set2Position = GetScrollPositionForCellViewIndex(dataIndex + NumberOfCells, CellViewPositionEnum.Before) + offset;
|
var set3Position = GetScrollPositionForCellViewIndex(dataIndex + (NumberOfCells * 2), CellViewPositionEnum.Before) + offset;
|
|
// get the offsets of each scroll position from the current scroll position
|
var set1Diff = (Mathf.Abs(_scrollPosition - set1Position));
|
var set2Diff = (Mathf.Abs(_scrollPosition - set2Position));
|
var set3Diff = (Mathf.Abs(_scrollPosition - set3Position));
|
|
// choose the smallest offset from the current position (the closest position)
|
if (set1Diff < set2Diff)
|
{
|
if (set1Diff < set3Diff)
|
{
|
newScrollPosition = set1Position;
|
}
|
else
|
{
|
newScrollPosition = set3Position;
|
}
|
}
|
else
|
{
|
if (set2Diff < set3Diff)
|
{
|
newScrollPosition = set2Position;
|
}
|
else
|
{
|
newScrollPosition = set3Position;
|
}
|
}
|
}
|
else
|
{
|
// not looping, so just get the scroll position from the dataIndex
|
newScrollPosition = GetScrollPositionForDataIndex(dataIndex, CellViewPositionEnum.Before) + offset;
|
}
|
|
// clamp the scroll position to a valid location
|
newScrollPosition = Mathf.Clamp(newScrollPosition, 0, GetScrollPositionForCellViewIndex(_cellViewSizeArray.Count - 1, CellViewPositionEnum.Before));
|
|
// if spacing is used, adjust the final position
|
if (useSpacing)
|
{
|
// move back by the spacing if necessary
|
newScrollPosition = Mathf.Clamp(newScrollPosition - spacing, 0, GetScrollPositionForCellViewIndex(_cellViewSizeArray.Count - 1, CellViewPositionEnum.Before));
|
}
|
|
// start tweening
|
if (tweenType == TweenType.immediate || tweenTime == 0)
|
{
|
// if the easing is immediate or the time is zero, just jump to the end position
|
ScrollPosition = newScrollPosition;
|
return;
|
}
|
StartCoroutine(TweenPosition(tweenType, tweenTime, ScrollPosition, newScrollPosition, jumpComplete));
|
}
|
|
public void Tween(TweenType tweenType, float tweenTime, float newPosition, Action jumpComplete = null)
|
{
|
StartCoroutine(TweenPosition(tweenType, tweenTime, ScrollPosition, newPosition, jumpComplete));
|
}
|
|
/// <summary>
|
/// Jump to a position in the scroller based on a dataIndex.
|
/// </summary>
|
/// <param name="dataIndex">The data index to jump to</param>
|
/// <param name="position">Whether you should jump before or after the cell view</param>
|
[System.Obsolete("This is an obsolete method, please use the version of this function with a cell offset.")]
|
//过时的方法，可以选择定位到元素上方或下方（左右同理)，可以通过上面的方法调整偏移达到同样的效果
|
public void JumpToDataIndex(int dataIndex,
|
CellViewPositionEnum position = CellViewPositionEnum.Before,
|
bool useSpacing = true)
|
{
|
// if looping is on, we need to jump to the middle set of data, otherwise just use the dataIndex for the cellIndex
|
ScrollPosition = GetScrollPositionForDataIndex(dataIndex, position);
|
|
// if spacing is used, adjust the final position
|
if (useSpacing)
|
{
|
if (position == CellViewPositionEnum.Before)
|
ScrollPosition = _scrollPosition - spacing;
|
else
|
ScrollPosition = _scrollPosition + spacing;
|
}
|
}
|
|
/// <summary>
|
/// Snaps the scroller on command. This is called internally when snapping is set to true and the velocity
|
/// has dropped below the threshold. You can use this to manually snap whenever you like.
|
/// </summary>
|
/// 当开启锁定位置功能时，在滑动条滑动后元素会进行相应的定位（定位的约束在面板中可以进行设置）
|
public void Snap()
|
{
|
if (NumberOfCells == 0) return;
|
|
// set snap jumping to true so other events won't process while tweening
|
_snapJumping = true;
|
|
// stop the scroller
|
LinearVelocity = 0;
|
|
// cache the current inertia state and turn off inertia
|
_snapInertia = scrollRect.inertia;
|
scrollRect.inertia = false;
|
|
// calculate the snap position
|
var snapPosition = ScrollPosition + (ScrollRectSize * Mathf.Clamp01(snapWatchOffset));
|
|
// get the cell view index of cell at the watch location
|
_snapCellViewIndex = GetCellViewIndexAtPosition(snapPosition);
|
|
// get the data index of the cell at the watch location
|
_snapDataIndex = _snapCellViewIndex % NumberOfCells;
|
|
// jump the snapped cell to the jump offset location and center it on the cell offset
|
JumpToDataIndex(_snapDataIndex, snapJumpToOffset, snapCellCenterOffset, snapUseCellSpacing, snapTweenType, snapTweenTime, SnapJumpComplete);
|
}
|
|
/// <summary>
|
/// Gets the scroll position in pixels from the start of the scroller based on the cellViewIndex
|
/// </summary>
|
/// <param name="cellViewIndex">The cell index to look for. This is used instead of dataIndex in case of looping</param>
|
/// <param name="insertPosition">Do we want the start or end of the cell view's position</param>
|
/// <returns></returns>
|
public float GetScrollPositionForCellViewIndex(int cellViewIndex, CellViewPositionEnum insertPosition)//根据相关的索引从_cellViewOffsetArray里取对应的position
|
{
|
/*这个方法的主要作用是通过一个索引来返回position，而这个position实际上可以认为是可滑动的content向上或向左滑动了多少
|
* 因为之前通过_cellViewOffsetArray来存储了每个cellView下方相对于左上的偏移(TextAnchor.UpperLeft)所以通过索引实际上就能取出这个偏移量
|
* 再通过Before(取上或左) After(取下或右)来判断最终position的值
|
* -----scrollRect的NormallizedPosition实际上是可滑动区域的大小向另一方滑动中偏移量的比例--------------
|
* 所以可以通过postion和可滑动区域大小的比值来定义滑动条滑动到了哪个位置
|
*/
|
|
if (NumberOfCells == 0 || _cellViewOffsetArray.Count == 0) return 0;//如果scroll没有子物体直接返回
|
|
if (cellViewIndex <= 0 && insertPosition == CellViewPositionEnum.Before)
|
{
|
return 0;//如果是第一个子物体且要得到它的上方位置，直接返回0
|
}
|
else
|
{
|
if (cellViewIndex < _cellViewOffsetArray.Count)
|
{
|
// the index is in the range of cell view offsets
|
|
if (insertPosition == CellViewPositionEnum.Before)
|
{
|
// return the previous cell view's offset + the spacing between cell views
|
return _cellViewOffsetArray[cellViewIndex - 1] + spacing + (scrollDirection == ScrollDirectionEnum.Vertical ? padding.top : padding.left);
|
//返回当前索引上方的值
|
//这里要注意一点就是一般来说调用这个方法的时候就是处在loop模式之下，这里的_cellViewOffsetArray是经过复制后的集合
|
}
|
else
|
{
|
// return the offset of the cell view (offset is after the cell)
|
return _cellViewOffsetArray[cellViewIndex] + (scrollDirection == ScrollDirectionEnum.Vertical ? padding.top : padding.left);
|
//返回当前索引下方的值
|
}
|
}
|
else
|
{
|
// get the start position of the last cell (the offset of the second to last cell)
|
return _cellViewOffsetArray[_cellViewOffsetArray.Count - 2];
|
//返回最后一个索引的上方值
|
}
|
}
|
}
|
|
/// <summary>
|
/// Gets the scroll position in pixels from the start of the scroller based on the dataIndex
|
/// </summary>
|
/// <param name="dataIndex">The data index to look for</param>
|
/// <param name="insertPosition">Do we want the start or end of the cell view's position</param>
|
/// <returns></returns>
|
public float GetScrollPositionForDataIndex(int dataIndex, CellViewPositionEnum insertPosition)
|
{
|
return GetScrollPositionForCellViewIndex(loop ? _delegate.GetNumberOfCells(this) + dataIndex : dataIndex, insertPosition);
|
//通过dataIndex来确定ScrollPosition，要注意的是GetScrollPositionForCellViewIndex需要的是cellIndex而不是dataIndex
|
//所以在循环模式下，dataIndex要加上所有元素的数量（因为在循环模式下，dataIndex对应的元素永远都是在集合中的第二组）
|
}
|
|
/// <summary>
|
/// Gets the index of a cell view at a given position
|
/// </summary>
|
/// <param name="position">The pixel offset from the start of the scroller</param>
|
/// <returns></returns>
|
public int GetCellViewIndexAtPosition(float position)
|
{
|
// call the overrloaded method on the entire range of the list
|
return _GetCellIndexAtPosition(position, 0, _cellViewOffsetArray.Count - 1);
|
}
|
|
#endregion
|
|
#region Private
|
|
/// <summary>
|
/// Cached reference to the scrollRect
|
/// </summary>
|
private ScrollRect m_ScrollRect;
|
public ScrollRect scrollRect {
|
get {
|
if (m_ScrollRect == null) {
|
m_ScrollRect = this.GetComponent<ScrollRect>();
|
}
|
return m_ScrollRect;
|
}
|
}
|
|
/// <summary>
|
/// Cached reference to the scrollRect's transform
|
/// </summary>
|
private RectTransform _scrollRectTransform;
|
|
/// <summary>
|
/// Cached reference to the scrollbar if it exists
|
/// </summary>
|
private Scrollbar _scrollbar;
|
|
/// <summary>
|
/// Cached reference to the active cell view container
|
/// </summary>
|
private RectTransform _container;
|
|
/// <summary>
|
/// Cached reference to the layout group that handles view positioning
|
/// </summary>
|
private HorizontalOrVerticalLayoutGroup _layoutGroup;
|
public HorizontalOrVerticalLayoutGroup LayoutGroup
|
{
|
get
|
{
|
return _layoutGroup;
|
}
|
}
|
/// <summary>
|
/// Reference to the delegate that will tell this scroller information
|
/// about the underlying data
|
/// </summary>
|
private IEnhancedScrollerDelegate _delegate;
|
|
/// <summary>
|
/// Flag to tell the scroller to reload the data
|
/// </summary>
|
private bool _reloadData;
|
|
/// <summary>
|
/// Flag to tell the scroller to refresh the active list of cell views
|
/// </summary>
|
private bool _refreshActive;
|
|
/// <summary>
|
/// List of views that have been recycled
|
/// </summary>
|
private SmallList<EnhancedScrollerCellView> _recycledCellViews = new SmallList<EnhancedScrollerCellView>();
|
|
/// <summary>
|
/// Cached reference to the element used to offset the first visible cell view
|
/// </summary>
|
private LayoutElement _firstPadder;
|
|
/// <summary>
|
/// Cached reference to the element used to keep the cell views at the correct size
|
/// </summary>
|
private LayoutElement _lastPadder;
|
|
/// <summary>
|
/// Cached reference to the container that holds the recycled cell views
|
/// </summary>
|
private RectTransform _recycledCellViewContainer;
|
|
/// <summary>
|
/// Internal list of cell view sizes. This is created when the data is reloaded
|
/// to speed up processing.
|
/// </summary>
|
private SmallList<float> _cellViewSizeArray = new SmallList<float>();
|
|
/// <summary>
|
/// Internal list of cell view offsets. Each cell view offset is an accumulation
|
/// of the offsets previous to it.
|
/// This is created when the data is reloaded to speed up processing.
|
/// </summary>
|
private SmallList<float> _cellViewOffsetArray = new SmallList<float>();
|
|
/// <summary>
|
/// The scrollers position
|
/// </summary>
|
private float _scrollPosition;
|
|
/// <summary>
|
/// The list of cell views that are currently being displayed
|
/// </summary>
|
private SmallList<EnhancedScrollerCellView> _activeCellViews = new SmallList<EnhancedScrollerCellView>();
|
|
/// <summary>
|
/// The index of the first cell view that is being displayed
|
/// </summary>
|
private int _activeCellViewsStartIndex;
|
|
/// <summary>
|
/// The index of the last cell view that is being displayed
|
/// </summary>
|
private int _activeCellViewsEndIndex;
|
|
/// <summary>
|
/// The index of the first element of the middle section of cell view sizes.
|
/// Used only when looping
|
/// </summary>
|
private int _loopFirstCellIndex;
|
|
/// <summary>
|
/// The index of the last element of the middle seciton of cell view sizes.
|
/// used only when looping
|
/// </summary>
|
private int _loopLastCellIndex;
|
|
/// <summary>
|
/// The scroll position of the first element of the middle seciotn of cell views.
|
/// Used only when looping
|
/// </summary>
|
private float _loopFirstScrollPosition;
|
|
/// <summary>
|
/// The scroll position of the last element of the middle section of cell views.
|
/// Used only when looping
|
/// </summary>
|
private float _loopLastScrollPosition;
|
|
/// <summary>
|
/// The position that triggers the scroller to jump to the end of the middle section
|
/// of cell views. This keeps the scroller in the middle section as much as possible.
|
/// </summary>
|
private float _loopFirstJumpTrigger;
|
|
/// <summary>
|
/// The position that triggers the scroller to jump to the start of the middle section
|
/// of cell views. This keeps the scroller in the middle section as much as possible.
|
/// </summary>
|
private float _loopLastJumpTrigger;
|
|
/// <summary>
|
/// The cached value of the last scroll rect size. This is checked every frame to see
|
/// if the scroll rect has resized. If so, it will refresh.
|
/// </summary>
|
private float _lastScrollRectSize;
|
|
/// <summary>
|
/// The cached value of the last loop setting. This is checked every frame to see
|
/// if looping was toggled. If so, it will refresh.
|
/// </summary>
|
private bool _lastLoop;
|
|
/// <summary>
|
/// The cell view index we are snapping to
|
/// </summary>
|
private int _snapCellViewIndex;
|
|
/// <summary>
|
/// The data index we are snapping to
|
/// </summary>
|
private int _snapDataIndex;
|
|
/// <summary>
|
/// Whether we are currently jumping due to a snap
|
/// </summary>
|
private bool _snapJumping;
|
|
/// <summary>
|
/// What the previous inertia setting was before the snap jump.
|
/// We cache it here because we need to turn off inertia while
|
/// manually tweeing.
|
/// </summary>
|
private bool _snapInertia;
|
|
/// <summary>
|
/// The cached value of the last scrollbar visibility setting. This is checked every
|
/// frame to see if the scrollbar visibility needs to be changed.
|
/// </summary>
|
private ScrollbarVisibilityEnum _lastScrollbarVisibility;
|
|
/// <summary>
|
/// Where in the list we are
|
/// </summary>
|
private enum ListPositionEnum
|
{
|
First,
|
Last
|
}
|
|
/// <summary>
|
/// The size of the active cell view container minus the visibile portion
|
/// of the scroller
|
/// </summary>
|
public float _ScrollSize//这里并不是指scrllrect的大小，而是指真正在滑动的区域的大小
|
/*scrollrect的normallizePosition实际上就是这个真正能滑动的区域的大小
|
* 在滑动过程中归一化的值，而这个大小就是所有子物体的大小与可视化区域的差
|
* 当content的大小等于所有子物体的大小时，就可以简化操作直接用content的大小来代替
|
*/
|
{
|
get
|
{
|
if (scrollDirection == ScrollDirectionEnum.Vertical)
|
{
|
if (_container != null && _scrollRectTransform != null)
|
return _container.rect.height - _scrollRectTransform.rect.height;
|
else
|
return 0;
|
|
}
|
|
else
|
{
|
if (_container != null && _scrollRectTransform != null)
|
return _container.rect.width - _scrollRectTransform.rect.width;
|
else
|
return 0;
|
}
|
|
}
|
}
|
|
/// <summary>
|
/// This function will create an internal list of sizes and offsets to be used in all calculations.
|
/// It also sets up the loop triggers and positions and initializes the cell views.
|
/// </summary>
|
/// <param name="keepPosition">If true, then the scroller will try to go back to the position it was at before the resize</param>
|
private void _Resize(bool keepPosition)
|
{
|
// cache the original position
|
var originalScrollPosition = _scrollPosition;
|
|
// clear out the list of cell view sizes and create a new list
|
_cellViewSizeArray.Clear();
|
var offset = _AddCellViewSizes();//每次清空后重新添加一次，并返回这个集合的值的和
|
|
// if looping, we need to create three sets of size data
|
if (loop)
|
{
|
// if the cells don't entirely fill up the scroll area,
|
// make some more size entries to fill it up
|
if (offset < ScrollRectSize)//所有子物体相加没有这块可视区域大
|
{
|
int additionalRounds = Mathf.CeilToInt(ScrollRectSize / offset);
|
_DuplicateCellViewSizes(additionalRounds, _cellViewSizeArray.Count);//如果子物体的个数不足以填充可视区域，要进行复制
|
}
|
|
// set up the loop indices
|
_loopFirstCellIndex = _cellViewSizeArray.Count;
|
_loopLastCellIndex = _loopFirstCellIndex + _cellViewSizeArray.Count - 1;
|
//这里的两个值是在集合没有进行任何复制时赋值的，_loopFirstCellIndex是第二次循环的第一个元素索引，_loopLastCellIndex是第二次循环的最后一个索引
|
|
// create two more copies of the cell sizes
|
_DuplicateCellViewSizes(2, _cellViewSizeArray.Count);
|
/*当使用循环模式的时候，如果子物体不足以填充可视区就进行一次复制，使元素能够滑动
|
*当元素足够多，能够在可视区滑动的时候，再进行两次复制（最终结果是三个循环）
|
* firstCellIndex为第一个循环的第一个物体索引，比如10个元素，第一个循环的第一个索引就是10，因为是从（0~9）
|
* lastCellIndex为第一个循环的最后一个物体索引，比如10元素（0~9）+ 10 = 19
|
* 要注意： 上面说的复制在这里并没有复制游戏对象，只是对集合进行了一些扩充，这只是为了方便理解
|
*/
|
}
|
|
// calculate the offsets of each cell view
|
_CalculateCellViewOffsets();//计算了第一个元素下方相对原点的偏移（其中也包括了间距）
|
|
// set the size of the active cell view container based on the number of cell views there are and each of their sizes
|
if (scrollDirection == ScrollDirectionEnum.Vertical)
|
_container.sizeDelta = new Vector2(_container.sizeDelta.x, _cellViewOffsetArray.Last() + padding.top + padding.bottom);
|
else
|
_container.sizeDelta = new Vector2(_cellViewOffsetArray.Last() + padding.left + padding.right, _container.sizeDelta.y);
|
//设置content的大小，根据_cellViewOffsetArray的最后一个值就可以得到所有元素和它们的间距的总和，再加上padding的值就可以让content和所有子物体完美匹配
|
//且因为之前设置了pivot的原因，直接设置content的大小并不会让它往两边缩放，而是顺着我们需要的方向进行缩放
|
// if looping, set up the loop positions and triggers
|
if (loop)
|
{
|
_loopFirstScrollPosition = GetScrollPositionForCellViewIndex(_loopFirstCellIndex, CellViewPositionEnum.Before) + (spacing * 0.5f);
|
_loopLastScrollPosition = GetScrollPositionForCellViewIndex(_loopLastCellIndex, CellViewPositionEnum.After) - ScrollRectSize + (spacing * 0.5f);
|
|
|
_loopFirstJumpTrigger = _loopFirstScrollPosition - ScrollRectSize;
|
_loopLastJumpTrigger = _loopLastScrollPosition + ScrollRectSize;
|
//firstJumpTrigger是第一个循环的最后一个索引的下方 - 可视区大小，lastJumpTrigger是第二次循环的最后一个索引的下方
|
}
|
|
// create the visibile cells
|
_ResetVisibleCellViews();//根据可视区两端索引（通过_scrollPosition来计算索引)来重建可视区域内的子物体
|
if (this.Delegate != null)
|
{
|
this.Delegate.OnRebuildComplete();
|
}
|
// if we need to maintain our original position
|
if (keepPosition)//如果为true则保持调用这个方法时对应的位置
|
{
|
ScrollPosition = originalScrollPosition;
|
}
|
else
|
{
|
if (loop)
|
{
|
ScrollPosition = _loopFirstScrollPosition;//循环模式时定义的是第二次循环的起始点（相当于两边都存在一个循环，定位在中间那个循环的起始点）
|
}
|
else
|
{
|
ScrollPosition = 0;
|
}
|
}
|
|
// set up the visibility of the scrollbar
|
ScrollbarVisibility = scrollbarVisibility;
|
|
if (!m_IsLoadAll)
|
{
|
m_IsLoadAll = true;
|
if (OnFirstLoadAllEvent != null)
|
{
|
OnFirstLoadAllEvent();
|
}
|
}
|
}
|
|
/// <summary>
|
/// Creates a list of cell view sizes for faster access
|
/// </summary>
|
/// <returns></returns>
|
private float _AddCellViewSizes()//创建一个用于存放所有子物体的大小的集合，并返回所有子物体相加后的总尺寸
|
{
|
var offset = 0f;
|
// add a size for each row in our data based on how many the delegate tells us to create
|
for (var i = 0; i < NumberOfCells; i++)
|
{
|
// add the size of this cell based on what the delegate tells us to use. Also add spacing if this cell isn't the first one
|
_cellViewSizeArray.Add(_delegate.GetCellViewSize(this, i) + (i == 0 ? 0 : _layoutGroup.spacing));
|
offset += _cellViewSizeArray[_cellViewSizeArray.Count - 1];
|
}
|
|
return offset;
|
}
|
|
/// <summary>
|
/// Create a copy of the cell view sizes. This is only used in looping
|
/// </summary>
|
/// <param name="numberOfTimes">How many times the copy should be made</param>
|
/// <param name="cellCount">How many cells to copy</param>
|
private void _DuplicateCellViewSizes(int numberOfTimes, int cellCount)//当使用循环模式时，如果子物体不足以填充可视区域，就进行复制
|
{
|
for (var i = 0; i < numberOfTimes; i++) //注意此处的复制并不是复制游戏对象，而只是集合的扩充
|
{
|
for (var j = 0; j < cellCount; j++)
|
{
|
_cellViewSizeArray.Add(_cellViewSizeArray[j] + (j == 0 ? _layoutGroup.spacing : 0));//存储子物体size的集合也要跟着变
|
/*j == 0 ? _layoutGroup.spacing : 0 注意这个三元表达式，在进行复制时，如果是复制集合的第一个元素要多加一个spacing
|
* 因为滑动条中只有第一个元素前方或左方是没有spacing的，所以当复制n份时，就要增加n个spacing
|
*/
|
}
|
}
|
}
|
|
/// <summary>
|
/// Calculates the offset of each cell, accumulating the values from previous cells
|
/// </summary>
|
private void _CalculateCellViewOffsets()//此处的偏移集合存储的是当前索引下的物体下方相对原点的偏移量，也就是说最后一个元素的大小就是所有子物体大小加间距的总和
|
{
|
_cellViewOffsetArray.Clear();
|
var offset = 0f;
|
for (var i = 0; i < _cellViewSizeArray.Count; i++)
|
{
|
offset += _cellViewSizeArray[i];
|
_cellViewOffsetArray.Add(offset);
|
}
|
}
|
|
/// <summary>
|
/// Get a recycled cell with a given identifier if available
|
/// </summary>
|
/// <param name="cellPrefab">The prefab to check for</param>
|
/// <returns></returns>
|
private EnhancedScrollerCellView _GetRecycledCellView(EnhancedScrollerCellView cellPrefab)//从缓存池中取一个cellPrefab
|
{
|
for (var i = 0; i < _recycledCellViews.Count; i++)
|
{
|
if (_recycledCellViews[i].cellIdentifier == cellPrefab.cellIdentifier)
|
{
|
// the cell view was found, so we use this recycled one.
|
// we also remove it from the recycled list
|
var cellView = _recycledCellViews.RemoveAt(i);
|
return cellView;
|
}
|
}
|
|
return null;
|
}
|
|
/// <summary>
|
/// This sets up the visible cells, adding and recycling as necessary
|
/// </summary>
|
private void _ResetVisibleCellViews()//通过某个_scrollPosition来判断可视区两端能看到的索引，再通过这两个索引来重建可视区内的子物体，并更新相应的集合
|
{
|
int startIndex;
|
int endIndex;
|
|
// calculate the range of the visible cells
|
_CalculateCurrentActiveCellRange(out startIndex, out endIndex);//这个方法返回当前_scrollPosition对应的可视区两端能看到的子物体索引（并不一定要完全在可视区内）
|
// go through each previous active cell and recycle it if it no longer falls in the range
|
var i = 0;
|
SmallList<int> remainingCellIndices = new SmallList<int>();
|
while (i < _activeCellViews.Count)
|
{
|
if (_activeCellViews[i].cellIndex < startIndex || _activeCellViews[i].cellIndex > endIndex)
|
{
|
_RecycleCell(_activeCellViews[i]);//如果原本可见的元素不在可视区域内将其移动到_RecycleCell节点下
|
}
|
else
|
{
|
// this cell index falls in the new range, so we add its
|
// index to the reusable list
|
remainingCellIndices.Add(_activeCellViews[i].cellIndex);
|
//剩下的肯定是可见元素，放入remainingCellIndices集合中，这里要注意的是，这一集合并不一定能够填充整个可视区域，
|
//startIndex和endIndex内的部分索引可能并没有对应的可见子物体
|
i++;
|
}
|
}
|
|
if (remainingCellIndices.Count == 0)//在跳转至较远位置时，会导致原来可见元素全部都不可见了，又或者此组件刚进行初始化时，并没有任何可见元素
|
{
|
// there were no previous active cells remaining,
|
// this list is either brand new, or we jumped to
|
// an entirely different part of the list.
|
// just add all the new cell views
|
|
for (i = startIndex; i <= endIndex; i++)
|
{
|
_AddCellView(i, ListPositionEnum.Last);
|
/*正序添加，当remainingCellIndices集合没有元素时，直接按顺序添加就可以了，先添加的在前面，后添加的在后面
|
* 在当前_scrollPosition下能看到的就只有从startIndex到endIndex这几个元素，只需要实例化（从缓冲池取）这几个元素就行了*/
|
}
|
}
|
else
|
{
|
// we are able to reuse some of the previous
|
// cell views
|
|
// first add the views that come before the
|
// previous list, going backward so that the
|
// new views get added to the front
|
for (i = endIndex; i >= startIndex; i--)
|
{
|
if (i < remainingCellIndices.First())
|
{
|
_AddCellView(i, ListPositionEnum.First);//倒序添加，即当前添加的元素一定在第一个，完成循环后第一个被添加的元素就放到了最后一个
|
}
|
/*当remainingCellIndices集合中存在元素时，说明集合中的元素是可见的，但是不一定能够完全填充可视区，所以还需要根据情况来添加新的可见元素
|
* 如果此集合的最小元素索引大于startIndex和endIndex之内的某一索引，说明这一索引对应的子物体要进行实例化（从缓冲池取），且一定排在这个集合的第一个元素之前
|
* 这里要注意的是循环中i是递减的，当索引i比集合中最小的元素索引都要小时说明了i索引此时并没有可对应的可见子物体，实例化子物体时要
|
* 将它设置在最前面，以此类推，循环完成后，后添加的会比先添加的排在前面
|
*/
|
}
|
|
// next add teh views that come after the
|
// previous list, going forward and adding
|
// at the end of the list
|
for (i = startIndex; i <= endIndex; i++)
|
{
|
if (i > remainingCellIndices.Last())
|
{
|
_AddCellView(i, ListPositionEnum.Last);
|
}
|
/*当此集合最大的元素索引小于startIndex到endIndex中某一索引时，说明这一索引一样没有对应的可见子物体，
|
* 又因为此循环是递增的，所以先进行实例化（缓冲池取）的子物体一定是要比后添加的子物体排在前面
|
*/
|
}
|
}
|
|
// update the start and end indices
|
_activeCellViewsStartIndex = startIndex;
|
_activeCellViewsEndIndex = endIndex;
|
|
// adjust the padding elements to offset the cell views correctly
|
_SetPadders();//当可见区域被填充满后，就可以将其它区域设置为padding
|
}
|
|
/// <summary>
|
/// Recycles all the active cells
|
/// </summary>
|
private void _RecycleAllCells()//移除全部可见元素到缓冲池
|
{
|
while (_activeCellViews.Count > 0) _RecycleCell(_activeCellViews[0]);
|
_activeCellViewsStartIndex = 0;
|
_activeCellViewsEndIndex = 0;
|
}
|
|
/// <summary>
|
/// Recycles one cell view
|
/// </summary>
|
/// <param name="cellView"></param>
|
public void _RecycleCell(EnhancedScrollerCellView cellView)//从_activeCellVeiws集合中移除元素到_RecycleCell集合中
|
{
|
// remove the cell view from the active list
|
_activeCellViews.Remove(cellView);
|
|
// add the cell view to the recycled list
|
_recycledCellViews.Add(cellView);
|
|
// move the GameObject to the recycled container
|
cellView.transform.SetParent(_recycledCellViewContainer);
|
|
// reset the cellView's properties
|
cellView.dataIndex = 0;
|
cellView.cellIndex = 0;
|
cellView.active = false;
|
|
if (cellViewVisibilityChanged != null) cellViewVisibilityChanged(cellView);
|
}
|
|
/// <summary>
|
/// Creates a cell view, or recycles if it can
|
/// </summary>
|
/// <param name="cellIndex">The index of the cell view</param>
|
/// <param name="listPosition">Whether to add the cell to the beginning or the end</param>
|
private void _AddCellView(int cellIndex, ListPositionEnum listPosition)
|
{
|
//通过某个索引添加（从缓冲池中取）子物体到_activeCellViews集合中，并触发相关事件
|
//这个方法本身也会根据传过来的索引来初始化CellView
|
|
if (NumberOfCells == 0) return;
|
|
// get the dataIndex. Modulus is used in case of looping so that the first set of cells are ignored
|
var dataIndex = cellIndex % NumberOfCells;
|
// request a cell view from the delegate
|
var cellView = _delegate.GetCellView(this, dataIndex, cellIndex);
|
|
// set the cell's properties
|
cellView.cellIndex = cellIndex;
|
cellView.dataIndex = dataIndex;
|
cellView.active = true;
|
|
// add the cell view to the active container
|
cellView.transform.SetParent(_container, false);
|
cellView.transform.localScale = Vector3.one;
|
|
// add a layout element to the cellView
|
LayoutElement layoutElement = cellView.GetComponent<LayoutElement>();
|
if (layoutElement == null) layoutElement = cellView.gameObject.AddComponent<LayoutElement>();
|
|
// set the size of the layout element
|
if (scrollDirection == ScrollDirectionEnum.Vertical)
|
layoutElement.minHeight = _cellViewSizeArray[cellIndex] - (cellIndex > 0 ? _layoutGroup.spacing : 0);
|
else
|
layoutElement.minWidth = _cellViewSizeArray[cellIndex] - (cellIndex > 0 ? _layoutGroup.spacing : 0);
|
|
// add the cell to the active list
|
if (listPosition == ListPositionEnum.First)
|
_activeCellViews.AddStart(cellView);
|
else
|
_activeCellViews.Add(cellView);
|
|
// set the hierarchy position of the cell view in the container
|
if (listPosition == ListPositionEnum.Last)
|
cellView.transform.SetSiblingIndex(_container.childCount - 2);//这里的添加方式决定了两个padder的位置是夹着所有的cellView的
|
else if (listPosition == ListPositionEnum.First)
|
cellView.transform.SetSiblingIndex(1);
|
|
// call the visibility change delegate if available
|
if (cellViewVisibilityChanged != null) cellViewVisibilityChanged(cellView);
|
}
|
|
/// <summary>
|
/// This function adjusts the two padders that control the first cell view's
|
/// offset and the overall size of each cell.
|
/// </summary>
|
private void _SetPadders()//当处理完可见区域后，Padder就可以计算出来，padder的作用就是用来支撑整个scroll内的元素，保证它们的位置
|
{
|
if (NumberOfCells == 0) return;
|
|
// calculate the size of each padder
|
var firstSize = _cellViewOffsetArray[_activeCellViewsStartIndex] - _cellViewSizeArray[_activeCellViewsStartIndex];
|
var lastSize = _cellViewOffsetArray.Last() - _cellViewOffsetArray[_activeCellViewsEndIndex];
|
|
if (scrollDirection == ScrollDirectionEnum.Vertical)
|
{
|
// set the first padder and toggle its visibility
|
_firstPadder.minHeight = firstSize;
|
_firstPadder.SetActive(_firstPadder.minHeight > 0);
|
|
// set the last padder and toggle its visibility
|
_lastPadder.minHeight = lastSize;
|
_lastPadder.SetActive(_lastPadder.minHeight > 0);
|
}
|
else
|
{
|
// set the first padder and toggle its visibility
|
_firstPadder.minWidth = firstSize;
|
_firstPadder.SetActive(_firstPadder.minWidth > 0);
|
|
// set the last padder and toggle its visibility
|
_lastPadder.minWidth = lastSize;
|
_lastPadder.SetActive(_lastPadder.minWidth > 0);
|
}
|
}
|
|
/// <summary>
|
/// This function is called if the scroller is scrolled, updating the active list of cells
|
/// </summary>
|
private void _RefreshActive()
|
{
|
_refreshActive = false;
|
|
int startIndex;
|
int endIndex;
|
var velocity = Vector2.zero;
|
|
// if looping, check to see if we scrolled past a trigger
|
if (loop)
|
{
|
if (_scrollPosition < _loopFirstJumpTrigger)
|
{
|
velocity = scrollRect.velocity;
|
ScrollPosition = _loopLastScrollPosition - (_loopFirstJumpTrigger - _scrollPosition);
|
scrollRect.velocity = velocity;
|
}
|
else if (_scrollPosition > _loopLastJumpTrigger)
|
{
|
velocity = scrollRect.velocity;
|
ScrollPosition = _loopFirstScrollPosition + (_scrollPosition - _loopLastJumpTrigger);
|
scrollRect.velocity = velocity;
|
}
|
//循环模式下要将ScrollPosition限制在第二个循环内，这里的几个变量都是用于控制这一属性的
|
/*注意这里的ScrollPosition的赋值操作，只有当在循环模式下，且滑动的偏移已经达到了触发_loopJumpTrigger的时候
|
* 它才会发生赋值操作，当它被赋值以后，即此时的content的位置发生了改变，然后会再次调用此方法刷新可视区，直到再次触发loopJumpTirgger
|
* 之前，ScrollPosition都不会再次被赋值了
|
*/
|
}
|
|
// get the range of visibile cells
|
_CalculateCurrentActiveCellRange(out startIndex, out endIndex);
|
|
// if the index hasn't changed, ignore and return
|
if (startIndex == _activeCellViewsStartIndex && endIndex == _activeCellViewsEndIndex) return;
|
|
// recreate the visibile cells
|
_ResetVisibleCellViews();
|
|
if (this.Delegate != null)
|
{
|
this.Delegate.OnRebuildComplete();
|
}
|
}
|
|
/// <summary>
|
/// Determines which cells can be seen
|
/// </summary>
|
/// <param name="startIndex">The index of the first cell visible</param>
|
/// <param name="endIndex">The index of the last cell visible</param>
|
private void _CalculateCurrentActiveCellRange(out int startIndex, out int endIndex)//这个方法返回的是基于_scrollPosition得到的可视区域两端索引
|
{
|
startIndex = 0;
|
endIndex = 0;
|
|
// get the positions of the scroller
|
var startPosition = _scrollPosition;
|
var endPosition = _scrollPosition + (scrollDirection == ScrollDirectionEnum.Vertical ? _scrollRectTransform.rect.height : _scrollRectTransform.rect.width);
|
|
// calculate each index based on the positions
|
startIndex = GetCellViewIndexAtPosition(startPosition);
|
endIndex = GetCellViewIndexAtPosition(endPosition);
|
}
|
|
/// <summary>
|
/// Gets the index of a cell at a given position based on a subset range.
|
/// This function uses a recursive binary sort to find the index faster.
|
/// </summary>
|
/// <param name="position">The pixel offset from the start of the scroller</param>
|
/// <param name="startIndex">The first index of the range</param>
|
/// <param name="endIndex">The last index of the rnage</param>
|
/// <returns></returns>
|
private int _GetCellIndexAtPosition(float position, int startIndex, int endIndex)//这个方法的startIndex为0 ，endIndex为_cellViewOffsetArray的元素数量(但会根据计算的值进行调整）
|
{
|
// if the range is invalid, then we found our index, return the start index
|
if (startIndex >= endIndex) return startIndex;
|
// determine the middle point of our binary search
|
var middleIndex = (startIndex + endIndex) / 2;
|
// if the middle index is greater than the position, then search the last
|
// half of the binary tree, else search the first half
|
if ((_cellViewOffsetArray[middleIndex] + (scrollDirection == ScrollDirectionEnum.Vertical ? padding.top : padding.left)) >= position)
|
return _GetCellIndexAtPosition(position, startIndex, middleIndex);
|
else
|
return _GetCellIndexAtPosition(position, middleIndex + 1, endIndex);
|
}
|
|
/// <summary>
|
/// Caches and initializes the scroller
|
/// </summary>
|
void Awake()
|
{
|
GameObject go;
|
|
// cache some components
|
//_scrollRect = this.GetComponent<ScrollRect>();
|
_scrollRectTransform = scrollRect.GetComponent<RectTransform>();
|
|
// destroy any content objects if they exist. Likely there will be
|
// one at design time because Unity gives errors if it can't find one.
|
if (scrollRect.content != null)
|
{
|
DestroyImmediate(scrollRect.content.gameObject);//如果存在content则销毁
|
}
|
|
// Create a new active cell view container with a layout group
|
go = new GameObject("Container", typeof(RectTransform));
|
go.transform.SetParent(_scrollRectTransform);
|
if (scrollDirection == ScrollDirectionEnum.Vertical)
|
go.AddComponent<VerticalLayoutGroup>();
|
else
|
go.AddComponent<HorizontalLayoutGroup>();
|
_container = go.GetComponent<RectTransform>();
|
// set the containers anchor and pivot
|
if (scrollDirection == ScrollDirectionEnum.Vertical)
|
{
|
_container.anchorMin = new Vector2(0, 1);
|
_container.anchorMax = Vector2.one;
|
_container.pivot = new Vector2(0.5f, 1f);
|
//设置了content的锚点和轴心，主要作用是便于计算,以它上方中心的点到scroll上方的距离为它的y轴值，它的长度即为它的Height属性
|
//当设置它的高的时候就是设置了他的大小
|
}
|
else
|
{
|
_container.anchorMin = Vector2.zero;
|
_container.anchorMax = new Vector2(0, 1f);
|
_container.pivot = new Vector2(0, 0.5f);//同上
|
}
|
_container.offsetMax = Vector2.zero;
|
_container.offsetMin = Vector2.zero;
|
_container.localScale = Vector3.one;
|
Vector3 pos = _container.transform.localPosition;
|
pos.z = 0;
|
_container.transform.localPosition = pos;
|
//将它的位置固定在scrol上方或左方，通过这个位置和上面设置的锚点来保证设置大小的时候不会跑偏
|
scrollRect.content = _container;
|
|
// cache the scrollbar if it exists
|
if (scrollDirection == ScrollDirectionEnum.Vertical)
|
{
|
_scrollbar = scrollRect.verticalScrollbar;
|
}
|
else
|
{
|
_scrollbar = scrollRect.horizontalScrollbar;
|
}
|
|
// cache the layout group and set up its spacing and padding
|
_layoutGroup = _container.GetComponent<HorizontalOrVerticalLayoutGroup>();
|
_layoutGroup.spacing = spacing;
|
_layoutGroup.padding = padding;
|
_layoutGroup.childAlignment = TextAnchor.UpperLeft;//添加锚点
|
_layoutGroup.childForceExpandHeight = true;
|
_layoutGroup.childForceExpandWidth = true;
|
|
// force the scroller to scroll in the direction we want
|
//_scrollRect.horizontal = scrollDirection == ScrollDirectionEnum.Horizontal;
|
//_scrollRect.vertical = scrollDirection == ScrollDirectionEnum.Vertical;
|
|
// create the padder objects
|
|
go = new GameObject("First Padder", typeof(RectTransform), typeof(LayoutElement));
|
go.transform.SetParent(_container, false);
|
_firstPadder = go.GetComponent<LayoutElement>();
|
|
go = new GameObject("Last Padder", typeof(RectTransform), typeof(LayoutElement));
|
go.transform.SetParent(_container, false);
|
_lastPadder = go.GetComponent<LayoutElement>();
|
|
// create the recycled cell view container
|
go = new GameObject("Recycled Cells", typeof(RectTransform));
|
go.transform.SetParent(scrollRect.transform, false);
|
_recycledCellViewContainer = go.GetComponent<RectTransform>();
|
_recycledCellViewContainer.SetActive(false);
|
//实例化了两个padder和一个缓冲池
|
// set up the last values for updates
|
_lastScrollRectSize = ScrollRectSize;
|
_lastLoop = loop;
|
_lastScrollbarVisibility = scrollbarVisibility;
|
//一些变量进行了初始化
|
|
if(OnCompLoad!=null) OnCompLoad();
|
inited = true;
|
}
|
|
void Update()
|
{
|
if (_reloadData)//当外部脚本设置Delegate的时候就会将_reloadData置为true
|
{
|
// if the reload flag is true, then reload the data
|
ReloadData();//理论上不用在外部调用ReloadData()因为当成功赋值Delegate后这个方法就会执行一次
|
//但如果想在update之前执行就主动调用ReloadData()
|
}
|
|
// if the scroll rect size has changed and looping is on,
|
// or the loop setting has changed, then we need to resize
|
if (
|
(loop && _lastScrollRectSize != ScrollRectSize)//当Scroll的大小发生改变并且开启循环时
|
||
|
(loop != _lastLoop)//当循环开关发生了改变
|
)
|
{
|
_Resize(true);
|
_lastScrollRectSize = ScrollRectSize;
|
|
_lastLoop = loop;
|
}
|
|
// update the scroll bar visibility if it has changed
|
if (_lastScrollbarVisibility != scrollbarVisibility)//如果滑动条的可见性发生改变也需要更新一下相关变量
|
{
|
ScrollbarVisibility = scrollbarVisibility;
|
_lastScrollbarVisibility = scrollbarVisibility;
|
}
|
|
// determine if the scroller has started or stopped scrolling
|
// and call the delegate if so.
|
if (LinearVelocity != 0 && !IsScrolling)//当Scroll.velocity不为0时说明在滑动，此时如果IsScrolling为false(标记为没有滑动)
|
{ //触发当滑动开始时的事件
|
IsScrolling = true;
|
if (scrollerScrollingChanged != null) scrollerScrollingChanged(this, true);
|
}
|
else if (LinearVelocity == 0 && IsScrolling)//同理触发当滑动结束时的事件，这里的两个事件都只会在一个滑动周期时各执行一次
|
{
|
IsScrolling = false;
|
if (scrollerScrollingChanged != null) scrollerScrollingChanged(this, false);
|
}
|
}
|
|
void LateUpdate()
|
{
|
if (_refreshActive)//当设置ScrollPosition时就会将_refreshActive置为true,此时就会调用_RefreshActive()方法
|
{
|
// if the refresh toggle is on, then
|
// refresh the list
|
_RefreshActive();
|
}
|
}
|
|
void OnEnable()
|
{
|
// when the scroller is enabled, add a listener to the onValueChanged handler
|
scrollRect.onValueChanged.AddListener(_ScrollRect_OnValueChanged);//当显示时注册
|
}
|
|
void OnDisable()
|
{
|
// when the scroller is disabled, remove the listener
|
scrollRect.onValueChanged.RemoveListener(_ScrollRect_OnValueChanged);//当隐藏时移除注册
|
}
|
|
/// <summary>
|
/// Handler for when the scroller changes value
|
/// </summary>
|
/// <param name="val">The scroll rect's value</param>
|
private void _ScrollRect_OnValueChanged(Vector2 val)
|
{
|
// set the internal scroll position
|
if (scrollDirection == ScrollDirectionEnum.Vertical)
|
{
|
_scrollPosition = (1f - val.y) * _ScrollSize;//注意这里只是给私有字段赋值，并不会调用相关属性的Set方法（如果调用了Set方法会导致无限循环，Set方法会触发valuechange，valuechange又触发Set)
|
}
|
else
|
{
|
_scrollPosition = val.x * _ScrollSize;
|
}
|
_refreshActive = true;//标记要进行刷新
|
|
// call the handler if it exists
|
if (scrollerScrolled != null) scrollerScrolled(this, val, _scrollPosition);//滑动过程中触发的相关事件
|
|
// if the snapping is turned on, handle it
|
if (snapping && !_snapJumping)//如果开启锁定位置，但此时没有定位
|
{
|
// if the speed has dropped below the threshhold velocity
|
if (Mathf.Abs(LinearVelocity) <= snapVelocityThreshold)
|
{
|
// Call the snap function
|
Snap();//进行定位
|
}
|
}
|
|
_RefreshActive();//刷新
|
/*在滑动的过程中，通过NormalizePosition来求得_scrollPosition
|
* 如果满足定位条件就进行定位
|
* 以上代码执行完成后就会去刷新整个Scroll
|
*/
|
|
}
|
|
/// <summary>
|
/// This is fired by the tweener when the snap tween is completed
|
/// </summary>
|
private void SnapJumpComplete()//当定位完成时
|
{
|
// reset the snap jump to false and restore the inertia state
|
_snapJumping = false;
|
scrollRect.inertia = _snapInertia;
|
|
// fire the scroller snapped delegate
|
if (scrollerSnapped != null) scrollerSnapped(this, _snapCellViewIndex, _snapDataIndex);
|
}
|
|
#endregion
|
|
#region Tweening
|
|
/// <summary>
|
/// The easing type
|
/// </summary>
|
public enum TweenType
|
{
|
immediate,
|
linear,
|
spring,
|
easeInQuad,
|
easeOutQuad,
|
easeInOutQuad,
|
easeInCubic,
|
easeOutCubic,
|
easeInOutCubic,
|
easeInQuart,
|
easeOutQuart,
|
easeInOutQuart,
|
easeInQuint,
|
easeOutQuint,
|
easeInOutQuint,
|
easeInSine,
|
easeOutSine,
|
easeInOutSine,
|
easeInExpo,
|
easeOutExpo,
|
easeInOutExpo,
|
easeInCirc,
|
easeOutCirc,
|
easeInOutCirc,
|
easeInBounce,
|
easeOutBounce,
|
easeInOutBounce,
|
easeInBack,
|
easeOutBack,
|
easeInOutBack,
|
easeInElastic,
|
easeOutElastic,
|
easeInOutElastic
|
}
|
|
private float _tweenTimeLeft;
|
public bool inited;
|
|
/// <summary>
|
/// Moves the scroll position over time between two points given an easing function. When the
|
/// tween is complete it will fire the jumpComplete delegate.
|
/// </summary>
|
/// <param name="tweenType">The type of easing to use</param>
|
/// <param name="time">The amount of time to interpolate</param>
|
/// <param name="start">The starting scroll position</param>
|
/// <param name="end">The ending scroll position</param>
|
/// <param name="jumpComplete">The action to fire when the tween is complete</param>
|
/// <returns></returns>
|
IEnumerator TweenPosition(TweenType tweenType, float time, float start, float end, Action tweenComplete)
|
{
|
if (tweenType == TweenType.immediate || time == 0)
|
{
|
// if the easing is immediate or the time is zero, just jump to the end position
|
ScrollPosition = end;
|
}
|
else
|
{
|
// zero out the velocity
|
scrollRect.velocity = Vector2.zero;
|
|
// fire the delegate for the tween start
|
IsTweening = true;
|
if (scrollerTweeningChanged != null) scrollerTweeningChanged(this, true);
|
|
_tweenTimeLeft = 0;
|
var newPosition = 0f;
|
|
// while the tween has time left, use an easing function
|
while (_tweenTimeLeft < time)
|
{
|
switch (tweenType)
|
{
|
case TweenType.linear: newPosition = linear(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.spring: newPosition = spring(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInQuad: newPosition = easeInQuad(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeOutQuad: newPosition = easeOutQuad(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInOutQuad: newPosition = easeInOutQuad(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInCubic: newPosition = easeInCubic(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeOutCubic: newPosition = easeOutCubic(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInOutCubic: newPosition = easeInOutCubic(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInQuart: newPosition = easeInQuart(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeOutQuart: newPosition = easeOutQuart(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInOutQuart: newPosition = easeInOutQuart(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInQuint: newPosition = easeInQuint(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeOutQuint: newPosition = easeOutQuint(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInOutQuint: newPosition = easeInOutQuint(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInSine: newPosition = easeInSine(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeOutSine: newPosition = easeOutSine(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInOutSine: newPosition = easeInOutSine(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInExpo: newPosition = easeInExpo(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeOutExpo: newPosition = easeOutExpo(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInOutExpo: newPosition = easeInOutExpo(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInCirc: newPosition = easeInCirc(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeOutCirc: newPosition = easeOutCirc(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInOutCirc: newPosition = easeInOutCirc(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInBounce: newPosition = easeInBounce(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeOutBounce: newPosition = easeOutBounce(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInOutBounce: newPosition = easeInOutBounce(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInBack: newPosition = easeInBack(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeOutBack: newPosition = easeOutBack(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInOutBack: newPosition = easeInOutBack(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInElastic: newPosition = easeInElastic(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeOutElastic: newPosition = easeOutElastic(start, end, (_tweenTimeLeft / time)); break;
|
case TweenType.easeInOutElastic: newPosition = easeInOutElastic(start, end, (_tweenTimeLeft / time)); break;
|
}
|
|
if (loop)
|
{
|
// if we are looping, we need to make sure the new position isn't past the jump trigger.
|
// if it is we need to reset back to the jump position on the other side of the area.
|
|
if (end > start && newPosition > _loopLastJumpTrigger)
|
{
|
//DesignDebug.Log("name: " + name + " went past the last jump trigger, looping back around");
|
newPosition = _loopFirstScrollPosition + (newPosition - _loopLastJumpTrigger);
|
}
|
else if (start > end && newPosition < _loopFirstJumpTrigger)
|
{
|
//DesignDebug.Log("name: " + name + " went past the first jump trigger, looping back around");
|
newPosition = _loopLastScrollPosition - (_loopFirstJumpTrigger - newPosition);
|
}
|
}
|
|
// set the scroll position to the tweened position
|
ScrollPosition = newPosition;
|
|
// increase the time elapsed
|
_tweenTimeLeft += Time.unscaledDeltaTime;
|
|
yield return null;
|
}
|
|
// the time has expired, so we make sure the final scroll position
|
// is the actual end position.
|
ScrollPosition = end;
|
}
|
|
// the tween jump is complete, so we fire the delegate
|
if (tweenComplete != null) tweenComplete();
|
|
// fire the delegate for the tween ending
|
IsTweening = false;
|
if (scrollerTweeningChanged != null) scrollerTweeningChanged(this, false);
|
}
|
|
private float linear(float start, float end, float val)
|
{
|
return Mathf.Lerp(start, end, val);
|
}
|
|
private static float spring(float start, float end, float val)
|
{
|
val = Mathf.Clamp01(val);
|
val = (Mathf.Sin(val * Mathf.PI * (0.2f + 2.5f * val * val * val)) * Mathf.Pow(1f - val, 2.2f) + val) * (1f + (1.2f * (1f - val)));
|
return start + (end - start) * val;
|
}
|
|
private static float easeInQuad(float start, float end, float val)
|
{
|
end -= start;
|
return end * val * val + start;
|
}
|
|
private static float easeOutQuad(float start, float end, float val)
|
{
|
end -= start;
|
return -end * val * (val - 2) + start;
|
}
|
|
private static float easeInOutQuad(float start, float end, float val)
|
{
|
val /= .5f;
|
end -= start;
|
if (val < 1) return end / 2 * val * val + start;
|
val--;
|
return -end / 2 * (val * (val - 2) - 1) + start;
|
}
|
|
private static float easeInCubic(float start, float end, float val)
|
{
|
end -= start;
|
return end * val * val * val + start;
|
}
|
|
private static float easeOutCubic(float start, float end, float val)
|
{
|
val--;
|
end -= start;
|
return end * (val * val * val + 1) + start;
|
}
|
|
private static float easeInOutCubic(float start, float end, float val)
|
{
|
val /= .5f;
|
end -= start;
|
if (val < 1) return end / 2 * val * val * val + start;
|
val -= 2;
|
return end / 2 * (val * val * val + 2) + start;
|
}
|
|
private static float easeInQuart(float start, float end, float val)
|
{
|
end -= start;
|
return end * val * val * val * val + start;
|
}
|
|
private static float easeOutQuart(float start, float end, float val)
|
{
|
val--;
|
end -= start;
|
return -end * (val * val * val * val - 1) + start;
|
}
|
|
private static float easeInOutQuart(float start, float end, float val)
|
{
|
val /= .5f;
|
end -= start;
|
if (val < 1) return end / 2 * val * val * val * val + start;
|
val -= 2;
|
return -end / 2 * (val * val * val * val - 2) + start;
|
}
|
|
private static float easeInQuint(float start, float end, float val)
|
{
|
end -= start;
|
return end * val * val * val * val * val + start;
|
}
|
|
private static float easeOutQuint(float start, float end, float val)
|
{
|
val--;
|
end -= start;
|
return end * (val * val * val * val * val + 1) + start;
|
}
|
|
private static float easeInOutQuint(float start, float end, float val)
|
{
|
val /= .5f;
|
end -= start;
|
if (val < 1) return end / 2 * val * val * val * val * val + start;
|
val -= 2;
|
return end / 2 * (val * val * val * val * val + 2) + start;
|
}
|
|
private static float easeInSine(float start, float end, float val)
|
{
|
end -= start;
|
return -end * Mathf.Cos(val / 1 * (Mathf.PI / 2)) + end + start;
|
}
|
|
private static float easeOutSine(float start, float end, float val)
|
{
|
end -= start;
|
return end * Mathf.Sin(val / 1 * (Mathf.PI / 2)) + start;
|
}
|
|
private static float easeInOutSine(float start, float end, float val)
|
{
|
end -= start;
|
return -end / 2 * (Mathf.Cos(Mathf.PI * val / 1) - 1) + start;
|
}
|
|
private static float easeInExpo(float start, float end, float val)
|
{
|
end -= start;
|
return end * Mathf.Pow(2, 10 * (val / 1 - 1)) + start;
|
}
|
|
private static float easeOutExpo(float start, float end, float val)
|
{
|
end -= start;
|
return end * (-Mathf.Pow(2, -10 * val / 1) + 1) + start;
|
}
|
|
private static float easeInOutExpo(float start, float end, float val)
|
{
|
val /= .5f;
|
end -= start;
|
if (val < 1) return end / 2 * Mathf.Pow(2, 10 * (val - 1)) + start;
|
val--;
|
return end / 2 * (-Mathf.Pow(2, -10 * val) + 2) + start;
|
}
|
|
private static float easeInCirc(float start, float end, float val)
|
{
|
end -= start;
|
return -end * (Mathf.Sqrt(1 - val * val) - 1) + start;
|
}
|
|
private static float easeOutCirc(float start, float end, float val)
|
{
|
val--;
|
end -= start;
|
return end * Mathf.Sqrt(1 - val * val) + start;
|
}
|
|
private static float easeInOutCirc(float start, float end, float val)
|
{
|
val /= .5f;
|
end -= start;
|
if (val < 1) return -end / 2 * (Mathf.Sqrt(1 - val * val) - 1) + start;
|
val -= 2;
|
return end / 2 * (Mathf.Sqrt(1 - val * val) + 1) + start;
|
}
|
|
private static float easeInBounce(float start, float end, float val)
|
{
|
end -= start;
|
float d = 1f;
|
return end - easeOutBounce(0, end, d - val) + start;
|
}
|
|
private static float easeOutBounce(float start, float end, float val)
|
{
|
val /= 1f;
|
end -= start;
|
if (val < (1 / 2.75f))
|
{
|
return end * (7.5625f * val * val) + start;
|
}
|
else if (val < (2 / 2.75f))
|
{
|
val -= (1.5f / 2.75f);
|
return end * (7.5625f * (val) * val + .75f) + start;
|
}
|
else if (val < (2.5 / 2.75))
|
{
|
val -= (2.25f / 2.75f);
|
return end * (7.5625f * (val) * val + .9375f) + start;
|
}
|
else
|
{
|
val -= (2.625f / 2.75f);
|
return end * (7.5625f * (val) * val + .984375f) + start;
|
}
|
}
|
|
private static float easeInOutBounce(float start, float end, float val)
|
{
|
end -= start;
|
float d = 1f;
|
if (val < d / 2) return easeInBounce(0, end, val * 2) * 0.5f + start;
|
else return easeOutBounce(0, end, val * 2 - d) * 0.5f + end * 0.5f + start;
|
}
|
|
private static float easeInBack(float start, float end, float val)
|
{
|
end -= start;
|
val /= 1;
|
float s = 1.70158f;
|
return end * (val) * val * ((s + 1) * val - s) + start;
|
}
|
|
private static float easeOutBack(float start, float end, float val)
|
{
|
float s = 1.70158f;
|
end -= start;
|
val = (val / 1) - 1;
|
return end * ((val) * val * ((s + 1) * val + s) + 1) + start;
|
}
|
|
private static float easeInOutBack(float start, float end, float val)
|
{
|
float s = 1.70158f;
|
end -= start;
|
val /= .5f;
|
if ((val) < 1)
|
{
|
s *= (1.525f);
|
return end / 2 * (val * val * (((s) + 1) * val - s)) + start;
|
}
|
val -= 2;
|
s *= (1.525f);
|
return end / 2 * ((val) * val * (((s) + 1) * val + s) + 2) + start;
|
}
|
|
private static float easeInElastic(float start, float end, float val)
|
{
|
end -= start;
|
|
float d = 1f;
|
float p = d * .3f;
|
float s = 0;
|
float a = 0;
|
|
if (val == 0) return start;
|
val = val / d;
|
if (val == 1) return start + end;
|
|
if (a == 0f || a < Mathf.Abs(end))
|
{
|
a = end;
|
s = p / 4;
|
}
|
else
|
{
|
s = p / (2 * Mathf.PI) * Mathf.Asin(end / a);
|
}
|
val = val - 1;
|
return -(a * Mathf.Pow(2, 10 * val) * Mathf.Sin((val * d - s) * (2 * Mathf.PI) / p)) + start;
|
}
|
|
private static float easeOutElastic(float start, float end, float val)
|
{
|
end -= start;
|
|
float d = 1f;
|
float p = d * .3f;
|
float s = 0;
|
float a = 0;
|
|
if (val == 0) return start;
|
|
val = val / d;
|
if (val == 1) return start + end;
|
|
if (a == 0f || a < Mathf.Abs(end))
|
{
|
a = end;
|
s = p / 4;
|
}
|
else
|
{
|
s = p / (2 * Mathf.PI) * Mathf.Asin(end / a);
|
}
|
|
return (a * Mathf.Pow(2, -10 * val) * Mathf.Sin((val * d - s) * (2 * Mathf.PI) / p) + end + start);
|
}
|
|
private static float easeInOutElastic(float start, float end, float val)
|
{
|
end -= start;
|
|
float d = 1f;
|
float p = d * .3f;
|
float s = 0;
|
float a = 0;
|
|
if (val == 0) return start;
|
|
val = val / (d / 2);
|
if (val == 2) return start + end;
|
|
if (a == 0f || a < Mathf.Abs(end))
|
{
|
a = end;
|
s = p / 4;
|
}
|
else
|
{
|
s = p / (2 * Mathf.PI) * Mathf.Asin(end / a);
|
}
|
|
if (val < 1)
|
{
|
val = val - 1;
|
return -0.5f * (a * Mathf.Pow(2, 10 * val) * Mathf.Sin((val * d - s) * (2 * Mathf.PI) / p)) + start;
|
}
|
val = val - 1;
|
return a * Mathf.Pow(2, -10 * val) * Mathf.Sin((val * d - s) * (2 * Mathf.PI) / p) * 0.5f + end + start;
|
}
|
|
#endregion
|
}
|
}
|
