Topics

46

Releases / 2D Toolkit 2.0 final + hotfix 2

« on: June 18, 2013, 06:25:54 pm »

Please read the migration guide before updating. 2D Toolkit 2.0 is not API compatible with 1.x.
http://unikronsoftware.com/2dtoolkit/docs/2.00/migration_guide.html

Documentation available at:
http://unikronsoftware.com/2dtoolkit/docs/2.00


Another quick hotfix to fix some critical issues that could affect a very small number of users.

What's new

• 2D Toolkit UI
• Sprite handles - you can resize / move(click and drag) / rotate(alt) sprites using the handles. Turn them off in preferences if you don't like them.
• Static sprite batcher - supports all sprite types (clipped, tiled, sliced, normal) and text meshes too. Multiple materials & sprite collections supported.
• Animated sprite deprecated in favour of tk2dSpriteAnimator. Works the same, but lets you animate different sprite types.
• Text mesh supports inline colors and gradient switching. Click the help button in the text mesh editor for more details.
• "Sprite from Selected Texture" - use to create a sprite without a sprite collection. Use with care, as each will require one draw call. It's not there for convenience, but rather for backgrounds and render textures that can't be atlased.
• Loads of API improvements.

Bug fixes and improvements

• Sprite collection picker bugfix - bug occurred in rare cases when switching from a sprite collection to another with the same named sprite in it, and the second sprite collection index was larger than the number of sprites in the first.
• Scrollable area swipe velocity threshold corrected.
• Fix for AnimationEventTriggered, if nulled out during a sequence of events
• Cope with sprite / sprite from texture, added as a component - and cope with some cases
• SpriteFromTexture implementation changed to avoid some errors - now creates a sprite collection in the scene
• Added some missing tk2dSpriteAnimator.Play variants
• Fixed packed fonts - was broken in 2.0
• Fixed tk2dTextMesh help text for inline formatting - was incorrect
• Fixed tk2dTextMesh inline styling - was failing in some cases
• tk2dSprite.SetSprite - print out the sprite name when can't be found
• Smoothspherecollisions wasn't being transferred to the sprite
• Tilemap.GetTilePosition returns correct values for isometric tiles.
• tk2dSpriteAnimationClip copy constructor.
• Fixed ToggleButtonGroup OnChange order - now called after state is changed.
• Tk2dExternal.Skin.Done is now static - could run into issues before.
• tk2dUiManager.OnMouseWheelChange -> OnScrollWheelChange to stop Unity warning during iOS build because function name starts with OnMouse.
• textInput.SetFocos / IsFocus
• Sprite handles disable themselves when using vertex snap mode in Unity
• Selecting an animation clip will now select the first frame group
• tk2dSpriteAnimation - added "View Data" context menu, to allow viewing data without switching to debug mode.
• Animation editor - warn when invalid clip is detected, non destructive, but can attempt "fix" if requested
• tk2dTextMesh.GetMeshDimensionsForString re-instated
• tk2dStaticSpriteBatcher.UpdateMatrices for legacy support
• Clipped sprite bounds corrected, now will work correctly on trimmed sprites.
• Sprite collection polygon collider defaults to front & back collider faces. Was causing a lot of confusion.
• Creating a sprite will now automatically inherit the layer of the parent.
• Sprite collection names sorted "naturally"
• Removed skin assets - the skin is now stored externally in a DLL. Less files in the project, and less likely to break.
• Sliced sprite legacy mode removed - automatic upgrade should work almost 100% of the time.
• tk2dUIMask in favour of other masking methods - this is extremely efficient.
• Default ortho size in sprite collection is now 10, works better with default Unity physics settings.
• Textmesh data moved to external serializable class. Shouldn't require any changes from user code.
• Got rid of "Always pixel perfect". Its always more efficient to update the camera to compensate for resolution changes.
• You can convert between sprite types in the component settings menu - also add or remove animators to a sprite.
• Moved non-core systems into own directory structures - tk2dUI, and tk2dTileMap.
• Lots more little bugfixes - please let me know if a bug you've reported isn't fixed.

47

