Tag: Difference between revisions

From Resonite Wiki
Added tagging for slot subsection.
Added information when a child/parent slot is created under a tagged slot.
 
(6 intermediate revisions by 2 users not shown)
Line 4: Line 4:


Tags can be used as a simple label, or it can be part of a complex system. Tags can also be swapped for other tags through [[ProtoFlux]], especially when [[Drive|driving]] a receiver. Here are the following things that require tags:
Tags can be used as a simple label, or it can be part of a complex system. Tags can also be swapped for other tags through [[ProtoFlux]], especially when [[Drive|driving]] a receiver. Here are the following things that require tags:
* Slots have a tag [[Field|field]]
* Slots have a tag [[Field|field]]
{{Note|When a slot has a tag set and a child is created under the tagged slot, that child slot also will have the same tag. Similarly, when a parent is made from a child slot while still under the tagged slot, it too will have the same tag. The only time this is different is when you make a parent slot from a tagged slot, then the new parent has a null tag (unless under a slot that has a tag filled in).|information}}
=== ProtoFlux ===
There are a few [[ProtoFlux]] nodes that can access & modify the tag field. Here is a list of those nodes:
* [[ProtoFlux:Dynamic Impulse Receiver|Dynamic Impulse Receiver]] node (including the [[ProtoFlux:Async Dynamic Impulse Receiver|Async variant]])
* [[ProtoFlux:Dynamic Impulse Receiver|Dynamic Impulse Receiver]] node (including the [[ProtoFlux:Async Dynamic Impulse Receiver|Async variant]])
* [[ProtoFlux:Dynamic Impulse Trigger|Dynamic Impulse Trigger]] node (including the [[ProtoFlux:Async Dynamic Impulse Trigger|Async variant]])
* [[ProtoFlux:Dynamic Impulse Trigger|Dynamic Impulse Trigger]] node (including the [[ProtoFlux:Async Dynamic Impulse Trigger|Async variant]])
Line 12: Line 20:
* [[ProtoFlux:Get Tag|Get Tag]] node
* [[ProtoFlux:Get Tag|Get Tag]] node
* [[ProtoFlux:Set Tag|Set Tag]] node
* [[ProtoFlux:Set Tag|Set Tag]] node
=== World MetaData Tags ===
[[World|Worlds]] can have tags that help with searching and organizing worlds in the [[World Browser]] in the [[Dash]]. [[MMC]] uses this feature to help with the world submissions and categories during the competition.


=== Rich Text Formatting ===
=== Rich Text Formatting ===


[[Rich Text Formatting]] (also known as '''RTF''') tags are used to change how the text renders.
[[Text Formatting|Rich Text Formatting]] (also known as '''RTF''') tags are used to change how the text renders.


=== Haptics ===
=== Haptics ===
Line 37: Line 49:
* [[Component:TeleportPassthrough|TeleportPassthrough]] component
* [[Component:TeleportPassthrough|TeleportPassthrough]] component
* [[Component:TeleportSurface|TeleportSurface]] component
* [[Component:TeleportSurface|TeleportSurface]] component
Similarly, there is the <code>Assets</code> -> <code>Tagging</code> category that contains the following components:
* [[Component:HierarchyMaterialTarget|HierarchyMaterialTarget]] component
* [[Component:MaterialApplyPolicy|MaterialApplyPolicy]] component
* [[Component:MaterialRelay|MaterialRelay]] component
* [[Component:MeshRendererMaterialRelay|MeshRendererMaterialRelay]] component


== Why Use Tags ==
== Why Use Tags ==
Line 47: Line 65:


