com.unity.uiextensions.nosa.../README.md

243 lines
15 KiB
Markdown
Raw Normal View History

2020-10-31 21:22:02 +08:00
# Unity UI Extensions README
2014-12-31 06:25:53 +08:00
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)
2020-10-31 21:22:02 +08:00
> [Check out the control demos on our Tumblr page](https://unityuiextensions.tumblr.com/)
## [Intro](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/GettingStarted)
2015-09-01 22:59:54 +08:00
For more info, here's a little introduction video for the project:
[![View Intro Video](http://img.youtube.com/vi/njoIeE4akq0/0.jpg)](http://www.youtube.com/watch?v=njoIeE4akq0 "Unity UI Extensions intro video")
2015-09-01 22:52:45 +08:00
You can follow the UI Extensions team for updates and news on:
2020-10-31 21:22:02 +08:00
### [Twitter](https://twitter.com/hashtag/UnityUIExtensions?src=hash) / [Facebook](https://www.facebook.com/UnityUIExtensions/) / [YouTube](https://www.youtube.com/channel/UCG3gZOkmL-2rmZat4ufv28Q)
2020-11-01 00:10:29 +08:00
> ## Chat live with the Unity UI Extensions community on Gitter here:
>
> ## [UI Extensions Live Chat](https://gitter.im/Unity-UI-Extensions/Lobby)
-----
2020-10-31 21:22:02 +08:00
## [What is this repository for?](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/About)
2014-12-31 06:25:53 +08:00
2017-08-11 20:17:10 +08:00
In this repository is a collection of extension scripts / effects and controls to enhance your Unity UI experience. These scripts have been gathered from many sources, combined and improved over time.
2015-09-01 23:08:53 +08:00
> 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 pre-compiled Unity Assets, chock full of goodness for each release:
2020-10-31 21:22:02 +08:00
## [Download - 2019.5 (aka 2.3)](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/Downloads)
2019-03-09 22:09:22 +08:00
We have expanded where you can download the UnityPackage asset and widened the options to contribute to the project.
2020-07-09 03:38:28 +08:00
> I will still stress however, ***contribution is optional***. **The assets / code will always remain FREE**
2020-10-31 21:22:02 +08:00
| [![Download from Itch.IO](https://bytebucket.org/UnityUIExtensions/unity-ui-extensions/wiki/SiteImages/itchio.png)](https://unityuiextensions.itch.io/uiextensions2-0 "Download from Itch.IO") | [![Download from Itch.IO](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/SiteImages/unionassets.png)](https://unionassets.com/unity-ui-extensions "Download from Union Assets") | [![Download from Itch.IO](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/SiteImages/patreon.jpg)](https://www.patreon.com/UnityUIExtensions "Support Unity UI Extensions on Patreon & download")|
2017-10-25 22:37:58 +08:00
| :--- | :--- | :--- |
2020-10-31 21:22:02 +08:00
| [Grab from Itchio](https://unityuiextensions.itch.io/uiextensions2-0) | [Obtain via Union Assets](https://unionassets.com/unity-ui-extensions) |[Support through Patreon](https://www.patreon.com/UnityUIExtensions) |
2020-07-09 03:38:28 +08:00
> Still available to download on the [BitBucket site](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/downloads) if you prefer
2017-08-11 20:17:10 +08:00
To view previous releases, visit the [release archive](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/Downloads)
-----
2020-10-31 21:22:02 +08:00
## [Supporting the UI Extensions project](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=89L8T9N6BR7LJ)
2020-11-01 00:10:29 +08:00
If you wish to further support the Unity UI Extensions project itself, then you can either subsidize your downloads above, or using the links below.
2020-07-09 03:38:28 +08:00
All funds go to support the project, no matter the amount. **Donations in code are also extremely welcome**
2020-05-27 20:36:39 +08:00
| | |
|---|---|
| [![Donate via PayPal](https://www.paypalobjects.com/webstatic/mktg/Logo/pp-logo-150px.png)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=89L8T9N6BR7LJ "Donating via Paypal") | [![Buy us a Coffee](https://uploads-ssl.webflow.com/5c14e387dab576fe667689cf/5cbed8a4ae2b88347c06c923_BuyMeACoffee_blue-p-500.png)](https://ko-fi.com/uiextensions "Buy us a Coffee") |
> (PayPal account not required and you can remain anonymous if you wish)
2017-08-11 20:17:10 +08:00
-----
2020-10-31 21:22:02 +08:00
## [Getting Started](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/GettingStarted)
2020-10-31 23:09:41 +08:00
2017-08-11 20:17:10 +08:00
To get started with the project, here's a little guide:
2017-08-11 20:17:10 +08:00
[![View Getting Started Video](http://img.youtube.com/vi/sVLeYmsNQAI/0.jpg)](http://www.youtube.com/watch?v=sVLeYmsNQAI "Unity UI getting started video")
2017-08-11 20:17:10 +08:00
-----
2020-10-31 21:22:02 +08:00
## [Updates:](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/ReleaseNotes/RELEASENOTES)
2017-08-11 20:17:10 +08:00
2020-10-31 21:22:02 +08:00
## Update 2019.5 - 2.3 - Accelerated Deployment
2019-03-09 22:09:22 +08:00
2020-10-31 21:22:02 +08:00
Since the move to UPM, the team have been able to react quicker and push out fixes a lot easier, without affecting previous installation (whilst still adhering to Unity's backwards compatibility pattern). So it is with great news we announce this new release, faster that ever :D (and thanks to UPM, easier to upgrade than ever).
Be sure to also check out the "Examples" option in the Package Manager window to import the samples to your project.
2019-03-09 22:09:22 +08:00
2020-07-09 03:38:28 +08:00
> Be sure to logon to the new [Gitter Chat](https://gitter.im/Unity-UI-Extensions/Lobby) site for the UI Extensions project, if you have any questions, queries or suggestions
2020-10-31 21:22:02 +08:00
>
> Much easier that posting a question / issue on YouTube, Twitter or Facebook :D
2020-10-31 21:22:02 +08:00
>
> ## [UIExtensions Gitter Chanel](https://gitter.im/Unity-UI-Extensions/Lobby)
2019-03-09 22:09:22 +08:00
### New / updated features
2019-03-09 22:09:22 +08:00
2020-10-31 21:22:02 +08:00
* Add squircle primitive
* Adding new magnetic scroll control
* Added a static library to collate shaders on first use.
* Finalized new InputManagerHelper, which translates input based on the operating input system, new or old Updated CardStack2D to have defined keyboard input or specific gamepad input over the older axisname for new input system.
* Examples now included with UPM delivery and available as a button on the UPM package manager window
* Updated DropDown and Autocomplete controls based on feedback in #204
* Updated Accordion to support both Vertical as well as Horizontal layout
* Updated ComboBox controls to improve better programmatic controls
* Updates to the Infinite scroll to support content of various sizes
* Updated UI Knob control - enabled dragging outside the target area, added example scene
* Minor update to MagneticInfinite Scroll
* Refactored and extended the ContentScrollSnap control
* Added protection against errors and empty scrollrect content
* Added new SetNewItems function to add children programmatically to the control and reset accordingly
* Patch supplied by a contributor to improve the texture sheet use with the UIParticlesystem
* Added "SetKnobValue" function which allows the setting of Value and loops
* Added the programmatic capability to change the parent scroll rect on the ScrollConflictManager at runtime.
### Examples / Examples / Examples
2020-10-31 21:22:02 +08:00
2020-07-09 03:38:28 +08:00
Examples now have their own package, this simplifies their use and deployment. Especially in 2019 with the UPM deployment.
2019-03-09 22:09:22 +08:00
2020-10-31 21:22:02 +08:00
* New UI Knob examples
* New Magnetic Scroll Example
* Updated ComboBox examples for programmatic testing
### Fixes
2020-10-31 21:22:02 +08:00
* Fix to add a "RequireComponent" to Primitives as Unity 2020 does not add them by default
* Remove old Examples submodule
* Updated submodules to hide Examples folder Additionally, updated Package manifest to allow importing of examples direct from UPM package.
* Fixed hard swipe to ensure it only ever moves one page, no matter how far you swipe.
* Fixed a conflict when using the ScrollConflictManager in child content of a HSS or VSS
* Fix for UI Particle system looping
* Fixed public GoToScreen call to only raise events internally (not multiple)
* Final roll-up and fix. Resolved race condition for associated pagination controls.
* Fixed issue with page events not being raised when inertia was disabled (velocity was always zero)
* When cloned, reorderable list was creating a second List Content component that was not initialized. Refactored to ensure only one list content was present and is initialized correctly
* Reorderable list items marked as transferable, remain transferable after being dropped
* Patch to resolve issues without the new Input System installed
* Refined magnetic scroll and dependencies while documenting Updated example
* Patch Tooltip
### Known issues
2020-10-31 21:22:02 +08:00
2019-03-09 22:09:22 +08:00
No new issues in this release, but check the issues list for things we are currently working on:
* [UI Extensions Issue log](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/issues?status=new&status=open)
## Upgrade Notes
2020-07-09 03:38:28 +08:00
2020-10-31 21:22:02 +08:00
Due to the restructure of the package to meet Unity's new package guidelines, we recommend **Deleting the current Unity UI Extensions** folder prior to importing the new package.
For Unity 2019 users using the new UPM deployment, be sure to delete the existing folder in your assets folder before adding the new package to avoid conflict.
-----
2017-08-11 20:17:10 +08:00
## Release History
For the full release history, follow the below link to the full release notes page.
2017-08-11 20:17:10 +08:00
### [Release Notes](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/ReleaseNotes/RELEASENOTES)
2020-10-31 21:22:02 +08:00
-----
## [Controls and extensions listed in this project](https://bitbucket.org/UnityUIExtensions/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:
> ## [Check out the control demos on our Tumblr page](https://www.tumblr.com/blog/unityuiextensions)
2020-10-31 21:22:02 +08:00
>
2020-10-31 23:09:41 +08:00
> | [![UI Line Renderer](https://bytebucket.org/UnityUIExtensions/unity-ui-extensions/wiki/SiteImages/LineRenderer.gif)](https://www.tumblr.com/blog/unityuiextensions "UI Line Renderer") | [![UI Knob](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/SiteImages/UIKnob.gif)](https://www.tumblr.com/blog/unityuiextensions "UI Knob") | [![ScrollSnap](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/SiteImages/ScrollSnap.gif)](https://www.tumblr.com/blog/unityuiextensions "Scroll Snap")|
2017-10-25 22:36:35 +08:00
> | :--- | :--- | :--- |
2020-10-31 21:22:02 +08:00
> | [UI Line Renderer](https://www.tumblr.com/blog/unityuiextensions) | [UI Knob](https://www.tumblr.com/blog/unityuiextensions) |[Scroll Snap](https://www.tumblr.com/blog/unityuiextensions) |
2017-08-11 20:17:10 +08:00
## [UI Extensions controls list](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/Controls)
[Controls](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/Controls#markdown-header-controls)|||||
------|------|------|------|
2020-07-09 03:38:28 +08:00
Accordion|ColorPicker|Selection Box|UI Flippable|ComboBox
AutoComplete ComboBox|DropDown List|BoundToolTip|UIWindowBase|UI Knob
TextPic|Input Focus|Box Slider|Cooldown Button|Segmented Control
Stepper|Range Slider|Radial Slider|MultiTouch Scroll Rect|
||||
[Primitives](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/Controls#markdown-header-primitives)|||||
------|------|------|------|
UILineRenderer|UILineTextureRenderer|UICircle|DiamondGraph|UICornerCut
UIPolygon||||
||||
[Layouts](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/Controls#markdown-header-layouts)|||||
------|------|------|------|
Horizontal Scroll Snap|Vertical Scroll Snap|Flow Layout Group|Radial Layout|Tile Size Fitter
Scroll Snap (alt implementation)|Reorderable List|UI Vertical Scroller|Curved Layout|Table Layout
2020-07-09 03:38:28 +08:00
FancyScrollView|Card UI|Scroll Position Controller||
||||
[Effects](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/Controls#markdown-header-effect_components)|||||
------|------|------|------|
Best Fit Outline|Curved Text|Gradient|Gradient2|Letter Spacing
NicerOutline|RaycastMask|UIFlippable|UIImageCrop|SoftAlphaMask
2020-07-09 03:38:28 +08:00
CylinderText|UIParticleSystem|CurlyUI|Shine Effect|Shader Effects
||||
[Additional Components](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/Controls#markdown-header-additional_components)|||||
------|------|------|------|
ReturnKeyTrigger|TabNavigation|uGUITools|ScrollRectTweener|ScrollRectLinker
ScrollRectEx|UI_InfiniteScroll|UI_ScrollRectOcclusion|UIScrollToSelection|UISelectableExtension
2017-08-11 20:17:10 +08:00
switchToRectTransform|ScrollConflictManager|CLFZ2 (Encryption)|DragCorrector|PPIViewer
2020-10-31 21:22:02 +08:00
UI_TweenScale|UI_MagneticInfiniteScroll|UI_ScrollRectOcclusion|NonDrawingGraphic|
UILineConnector|UIHighlightable|Menu Manager|Pagination Manager|
||||
2014-12-31 06:27:53 +08:00
*More to come*
2014-12-31 06:25:53 +08:00
2020-10-31 21:22:02 +08:00
-----
2020-10-31 21:22:02 +08:00
## [How do I get set up?](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/GettingStarted)
2020-07-09 03:38:28 +08:00
As of Unity 2019, there are now two paths for getting access to the Unity UI Extensions project:
2020-07-09 03:38:28 +08:00
- Unity 2019 or higher
The recommended way to add the Unity UI Extensions project to your solution is to use the Unity package Manager. Simply use the [Unity Package Manager](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/UPMInstallation) to reference the project and install it.
Alternatively, you can also use the pre-compiled Unity packages if you wish, however, UPM offers full versioning support to allow you to switch versions as you wish.
- Unity 2018 or lower
The pre-compiled Unity assets are the only solution for Unity 2018 or earlier due to the changes in the Unity UI framework in Unity made for 2019.
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.
2014-12-31 06:25:53 +08:00
2020-10-31 21:22:02 +08:00
## [Contribution guidelines](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/ContributionGuidelines)
Got a script you want added? Then just fork the bitbucket repository and submit a PR. All contributions accepted (including fixes)
2020-07-09 03:38:28 +08:00
Just ensure:
* The header of the script should match the standard used in all scripts
2015-02-10 01:05:15 +08:00
* 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)
2020-10-31 21:22:02 +08:00
## [License](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/License)
2020-10-31 21:22:02 +08:00
All scripts conform to the BSD3 license and are free to use / distribute. See the [LICENSE](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/License) file for more information =
2014-12-31 06:25:53 +08:00
2020-10-31 21:22:02 +08:00
## [Like what you see?](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/FurtherInfo)
2014-12-31 06:25:53 +08:00
All these scripts were put together for my latest book Unity3D UI Essentials
2015-01-16 01:44:17 +08:00
Check out the [page on my blog](http://bit.ly/Unity3DUIEssentials) for more details and learn all about the inner workings of the new Unity UI System.
2020-10-31 21:22:02 +08:00
## [The downloads](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/Downloads)
2015-01-16 01:44:17 +08:00
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.
2020-10-31 21:22:02 +08:00
## [Previous Releases](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/Downloads)
2020-10-31 21:22:02 +08:00
Please see the [full downloads list](https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/wiki/Downloads) for all previous releases and their corresponding download links.