----------------------------------------------
NGUI: Next-Gen UI kit
Copyright © 2011-2016 Tasharen Entertainment
Version 3.11.1
http://www.tasharen.com/?page_id=197
[email protected]
----------------------------------------------
Thank you for buying NGUI!
PLEASE NOTE that NGUI can only be legally downloaded from the following 3 sources:
1. Unity Asset Store (Standard License)
2. www.tasharen.com (Standard License)
3. github.com/tasharen/ngui (Professional and Site Licenses)
If you've obtained NGUI via some other means then note that your license is effectively invalid,
as Tasharen cannot provide support for pirated and/or potentially modified software.
Documentation can be found here: http://www.tasharen.com/forum/index.php?topic=6754.0
If you have any questions, suggestions, comments or feature requests, please
drop by the NGUI forum, found here: http://www.tasharen.com/forum/index.php?board=1.0
--------------------
How To Update NGUI
--------------------
If you have the Professional or Site License of NGUI that comes with Git access, just pull the latest changes.
If you have a Standard License:
1. In Unity, File -> New Scene
2. Delete the NGUI folder from the Project View.
3. Import NGUI from the updated Unity Package.
---------------------------------------
Support, documentation, and tutorials
---------------------------------------
All can be found here: http://www.tasharen.com/forum/index.php?topic=6754.0
Using NGUI with JavaScript (UnityScript)? Read this first: http://www.tasharen.com/forum/index.php?topic=6
------------------
FreeType Library
------------------
NGUI version 3.5.2 onwards includes the pre-compiled C++ FreeType library, which is an open source project (http://freetype.org/)
FreeType license: http://git.savannah.gnu.org/cgit/freetype/freetype2.git/tree/docs/FTL.TXT
This library is used only if you choose the "Generate Bitmap" font option in the Font Maker,
and it will not be included in the build of your game. It's only used in the editor.
-----------------
Version History
-----------------
3.11.1
- NEW: Added a 'keep value' option to the popup list that will make popup values persist even after it disappears, like it used to work before the change many versions back.
- FIX: Popup list with values defined at edit time no longer has an initial value (unless the new 'keep value' is checked).
- FIX: Capitalized versions of bbcode keywords like [B] will now work in addition to lowercase.
- FIX: Backwards compatibility fixes with Unity 5.3.
3.11.0
- NEW: It's now possible to specify a custom material on regular NGUI sprites and labels.
- NEW: Added UV2 support, specified on the panels. Secondary UVs can be easily used to add multi-texturing effects such as blended tiled backgrounds or simply detail textures, enhancing your UI's look.
- NEW: Draw call now uses a material property block to specify the main texture as it works better at edit time.
- NEW: UIGeometry now has a onCustomWrite delegate that can be used to modify the generated geometry as you see fit.
- NEW: Added camera.FitOnScreen(transform) to simplify adjusting some group of widget's position to be within screen bounds.
- NEW: Tweens can now be set to use FixedUpdate for their animation.
- NEW: Added UIDrawCall.onCreateDrawCall that's called every time a new draw call gets created.
- NEW: Added UIDrawCall.shadowMode that can be used to change the shadow casting mode.
- FIX: NGUI's geometry should now work with one-sided shaders.
- NEW: Added UICamera.lastWorldRay to hold the last ray used to cast into the world.
- NEW: Added UICamera.mouse0, mouse1, mouse2 to access the mouse directly.
- NEW: UICamera.uiHasFocus to return 'true' when there is an active UI interaction happening.
- NEW: NGUI raycasts into the world will now automatically ignore triggers if the event type is set to World_3D.
- FIX: Popup list's panel now keeps the sorting order of its parent panel.
- FIX: Tweener.Begin now always clears the onFinished callback list.
- FIX: Eliminated GC allocations from raycasts.
3.10.2
- NEW: Added UIDrawCall.MoveToScene for Unity 5.4+ to make it easier to move the UI to another scene.
- FIX: Fixed an issue with Unity 5.4.1 in regards to the NGUI menu.
- FIX: DragDropItem will now inverse transform the delta, so it should theoretically work even with rotated panels.
- FIX: DragDropItem now again clears the scroll view reference after the drag operation completes.
- FIX: Unity 5.4 DX9 bug work-around (no longer marking VBOs as dynamic).
3.10.1
- NEW: Added UICamera.ignoreAllEvents to easily disable all NGUI events.
- FIX: Unity 5.4 editor on OSX: fixes for retina-related glitches of 5.4.
- FIX: Gamma to linear conversion now happens in the draw call class and no longer needs to be set in each OnFill function.
3.10.0
- NEW: Added Texture2D.MakeReadable(true/false) -- a convenience extension for the editor. Not sure why this isn't built-in.
- FIX: UIDragScrollView will no longer inform the scroll view of OnPress(false) on disable unless it's actually being dragged.
- FIX: Removed ColorMask RGB from shaders since according to Unity docs it may slow down some mobiles.
- FIX: Fixed Unity 5.4 function deprecation warnings.
- MISC: Added Profiler.BeginSample/EndSample blocks to clarify GC allocations that only happen in the editor.
3.9.9
- NEW: Added customizable GetMouse, GetTouch and RemoveTouch delegates to UICamera replacing fixed Input calls. This makes all of NGUI's events go through user-settable delegates.
- NEW: Sprite Animation script now has a frame offset index you can set if you want it to start at something other than 0.
- NEW: UIScrollView now has a "constrain on drag" as an option rather than always being off.
- FIX: UILabel resizing due to overflow settings will now trigger its UIWidget.onChange notification.
- FIX: Fix for a visibility issue caused by instantiating a panel off-screen then bringing it into view.
- FIX: Fixed a bug with text wrapping not wrapping colors properly in some situations (UITextList).
3.9.8
- NEW: NGUI now uses Color instead of Color32 for colors, which work better with linear space colors.
- NEW: Added a modifier setting to the UILabel that can automatically change the text prior to displaying it, such as making it uppercase/lowercase or calling a custom modifier function.
- FIX: Better handling of Linear space lighting.
- FIX: Changing UIPanel.alpha no longer invalidates the widgets underneath it (performance boost).
- FIX: Font Maker should now work even in the 32-bit version of Unity 5.
- FIX: Forcing OpenGL in Windows will no longer result in a blurry UI.
- FIX: Fix for an issue in Unity 5.4.
3.9.7
- NEW: Added "events go to colliders" option to all UICameras, not just the first one.
- NEW: UICamera now has an option to process events in either Update or LateUpdate.
- NEW: Added a "max width" property to labels set to overflow using Resize Freely.
- NEW: UIPopupList now supports 2D sprites.
- NEW: Added code to UIKeyBinding to convert its key+modifier to text format and back (good for saving a list of key bindings in files).
- NEW: Added Set() functions to UIProgressBar, UIToggle, UIInput that can set a value without triggering the event callbacks.
- NEW: Added Camera.FitOnScreen() extension that can be used to ensure that any UI does not go past the screen's dimensions (ex: tooltip).
- NEW: Added TweenFill that can be used to tween filled sprites' fill value.
- FIX: UIButton no longer fires its OnClick notification from right and middle mouse button clicks.
- FIX: Fix for duration 0 tweens not advancing their time properly.
- FIX: Fix for long press tooltips not showing properly on touch screens half the time.
3.9.6
- NEW: Added NGUITools.Draw<T> function that can be used like GUI.Draw (just much more efficient).
- NEW: NGUITools.AddChild is now an extension method (ie: gameObject.AddChild).
- NEW: Added several new versions of UIRect.SetAnchor.
- NEW