2015-02-03 03:25:41 +08:00
/// Credit BinaryX
/// Sourced from - http://forum.unity3d.com/threads/scripts-useful-4-6-scripts-collection.264161/page-2#post-1945602
/// Updated by ddreaper - removed dependency on a custom ScrollRect script. Now implements drag interfaces and standard Scroll Rect.
using UnityEngine.EventSystems ;
2015-02-03 07:07:31 +08:00
namespace UnityEngine.UI.Extensions
2015-02-03 03:25:41 +08:00
{
2016-05-24 03:57:56 +08:00
2015-02-03 07:07:31 +08:00
[RequireComponent(typeof(ScrollRect))]
2015-09-20 07:24:17 +08:00
[AddComponentMenu("Layout/Extensions/Horizontal Scroll Snap")]
2016-12-05 18:15:48 +08:00
public class HorizontalScrollSnap : ScrollSnapBase , IEndDragHandler
2015-02-03 07:07:31 +08:00
{
2016-12-19 06:51:16 +08:00
void Start ( )
2015-02-03 07:07:31 +08:00
{
2016-12-31 23:14:39 +08:00
_isVertical = false ;
_childAnchorPoint = new Vector2 ( 0 , 0.5f ) ;
2016-12-30 06:03:04 +08:00
_currentPage = StartingScreen ;
2017-07-27 13:44:18 +08:00
panelDimensions = gameObject . GetComponent < RectTransform > ( ) . rect ;
2017-01-01 01:01:49 +08:00
UpdateLayout ( ) ;
2015-02-03 07:07:31 +08:00
}
2015-02-03 03:25:41 +08:00
2015-02-03 07:07:31 +08:00
void Update ( )
2015-02-03 03:25:41 +08:00
{
2016-12-05 04:06:03 +08:00
if ( ! _lerp & & _scroll_rect . velocity = = Vector2 . zero )
{
2016-12-31 23:14:39 +08:00
if ( ! _settled & & ! _pointerDown )
{
if ( ! IsRectSettledOnaPage ( _screensContainer . localPosition ) )
{
ScrollToClosestElement ( ) ;
}
}
2016-12-05 04:06:03 +08:00
return ;
}
else if ( _lerp )
2015-02-03 03:25:41 +08:00
{
2016-05-17 20:26:50 +08:00
_screensContainer . localPosition = Vector3 . Lerp ( _screensContainer . localPosition , _lerp_target , transitionSpeed * Time . deltaTime ) ;
2016-11-16 07:48:44 +08:00
if ( Vector3 . Distance ( _screensContainer . localPosition , _lerp_target ) < 0.1f )
2015-02-03 07:07:31 +08:00
{
2017-03-12 23:18:36 +08:00
_screensContainer . localPosition = _lerp_target ;
2015-02-03 07:07:31 +08:00
_lerp = false ;
2016-11-16 02:09:13 +08:00
EndScreenChange ( ) ;
2015-02-03 07:07:31 +08:00
}
2016-12-05 04:06:03 +08:00
}
2016-12-22 00:52:19 +08:00
CurrentPage = GetPageforPosition ( _screensContainer . localPosition ) ;
2017-01-04 21:18:28 +08:00
2016-12-22 00:52:19 +08:00
//If the container is moving check if it needs to settle on a page
2017-01-04 21:18:28 +08:00
if ( ! _pointerDown )
2015-02-03 03:25:41 +08:00
{
2017-01-04 21:18:28 +08:00
if ( _scroll_rect . velocity . x > 0.01 | | _scroll_rect . velocity . x < 0.01 )
2016-12-22 00:52:19 +08:00
{
2017-01-04 21:18:28 +08:00
//if the pointer is released and is moving slower than the threshold, then just land on a page
if ( IsRectMovingSlowerThanThreshold ( 0 ) )
{
ScrollToClosestElement ( ) ;
}
2016-12-22 00:52:19 +08:00
}
2015-02-03 03:25:41 +08:00
}
}
2017-01-04 21:18:28 +08:00
private bool IsRectMovingSlowerThanThreshold ( float startingSpeed )
2016-12-31 23:14:39 +08:00
{
return ( _scroll_rect . velocity . x > startingSpeed & & _scroll_rect . velocity . x < SwipeVelocityThreshold ) | |
( _scroll_rect . velocity . x < startingSpeed & & _scroll_rect . velocity . x > - SwipeVelocityThreshold ) ;
}
2015-02-03 07:07:31 +08:00
private void DistributePages ( )
2015-02-03 03:25:41 +08:00
{
2016-12-10 21:36:28 +08:00
_screens = _screensContainer . childCount ;
2016-12-30 06:03:04 +08:00
_scroll_rect . horizontalNormalizedPosition = 0 ;
2016-12-10 21:36:28 +08:00
2015-02-03 07:07:31 +08:00
int _offset = 0 ;
2016-11-15 22:52:34 +08:00
float _dimension = 0 ;
float currentXPosition = 0 ;
2016-12-10 21:36:28 +08:00
var pageStepValue = _childSize = ( int ) panelDimensions . width * ( ( PageStep = = 0 ) ? 3 : PageStep ) ;
2016-11-16 02:09:13 +08:00
2015-02-03 07:07:31 +08:00
for ( int i = 0 ; i < _screensContainer . transform . childCount ; i + + )
{
RectTransform child = _screensContainer . transform . GetChild ( i ) . gameObject . GetComponent < RectTransform > ( ) ;
2016-11-15 22:52:34 +08:00
currentXPosition = _offset + ( int ) ( i * pageStepValue ) ;
2016-09-03 05:38:06 +08:00
child . sizeDelta = new Vector2 ( panelDimensions . width , panelDimensions . height ) ;
2015-02-03 07:07:31 +08:00
child . anchoredPosition = new Vector2 ( currentXPosition , 0f ) ;
2016-12-31 23:14:39 +08:00
child . anchorMin = child . anchorMax = child . pivot = _childAnchorPoint ;
2015-02-03 07:07:31 +08:00
}
_dimension = currentXPosition + _offset * - 1 ;
2017-07-02 21:22:10 +08:00
_screensContainer . offsetMax = new Vector2 ( _dimension , 0f ) ;
2016-11-16 07:48:44 +08:00
}
2016-05-24 03:57:56 +08:00
2016-12-10 21:36:28 +08:00
/// <summary>
2016-05-24 03:57:56 +08:00
/// Add a new child to this Scroll Snap and recalculate it's children
/// </summary>
/// <param name="GO">GameObject to add to the ScrollSnap</param>
public void AddChild ( GameObject GO )
2017-01-04 20:16:11 +08:00
{
AddChild ( GO , false ) ;
}
/// <summary>
/// Add a new child to this Scroll Snap and recalculate it's children
/// </summary>
/// <param name="GO">GameObject to add to the ScrollSnap</param>
/// <param name="WorldPositionStays">Should the world position be updated to it's parent transform?</param>
public void AddChild ( GameObject GO , bool WorldPositionStays )
2016-05-24 03:57:56 +08:00
{
_scroll_rect . horizontalNormalizedPosition = 0 ;
2017-01-04 20:16:11 +08:00
GO . transform . SetParent ( _screensContainer , WorldPositionStays ) ;
2017-08-07 18:53:57 +08:00
InitialiseChildObjectsFromScene ( ) ;
2016-05-24 03:57:56 +08:00
DistributePages ( ) ;
2016-12-22 01:51:38 +08:00
if ( MaskArea ) UpdateVisible ( ) ;
2016-05-24 03:57:56 +08:00
2016-12-22 01:51:38 +08:00
SetScrollContainerPosition ( ) ;
2016-05-24 03:57:56 +08:00
}
/// <summary>
/// Remove a new child to this Scroll Snap and recalculate it's children
/// *Note, this is an index address (0-x)
/// </summary>
2017-07-02 21:33:57 +08:00
/// <param name="index">Index element of child to remove</param>
/// <param name="ChildRemoved">Resulting removed GO</param>
2016-05-24 03:57:56 +08:00
public void RemoveChild ( int index , out GameObject ChildRemoved )
2017-07-02 21:33:57 +08:00
{
RemoveChild ( index , false , out ChildRemoved ) ;
}
/// <summary>
/// Remove a new child to this Scroll Snap and recalculate it's children
/// *Note, this is an index address (0-x)
/// </summary>
/// <param name="index">Index element of child to remove</param>
/// <param name="WorldPositionStays">If true, the parent-relative position, scale and rotation are modified such that the object keeps the same world space position, rotation and scale as before</param>
/// <param name="ChildRemoved">Resulting removed GO</param>
public void RemoveChild ( int index , bool WorldPositionStays , out GameObject ChildRemoved )
2016-05-24 03:57:56 +08:00
{
ChildRemoved = null ;
if ( index < 0 | | index > _screensContainer . childCount )
{
return ;
}
_scroll_rect . horizontalNormalizedPosition = 0 ;
2016-12-22 01:51:38 +08:00
Transform child = _screensContainer . transform . GetChild ( index ) ;
2017-07-02 21:33:57 +08:00
child . SetParent ( null , WorldPositionStays ) ;
2016-12-22 01:51:38 +08:00
ChildRemoved = child . gameObject ;
2016-12-05 18:15:48 +08:00
2016-05-24 03:57:56 +08:00
DistributePages ( ) ;
2016-12-22 01:51:38 +08:00
if ( MaskArea ) UpdateVisible ( ) ;
2016-12-05 18:15:48 +08:00
2016-12-22 00:52:19 +08:00
if ( _currentPage > _screens - 1 )
2016-05-24 03:57:56 +08:00
{
2016-12-19 06:51:16 +08:00
CurrentPage = _screens - 1 ;
2016-05-24 03:57:56 +08:00
}
2016-12-22 01:51:38 +08:00
SetScrollContainerPosition ( ) ;
}
2017-01-04 20:16:11 +08:00
/// <summary>
/// Remove all children from this ScrollSnap
/// </summary>
2017-07-02 21:33:57 +08:00
/// <param name="ChildrenRemoved">Array of child GO's removed</param>
2017-01-04 20:16:11 +08:00
public void RemoveAllChildren ( out GameObject [ ] ChildrenRemoved )
2017-07-02 21:33:57 +08:00
{
RemoveAllChildren ( false , out ChildrenRemoved ) ;
}
/// <summary>
/// Remove all children from this ScrollSnap
/// </summary>
/// <param name="WorldPositionStays">If true, the parent-relative position, scale and rotation are modified such that the object keeps the same world space position, rotation and scale as before</param>
/// <param name="ChildrenRemoved">Array of child GO's removed</param>
public void RemoveAllChildren ( bool WorldPositionStays , out GameObject [ ] ChildrenRemoved )
2017-01-04 20:16:11 +08:00
{
var _screenCount = _screensContainer . childCount ;
ChildrenRemoved = new GameObject [ _screenCount ] ;
for ( int i = _screenCount - 1 ; i > = 0 ; i - - )
{
ChildrenRemoved [ i ] = _screensContainer . GetChild ( i ) . gameObject ;
2017-07-02 21:33:57 +08:00
ChildrenRemoved [ i ] . transform . SetParent ( null , WorldPositionStays ) ;
2017-01-04 20:16:11 +08:00
}
_scroll_rect . horizontalNormalizedPosition = 0 ;
CurrentPage = 0 ;
InitialiseChildObjectsFromScene ( ) ;
DistributePages ( ) ;
if ( MaskArea ) UpdateVisible ( ) ;
}
2016-12-22 01:51:38 +08:00
private void SetScrollContainerPosition ( )
{
_scrollStartPosition = _screensContainer . localPosition . x ;
2016-12-22 00:52:19 +08:00
_scroll_rect . horizontalNormalizedPosition = ( float ) ( _currentPage ) / ( _screens - 1 ) ;
2017-08-02 17:21:45 +08:00
OnCurrentScreenChange ( _currentPage ) ;
2016-05-24 03:57:56 +08:00
}
2016-12-30 06:03:04 +08:00
/// <summary>
/// used for changing / updating between screen resolutions
/// </summary>
public void UpdateLayout ( )
{
_lerp = false ;
DistributePages ( ) ;
2016-12-31 23:14:39 +08:00
if ( MaskArea ) UpdateVisible ( ) ;
2016-12-30 06:03:04 +08:00
SetScrollContainerPosition ( ) ;
2017-02-07 18:55:38 +08:00
OnCurrentScreenChange ( _currentPage ) ;
2016-12-30 06:03:04 +08:00
}
2016-12-31 23:14:39 +08:00
private void OnRectTransformDimensionsChange ( )
{
if ( _childAnchorPoint ! = Vector2 . zero )
{
UpdateLayout ( ) ;
}
}
2017-03-12 23:18:36 +08:00
private void OnEnable ( )
{
2017-03-12 23:29:59 +08:00
InitialiseChildObjectsFromScene ( ) ;
2017-03-12 23:18:36 +08:00
DistributePages ( ) ;
if ( MaskArea ) UpdateVisible ( ) ;
2017-03-12 23:29:59 +08:00
if ( JumpOnEnable | | ! RestartOnEnable ) SetScrollContainerPosition ( ) ;
if ( RestartOnEnable ) GoToScreen ( StartingScreen ) ;
2017-03-12 23:18:36 +08:00
}
2015-02-03 07:07:31 +08:00
#region Interfaces
2016-12-05 04:06:03 +08:00
/// <summary>
/// Release screen to swipe
/// </summary>
/// <param name="eventData"></param>
2015-02-03 07:07:31 +08:00
public void OnEndDrag ( PointerEventData eventData )
2015-02-03 03:25:41 +08:00
{
2017-01-04 21:18:28 +08:00
_pointerDown = false ;
2015-02-03 07:07:31 +08:00
if ( _scroll_rect . horizontal )
2015-02-03 03:25:41 +08:00
{
2017-07-02 21:22:10 +08:00
var distance = Vector3 . Distance ( _startPosition , _screensContainer . localPosition ) ;
2017-08-02 17:57:02 +08:00
if ( UseFastSwipe & & distance < panelDimensions . width & & distance > = FastSwipeThreshold )
2015-02-03 03:25:41 +08:00
{
2017-07-02 21:22:10 +08:00
_scroll_rect . velocity = Vector3 . zero ;
if ( _startPosition . x - _screensContainer . localPosition . x > 0 )
2015-02-03 03:25:41 +08:00
{
2017-07-02 21:22:10 +08:00
NextScreen ( ) ;
2015-02-03 03:25:41 +08:00
}
else
{
2017-07-02 21:22:10 +08:00
PreviousScreen ( ) ;
2015-02-03 03:25:41 +08:00
}
}
}
}
2017-08-02 17:59:27 +08:00
# endregion
2015-02-03 03:25:41 +08:00
}
}