Component:OSC Field: Difference between revisions

Revision as of 20:01, 30 April 2024

Component image

This article or section is a Stub. You can help the Resonite Wiki by expanding it.

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. Some components stop their functionality when this field is disabled, but some don't.
`Handler`	OSC_Handler	The Component:OSC_Receiver or Component:OSC_Sender to be used with this component.
`Path`	String	The OSC Path for this value.
`ArgumentIndex`	Int	For Multi-Dimensional OSC Values, this specifies which value to retrieve or send.
`Field`	direct RelayRef`1<IField`1<T>>	The Field to store the value in.

Behavior

Receiving

When Handler, is set to a valid and IsListening, OSC Reciever, if OSC Data is found at the specified Path. The value from OSC will be set on the Field specified.

Sending

When Handler, is set to a valid, OSC Sender.

If the SendMode of the OSC_Receiver, is set to SendAsBundles, then it will bundle up all other OSC Value component's values and send them all as a bundle.

If the SendMode of the OSC_Receiver, is set to SendIndividually, then Resonite will send the value within the specified Field, as an OSC message on the OSC Path in Path.

Resonite will send data each time it changes or again every AutoResendInterval on the OSC_Sender.

Examples

See OSC

@@ Line 7: / Line 7: @@
 == Usage ==
 {{Table ComponentFields
-|Handler|OSC_Handler|
+|Handler|OSC_Handler|The [[Component:OSC_Receiver]] or [[Component:OSC_Sender]] to be used with this component.
-|Path|String|
+|Path|String|The OSC Path for this value.
-|ArgumentIndex|Int|
+|ArgumentIndex|Int|For Multi-Dimensional OSC Values, this specifies which value to retrieve or send.
-|Field|{{RootFieldType|RelayRef`1|[[Type:IField`1|IField`1]]&lt;T&gt;}}|TypeAdv3=true|
+|Field|{{RootFieldType|RelayRef`1|[[Type:IField`1|IField`1]]&lt;T&gt;}}|TypeAdv3=true|The Field to store the value in.
 }}
 == Behavior ==
+=== Receiving ===
+When <code>Handler</code>, is set to a valid and <code>IsListening</code>, [[Component:OSC_Receiver|OSC Reciever]], if [[OSC]] Data is found at the specified <code>Path</code>. The value from OSC will be set on the Field specified.
+=== Sending ===
+When <code>Handler</code>, is set to a valid, [[Component:OSC_Sender|OSC Sender]].
+If the <code>SendMode</code> of the [[Component:OSC_Receiver|OSC_Receiver]], is set to <code>SendAsBundles</code>, then it will bundle up all other OSC Value component's values and send them all as a bundle.
+If the <code>SendMode</code> of the [[Component:OSC_Receiver|OSC_Receiver]], is set to <code>SendIndividually</code>, then Resonite will send the value within the specified <code>Field</code>, as an OSC message on the OSC Path in <code>Path</code>.
+Resonite will send data each time it changes or again every <code>AutoResendInterval</code> on the [[Component:OSC_Sender|OSC_Sender]].
 == Examples ==
+* See [[OSC]]
 == See Also ==
 [[Category:Components:Network:OSC{{#translation:}}|OSC Field`1]]