Détail du package

io.extendreality.tilia.interactions.spatialbuttons.unity

ExtendRealityLtd3kMIT2.3.33

User interface button types that can be used within a spatial environment for the Unity software.

interactions, buttons, pointers, ui

readme

Tilia logo

Interactions -> Spatial Buttons for the Unity Software

User interface button types that can be used within a spatial environment for the Unity software.

Release License Backlog

Introduction

The Spatial Button prefabs provide the ability to add spatial user interface button elements to a scene that can be interacted with via an Object Pointer.

The included Spatial Button prefabs are:

  • Interactions.SpatialButton.ClickButton - A simple button that is clicked and automatically unclicks.
  • Interactions.SpatialButton.ToggleButton - A button that is toggled on and off whenever it is clicked.
  • Interactions.SpatialButton.OptionButton - A button that is used as a group of other options buttons where only one can be selected.
  • Interactions.SpatialButton.Group - A container for Spatial Buttons to group them under a single, distinct dispatcher (required for Interactions.SpatialButton.OptionButton).

Requires the Unity software version 2018.3.10f1 (or above).

Getting Started

Please refer to the installation guide to install this package.

Documentation

Please refer to the How To Guides for usage of this package.

Further documentation can be found within the Documentation directory and at https://academy.vrtk.io

Contributing

Please refer to the Extend Reality Contributing guidelines and the project coding conventions.

Code of Conduct

Please refer to the Extend Reality Code of Conduct.

License

Code released under the MIT License.

changelog

Changelog

2.3.33 (2024-09-28)

Miscellaneous Chores

2.3.32 (2024-09-28)

Miscellaneous Chores

2.3.31 (2024-09-28)

Miscellaneous Chores

2.3.30 (2024-05-11)

Miscellaneous Chores

2.3.29 (2024-05-11)

Miscellaneous Chores

2.3.28 (2024-05-11)

Miscellaneous Chores

2.3.27 (2024-05-11)

Miscellaneous Chores

2.3.26 (2024-05-11)

Bug Fixes

  • Editor: disable custom inspector if ignore custom editor is set (3095278)

    If the ZINNIA_IGNORE_CUSTOM_INSPECTOR_EDITOR ifdef is set then the custom editor must also be disabled otherwise an error will occur.

2.3.25 (2024-04-17)

Miscellaneous Chores

2.3.24 (2024-04-17)

Miscellaneous Chores

2.3.23 (2024-04-17)

Miscellaneous Chores

2.3.22 (2023-07-10)

Miscellaneous Chores

2.3.21 (2023-07-10)

Miscellaneous Chores

2.3.20 (2023-07-10)

Miscellaneous Chores

2.3.19 (2023-07-08)

Miscellaneous Chores

2.3.18 (2023-07-08)

Miscellaneous Chores

2.3.17 (2023-07-08)

Miscellaneous Chores

2.3.16 (2023-07-05)

Miscellaneous Chores

2.3.15 (2023-07-05)

Miscellaneous Chores

2.3.14 (2023-07-05)

Miscellaneous Chores

2.3.13 (2023-06-14)

Miscellaneous Chores

2.3.12 (2023-06-14)

Miscellaneous Chores

2.3.11 (2023-05-06)

Miscellaneous Chores

2.3.10 (2023-05-06)

Miscellaneous Chores

2.3.9 (2023-05-06)

Miscellaneous Chores

2.3.8 (2023-05-02)

Miscellaneous Chores

2.3.7 (2023-05-02)

Miscellaneous Chores

2.3.6 (2023-05-02)

Miscellaneous Chores

2.3.5 (2023-05-02)

Miscellaneous Chores

2.3.4 (2023-05-02)

Miscellaneous Chores

2.3.3 (2023-04-16)

Miscellaneous Chores

2.3.2 (2023-04-16)

Miscellaneous Chores

2.3.1 (2023-04-16)

Miscellaneous Chores