Releases / 2D Toolkit 2.0 final + hotfix 1

« on: June 15, 2013, 10:02:57 pm »

Please read the migration guide before updating. 2D Toolkit 2.0 is not API compatible with 1.x.
http://unikronsoftware.com/2dtoolkit/docs/2.00/migration_guide.html

Documentation available at:
http://unikronsoftware.com/2dtoolkit/docs/2.00


What's new

• 2D Toolkit UI
• Sprite handles - you can resize / move(click and drag) / rotate(alt) sprites using the handles. Turn them off in preferences if you don't like them.
• Static sprite batcher - supports all sprite types (clipped, tiled, sliced, normal) and text meshes too. Multiple materials & sprite collections supported.
• Animated sprite deprecated in favour of tk2dSpriteAnimator. Works the same, but lets you animate different sprite types.
• Text mesh supports inline colors and gradient switching. Click the help button in the text mesh editor for more details.
• "Sprite from Selected Texture" - use to create a sprite without a sprite collection. Use with care, as each will require one draw call. It's not there for convenience, but rather for backgrounds and render textures that can't be atlased.
• Loads of API improvements.

Bug fixes and improvements

• Fix for AnimationEventTriggered, if nulled out during a sequence of events
• Cope with sprite / sprite from texture, added as a component - and cope with some cases
• SpriteFromTexture implementation changed to avoid some errors - now creates a sprite collection in the scene
• Added some missing tk2dSpriteAnimator.Play variants
• Fixed packed fonts - was broken in 2.0
• Fixed tk2dTextMesh help text for inline formatting - was incorrect
• Fixed tk2dTextMesh inline styling - was failing in some cases
• tk2dSprite.SetSprite - print out the sprite name when can't be found
• Smoothspherecollisions wasn't being transferred to the sprite
• Tilemap.GetTilePosition returns correct values for isometric tiles.
• tk2dSpriteAnimationClip copy constructor.
• Fixed ToggleButtonGroup OnChange order - now called after state is changed.
• Tk2dExternal.Skin.Done is now static - could run into issues before.
• tk2dUiManager.OnMouseWheelChange -> OnScrollWheelChange to stop Unity warning during iOS build because function name starts with OnMouse.
• textInput.SetFocos / IsFocus
• Sprite handles disable themselves when using vertex snap mode in Unity
• Selecting an animation clip will now select the first frame group
• tk2dSpriteAnimation - added "View Data" context menu, to allow viewing data without switching to debug mode.
• Animation editor - warn when invalid clip is detected, non destructive, but can attempt "fix" if requested
• tk2dTextMesh.GetMeshDimensionsForString re-instated
• tk2dStaticSpriteBatcher.UpdateMatrices for legacy support
• Clipped sprite bounds corrected, now will work correctly on trimmed sprites.
• Sprite collection polygon collider defaults to front & back collider faces. Was causing a lot of confusion.
• Creating a sprite will now automatically inherit the layer of the parent.
• Sprite collection names sorted "naturally"
• Removed skin assets - the skin is now stored externally in a DLL. Less files in the project, and less likely to break.
• Sliced sprite legacy mode removed - automatic upgrade should work almost 100% of the time.
• tk2dUIMask in favour of other masking methods - this is extremely efficient.
• Default ortho size in sprite collection is now 10, works better with default Unity physics settings.
• Textmesh data moved to external serializable class. Shouldn't require any changes from user code.
• Got rid of "Always pixel perfect". Its always more efficient to update the camera to compensate for resolution changes.
• You can convert between sprite types in the component settings menu - also add or remove animators to a sprite.
• Moved non-core systems into own directory structures - tk2dUI, and tk2dTileMap.
• Lots more little bugfixes - please let me know if a bug you've reported isn't fixed.

48

Support / 2D Toolkit Roadmap Trello

« on: June 10, 2013, 11:45:58 am »

Hi folks,

I've been going through and setting up a 2D Toolkit Roadmap Trello. Feel free to vote/comment on any features. We've more or less made up our minds for the 2.1 targets, but it'll be a good experiment for the next version at least.

https://trello.com/b/UfqlXqXy

