Facets: Difference between revisions

Revision as of 02:05, 21 July 2024

Facets are a modular system made from UIX allowing the user to customize the user interface of the Dash Menu, including the Facet Anchors.

Basic functionality

Facets are currently not editable in Desktop Mode. A GitHub issue #628 is open to track the status of that feature.

UI Edit Mode

To be able to move, remove, and place facets onto your Dash Menu, you will need to enable UI Edit Mode.

You can toggle UI Edit Mode in several ways:

This can be done in the "User Interface" section of the settings.
Using your controllers, hold down the dash menu button on one side of the controllers, and the other side you double tap the dash button.
Using a community-made facets to toggle this mode (there are several out there).
Using a the 3D Dash On Screen Mod made by rampa3, pressing the F4 key will allow you to toggle UI Edit Mode.

Mods are not officially supported. All issues must be reported to the mod creator.

Basic Facets

By default, the Dash Menu comes with a variety of facets in the home, worlds, settings, migration tabs.

You can find those default facets in the Resonite Essentials public folder.

Creating facets from settings

While having UI Edit Mode enabled, you can grab the six dots at the right of any setting to transform it into a facet you can place onto your Dash Menu or Facet Anchors.

Facet Anchors

Added in the version Beta 2024.5.28.94, facet anchors allow users to snap facets to their hands, forearms, and in front of their view, to create quick shortcuts to certain settings and other facets.

When enabled in the User Interface section of the settings, facet anchors can be toggled via the dash button on the controller of choice of the user (set in the same setting category).

Creating Facets

The sample facet created using the dev tool.

Facets are created using UIX. There is a sample facet to get you started. Use the Dev Tool and open the Create New Wizard and select Object -> Facet.

@@ Line 1: / Line 1: @@
-{{stub}}
+'''Facets''' are a modular system made from [[UIX]] allowing the [[User|user]] to customize the user interface of the [[Dash Menu]], including the [[Facets#Facet Anchors|Facet Anchors]].
-Facets are a modular system allowing you to customise the user interface of the [[Dash Menu]] amongst others.
 == Basic functionality ==
-{{Note|Facets are currently not editable in Desktop Mode. A [https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/628 GitHub issue is open] to track the status of that feature.|warning}}
+{{Note|Facets are currently not editable in Desktop Mode. A [https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/628 GitHub issue #628] is open to track the status of that feature.|warning}}
 === UI Edit Mode ===
-To be able to remove, move and place facets onto your Dash Menu, you will need to enable UI Edit Mode.
+To be able to move, remove, and place facets onto your Dash Menu, you will need to enable UI Edit Mode.
+You can toggle UI Edit Mode in several ways:
+* This can be done in the "User Interface" section of the [[Settings|settings]].
+* Using your controllers, hold down the dash menu button on one side of the controllers, and the other side you double tap the dash button.
+* Using a community-made facets to toggle this mode (there are several out there).
+* Using a the [https://github.com/rampa3/3DDashOnScreen 3D Dash On Screen Mod] made by [[User:rampa3|rampa3]], pressing the <code>F4</code> key will allow you to toggle UI Edit Mode.
-This can be done in the "User Interface" section of the [[Settings|settings]].
+{{Mod Warning}}
 === Basic Facets ===
-By default, the Dash Menu comes with a variety of facets in the home, worlds and settings tab.
+By default, the Dash Menu comes with a variety of facets in the home, worlds, settings, migration tabs.
 You can find those default facets in the [[List_of_Public_Folders#Resonite_Essentials|Resonite Essentials public folder]].
@@ Line 25: / Line 29: @@
 == Facet Anchors ==
-Added in the version [[Beta 2024.5.28.94]], facet anchors allow users to snap facets to their hands and forearms, to create quick shortcuts to certain settings and other facets.
+Added in the version [[Beta 2024.5.28.94]], facet anchors allow users to snap facets to their hands, forearms, and in front of their view, to create quick shortcuts to certain settings and other facets.
+When enabled in the User Interface section of the settings, facet anchors can be toggled via the dash button on the controller of choice of the user (set in the same setting category).
+== Creating Facets ==
+[[File:FacetSample.png|alt=The sample facet created using the dev tool.|thumb|The sample facet created using the dev tool.]]
-When enabled in the User Interface section of the settings, facet anchors are can be toggled via the dash button on the controller of choice of the user (set in the same setting category).
+Facets are created using [[UIX]]. There is a sample facet to get you started. Use the [[Dev Tool]] and open the [[Create New Wizard]] and select Object -> Facet.
 == See Also ==