2.3.0 (2023-04-04)

Features

  • Resources: add multiple render pipeline materials (c530247)

    The prefab now uses the Pipeline Material Applier to provide multiple material types for the main render pipelines to improve compatibility.

2.2.25 (2023-04-04)

Miscellaneous Chores

2.2.24 (2023-04-03)

Miscellaneous Chores

2.2.23 (2023-04-03)

Miscellaneous Chores

2.2.22 (2023-04-03)

Miscellaneous Chores

2.2.21 (2023-03-28)

Miscellaneous Chores

2.2.20 (2023-03-28)

Miscellaneous Chores

2.2.19 (2023-03-28)

Miscellaneous Chores

2.2.18 (2023-03-28)

Miscellaneous Chores

2.2.17 (2023-03-21)

Miscellaneous Chores

2.2.16 (2023-03-21)

Miscellaneous Chores

2.2.15 (2023-03-21)

Miscellaneous Chores

2.2.14 (2023-03-16)

Miscellaneous Chores

2.2.13 (2023-03-16)

Miscellaneous Chores

2.2.12 (2023-03-16)

Miscellaneous Chores

2.2.11 (2023-03-13)

Miscellaneous Chores

2.2.10 (2023-03-13)

Miscellaneous Chores

2.2.9 (2023-03-13)

Miscellaneous Chores

2.2.8 (2023-03-11)

Miscellaneous Chores

2.2.7 (2023-03-11)

Miscellaneous Chores

2.2.6 (2023-03-11)

Miscellaneous Chores

2.2.5 (2023-02-22)

Miscellaneous Chores

2.2.4 (2023-02-22)

Miscellaneous Chores

2.2.3 (2023-02-21)

Bug Fixes

  • Editor: move both action buttons into same group (b7a7fda)

    The Copy Text and Size button and the Preview Style button have now been moved into the same GroupBox group as this looks neater.

  • Materials: swap button shader to mobile friendly version (65a6ea4)

    The standard unity particle shaders do not behave well on mobile devices such as the oculus quest so the shader has been switched out on the SpatialButton material to the Tilia vertex unlit shader.

    The style setting code has been updated now to just use a simple shared material color set as this seems to work for all shaders.

2.2.2 (2023-02-19)

Miscellaneous Chores

2.2.1 (2023-02-08)

Miscellaneous Chores

2.2.0 (2022-07-04)

Features

  • package.json: bump textmeshpro to latest version (3e8f901)

    Bump the version of text mesh pro to the latest.

2.1.0 (2022-07-04)

Features

  • Editor: add custom buttons for facade (563bd2e)

    A new custom inspector editor has been added for the Spatial Button Facade that renders a Copy Text and Size button that will copy the text and font size from the enabled inactive style to all the other states to make it easier to update.

    There is also a Preview Style button that will apply the styles in the editor so it is easy to see what the button looks like without needing to run the scene in play mode.

2.0.10 (2022-06-19)

Miscellaneous Chores

2.0.9 (2022-06-16)

Miscellaneous Chores

2.0.8 (2022-06-16)

Miscellaneous Chores

2.0.7 (2022-05-20)

Miscellaneous Chores

2.0.6 (2022-05-20)

Miscellaneous Chores

2.0.5 (2022-05-09)

Miscellaneous Chores

2.0.4 (2022-05-02)

Miscellaneous Chores

2.0.3 (2022-04-28)

Bug Fixes

  • SpatialButtonFacade: make ObjectReference setter private (6646f72)

    The ObjectReference Container property should have a protected setter as it is only for use within the Unity Editor and should not be able to be set via code.

2.0.2 (2022-04-28)

Miscellaneous Chores

2.0.1 (2022-04-28)

Miscellaneous Chores

2.0.0 (2022-04-28)