Its not complete yet, and this is disjoint from our own internal Trellos at the moment, but the idea is to merge it all eventually.

49

Support / MOVED: building your own ui components in unity script

« on: June 05, 2013, 10:10:55 am »

This topic has been moved to FAQs.

http://unikronsoftware.com/2dtoolkit/forum/index.php?topic=1835.0

50

Releases / 2D Toolkit 2.0 final

« on: June 01, 2013, 12:30:32 am »

Please read the migration guide before updating. 2D Toolkit 2.0 is not API compatible with 1.x.
http://unikronsoftware.com/2dtoolkit/docs/2.00/migration_guide.html

Documentation available at:
http://unikronsoftware.com/2dtoolkit/docs/2.00


What's new

• 2D Toolkit UI
• Sprite handles - you can resize / move(click and drag) / rotate(alt) sprites using the handles. Turn them off in preferences if you don't like them.
• Static sprite batcher - supports all sprite types (clipped, tiled, sliced, normal) and text meshes too. Multiple materials & sprite collections supported.
• Animated sprite deprecated in favour of tk2dSpriteAnimator. Works the same, but lets you animate different sprite types.
• Text mesh supports inline colors and gradient switching. Click the help button in the text mesh editor for more details.
• "Sprite from Selected Texture" - use to create a sprite without a sprite collection. Use with care, as each will require one draw call. It's not there for convenience, but rather for backgrounds and render textures that can't be atlased.
• Loads of API improvements.

Bug fixes and improvements

• Tilemap.GetTilePosition returns correct values for isometric tiles.
• tk2dSpriteAnimationClip copy constructor.
• Fixed ToggleButtonGroup OnChange order - now called after state is changed.
• Tk2dExternal.Skin.Done is now static - could run into issues before.
• tk2dUiManager.OnMouseWheelChange -> OnScrollWheelChange to stop Unity warning during iOS build because function name starts with OnMouse.
• textInput.SetFocos / IsFocus
• Sprite handles disable themselves when using vertex snap mode in Unity
• Selecting an animation clip will now select the first frame group
• tk2dSpriteAnimation - added "View Data" context menu, to allow viewing data without switching to debug mode.
• Animation editor - warn when invalid clip is detected, non destructive, but can attempt "fix" if requested
• tk2dTextMesh.GetMeshDimensionsForString re-instated
• tk2dStaticSpriteBatcher.UpdateMatrices for legacy support
• Clipped sprite bounds corrected, now will work correctly on trimmed sprites.
• Sprite collection polygon collider defaults to front & back collider faces. Was causing a lot of confusion.
• Creating a sprite will now automatically inherit the layer of the parent.
• Sprite collection names sorted "naturally"
• Removed skin assets - the skin is now stored externally in a DLL. Less files in the project, and less likely to break.
• Sliced sprite legacy mode removed - automatic upgrade should work almost 100% of the time.
• tk2dUIMask in favour of other masking methods - this is extremely efficient.
• Default ortho size in sprite collection is now 10, works better with default Unity physics settings.
• Textmesh data moved to external serializable class. Shouldn't require any changes from user code.
• Got rid of "Always pixel perfect". Its always more efficient to update the camera to compensate for resolution changes.
• You can convert between sprite types in the component settings menu - also add or remove animators to a sprite.
• Moved non-core systems into own directory structures - tk2dUI, and tk2dTileMap.
• Lots more little bugfixes - please let me know if a bug you've reported isn't fixed.

51

FAQs / Floaty physics?

« on: May 26, 2013, 12:25:11 am »

Setting up physics.

Physics is configured in the Unity Physics Manager.
http://docs.unity3d.com/Documentation/Components/class-PhysicsManager.html

You will likely need to adjust physics to work well with your scene/sprites based on your camera. Here is a quick way to help pick appropriate gravity settings. There is no magic number which will work in all cases - it depends very much on what your sprites represent.

1. Work out the screen height in meters from the top to the bottom of your game window screen. Eg. if you can stack up 10x 1 meter boxes to fill up your screen vertically, then thats 10 meters.

