Component:BooleanUserOverrideGather

From Resonite Wiki
Revision as of 17:49, 16 October 2024 by 989onan (talk | contribs) (this is far from a component stub lol)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

The BooleanUserOverrideGather Component allows storing Boolean "override" values for each user listed under _overrides and driving the Target field. The behavior is similar to ValueUserOverride<Bool>, except this component also reports aggregate information about the overrides.

Component image 
Boolean User Override Gather component as seen in the Scene Inspector


Usage

Fields
Name Type Description
persistent Bool Determines whether or not this item will be saved to the server.
UpdateOrder Int Controls the order in which this component is updated.
Enabled Bool Controls whether or not this component is enabled.
Default Bool The default value given to Target if no suitable override exists in _overrides.
CreateOverrideOnWrite Bool Whether an entry in _overrides should be created when Target is written back.
PersistentOverrides Bool Whether values in _overrides should persist when the component is saved.
_overrides direct SyncBag`1<Override<Bool>> A Bag of the Boolean Overrides and the corresponding UserRef they apply to.
Target field drive of Bool Reference to the field that gets driven to the override value.
Any raw output of Bool Reports true when any user in the session would have their override be true (either from the default value or an override).
All raw output of Bool Reports true when all users in the session would have their override be true (either from the default value or an override).
None raw output of Bool Reports true when none of the users in the session would have their override be true (either from the default value or an override).
TrueCount raw output of Int Reports the total count of true values for all users in the session.
FalseCount raw output of Int Reports the total count of false values for all users in the session.

Note that the reporting fields (Any, All, None, TrueCount and FalseCount) count only the values for users in the sessions (including away users and headless servers), but not all the values in the _overrides list.

Override

Fields
Name Type Description
User UserRef The User that should see Value's content inside of Target locally instead of Default's content.
Value Bool The Boolean value that User should see target driven to locally.


Behavior

The _overrides bag contains a list of users and their associated Boolean values - whenever the local user matches a user entry in the bag, the associated value is driven to Target. Otherwise, Target is driven to the value in Default.

CreateOverrideOnWrite allows for new users and values to be added to the bag when the driven value in Target is directly or indirectly changed by that user. If it is not enabled, the value in Target is not changeable unless the override is added or changed manually from the inspector panel.

Attempting to write to or otherwise cause a discrete entry to a driven field is known as Hooking it. Any Hook to the Target value is intercepted by the BooleanUserOverrideGather Component and will change the modifying user's entry in the _overrides bag. If there is no entry for the user and if CreateOverrideOnWrite is enabled, it will create an entry using the set value.

Examples

Related Components