Component:CloudValueField: Difference between revisions

From Resonite Wiki
add info
move from `1
Tag: Removed redirect
 
(One intermediate revision by one other user not shown)
Line 2: Line 2:
<translate>
<translate>
<!--T:1-->
<!--T:1-->
{{stub}}
{{Infobox Component
{{Infobox Component
|Image=CloudValueField`1Component.png
|Image=CloudValueField`1Component.png
|Name=Cloud Value Field`1
|Name=CloudValueField<T>
}}
}}
For more info on how Cloud Variables work in general, see [[Cloud Variables]].


This updates as fast as reading/writing cloud variables permits. All the restrictions that apply to cloud variables apply to this component, including permissions and world contexts.
The '''CloudValueField<T>''' component links a [[field]] of type '''T''' to a cloud variable.


This component constantly writes the contents of the field specified by <code>Target</code> to the value of the specified cloud variable.  
For more info on how Cloud Variables work in general, see [[Cloud Variables]].


<!--T:2-->
<!--T:2-->
== Fields ==
== Fields ==
{{Table ComponentFields
{{Table ComponentFields
|Path|String| The cloud variable path to read from, this needs to start with a UserID.
|Path|String| The [[Cloud_Variables#Cloud_Variable_Definition| path]] of the variable this component will read.
|IsLinkedToCloud|Bool| Whether the variable exists or not.
|IsLinkedToCloud|Bool| ''(Read Only)'' Indicates whether this field was successfully bound to the target variable.
|VariableOwnerId|String| The UserID of the user that created the variable.
|VariableOwnerId|String| The UserID of the user that made a definition for the variable specified by <code>Path</code>
|ChangeHandling|CloudVariableChangeMode| See [[Type:CloudVariableChangeMode|Cloud Variable Change Mode]].
|ChangeHandling|CloudVariableChangeMode| See [[Type:CloudVariableChangeMode|Cloud Variable Change Mode]].
|Target|IField`1|TypeString4=IField<float>| The field which to change the contents of to the value of the cloud variable.
|Target|{{RootFieldType|RelayRef`1|[[Type:IField`1|IField`1]]&lt;T&gt;}}|TypeAdv4=true| The target [[Type:IField`1| field]] to which the variable value will be written.
}}
}}


<!--T:3-->
<!--T:3-->
== Usage ==
== Usage ==
Put this component on a slot, and give it a valid cloud variable <code>Path</code> and <code>VariableOwnerId</code>. For how to get a valid path and id, see [[Cloud Variables]]. when given a <code>Target</code>, the contents of the field given to <code>Target</code> will auto update with the cloud variable value.
Put this component on a slot, and give it a valid cloud variable <code>Path</code> and <code>VariableOwnerId</code>. When given a <code>Target</code>, the contents of the field given to <code>Target</code> will auto update with the cloud variable value. Depending on the value of <code>ChangeHandling</code> and <code>VariableOwnerId</code>, the cloud variable may be updated through this component as well.
 
This updates as fast as reading/writing cloud variables permits. All the restrictions that apply to cloud variables apply to this component, including permissions and world contexts.


<!--T:4-->
<!--T:4-->
Line 31: Line 31:


<!--T:5-->
<!--T:5-->
== Related Components ==
== See Also ==
* [[Cloud Variables]]
* [[Component:CloudValueVariable]]
* [[Component:ActiveUserCloudField]]
* [[Component:ActiveUserCloudValueVariable]]
* [[Component:CloudValueVariableDriver]]
</translate>
</translate>
[[Category:Generics{{#translation:}}]]
[[Category:Generics{{#translation:}}]]
[[Category:Components{{#translation:}}|Cloud Value Field`1]]
[[Category:Components{{#translation:}}|Cloud Value Field`1]]
[[Category:Generic Components{{#translation:}}|Cloud Value Field`1]]
[[Category:Components:Cloud:Variables{{#translation:}}|Cloud Value Field`1]]
[[Category:Components:Cloud:Variables{{#translation:}}|Cloud Value Field`1]]

Latest revision as of 12:24, 11 November 2024

Component image 
CloudValueField<T> component as seen in the Scene Inspector


The CloudValueField<T> component links a field of type T to a cloud variable.

For more info on how Cloud Variables work in general, see Cloud Variables.

Fields

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.
Path String The path of the variable this component will read.
IsLinkedToCloud Bool (Read Only) Indicates whether this field was successfully bound to the target variable.
VariableOwnerId String The UserID of the user that made a definition for the variable specified by Path
ChangeHandling CloudVariableChangeMode See Cloud Variable Change Mode.
Target direct RelayRef`1<IField`1<T>> The target field to which the variable value will be written.

Usage

Put this component on a slot, and give it a valid cloud variable Path and VariableOwnerId. When given a Target, the contents of the field given to Target will auto update with the cloud variable value. Depending on the value of ChangeHandling and VariableOwnerId, the cloud variable may be updated through this component as well.

This updates as fast as reading/writing cloud variables permits. All the restrictions that apply to cloud variables apply to this component, including permissions and world contexts.

Examples

See Also