2. Work out the camera height - if you're using an orthographic camera, it will be the orthographic size * 2. If you use a tk2dCamera, it will be the height of your native resolution in pixels.

gravity.y should be around = -9.81 * camera height / screen height meters for things to fall naturally.

52

Releases / 2D Toolkit 2.0 beta 1

« on: May 17, 2013, 07:34:19 pm »

Please read the migration guide before updating. 2D Toolkit 2.0 is not API compatible.
http://unikronsoftware.com/2dtoolkit/docs/2.00/migration_guide.html

Documentation available at:
http://unikronsoftware.com/2dtoolkit/docs/2.00


What's new

• 2D Toolkit UI
• Sprite handles - you can resize / move(click and drag) / rotate(alt) sprites using the handles. Turn them off in preferences if you don't like them.
• Static sprite batcher - supports all sprite types (clipped, tiled, sliced, normal) and text meshes too. Multiple materials & sprite collections supported.
• Animated sprite deprecated in favour of tk2dSpriteAnimator. Works the same, but lets you animate different sprite types.
• Text mesh supports inline colors and gradient switching. Click the help button in the text mesh editor for more details.
• "Sprite from Selected Texture" - use to create a sprite without a sprite collection. Use with care, as each will require one draw call. It's not there for convenience, but rather for backgrounds and render textures that can't be atlased.
• Loads of API improvements.

Bug fixes and improvements

• Clipped sprite bounds corrected, now will work correctly on trimmed sprites.
• Sprite collection polygon collider defaults to front & back collider faces. Was causing a lot of confusion.
• Creating a sprite will now automatically inherit the layer of the parent.
• Sprite collection names sorted "naturally"
• Removed skin assets - the skin is now stored externally in a DLL. Less files in the project, and less likely to break.
• Sliced sprite legacy mode removed - automatic upgrade should work almost 100% of the time.
• tk2dUIMask in favour of other masking methods - this is extremely efficient.
• Default ortho size in sprite collection is now 10, works better with default Unity physics settings.
• Textmesh data moved to external serializable class. Shouldn't require any changes from user code.
• Got rid of "Always pixel perfect". Its always more efficient to update the camera to compensate for resolution changes.
• You can convert between sprite types in the component settings menu - also add or remove animators to a sprite.
• Moved non-core systems into own directory structures - tk2dUI, and tk2dTileMap.
• Lots more little bugfixes - please let me know if a bug you've reported isn't fixed.

53

Support / 2D Toolkit 2.0 migration guide.

« on: May 16, 2013, 11:56:15 pm »

Hi folks.

Here is the 2D Toolkit 2.0 migration guide. A few API functions have changed, but we have attempted to document all the changes you are likely to make in your codebase.

http://unikronsoftware.com/2dtoolkit/docs/200/

54

Releases / 2D Toolkit Integrity Checker

« on: May 15, 2013, 02:07:10 pm »

Hi folks,

Since we are drawing really close to the 2D Toolkit 2.0 release, I'm releasing this 2D Toolkit runtime integrity checker. This will check your project to see if the GUIDs are correct on the tk2d runtime files. It is highly advisable to run this to make sure your installation is healthy before upgrading to 2.0.

1. Import unity package into your project, restart Unity if necessary.
2. You will see a "2D Toolkit Integrity Check" menu. Click the "Run" submenu there.
3. Wait until it does its thing.
4. When it finishes, you either get an "Integrity check success!" message, or "Integrity check failed..." message with one or more errors.

I would appreciate it if you could vote on the poll, and reply with the console dump if you have any errors.
ps. to uninstall, just delete the tk2dIntegrityChecker folder.

This version will check integrity up to version 2.0 - version 2.0 and above will have a built in integrity checker.

55

Support / IMPORTANT - Forum email issues

« on: May 14, 2013, 12:20:32 am »

Hi folks,

We seem to be experiencing issues with forum email. If you haven't received the authentication or registration emails - please email support at unikronsoftware dot com and we will get it sorted out promptly.

Apologies for the inconvenience.

56

Releases / 2D Toolkit UI 1.0 Beta 6

