Simon Jackson
commit
b2ae5db354
118
README.md
118
README.md
|
|
@ -1,106 +1,109 @@
|
|||
# README #
|
||||
|
||||
This is an extension project for the new Unity UI system which can be found at: [Unity UI Source](https://bitbucket.org/Unity-Technologies/ui)
|
||||
###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](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=89L8T9N6BR7LJ)#
|
||||
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)
|
||||
#[Supporting the UI Extensions project](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=89L8T9N6BR7LJ)#
|
||||
|
||||
If you wish to support the Unity UI Extensions project itself, then you can using the PayPal link below.
|
||||
All funds go to support the project, no matter the amount.
|
||||
|
||||
> Donations in code are also extremely welcome :D
|
||||
|
||||
(PayPal account not required and you can remain anonymous if you wish)
|
||||
|
||||
##[>> Donate <<](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=89L8T9N6BR7LJ)##
|
||||
|
||||
-----
|
||||
|
||||
#[Intro](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/GettingStarted)#
|
||||
For more info, here's a little introduction video for the project:
|
||||
|
||||
[](http://www.youtube.com/watch?v=njoIeE4akq0 "Unity UI Extensions intro video")
|
||||
|
||||
You can follow the UI Extentions team for updates and news on:
|
||||
You can follow the UI Extensions team for updates and news on:
|
||||
### [Twitter](https://twitter.com/search?q=%23uiextensions) / [Facebook](https://www.facebook.com/UnityUIExtensions/) / [YouTube](https://www.youtube.com/channel/UCG3gZOkmL-2rmZat4ufv28Q)###
|
||||
|
||||
-----
|
||||
|
||||
#[ What is this repository for? ](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/About)#
|
||||
|
||||
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](http://bit.ly/UnityUIScriptsForumPost)
|
||||
|
||||
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:
|
||||
You can either download / fork this project to access the scripts, or you can also download these pre-compiled Unity Assets, chock full of goodness for each release:
|
||||
|
||||
#[Downloads](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/Downloads)#
|
||||
* [Unity UI Extensions Unity 4.x Asset](https://bitbucket.org/ddreaper/unity-ui-extensions/downloads/UnityUIExtensions-4.x.unitypackage)
|
||||
#[Download](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/Downloads)#
|
||||
The asset has been full tested on all current versions of Unity 5 (for versions prior to Unity 5.3, please see the [archive](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/Downloads))
|
||||
* [Unity UI Extensions Asset](https://bitbucket.org/ddreaper/unity-ui-extensions/downloads/UnityUIExtensions.unitypackage)
|
||||
|
||||
* [Unity UI Extensions Unity 5.1 Asset](https://bitbucket.org/ddreaper/unity-ui-extensions/downloads/UnityUIExtensions-5.1.unitypackage)
|
||||
|
||||
* [Unity UI Extensions Unity 5.2 Asset](https://bitbucket.org/ddreaper/unity-ui-extensions/downloads/UnityUIExtensions-5.2.unitypackage) <- 5.2.0 - 5.2.1 base releases ONLY
|
||||
|
||||
* [Unity UI Extensions Unity 5.3 (5.2.1P+) Asset](https://bitbucket.org/ddreaper/unity-ui-extensions/downloads/UnityUIExtensions-5.3.unitypackage) <- 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.
|
||||
To view previous releases, visit the [release archive](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/Downloads)
|
||||
|
||||
-----
|
||||
|
||||
#[Getting Started](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/GettingStarted)#
|
||||
To get started with the project, here's a little guide:
|
||||
|
||||
[](http://www.youtube.com/watch?v=sVLeYmsNQAI "Unity UI getting started video")
|
||||
|
||||
-----
|
||||
|
||||
#[Updates:](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/ReleaseNotes/RELEASENOTES)#
|
||||
|
||||
##Update 1.1##
|
||||
[](https://www.youtube.com/watch?v=JuE0ja5DmV4 "Update 1.1 for the Unity UI Extensions Project")
|
||||
##Update 1.2##
|
||||
|
||||
[](https://www.youtube.com/watch?v=tbc "Update 1.2 for the Unity UI Extensions Project")
|
||||
|
||||
###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
|
||||
* Major updates to the Horizontal and Vertical Scroll Snap controls
|
||||
* Replacement HSV/Color picker control (and new Box Slider control)
|
||||
* Fixes / updates to the TextPic control
|
||||
* Updates to SoftAlphaUI script - improved Text / world space support
|
||||
* New Gradient control (gradient 2)
|
||||
* New UI ScrollRect Occlusion utility
|
||||
* New UI Tween Scale utility
|
||||
* New UI Infinite ScrollRect
|
||||
* New Table Layout Group
|
||||
|
||||
###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.
|
||||
* H&S Scroll Snap indexing issues
|
||||
* H&S Scroll Snap performance updates
|
||||
* H&S Scroll Snap Long swipe behavior updated
|
||||
* TextPic Set set before draw issues
|
||||
* HSV picker replaced with more generic color picker
|
||||
|
||||
###Known issues###
|
||||
* The Image_Extended control has been removed due to Unity upgrade issues. Will return in a future update.
|
||||
|
||||
##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:
|
||||
Although not specifically required, it is recommended to remove the old UI Extensions folder before importing the new asset
|
||||
The HSS picker especially had a lot of file changes in this update.
|
||||
|
||||
>**Note** In Unity 5.5 the particle system was overhauled and several methods were marked for removal. However, the UI Particle System script currently still uses them
|
||||
> Either ignore these errors or remove the *_UIParticleSystem_* script in the "*Unity UI Extensions / Scripts / Effects*" folder
|
||||
|
||||
* 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](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/ReleaseNotes/RELEASENOTES)###
|
||||
|
||||
---
|
||||
#[Controls and extensions listed in this project](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/Controls):#
|
||||
|
||||
There are almost 70 extension controls / effect and other utilities in the project which are listed on the following page:
|
||||
|
||||
##[UI Extensions controls list](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/Controls)##
|
||||
|
||||
[Controls](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/Controls#Controls)|||||
|
||||
------|------|------|------|
|
||||
Accordion|HSVPicker|SelectionBox|UIButton|UIFlippable
|
||||
Accordion|ColorPicker|SelectionBox|UIButton|UIFlippable
|
||||
ComboBox|AutoCompleteComboBox|DropDownList|BoundToolTip|UIWindowBase
|
||||
UI_Knob|TextPic|InputFocus|ImageExtended|
|
||||
UI_Knob|TextPic|InputFocus|Box Slider
|
||||
||||
|
||||
|
||||
[Primitives](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/Controls#Primitives)|||||
|
||||
|
|
@ -117,9 +120,9 @@ ScrollSnap|ReorderableList|UIVerticalScroller|CurvedLayout|
|
|||
|
||||
[Effects](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/Controls#Effects)|||||
|
||||
------|------|------|------|
|
||||
BestFitOutline|CurvedText|Gradient|LetterSpacing|NicerOutline
|
||||
RaycastMask|UIFlippable|UIImageCrop|SoftAlphaMask|CylinderText
|
||||
UIParticleSystem||||
|
||||
BestFitOutline|CurvedText|Gradient|Gradient2|LetterSpacing|
|
||||
NicerOutline|RaycastMask|UIFlippable|UIImageCrop|SoftAlphaMask
|
||||
CylinderText|UIParticleSystem|||
|
||||
||||
|
||||
|
||||
[VR Components](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/Controls#VR)|||||
|
||||
|
|
@ -137,7 +140,7 @@ AimerInputModule|GamePadInputModule|||
|
|||
ReturnKeyTrigger|TabNavigation|uGUITools|ScrollRectTweener|ScrollRectLinker
|
||||
ScrollRectEx|UI_InfiniteScroll|UI_ScrollRectOcclusion|UIScrollToSelection|UISelectableExtension
|
||||
switchToRectTransform|ScrollConflictManager|CLFZ2 (Encryption)|Serialization|DragCorrector
|
||||
PPIViewer|UI_TweenScale|||
|
||||
PPIViewer|UI_TweenScale|UI_InfiniteScroll|UI_ScrollRectOcclusion|
|
||||
||||
|
||||
|
||||
*More to come*
|
||||
|
|
@ -165,4 +168,19 @@ Check out the [page on my blog](http://bit.ly/Unity3DUIEssentials) for more deta
|
|||
#[ The downloads ](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/Downloads)#
|
||||
As this repo was created to support my new Unity UI Title ["Unity 3D UI Essentials"](http://bit.ly/Unity3DUIEssentials), 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.
|
||||
I will add more sample scenes for the UI examples in this repository and detail them above over time.
|
||||
|
||||
#[Previous Releases](https://bitbucket.org/ddreaper/unity-ui-extensions/wiki/Downloads)#
|
||||
* [Unity UI Extensions Unity 4.x Asset](https://bitbucket.org/ddreaper/unity-ui-extensions/downloads/UnityUIExtensions-4.x.unitypackage)
|
||||
|
||||
* [Unity UI Extensions Unity 5.1 Asset](https://bitbucket.org/ddreaper/unity-ui-extensions/downloads/UnityUIExtensions-5.1.unitypackage)
|
||||
|
||||
* [Unity UI Extensions Unity 5.2 Asset](https://bitbucket.org/ddreaper/unity-ui-extensions/downloads/UnityUIExtensions-5.2.unitypackage) <- 5.2.0 - 5.2.1 base releases ONLY
|
||||
|
||||
* [Unity UI Extensions Unity 5.3 (5.2.1P+) Asset](https://bitbucket.org/ddreaper/unity-ui-extensions/downloads/UnityUIExtensions-5.3.unitypackage) <- 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.
|
||||
|
|
|
|||
|
|
@ -2,17 +2,33 @@
|
|||
This file contains the up to date release notes for each release of the UI Extensions project including release videos where required.
|
||||
|
||||
----------------
|
||||
##Update 1.1.1##
|
||||
|
||||
Incremental release with a few new features and fixes
|
||||
##Update 1.2##
|
||||
[](https://www.youtube.com/watch?v=tbc "Update 1.2 for the Unity UI Extensions Project")
|
||||
|
||||
###New / updated features###
|
||||
* Major updates to the Horizontal and Vertical Scroll Snap controls
|
||||
* Replacement HSV/Color picker control (and new Box Slider control)
|
||||
* Fixes / updates to the TextPic control
|
||||
* Updates to SoftAlphaUI script - improved Text / worldspace support
|
||||
* New Gadient control (gradient 2)
|
||||
* New UI ScrollRect Occlusion utility
|
||||
* New UI Tween Scale utility
|
||||
* New UI Infinite ScrollRect
|
||||
* New Table Layout Group
|
||||
|
||||
###Fixes###
|
||||
* UI Particles effect updated with minor fixes
|
||||
* H&S Scroll Snap indexing issues
|
||||
* H&S Scroll Snap performance updates
|
||||
* H&S Scroll Snap Long swipe behavior updated
|
||||
* TextPic Set set before draw issues
|
||||
* HSV picker replaced with more generic color picker
|
||||
|
||||
###Known issues###
|
||||
* The Image_Extended control has been removed due to Unity upgrade issues. Will return in a future update.
|
||||
|
||||
##Upgrade Notes##
|
||||
Although not specifically required, it is recommended to remove the old UI Extensions folder before importing the new asset
|
||||
The HSS picker especially had a lot of file changes in this update.
|
||||
|
||||
----------------
|
||||
##Update 1.1##
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
fileFormatVersion: 2
|
||||
guid: 062e39c1ab27d894bb43a964baff69d2
|
||||
timeCreated: 1480011173
|
||||
guid: 7e448480810b55843aefa91c1ab74cd2
|
||||
timeCreated: 1483197306
|
||||
licenseType: Pro
|
||||
MonoImporter:
|
||||
serializedVersion: 2
|
||||
|
|
|
|||
|
|
@ -100,7 +100,7 @@ namespace UnityEngine.UI.Extensions
|
|||
SetProperty(ref rowSpacing, value);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
// Temporarily stores data generated during the execution CalculateLayoutInputVertical for use in SetLayoutVertical
|
||||
private float[] preferredRowHeights;
|
||||
|
||||
|
|
@ -109,7 +109,7 @@ namespace UnityEngine.UI.Extensions
|
|||
base.CalculateLayoutInputHorizontal();
|
||||
|
||||
float horizontalSize = padding.horizontal;
|
||||
|
||||
|
||||
// We calculate the actual cell count for cases where the number of children is lesser than the number of columns
|
||||
int actualCellCount = Mathf.Min(rectChildren.Count, columnWidths.Length);
|
||||
|
||||
|
|
@ -148,30 +148,28 @@ namespace UnityEngine.UI.Extensions
|
|||
float maxMinimumHeightInRow = 0;
|
||||
float maxPreferredHeightInRow = 0;
|
||||
|
||||
for (int i = 0; i < rectChildren.Count; i++)
|
||||
for (int i = 0; i < rowCount; i++)
|
||||
{
|
||||
int currentRowIndex = i / columnCount;
|
||||
int currentColumnIndex = i % columnCount;
|
||||
maxMinimumHeightInRow = minimumRowHeight;
|
||||
maxPreferredHeightInRow = minimumRowHeight;
|
||||
|
||||
// If it's the first cell in the row, reset heights for the row
|
||||
if (currentColumnIndex == 0)
|
||||
for (int j = 0; j < columnCount; j++)
|
||||
{
|
||||
maxMinimumHeightInRow = minimumRowHeight;
|
||||
maxPreferredHeightInRow = minimumRowHeight;
|
||||
int childIndex = (i * columnCount) + j;
|
||||
|
||||
// Safeguard against tables with incomplete rows
|
||||
if (childIndex == rectChildren.Count)
|
||||
break;
|
||||
|
||||
maxPreferredHeightInRow = Mathf.Max(LayoutUtility.GetPreferredHeight(rectChildren[childIndex]), maxPreferredHeightInRow);
|
||||
maxMinimumHeightInRow = Mathf.Max(LayoutUtility.GetMinHeight(rectChildren[childIndex]), maxMinimumHeightInRow);
|
||||
}
|
||||
|
||||
maxPreferredHeightInRow = Mathf.Max(LayoutUtility.GetPreferredHeight(rectChildren[i]), maxPreferredHeightInRow);
|
||||
maxMinimumHeightInRow = Mathf.Max(LayoutUtility.GetMinHeight(rectChildren[i]), maxMinimumHeightInRow);
|
||||
totalMinHeight += maxMinimumHeightInRow;
|
||||
totalPreferredHeight += maxPreferredHeightInRow;
|
||||
|
||||
// If it's the last cell in the row, or if it's the last cell and the row is incomplete, set calculated heights
|
||||
if (currentColumnIndex == columnCount - 1 || (i == rectChildren.Count - 1 && currentRowIndex == rowCount - 1))
|
||||
{
|
||||
totalMinHeight += maxMinimumHeightInRow;
|
||||
totalPreferredHeight += maxPreferredHeightInRow;
|
||||
|
||||
// Add calculated row height to a commonly accessible array for reuse in SetLayoutVertical()
|
||||
preferredRowHeights[currentRowIndex] = maxPreferredHeightInRow;
|
||||
}
|
||||
// Add calculated row height to a commonly accessible array for reuse in SetLayoutVertical()
|
||||
preferredRowHeights[i] = maxPreferredHeightInRow;
|
||||
}
|
||||
}
|
||||
else
|
||||
|
|
@ -199,7 +197,7 @@ namespace UnityEngine.UI.Extensions
|
|||
|
||||
float startOffset = 0;
|
||||
float requiredSizeWithoutPadding = 0;
|
||||
|
||||
|
||||
// We calculate the actual cell count for cases where the number of children is lesser than the number of columns
|
||||
int actualCellCount = Mathf.Min(rectChildren.Count, columnWidths.Length);
|
||||
|
||||
|
|
@ -242,46 +240,45 @@ namespace UnityEngine.UI.Extensions
|
|||
{
|
||||
int columnCount = columnWidths.Length;
|
||||
int rowCount = preferredRowHeights.Length;
|
||||
|
||||
|
||||
int cornerY = (int)startCorner / 2;
|
||||
|
||||
float startOffset = 0;
|
||||
float requiredSizeWithoutPadding = 0;
|
||||
|
||||
for (int i = 0; i < rowCount; i++)
|
||||
{
|
||||
requiredSizeWithoutPadding += preferredRowHeights[i];
|
||||
requiredSizeWithoutPadding += rowSpacing;
|
||||
}
|
||||
|
||||
requiredSizeWithoutPadding -= rowSpacing;
|
||||
for (int i = 0; i < rowCount; i++)
|
||||
requiredSizeWithoutPadding += preferredRowHeights[i];
|
||||
|
||||
if (rowCount > 1)
|
||||
requiredSizeWithoutPadding += (rowCount - 1) * rowSpacing;
|
||||
|
||||
startOffset = GetStartOffset(1, requiredSizeWithoutPadding);
|
||||
|
||||
|
||||
if (cornerY == 1)
|
||||
startOffset += requiredSizeWithoutPadding;
|
||||
|
||||
float positionY = startOffset;
|
||||
|
||||
for (int i = 0; i < rectChildren.Count; i++)
|
||||
for (int i = 0; i < rowCount; i++)
|
||||
{
|
||||
int currentRowIndex = i / columnCount;
|
||||
int currentColumnIndex = i % columnCount;
|
||||
if (cornerY == 1)
|
||||
positionY -= preferredRowHeights[i];
|
||||
|
||||
// If it's the first cell in the row and start corner is one of the bottom corners, then modify positionY appropriately
|
||||
if (currentColumnIndex == 0 && cornerY == 1)
|
||||
positionY -= preferredRowHeights[currentRowIndex];
|
||||
|
||||
SetChildAlongAxis(rectChildren[i], 1, positionY, preferredRowHeights[currentRowIndex]);
|
||||
|
||||
// If it's the first last cell in the row, then modify positionY appropriately
|
||||
if (currentColumnIndex == columnCount - 1)
|
||||
for (int j = 0; j < columnCount; j++)
|
||||
{
|
||||
if (cornerY == 1)
|
||||
positionY -= rowSpacing;
|
||||
else
|
||||
positionY += preferredRowHeights[currentRowIndex] + rowSpacing;
|
||||
int childIndex = (i * columnCount) + j;
|
||||
|
||||
// Safeguard against tables with incomplete rows
|
||||
if (childIndex == rectChildren.Count)
|
||||
break;
|
||||
|
||||
SetChildAlongAxis(rectChildren[childIndex], 1, positionY, preferredRowHeights[i]);
|
||||
}
|
||||
|
||||
if (cornerY == 1)
|
||||
positionY -= rowSpacing;
|
||||
else
|
||||
positionY += preferredRowHeights[i] + rowSpacing;
|
||||
}
|
||||
|
||||
// Set preferredRowHeights to null to free memory
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"name": "Unity UI Extensions",
|
||||
"version": "1.1.0.0",
|
||||
"version": "1.2.0.0",
|
||||
"description": "An extension project for the Unity3D UI system, all crafted and contributed by the awesome Unity community",
|
||||
"author": "Simon darkside Jackson <@SimonDarksideJ>",
|
||||
"contributors": [{
|
||||
|
|
|
|||
Loading…
Reference in New Issue