{{Note|Currently the [[Component:DelegateTag|Delegate Tag]] Component will crash [[User|users]] in the world when there is an invalid input! [https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/919 DelegateTag With Invalid Type Makes World Unjoinable - Issue 919]|danger}}
{{Note|Currently the [[Component:DelegateTag|Delegate Tag]] Component will crash [[User|users]] in the world when there is an invalid input! [https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/919 DelegateTag With Invalid Type Makes World Unjoinable - Issue 919]|danger}}
== Default Tags ==
Some items and slots have default tags for your convenience (or sometimes left there by the [[Team|Dev Team]]). Here are some notable items that contain default tags:
* The [[Scene Inspector]], [[User Inspector]], [[Create New Wizard]], [[ProtoFlux Node Browser]], [[Module Snapping Tool]], & [[Avatar Creator]] has a default tag of <code>Developer</code>.
* The [[Dev Tool]], [[Material Tool]], [[Glue Tool]], [[Character Collider Setter Tool]], [[Mesh Visibility Tool]], [[Mesh Tool]], [[Rig Mesh Transfer Tool]], [[Object Slicer Tool]], [[Meter Tool]], [[World Submitter]], [[Twitch Chat]], The [[Raw File]] visual slot, & [[SupporterWall]] has a default tag, but it is an empty string, not a null string for the tag field.
* The [[Geometry Line Brush]] (Default, Highlighter, Screen Mode) has the default Tag of <code>User</code>.
* The [[Camera]] from the [[Resonite Essentials]] [[Public Folders|public folder]] and streaming camera has the default tag of <code>Media.interactive_camera</code>.
* The default [[Resonite Keyboard|Keyboard]] has the default tag of <code>Userspace.Keyboard</code>.
* The default [[Audio Stream Controller]] has the default tag of <code>Media.user_audio_stream</code>.
* The default [[Color Dialog]] has the default tag of <code>Interface.user_color_dialog</code>.
* The default [[Text Display]] has the default tag of <code>Media.text_import</code>.
* The default [[Url Display]] has the default tag of <code>Media.hyperlink_dialog</code>.
* The default [[Notice Display]] has the default tag of <code>Info.notice_display</code>.
* The default [[Audio Player]] has the default tag of <code>Media.user_audio_player</code>.
* The default [[Video Player]] has the default tag of <code>Media.user_media_player</code>.
* The [[Dawn Modular]] pieces each have a slot hierarchy that lists off their snap points, matching the default tag to their slot name.
* The default [[Avatar]] has the default tag of <code>PlatformRootLayer</code>.
* The [["Reso" Deck]] found in <code>[[Resonite Essentials]]</code> -> <code>Games</code> -> <code>Tabletop Games</code>, has cards that have the tag <code>Card</code> for each card in the deck.
=== Trivia ===
* The [[Full Body Tracking|Full Body Calibrator]] slot <code>Ground Control</code> has the default tag of <code>To Major Tom</code>, an easter egg to the song "David Bowie – Space Oddity".
<youtube>iYYRH4apXDo</youtube>

Latest revision as of 01:24, 28 March 2025

Tags are Strings that Resonite uses to label slots, Dynamic Variables (Triggers & Receivers), and other objects that require a tag.

How To Use

Tags can be used as a simple label, or it can be part of a complex system. Tags can also be swapped for other tags through ProtoFlux, especially when driving a receiver. Here are the following things that require tags:

When a slot has a tag set and a child is created under the tagged slot, that child slot also will have the same tag. Similarly, when a parent is made from a child slot while still under the tagged slot, it too will have the same tag. The only time this is different is when you make a parent slot from a tagged slot, then the new parent has a null tag (unless under a slot that has a tag filled in).

ProtoFlux

There are a few ProtoFlux nodes that can access & modify the tag field. Here is a list of those nodes:

World MetaData Tags

Worlds can have tags that help with searching and organizing worlds in the World Browser in the Dash. MMC uses this feature to help with the world submissions and categories during the competition.

Rich Text Formatting

Rich Text Formatting (also known as RTF) tags are used to change how the text renders.

Haptics

There are tags for the Haptics system which allow for more control when using these devices. Here is a list relating to tags:

Tagging For Slots

Sometimes you need to mark a slot to have a certain effect to it, there are components that do that found in Transform -> Tagging within the component browser. Here is a list of them:

Similarly, there is the Assets -> Tagging category that contains the following components:

Why Use Tags

(ToDo)

Unknown Tags

Currently the Delegate Tag Component will crash users in the world when there is an invalid input! DelegateTag With Invalid Type Makes World Unjoinable - Issue 919

Default Tags

Some items and slots have default tags for your convenience (or sometimes left there by the Dev Team). Here are some notable items that contain default tags:

Trivia

  • The Full Body Calibrator slot Ground Control has the default tag of To Major Tom, an easter egg to the song "David Bowie – Space Oddity".