« on: May 11, 2013, 01:30:20 am »

IMPORTANT: This version is not guaranteed to be backwards compatible with the alpha release. Most class names have changed. If you have started work with the alpha version, follow the instructions the beta 2 post to upgrade before proceeding.

This version breaks backwards compatibility in some ways with beta 3.
Follow the instructions in beta 5 to upgrade before proceeding.


Webplayer demo here

Features:
- Light weight code, ultra fast.
- Lots of control prefabs. Use as a basis for customization, or create your own.
  - Buttons
  - Checkboxes
  - Radio Buttons
  - Textboxes
  - Lists
  - Sliders
  - Progress bars
  - Scrollbars
  - Scrolling areas
- Multi touch support, including on screen keyboard on iOS / Android / Windows Phone 8
- Full iOS / Android / Windows Phone 8 / WebPlayer / PC / Mac support. Almost complete Flash support.
- Works in Unity Free & Pro

Bugfixes and improvements:
- New mask system inspired by wtg's request. Removes need for second camera unless you need to clip 3D objects. The demo scene uses this. When upgrading, if you don't wish to upgrade to this new clipping method, you will need to manually change the shader on your sprite collection to Depth Mask Solid.
- Automatic collider resizing - select a tk2dUIItem and click "Fit" to best-fit colliders, or select a root game object and select the "2D Toolkit > UI > Fix Selected Item Bounds" to fix collider bounds on all selected items. Works with sphere and box colliders.
- Warn user when running the game without a tk2dUIManager
- clicking on a button in a list and dragging will not click the button when finger is lifted while still on the button
- OnTextChange in UITextInput
- radio button added to list at runtime no works as expected
- setting text of TextInput from code
- fixed cursor anchor when alignment in textinput set to center
- Fixed some Unity 4 warnings
- Works in Flash, apart from text input. This is a known issue with Unity.
- UIDropDown now has a helper to help set up heights.
- Scrollbar, arrow buttons mirror mouse operations - held down for duration of mouse click.
- Esc/tab entering incorrect input on Mac only (known Unity issue).
- Dismiss on screen keyboard by clicking outside the view
- Scrollbar, when dragging thumb, the arrows aren't highlighted.
- UIControlsHelper works when scaled
- Scrollable area depth masks are now sliced sprites (easily scaled)
- Scrollbar "bar" is a sliced sprite.
- tk2dUIItem doesn't require a collider any more, sphere colliders can be set up.
- textinput password option with configureable character.
- fixed bug where clicking on the next textinput (on mobile) will enter text in both.
- scrollable area option to set value without event.
- in scrollable area, when setting content length programatically, if content length < visible length, scrollbar is hidden.
- tk2dUI prefix on all classes (finalized)
- tk2dUITime is now a static class
- scrollable area snapback uses velocity
- click + hold scrollbar arrow to scroll continuously
- now possible to change toggle buttons at runtime
- scrollbar editor widget corrected and shows thumb size
- editor widgets show extended line when being used, easier to position and tweak correctly.

57

Support / Unity Versions

« on: May 07, 2013, 11:55:06 pm »

I'm creating this poll to better gauge where to spend engineering efforts for future versions of the software.

This isn't for version 2D Toolkit 2.0, but for later versions. There are quite a few nice features in Unity 4.x which could be used, if not for the fact that we currently have full support for 3.5.7.

58

Releases / 2D Toolkit UI 1.0 Beta 5

« on: May 05, 2013, 02:15:41 am »

IMPORTANT: This version is not guaranteed to be backwards compatible with the alpha release. Most class names have changed. If you have started work with the alpha version, follow the instructions the beta 2 post to upgrade before proceeding.

This version breaks backwards compatibility in some ways with beta 3.
Please read the next post before updating.


Webplayer demo here

Features:
- Light weight code, ultra fast.
- Lots of control prefabs. Use as a basis for customization, or create your own.
Buttons
Checkboxes
Radio Buttons
Textboxes
Lists
Sliders
Progress bars
Scrollbars
Scrolling areas
- Multi touch support, including on screen keyboard on iOS / Android / Windows Phone 8
- Full iOS / Android / Windows Phone 8 / WebPlayer / PC / Mac support. Almost complete Flash support.
- Works in Unity Free & Pro