:warning: BREAKING CHANGES :warning:

  • Malimbe: This removes the last remaining elements of Malimbe and whilst it does not cause any breaking changes within this package, it removes Malimbe as a dependency which other projects that rely on this package may piggy back off this Malimbe dependency so it will break any project like that.

All of the previous functionality from Malimbe has been replicated in standard code without the need for it to be weaved by the Malimbe helper tags. (c7c877f)

Features

  • Malimbe: remove malimbe dependency (c7c877f)

1.4.5 (2022-03-15)

Miscellaneous Chores

1.4.4 (2022-03-15)

Miscellaneous Chores

1.4.3 (2022-03-15)

Miscellaneous Chores

1.4.2 (2022-03-02)

Miscellaneous Chores

1.4.1 (2022-03-02)

Miscellaneous Chores

1.4.0 (2022-03-02)

Features

  • package.json: add information urls to package (85e5183)

    The changelog, documentation and license url has been added to the package.json as these are used within the Unity package manager.

1.3.31 (2022-02-14)

Miscellaneous Chores

1.3.30 (2022-02-14)

Miscellaneous Chores

1.3.29 (2022-02-05)

Miscellaneous Chores

1.3.28 (2022-02-05)

Miscellaneous Chores

1.3.27 (2022-01-17)

Miscellaneous Chores

1.3.26 (2022-01-17)

Miscellaneous Chores

1.3.25 (2022-01-13)

Miscellaneous Chores

1.3.24 (2022-01-13)

Miscellaneous Chores

1.3.23 (2022-01-13)

Miscellaneous Chores

1.3.22 (2022-01-13)

Miscellaneous Chores

1.3.21 (2022-01-12)

Miscellaneous Chores

1.3.20 (2022-01-12)

Miscellaneous Chores

1.3.19 (2022-01-03)

Miscellaneous Chores

1.3.18 (2022-01-03)

Miscellaneous Chores

1.3.17 (2021-12-03)

Miscellaneous Chores

1.3.16 (2021-11-16)

Bug Fixes

  • HowToGuides: update project link to correct package (89c26bf)

    The Adding A Click Button guide contains the incorrect wording to the package installation guide. It should be installing the Spatial Buttons package and not the Spatial Targets package.

1.3.15 (2021-07-21)

Miscellaneous Chores

1.3.14 (2021-07-21)

Miscellaneous Chores

1.3.13 (2021-07-19)

Miscellaneous Chores

1.3.12 (2021-07-19)

Miscellaneous Chores

1.3.11 (2021-06-24)

Miscellaneous Chores

1.3.10 (2021-06-19)

Miscellaneous Chores

1.3.9 (2021-06-10)

Miscellaneous Chores

1.3.8 (2021-06-10)

Miscellaneous Chores

1.3.7 (2021-05-09)

Miscellaneous Chores

1.3.6 (2021-05-09)

Miscellaneous Chores

1.3.5 (2021-05-03)

Miscellaneous Chores

1.3.4 (2021-05-03)

Miscellaneous Chores

1.3.3 (2021-04-15)

Miscellaneous Chores

1.3.2 (2021-04-07)

Miscellaneous Chores

1.3.1 (2021-04-07)

Miscellaneous Chores

1.3.0 (2021-04-07)

Features

  • Utility: add prefab creator (9027964)

    The latest version of Zinnia has the basis of a prefab creator that can be used to enable easy adding of prefabs to a scene without needing to drag and drop from directories. Instead a new menu item is added for quickly adding prefabs. The guide has been updated to accommodate this and the FodyWeavers.xml is now located in the root to serve both the Runtime and Editor scripts.

Bug Fixes

  • package.json: add missing reference to Editor directory (432c3d9)

    The build will fail without referencing this new Editor directory so it has now been added to the package.

1.2.11 (2021-03-29)

Bug Fixes

  • package.json: reduce textmeshpro version for older Unity vrsions (4c39188)

    TextMeshPro is only supported up to v1.3.0 on older versions of Unity so this should be the base installed version and should be left to be manually updated in newer versions of unity.

