README

This is an extension project for the new Unity UI system which can be found at: Unity UI Source ###For Unity 5.2.2+ - Use the new 5.3 package!### ###*Note, due to limited demand, this is the last release we will update the 4.x/5.1/5.2 asset package, we'll be focusing on 5.3/5.4 from now on.###

---

#Supporting the UI Extensions project# If you wish to support the Unity UI Extensions project itself, then you can using the PayPal link below.

(paypal account not required and you can remain anonymous if you wish)

##>> Donate <<##

---

#Intro# For more info, here's a little introduction video for the project:

You can follow the UI Extentions team for updates and news on:

Twitter / Facebook / YouTube###

---

# What is this repository for? #

In this repository is a collection of extension scripts to enhance your Unity UI experience. These scripts have been gathered from many sources and combined and improved over time.

The majority of the scripts came from the Scripts thread on the Unity UI forum here

You can either download / fork this project to access the scripts, or you can also download these precompiled Unity Assets, chock full of goodness for each release:

#Downloads#

• Unity UI Extensions Unity 4.x Asset

• Unity UI Extensions Unity 5.1 Asset

• Unity UI Extensions Unity 5.2 Asset <- 5.2.0 - 5.2.1 base releases ONLY

• Unity UI Extensions Unity 5.3 (5.2.1P+) Asset <- use this for 5.2.1P+ releases

Note To retain 5.2 compatibility in the 5.3 package, you will see two warnings related to:

`UnityEngine.UI.InputField.onValueChange' is obsolete.  

This has no effect on the package working in 5.4 plus and is only there to maintain backwards compatibility. We will look to update/remove this in a future release, likely after 5.4. If you have any concerns, feel free to update your code in your project to add the missing "d". Unity have ensured it still works as they have mapped the API change for now.

---

#Getting Started# To get started with the project, here's a little guide:

---

#Updates:#

##Update 1.1##

###New / updated features###

• New Polygon primitive
• New UI Vertical Scroller control
• New Curved layout component
• New Shining effect
• New UI Particle system
• New Scroll Conflict Manager
• Soft Alpha Mask updated in line with SAUI 1.3 release
• Line Renderer has had a complete overhaul, including full programmatic support, Line list and Bezier line rendering
• Horizontal and Vertical Scroll Snaps updated to include a Starting page, current page and transition speed parameters. Plus a new GoToPage, Add and Remove page functions
• Added some script helper functions for LZF compression and Serialization
• Two utilities to help manage drag thresholds on high PPI systems

###Fixes###

• Line Render almost completely re-written with tons of fixes
• Radial layout updated to avoid 360 overlap (first and last)
• Scroll Snaps updates to better handle children.
• Scroll Snaps distribute function updated so it can be called onDirty more efficiently.

##Upgrade Notes## A few scripts from earlier releases were moved and need their originals need deleting post upgrade. Please remove the following files if found:

• Scripts\ImageExtended.cs
• Scripts\UIScrollToSelection.cs
• Scripts\UIScrollToSelectionXY.cs
• Scripts\UISelectableExtension.cs
• Scripts\Effects\UIImageCrop.cs

---

##Release History##

For the full release history, follow the below link to the full release notes page.

Release Notes###

---

#Controls and extensions listed in this project:# There are almost 70 extension controls / effect and other utilities in the project which are listed on the following page:

##UI Extensions controls list##

Controls
Accordion	HSVPicker	SelectionBox	UIButton
ComboBox	AutoCompleteComboBox	DropDownList	BoundToolTip
UI_Knob	TextPic	InputFocus	ImageExtended

Primitives
UILineRenderer	UILineTextureRenderer	UICircle	DiamondGraph
UIPolygon

Layouts
HorizontalScrollSnap	VerticalScrollSnap	FlowLayoutGroup	RadialLayout
ScrollSnap	ReorderableList	UIVerticalScroller	CurvedLayout

Effects
BestFitOutline	CurvedText	Gradient	LetterSpacing
RaycastMask	UIFlippable	UIImageCrop	SoftAlphaMask
UIParticleSystem

VR Components
VRCursor	VRInputModule

Input Modules
AimerInputModule	GamePadInputModule

Additional Components
ReturnKeyTrigger	TabNavigation	uGUITools	ScrollRectTweener
ScrollRectEx	UI_InfiniteScroll	UI_ScrollRectOcclusion	UIScrollToSelection
switchToRectTransform	ScrollConflictManager	CLFZ2 (Encryption)	Serialization
PPIViewer	UI_TweenScale

More to come

---

# How do I get set up? # Either clone / download this repository to your machine and then copy the scripts in, or use the pre-packaged .UnityPackage for your version of Unity and import it as a custom package in to your project.

# Contribution guidelines # Got a script you want added? Then just fork the bitbucket repository and submit a PR. All contributions accepted (including fixes) Just ensure

• The header of the script matches the standard used in all scripts
• The script uses the Unity.UI.Extensions namespace so they do not affect any other developments
• (optional) Add Component and Editor options where possible (editor options are in the Editor\UIExtensionsMenuOptions.cs file)

# License # All scripts conform to the BSD license and are free to use / distribute. See the LICENSE file for more information

# Like what you see? # All these scripts were put together for my latest book Unity3D UI Essentials Check out the page on my blog for more details and learn all about the inner workings of the new Unity UI System.

# The downloads # As this repo was created to support my new Unity UI Title "Unity 3D UI Essentials", in the downloads section you will find two custom assets (SpaceShip-DemoScene-Start.unitypackage and RollABallSample-Start.unitypackage). These are just here as starter scenes for doing UI tasks in the book.

I will add more sample scenes for the UI examples in this repository and detail them above over time.