Bugfixes and improvements:
- clicking on a button in a list and dragging will not click the button when finger is lifted while still on the button
- OnTextChange in UITextInput
- radio button added to list at runtime no works as expected
- setting text of TextInput from code
- fixed cursor anchor when alignment in textinput set to center
- Fixed some Unity 4 warnings
- Works in Flash, apart from text input. This is a known issue with Unity.
- UIDropDown now has a helper to help set up heights.
- Scrollbar, arrow buttons mirror mouse operations - held down for duration of mouse click.
- Esc/tab entering incorrect input on Mac only (known Unity issue).
- Dismiss on screen keyboard by clicking outside the view
- Scrollbar, when dragging thumb, the arrows aren't highlighted.
- UIControlsHelper works when scaled
- Scrollable area depth masks are now sliced sprites (easily scaled)
- Scrollbar "bar" is a sliced sprite.
- tk2dUIItem doesn't require a collider any more, sphere colliders can be set up.
- textinput password option with configureable character.
- fixed bug where clicking on the next textinput (on mobile) will enter text in both.
- scrollable area option to set value without event.
- in scrollable area, when setting content length programatically, if content length < visible length, scrollbar is hidden.
- tk2dUI prefix on all classes (finalized)
- tk2dUITime is now a static class
- scrollable area snapback uses velocity
- click + hold scrollbar arrow to scroll continuously
- now possible to change toggle buttons at runtime
- scrollbar editor widget corrected and shows thumb size
- editor widgets show extended line when being used, easier to position and tweak correctly.

59

Support / Web host moved!

« on: April 28, 2013, 06:05:16 pm »

We've just moved web hosts - DNS hasn't fully updated yet, but the redirect should work for now. Hopefully, the forum won't randomly stall/randomly not send emails as it used to with the previous host, and ultimately will be a better experience for everyone.

If you have any problems/comments, please let us know.

60

Releases / 2D Toolkit UI 1.0 beta 3

« on: April 19, 2013, 12:36:41 pm »

IMPORTANT: This version is not guaranteed to be backwards compatible with the alpha release. Most class names have changed. If you have started work with the alpha version, follow the instructions the beta 2 post to upgrade before proceeding.

This version is backwards compatible with beta 2.

Webplayer demo here

Features:
- Light weight code, ultra fast.
- Lots of control prefabs. Use as a basis for customization, or create your own.
Buttons
Checkboxes
Radio Buttons
Textboxes
Lists
Sliders
Progress bars
Scrollbars
Scrolling areas
- Multi touch support, including on screen keyboard on iOS / Android
- Full mobile / webplayer / PC / Mac support. Almost full Flash support.
- Works in Unity Free & Pro

Bugfixes and improvements:
- Works in Flash, apart from text input. This is a known issue with Unity.
- UIDropDown now has a helper to help set up heights.
- Scrollbar, arrow buttons mirror mouse operations - held down for duration of mouse click.
- Esc/tab entering incorrect input on Mac only (known Unity issue).
- Dismiss on screen keyboard by clicking outside the view
- Scrollbar, when dragging thumb, the arrows aren't highlighted.
- UIControlsHelper works when scaled
- Scrollable area depth masks are now sliced sprites (easily scaled)
- Scrollbar "bar" is a sliced sprite.
- tk2dUIItem doesn't require a collider any more, sphere colliders can be set up.
- textinput password option with configureable character.
- fixed bug where clicking on the next textinput (on mobile) will enter text in both.
- scrollable area option to set value without event.
- in scrollable area, when setting content length programatically, if content length < visible length, scrollbar is hidden.
- tk2dUI prefix on all classes (finalized)
- tk2dUITime is now a static class
- scrollable area snapback uses velocity
- click + hold scrollbar arrow to scroll continuously
- now possible to change toggle buttons at runtime
- scrollbar editor widget corrected and shows thumb size
- editor widgets show extended line when being used, easier to position and tweak correctly.