1.2.10 (2021-03-29)

Bug Fixes

  • package.json: bump textmeshpro to latest version (42e944c)

    The version of Text Mesh Pro has been updated to a much newer version.

1.2.9 (2021-03-29)

Miscellaneous Chores

1.2.8 (2021-03-29)

Miscellaneous Chores

1.2.7 (2021-03-03)

Miscellaneous Chores

1.2.6 (2021-03-03)

Miscellaneous Chores

1.2.5 (2021-02-27)

Miscellaneous Chores

1.2.4 (2021-02-27)

Miscellaneous Chores

1.2.3 (2021-02-07)

Bug Fixes

  • prefabs: force apply TextMeshPro styles when state is enabled (bfb0f88)

    There is an issue in later versions of Unity where if the TextMeshPro component is not enabled in the scene then it does not apply the state styles to the TextMeshPro component. This fix uses a BehaviourEnabledObserver to check to see whtn the TextMeshPro for each style is enabled and then force applies the styles.

1.2.2 (2021-02-06)

Bug Fixes

  • prefabs: allow option group buttons to be touched on and off (8a9d091)

    There was an issue where Option buttons would not toggle each other on and off because the Select action was going through the SpatialTarget and an Option group needs the Spatial Dispatcher to dispatch the Select action so it knows which other buttons to dispatch the Deselect action to.

    The SpatialButton.OptionButton prefab now uses the SpatialButtonConfigurator Select action as this goes through the correct dispatcher when dealing with button groups.

1.2.1 (2021-02-04)

Miscellaneous Chores

1.2.0 (2021-02-04)

Features

  • prefabs: add ability to touch spatial buttons with objects (8037bec)

    The new CollidableObjects property allows any specified object to interact with the spatial button, so if Interactors are added to it then they will be able to touch the button and the hover state is controller by the larger trigger collider.

1.1.1 (2021-01-31)

Miscellaneous Chores

1.1.0 (2021-01-11)

Features

  • HowToGuides: add guide for option buttons (2df0363)

    A new guide has been added showing how to create a group of option buttons.

  • HowToGuides: add guide for toggle button (e24eb0d)

    A new guide has been added showing how to add a toggle button and also how to use the Spatial Target Processor along with the Button Groups to make this guide a bit more worthwhile.

  • HowToGuides: add guide on how to add click button (714c1cb)

    A new guide has been added to show how to add a simple click button to a scene.

1.0.5 (2021-01-09)

Bug Fixes

  • prefab: ensure inner events are propagated to facade events (8aeaa90)

    The Facade events were not doing anything because the inner events had not been linked to notify the Facade to raise the event.

1.0.4 (2021-01-07)

Bug Fixes

  • HowToGuides: add step to install TextMeshPro dependencies (7f75062)

    The installation guide now includes the steps required to install the TextMeshPro depdendencies via the TMP Importer popup window.

1.0.3 (2021-01-07)

Bug Fixes

  • API: add missing API documentation (64ab7a8)

    The API docs have been auto generated for the latest changes.

1.0.2 (2021-01-07)

Bug Fixes

  • prefab: update ActiveButtonIndex when group button changes (3b327af)

    The ActiveButtonIndex property will now correctly reflect the actual selected button and not only used for the initial set.

1.0.1 (2021-01-07)

Miscellaneous Chores

1.0.0 (2021-01-06)

Features

  • SpatialButton: add prefabs for spatial button types (dd57e18)

    The new Spatial Button prefabs have been added in the following types:

    • ClickButton - a simple button that is clicked on and auto off ToggleButton - a button that is toggled on and off per click OptionButton - a button used as a group of buttons for options

    The Group prefab also allows SpatialButtons to be grouped into a distinct group to be processed via a distinct dispatcher.

  • structure: add initial documentation content (c98a364)

    The content of documentation and other supplement files has been added to the repo.