# Predefined Behaviors

# Examples Using Predefined Behaviors

<div class="contents" id="bkmrk-thermometer-example-"></div>#### Thermometer Example

1\. Drag&amp;drop a Slider Control and a Text Value Control from the Controls Panel of the Toolbox to the Scene Editor or the Scene Tree.

<div class="contents" id="bkmrk-"><div class="contents"><div class="textblock"><div drawio-diagram="2375"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217038.png" alt=""/></div>

</div></div></div>2\. Set the Slider's Minimum to "-50,00" and the maximum to "+50,00".

<div class="contents" id="bkmrk--0"><div class="contents"><div class="textblock"><div drawio-diagram="2376"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217059.png" alt=""/></div>

</div></div></div>3\. Change the Text Value Control's "Format Text" Property to "%d °C".

<div class="contents" id="bkmrk--1"><div class="contents"><div class="textblock"><div drawio-diagram="2377"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217081.png" alt=""/></div>

</div></div></div>4\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Forward Value](https://doc316en.candera.eu/link/647#bkmrk-forward-value)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) from the Behaviors Panel of the Toolbox onto the Slider in the Scene Tree.

<div class="contents" id="bkmrk--2"><div class="contents"><div class="textblock"><div drawio-diagram="2378"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217098.png" alt=""/></div>

</div></div></div>This is what the Scene Tree should look like now:

<div class="contents" id="bkmrk--3"><div class="contents"><div class="textblock"><div drawio-diagram="2379"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217109.png" alt=""/></div>

</div></div></div>5\. Select the <span style="color: rgb(230, 126, 35);">[Forward Value](https://doc316en.candera.eu/link/647#bkmrk-forward-value)</span> Behavior in the right side of the Scene Tree view. Set the <span style="color: rgb(230, 126, 35);">[Forward Value](https://doc316en.candera.eu/link/647#bkmrk-forward-value)</span> Behavior's Target Node to the Text Value Control you have added to the scene in step 1 by clicking on the magnifying glass on the right of the input field and selecting the Text Value Control in the "Choose Item" dialog.

<div class="contents" id="bkmrk--4"><div class="contents"><div class="textblock"><div drawio-diagram="2380"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217134.png" alt=""/></div>

</div></div></div>After that, the <span style="color: rgb(230, 126, 35);">[Forward Value](https://doc316en.candera.eu/link/647#bkmrk-forward-value)</span> Behavior's Properties will look as follows.

<div class="contents" id="bkmrk--5"><div class="contents"><div class="textblock"><div drawio-diagram="2381"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217146.png" alt=""/></div>

</div></div></div>6\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Value Behavior](https://doc316en.candera.eu/link/647#bkmrk-value)</span> (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) from the Behaviors Panel of the Toolbox onto the Text Value Control in the Scene Tree.

<div class="contents" id="bkmrk--6"><div class="contents"><div class="textblock"><div drawio-diagram="2382"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217166.png" alt=""/></div>

</div></div></div>7\. Select the [<span style="color: rgb(230, 126, 35);">Value Behavior</span>](https://doc316en.candera.eu/link/647#bkmrk-value) on the right side of the Scene Tree View. Set the <span style="color: rgb(230, 126, 35);">[Value Behavior](https://doc316en.candera.eu/link/647#bkmrk-value)</span>'s AcceptValueEvent Property to "true" by checking the checkbox.

<div class="contents" id="bkmrk--7"><div class="contents"><div class="textblock"><div drawio-diagram="2383"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217184.png" alt=""/></div>

</div></div></div>8\. Select the "Text Value" Control in the Scene Tree Panel and drag&amp;drop two <span style="color: rgb(230, 126, 35);">[Action on Value](https://doc316en.candera.eu/link/647#bkmrk-action-on-value)</span> Behaviors (which are <span style="color: rgb(230, 126, 35);">[Value Processing Behaviors](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) from the Behaviors Panel of the Toolbox onto the "Receivers" of the "Value Behavior" in right side of the SceneTree Panel.

<div class="contents" id="bkmrk--8"><div class="contents"><div class="textblock"><div drawio-diagram="2384"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217211.png" alt=""/></div>

</div></div></div>9\. Add a condition to the <span style="color: rgb(230, 126, 35);">[Action on Value](https://doc316en.candera.eu/link/647#bkmrk-action-on-value)</span> Behaviors you have just added by dragging&amp;dropping a <span style="color: rgb(230, 126, 35);">[Check processed Value](https://doc316en.candera.eu/link/597#bkmrk-check-processed-valu)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Condition - Control Behavior](https://doc316en.candera.eu/link/597#bkmrk-control-condition-be-0)</span>) onto each of the <span style="color: rgb(230, 126, 35);">[Action on Value](https://doc316en.candera.eu/link/647#bkmrk-action-on-value)</span> Behaviors you have just added.

<div class="contents" id="bkmrk--9"><div class="contents"><div class="textblock"><div drawio-diagram="2385"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217229.png" alt=""/></div>

</div></div></div>10\. Configure one of the Conditions to "LowerThan 0,00" and the other one to "GreaterThan 0,00".

<div class="contents" id="bkmrk--10"><div class="contents"><div class="textblock"><div drawio-diagram="2386"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217255.png" alt=""/></div>

</div></div></div>11\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> SetColor Action (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Toolbox view onto the Actions of each of the <span style="color: rgb(230, 126, 35);">[Action on Value](https://doc316en.candera.eu/link/647#bkmrk-action-on-value)</span> Behaviors in the SceneTree.

<div class="contents" id="bkmrk--11"><div class="contents"><div class="textblock"><div drawio-diagram="2387"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217282.png" alt=""/></div>

</div></div></div>12\. Set the color to Blue on the <span style="color: rgb(230, 126, 35);">[Action on Value](https://doc316en.candera.eu/link/647#bkmrk-action-on-value)</span> Behavior with the Condition <code>Lower Than 0&#44;00</code> and set the Color to Red on the <span style="color: rgb(230, 126, 35);">[Action on Value](https://doc316en.candera.eu/link/647#bkmrk-action-on-value)</span> Behavior with the Condition <code>Greater Than 0&#44;00</code>.

<div class="contents" id="bkmrk--12"><div class="contents"><div class="textblock"><div drawio-diagram="2388"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217306.png" alt=""/></div>

</div></div></div>13\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--13"><div class="contents"><div class="textblock"><div drawio-diagram="2389"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217319.png" alt=""/></div>

</div></div></div>14\. The text color of the Text Value Control displaying the temperature in degrees celcius will turn blue once the value of the slider gets lower than zero and it will turn red once the value becomes greater than zero.

<div class="contents" id="bkmrk--14"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2391"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217397.png" alt=""/></div>

</div></div></div></div>
#### Align Pivot Example

1\. Drag&amp;drop a Group from the "Nodes 2D" Panel of the Toolbox to the SceneEditor or the Scene Tree. Choose the follwing two Images from the Construction Kit (in the Solution Explorer) and drag&amp;drop them onto the Group node in the SceneTree: GaugeBmP and GaugeNeedleBmp

<div class="contents" id="bkmrk--15"><div class="contents"><div class="contents" id="bkmrk--16"><div class="contents"><div class="textblock"><div drawio-diagram="2395"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217510.png" alt=""/></div>

</div></div></div></div></div>2\. Arrange the Controls in the SceneEditor so that "GaugeNeedleBmp" is the last entry of the Group Node in the Scene Tree.

<div class="contents" id="bkmrk--17"><div class="contents"><div class="contents" id="bkmrk--18"><div class="contents"><div class="textblock"><div drawio-diagram="2396"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217525.png" alt=""/></div>

</div></div></div></div></div>3\. Select the "Pivot only" Translation tool in the toolbar and move the pivot of "GaugeBmP" to the center of the image and the pivot of "GaugeNeedleBmp" to the usual center of rotation of a gauge needle.

<div class="contents" id="bkmrk--19"><div class="contents"><div class="contents" id="bkmrk--20"><div class="contents"><div class="textblock"><div drawio-diagram="2400"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217601.png" alt=""/></div>

</div></div></div></div></div>4\. Drag&amp;drop the <span style="color: rgb(230, 126, 35);">[Align Pivot](https://doc316en.candera.eu/link/598#bkmrk-align-pivot)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) from the Toolbox view onto the Group node in the SceneTree.

<div class="contents" id="bkmrk--21"><div class="contents"><div class="contents" id="bkmrk--22"><div class="contents"><div class="textblock"><div drawio-diagram="2402"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217632.png" alt=""/></div>

</div></div></div></div></div>5\. The <span style="color: rgb(230, 126, 35);">[Align Pivot](https://doc316en.candera.eu/link/598#bkmrk-align-pivot)</span> Behavior does not have any properties to set. The pivots of the Bitmap Nodes are aligned and the result can be seen in the SceneEditor: The Needle image is positioned correctly in the Gauge image.

<div class="contents" id="bkmrk-don%27t-forget-to-rese"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2403"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217647.png" alt=""/></div>

</div><div class="textblock"><dl class="note"><dt><p class="callout info">Don't forget to reset the Translation tool to "Pivot and Object".  
</p>

<div drawio-diagram="2405"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217718.png" alt=""/></div>

</dt></dl></div></div></div></div>
#### <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Arc Align Example  
</span></span>

1\. Drag&amp;drop a Group from the "Nodes 2D" Panel of the Toolbox to the SceneEditor or the Scene Tree. And add four Text Nodes to this group by dragging&amp;dropping them onto the Group node in the SceneTree.

<div class="contents" id="bkmrk--23"><div class="contents"><div class="textblock"><div drawio-diagram="2407"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217869.png" alt=""/></div>

</div></div></div>2\. Change the texts of the Text Nodes to "Text", "Text\_1" etc. according to their names in the Scene Tree View.

<div class="contents" id="bkmrk--24"><div class="contents"><div class="textblock"><div drawio-diagram="2408"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217884.png" alt=""/></div>

</div></div></div>3\. Drag&amp;drop the <span style="color: rgb(230, 126, 35);">[Arc Align](https://doc316en.candera.eu/link/598#bkmrk-arc-align)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) from the Toolbox view onto the Group node in the SceneTree.

<div class="contents" id="bkmrk--25"><div class="contents"><div class="textblock"><div drawio-diagram="2410"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217902.png" alt=""/></div>

</div></div></div>4\. Configure the <span style="color: rgb(230, 126, 35);">[Arc Align](https://doc316en.candera.eu/link/598#bkmrk-arc-align)</span> Behavior with a radius of 50 and AngleMinMax values of 0 and 90.

<div class="contents" id="bkmrk--26"><div class="contents"><div class="textblock"><div drawio-diagram="2411"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217920.png" alt=""/></div>

</div></div></div>5\. The result can be seen in the Scene Editor view: All nodes are aligned like an arc from 0 to 90 degrees.

<div class="contents" id="bkmrk--27"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2412"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677217929.png" alt=""/></div>

</div></div></div></div>
#### <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Enable Rendering Example  
</span></span>

<div class="contents" id="bkmrk--28"></div>1\. Drag&amp;drop a TextButton Control from the Controls Panel of the Toolbox to the SceneEditor or the Scene Tree.

<div class="contents" id="bkmrk--29"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--30"><div class="contents"><div class="textblock"><div drawio-diagram="2426"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677221451.png" alt=""/></div>

</div></div></div></div></div></div>2\. Drag&amp;drop the <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) from the Toolbox view onto the TextButton node in the SceneTree. Additionally, drag&amp;drop the <span style="color: rgb(230, 126, 35);">[Enable Rendering](https://doc316en.candera.eu/link/582#bkmrk-enable-rendering)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Toolbox view onto the "Actions" field of the OnClick Behavior on the right side of the Scene Tree.

<div class="contents" id="bkmrk--31"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--32"><div class="contents"><div class="textblock"><div drawio-diagram="2427"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677221472.png" alt=""/></div>

</div></div></div></div></div></div>3\. Check the properties of the <span style="color: rgb(230, 126, 35);">[Enable Rendering](https://doc316en.candera.eu/link/582#bkmrk-enable-rendering)</span> Behavior. We want to change the visibility of the TextButton to invisible when it has been clicked (onClick), so the checkbox "Visible" has to remain unchecked.

<div class="contents" id="bkmrk--33"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--34"><div class="contents"><div class="textblock"><div drawio-diagram="2428"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677221485.png" alt=""/></div>

</div></div></div></div></div></div>4\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--35"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2429"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677221499.png" alt=""/></div>

</div></div></div></div></div></div>
#### <span style="color: rgb(0, 0, 0);">Format </span>String Example

1\. Drag&amp;drop a TextButton Control from the Controls panel and a TextNode from the "Nodes 2D" Panel of the Toolbox to the SceneEditor or the Scene Tree. Set the TextButton's Text to "Format String".

<div class="contents" id="bkmrk--36"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--37"><div class="contents"><div class="textblock"><div drawio-diagram="2430"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677221666.png" alt=""/></div>

</div></div></div></div></div></div></div></div>2\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) from the Toolbox view onto the TextNode in the SceneTree. Set the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's "AcceptValueEvent" property to true.

<div class="contents" id="bkmrk--38"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--39"><div class="contents"><div class="textblock"><div drawio-diagram="2431"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677221695.png" alt=""/></div>

</div></div></div></div></div></div></div></div>3\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Format String](https://doc316en.candera.eu/link/647#bkmrk-format-string)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-value)</span>) from the Toolbox view onto the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's Receivers.

<div class="contents" id="bkmrk--40"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--41"><div class="contents"><div class="textblock"><div drawio-diagram="2432"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677221725.png" alt=""/></div>

</div></div></div></div></div></div></div></div>4\. Set the <span style="color: rgb(230, 126, 35);">[Format String](https://doc316en.candera.eu/link/647#bkmrk-format-string)</span> Behavior's "Text" property to "Score: %0.2f", in order to represent the value as formatted string.

<div class="contents" id="bkmrk--42"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--43"><div class="contents"><div class="textblock"><div drawio-diagram="2433"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677221738.png" alt=""/></div>

</div></div></div></div></div></div></div></div>5\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Toolbox view onto the TextButton's Actions on the right side of the SceneTree view.

<div class="contents" id="bkmrk--44"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--45"><div class="contents"><div class="textblock"><div drawio-diagram="2434"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677221762.png" alt=""/></div>

</div></div></div></div></div></div></div></div>6\. Configure the <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior's Value property to datatype Int32 and value 10. Adjust the behavior's TargetNode by clicking on the magnifying glass on the right of the property.

<div class="contents" id="bkmrk--46"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--47"><div class="contents"><div class="textblock"><div drawio-diagram="2435"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677221773.png" alt=""/></div>

</div></div></div></div></div></div></div></div>7\. Set the scene's TextNode as TargetNode for the <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior: After clicking the magnifying glass in the properties panel, the "Select Item" Dialog is opened. Select the scene's TextNode and press OK.

<div class="contents" id="bkmrk--48"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--49"><div class="contents"><div class="textblock"><div drawio-diagram="2436"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677221811.png" alt=""/></div>

</div></div></div></div></div></div></div></div>8\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--50"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--51"><div class="contents"><div class="textblock"><div drawio-diagram="2437"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677221826.png" alt=""/></div>

</div></div></div></div></div></div></div></div>9\. When the TextButton is pressed, the Int32 value of 10 will be sent to the TextNode. This value is accepted by the TextNode and the behavior FormatString formats it to "Score: 10.00".

<div class="contents" id="bkmrk--52"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2438"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677221861.png" alt=""/></div>

</div></div></div></div></div></div></div>
#### <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Forward Value Example  
</span></span>

<div class="contents" id="bkmrk-1.-drag%26drop-a-slide-1"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--53"></div></div><div class="header" id="bkmrk-1.-drag%26drop-a-slide-2"><div class="header"><div class="headertitle"><div class="title">1. Drag&amp;drop a Slider Control and a Text Value Control the Controls panel and a TextNode from the Controls Panel of the Toolbox to the Scene Editor or the Scene Tree.  
</div></div></div></div><div class="header" id="bkmrk--54"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2443"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677222589.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>2\. Position the Slider Control and Text Value Control in the Scene Editor View.

<div class="contents" id="bkmrk--55"><div class="contents"><div class="contents"><div class="contents"><div class="header" id="bkmrk--56"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2444"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677222616.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>3\. Change the Text Value Control's "Format Text" Property to "Value: %d".

<div class="contents" id="bkmrk--57"><div class="contents"><div class="contents"><div class="contents"><div class="header" id="bkmrk--58"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2445"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677222688.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>4\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Forward Value](https://doc316en.candera.eu/link/647#bkmrk-forward-value)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) from the Behaviors Panel of the Toolbox onto the Slider in the Scene Tree.

<div class="contents" id="bkmrk--59"><div class="contents"><div class="contents"><div class="contents"><div class="header" id="bkmrk--60"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2446"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677222705.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>5\. Select the <span style="color: rgb(230, 126, 35);">[Forward Value](https://doc316en.candera.eu/link/647#bkmrk-forward-value)</span> Behavior in the right side of the Scene Tree view. Set the <span style="color: rgb(230, 126, 35);">[Forward Value](https://doc316en.candera.eu/link/647#bkmrk-forward-value)</span> Behavior's Target Node to the Text Value Control you have added to the scene in step 1 by clicking on the magnifying glass on the right of the input field and selecting the Text Value Control in the Choose Item dialog.

<div class="contents" id="bkmrk--61"><div class="contents"><div class="contents"><div class="contents"><div class="header" id="bkmrk--62"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2447"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677222726.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>After that, the [Forward Value](https://doc316en.candera.eu/link/647#bkmrk-forward-value) Behavior's Properties will look as follows.

<div class="contents" id="bkmrk--63"><div class="contents"><div class="contents"><div class="contents"><div class="header" id="bkmrk--64"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2448"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677222739.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>6\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--65"><div class="contents"><div class="contents"><div class="contents"><div class="header" id="bkmrk--66"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2449"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677222755.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>7\. When manipulating the slider, the Value of the Text Value Control changes according to the alteration on the slider.

<div class="contents" id="bkmrk--67"><div class="contents"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="textblock"><div drawio-diagram="2450"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677222799.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>
#### <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Hover - Hover Leave Example  
</span></span>

1\. Drag&amp;drop a Text Control from the Controls Panel of the Toolbox to the Scene Editor or the Scene Tree and change its text to "Hover".

<div class="contents" id="bkmrk--68"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--69"><div class="contents"><div class="textblock"><div drawio-diagram="2451"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223245.png" alt=""/></div>

</div></div></div></div></div></div></div>2\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Hover](https://doc316en.candera.eu/link/598#bkmrk-hover)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) and a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the Text Control in the SceneTree. The <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior is needed in order for the Text Control to receive Input Events.

<div class="contents" id="bkmrk--70"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--71"><div class="contents"><div class="textblock"><div drawio-diagram="2452"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223271.png" alt=""/></div>

</div></div></div></div></div></div></div>3\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[SetColor](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> Behavior (which is an <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) onto the Actions of the <span style="color: rgb(230, 126, 35);">[Hover](https://doc316en.candera.eu/link/598#bkmrk-hover)</span> Behavior on the right side of the SceneTree view.

<div class="contents" id="bkmrk--72"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--73"><div class="contents"><div class="textblock"><div drawio-diagram="2453"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223296.png" alt=""/></div>

</div></div></div></div></div></div></div>4\. Select the <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> Behavior and change the Color to red.

<div class="contents" id="bkmrk--74"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--75"><div class="contents"><div class="textblock"><div drawio-diagram="2454"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223305.png" alt=""/></div>

</div></div></div></div></div></div></div>5\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--76"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--77"><div class="contents"><div class="textblock"><div drawio-diagram="2455"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223315.png" alt=""/></div>

</div></div></div></div></div></div></div>6\. When moving the mouse over the Text Control, the text color changes to red.

<div class="contents" id="bkmrk--78"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--79"><div class="contents"><div class="textblock"><div drawio-diagram="2456"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223338.png" alt=""/></div>

</div></div></div></div></div></div></div>7\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Hover Leave](https://doc316en.candera.eu/link/598#bkmrk-hoverleave-0)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) onto the TextNode.

<div class="contents" id="bkmrk--80"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--81"><div class="contents"><div class="textblock"><div drawio-diagram="2457"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223364.png" alt=""/></div>

</div></div></div></div></div></div></div>8\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> Behavior (which is an <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) onto the Actions of the <span style="color: rgb(230, 126, 35);">[HoverLeave](https://doc316en.candera.eu/link/598#bkmrk-hoverleave-0)</span> Behavior on the right side of the SceneTree view.

<div class="contents" id="bkmrk--82"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--83"><div class="contents"><div class="textblock"><div drawio-diagram="2458"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223385.png" alt=""/></div>

</div></div></div></div></div></div></div>9\. Select the <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> Behavior and change the Color to green.

<div class="contents" id="bkmrk--84"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--85"><div class="contents"><div class="textblock"><div drawio-diagram="2459"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223403.png" alt=""/></div>

</div></div></div></div></div></div></div>10\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--86"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--87"><div class="contents"><div class="textblock"><div drawio-diagram="2460"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223416.png" alt=""/></div>

</div></div></div></div></div></div></div>11\. When moving the mouse over the Text Control, the text color changes to red (as it did before). When moving the mouse away again, the Text Control's color changes to green. Whenever you hover, it's getting red, when leaving, it's turning green.

<div class="contents" id="bkmrk--88"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--89"><div class="contents"><div class="textblock"><div drawio-diagram="2461"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223532.png" alt=""/></div>

</div></div></div></div></div></div></div>
#### <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Interpolate Value Example  
</span></span>

<div class="contents" id="bkmrk--90"><div class="contents" id="bkmrk--91"><div class="contents" id="bkmrk--92"></div></div></div>1\. Drag&amp;drop a TextButton Control from the Controls panel and a TextNode from the "Nodes 2D" Panel of the Toolbox to the SceneEditor or the Scene Tree. Set the TextButton's Text to "Count to 10".

<div class="contents" id="bkmrk--93"><div class="contents"><div class="textblock"><div drawio-diagram="2472"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677224131.png" alt=""/></div>

</div></div></div>2\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Value Behavior](https://doc316en.candera.eu/link/647#bkmrk-value)</span> (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) from the Behaviors Panel of the Toolbox onto the TextNode in the Scene Tree.

<div class="contents" id="bkmrk--94"><div class="contents"><div class="textblock"><div drawio-diagram="2473"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677224160.png" alt=""/></div>

</div></div></div>3\. Select the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior in the right side of the Scene Tree view. Set the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's AcceptValueEvent Property to "true" by checking the checkbox.

<div class="contents" id="bkmrk--95"><div class="contents"><div class="textblock"><div drawio-diagram="2474"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677224173.png" alt=""/></div>

</div></div></div>4\. Drag&amp;drop an <span style="color: rgb(230, 126, 35);">[Interpolate Value](https://doc316en.candera.eu/link/647#bkmrk-interpolate-value)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) onto the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's Receivers in the right side of the Scene Tree Panel.

<div class="contents" id="bkmrk--96"><div class="contents"><div class="textblock"><div drawio-diagram="2475"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677224204.png" alt=""/></div>

</div></div></div>5\. Select the <span style="color: rgb(230, 126, 35);">[Interpolate Value](https://doc316en.candera.eu/link/647#bkmrk-interpolate-value)</span> Behavior on the right side of the Scene Tree View and set the UnitsPerSecond to 1,00 in the Properties view on the bottom right.

<div class="contents" id="bkmrk--97"><div class="contents"><div class="textblock"><div drawio-diagram="2476"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677224216.png" alt=""/></div>

</div></div></div>6\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Format String](https://doc316en.candera.eu/link/647#bkmrk-format-string)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) from the Toolbox onto the <span style="color: rgb(230, 126, 35);">[Interpolate Value](https://doc316en.candera.eu/link/647#bkmrk-interpolate-value)</span> Behavior's Receivers on the right side of the Scene Tree Panel.

<div class="contents" id="bkmrk--98"><div class="contents"><div class="textblock"><div drawio-diagram="2477"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677224250.png" alt=""/></div>

</div></div></div>7\. Select the <span style="color: rgb(230, 126, 35);">[Format String](https://doc316en.candera.eu/link/647#bkmrk-format-string)</span> Behavior on the right side of the Scene Tree view and set the Text property to "%d" in the Properties view.

<div class="contents" id="bkmrk--99"><div class="contents"><div class="textblock"><div drawio-diagram="2478"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677224267.png" alt=""/></div>

</div></div></div>8\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Toolbox view onto the TextButton's Actions on the right side of the SceneTree view.

<div class="contents" id="bkmrk--100"><div class="contents"><div class="textblock"><div drawio-diagram="2479"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677224298.png" alt=""/></div>

</div></div></div>9\. Select the <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior on the right side of the Scene Tree Panel. Set the Value property to datatype "Float" and value "10" in the Properties view. Adjust the behavior's TargetNode by clicking on the magnifying glass on the right of the property.

<div class="contents" id="bkmrk--101"><div class="contents"><div class="textblock"><div drawio-diagram="2480"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677224312.png" alt=""/></div>

</div></div></div>10\. Set the scene's TextNode as TargetNode for the <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior: After clicking the magnifying glass in the properties panel, the "Select Item" Dialog is opened. Select the scene's TextNode and press OK.

<div class="contents" id="bkmrk--102"><div class="contents"><div class="textblock"><div drawio-diagram="2481"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677224346.png" alt=""/></div>

</div></div></div>11\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--103"><div class="contents"><div class="textblock"><div drawio-diagram="2482"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677224359.png" alt=""/></div>

</div></div></div>12\. When clicking on the TextButton, the value 10 gets sent to the TextNode, but the TextNode doesn't change to 10 immediately. The [Interpolate Value](https://doc316en.candera.eu/link/647#bkmrk-interpolate-value) Behavior makes the TextNode count up from 0 to 10 in one step per second.

<div class="contents" id="bkmrk--104"><div class="contents"><div class="textblock"><div drawio-diagram="2485"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677224502.png" alt=""/></div>

</div></div></div>
#### <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Move Node Example  
</span></span>

 1. Drag&amp;drop a TextButton Control from the Controls Panel of the Toolbox to the SceneEditor or the Scene Tree and change the Text to "Move Node"

<div class="contents" id="bkmrk--105"><div class="contents"><div class="textblock"><div drawio-diagram="2462"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223703.png" alt=""/></div>

</div></div></div>2\. Select the TextButton in the Scene Tree View and delete all Behaviors that are automatically attached to the TextButton from the right side of the Scene Tree View.

<div class="contents" id="bkmrk--106"><div class="contents"><div class="textblock"><div drawio-diagram="2463"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223735.png" alt=""/></div>

</div></div></div>3\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) and a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the TextButton Control in the SceneTree. The <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior is needed in order for the TextButton Control to receive Input Events.

<div class="contents" id="bkmrk--107"><div class="contents"><div class="textblock"><div drawio-diagram="2464"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223783.png" alt=""/></div>

</div></div></div>4\. Select the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior on the right of the Scene Tree View and set the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's AcceptValueEvent Property to "true" by checking the checkbox.

<div class="contents" id="bkmrk--108"><div class="contents"><div class="textblock"><div drawio-diagram="2465"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223801.png" alt=""/></div>

</div></div></div>5\. Drag&amp;drop the <span style="color: rgb(230, 126, 35);">[Move Node](https://doc316en.candera.eu/link/647#bkmrk-move-node)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing - Transformation Behavior](https://doc316en.candera.eu/link/647#bkmrk-transformation-value)</span>) from the Behaviors Panel of the ToolBox onto the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's Receivers.

<div class="contents" id="bkmrk--109"><div class="contents"><div class="textblock"><div drawio-diagram="2466"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223828.png" alt=""/></div>

</div></div></div>6\. Drag&amp;drop an <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) from the Behaviors Panel of the ToolBox onto the TextButton Control.

<div class="contents" id="bkmrk--110"><div class="contents"><div class="textblock"><div drawio-diagram="2467"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223850.png" alt=""/></div>

</div></div></div>7\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Behaviors Panel of the ToolBox onto the <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behavior's Actions Property.

<div class="contents" id="bkmrk--111"><div class="contents"><div class="textblock"><div drawio-diagram="2468"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223875.png" alt=""/></div>

</div></div></div>8\. Select the <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior on the right side of the Scene Tree View and set the value to datatype "Float" value "100,00" in the Properties view.

<div class="contents" id="bkmrk--112"><div class="contents"><div class="textblock"><div drawio-diagram="2469"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223899.png" alt=""/></div>

</div></div></div>9\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--113"><div class="contents"><div class="textblock"><div drawio-diagram="2470"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223911.png" alt=""/></div>

</div></div></div>10\. When Clicking on the TextButton in the Player, the Button moves to position 50, 50.

<div class="contents" id="bkmrk--114"><div class="contents"><div class="textblock"><div drawio-diagram="2471"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677223936.png" alt=""/></div>

</div>---

</div></div>#### OnClick Example

1\. Drag&amp;drop a SolidColorNode from the "Nodes 2D" Panel of the Toolbox to the SceneEditor or the Scene Tree.

<div class="contents" id="bkmrk--116"><div class="contents"><div class="contents" id="bkmrk--117"><div class="contents"><div class="textblock"><div drawio-diagram="2507"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677228014.png" alt=""/></div>

</div></div></div></div></div>2\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) and a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the SolidColorNode in the SceneTree. The <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior is needed in order for the TextButton Control to receive Input Events.

<div class="contents" id="bkmrk--118"><div class="contents"><div class="contents" id="bkmrk--119"><div class="contents"><div class="textblock"><div drawio-diagram="2510"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677228098.png" alt=""/></div>

</div></div></div></div></div>3\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> SetColor Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Toolbox view onto the Actions of the <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behaviors in the SceneTree.

<div class="contents" id="bkmrk--120"><div class="contents"><div class="contents" id="bkmrk--121"><div class="contents"><div class="textblock"><div drawio-diagram="2509"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677228070.png" alt=""/></div>

</div></div></div></div></div>4\. Select the <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> Behavior and change the Color to red.

<div class="contents" id="bkmrk--122"><div class="contents"><div class="contents" id="bkmrk--123"><div class="contents"><div class="textblock"><div drawio-diagram="2511"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677228106.png" alt=""/></div>

</div></div></div></div></div>5\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--124"><div class="contents"><div class="contents" id="bkmrk--125"><div class="contents"><div class="textblock"><div drawio-diagram="2512"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677228115.png" alt=""/></div>

</div></div></div></div></div>6\. When clicking on the SolidColorNode, the SolidColorNode's color changes to red.

<div class="contents" id="bkmrk--126"><div class="contents"><div class="contents" id="bkmrk--127"><div class="contents"><div class="textblock"><div drawio-diagram="2513"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677228134.png" alt=""/></div>

</div></div></div></div></div>
#### <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">OnPressed Example</span></span>

1\. Drag&amp;drop a SolidColorNode from the "Nodes 2D" Panel of the Toolbox to the SceneEditor or the Scene Tree.

<div class="contents" id="bkmrk--128"><div class="contents"><div class="textblock"><div drawio-diagram="2515"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677228338.png" alt=""/></div>

</div></div></div>2\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[OnPressed](https://doc316en.candera.eu/link/598#bkmrk-onpressed)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) and a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the SolidColorNode in the SceneTree. The <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior is needed in order for the TextButton Control to receive Input Events.

<div class="contents" id="bkmrk--129"><div class="contents"><div class="textblock"><div drawio-diagram="2516"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677228366.png" alt=""/></div>

</div></div></div>3\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> SetColor Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Toolbox view onto the Actions of the <span style="color: rgb(230, 126, 35);">[OnPressed](https://doc316en.candera.eu/link/598#bkmrk-onpressed)</span> Behaviors in the SceneTree.

<div class="contents" id="bkmrk--130"><div class="contents"><div class="textblock"><div drawio-diagram="2518"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677228409.png" alt=""/></div>

</div></div></div>4\. Select the <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> Behavior and change the Color to red.

<div class="contents" id="bkmrk--131"><div class="contents"><div class="textblock"><div drawio-diagram="2519"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677228439.png" alt=""/></div>

</div></div></div>5\. Save your solution and start the CGIPlayer through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--132"><div class="contents"><div class="textblock"><div drawio-diagram="2520"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677228460.png" alt=""/></div>

</div></div></div>6\. When pressing the mouse left button on the SolidColorNode, the SolidColorNode's color changes to red.

<div class="contents" id="bkmrk--133"><div class="contents"><div class="textblock"><div drawio-diagram="2522"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677228477.png" alt=""/></div>

</div></div></div>
#### Perform Transition Requests Example

1\. Drag&amp;drop a SolidColorNode from the "Nodes 2D" Panel of the Toolbox to the 2D scene "Scene2D" in the SceneEditor or the Scene Tree view. Change the Scale X and Scale Y propertes to 3,0 each in the Properties view.

<div class="contents" id="bkmrk--134"><div class="contents"><div class="textblock"><div drawio-diagram="2530"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460607.png" alt=""/></div>

</div></div></div>2\. Open the already existing 3D scene "Scene3D" by double-clicking it in the Solution Explorer on the left.

<div class="contents" id="bkmrk--135"><div class="contents"><div class="textblock"><div drawio-diagram="2531"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460624.png" alt=""/></div>

</div></div></div>3\. Drag&amp;drop a Cube Control from the Controls Panel of the Toolbox to the 3D Scene "Scene3D" in SceneEditor or the Scene Tree view.

<div class="contents" id="bkmrk--136"><div class="contents"><div class="textblock"><div drawio-diagram="2532"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460648.png" alt=""/></div>

</div></div></div>4\. Select the Cube Control in the Scene Tree view and set the Position properties to (0, 0, 0).

<div class="contents" id="bkmrk--137"><div class="contents"><div class="textblock"><div drawio-diagram="2533"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460668.png" alt=""/></div>

</div></div></div>5\. Switch back to the 2D scene "Scene2D" by double-clicking it in the Solution Explorer on the left.

<div class="contents" id="bkmrk--138"><div class="contents"><div class="textblock"><div drawio-diagram="2534"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460682.png" alt=""/></div>

</div></div></div>6\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) and a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the SolidColorNode in the SceneTree. The <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior is needed in order for the TextButton Control to receive Input Events.

<div class="contents" id="bkmrk--139"><div class="contents"><div class="textblock"><div drawio-diagram="2535"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460707.png" alt=""/></div>

</div></div></div>7\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Perform Transition Requests](https://doc316en.candera.eu/link/582#bkmrk-perform-transition-r-0)</span> Perform Transition Requests Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Transition Behavior](https://doc316en.candera.eu/link/582#bkmrk-transition-action-be)</span>) from the Toolbox view onto the Actions of the <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behaviors in right side of the SceneTree view.

<div class="contents" id="bkmrk--140"><div class="contents"><div class="textblock"><div drawio-diagram="2536"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460734.png" alt=""/></div>

</div></div></div>8\. Drag&amp;drop two <span style="color: rgb(230, 126, 35);">[Transition Request](https://doc316en.candera.eu/link/582#bkmrk-transition-request-0)</span> Transition Request Behaviors (which are <span style="color: rgb(230, 126, 35);">[Action - Transition Behaviors](https://doc316en.candera.eu/link/582#bkmrk-transition-action-be)</span>) from the Toolbox view onto the Requests of the <span style="color: rgb(230, 126, 35);">[Perform Transition Requests](https://doc316en.candera.eu/link/582#bkmrk-perform-transition-r-0)</span> Perform Transition Requests Behavior in the right side of the SceneTree view.

<div class="contents" id="bkmrk--141"><div class="contents"><div class="textblock"><div drawio-diagram="2537"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460756.png" alt=""/></div>

</div></div></div>9\. Select the first one of the two <span style="color: rgb(230, 126, 35);">[Transition Request](https://doc316en.candera.eu/link/582#bkmrk-transition-request-0)</span> Transition Request Behaviors. Set the <span style="color: rgb(230, 126, 35);">[Transition Request](https://doc316en.candera.eu/link/582#bkmrk-transition-request-0)</span> Transition Request Behavior's Identifier to the current scene (Scene2D) by clicking on the magnifying glass on the right of the input field and selecting the current 2D Scene (Scene2D) in the "Choose Item" dialog.

<div class="contents" id="bkmrk--142"><div class="contents"><div class="textblock"><div drawio-diagram="2538"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460782.png" alt=""/></div>

</div></div></div>After that, the <span style="color: rgb(230, 126, 35);">[Transition Request](https://doc316en.candera.eu/link/582#bkmrk-transition-request-0)</span> Transition Request Behavior's Properties will look as follows.

<div class="contents" id="bkmrk--143"><div class="contents"><div class="textblock"><div drawio-diagram="2539"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460805.png" alt=""/></div>

</div></div></div>10\. Now, select the second <span style="color: rgb(230, 126, 35);">[Transition Request](https://doc316en.candera.eu/link/582#bkmrk-transition-request-0)</span> Transition Request Behaviors. Set the <span style="color: rgb(230, 126, 35);">[Transition Request](https://doc316en.candera.eu/link/582#bkmrk-transition-request-0)</span> Transition Request Behavior's Identifier to the 3D scene (Scene3D) by clicking on the magnifying glass on the right of the input field and selecting the 3D Scene (Scene3D) in the "Choose Item" dialog.

<div class="contents" id="bkmrk--144"><div class="contents"><div class="textblock"><div drawio-diagram="2540"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460836.png" alt=""/></div>

</div></div></div>After that, the <span style="color: rgb(230, 126, 35);">[Transition Request](https://doc316en.candera.eu/link/582#bkmrk-transition-request-0)</span> Transition Request Behavior's Properties will look as follows.

<div class="contents" id="bkmrk--145"><div class="contents"><div class="textblock"><div drawio-diagram="2541"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460854.png" alt=""/></div>

</div></div></div>11\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--146"><div class="contents"><div class="textblock"><div drawio-diagram="2542"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460867.png" alt=""/></div>

</div></div></div>12\. You can see your 2D scene with the white SolidColorNode. When clicking on the SolidColorNode, a transition to the 3D scene is performed.

<div class="contents" id="bkmrk-initially-displaying"><div class="contents"><div class="contents"><div class="textblock"><table border="0"><tbody><tr><td valign="top"><div class="image"><div drawio-diagram="2543"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460901.png" alt=""/></div>

</div></td><td valign="top"><div class="image"><div drawio-diagram="2544"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677460916.png" alt=""/></div>

</div></td></tr><tr><td align="center">*Initially displaying Scene2D*</td><td align="center">*After Clicking, displaying Scene3D*</td></tr></tbody></table>

</div></div></div></div>
#### Render Child Nodes Example

1\. Drag&amp;drop two TextButton Controls from the Controls Panel of the Toolbox to the already existing Group Node of the Scene Tree and change their texts to "Button 1" and "Button 2".

<div class="contents" id="bkmrk--147"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--148"><div class="contents"><div class="textblock"><div drawio-diagram="2545"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461065.png" alt=""/></div>

</div></div></div></div></div></div>2\. Drag&amp;drop an <span style="color: rgb(230, 126, 35);">[Event Handler](https://doc316en.candera.eu/link/598#bkmrk-event-handler)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) from the Toolbox view onto the Group Node in the Scene Tree view.

<div class="contents" id="bkmrk--149"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--150"><div class="contents"><div class="textblock"><div drawio-diagram="2546"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461099.png" alt=""/></div>

</div></div></div></div></div></div>3\. Select the Group Node in the Scene Tree view and drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Check Click](https://doc316en.candera.eu/link/597#bkmrk-check-click)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Condition - Input Behavior](https://doc316en.candera.eu/link/597#bkmrk-%C2%A0-1)</span>) from the Toolbox view onto the Condition of the Group Node's EventHandler in the right side of the Scene Tree view.

<div class="contents" id="bkmrk--151"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--152"><div class="contents"><div class="textblock"><div drawio-diagram="2547"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461124.png" alt=""/></div>

</div></div></div></div></div></div>4\. Keep the Group Node selected in the Scene Tree view and drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Render Child Nodes](https://doc316en.candera.eu/link/647#bkmrk-render-child-nodes)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span> Behavior) from the Toolbox view onto the "Actions" of the Group Node's EventHandler on the right side of the Scene Tree view.

<div class="contents" id="bkmrk--153"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--154"><div class="contents"><div class="textblock"><div drawio-diagram="2548"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461147.png" alt=""/></div>

</div></div></div></div></div></div>5\. Select the "Render Child Nodes" Behavior in the right side of the Scene Tree view. In the Properties view set Index to "1,0" and OperationMode to to "SingleNode".

<div class="contents" id="bkmrk--155"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--156"><div class="contents"><div class="textblock"><div drawio-diagram="2549"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461167.png" alt=""/></div>

</div></div></div></div></div></div>6\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--157"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--158"><div class="contents"><div class="textblock"><div drawio-diagram="2550"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461178.png" alt=""/></div>

</div></div></div></div></div></div>7\. After clicking on one of the two buttons (no matter which one), "Button 2" will disappear and "Button 1" will get rendered.

<div class="contents" id="bkmrk--159"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--160"><div class="contents"><div class="textblock"><div drawio-diagram="2551"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461200.png" alt=""/></div>

</div></div></div></div></div></div>8\. Stop the Player by pressing on the Stop Button (next to the option "Generate and Play") and change the "Render Child Nodes" Behavior's Property: Set Index to "2,0".

<div class="contents" id="bkmrk--161"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--162"><div class="contents"><div class="textblock"><div drawio-diagram="2552"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461219.png" alt=""/></div>

</div></div></div></div></div></div>9\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--163"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--164"><div class="contents"><div class="textblock"><div drawio-diagram="2553"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461245.png" alt=""/></div>

</div></div></div></div></div></div>10\. After clicking on one of the two buttons (no matter which one), "Button 1" will disappear and "Button 2" will get rendered.

<div class="contents" id="bkmrk--165"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--166"><div class="contents"><div class="textblock"><div drawio-diagram="2555"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461271.png" alt=""/></div>

</div></div></div></div></div></div>#### <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Send Value As Event Example</span>  
</span>

<div class="contents" id="bkmrk-1.-drag%26drop-two-tex-1"><div class="contents"><div class="contents"><div class="header" id="bkmrk-1.-drag%26drop-two-tex-2"><div class="header"><div class="headertitle"><div class="title">1. Drag&amp;drop two TextButton Controls and a TextValue Control from the Controls Panel of the Toolbox to the Scene Editor or Scene Tree.  
</div></div></div></div><div class="header" id="bkmrk--167"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2559"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461437.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>2\. Rename the TextButton Controls to "DecreaseButton" and "IncreaseButton". Change the text of the DecreaseButton to "-" and the text of the IncreaseButton to "+".

<div class="contents" id="bkmrk--168"><div class="contents"><div class="contents"><div class="header" id="bkmrk--169"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2564"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461590.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>3\. Change the Text of the TextValue Control to "Count: %d" and arrange the three Controls as in the right picture below.

<div class="contents" id="bkmrk--170"><div class="contents"><div class="contents"><div class="header" id="bkmrk--171"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2565"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461636.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>4\. The value of the TextValue Control should be increased or decreased according to the pressed Button. To connect the TextButton Controls with the TextValue Control select one of the TextButtons. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) onto the Actions sections of both of the TextButton Controls' EventHandler.

<div class="contents" id="bkmrk--172"><div class="contents"><div class="contents"><div class="header" id="bkmrk--173"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2566"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461678.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>5\. Select the "SendValueAsEvent" Behavior of the "DecreaseButton" and change the Value to "-1,00" in the Properties view. As the value should change relative to the current value, the "ChangeValue" property has to be set to "Relative". Select the "SendValueAsEvent" Behavior of the "IncreaseButton" and change the Value to "1,00" in the Properties view. Again, the "ChangeValue" property has to be set to "Relative"

<div class="contents" id="bkmrk--174"><div class="contents"><div class="contents"><div class="header" id="bkmrk--175"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2567"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461711.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>6\. Both "SendValueAsEvent" Behaviors need to be configured with the "Text Value" Control as TargetNode by clicking on the magnifying glass on the right of the property.

<div class="contents" id="bkmrk--176"><div class="contents"><div class="contents"><div class="header" id="bkmrk--177"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2568"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461727.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>7\. Set the scene's TextValue Node as TargetNode for the <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior: After clicking the magnifying glass in the properties panel, the "Select Item" Dialog is opened. Select the scene's TextValue Node and press OK. Repeat this for the second "SendValueAsEvent" Behavior.

<div class="contents" id="bkmrk--178"><div class="contents"><div class="contents"><div class="header" id="bkmrk--179"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2569"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461761.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>8\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--180"><div class="contents"><div class="contents"><div class="header" id="bkmrk--181"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2570"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461780.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>9\. When pressing the "-" Button, the Count value is decreased by one. When pressing the "+" Button, the Count value is increased by one.

<div class="contents" id="bkmrk--182"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="headertitle"><div class="title"><div class="contents"><div class="textblock"><div drawio-diagram="2571"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677461844.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>
#### <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Set Alpha Value Example</span></span>

1\. Drag&amp;drop a TextButton Control from the Controls Panel of the Toolbox to the SceneEditor or the Scene Tree and change the Text to "Set Alpha Value"

<div class="contents" id="bkmrk--183"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--184"><div class="contents"><div class="textblock"><div drawio-diagram="2577"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677462561.png" alt=""/></div>

</div></div></div></div></div></div></div></div>2\. Select the TextButton in the Scene Tree View and delete all Behaviors that are automatically attached to the TextButton from the right side of the Scene Tree View.

<div class="contents" id="bkmrk-before-deleting-all-"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk-before-deleting-all--1"><div class="contents"><div class="textblock"><table border="0"><tbody><tr><td valign="top"><div class="image"><div drawio-diagram="2578"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677462609.png" alt=""/></div>

</div></td><td valign="top"><div class="image"><div drawio-diagram="2579"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677462633.png" alt=""/></div>

</div></td></tr><tr><td align="center">*before deleting all behaviors*</td><td align="center">*after deleting behaviors*</td></tr></tbody></table>

</div></div></div></div></div></div></div></div>3\. Select the TextButton Control in the SceneTree View and decrease its Alpha Value e.g. to 0,5 in the Item Tab of the Properties Panel.

<div class="contents" id="bkmrk--185"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--186"><div class="contents"><div class="textblock"><div drawio-diagram="2580"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677462646.png" alt=""/></div>

</div></div></div></div></div></div></div></div>4\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) and a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the TextButton Control in the SceneTree. The [<span style="color: rgb(230, 126, 35);">Handle Control State</span>](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state) Behavior is needed in order for the TextButton Control to receive Input Events.

<div class="contents" id="bkmrk--187"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--188"><div class="contents"><div class="textblock"><div drawio-diagram="2582"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677462713.png" alt=""/></div>

</div></div></div></div></div></div></div></div>5\. Select the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior on the right of the Scene Tree View and set the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's AcceptValueEvent Property to "true" by checking the checkbox.

<div class="contents" id="bkmrk--189"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--190"><div class="contents"><div class="textblock"><div drawio-diagram="2583"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677462728.png" alt=""/></div>

</div></div></div></div></div></div></div></div>6\. Drag&amp;drop the <span style="color: rgb(230, 126, 35);">[Set Alpha Value](https://doc316en.candera.eu/link/647#bkmrk-set-alpha-value)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing - Effects Behavior](https://doc316en.candera.eu/link/647#bkmrk-effects-value-proces)</span>) from the Behaviors Panel of the ToolBox onto the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's Receivers.

<div class="contents" id="bkmrk--191"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--192"><div class="contents"><div class="textblock"><div drawio-diagram="2584"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677462757.png" alt=""/></div>

</div></div></div></div></div></div></div></div>7\. Drag&amp;drop an <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) from the Behaviors Panel of the ToolBox onto the TextButton Control.

<div class="contents" id="bkmrk--193"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--194"><div class="contents"><div class="textblock"><div drawio-diagram="2586"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677462788.png" alt=""/></div>

</div></div></div></div></div></div></div></div>8\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Behaviors Panel of the ToolBox onto the [OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick) Behavior's Actions Property.

<div class="contents" id="bkmrk--195"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--196"><div class="contents"><div class="textblock"><div drawio-diagram="2590"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677462835.png" alt=""/></div>

</div></div></div></div></div></div></div></div>9\. Select the <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior on the right side of the Scene Tree View and set the value to datatype "Float" value "1,00" in the Properties view.

<div class="contents" id="bkmrk--197"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--198"><div class="contents"><div class="textblock"><div drawio-diagram="2591"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677462851.png" alt=""/></div>

</div></div></div></div></div></div></div></div>10\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--199"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--200"><div class="contents"><div class="textblock"><div drawio-diagram="2592"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677462862.png" alt=""/></div>

</div></div></div></div></div></div></div></div>11\. When Clicking on the TextButton in the Player, the Button moves to position 50, 50.

<div class="contents" id="bkmrk--201"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--202"><div class="contents"><div class="textblock"><div drawio-diagram="2593"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677462890.png" alt=""/></div>

</div></div></div></div></div></div></div></div>
#### Set Image Example

1\. Drag&amp;drop a TextButton Control from the Controls Panel and a BitmapNode from the "Nodes 2D" Panel of the Toolbox to the SceneEditor or the Scene Tree.

<div class="contents" id="bkmrk--203"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--204"><div class="contents"><div class="textblock"><div drawio-diagram="2594"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463007.png" alt=""/></div>

</div></div></div></div></div></div></div></div>2\. Position the TextButton Control and the BitmapNode next to each other in the Scene Editor.

<div class="contents" id="bkmrk--205"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--206"><div class="contents"><div class="textblock"><div drawio-diagram="2595"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463025.png" alt=""/></div>

</div></div></div></div></div></div></div></div>3\. Drag&amp;Drop a <span style="color: rgb(230, 126, 35);">[Provide Image](https://doc316en.candera.eu/link/598#bkmrk-provide-image)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Public Property Behavior](https://doc316en.candera.eu/link/598#bkmrk-public-property-cont)</span>) from the Behaviors Panel of the ToolBox onto the BitmapNode in the Scene Tree view.

<div class="contents" id="bkmrk--207"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--208"><div class="contents"><div class="textblock"><div drawio-diagram="2596"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463058.png" alt=""/></div>

</div></div></div></div></div></div></div></div>4\. Select the TextButton Control in the Scene Tree view and change its Text to "Set Image" in the Properties view.

<div class="contents" id="bkmrk--209"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--210"><div class="contents"><div class="textblock"><div drawio-diagram="2597"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463073.png" alt=""/></div>

</div></div></div></div></div></div></div></div>5\. Drag&amp;Drop a <span style="color: rgb(230, 126, 35);">[Set Image](https://doc316en.candera.eu/link/582#bkmrk-set-image)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Behaviors Panel of the ToolBox onto the "Actions" field of the TextButton Control's EventHandler on the right side of the Scene Tree.

<div class="contents" id="bkmrk--211"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--212"><div class="contents"><div class="textblock"><div drawio-diagram="2598"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463107.png" alt=""/></div>

</div></div></div></div></div></div></div></div>6\. Select the newly added <span style="color: rgb(230, 126, 35);">[Set Image](https://doc316en.candera.eu/link/582#bkmrk-set-image)</span> Behavior in right side of the Scene Tree view. Adjust the "Set Image" Behavior's Image Property by clicking the magnifying glass on the right of the input field.

<div class="contents" id="bkmrk--213"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--214"><div class="contents"><div class="textblock"><div drawio-diagram="2599"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463121.png" alt=""/></div>

</div></div></div></div></div></div></div></div>7\. Set the "Set Image" Behavior's image property: After clicking the magnifying glass in the properties panel, the "Select Item" Dialog is opened. Select an image from the construction kit (a preview of the image is shown when moving the mouse over the image) and press OK.

<div class="contents" id="bkmrk--215"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--216"><div class="contents"><div class="textblock"><div drawio-diagram="2600"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463153.png" alt=""/></div>

</div></div></div></div></div></div></div></div>8\. Select the <span style="color: rgb(230, 126, 35);">[Set Image](https://doc316en.candera.eu/link/582#bkmrk-set-image)</span> Behavior on the right side of the Scene Tree view and drag&amp;drop it onto the BitmapNode on the left side of the Scene Tree view (you can see a little arrow and "Set Image").

<div class="contents" id="bkmrk--217"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--218"><div class="contents"><div class="textblock"><div drawio-diagram="2601"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463173.png" alt=""/></div>

</div></div></div></div></div></div></div></div>9\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--219"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents" id="bkmrk--220"><div class="contents"><div class="textblock"><div drawio-diagram="2602"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463182.png" alt=""/></div>

</div></div></div></div></div></div></div></div>10\. When the TextButton is pressed, the configured image will be set to the BitmapNode and the image will appear.

<div class="contents" id="bkmrk--221"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2603"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463219.png" alt=""/></div>

</div></div></div></div></div></div></div></div>
#### Set Position Example

1\. Drag&amp;drop a TextButton Control from the Controls Panel of the Toolbox to the SceneEditor or the Scene Tree and change the Text to "Change Position".

<div class="contents" id="bkmrk--222"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--223"><div class="contents"><div class="textblock"><div drawio-diagram="2604"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463851.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>2\. Select the TextButton in the Scene Tree View and delete all Behaviors that are automatically attached to the TextButton from the right side of the Scene Tree View.

<div class="contents" id="bkmrk-before-deleting-all--2"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk-before-deleting-all--0"><div class="contents"><div class="textblock"><table border="0"><tbody><tr><td valign="top"><div class="image"><div drawio-diagram="2605"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463866.png" alt=""/></div>

</div></td><td valign="top"><div class="image"><div drawio-diagram="2606"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463877.png" alt=""/></div>

</div></td></tr><tr><td align="center">*before deleting all behaviors*</td><td align="center">*after deleting behaviors*</td></tr></tbody></table>

</div></div></div></div></div></div></div></div></div>3\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) and a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the TextButton Control in the SceneTree. The <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior is needed in order for the TextButton Control to receive Input Events.

<div class="contents" id="bkmrk--224"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--225"><div class="contents"><div class="textblock"><div drawio-diagram="2607"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463921.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>4\. Select the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior on the right side of the Scene Tree View and set the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's AcceptValueEvent Property to "true" by checking the checkbox.

<div class="contents" id="bkmrk--226"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--227"><div class="contents"><div class="textblock"><div drawio-diagram="2608"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463936.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>5\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Set Position](https://doc316en.candera.eu/link/647#bkmrk-set-position)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing - Transformation Behavior](https://doc316en.candera.eu/link/647#bkmrk-transformation-value)</span>) from the Behaviors Panel of the ToolBox onto the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's Receivers.

<div class="contents" id="bkmrk--228"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--229"><div class="contents"><div class="textblock"><div drawio-diagram="2609"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463971.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>6\. Select the <span style="color: rgb(0, 0, 0);">Set Position</span> Behavior on the right side of the Scene Tree view and set its TranslationAxis Property to "AxisX"

<div class="contents" id="bkmrk--230"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--231"><div class="contents"><div class="textblock"><div drawio-diagram="2610"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677463982.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>7\. Drag&amp;drop an <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) from the Behaviors Panel of the ToolBox onto the TextButton Control.

<div class="contents" id="bkmrk--232"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--233"><div class="contents"><div class="textblock"><div drawio-diagram="2611"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464010.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>8\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Behaviors Panel of the ToolBox onto the <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behavior's Actions Property.

<div class="contents" id="bkmrk--234"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--235"><div class="contents"><div class="textblock"><div drawio-diagram="2612"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464048.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>9\. Select the <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior on the right side of the Scene Tree View and set the value to datatype "Float" value "100,00" in the Properties view.

<div class="contents" id="bkmrk--236"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--237"><div class="contents"><div class="textblock"><div drawio-diagram="2613"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464062.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>10\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--238"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--239"><div class="contents"><div class="textblock"><div drawio-diagram="2614"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464071.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>11\. When Clicking on the TextButton in the Player, the Button's horizontal position (x coordinate) is set to 100, so it moves to the right.

<div class="contents" id="bkmrk--240"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--241"><div class="contents"><div class="textblock"><div drawio-diagram="2615"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464100.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>
#### Set Rotation Example  


1\. Drag&amp;drop a TextButton Control from the Controls Panel of the Toolbox to the SceneEditor or the Scene Tree and change the Text to "Set Rotation".

<div class="contents" id="bkmrk--242"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--243"><div class="contents"><div class="textblock"><div drawio-diagram="2616"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464616.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>2\. Select the TextButton in the Scene Tree View and delete all Behaviors that are automatically attached to the TextButton from the right side of the Scene Tree View.

<div class="contents" id="bkmrk-before-deleting-all--3"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk-before-deleting-all--4"><div class="contents"><div class="textblock"><table border="0"><tbody><tr><td valign="top"><div class="image"><div drawio-diagram="2617"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464644.png" alt=""/></div>

</div></td><td valign="top"><div class="image"><div drawio-diagram="2618"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464661.png" alt=""/></div>

</div></td></tr><tr><td align="center">*before deleting all behaviors*</td><td align="center">*after deleting behaviors*</td></tr></tbody></table>

</div></div></div></div></div></div></div></div></div>3\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) and a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the TextButton Control in the SceneTree. The <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior is needed in order for the TextButton Control to receive Input Events.

<div class="contents" id="bkmrk--244"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--245"><div class="contents"><div class="textblock"><div drawio-diagram="2619"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464698.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>4\. Select the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior on the right side of the Scene Tree View and set the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's AcceptValueEvent Property to "true" by checking the checkbox.

<div class="contents" id="bkmrk--246"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--247"><div class="contents"><div class="textblock"><div drawio-diagram="2620"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464712.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>5\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Set Rotation](https://doc316en.candera.eu/link/647#bkmrk-set-rotation)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing - Transformation Behavior](https://doc316en.candera.eu/link/647#bkmrk-transformation-value)</span>) from the Behaviors Panel of the ToolBox onto the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's Receivers.

<div class="contents" id="bkmrk--248"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--249"><div class="contents"><div class="textblock"><div drawio-diagram="2621"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464744.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>6\. Drag&amp;drop an <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) from the Behaviors Panel of the ToolBox onto the TextButton Control.

<div class="contents" id="bkmrk--250"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--251"><div class="contents"><div class="textblock"><div drawio-diagram="2622"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464772.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>7\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Behaviors Panel of the ToolBox onto the <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behavior's Actions Property.

<div class="contents" id="bkmrk--252"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--253"><div class="contents"><div class="textblock"><div drawio-diagram="2623"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464807.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>8\. Select the <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior on the right side of the Scene Tree View and set the value to datatype "Float" value "40,00" in the Properties view.

<div class="contents" id="bkmrk--254"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--255"><div class="contents"><div class="textblock"><div drawio-diagram="2624"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464829.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>9\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--256"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--257"><div class="contents"><div class="textblock"><div drawio-diagram="2625"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464839.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>10\. When Clicking on the TextButton in the Player, the Button is rotated 40° clockwise.

<div class="contents" id="bkmrk--258"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--259"><div class="contents"><div class="textblock"><div drawio-diagram="2626"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464862.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>
#### Set Scale Example  


1\. Drag&amp;drop a SolidColorNode from the "Nodes 2D" Panel of the Toolbox to the SceneEditor or the Scene Tree.

<div class="contents" id="bkmrk--260"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--261"><div class="contents"><div class="textblock"><div drawio-diagram="2627"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464965.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>2\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Value Behavior](https://doc316en.candera.eu/link/647#bkmrk-value)</span> (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) from the Behaviors Panel of the Toolbox onto the Text Value Control in the Scene Tree.

<div class="contents" id="bkmrk--262"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--263"><div class="contents"><div class="textblock"><div drawio-diagram="2628"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677464995.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>3\. Select the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior on the right side of the Scene Tree View. Set the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's AcceptValueEvent Property to "true" by checking the checkbox in the Properties view. Check the Minimum Checkbox and set the Minimum Value to 0,50. Check the Maximum Checkbox and set the Maximum Value to 3,00. Also, set the Variant Value to 1,00.

<div class="contents" id="bkmrk--264"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--265"><div class="contents"><div class="textblock"><div drawio-diagram="2629"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465013.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>4\. Select the SolidColorNode in the Scene Tree view and drag&amp;drop an <span style="color: rgb(230, 126, 35);">[Interpolate Value](https://doc316en.candera.eu/link/647#bkmrk-interpolate-value)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) onto the <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior's Receivers in the right side of the Scene Tree Panel.

<div class="contents" id="bkmrk--266"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--267"><div class="contents"><div class="textblock"><div drawio-diagram="2631"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465082.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>5\. Select the <span style="color: rgb(230, 126, 35);">[Interpolate Value](https://doc316en.candera.eu/link/647#bkmrk-interpolate-value)</span> Behavior on the right side of the Scene Tree view and set the property "Units Per Second" to 1,00 in the Properties view.

<div class="contents" id="bkmrk--268"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--269"><div class="contents"><div class="textblock"><div drawio-diagram="2632"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465101.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>6\. Drag&amp;Drop a <span style="color: rgb(230, 126, 35);">[Set Scale](https://doc316en.candera.eu/link/647#bkmrk-set-scale)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing - Transformation Behavior](https://doc316en.candera.eu/link/647#bkmrk-transformation-value)</span>) onto the <span style="color: rgb(230, 126, 35);">[Interpolate Value](https://doc316en.candera.eu/link/647#bkmrk-interpolate-value)</span> Behavior's Receivers in the right side of the Scene Tree Panel.

<div class="contents" id="bkmrk--270"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--271"><div class="contents"><div class="textblock"><div drawio-diagram="2633"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465130.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>7\. Select the <span style="color: rgb(230, 126, 35);">[Set Scale](https://doc316en.candera.eu/link/647#bkmrk-set-scale)</span> Behavior and check the ScaleAlongY checkbox in the Properties view. Set the ScaleVextor2D Property to (1, 1).

<div class="contents" id="bkmrk--272"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--451"><div class="contents"><div class="textblock"><div drawio-diagram="2634"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465144.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>8\. Drag&amp;drop two TextButton Controls from the Controls Panel of the Toolbox to the SceneEditor or the Scene Tree.

<div class="contents" id="bkmrk--453"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--454"><div class="contents"><div class="textblock"><div drawio-diagram="2635"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465180.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>9\. Configure the first TextButton Control to have the Text "Decrease". Configure the second TextButton Control to have the Text "Increase" and set it's Enabled Property to "false" by unchecking the Checkbox.

<div class="contents" id="bkmrk--456"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--457"><div class="contents"><div class="textblock"><div drawio-diagram="2636"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465215.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>10\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Toolbox view onto the TextButton's Actions on the right side of the SceneTree view. Do this for both of the TextButton Controls.

<div class="contents" id="bkmrk--459"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--460"><div class="contents"><div class="textblock"><div drawio-diagram="2638"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465306.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>11\. Select the first TextButton Control (the one with text "Decrease") and then select its <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior on the right side of the Scene Tree view. Set the Value Property to 0,50. Adjust the behavior's TargetNode by clicking on the magnifying glass on the right of the property.

<div class="contents" id="bkmrk--462"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--463"><div class="contents"><div class="textblock"><div drawio-diagram="2639"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465327.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>12\. Set the scene's TextNode as SolidColorNode for the <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior: After clicking the magnifying glass in the properties panel, the "Select Item" Dialog is opened. Select the scene's SolidColorNode and press OK.

<div class="contents" id="bkmrk--465"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--466"><div class="contents"><div class="textblock"><div drawio-diagram="2640"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465358.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>13\. Select the second TextButton Control (the one with text "Increase") and then select its <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior on the right side of the Scene Tree view. Set the Value Property to 3,00. Set the behavior's TargetNode to the scene's SolidColorNode as you just did for the first TextButton Control.

<div class="contents" id="bkmrk--468"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--469"><div class="contents"><div class="textblock"><div drawio-diagram="2641"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465376.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>14\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--471"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--472"><div class="contents"><div class="textblock"><div drawio-diagram="2642"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465391.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>15\. When clicking on the TextButton "Increase" in the Player, the size of the SolidColorNode is slowly increased. When clicking on the TextButton "Decrease", the size of the SolidColorNode is slowly decreased.

<div class="contents" id="bkmrk--474"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--475"><div class="contents"><div class="textblock"><div drawio-diagram="2643"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465415.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>
#### Set Text Example  


1\. Drag&amp;drop a TextButton Control from the Controls panel and a TextNode from the "Nodes 2D" Panel of the Toolbox to the SceneEditor or the Scene Tree. Set the TextButton's Text to "Change Text".

<div class="contents" id="bkmrk--477"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--478"><div class="contents"><div class="textblock"><div drawio-diagram="2644"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465523.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>2\. Position the TextButton Control and the TextNode nicely in the Scene Editor.

<div class="contents" id="bkmrk--480"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--481"><div class="contents"><div class="textblock"><div drawio-diagram="2645"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465539.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>3\. Drag&amp;Drop a <span style="color: rgb(230, 126, 35);">[Provide Text](https://doc316en.candera.eu/link/598#bkmrk-provide-text)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Public Property Behavior](https://doc316en.candera.eu/link/598#bkmrk-public-property-cont)</span>) from the Behaviors Panel of the ToolBox onto the TextNode in the Scene Tree view.

<div class="contents" id="bkmrk--483"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--484"><div class="contents"><div class="textblock"><div drawio-diagram="2646"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465570.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>4\. Select the TextButton Control and drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Set Text](https://doc316en.candera.eu/link/582#bkmrk-set-text)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Behaviors Panel of the ToolBox onto the "Actions" field of the TextButton Control's EventHandler on the right side of the Scene Tree.

<div class="contents" id="bkmrk--486"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--487"><div class="contents"><div class="textblock"><div drawio-diagram="2647"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465604.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>5\. Select the newly added [Set Text](https://doc316en.candera.eu/link/582#bkmrk-set-text) Behavior in right side of the Scene Tree view and change the Text property to "Hallo" in the Properties view.

<div class="contents" id="bkmrk--489"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--490"><div class="contents"><div class="textblock"><div drawio-diagram="2648"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465618.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>6\. Select the <span style="color: rgb(230, 126, 35);">[Set Text](https://doc316en.candera.eu/link/582#bkmrk-set-text)</span> Behavior on the right side of the Scene Tree view and drag&amp;drop it onto the TextNode on the left side of the Scene Tree view (you can see a little arrow and "Set Text").

<div class="contents" id="bkmrk--492"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--493"><div class="contents"><div class="textblock"><div drawio-diagram="2649"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465630.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>7\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--495"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--496"><div class="contents"><div class="textblock"><div drawio-diagram="2650"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465645.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>8\. When the TextButton is pressed, the text of the TextNode will be changed to "Hallo".

<div class="contents" id="bkmrk--498"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--499"><div class="contents"><div class="textblock"><div drawio-diagram="2651"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677465664.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>
#### Start Timer Example  


1\. Drag&amp;drop a TextButton Control and a Text Control from the Controls panel of the Toolbox to the SceneEditor or the Scene Tree.

<div class="contents" id="bkmrk--501"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--502"><div class="contents"><div class="textblock"><div drawio-diagram="2652"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466176.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>2\. Select the TextButton in the Scene Tree View and delete all Behaviors that are automatically attached to the TextButton from the right side of the Scene Tree View.

<div class="contents" id="bkmrk-before-deleting-all--5"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk-before-deleting-all--6"><div class="contents"><div class="textblock"><table border="0"><tbody><tr><td valign="top"><div class="image"><div drawio-diagram="2653"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466205.png" alt=""/></div>

</div></td><td valign="top"><div class="image"><div drawio-diagram="2654"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466222.png" alt=""/></div>

</div></td></tr><tr><td align="center">*before deleting all behaviors*</td><td align="center">*after deleting behaviors*</td></tr></tbody></table>

</div></div></div></div></div></div></div></div></div>3\. Set the TextButton Control's text to "Start Timer" and the Text Control's text to "Wait for Timer".

<div class="contents" id="bkmrk--506"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--507"><div class="contents"><div class="textblock"><div drawio-diagram="2655"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466255.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>4\. Drag&amp;drop an <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) and a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the TextButton Control in the SceneTree. The <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior is needed in order for the Text Control to receive Input Events.

<div class="contents" id="bkmrk--509"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--510"><div class="contents"><div class="textblock"><div drawio-diagram="2656"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466286.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>5\. Select the TextButton Control in the Scene Tree view and drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Start Timer](https://doc316en.candera.eu/link/582#bkmrk-start-timer)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Control Behavior](https://doc316en.candera.eu/link/582#bkmrk-control-action-behav)</span>) from the Toolbox view onto the Actions of the TextButton Control's OnClick Behavior in the right side of the Scene Tree view.

<div class="contents" id="bkmrk--512"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--513"><div class="contents"><div class="textblock"><div drawio-diagram="2658"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466318.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>6\. Select the <span style="color: rgb(230, 126, 35);">[Start Timer](https://doc316en.candera.eu/link/582#bkmrk-start-timer)</span> Behavior in the right side of the Scene Tree view and set the Delay property to "1000" in the properties view. Set the <span style="color: rgb(230, 126, 35);">[Start Timer](https://doc316en.candera.eu/link/582#bkmrk-start-timer)</span> Behavior's Target Node to the Text Control you have added to the scene in step 1 by clicking the magnifying glass on the right side of the input filed and selecting the Text Value Control in "Choose Item" dialog.

<div class="contents" id="bkmrk--515"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--516"><div class="contents"><div class="textblock"><div drawio-diagram="2659"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466347.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>After that, the <span style="color: rgb(230, 126, 35);">[Start Timer](https://doc316en.candera.eu/link/582#bkmrk-start-timer)</span> Behavior's Properties will look as follows.

<div class="contents" id="bkmrk--518"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--519"><div class="contents"><div class="textblock"><div drawio-diagram="2660"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466362.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>7\. Drag&amp;drop an <span style="color: rgb(230, 126, 35);">[On Timer](https://doc316en.candera.eu/link/598#bkmrk-ontimer)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) and a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the TextButton Control in the SceneTree. The <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior is needed in order for the Text Control to receive Input Events.

<div class="contents" id="bkmrk--521"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--522"><div class="contents"><div class="textblock"><div drawio-diagram="2662"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466421.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>8\. Select the Text Control in the Scene Tree view and drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Toolbox view onto the Actions of the Text Control's <span style="color: rgb(230, 126, 35);">[On Timer](https://doc316en.candera.eu/link/598#bkmrk-ontimer)</span> Behavior in the right side of the Scene Tree view.

<div class="contents" id="bkmrk--524"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--525"><div class="contents"><div class="textblock"><div drawio-diagram="2663"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466472.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>9\. Select the <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> Behavior and change the Color to red.

<div class="contents" id="bkmrk--527"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--528"><div class="contents"><div class="textblock"><div drawio-diagram="2664"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466483.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>10\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--530"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--531"><div class="contents"><div class="textblock"><div drawio-diagram="2665"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466498.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>11\. When the TextButton "Start Timer" is pressed, a timer is started and after some time the Text Control's text changes its color.

<div class="contents" id="bkmrk--533"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--534"><div class="contents"><div class="textblock"><div drawio-diagram="2666"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466517.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>
#### Switch Image Example  


1\. Drag&amp;drop a FlipBook Control from the Controls panel of the Toolbox to the SceneEditor or the Scene Tree.

<div class="contents" id="bkmrk--536"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--537"><div class="contents"><div class="textblock"><div drawio-diagram="2669"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466622.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>2\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing Behavior](https://doc316en.candera.eu/link/647#bkmrk-page-title)</span>) and a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the TextButton Control in the SceneTree. The <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior is needed in order for the Text Control to receive Input Events.

<div class="contents" id="bkmrk--539"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--540"><div class="contents"><div class="textblock"><div drawio-diagram="2670"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466649.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>3\. Select the [Value](https://doc316en.candera.eu/link/647#bkmrk-value) Behavior in the right side of the Scene Tree view and set the "AcceptValueEvent" property to "True" in the Properties view.

<div class="contents" id="bkmrk--542"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--543"><div class="contents"><div class="textblock"><div drawio-diagram="2671"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466660.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>4\. Select the FlipBook Control in the Scene Tree view and drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Switch Image](https://doc316en.candera.eu/link/647#bkmrk-switch-image)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Value Processing - Effects Behavior](https://doc316en.candera.eu/link/647#bkmrk-effects-value-proces)</span>) from the Toolbox view onto the Receivers of the FlipBook Control's <span style="color: rgb(230, 126, 35);">[Value](https://doc316en.candera.eu/link/647#bkmrk-value)</span> Behavior in the right side of the Scene Tree view.

<div class="contents" id="bkmrk--545"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--546"><div class="contents"><div class="textblock"><div drawio-diagram="2672"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466696.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>5\. Drag&amp;drop an <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) from the Behaviors Panel of the ToolBox onto the FlipBook Control in the SceneTree.

<div class="contents" id="bkmrk--548"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--549"><div class="contents"><div class="textblock"><div drawio-diagram="2673"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466717.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>6\. Select the FlipBook Control in the Scene Tree view and drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) from the Toolbox view onto the Actions of the FlipBook Control's <span style="color: rgb(230, 126, 35);">[OnClick](https://doc316en.candera.eu/link/598#bkmrk-onclick)</span> Behavior in the right side of the Scene Tree view.

<div class="contents" id="bkmrk--551"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--552"><div class="contents"><div class="textblock"><div drawio-diagram="2675"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466750.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>7\. Select the <span style="color: rgb(230, 126, 35);">[Send Value as Event](https://doc316en.candera.eu/link/582#bkmrk-send-value-as-event)</span> Behavior in the right side of the Scene Tree view and set the "Value" propert to "5,00".

<div class="contents" id="bkmrk--554"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--555"><div class="contents"><div class="textblock"><div drawio-diagram="2676"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466761.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>8\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--557"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents" id="bkmrk--558"><div class="contents"><div class="textblock"><div drawio-diagram="2677"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466774.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>9\. When the FlipBook Control is clicked in the Player, the image of the FlipBook is switched.

<div class="contents" id="bkmrk--560"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2678"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677466812.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>
#### Transform Gesture Action Example  


1\. Drag&amp;drop a SolidColorNode from the "Nodes 2D" Panel of the Toolbox to the SceneEditor or the Scene Tree.

<div class="contents" id="bkmrk--562"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--563"><div class="contents"><div class="textblock"><div drawio-diagram="2685"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677471881.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>2\. Select the SolidColorNode's SolodColorBushBlend effect and change the Size properties to 100,00 and 100,0 in the Properties view.   
The SolidColorNode is going to be our touchable content, which should be large enough to touch it with two fingers. This could also be achieved by extending the touchable area of the RenderNode (defining the Bounding Rectangle). But please beware that this will have consequences on the laid out size.

<div class="contents" id="bkmrk--565"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--566"><div class="contents"><div class="textblock"><div drawio-diagram="2686"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677471909.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>3\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Transform Gesture](https://doc316en.candera.eu/link/582#bkmrk-transform-gesture-ac)</span> Action Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Gesture Behavior](https://doc316en.candera.eu/link/582#bkmrk--8)</span>) and a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the SolidColorNode in the SceneTree. The <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior is needed in order for the TextButton Control to receive Input Events.

<div class="contents" id="bkmrk--568"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--569"><div class="contents"><div class="textblock"><div drawio-diagram="2687"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677471949.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>4\. Select the <span style="color: rgb(230, 126, 35);">[Transform Gesture](https://doc316en.candera.eu/link/582#bkmrk-transform-gesture-ac)</span> Action Behavior and configure Panning Minimum and Maximum values for x and y coordinate.

<div class="contents" id="bkmrk--571"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--572"><div class="contents"><div class="textblock"><div drawio-diagram="2688"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677471964.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>5\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--574"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--575"><div class="contents"><div class="textblock"><div drawio-diagram="2689"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677471979.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>6\. When panning the SolidColorNode you can drag it around in the area that has been defined in the <span style="color: rgb(230, 126, 35);">[Transform Gesture](https://doc316en.candera.eu/link/582#bkmrk-transform-gesture-ac)</span> Action Behavior's Panning Properties. If you do have a touch screen available, you can also try pinching and rotating the SolidColorNode.

<div class="contents" id="bkmrk--577"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--578"><div class="contents"><div class="textblock"><div drawio-diagram="2690"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677471997.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>
#### Transform Gesture Condition Example  


1\. Drag&amp;drop a SolidColorNode from the "Nodes 2D" Panel of the Toolbox to the SceneEditor or the Scene Tree.

<div class="contents" id="bkmrk--580"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--581"><div class="contents"><div class="textblock"><div drawio-diagram="2691"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472095.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>2\. Select the SolidColorNode's SolidColorBushBlend effect and change the Size properties to 100,00 and 100,0 in the Properties view.   
The SolidColorNode is going to be our touchable content, which should be large enough to touch it with two fingers. This could also be achieved by extending the touchable area of the RenderNode (defining the Bounding Rectangle). But please beware that this will have consequences on the laid out size.

<div class="contents" id="bkmrk--583"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--584"><div class="contents"><div class="textblock"><div drawio-diagram="2692"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472127.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>3\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Event Handler](https://doc316en.candera.eu/link/598#bkmrk-event-handler)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) and a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the SolidColorNode in the SceneTree. The <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior is needed in order for the TextButton Control to receive Input Events.

<div class="contents" id="bkmrk--586"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--587"><div class="contents"><div class="textblock"><div drawio-diagram="2694"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472255.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>4\. Drag&amp;drop an <span style="color: rgb(230, 126, 35);">[Event Handler](https://doc316en.candera.eu/link/598#bkmrk-event-handler)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) from the Toolbox view onto the SolidColorNode or its parent node in the Scene Tree view.

<div class="contents" id="bkmrk--589"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--590"><div class="contents"><div class="textblock"><div drawio-diagram="2695"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472287.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>5\. Select the SolidColorNode and drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Transform Gesture](https://doc316en.candera.eu/link/597#bkmrk-transform-gesture)</span> Condition Behavior (which is a <span style="color: rgb(230, 126, 35);">[Condition - Input Behavior](https://doc316en.candera.eu/link/597#bkmrk-%C2%A0-1)</span>) onto the <span style="color: rgb(230, 126, 35);">[Event Handler](https://doc316en.candera.eu/link/598#bkmrk-event-handler)</span> EventHandler's Condition on the right side of the Scene Tree View.

<div class="contents" id="bkmrk--592"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--593"><div class="contents"><div class="textblock"><div drawio-diagram="2696"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472332.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>6\. Select the SolidColorNode and drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) onto the <span style="color: rgb(230, 126, 35);">[Event Handler](https://doc316en.candera.eu/link/598#bkmrk-event-handler)</span> EventHandler's Actions on the right side of the Scene Tree View.

<div class="contents" id="bkmrk--595"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--596"><div class="contents"><div class="textblock"><div drawio-diagram="2697"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472363.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>7\. Select the <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> Behavior and change the Color to red.

<div class="contents" id="bkmrk--598"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--599"><div class="contents"><div class="textblock"><div drawio-diagram="2698"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472383.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>8\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--601"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--602"><div class="contents"><div class="textblock"><div drawio-diagram="2699"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472394.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>9\. When a transform gesture is detected, a TransformEvent is sent to the touched node. If the event matches the condition, the configured action will be performed. In our case, when a transform gesture is detected, the SetColor Action will be performed and the SolidColorNode changes its color.

<div class="contents" id="bkmrk--604"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--605"><div class="contents"><div class="textblock"><div drawio-diagram="2700"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472413.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>
#### Swipe Gesture Example  


1\. Drag&amp;drop a SolidColorNode from the "Nodes 2D" Panel of the Toolbox to the SceneEditor or the Scene Tree.

<div class="contents" id="bkmrk--607"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--608"><div class="contents"><div class="textblock"><div drawio-diagram="2701"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472523.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>2\. Select the SolidColorNode's SolidColorBushBlend effect and change the Size properties to 100,00 and 100,0 in the Properties view.   
The SolidColorNode is going to be our touchable content, which should be large enough to touch it with two fingers. This could also be achieved by extending the touchable area of the RenderNode (defining the Bounding Rectangle). But please beware that this will have consequences on the laid out size.

<div class="contents" id="bkmrk--610"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--611"><div class="contents"><div class="textblock"><div drawio-diagram="2702"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472556.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>3\. Drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Event Handler](https://doc316en.candera.eu/link/598#bkmrk-event-handler)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control Behavior](https://doc316en.candera.eu/link/598#bkmrk-page-title)</span>) and a [<span style="color: rgb(230, 126, 35);">Handle Control State</span>](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state) Behavior (which is a <span style="color: rgb(230, 126, 35);">[Control - Internal Behavior](https://doc316en.candera.eu/link/598#bkmrk-internal-control-beh)</span>) from the Behaviors Panel of the ToolBox onto the SolidColorNode in the SceneTree. The <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> Behavior is needed in order for the TextButton Control to receive Input Events.

<div class="contents" id="bkmrk--613"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--614"><div class="contents"><div class="textblock"><div drawio-diagram="2703"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472578.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>4\. Select the SolidColorNode and drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Swipe Gesture](https://doc316en.candera.eu/link/597#bkmrk-swipe-gesture-condit)</span> Condition Behavior (which is a <span style="color: rgb(230, 126, 35);">[Condition - Input Behavior](https://doc316en.candera.eu/link/597#bkmrk-%C2%A0-1)</span>) onto the <span style="color: rgb(230, 126, 35);">[Event Handler](https://doc316en.candera.eu/link/598#bkmrk-event-handler)</span> EventHandler's Condition on the right side of the Scene Tree View.

<div class="contents" id="bkmrk--616"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--617"><div class="contents"><div class="textblock"><div drawio-diagram="2704"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472613.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>5\. Select the <span style="color: rgb(230, 126, 35);">[Swipe Gesture](https://doc316en.candera.eu/link/597#bkmrk-swipe-gesture-condit)</span> Condition Behavior and configure its direction to "Right".

<div class="contents" id="bkmrk--619"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--620"><div class="contents"><div class="textblock"><div drawio-diagram="2705"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472642.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>6\. Select the SolidColorNode and drag&amp;drop a <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> Behavior (which is a <span style="color: rgb(230, 126, 35);">[Action - Property Behavior](https://doc316en.candera.eu/link/582#bkmrk-property-action-beha)</span>) onto the <span style="color: rgb(230, 126, 35);">[Event Handler](https://doc316en.candera.eu/link/598#bkmrk-event-handler)</span> EventHandler's Actions on the right side of the Scene Tree View.

<div class="contents" id="bkmrk--622"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--623"><div class="contents"><div class="textblock"><div drawio-diagram="2706"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472735.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>7\. Select the <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span> Behavior and change the Color to red.

<div class="contents" id="bkmrk--625"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--626"><div class="contents"><div class="textblock"><div drawio-diagram="2707"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472750.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>8\. Copy the EventHandler (with both its Condition and its Action you configured in steps 3 - 6 of this example) by right-clicking on the EventHandler in the right side of the Scene Tree View and choosing "Copy" (or via keyboard shortcut use Ctrl+C). Paste the EventHandler by right-clicking on the Behaviors (the topmost entry, where it says "Behaviors") in the right side of the Scene Scene Tree view and choosing "Paste" (or via keyboard shortcut select the topmost entry where it says "Behaviors" and press Ctrl+V).

<div class="contents" id="bkmrk--628"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--629"><div class="contents"><div class="textblock"><div drawio-diagram="2709"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472811.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>9\. By duplicating the EventHandler you have created "Event Handler\_1" with Condition "Swipe Gesture\_1" and Action "Set Color\_1".

<div class="contents" id="bkmrk--631"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--632"><div class="contents"><div class="textblock"><div drawio-diagram="2710"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472824.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>10\. Select the "Swipe Gesture\_1" Condition and set its Direction to "Left". Select the "Set Color\_1" Action and configure its color to Green.

<div class="contents" id="bkmrk--634"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--635"><div class="contents"><div class="textblock"><div drawio-diagram="2711"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472857.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>11\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--637"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--638"><div class="contents"><div class="textblock"><div drawio-diagram="2712"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472871.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div>12\. In the beginning the SolidColorNode is white. But after a swipe to the right, the SolidColorNode is gets red. If you swipe to the left, the SolidColorNode gets green.

<div class="contents" id="bkmrk-initial-color-after-"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="textblock"><table border="0"><tbody><tr><td valign="top"><div class="image"><div drawio-diagram="2713"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472911.png" alt=""/></div>

</div></td><td valign="top"><div class="image"><div drawio-diagram="2715"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472931.png" alt=""/></div>

</div></td><td valign="top"><div class="image"><div drawio-diagram="2716"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677472948.png" alt=""/></div>

</div></td></tr><tr><td align="center">*Initial color*</td><td align="center">*After swipe right*</td><td align="center">*After swipe left*</td></tr></tbody></table>

</div></div></div></div></div></div></div></div></div></div>
#### Scroll View Example  


1\. Drag&amp;drop a ScrollView Control from the Controls Panel of the Toolbox to the Scene Editor or the Scene Tree.

<div class="contents" id="bkmrk--643"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--644"><div class="contents"><div class="textblock"><div drawio-diagram="2717"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677473077.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>2\. Drag&amp;drop a StackLayout from the "Nodes2D" Panel of the ToolBox onto the ContentAnchor of the ScrollView Control in the Scene Tree.

<div class="contents" id="bkmrk--646"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--647"><div class="contents"><div class="textblock"><div drawio-diagram="2718"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677473134.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>3\. Change the Layouter Arrangement of the StackLayout to "vertical".

<div class="contents" id="bkmrk--649"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--650"><div class="contents"><div class="textblock"><div drawio-diagram="2719"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677473146.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>4\. Drag&amp;drop a Text Control from the Controls Panel, a BitmapNode from the "Nodes2D" Panel of the ToolBox and another Text Control from the Control Panel onto the StackLayout in the Scene Tree.

<div class="contents" id="bkmrk--652"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--653"><div class="contents"><div class="textblock"><div drawio-diagram="2720"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677473184.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>5\. Select a Text Control in the Scene Tree View and set its width to "500" in the Layout Size Properties.

<div class="contents" id="bkmrk--655"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--656"><div class="contents"><div class="textblock"><div drawio-diagram="2721"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677473201.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>6\. In the Control Properties change the Text Property to a longer, several lines long text (newlines can be achieved via *Ctrl+Enter*). Also set the Text Control to be Multiline and enable Word Wrap.

<div class="contents" id="bkmrk--658"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--659"><div class="contents"><div class="textblock"><div drawio-diagram="2722"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677473212.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>7\. Repeat the previous two steps for the second Text Control.

<div class="contents" id="bkmrk--661"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--662"><div class="contents"><div class="textblock"><div drawio-diagram="2723"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677473240.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>8\. Select the BitmapNode in the Scene Tree View before selecting the BitmapBrushBlend Effect on the right side of the Scene Tree View. Adjust the BitmapBrushBlend Effect's image by clicking on the magnifying glass on the right of the input field.

<div class="contents" id="bkmrk--664"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--665"><div class="contents"><div class="textblock"><div drawio-diagram="2724"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677473273.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>9\. Set the BitmapBrushBlend Effect's image property: After clicking the magnifying glass in the properties panel, the "Select Item" Dialog is opened. Select an image from the construction kit (a preview of the image is shown when moving the mouse over the image) and press OK.

<div class="contents" id="bkmrk--667"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--668"><div class="contents"><div class="textblock"><div drawio-diagram="2725"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677473307.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>10\. The SceneEditor now displays the ScrollView and its contents without the possibility to scroll.

<div class="contents" id="bkmrk--670"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--671"><div class="contents"><div class="textblock"><div drawio-diagram="2726"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677473323.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>11\. Select the ScrollView Control in the Scene Tree View and set its Layout Size to a height of "400". After that, a vertical scrollbar is displayed in the SceneEditor.

<div class="contents" id="bkmrk--673"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--674"><div class="contents"><div class="textblock"><div drawio-diagram="2727"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677473358.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>12\. Save your solution and start the Player through the Play button (with the option "Generate and Play") in the Toolbar on the top to see the result.

<div class="contents" id="bkmrk--676"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--677"><div class="contents"><div class="textblock"><div drawio-diagram="2728"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677473378.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>13\. The ScrollView is displayed with a full functional scrollbar. When scrolling, you can check that all configured content is available: both Text Controls and one BitmapNode.

<div class="contents" id="bkmrk--679"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="2729"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677473392.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div></div></div>
#### Process Value Changed Event - Slider Example  


<div class="contents" id="bkmrk-drag%26drop-a-slider-a"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents">

1. Drag&amp;drop a Slider and a TextNode2D from the Toolbox into the Scene Editor or the Scene Tree and arrange them in a way that both are clearly visible.  
    
    [![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/YCOgrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/YCOgrafik.png)
2. Drag&amp;drop a Process Value Changed Event from the Toolbox onto the Slider in the Scene Tree.
3. Select the Slider in the Scene Tree and drag&amp;drop a Format String Behavior into the right side of the Scene Tree onto the Receivers part of the Process Value Changed Event.  
    
    [![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/Wzngrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/Wzngrafik.png)
4. Drag the Format String Behavior from the Slider's Process Value Changed Event's Receivers and drop it onto the TextNode in the Scene tree.
    
    [![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/Gx8grafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/Gx8grafik.png)
5. Select the TextNode2D in the Scene Tree, so that its behaviors get visible on the right side of the Scene Tree and select the Format String Behavior. In the Properties panel configure the Text to "%d" so that the TextNode2D can correctly display the value given by the Slider  
    
    [![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/mzografik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/mzografik.png)
6. You can test the functionality already without starting the Player: Select the Slider and change its Value in the Properties panel (confirm the value by hitting the &lt;Enter&gt; key). The TextNode2D will always display the current value of the Slider.
    
    [![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/orOgrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/orOgrafik.png)
7. You can also start the Player. Manipulating the Slider knob will change the Slider's value. The TextNode2D will get updated whenever the Slider's value is changed, it will always display the Slider's value.[![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/grafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/grafik.png)

</div></div></div></div></div></div></div></div></div>
#### Process Value Changed Event - State Machine Example

<div class="contents" id="bkmrk--681"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div id="bkmrk--682"></div><div class="header" id="bkmrk--683"></div></div></div></div></div></div></div></div></div></div>1\. Drag&amp;drop a Button and a TextNode2D from the Toolbox into the Scene Editor or Scene Tree and arrange them in a way that both are clearly visible.

[![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/2lVgrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/2lVgrafik.png)

<div class="contents" id="bkmrk--685"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--686"><div class="contents"><div class="textblock">  
</div></div></div></div></div></div></div></div></div></div></div></div>2\. Create a new State Machine through the menu "State Machine" - "New State Machine...", which will open the "Add New State Machine" dialog. Adapt the State Machine's name to your needs and press "OK".

[![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/OJEgrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/OJEgrafik.png)

<div class="contents" id="bkmrk--688"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--689"><div class="contents"><div class="textblock">  
</div></div></div></div></div></div></div></div></div></div></div></div>3\. Select the created State Machine and make it a global State Machine by checking the "Is Global" property in the Properties panel.

[![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/IGqgrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/IGqgrafik.png)

<div class="contents" id="bkmrk--691"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--692"><div class="contents"><div class="textblock">  
</div></div></div></div></div></div></div></div></div></div></div></div>4\. Double-click your Global State Machine to open it in the State Machine Editor. Drag&amp;drop a State from the tools in the top right corner of the State Machine Editor into the State Machine diagram.

[![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/IARgrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/IARgrafik.png)

<div class="contents" id="bkmrk--694"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--695"><div class="contents"><div class="textblock">  
</div></div></div></div></div></div></div></div></div></div></div></div>5\. Drag&amp;drop a Transition from the tools in the top right corner onto one of the States in the diagram, then move the mouse and click the second state of the diagram, which will draw a Transition from one State to the other.

[![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/ybGgrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/ybGgrafik.png)

<div class="contents" id="bkmrk--697"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--698"><div class="contents"><div class="textblock">  
</div></div></div></div></div></div></div></div></div></div></div></div>6\. Perform the same action again, drawing a Transition in the other direction.

[![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/p5xgrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/p5xgrafik.png)

<div class="contents" id="bkmrk--700"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--701"><div class="contents"><div class="textblock">  
</div></div></div></div></div></div></div></div></div></div></div></div>7\. Select a State and add an OnEntry Action. To do this, press the "+" sign. Choose the "Send Value Changed As Event" from the drop-down list and configure a Float value of "1.00".

[![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/hSNgrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/hSNgrafik.png)

<div class="contents" id="bkmrk--703"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--704"><div class="contents"><div class="textblock">  
</div></div></div></div></div></div></div></div></div></div></div></div>8\. Click the magnifying glass next to the Target Node property to open the "Choose Item" dialog, where you can select the Scene's TextNode2D.

[![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/37cgrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/37cgrafik.png)

<div class="contents" id="bkmrk--706"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--707"><div class="contents"><div class="textblock">  
</div></div></div></div></div></div></div></div></div></div></div></div>9\. Now, select the other State and perform the same action again, but configure a different value in the "Send Value Changed As Event", e.g. a Float value of "2.00".

10\. Drag&amp;drop a "Process Value Changed Event" from the Toolbox onto the TextNode2D in the Scene Tree and drag&amp;drop a "Format String" behavior onto the Receiver's part of the "Process Value Changed Event".

[![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/Yglgrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/Yglgrafik.png)

<div class="contents" id="bkmrk--709"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--710"><div class="contents"><div class="textblock">  
</div></div></div></div></div></div></div></div></div></div></div></div>11\. Select the Format String Behavior and enter "%d" in the Text Property.

[![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/3jEgrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/3jEgrafik.png)

<div class="contents" id="bkmrk--712"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents" id="bkmrk--713"><div class="contents"><div class="textblock">  
</div></div></div></div></div></div></div></div></div></div></div></div>12\. Save your solution and start the Player. Whenever you press the button, a state transition will be performed. Each of the two states is configured with a different value (1.00 or 2.00), which will be sent as event. The TextNode2D will receive this value and display it. So, repeatedly pressing the button will change the displayed value from 1 to 2 and back to 1 etc.

[![grafik.png](https://doc316en.candera.eu/uploads/images/gallery/2023-04/scaled-1680-/3RBgrafik.png)](https://doc316en.candera.eu/uploads/images/gallery/2023-04/3RBgrafik.png)


#### Usecase for Send Value Changed as Event and reception in state machine(s)   


**Triggering State Transitions using Buttons**

This example demonstrates the usage of "Send Value Changed as Event" in combination with a local as well as a global state machine.

**Setting up the Scene**

For this example, two groups are used each with two buttons and a color node. The buttons are used to send events with values "0" and "1". The color node is used to display the corresponding state of the associated state machine.

1\. Drag&amp;Drop a StackLayout onto the scene and rename to "Group"

2\. Drag&amp;Drop a StackLayout onto the root group and rename to "GlobalGroup". Set the property "Layouter &gt; Arrangement" to "Vertical"

3\. Drag&amp;Drop a TextNode into the GlobalGroup and change name and text to "Global". Add two TextButtons rename to "GlobalButton\_Send\_0" and "GlobalButton\_Send\_1" and change the text to "0" and "1". Add a SolidColorNode and rename to "GlobalTarget". Set property "StretchBehavior" to "Fill".

4\. Repeat Step 2. and 3. using "Local" for the names (as displayed in the screenshot).

<div class="contents" id="bkmrk--715"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div drawio-diagram="4110"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-09/drawing-7-1693531116.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>**Setting up the State Machines**

1\. In Solution Explorer in "Solution &gt; State Machines" from the context menu use "Add &gt; New Item…". In the dialog select "StateMachine" and change name to "GlobalChangeColorOnEvent"

2\. Open State Machine Editor by double clicking on the created state machine. It shows an initial state and a state with a transition.

3\. Drag&amp;Drop a new State onto StateMachine canvas. Rename the two states to "Value\_Is\_0" and "Value\_Is\_1".

4\. Drag&amp;Drop a Transition starting from State "Value\_Is\_0" to "Value\_Is\_1". Rename it to "If\_Value\_1". In the property panel in the "Transition" section set the property "Event" to "Value Changed" and property "Condition" to "Check Changed Value". In the "Condition parameters" section set "ConditionOperator" to "Equal" and "ConditionValue" to "Int32" and value "1".

5\. Repeat Step 4. for the transition in opposite direction. Use "If\_Value\_0" as a name, and for the "ConditionValue" property use value "0".

6\. In the "Solution Explorer" clone the state machine "GlobalChangeColorOnEvent" naming it "LocalChangeColorOnEvent".

7\. Set the property settings of the cloned state machine (set "Transition &gt; Event" to "Value Changed", "Transition &gt; Condition" to "Check Changed Value", "Condition parameters &gt; ConditionOperator" to "Equal" and "Condition parameters &gt; ConditionValue" to "Int32" and value "0" and "1", respectively).

**Connecting Scene and StateMachines**

1\. In Scene Tree open "GlobalButton\_Send\_1". From "Behaviors &gt; Action &gt; Property" drag&amp;drop a "Send Value Changed As Event" action onto the buttons "Actions" section in the "Behaviors" tree. In the property panel of the added action, change "Value" to "Int32" and value "1" and "EventDispatchStrategy" to "Bubble".

2\. Repeat Step 1 for the other buttons "GlobalButton\_Send\_0", "LocalButton\_Send\_1", and "LocalButton\_Send\_1", with values set accordingly.

3\. In Solution Explorer open state machine "GlobalChangeColorOnEvent". Select Transition "If\_Value\_1". In the properties panel set "Condition Parameters &gt; Sender" to "Scene2D &gt; Group &gt; GlobalGroup &gt; GlobalButton\_Send\_1".

4\. Repeat Step 3 for Transition "If\_Value\_0" using "GlobalButton\_Send\_0".

5\. In the State Machine Editor, select state "Value\_Is\_0". From "Behaviors &gt; Action &gt; Property" drag&amp;Drop a "Set Color" action onto the "On Entry Actions" section in the transition’s actions editor.

6\. Select the new action and in the properties panel set "TargetNode" to "Scene2D &gt; Group &gt; GlobalGroup &gt; GlobalTarget" and "Color" to a color that is associated with the global value "0" (for example #FFD900FF)

7\. Repeat step 5 and 6 for state "Value\_Is\_1" (using a different color, such as #0E00FFFF)

8\. Repeat Step 3 – 7 for state machine "LocalChangeColorOnEvent" referring to the nodes in "LocalGroup" instead and using different colors (for example #00FF00FF for value "0" and #FF0000FF for value "1").

9\. Select the state machine "GlobalChangeColorOnEvent" and change its property "Is Global" to "true".

10\. In Scene Tree select "Scene2D &gt; Group" and drag&amp;drop a StateMachine behavior onto its behavior tree. In the properties panel set "StateMachine" to "Solution &gt; State Machines &gt; LocalChangeColorOnEvent".

**Result and Conclusion**

Generate and play the solution to see the following result:

<div class="contents" id="bkmrk--718"><div class="contents"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div drawio-diagram="4109"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-09/drawing-7-1693531086.png" alt=""/></div>

</div></div></div></div></div></div></div></div></div>The following aspects have been considered in this example:

<div class="contents" id="bkmrk-a-combination-of-%22se"><div class="contents"><div class="header"><div class="header"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="textblock">

- A combination of "Send Value Changed as Event" action and "Check Changed Value" behavior are used to trigger state transitions in a global and a local state machine.
- The "Send Value Changed as Event" action provides variants for the "EventDispatchStrategy" property. Please refer to <span style="color: rgb(230, 126, 35);">[Behaviors and Events](https://doc316en.candera.eu/link/565#bkmrk-page-title)</span>. In this example, the "Bubble" strategy was applied as it is very simple to understand.
- The global state machine receives all bubbling events that have not been consumed already.
- To avoid that the two state machines react on the same events, the "Sender" property in the condition parameters of the state transitions should be used.

</div></div></div></div></div></div></div></div></div></div></div>#### Set MVG Fill Colour

<div id="bkmrk--721">  
</div><div id="bkmrk-%E3%83%84%E3%83%BC%E3%83%AB%E3%83%9C%E3%83%83%E3%82%AF%E3%82%B9%E3%81%AE%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%AB%EF%BC%9Etouch">

1. Drag and drop TextButton (Controls &gt; Touchable) and MVG Rect  Node (Nodes 2D) from the Toolbox onto the Scene Editor or Scene Tree.  
    <div drawio-diagram="9447"><img src="http://cgi316jp.candera.eu/uploads/images/drawio/2026-01/drawing-4-1767591704.png" alt=""/></div>
2. Select the TextButton node in the Scene Tree.  
    In the Properties panel, under Control &gt; Text, set the value to “Change Color.”  
    <div drawio-diagram="8877"><img src="https://doc316en.candera.eu/uploads/images/drawio/2026-01/drawing-4-1767685309.png" alt=""/></div>
3. Select the TextButton node again in the Scene Tree.  
    In the Extra Scene Tree, add a **Set MVG Fill Color** (Behavior: Action &gt; Property) to Event Handler &gt; Actions by dragging and dropping it from the Toolbox.  
    <div drawio-diagram="8878"><img src="https://doc316en.candera.eu/uploads/images/drawio/2026-01/drawing-4-1767685330.png" alt=""/></div>
4. Select the newly added **Set MVG Fill Color**.  
    In the Properties panel, change Color to any desired color.
5. In the **Set MVG Fill Color** properties, for TargetNode, click the item-selection icon. 
    - The **Choose Item** dialog opens.
6. In Scenes, choose Scene2D &gt; MVG Rect. 
    - The MVG Rect node is now set as the target node.
7. Next, in the Extra Scene Tree, select Condition: Check Click. 
    - Its properties appear in the Properties panel.
8. For the Sender property, click the item-selection icon. 
    - The **Choose Item** dialog opens.
9. In Scenes, choose Scene2D &gt; TextButton.
10. Click the Player button on the top toolbar to launch the Player and verify the result. 
    - When you press the TextButton, the MVG node’s fill color changes.

</div><div id="bkmrk--728">  
</div><div id="bkmrk--729">  
</div>#### Set MVG Stroke Color

<div id="bkmrk-drag-and-drop-textbu">

1. Drag and drop TextButton (Controls &gt; Touchable) and MVG Rect  Node (Nodes 2D) from the Toolbox onto the Scene Editor or Scene Tree.  
    <div drawio-diagram="9447"><img src="http://cgi316jp.candera.eu/uploads/images/drawio/2026-01/drawing-4-1767591704.png" alt=""/></div>
2. Select the TextButton node in the Scene Tree.  
    In the Properties panel, under Control &gt; Text, set the value to “Change Stroke Color.”  
    <div drawio-diagram="8875"><img src="https://doc316en.candera.eu/uploads/images/drawio/2026-01/drawing-4-1767685244.png" alt=""/></div>
3. Select the TextButton node again in the Scene Tree.  
    In the Extra Scene Tree, add a **Set MVG Stroke Color** (Behavior: Action &gt; Property) to Event Handler &gt; Actions by dragging and dropping it from the Toolbox.  
    <div drawio-diagram="8879"><img src="https://doc316en.candera.eu/uploads/images/drawio/2026-01/drawing-4-1767685379.png" alt=""/></div>
4. Select the newly added **Set MVG Stroke Color**.  
    In the Properties panel, change Color to any desired color.
5. In the **Set MVG Stroke Color properties, for TargetNode, click the item-selection icon. 
    - The **Choose Item** dialog opens.
6. In Scenes, choose Scene2D &gt; MVG Rect. 
    - The MVG Rect node is now set as the target node.
7. Next, in the Extra Scene Tree, select Condition: Check Click. 
    - Its properties appear in the Properties panel.
8. For the Sender property, click the item-selection icon. 
    - The **Choose Item** dialog opens.
9. In Scenes, choose Scene2D &gt; TextButton.
10. Click the Player button on the top toolbar to launch the Player and verify the result. 
    - When you press the TextButton, the MVG Rect node’s stroke color changes.

</div><div class="contents" id="bkmrk--737"></div>

# Action Behaviors

#### **Animation Action Behaviors**


##### **Configure and Play Animation**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_animation_action_behavior.html)</small>

Starts, stops, pauses, resumes animations and offers additional properties for configuration. Also sends AnimationEvents with the state of the animation. These Events can be received by an AnimationStateCondition.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%; height: 467.267px;"><tbody><tr style="height: 29.4667px;"><th style="width: 25.0824%; height: 29.4667px;">**Property Name**</th><th style="width: 30.7656%; height: 29.4667px;">**Type**</th><th style="width: 44.1109%; height: 29.4667px;">**Description**</th></tr><tr style="height: 36.8667px;"><td style="width: 25.0824%; height: 36.8667px;">TargetNode  
</td><td style="width: 30.7656%; height: 36.8667px;"><span style="color: rgb(230, 126, 35);">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</span></td><td style="width: 44.1109%; height: 36.8667px;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.  
</td></tr><tr style="height: 37.8667px;"><td style="width: 25.0824%; height: 37.8667px;">Animation</td><td style="width: 30.7656%; height: 37.8667px;">[<span style="color: rgb(230, 126, 35);"><span style="color: rgb(35, 111, 161);">Candera::Animation::AnimationPlayer</span></span>](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_animation_1_1_animation_player.html "AnimationPlayer is an AnimationPlayerBase that animates AnimationBlendedProperties.")</td><td style="width: 44.1109%; height: 37.8667px;">The animation that should be controlled.</td></tr><tr style="height: 46.2667px;"><td style="width: 25.0824%; height: 46.2667px;">Action</td><td style="width: 30.7656%; height: 46.2667px;">CgiStudioControl::AnimationAction::Enum</td><td style="width: 44.1109%; height: 46.2667px;">Action that shall be executed on the animation:  
Start, Stop, Pause, Resume, Speedup, Finish, Change.</td></tr><tr style="height: 46.2667px;"><td style="width: 25.0824%; height: 46.2667px;">Direction</td><td style="width: 30.7656%; height: 46.2667px;">CgiStudioControl::AnimationDirection::Enum</td><td style="width: 44.1109%; height: 46.2667px;">Playback direction of the animation.</td></tr><tr style="height: 29.4667px;"><td style="width: 25.0824%; height: 29.4667px;">Speed</td><td style="width: 30.7656%; height: 29.4667px;">FeatStd::Float</td><td style="width: 44.1109%; height: 29.4667px;">Playback speed of the animation.</td></tr><tr style="height: 60.2667px;"><td style="width: 25.0824%; height: 60.2667px;">RepeatMode  
</td><td style="width: 30.7656%; height: 60.2667px;">FeatStd::Optional&lt;AnimationRepeatMode::Enum&gt;  
</td><td style="width: 44.1109%; height: 60.2667px;">Defines how the animation shall be repeated.

*Possible values: Replay, Bounce*

</td></tr><tr style="height: 46.2667px;"><td style="width: 25.0824%; height: 46.2667px;">RepeatCount  
</td><td style="width: 30.7656%; height: 46.2667px;">FeatStd::Optional&lt;FeatStd::UInt32&gt;</td><td style="width: 44.1109%; height: 46.2667px;">Count of replays. If set to 0 the animation loops till it gets stopped.  
</td></tr><tr style="height: 29.4667px;"><td style="width: 25.0824%; height: 29.4667px;">EventDispatchStrategy  
</td><td style="width: 30.7656%; height: 29.4667px;">EventDispatchStrategyType::Enum</td><td style="width: 44.1109%; height: 29.4667px;">The way the event gets sent.  
</td></tr><tr style="height: 105.067px;"><td style="width: 25.0824%; height: 105.067px;">DedicatedBehavior  
</td><td style="width: 30.7656%; height: 105.067px;">Candera::Behavior\*</td><td style="width: 44.1109%; height: 105.067px;">A dedicated process value behavior that will receive the animation event.

*This property can be set in the right side of the Scene Tree Panel.*

</td></tr></tbody></table>

</div></div></div>**Advanced Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-1" style="width: 100%;"><tbody><tr><th style="width: 25.0824%;">**Property Name**</th><th style="width: 27.8024%;">**Type**</th><th style="width: 47.0741%;">**Description**</th></tr><tr><td style="width: 25.0824%;">FinishTime  
</td><td style="width: 27.8024%;">FeatStd::Optional&lt;Candera::Animation::WorldTimeType&gt;  
</td><td style="width: 47.0741%;">Finish time in milliseconds.

*This property is only available if the property "Action" is checked and set to "Finish".*

</td></tr><tr><td style="width: 25.0824%;">IncreaseSdpeed  
</td><td style="width: 27.8024%;">FeatStd::Optional&lt;FeatStd::Float&gt;</td><td style="width: 47.0741%;">Increased playback speed of the animation. If set and Play is executed again during playback, animation will speed up (can be used only once per animation!). Zero means immediate position seek.

*This property is only available in the following configuration:*

*an "Animation" is configured*

*"Action" is set to "Start" or "SpeedUp"*

*"RepeatMode" is not checked*

*"RepeatCount" is not checked*

</td></tr><tr><td style="width: 25.0824%;">IncreasedSpeedRevertMargin  
</td><td style="width: 27.8024%;">FeatStd::Optional&lt;Candera::Animation::WorldTimeType&gt;</td><td style="width: 47.0741%;">Defines trailing part of animation (in milliseconds) that will be played at normal speed again. If not set, speedup will last until the end of animation.

*This property is only available if property "IncreasedSpeed" is checked.*

</td></tr><tr><td style="width: 25.0824%;">SequenceStartTime  
</td><td style="width: 27.8024%;">FeatStd::Optional&lt;Candera::Animation::SequenceTimeType&gt;</td><td style="width: 47.0741%;">The start point  of the animation. \[ms\]

*This property is only available if an animation is set in the property "Animation".*

</td></tr><tr><td style="width: 25.0824%;">SequenceDurationTime  
</td><td style="width: 27.8024%;">FeatStd::Optional&lt;Candera::Animation::SequenceTimeType&gt;</td><td style="width: 47.0741%;">The duration of the animation. \[ms\]

*This property is only available if an animation is set in the property "Animation".*

</td></tr></tbody></table>

<div class="contents" id="bkmrk-property-name-type-d-0"><div class="contents"><div class="textblock">  
</div></div></div><div class="contents" id="bkmrk--0"><div class="textblock">---

</div></div>#### **Control Action Behaviors**

##### **Breadcrumb Action**<small></small>

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_breadcrumb_action_behavior.html)</small>

An Action Behavior that sends breadcrumb action events. It allows you to control a <span style="color: rgb(230, 126, 35);">[Breadcrumb](https://doc316en.candera.eu/books/controls-and-behaviors/page/common#bkmrk-breadcrumb)</span> or a node with a <span style="color: rgb(230, 126, 35);">[Breadcrumb Behavior](https://doc316en.candera.eu/link/598#bkmrk-%C2%A0-30)</span> attached. This behavior is available for 2D scenes only.

The operations that can be performed are:

<div class="contents" id="bkmrk-setpath---sets-eleme"><div class="contents"><div class="textblock">

- SetPath - sets elements contained in the breadcrumb.
- BackToPrevious - calls breadcrumb to create a path without the last element from the ones existing in the breadcrumb.
- BackToElement - the action will be called if the element exists in the breadcrumb. It will create a path from beginning to the selected element from the breadcrumb.

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-2"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.1928%;">**Property Name**</th><th style="width: 36.8338%;">**Type**</th><th style="width: 46.9734%;">**Description**</th></tr><tr><td style="width: 16.1928%;">Action</td><td style="width: 36.8338%;">CgiStudioControl::AnimationAction::Enum</td><td style="width: 46.9734%;">Action that will be called on the breadcrumb.

*Possible values: SetPath, BackToPrevious, BackToElement*

</td></tr><tr><td style="width: 16.1928%;">Path</td><td style="width: 36.8338%;">String</td><td style="width: 46.9734%;">The path with a separator that will be passed when the action is called. The separator is defined in the receiving breadcrumb.

</td></tr><tr><td style="width: 16.1928%;">BreadcrumbNode</td><td style="width: 36.8338%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 46.9734%;">Breadcrumb Control Node.</td></tr></tbody></table>

</div></div></div><div class="header" id="bkmrk--2"></div>##### **Change Selection**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_change_selection_action_behavior.html)</small>

Sends a ChangeSelectionEvent to the SelectionGroup. The SelectionGroup then sends a ChangeSelectionEvent to all of its receivers. The event is emitted via BubbleEventDispatchStrategy to a SelectionGroupBehavior.

**Common Properties**

This behavior does not have any configurable properties.

<div class="header" id="bkmrk--3"></div>##### **Conditional Action**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_conditional_action_behavior.html)</small>

A conditional action can be used to add further checking of conditions while actions are already performed. E.g. a click may trigger one action in a specific control state and another if this state is not set.<small></small>

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-3"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 17.3053%;">**Property Name**</th><th style="width: 33.2483%;">**Type**</th><th style="width: 49.4464%;">**Description**</th></tr><tr><td style="width: 17.3053%;">Condition</td><td style="width: 33.2483%;">Candera::ConditionBehavior\*</td><td style="width: 49.4464%;">The ConditionBehavior that TriggerBehavior passes a value to and expect a response from to see if Action needs to be invoked.</td></tr><tr><td style="width: 17.3053%;">Actions</td><td style="width: 33.2483%;">Candera::ActionBehaviorArrayProperty</td><td style="width: 49.4464%;">The set of ActionBehaviors that TriggerBehavior invokes in the even that it receives a positive response from Condition.</td></tr><tr><td style="width: 17.3053%;">Postpone</td><td style="width: 33.2483%;">bool</td><td style="width: 49.4464%;">Set this flag to true to perform the actions after all other actions have been performed. This may become necessary if the actions alter the state and other conditional actions may be invoked due to that changed state.</td></tr></tbody></table>

</div></div>##### **Change Drawer State**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_drawer_action_behavior.html)</small>

An Action that allows to hide/show the contents of a <span style="color: rgb(230, 126, 35);">[Drawer](https://doc316en.candera.eu/link/1156#bkmrk-drawer)</span> or a Node with a <span style="color: rgb(230, 126, 35);">[Drawer Behavior](https://doc316en.candera.eu/link/598#bkmrk-drawer-behavior)</span> attached. This behavior is available for 2D scenes only.

The operation that can be performed are: Close, Open or Toggle.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-4"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 20.14%;">**Property Name**</th><th style="width: 41.8863%;">**Type**</th><th style="width: 37.9325%;">**Description**</th></tr><tr><td style="width: 20.14%;">TargetNode</td><td style="width: 41.8863%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 37.9325%;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 20.14%;">Action</td><td style="width: 41.8863%;">CgiStudioControl::DrawerEventType::Enum</td><td style="width: 37.9325%;">The action that should be performed.

*Possible values: Open, Close, Toggle*

</td></tr><tr><td style="width: 20.14%;">EventDispatchStrategy</td><td style="width: 41.8863%;">CgiStudioControl::EventDispatchStrategyType::Enum</td><td style="width: 37.9325%;">The way the event gets sent.

*Possible values: Direct, Broadcast, Bubble, Tunnel, DedicatedBehavior*

</td></tr></tbody></table>

</div></div></div>**Advanced Properties**

<div class="contents" id="bkmrk-property-name-type-d-5"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 20.2719%;">**Property Name**</th><th style="width: 18.2982%;">**Type**</th><th style="width: 61.4299%;">**Description**</th></tr><tr><td style="width: 20.2719%;">DedicatedBehavior</td><td style="width: 18.2982%;">[Candera::Behavior](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_behavior.html "Behaviors are small re-usable functional blocks that communicate via events. Behaviors are based on W...")\*</td><td style="width: 61.4299%;">A dedicated behavior that will receive the event. Only available when Dispatch Strategy is set to 'DedicatedBehavior'.</td></tr></tbody></table>

</div></div>##### **Set Focus**

Sets keyboard focus to the selected control when triggered. Can be used for example to change focus between List controls.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-6"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 14.182%;">**Property Name**</th><th style="width: 26.338%;">**Type**</th><th style="width: 59.4691%;">**Description**</th></tr><tr><td style="width: 14.182%;">TargetNode</td><td style="width: 26.338%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 59.4691%;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 14.182%;">FocusCamera</td><td style="width: 26.338%;">Candera::AbstractNodePointer</td><td style="width: 59.4691%;">Set the camera node for this focus Action.</td></tr></tbody></table>

</div></div>##### **Interpolate Value Action**

Changes the animation mode (for example, SpeedBased) of the InterpolateProcessValue behavior when the relevant action is triggered.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-7"><div class="textblock"><table class="doxtable" style="width: 100%; height: 215.867px;"><tbody><tr style="height: 29.4667px;"><th style="width: 15.5684%; height: 29.4667px;">**Property Name**</th><th style="width: 29.7766%; height: 29.4667px;">**Type**</th><th style="width: 54.6139%; height: 29.4667px;">**Description**</th></tr><tr style="height: 49.0667px;"><td style="width: 15.5684%; height: 49.0667px;">TargetNode</td><td style="width: 29.7766%; height: 49.0667px;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 54.6139%; height: 49.0667px;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr style="height: 57.4667px;"><td style="width: 15.5684%; height: 57.4667px;">Action</td><td style="width: 29.7766%; height: 57.4667px;">InterpolateValueAction::Enum  
</td><td style="width: 54.6139%; height: 57.4667px;">Action that will be called on the interpolate value behavior.

*Possible values: SetMode, Reset*

</td></tr><tr style="height: 79.8667px;"><td style="width: 15.5684%; height: 79.8667px;">AnimationMode</td><td style="width: 29.7766%; height: 79.8667px;">InterpolationAnimationMode::Enum  
</td><td style="width: 54.6139%; height: 79.8667px;">Use the InterpolationAnimationMode to select the desired type of animation in the InterpolateProcessValueBehavior.

*Possible values: SpeedBased, TimeBased, Instant*

</td></tr></tbody></table>

</div></div>##### **Interval Switch Action**

This action changes the state of the interval switch behavior (by selecting a target Node). With this behavior we can set the state to the following values: on, off, blinking.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-8"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.1977%;">**Property Name**</th><th style="width: 25.3291%;">**Type**</th><th style="width: 59.432%;">**Description**</th></tr><tr><td style="width: 15.1977%;">TargetNode</td><td style="width: 25.3291%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 59.432%;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 15.1977%;">SwitchState</td><td style="width: 25.3291%;">IntervalSwitchState::Enum</td><td style="width: 59.432%;">SwitchState: IntervalSwitchState: Enum

*Possible values: On, Off, Blinking*

</td></tr></tbody></table>

</div></div><div class="header" id="bkmrk-back-to-the-menu-6"><div class="headertitle">  
</div></div>##### **Keyboard Action**

Manages keyboard control by executing configured actions such as open, close, toggle, and layout switch on the target keyboard node, using defined layout and auto-hide settings when triggered.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-9"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.804%;">**<span style="text-decoration: underline;"><span style="color: rgb(0, 0, 0); text-decoration: underline;">Property Name</span></span>**</th><th style="width: 26.5606%;">**<span style="text-decoration: underline;"><span style="color: rgb(0, 0, 0); text-decoration: underline;">Type</span></span>**</th><th style="width: 56.5943%;">**<span style="text-decoration: underline;"><span style="color: rgb(0, 0, 0); text-decoration: underline;">Description</span></span>**</th></tr><tr><td style="width: 16.804%;">Action</td><td style="width: 26.5606%;">KeyboardAction::Enum  
</td><td style="width: 56.5943%;">Keyboard action to execute.

*Possible values: Open, Close, Toggle, InvokeKey, ShiftLayout, SwitchLayout, SetConfiguration*

</td></tr><tr><td style="width: 16.804%;">KeyboardNode</td><td style="width: 26.5606%;">Candera::AbstractNodePointer</td><td style="width: 56.5943%;">Keyboard Node.</td></tr><tr><td style="width: 16.804%;">AutoHideKeyboard</td><td style="width: 26.5606%;">bool</td><td style="width: 56.5943%;">Should keyboard be hidden when node loses focus and show again when node is focused?</td></tr></tbody></table>

</div></div></div>**Advanced Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-10" style="width: 100%;"><tbody><tr><th style="width: 16.804%;">**<span style="text-decoration: underline;"><span style="color: rgb(0, 0, 0); text-decoration: underline;">Property Name</span></span>**</th><th style="width: 26.5631%;">**<span style="text-decoration: underline;"><span style="color: rgb(0, 0, 0); text-decoration: underline;">Type</span></span>**</th><th style="width: 56.5917%;">**<span style="text-decoration: underline;"><span style="color: rgb(0, 0, 0); text-decoration: underline;">Description</span></span>**</th></tr><tr><td style="width: 16.804%;">Layout</td><td style="width: 26.5631%;">String</td><td style="width: 56.5917%;">Layout name.

*This property is only available if "Action" is set to "Open", "ShiftLayout" or "SwitchLayout".*

</td></tr><tr><td style="width: 16.804%;">Notifier  
</td><td style="width: 26.5631%;">Candera::AbstractNodePointer</td><td style="width: 56.5917%;">Event sender. If Notifier is invalid then default is node which has attached behavior.

*This property is only available if "Action" is set to "InvokeKey".*

</td></tr><tr><td style="width: 16.804%;">TextNode  
</td><td style="width: 26.5631%;">Candera::AbstractNodePointer</td><td style="width: 56.5917%;">Text node.

*This property is only available if "Action" is set to "InvokeKey".*

</td></tr><tr><td style="width: 16.804%;">ImageNode  
</td><td style="width: 26.5631%;">Candera::AbstractNodePointer</td><td style="width: 56.5917%;">ImageNode node.

*This property is only available if "Action" is set to "InvokeKey".*

</td></tr><tr><td style="width: 16.804%;">FocusNode  
</td><td style="width: 26.5631%;">Candera::AbstractNodePointer</td><td style="width: 56.5917%;">FocusNode node.

*This property is only available if "Action" is set to "InvokeKey".*

</td></tr><tr><td style="width: 16.804%;">Configuration  
</td><td style="width: 26.5631%;">String  
</td><td style="width: 56.5917%;">Keyboard configuration.

*This property is only available if "Action" is set to "SetConfiguration".*

</td></tr></tbody></table>

##### **Map Action**

Call a specified action on selected MapBehavior.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-11"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.8155%;">**Property Name**</th><th style="width: 26.0698%;">**Type**</th><th style="width: 58.0735%;">**Description**</th></tr><tr><td style="width: 15.8155%;">MapNode</td><td style="width: 26.0698%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 58.0735%;">Map node on which this action should be called.</td></tr><tr><td style="width: 15.8155%;">Action</td><td style="width: 26.0698%;">MapAction::Enum</td><td style="width: 58.0735%;">Action that will be called on the MapBehavior.

*Possible values: Reset, Pan, Zoom, Tilt, LookAt, CenterAtLocation, Rotate, SetRotation, ChangeTheme.*

</td></tr><tr><td style="width: 15.8155%;">Latitude</td><td style="width: 26.0698%;">Float</td><td style="width: 58.0735%;">GPS latitude at which the camera looks at.</td></tr><tr><td style="width: 15.8155%;">Longitude</td><td style="width: 26.0698%;">Float</td><td style="width: 58.0735%;">GPS longitude at which the camera looks at.</td></tr><tr><td style="width: 15.8155%;">Zoomlevel</td><td style="width: 26.0698%;">Float</td><td style="width: 58.0735%;">Determines how close is the camera to the ground level.</td></tr><tr><td style="width: 15.8155%;">Bearing</td><td style="width: 26.0698%;">Float</td><td style="width: 58.0735%;">Determines the bearing angle at which the camera is rotated relative to north.</td></tr><tr><td style="width: 15.8155%;">Tilt</td><td style="width: 26.0698%;">Float</td><td style="width: 58.0735%;">Determines the tilt angle at which the camera looks at specified location.</td></tr><tr><td style="width: 15.8155%;">SyleUrl</td><td style="width: 26.0698%;">String</td><td style="width: 58.0735%;">Theme that describes how the map looks like and how is styled.</td></tr></tbody></table>

</div></div>##### **Map Location Action**

Represents a location on the map which can be sent to MapBehavior.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-12"><div class="textblock"><table class="doxtable" style="width: 92.5926%; height: 147.334px;"><tbody><tr style="height: 29.4667px;"><th style="width: 21.7527%; height: 29.4667px;">**Property Name**</th><th style="width: 28.0327%; height: 29.4667px;">**Type**</th><th style="width: 50.1701%; height: 29.4667px;">**Description**</th></tr><tr style="height: 29.4667px;"><td style="width: 21.7527%; height: 29.4667px;">TargetNode</td><td style="width: 28.0327%; height: 29.4667px;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 50.1701%; height: 29.4667px;">Map node on which this action should be called.</td></tr><tr style="height: 29.4667px;"><td style="width: 21.7527%; height: 29.4667px;">Latitude</td><td style="width: 28.0327%; height: 29.4667px;">Float</td><td style="width: 50.1701%; height: 29.4667px;">Latitude of the location.</td></tr><tr style="height: 29.4667px;"><td style="width: 21.7527%; height: 29.4667px;">Longitude</td><td style="width: 28.0327%; height: 29.4667px;">Float</td><td style="width: 50.1701%; height: 29.4667px;">Longitude of the location.</td></tr><tr><td style="width: 21.7527%;">LocationName  
</td><td style="width: 28.0327%;">String  
</td><td style="width: 50.1701%;">Human-readable name of the location.  
</td></tr><tr style="height: 29.4667px;"><td style="width: 21.7527%; height: 29.4667px;">Address</td><td style="width: 28.0327%; height: 29.4667px;">String</td><td style="width: 50.1701%; height: 29.4667px;">Address of the location (usually street name).</td></tr></tbody></table>

</div></div><div class="header" id="bkmrk-back-to-the-menu-9"><div class="headertitle">  
</div></div>##### **Navigation Action**

Invoke a specified navigation action on selected Map

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-13"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>MapNode</td><td>[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td>Map node on which this action should be called.</td></tr><tr><td>Action</td><td>MapNavigationAction::Enum</td><td>Action that will be called on the MapNode.

*Possible values: StartNavi, StopNavi, ReverseRoute*

</td></tr></tbody></table>

</div></div>##### **MenuScreenAction**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_menu_screen_action_behavior.html)</small>

**Description**

Action Behavior which sends MenuScreen action event allows you control the menu screen. The operations it can do are: add, delete element and change screen page. This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-14"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.0626%;">**Property Name**</th><th style="width: 25.4526%;">**Type**</th><th style="width: 58.4436%;">**Description**</th></tr><tr><td style="width: 16.0626%;">Action</td><td style="width: 25.4526%;">MenuScreenAction::Enum</td><td style="width: 58.4436%;">Action that will be called on the menu screen.

*Possible values: EditMode, Delete, SwapRight, SwapLeft, AddScreen, DeleteLastScreen*

</td></tr><tr><td style="width: 16.0626%;">MenuItemNode</td><td style="width: 25.4526%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 58.4436%;">Needed to identify which node should be deleted.</td></tr><tr><td style="width: 16.0626%;">MenuScreenNode</td><td style="width: 25.4526%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 58.4436%;">MenuScreen node to which event will be sent.</td></tr></tbody></table>

</div></div><div class="header" id="bkmrk-back-to-the-menu-11"><div class="headertitle">  
</div></div>##### **Page Indicator Action**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_page_indicator_action_behavior.html)</small>

Sends an event to PageIndicator from external control (change number of pages, change active index)

It is also used by PageIndicatorElement (ActivateDot) to activate clicked element and to define visual properties of the PageIndicatorElement. This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-15"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 17.5453%;">**Property Name**</th><th style="width: 25.8237%;">**Type**</th><th style="width: 56.5898%;">**Description**</th></tr><tr><td style="width: 17.5453%;">Action</td><td style="width: 25.8237%;">PageIndicatorAction::Enum</td><td style="width: 56.5898%;">Action to perform on PageIndicator (change number of pages, change active index)

*Possible values: ChangeActiveIndex, ChangeNumberOfPages, ActiveDot*

</td></tr></tbody></table>

</div></div></div>**Properties available when *Action* is set to *ChangeActiveIndex* or *ChangeNumberOf Pages***

<table class="doxtable" id="bkmrk-property-name-type-d-16" style="width: 100%;"><tbody><tr><th style="width: 25.453%;">**Property Name**</th><th style="width: 25.8237%;">**Type**</th><th style="width: 48.682%;">**Description**</th></tr><tr><td style="width: 25.453%;">Value</td><td style="width: 25.8237%;">FeatStd::Int32</td><td style="width: 48.682%;">Value to be sent to PageIndicator (for ChangeActiveIndex and ChangeNumberOfPages actions)</td></tr><tr><td style="width: 25.453%;">ChangeValue</td><td style="width: 25.8237%;">ChangeValue::Enum</td><td style="width: 48.682%;">Type of value change to be sent to PageIndicator (for ChangeActiveIndex and ChangeNumberOfPages actions)

*Possible values: Absolute or Relative*

</td></tr><tr><td style="width: 25.453%;">PageIndicatorNode</td><td style="width: 25.8237%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 48.682%;">PageIndicator node to communicate with.</td></tr></tbody></table>

**Properties for usage within PageIndicatorElement (ActivateDot)**

These properties are used only when the behavior is used within PageIndicatorElement and action is set to ActivateDot.

<div class="contents" id="bkmrk-property-name-type-d-17"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 25.453%;">**Property Name**</th><th style="width: 25.8237%;">**Type**</th><th style="width: 48.682%;">**Description**</th></tr><tr><td style="width: 25.453%;">RenderNode  
</td><td style="width: 25.8237%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 48.682%;">Render node for current PageIndicatorElement (used only for PageIndicatorElement)</td></tr><tr><td style="width: 25.453%;">NormalImagePropertyProvider  
</td><td style="width: 25.8237%;">CgiStudioControl::PropertyProviderBehavior\*</td><td style="width: 48.682%;">Property Behavior which contains the image of normal (unselected) PageIndicatorElement (defines visual aspect of current PageIndicatorElement).

*This property can be set in the right side of the Scene Tree panel.*

</td></tr><tr><td style="width: 25.453%;">ActiveImagePropertyProvider  
</td><td style="width: 25.8237%;">CgiStudioControl::PropertyProviderBehavior\*</td><td style="width: 48.682%;">Property Behavior which contains the image of active (selected) PageIndicatorElement (defines visual aspect of current PageIndicatorElement).

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div><div class="header" id="bkmrk-back-to-the-menu-12"><div class="headertitle">  
</div></div>##### **Set Control State**<small></small>

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_set_control_state_action_behavior.html)</small>

Sets the <span style="color: rgb(230, 126, 35);">[state](https://doc316en.candera.eu/books/controls-and-behaviors/page/control-states)</span> of a control by sending an Event to a control considering the selected EventDispatchStrategy.

**Supports:** Any Node with a <span style="color: rgb(230, 126, 35);">[Handle Control State](https://doc316en.candera.eu/link/598#bkmrk-handle-control-state)</span> attached.

**Used in:** <span style="color: rgb(230, 126, 35);">[SpinBox](https://doc316en.candera.eu/link/1156#bkmrk-spinbox)</span>

**See also:** <span style="color: rgb(230, 126, 35);">[Set Image](https://doc316en.candera.eu/link/582#bkmrk-set-image)</span>, <span style="color: rgb(230, 126, 35);">[Set Text](https://doc316en.candera.eu/link/582#bkmrk-set-text)</span>, <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span>

**Example Usage**

<div class="contents" id="bkmrk-hover---hover-leave-"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Hover - Hover Leave Example](https://doc316en.candera.eu/link/572#bkmrk-hover---hover-leave-)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-18"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 19.3987%;">**Property Name**</th><th style="width: 28.0455%;">**Type**</th><th style="width: 52.5146%;">**Description**</th></tr><tr><td style="width: 19.3987%;">State</td><td style="width: 28.0455%;">ControlStateEnum::Enum</td><td style="width: 52.5146%;">Choose the State which has to be changed to True or False.

*Possible values: Selected, Pressed, Enabled, Highlighted, KeyboardFocused, ScopeFocused, Hover, Touched*

</td></tr><tr><td style="width: 19.3987%;">ChangeTo</td><td style="width: 28.0455%;">bool</td><td style="width: 52.5146%;">Switch the state of the control to True or False.</td></tr><tr><td style="width: 19.3987%;">UseForChildNodes  
</td><td style="width: 28.0455%;">bool  
</td><td style="width: 52.5146%;">State change will also affect all child nodes of the target node</td></tr><tr><td style="width: 19.3987%;">EventDispatchStrategy</td><td style="width: 28.0455%;">[EventDispatchStrategyType::Enum](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 52.5146%;">The way the event gets sent.

*Possible values: Direct, Broadcast, Bubble, Tunnel, DedicatedBehavior*

</td></tr><tr><td style="width: 19.3987%;">TargetNode</td><td style="width: 28.0455%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 52.5146%;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr></tbody></table>

</div></div></div>**Advanced Properties**

<div class="contents" id="bkmrk-property-name-type-d-19"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 17.0581%;">**Property Name**</th><th style="width: 17.4308%;">**Type**</th><th style="width: 65.5111%;">**Description**</th></tr><tr><td style="width: 17.0581%;">DedicatedBehavior</td><td style="width: 17.4308%;">[Candera::Behavior](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_behavior.html "Behaviors are small re-usable functional blocks that communicate via events. Behaviors are based on W...")\*</td><td style="width: 65.5111%;">A dedicated behavior that will receive the event.

*This property is only available when Dispatch Strategy is set to 'DedicatedBehavior'.*

</td></tr></tbody></table>

</div></div></div><div class="header" id="bkmrk-back-to-the-menu-13"><div class="headertitle">  
</div></div>##### **Start Timer**<small></small>

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_timer_action_behavior.html)</small>

Start Timer Behavior starts a timer. If the delay time is passed the behavior's node or target node will receive a Timer Event. The Timer Event can then be handled by an Event Handler with a Check Timer Behavior to trigger an action.

**Used in:** <span style="color: rgb(230, 126, 35);">[ScrollBar](https://doc316en.candera.eu/link/1156#bkmrk-scrollbar)</span>

**See also:** <span style="color: rgb(230, 126, 35);">[Check Timer](https://doc316en.candera.eu/link/597#bkmrk-check-timer)</span>, [<span style="color: rgb(230, 126, 35);">OnTimer</span>](https://doc316en.candera.eu/link/598#bkmrk-ontimer)

**Example Usage**

<div class="contents" id="bkmrk-start-timer-example"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Start Timer Example](https://doc316en.candera.eu/link/572#bkmrk-start-timer-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-20"><div class="contents"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>TargetNode</td><td>[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td>The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td>Delay</td><td>FeatStd::UInt32</td><td>Delay time for the timer event (specification in milliseconds)</td></tr></tbody></table>

</div></div></div>---

#### **Custom Action Behaviors** 

##### **Click to Message**

Sends a custom message on invoke action event.

**Common Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-21" style="width: 99.2593%;"><tbody><tr><th style="width: 19.167%;">**Property Name**</th><th style="width: 23.5301%;">**Type**</th><th style="width: 57.3859%;">**Description**</th></tr><tr><td style="width: 19.167%;">Identifier</td><td style="width: 23.5301%;">String</td><td style="width: 57.3859%;">The identifier of the click message.</td></tr></tbody></table>

<div class="header" id="bkmrk-back-to-the-menu-15"><div class="headertitle">  
</div></div>##### **Copy Textures**  


When triggered, the textures of an appearance are used on the appearance of the node. This behavior is available for 3D scenes only.

**Common Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-22" style="width: 99.2593%;"><tbody><tr><th style="width: 19.1701%;">**Property Name**</th><th style="width: 25.6414%;">**Type**</th><th style="width: 55.2715%;">**Description**</th></tr><tr><td style="width: 19.1701%;">TargetNode</td><td style="width: 25.6414%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 55.2715%;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 19.1701%;">Appearance  
</td><td style="width: 25.6414%;">SharedPointer&lt;Candera::Appearance&gt;</td><td style="width: 55.2715%;">The appearance to set on the node.  
</td></tr></tbody></table>

<div class="contents" id="bkmrk--7"><div class="contents"><div class="textblock">---

</div></div></div>#### **Gesture Action Behaviors**

<div class="contents" id="bkmrk--9"></div>##### **Transform Gesture** 

Use the transform gesture action to apply the transformation of a transform gesture event (pan, pinch and rotate) to a node. You can use this behavior as an action or directly without an event handler. This behavior is available for 2D scenes only.

**Pan**

If you touch the Render Node with one finger, the content that you have touched will follow your finger. If you touch it with two fingers the point of the content that hits the center between your fingers will follow the center between your fingers.

<div class="contents" id="bkmrk-use-the-maximum%2Fmini"><div class="contents"><div class="textblock">

- Use the Maximum/Minimum properties for X/Y to limit the movement of the position to a certain area.
- Use the Pan mode selector to limit the transformation to X or Y axis.
- Deactivate the Pan to disallow any position change.

</div></div></div>**Pinch**

If you pinch/stretch the content with your fingers the content will be scaled down/up.

<div class="contents" id="bkmrk-use-the-maximum%2Fmini-0"><div class="contents"><div class="textblock">

- Use the Maximum/Minimum properties to limit the absolute scale of the node.
- Use the Pinch mode selector to either limit the scaling to X or Y axis or to switch to non-uniform scaling where both axis are scaled individually.
- Deactivate the Pinch to disallow any scale change.

</div></div></div>**Rotate**

If you touch the content with two fingers and drag them around the rotation change of the line between your fingers will be applied on the content.

<div class="contents" id="bkmrk-use-the-maximum%2Fmini-1"><div class="contents"><div class="textblock">

- Use the Maximum/Minimum properties to limit the absolute scale of the node.
- Use the Pinch mode selector to either limit the scaling to X or Y axis or to switch to none uniform scaling where both axis are scaled individually.

</div></div></div><p class="callout info">Only if all transformations are allowed the content is able to follow your fingers. Otherwise there may be a displacement that matches the configuration but not the finger position (e.g. if the pan/scale is locked to an axis or Rotation is disabled but scale is still set to uniform scale). The default values are chosen to most fit the common use cases (e.g. it is more likely that uniform scale is required than a non-uniform scale).</p>

**Example Usage**

<div class="contents" id="bkmrk-transform-gesture-ac-0"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Transform Gesture Example](https://doc316en.candera.eu/link/572#bkmrk-transform-gesture-ac)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-23"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 18.4102%;">**Property Name**</th><th style="width: 36.4531%;">**Type**</th><th style="width: 45.0955%;">**Description**</th></tr><tr><td style="width: 18.4102%;">TargetNode</td><td style="width: 36.4531%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 45.0955%;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 18.4102%;">Pan</td><td style="width: 36.4531%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;PanGestureType::Enum&gt;</td><td style="width: 45.0955%;">The pan transformation of a pan gesture is applied to the node.</td></tr><tr><td style="width: 18.4102%;">Pinch</td><td style="width: 36.4531%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;PinchGestureType::Enum&gt;</td><td style="width: 45.0955%;">The scale transformation of a pinch gesture is applied to the node.</td></tr><tr><td style="width: 18.4102%;">Rotate</td><td style="width: 36.4531%;">bool</td><td style="width: 45.0955%;">The rotate transformation of a rotate gesture is applied to the node.</td></tr></tbody></table>

</div></div></div></div>**Advanced Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-24" style="width: 100%;"><tbody><tr><th style="width: 20.8814%;">**Property Name**</th><th style="width: 29.661%;">**Type**</th><th style="width: 49.4165%;">**Description**</th></tr><tr><td style="width: 20.8814%;">PanMinimumX</td><td style="width: 29.661%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;FeatStd::Float&gt;</td><td style="width: 49.4165%;">The minimum pan X value.

*This property is only available if panning in x direction is enabled.*

</td></tr><tr><td style="width: 20.8814%;">PanMinimumY</td><td style="width: 29.661%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;FeatStd::Float&gt;</td><td style="width: 49.4165%;">The minimum pan Y value.

*This property is only available if panning in y direction is enabled.*

</td></tr><tr><td style="width: 20.8814%;">PanMaximumY</td><td style="width: 29.661%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;FeatStd::Float&gt;</td><td style="width: 49.4165%;">The maximum pan X value.

*This property is only available if panning in x direction is enabled.*

</td></tr><tr><td style="width: 20.8814%;">PanMaximumX</td><td style="width: 29.661%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;FeatStd::Float&gt;</td><td style="width: 49.4165%;">The maximum pan Y value.

*This property is only available if panning in y direction is enabled.*

</td></tr><tr><td style="width: 20.8814%;">PinchMinimumX</td><td style="width: 29.661%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;FeatStd::Float&gt;</td><td style="width: 49.4165%;">The minimum pinch X value.

*This property is only available if pinching in x direction is enabled.*

</td></tr><tr><td style="width: 20.8814%;">PinchMinimumY</td><td style="width: 29.661%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;FeatStd::Float&gt;</td><td style="width: 49.4165%;">The minimum pinch Y value.

*This property is only available if pinching in y direction is enabled.*

</td></tr><tr><td style="width: 20.8814%;">PinchMaximumX</td><td style="width: 29.661%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;FeatStd::Float&gt;</td><td style="width: 49.4165%;">The maximum pinch X value.

*This property is only available if pinching in x direction is enabled.*

</td></tr><tr><td style="width: 20.8814%;">PinchMaximumY</td><td style="width: 29.661%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;FeatStd::Float&gt;</td><td style="width: 49.4165%;">The maximum pinch Y value.

*This property is only available if pinching in y direction is enabled.*

</td></tr><tr><td style="width: 20.8814%;">PinchMinimumUniform</td><td style="width: 29.661%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;FeatStd::Float&gt;</td><td style="width: 49.4165%;">The minimum pinch uniform value.

*This property is only available if pinching is enabled and configured for ScaleUniform.*

</td></tr><tr><td style="width: 20.8814%;">PinchMaximumUniform</td><td style="width: 29.661%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;FeatStd::Float&gt;</td><td style="width: 49.4165%;">The maximum pinch uniform value.

*This property is only available if pinching is enabled and configured for ScaleUniform.*

</td></tr><tr><td style="width: 20.8814%;">RotateMinimum</td><td style="width: 29.661%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;FeatStd::Float&gt;</td><td style="width: 49.4165%;">The minimum rotate value

*This property is only available if rotation is enabled.*

</td></tr><tr><td style="width: 20.8814%;">RotateMaximum</td><td style="width: 29.661%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;FeatStd::Float&gt;</td><td style="width: 49.4165%;">The maximum rotate value

*This property is only available if rotation is enabled.*

</td></tr></tbody></table>

<div class="contents" id="bkmrk--10"><div class="textblock">---

</div></div>#### **Property Action Behaviors**

<div class="header" id="bkmrk--4"></div>
##### **Set Appearance**

Sets or changes the appearance of a 3D node. Adjusts its material, color, transparency, or texture to update how the node looks when triggered. This behavior is available for 3D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-25"><div class="contents"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 18.4102%;">**Property Name**</th><th style="width: 36.4531%;">**Type**</th><th style="width: 45.0955%;">**Description**</th></tr><tr><td style="width: 18.4102%;">TargetNode</td><td style="width: 36.4531%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 45.0955%;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 18.4102%;">PropertyReference  
</td><td style="width: 36.4531%;">PropertyReference::Enum</td><td style="width: 45.0955%;">Choose how the property gets set. Via own property or from another Behavior.

*Possible values: Self, Other*

</td></tr><tr><td style="width: 18.4102%;">Appearance  
</td><td style="width: 36.4531%;">SharedPointer&lt;Candera::Appearance&gt;</td><td style="width: 45.0955%;">The appearance to set on the node.

*This property is only available if the PropertyReference is set to "Self".*

</td></tr><tr><td style="width: 18.4102%;">PropertyProvider  
</td><td style="width: 36.4531%;">PropertyProviderBehavior\*</td><td style="width: 45.0955%;">Property Behavior which contains the color which has to be set on the effect.

*This property is only available if the PropertyReference is set to "Other".*

</td></tr><tr><td style="width: 18.4102%;">UseAsDefault  
</td><td style="width: 36.4531%;">bool  
</td><td style="width: 45.0955%;">True if the image shall be used as default image.</td></tr></tbody></table>

</div></div></div></div></div>##### **Send Value as Event**<small></small>

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_change_value_action_behavior.html)</small>

Sends out a new value. Associated controls with a value property receive the new value.

**Example Usage**

<div class="contents" id="bkmrk-format-string-exampl"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Format String Example](https://doc316en.candera.eu/link/572#bkmrk-format-string-exampl)</span>
- <span style="color: rgb(230, 126, 35);">[Interpolate Value Example](https://doc316en.candera.eu/link/572#bkmrk-interpolate-value-ex)</span>
- <span style="color: rgb(230, 126, 35);">[Move Node Example](https://doc316en.candera.eu/link/572#bkmrk-move-node-example)</span>
- <span style="color: rgb(230, 126, 35);">[Send Value As Event Example](https://doc316en.candera.eu/link/572#bkmrk-%C2%A0-5)</span>
- <span style="color: rgb(230, 126, 35);">[Set Position Example](https://doc316en.candera.eu/link/572#bkmrk-set-position-example)</span>
- <span style="color: rgb(230, 126, 35);">[Set Rotation Example](https://doc316en.candera.eu/link/572#bkmrk-set-rotation-example)</span>
- <span style="color: rgb(230, 126, 35);">[Switch Image Example](https://doc316en.candera.eu/link/572#bkmrk-switch-image-example)</span>
- <span style="color: rgb(230, 126, 35);">[Set Scale Example](https://doc316en.candera.eu/link/572#bkmrk-set-scale-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-26"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 20.5115%;">**Property Name**</th><th style="width: 28.5412%;">**Type**</th><th style="width: 50.9061%;">**Description**</th></tr><tr><td style="width: 20.5115%;">TargetNode</td><td style="width: 28.5412%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 50.9061%;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 20.5115%;">PropertyReference</td><td style="width: 28.5412%;">CgiStudioControl::PropertyReference::Enum</td><td style="width: 50.9061%;">Choose how the property gets set. Via own property or from another Behavior.

*Possible values: Self, Other*

</td></tr><tr><td style="width: 20.5115%;">ChangeValue</td><td style="width: 28.5412%;">ChangeValue::Enum  
</td><td style="width: 50.9061%;">How the event value shall be handled by the receiving.

*Possible values: Absolute, Relative*

</td></tr><tr><td style="width: 20.5115%;">EventDispatchStrategy</td><td style="width: 28.5412%;">[EventDispatchStrategyType::Enum](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 50.9061%;">The way the event gets sent.

*Possible values: Direct, Broadcast, Bubble, Tunnel, DedicatedBehavior*

</td></tr></tbody></table>

</div></div></div>**Advanced Properties**

<div class="contents" id="bkmrk-property-name-type-d-27"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.9275%;">**Property Name**</th><th style="width: 26.4415%;">**Type**</th><th style="width: 56.5898%;">**Description**</th></tr><tr><td style="width: 16.9275%;">Value</td><td style="width: 26.4415%;">FeatStd::Variant</td><td style="width: 56.5898%;">The value of the event which gets sent.

*This property is only available when the PropertyReference is set to "Self".*

</td></tr><tr><td style="width: 16.9275%;">PropertyProvider</td><td style="width: 26.4415%;">PropertyProviderBehavior\*</td><td style="width: 56.5898%;">Property provider which contains the value which has to be set on the send value as event action.

*This property can be set in the right side of the Scene Tree panel.*

*It is only available when the PropertyReference is set to "Other".*

</td></tr><tr><td style="width: 16.9275%;">DedicatedBehavior</td><td style="width: 26.4415%;">[Candera::ProcessValueBehavior](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_process_value_behavior.html "The ProcessValueBehavior provides a Variant data type which is bindable. A value change results in a ...")\*</td><td style="width: 56.5898%;">The dedicated process value behavior that will receive the change value event.

*This property can be set in the right side of the Scene Tree panel.*

*It is only available if the EventDispatchStrategy is set to "DedicatedBehavior".*

</td></tr></tbody></table>

</div></div><div class="header" id="bkmrk--6"></div>##### **Set Color**<small></small>

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_color_action_behavior.html)</small>

Sets the color of a node with a Color effect attached (e.g. BitmapBrushColorBlend or SolidColorBrush). In 3D, it sets the diffuse color of the material.

**Supports**

<div class="contents" id="bkmrk-controls%3A-text-text-"><div class="contents"><div class="textblock">

- Controls: 
    - Text
    - Text Value
- Effects: 
    - BitmapBrushColorBlend (as used in TextNode)
    - GlBitmapBrushColorMaskBlend
    - GlDropShadowBitmapBrushColorBlend
    - GlFlipBitmapBrushColorBlend
    - GlOutlineBitmapBrushColorBlend
    - SolidColorBrushColorBlend (as used in SolidColorNode)

</div></div></div>**See also:** <span style="color: rgb(230, 126, 35);">[Set Image](https://doc316en.candera.eu/link/582#bkmrk-set-image)</span>, <span style="color: rgb(230, 126, 35);">[Set Text](https://doc316en.candera.eu/link/582#bkmrk-set-text)</span>, <span style="color: rgb(230, 126, 35);">[Set Control State](https://doc316en.candera.eu/link/582#bkmrk-set-control-state)</span>

**Example Usage**

<div class="contents" id="bkmrk-button-thermometer-e"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Thermometer Example](https://doc316en.candera.eu/link/572#bkmrk-thermometer-example)</span>
- <span style="color: rgb(230, 126, 35);">[Hover - Hover Leave Example](https://doc316en.candera.eu/link/572#bkmrk-hover---hover-leave-)</span>
- <span style="color: rgb(230, 126, 35);">[OnClick Example](https://doc316en.candera.eu/link/572#bkmrk-%C2%A0-2)</span>
- <span style="color: rgb(230, 126, 35);">[Set Image Example](https://doc316en.candera.eu/link/572#bkmrk-set-image-example)</span>
- <span style="color: rgb(230, 126, 35);">[Start Timer Example](https://doc316en.candera.eu/link/572#bkmrk-start-timer-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-28"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 20.5192%;">**Property Name**</th><th style="width: 17.6786%;">**Type**</th><th style="width: 61.8023%;">**Description**</th></tr><tr><td style="width: 20.5192%;">Property Reference</td><td style="width: 17.6786%;">PropertyReference::Enum</td><td style="width: 61.8023%;">Choose how the property gets set. Via own property or from another Behavior.

*Possible values: Self, Other*

</td></tr><tr><td style="width: 20.5192%;">Color</td><td style="width: 17.6786%;">Candera::Color</td><td style="width: 61.8023%;">The color to set.

*This property is only available if PropertyReference is set to "Self".*

</td></tr><tr><td style="width: 20.5192%;">Use For Child Nodes</td><td style="width: 17.6786%;">bool</td><td style="width: 61.8023%;">If set to true, also child nodes are affected by this action.</td></tr><tr><td style="width: 20.5192%;">Levels</td><td style="width: 17.6786%;">UInt8</td><td style="width: 61.8023%;">Number of levels to step down through groups. Default is zero.

*This property is only available if UseForChildNodes is checked.*

</td></tr><tr><td style="width: 20.5192%;">TargetNode</td><td style="width: 17.6786%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 61.8023%;">The node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr></tbody></table>

</div></div></div>**Advanced Properties**

<div class="contents" id="bkmrk-property-name-type-d-29"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>Property Provider</td><td>PropertyProviderBehavior\*</td><td>Property Provider which contains the color which has to be set on the effect.

*This property can be set in the right side of the Scene Tree panel.*

*It is only available if PropertyReference is set to"Other".*

</td></tr></tbody></table>

</div></div>##### **Set Image**<small></small>

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_image_action_behavior.html)</small>

Sets or changes the image of a node (such as Bitmap) with an attached effect (BitmapBrush) when an action is triggered. Can be used to update the image property of a BitmapBrush effect when used with OnClick.

**See also:** <span style="color: rgb(230, 126, 35);">[Set Text](https://doc316en.candera.eu/link/582#bkmrk-set-text)</span>, <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span>, <span style="color: rgb(230, 126, 35);">[Set Control State](https://doc316en.candera.eu/link/582#bkmrk-set-control-state)</span>

**Example Usage**

- <span style="color: rgb(230, 126, 35);">[Set Image Example](https://doc316en.candera.eu/link/572#bkmrk-set-image-example)</span>

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-30"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.804%;">**Property Name**</th><th style="width: 22.9819%;">**Type**</th><th style="width: 60.173%;">**Description**</th></tr><tr><td style="width: 16.804%;">Target Node</td><td style="width: 22.9819%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 60.173%;">The node which gets the given image. If not set, then the node where the behavior is attached too, will be modified.</td></tr><tr><td style="width: 16.804%;">Property Reference</td><td style="width: 22.9819%;">PropertyReference::Enum</td><td style="width: 60.173%;">Choose how the property gets set. Via own property or from another Behavior.

*Possible values: Self, Other*

</td></tr><tr><td style="width: 16.804%;">Image</td><td style="width: 22.9819%;">[SharedPointer&lt;Image2D&gt;](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_memory_management_1_1_shared_pointer.html)</td><td style="width: 60.173%;">The image to set on the effect.

*This property is only available for 2D scenes.*

</td></tr><tr><td style="width: 16.804%;">Use As Default</td><td style="width: 22.9819%;">bool</td><td style="width: 60.173%;">True if the image shall be used as default image.</td></tr></tbody></table>

</div></div></div>**Advanced Properties**

<div class="contents" id="bkmrk-property-name-type-d-31"><div class="textblock"><table class="doxtable" style="width: 100%; height: 169.8px;"><tbody><tr style="height: 29.4667px;"><th style="width: 16.6804%; height: 29.4667px;">**Property Name**</th><th style="width: 33.1179%; height: 29.4667px;">**Type**</th><th style="width: 50.284%; height: 29.4667px;">**Description**</th></tr><tr style="height: 57.4667px;"><td style="width: 16.6804%; height: 57.4667px;">Texture</td><td style="width: 33.1179%; height: 57.4667px;">SharedPointer&lt;[Candera::TextureImage](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_texture_image.html "Abstract base class for Texture images.A texture image mainly encapsulates a texture handle in VRAM a...")&gt;</td><td style="width: 50.284%; height: 57.4667px;">The image to set on the appearance.

*This property is only available for 3D scenes.*

</td></tr><tr style="height: 82.867px;"><td style="width: 16.6804%; height: 82.867px;">PropertyProvider</td><td style="width: 33.1179%; height: 82.867px;">PropertyProviderBehavior\*</td><td style="width: 50.284%; height: 82.867px;">Property Provider which contains the color which has to be set on the effect.

*This property can be set in the right side of the Scene Tree panel.*

*It is only available if PropertyReference is set to "Other"*

</td></tr></tbody></table>

</div></div>##### **Set MVG Fill Color**

Sets the fill color of an MVG node using an MVG brush effect (for example, MVGRectBrush) when an action behavior is triggered.

<table class="doxtable" id="bkmrk-property-name-type-d-32" style="width: 100%; height: 163.366px;"><tbody><tr style="height: 29.7017px;"><th style="width: 16.6804%; height: 29.7017px;">**Property Name**</th><th style="width: 33.1179%; height: 29.7017px;">**Type**</th><th style="width: 50.284%; height: 29.7017px;">**Description**</th></tr><tr style="height: 57.4574px;"><td style="width: 16.6804%; height: 57.4574px;">PropertyReference</td><td style="width: 33.1179%; height: 57.4574px;">CgiStudioControl::PropertyReference::Enum    </td><td style="width: 50.284%; height: 57.4574px;">Choose how the property gets set. Via own property or from another Behavior.</td></tr><tr style="height: 29.7017px;"><td style="width: 16.6804%; height: 29.7017px;">Color</td><td style="width: 33.1179%; height: 29.7017px;">Candera::Color</td><td style="width: 50.284%; height: 29.7017px;">The fill color to be set.</td></tr><tr style="height: 46.5057px;"><td style="width: 16.6804%; height: 46.5057px;">PropertyProvider</td><td style="width: 33.1179%; height: 46.5057px;">CgiStudioControl::PropertyProviderBehavior</td><td style="width: 50.284%; height: 46.5057px;">Property Behavior which contains the color which has to be set on the effect.

</td></tr></tbody></table>

##### **Set MVG Stroke Color**

<div class="headertitle" id="bkmrk-sets-the-stroke-%28out">Sets the stroke (outline/border) color of an MVG node using an effect. The color can be applied dynamically when an action behavior is triggered. Can set the stroke color of an MVGArc node when used with OnPress.</div><div class="headertitle" id="bkmrk-property-name-type-d-33"><table class="doxtable" style="width: 100%; height: 163.366px;"><tbody><tr style="height: 29.7017px;"><th style="width: 16.6804%; height: 29.7017px;">**Property Name**</th><th style="width: 33.1179%; height: 29.7017px;">**Type**</th><th style="width: 50.284%; height: 29.7017px;">**Description**</th></tr><tr style="height: 57.4574px;"><td style="width: 16.6804%; height: 57.4574px;">PropertyReference</td><td style="width: 33.1179%; height: 57.4574px;">CgiStudioControl::PropertyReference::Enum    </td><td style="width: 50.284%; height: 57.4574px;">Choose how the property gets set. Via own property or from another Behavior.</td></tr><tr style="height: 29.7017px;"><td style="width: 16.6804%; height: 29.7017px;">Color</td><td style="width: 33.1179%; height: 29.7017px;">Candera::Color</td><td style="width: 50.284%; height: 29.7017px;">The fill color to be set.</td></tr><tr style="height: 46.5057px;"><td style="width: 16.6804%; height: 46.5057px;">PropertyProvider</td><td style="width: 33.1179%; height: 46.5057px;">CgiStudioControl::PropertyProviderBehavior</td><td style="width: 50.284%; height: 46.5057px;">Property Behavior which contains the color which has to be set on the effect.

</td></tr></tbody></table>

</div><div class="headertitle" id="bkmrk-"></div><div class="headertitle" id="bkmrk--8"></div>##### **Render Child Nodes**  


<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_switch_action_behavior.html)</small>

Enables or disables child nodes of a group according to the operation mode. The same float input is used to select a single node or affect multiple nodes. When the action triggred.

**Example Usage**

<div class="contents" id="bkmrk-render-child-nodes-e"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Render Child Nodes Example](https://doc316en.candera.eu/link/572#bkmrk-render-child-nodes-e)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-34"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.0626%;">**Property Name**</th><th style="width: 29.4069%;">**Type**</th><th style="width: 54.4893%;">**Description**</th></tr><tr><td style="width: 16.0626%;">TargetNode</td><td style="width: 29.4069%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 54.4893%;">The node which switches child nodes. If not set, then the node where the behavior is attached to, will modified its children.</td></tr><tr><td style="width: 16.0626%;">Index</td><td style="width: 29.4069%;">Float</td><td style="width: 54.4893%;">Index of the child node which shall be active.</td></tr><tr><td style="width: 16.0626%;">OperationMode</td><td style="width: 29.4069%;">OperationMode::Enum</td><td style="width: 54.4893%;">When set to MultipleNodes, EnableChildNodes will enable the first N children of Group Node. When Operation Mode is set to SingleNode, only the Nth node is enabled.

*Possible values: MultipleNodes, SingleNode*

</td></tr><tr><td style="width: 16.0626%;">Levels</td><td style="width: 29.4069%;">UInt8</td><td style="width: 54.4893%;">Number of levels to step down through groups. Default is zero.</td></tr><tr><td style="width: 16.0626%;">NormalizeValue</td><td style="width: 29.4069%;">bool</td><td style="width: 54.4893%;">If set to true, the received value has to be between 0 and 1 and will be mapped to the number of children. Otherwise the value has to be the index of the child.</td></tr></tbody></table>

</div></div><div class="header" id="bkmrk-back-to-the-menu-23"><div class="headertitle">  
</div></div>##### **Set Text**<small></small>

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_text_action_behavior.html)</small>

Sets/Changes the text of a TextNode.

**See also:** <span style="color: rgb(230, 126, 35);">[Set Image](https://doc316en.candera.eu/link/582#bkmrk-set-image)</span>, <span style="color: rgb(230, 126, 35);">[Set Color](https://doc316en.candera.eu/link/582#bkmrk-set-color)</span>, <span style="color: rgb(230, 126, 35);">[Set Control State](https://doc316en.candera.eu/link/582#bkmrk-set-control-state)</span>

**Example Usage**

<div class="contents" id="bkmrk-set-text-example"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Set Text Example](https://doc316en.candera.eu/link/572#bkmrk-set-text-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-35"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 17.6689%;">**Property Name**</th><th style="width: 19.028%;">**Type**</th><th style="width: 63.2619%;">**Description**</th></tr><tr><td style="width: 17.6689%;">TargetNode</td><td style="width: 19.028%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 63.2619%;">The Node which gets the given text. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 17.6689%;">PropertyReference</td><td style="width: 19.028%;">PropertyReference::Enum</td><td style="width: 63.2619%;">Choose how the property gets set. Via own property or from another Behavior.

*Possible values: Self, Other*

</td></tr><tr><td style="width: 17.6689%;">Text</td><td style="width: 19.028%;">String</td><td style="width: 63.2619%;">The text that will be set to the Text Node.

*This property is available if the PropertyReference is set to "Self".*

</td></tr></tbody></table>

</div></div></div>**Advanced Properties**

<div class="contents" id="bkmrk-property-name-type-d-36"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>PropertyProvider</td><td>PropertyProviderBehavior\*</td><td>Property Behavior which contains the color which has to be set on the effect.

*This property can be set in the right side of the Scene Tree panel.*

*It is only available if the PropertyReference is configured with "Other".*

</td></tr></tbody></table>

</div></div><div class="header" id="bkmrk-back-to-the-menu-24"><div class="headertitle">  
</div></div>##### **Set Text Style**

Sets the configured text style to a text node when the action is triggered.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-37"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 12.8501%;">**Property Name**</th><th style="width: 25.3218%;">**Type**</th><th style="width: 61.787%;">**Description**</th></tr><tr><td style="width: 12.8501%;">TargetNode</td><td style="width: 25.3218%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 61.787%;">The Node which gets the given text. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 12.8501%;">Style</td><td style="width: 25.3218%;">SharedPointer&lt;TextRendering::SharedStyle&gt;</td><td style="width: 61.787%;">The Style that will be set to the Text Node.</td></tr></tbody></table>

</div></div><div class="header" id="bkmrk-back-to-the-menu-25"><div class="headertitle">  
</div></div>##### **Enable Rendering**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_toggle_action_behavior.html)</small>

If invoked by a TriggerBehavior, changes the visibility of a node.

**Example Usage**

<div class="contents" id="bkmrk-enable-rendering-exa"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Enable Rendering Example](https://doc316en.candera.eu/link/572#bkmrk-enable-rendering-exa)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-38"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.9275%;">**Property Name**</th><th style="width: 18.7809%;">**Type**</th><th style="width: 64.2504%;">**Description**</th></tr><tr><td style="width: 16.9275%;">TargetNode</td><td style="width: 18.7809%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 64.2504%;">The node which gets the visibility flag. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 16.9275%;">Visible</td><td style="width: 18.7809%;">bool</td><td style="width: 64.2504%;">According to this value, the affected node gets rendered or not.</td></tr></tbody></table>

</div></div></div>##### **<span style="color: rgb(0, 0, 0);">Send Value Changed As Event  
</span>**

<span style="color: rgb(0, 0, 0);">Sends out a new value. Associated controls with a value property receive the new value.</span>

**<span style="color: rgb(0, 0, 0);">Example Usage</span>**

<div class="contents" id="bkmrk-process-value-change"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Process Value Changed Event - State Machine Example](https://doc316en.candera.eu/books/controls-and-behaviors/page/examples-using-predefined-behaviors#bkmrk-process-value-change-1)</span>
- [<span style="color: rgb(230, 126, 35);">Usecase for Send Value Changed as Event and reception in state machine(s)</span>](https://doc316en.candera.eu/link/572#bkmrk-usecase-for-send-val)

</div></div>**<span style="color: rgb(0, 0, 0);">Common Properties</span>**

<div class="contents" id="bkmrk-property-name-type-d-39"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.9345%;">**Property Name**</th><th style="width: 18.7853%;">**Type**</th><th style="width: 64.2802%;">**Description**</th></tr><tr><td style="width: 16.9345%;">Value  
</td><td style="width: 18.7853%;">FeatStd::Variant</td><td style="width: 64.2802%;">The value of the event which gets sent.

*This property is only available if PropertyReference is set to "Self".*

</td></tr><tr><td style="width: 16.9345%;">Sender  
</td><td style="width: 18.7853%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 64.2802%;">The node for which the event shall be emitted. If it is not set then the TargetNode or Node (if TargetNode is not set) will be taken instead.</td></tr><tr><td style="width: 16.9345%;">EventDispatchStrategy  
</td><td style="width: 18.7853%;">c</td><td style="width: 64.2802%;">The way the event gets sent.

*Possible values: Direct, Broadcast, Bubble, Tunnel, DedicatedBehavior*

</td></tr><tr><td style="width: 16.9345%;">TargetNode  
</td><td style="width: 18.7853%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 64.2802%;">The node on which the for which the EventDispatchStrategy will be applied. If it is not set then the Node will be taken instead.</td></tr><tr><td style="width: 16.9345%;">PropertyReference  
</td><td style="width: 18.7853%;">PropertyReference::Enum</td><td style="width: 64.2802%;">Choose how the property gets set. Via own property or from another Behavior.

*Possible values: Self, Other*

</td></tr><tr><td style="width: 16.9345%;">Target Node</td><td style="width: 18.7853%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 64.2802%;">The target node to which the events are routed from the source node. If this property is not set, the event will be routed to the node of the behavior.</td></tr></tbody></table>

</div></div></div></div>**Advanced Properties**

<div class="contents" id="bkmrk-property-name-type-d-40"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 17.1746%;">**Property Name**</th><th style="width: 17.4223%;">**Type**</th><th style="width: 65.3619%;">**Description**</th></tr><tr><td style="width: 17.1746%;">DedicatedBehavior  
</td><td style="width: 17.4223%;">ProcessValueBehavior\*</td><td style="width: 65.3619%;">The dedicated process value behavior that will receive the change value event.

*This property can be set in the right side of the Scene Tree panel.*

*It is only available if the EventDispatchStrategy is set to "DedicatedBehavior".*

</td></tr><tr><td style="width: 17.1746%;">PropertyProvider</td><td style="width: 17.4223%;">PropertyProviderBehavior\*</td><td style="width: 65.3619%;">Property Behavior which contains the color which has to be set on the effect.

*This property can be set in the right side of the Scene Tree panel.*

*It is only available if the PropertyReference is set to "Other".*

</td></tr></tbody></table>

</div></div>---

#### **Scroll Action Behaviors**

<div class="header" id="bkmrk--15"><div class="headertitle">  
</div></div>##### **Send Scrollable Event**  


<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_scrollable_event_action_behavior.html)</small>

Enables a scrollable behavior (for example, a List behavior) to scroll to a specific target position based on the selected scrolling type (horizontal or vertical) and value (item-wise or page-wise) when triggered. Can be used to manage the scroll direction of a list control.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-41"><div class="contents"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 19.7683%;">**Property Name**</th><th style="width: 17.2992%;">**Type**</th><th style="width: 62.8913%;">**Description**</th></tr><tr><td style="width: 19.7683%;">Target Node</td><td style="width: 17.2992%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 62.8913%;">The node which is modified. If not set, then the node where the behavior is attached to, will be modified.  
</td></tr><tr><td style="width: 19.7683%;">Direction</td><td style="width: 17.2992%;">Optional&lt;ScrollDirection::Enum&gt;</td><td style="width: 62.8913%;">The direction in which the scroll should be performed.

*Possible values: Vertical, Horizontal*

</td></tr><tr><td style="width: 19.7683%;">Type</td><td style="width: 17.2992%;">ScrollableEventType::Enum</td><td style="width: 62.8913%;">The scrolling type. It can be either relative or absolute scrolling in combination of being either itemwise or pagewise scrolling.</td></tr><tr><td style="width: 19.7683%;">Value</td><td style="width: 17.2992%;">Float</td><td style="width: 62.8913%;">The number of items or pages scrolled to.</td></tr><tr><td style="width: 19.7683%;">TreatAnimationDurationZeroAsNotSet  
</td><td style="width: 17.2992%;">bool  
</td><td style="width: 62.8913%;">When the AnimationDuration is set to 0 it will not be used as a valid animation duration. If a immediate scroll to the target position is intended this flag has to be set to false.</td></tr><tr><td style="width: 19.7683%;">AnimationDuration  
</td><td style="width: 17.2992%;">UInt32  
</td><td style="width: 62.8913%;">Duration of the scrolling animation.</td></tr><tr><td style="width: 19.7683%;">EventDispatchStrategy  
</td><td style="width: 17.2992%;">EventDispatchStrategyType::Enum</td><td style="width: 62.8913%;">The way the event gets sent.

*Possible values: Direct, Broadcast, Bubble, Tunnel, DedicatedBehavior*

</td></tr></tbody></table>

</div></div></div></div></div>**Advanced Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-42" style="width: 100%;"><tbody><tr><th style="width: 19.7694%;">**Property Name**</th><th style="width: 17.2982%;">**Type**</th><th style="width: 62.8913%;">**Description**</th></tr><tr><td style="width: 19.7694%;">DedicatedBehavior  
</td><td style="width: 17.2982%;">Behavior\*</td><td style="width: 62.8913%;">The dedicated process value behavior that will receive the change value event.

*This property can be set in the right side of the Scene Tree panel.*

*It is only available if the EventDispatchStrategy is set to "DedicatedBehavior".*

</td></tr></tbody></table>

<div class="contents" id="bkmrk--16"><div class="textblock">---

</div></div>#### **Streaming Action Behaviors**

<div class="header" id="bkmrk--17"><div class="headertitle"><div class="title">  
</div></div></div>##### **Configure and Play Stream**<small></small>

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_video_stream_action_behavior.html)</small>

Starts, stops, pauses, resumes video streams by emitting an VideoControl Event. These Events can be received by <span style="color: rgb(230, 126, 35);">[Video Stream](https://doc316en.candera.eu/link/646#bkmrk-video-stream)</span> Behaviors.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-43"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 20.0165%;">**Property Name**</th><th style="width: 28.0548%;">**Type**</th><th style="width: 51.8875%;">**Description**</th></tr><tr><td style="width: 20.0165%;">TargetNode</td><td style="width: 28.0548%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 51.8875%;">The node which receives the event. If not set, then the node where the behavior is attached to, will receive it.</td></tr><tr><td style="width: 20.0165%;">Action</td><td style="width: 28.0548%;">VideoControl::Enum</td><td style="width: 51.8875%;">Action that will be executed on the stream.

*Possible values:* *Play, Replay, Pause, Resume, Stop.*

</td></tr><tr><td style="width: 20.0165%;">EventDispatchStrategy</td><td style="width: 28.0548%;">EventDispatchStrategyType::Enum</td><td style="width: 51.8875%;">The strategy in which the event is sent.

*Possible values: Direct, Broadcast, Bubble, Tunnel, DedicatedBehavior.*

</td></tr></tbody></table>

</div></div></div></div>Advanced Properties

<table class="doxtable" id="bkmrk-property-name-type-d-44" style="width: 100%;"><tbody><tr><th style="width: 20.0165%;">**Property Name**</th><th style="width: 20.2652%;">**Type**</th><th style="width: 59.6771%;">**Description**</th></tr><tr><td style="width: 20.0165%;">DedicatedBehavior</td><td style="width: 20.2652%;">[Candera::Behavior](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_behavior.html "Behaviors are small re-usable functional blocks that communicate via events. Behaviors are based on W...")\*</td><td style="width: 59.6771%;">A dedicated behavior that will receive the event.

*This property can be set in the right side of the Scene Tree panel.*

*It is only available if the EventDispatchStrategy is set to "DedicatedBehavior".*

</td></tr></tbody></table>

<div class="contents" id="bkmrk--18"><div class="textblock">---

</div></div>#### **Transition Action Behaviors**

##### **Perform Transition Requests**<small></small>

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_transition_action_behavior.html)</small>

Used to specify whether a node should be activated or deactivated by the transition framework when the associated TransitionActionBehavior is triggered.

Used to execute transitions via TransitionRequestBehaviors.

**See also:** <span style="color: rgb(230, 126, 35);">[Transition Request](https://doc316en.candera.eu/link/582#bkmrk-transition-request-0)</span>

**Example Usage**

<div class="contents" id="bkmrk-perform-transition-r-1"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Perform Transition Requests Example](https://doc316en.candera.eu/link/572#bkmrk-perform-transition-r)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-45"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 13.3498%;">**Property Name**</th><th style="width: 36.833%;">**Type**</th><th style="width: 49.8172%;">**Description**</th></tr><tr><td style="width: 13.3498%;">Requests</td><td style="width: 36.833%;">ArrayProperty&lt;TransitionRequestBehavior \*&gt;</td><td style="width: 49.8172%;">The first TransitionRequestBehavior in the request-set.</td></tr><tr><td style="width: 13.3498%;">Variant</td><td style="width: 36.833%;">String</td><td style="width: 49.8172%;">Default Variant which will be used for attached Requests. Not that Requests can also have their own Variant.</td></tr></tbody></table>

</div></div>##### **Transition Request**<small></small>

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_transition_request_behavior.html)</small>

Used to specify whether a node should be activated or deactivated by the transition framework when the associated TransitionActionBehavior is triggered.

**Example Usage**

<div class="contents" id="bkmrk-perform-transition-r-2"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Perform Transition Requests Example](https://doc316en.candera.eu/link/572#bkmrk-perform-transition-r)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-46"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.3164%;">**Property Name**</th><th style="width: 38.0688%;">**Type**</th><th style="width: 45.6148%;">**Description**</th></tr><tr><td style="width: 16.3164%;">RequestType</td><td style="width: 38.0688%;">CgiStudioControl::TransitionRequestType::Enum</td><td style="width: 45.6148%;">Whether a node should be Activated or Deactivated by the transition. Currently running transitions on a node can be ended using the Finish transition type.

*Possible values: Activate, Deactivate, Finish*

</td></tr><tr><td style="width: 16.3164%;">Variant</td><td style="width: 38.0688%;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 45.6148%;">Variant which will be used for this Request.</td></tr><tr><td style="width: 16.3164%;">Identifier</td><td style="width: 38.0688%;">[Candera::Transitions::Identifier](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_transitions_1_1_identifier.html "Currently known limitation: there is currently no suitable identification available of nodes that are...")</td><td style="width: 45.6148%;">The Node or Scene that will be subject to the transition.</td></tr></tbody></table>

</div></div></div></div><div class="contents" id="bkmrk--19"><div class="contents"><div class="textblock">---

</div></div></div>#### **Views**

##### **Jump to View**

<span style="color: rgb(0, 0, 0);">Use this action to request jump/switching to the configured view (via the configured node). Depending on the view state setup (e.g. with view trees or a state machine) the request will be accepted or denied. The action itself will emit a JumpToViewEvent on the configured node.</span>

**<span style="color: rgb(0, 0, 0);">Common Properties</span>**

<table class="doxtable" id="bkmrk-property-name-type-d-47" style="width: 100%;"><tbody><tr><th style="width: 16.3164%;">**Property Name**</th><th style="width: 38.0688%;">**Type**</th><th style="width: 45.6148%;">**Description**</th></tr><tr><td style="width: 16.3164%;">TargetNode</td><td style="width: 38.0688%;">Candera::AbstractNodePointer</td><td style="width: 45.6148%;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 16.3164%;">View</td><td style="width: 38.0688%;">ViewIdentifier</td><td style="width: 45.6148%;">Identifier of the view that is requested to be shown.</td></tr></tbody></table>

<p class="callout warning">There is **no documentation** for behaviors of the **Internal** subcategory as they are used internally by Scene Composer and **not intended for customer use**.</p>

---

#### **Send Virtual Key**

When triggered the action behavior sends a KeyEvent for down and one frame later a KeyEvent for up

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-48"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 97.6543%;"><tbody><tr><th style="width: 15.388%;">**Property Name**</th><th style="width: 22.4901%;">**Type**</th><th style="width: 62.078%;">**Description**</th></tr><tr><td style="width: 15.388%;">KeyType</td><td style="width: 22.4901%;">KeyType::Enum</td><td style="width: 62.078%;">Choose the type of the key. With KeyCode you can select any key.

*Possible values: KeyCode, Modifier*

</td></tr><tr><td style="width: 15.388%;">Modifier  
</td><td style="width: 22.4901%;">KeyModifierEnum::Enum</td><td style="width: 62.078%;">Modifier Key (e.g. Shift)

*Possible values: None, Key\_Shift, Key\_Alt, Key\_Ctrl, Key\_CapsLock, Key\_Num*

*This property is only available if "KeyType" is set to "Modifier".*

</td></tr><tr><td style="width: 15.388%;">KeyCode  
</td><td style="width: 22.4901%;">KeyboardKeyCode::Enum</td><td style="width: 62.078%;">With KeyCode you can select any key.

*Possible values: Key\_None, ...&lt;all keyboard key codes&gt;... Key\_OEM8*

*This property is only available if "KeyType" is set to "KeyCode".*

</td></tr></tbody></table>

</div></div></div></div>---

#### **Set Culture**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_set_culture_action_behavior.html)</small>

Action Behavior which activates a culture based on its 'locale' value. Receives a locale as value. Invoking the action changes the application culture to a culture fitting to this locale.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-49"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100.494%;"><tbody><tr><th style="width: 18.3866%;">**Property Name**</th><th style="width: 16.5008%;">**Type**</th><th style="width: 65.0603%;">**Description**</th></tr><tr><td style="width: 18.3866%;">Locale</td><td style="width: 16.5008%;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 65.0603%;">Locale of a culture. Invoking the action will set the culture active.</td></tr></tbody></table>

</div></div></div>

# Condition Behaviors

#### **Control Condition Behaviors**

<div class="header" id="bkmrk--0"><div class="headertitle">  
</div></div><div class="title" id="bkmrk--1"></div>##### **Check Animation State**

Checks the current state of an animation (for example, play, paused, or direction changed) from the Configure and Play Animation behavior and triggers an action behavior when the condition is met.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 14.7011%;">**Property Name**</th><th style="width: 30.892%;">**Type**</th><th style="width: 54.3657%;">**Description**</th></tr><tr><td style="width: 14.7011%;">AnimationState</td><td style="width: 30.892%;">AnimationState::Enum</td><td style="width: 54.3657%;">State of the AnimationEvent which fulfills the Condition.

*Possible values: PastEnd, Start, Stop, Finish, Resume, Pause, ApplyChanges, DirectionChange*

</td></tr><tr><td style="width: 14.7011%;">Sender  
</td><td style="width: 30.892%;">SharedPointer&lt;Candera::Animation::AnimationPlayer&gt;</td><td style="width: 54.3657%;">The sender of AnimationEvent.</td></tr></tbody></table>

<dl class="note"></dl></div></div><p class="callout info">When this condition is used in a global state machine, the event dispatch strategy of 'Configure and Play Animation Behavior' must be set to bubble or tunnel.</p>

##### **Check Enter or Exit**

Expects an EnterExit Event (generated by Edit Text Behavior) and returns either a positive or negative response.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-0"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>EnterOrExit</td><td>bool</td><td>True means Enter, false means Exit.</td></tr></tbody></table>

</div></div><div class="header" id="bkmrk--2"><div class="headertitle">  
</div></div>##### **Check Interval Switch**

Checks if the visualization state from the IntervalSwitch behavior matches the configured state (On or Off). Triggers an action when the condition is met. Can be used to check the state of a IntervalSwitch behavior.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-1"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.6873%;">**Property Name**</th><th style="width: 22.6156%;">**Type**</th><th style="width: 60.6971%;">**Description**</th></tr><tr><td style="width: 16.6873%;">VisualizationState</td><td style="width: 22.6156%;">IntervalSwitchState::Enum</td><td style="width: 60.6971%;">If the value (received by the IntervalSwitchConditionBehavior) matches the Visualization State set, it will return a positive response.

*Possible values: On, Off, Blinking*

</td></tr></tbody></table>

</div></div>##### **Check Selection ID** 

Compares the ID from the ChangeSelectionEvent with the ID from its own Control.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-2"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>SelectionCondition</td><td>SelectionConditionEnum::Enum</td><td>The condition that the ID from the ChangeSelectionEvent has to fulfill.

*Possible values: Same, NotSame*

</td></tr></tbody></table>

</div></div><div class="header" id="bkmrk--3"><div class="headertitle">  
</div></div>##### **Check Control State**

Checks a specific state event generated by the ControlState behavior (pressed, enabled, etc.) in conjunction with the configured state and condition (e.g. pressed and is true). If the condition is met, an action behavior is triggered.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-3"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 14.5784%;">**Property Name**</th><th style="width: 17.7939%;">**Type**</th><th style="width: 67.5865%;">**Description**</th></tr><tr><td style="width: 14.5784%;">State</td><td style="width: 17.7939%;">ControlStateEnum::Enum</td><td style="width: 67.5865%;">State which has to be checked.

*Possible values: Selected, Pressed, Enabled, Highlighted, KeyboardFocused, ScopeFocused, Hover, Touched*

</td></tr><tr><td style="width: 14.5784%;">StateCondition</td><td style="width: 17.7939%;">StateConditionEnum::Enum</td><td style="width: 67.5865%;">The condition the state has to fulfill.

*Possible values:* *ChangedToTrue, ChangedToFalse, IsTrue, IsFalse*

</td></tr></tbody></table>

</div></div><div class="header" id="bkmrk--4"><div class="headertitle">  
</div></div>##### **Check Timer**

**See also:** <span style="color: rgb(230, 126, 35);">[Start Timer](https://doc316en.candera.eu/link/582#bkmrk-start-timer)</span>, <span style="color: rgb(230, 126, 35);">[OnTimer](https://doc316en.candera.eu/link/598#bkmrk-ontimer)</span>

Checks the time (in milliseconds) received from the StartTimer behavior. If the timer reaches the configured delay, it invokes an Action behavior. Can be used as a transition condition in a state machine.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-4"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>Sender</td><td style="width: 30.892%;">AbstractNodePointer</td><td style="width: 54.3657%;">The node from which the event has to be emitted. If it is not set then all events of the proper event type are handled.</td></tr></tbody></table>

</div></div>##### **Check Changed Value**

Evaluates the configured value condition. To be used within a trigger behavior to trigger a certain action if the value matches the condition.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-5"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 18.5306%;">**Property Name**</th><th style="width: 27.0625%;">**Type**</th><th style="width: 54.3657%;">**Description**</th></tr><tr><td style="width: 18.5306%;">Sender</td><td style="width: 27.0625%;">AbstractNodePointer</td><td style="width: 54.3657%;">The node from which the event has to be emitted. If it is not set then all events of the proper event type are handled.</td></tr><tr><td style="width: 18.5306%;">ConditionOperator</td><td style="width: 27.0625%;">Operators::Enum</td><td style="width: 54.3657%;">The condition operator.

*Possible values: GreaterThan, LowerThan, Equal, AlmostEqual, GreaterOrEqual, LowerOrEqual*

</td></tr><tr><td style="width: 18.5306%;">ConditionValue</td><td style="width: 27.0625%;">[FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html)</td><td style="width: 54.3657%;">The condition value.</td></tr></tbody></table>

</div></div></div><div class="title" id="bkmrk--5"></div>##### **Check Processed Value**

Checks whether a Value meets certain condition.

The following values can take part in the comparison, depending on the Operation Mode selected:

<div class="contents" id="bkmrk-value-sent-in-proces"><div class="contents"><div class="textblock">

- Value sent in Process Value
- External value from ValueBehavior
- Value set directly in this ValueConditionBehavior

</div></div></div>**Example Usage**

<div class="contents" id="bkmrk-thermometer-example"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Thermometer Example](https://doc316en.candera.eu/link/572#bkmrk-thermometer-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-6"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.6873%;">**Property Name**</th><th style="width: 28.3029%;">**Type**</th><th style="width: 55.0098%;">**Description**</th></tr><tr><td style="width: 16.6873%;">OperationMode</td><td style="width: 28.3029%;">Operators::Enum</td><td style="width: 55.0098%;">Operation mode of behavior, defining which values should be compared.

*Possible values: CompareProcessedValueWithConditionValue, CompareExternalValueWithConditionValue, CompareProcessedValueWithExternalValue*

</td></tr><tr><td style="width: 16.6873%;">ConditionOperator</td><td style="width: 28.3029%;">Operators::Enum</td><td style="width: 55.0098%;">The condition operator.

*Possible values: GreaterThan, LowerThan, Equal, AlmostEqual, GreaterOrEqual, LowerOrEqual*

</td></tr><tr><td style="width: 16.6873%;">ConditionValue</td><td style="width: 28.3029%;">[FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html)</td><td style="width: 55.0098%;">The condition value.

*This property is only available if "OperationMode" is set to "CompareProcessedValueWithConditionValue" or  "CompareExternalValueWithConditionValue".*  
</td></tr><tr><td style="width: 16.6873%;">ValueBehavior</td><td style="width: 28.3029%;">[CgiStudioControl::ValueBehavior](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_value_behavior.html "Receives a ChangeValueEvent and passes its changed value to the receivers (Value Processing Behaviors...") \*</td><td style="width: 55.0098%;">Value behavior to be checked for changes if OperationMode requires external value.

*This property is only available if "OperationMode" is set to "CompareExternalValueWithConditionValue" or "CompareProcessedValueWithExternalValue".*

*This property can be set in the right side of the Scene Tree Panel.*

</td></tr></tbody></table>

</div></div><div class="header" id="bkmrk--6"><div class="headertitle">  
</div></div>##### **Check Video State**

Checks the state of an VideoStateEvent received from an 'Video Stream Behavior'.

Expects a VideoState event (generated by <span style="color: rgb(230, 126, 35);">[Video Stream](https://doc316en.candera.eu/link/646#bkmrk-video-stream)</span> Behavior) and evaluates the configured state condition. To be used within a trigger behavior.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-7"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>VideoState</td><td>VideoState::Enum</td><td>State of the VideoEvent which fulfills the Condition.

*Possible values: Null, Ready, Playing, Paused, EndOfStream*

</td></tr></tbody></table>

</div></div></div></div><div class="contents" id="bkmrk--7"><div class="contents"><div class="textblock">---

</div></div></div>#### **Input Condition Behaviors**

##### **Check Click**

Evaluates the configured click event condition. To be used within a trigger behavior to trigger a certain action.

**Example Usage**

<div class="contents" id="bkmrk-render-child-nodes-e"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Render Child Nodes Example](https://doc316en.candera.eu/link/572#bkmrk-render-child-nodes-e)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-8"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.8155%;">**Property Name**</th><th style="width: 30.5189%;">**Type**</th><th style="width: 53.6244%;">**Description**</th></tr><tr><td style="width: 15.8155%;">Sender</td><td style="width: 30.5189%;">AbstractNodePointer</td><td style="width: 53.6244%;">The node from which the event has to be emitted. If it is not set then all events of the proper event type are handled.</td></tr><tr><td style="width: 15.8155%;">ClickCount</td><td style="width: 30.5189%;">CgiStudioControl::ClickCount::Enum</td><td style="width: 53.6244%;">If the value ClickConditionBehavior receives matches the Click Count set, it will return a positive response.

*Possible values: AnyClick, SingleClick, DoubleClick, TripleClick*

</td></tr><tr><td style="width: 15.8155%;">TouchId</td><td style="width: 30.5189%;">FeatStd::UInt</td><td style="width: 53.6244%;">The id of the finger that performed the click (the default value of 0 indicates the first finger, 1 the second ...).</td></tr></tbody></table>

</div></div>##### **Check Drag Drop**

Evaluates the configured DragDrop event condition. To be used within a trigger behavior to trigger a certain action.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-9"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 14.9506%;">**Property Name**</th><th style="width: 38.9209%;">**Type**</th><th style="width: 46.0873%;">**Description**</th></tr><tr><td style="width: 14.9506%;">Sender</td><td style="width: 38.9209%;">AbstractNodePointer</td><td style="width: 46.0873%;">The node from which the event has to be emitted. If it is not set then all events of the proper event type are handled.</td></tr><tr><td style="width: 14.9506%;">Type</td><td style="width: 38.9209%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;DragDropEventType::Enum&gt;</td><td style="width: 46.0873%;">The optional type of the event. If not provided then any DragDropEvent will be evaluated to true.

*Possible values: Drag, DragMove, Drop, DragEnter, DragLeave*

</td></tr><tr><td style="width: 14.9506%;">TouchId</td><td style="width: 38.9209%;">FeatStd::UInt</td><td style="width: 46.0873%;">The id of the finger that performed the drag (the default value of 0 indicates the first finger, 1 the second ...).</td></tr></tbody></table>

</div></div>##### **Check Hover**

Evaluates the configured Hover event condition. To be used within a trigger behavior to trigger a certain action.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-10"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.1862%;">**Property Name**</th><th style="width: 39.2916%;">**Type**</th><th style="width: 44.4811%;">**Description**</th></tr><tr><td style="width: 16.1862%;">Sender</td><td style="width: 39.2916%;">AbstractNodePointer</td><td style="width: 44.4811%;">The node from which the event has to be emitted. If it is not set then all events of the proper event type are handled.</td></tr><tr><td style="width: 16.1862%;">Type</td><td style="width: 39.2916%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;DragDropEventType::Enum&gt;</td><td style="width: 44.4811%;">The optional type of the event. If not provided then any DragDropEvent will be evaluated to true.

*Possible values: Hover, HoverEnter, HoverLeave*

</td></tr><tr><td style="width: 16.1862%;">TouchId</td><td style="width: 39.2916%;">FeatStd::UInt</td><td style="width: 44.4811%;">The id of the finger that performed the drag (the default value of 0 indicates the first finger, 1 the second ...).</td></tr></tbody></table>

</div></div>##### **Check Key Input**

Checks a received KeyEvent (Control or Node with ControlStateBehavior / 'Handle Control State' must have focus).

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-11"><div class="contents"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>KeyType</td><td>CgiStudioControl::KeyType::KeyCode</td><td>Choose type of key.

*Possible values: KeyCode, Modifier*

</td></tr><tr><td>KeyCode</td><td>Candera::KeyboardKeyCode::Enum</td><td>Check the KeyCode of the pressed key (can also be modifier).

*Possible values: Key\_None, ...&lt;all keyboard key codes&gt;... Key\_OEM8*

*This property is only available if "KeyType" is set to "KeyCode".*

</td></tr></tbody></table>

</div></div></div>Advanced Properties

<div class="contents" id="bkmrk-property-name-type-d-12"><div class="textblock"><table class="doxtable" style="width: 101.358%;"><tbody><tr><th style="width: 14.8267%;">**Property Name**</th><th style="width: 28.4188%;">**Type**</th><th style="width: 56.7134%;">**Description**</th></tr><tr><td style="width: 14.8267%;">Modifier</td><td style="width: 28.4188%;">Candera::KeyModifierEnum::Enum</td><td style="width: 56.7134%;">Check a modifier key.

*Possible values: None, Key\_Shift, Key\_Alt, Key\_Ctrl, Key\_CapsLock, Key\_Num*

*This property is only available if "KeyType" is set to "Modifier".*

</td></tr></tbody></table>

</div></div>##### **Check Pressed**

Evaluates the configured Pressed event condition. To be used within a trigger behavior to trigger a certain action.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-13"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 17.2982%;">**Property Name**</th><th style="width: 39.6623%;">**Type**</th><th style="width: 42.9984%;">**Description**</th></tr><tr><td style="width: 17.2982%;">Sender</td><td style="width: 39.6623%;">AbstractNodePointer</td><td style="width: 42.9984%;">The node from which the event has to be emitted. If it is not set then all events of the proper event type are handled.</td></tr><tr><td style="width: 17.2982%;">Type</td><td style="width: 39.6623%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;DragDropEventType::Enum&gt;</td><td style="width: 42.9984%;">The optional type of the event. If not provided then any DragDropEvent will be evaluated to true.

*Possible values: Pressed, Released, LongPressed*

</td></tr><tr><td style="width: 17.2982%;">TouchId</td><td style="width: 39.6623%;">FeatStd::UInt</td><td style="width: 42.9984%;">The id of the finger that performed the drag (the default value of 0 indicates the first finger, 1 the second ...).</td></tr></tbody></table>

</div></div>##### **Swipe Gesture** 

The swipe condition checks if a swipe/flick has been performed according to the configured settings.

**Configuration**

The type of swipe event and the direction can be configured. By default, it is configured to the end of the swipe (removing the finger from the screen) in any direction. Other configurations are:

***Begin***

The finger has touched the control and moved over the threshold.

<div class="contents" id="bkmrk-the-threshold-in-pix"><div class="contents"><div class="textblock">

- The threshold in pixel is independent of the unit size of the control local coordinate system. You do not have to take care of that transformation.
- The default threshold is set to 10 pixel.
- The threshold can be changed by calling this method: `<a class="el" href="http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_swipe_gesture_detector.html" title="The SwipeGestureDetector handles TouchEvents and emits a SwipeEvent when a Swipe gesture is detected...">CgiStudioControl::SwipeGestureDetector</a>:: GetInstance().SetSwipeDistanceThreshold(…)`.

</div></div></div>***Swiping***

The swipe is in progress and the finger is moving over the screen.

***Flick***

In addition to the Swipe End a Swipe Flick will be sent if the velocity at the Swipe End exceeds the flick velocity threshold.

<div class="contents" id="bkmrk-the-threshold-is-in-"><div class="contents"><div class="textblock">

- The threshold is in pixel per second independent of the unit size of the control local coordinate system. You do not have to take care of that transformation.
- The default threshold is set to 0,01 pixel per second.
- The threshold can be changed by calling this method `<a class="el" href="http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_swipe_gesture_detector.html" title="The SwipeGestureDetector handles TouchEvents and emits a SwipeEvent when a Swipe gesture is detected...">CgiStudioControl::SwipeGestureDetector</a>:: GetInstance().SetFlickVelocityThreshold(…)`.

</div></div></div>***Abort***

An external actor has aborted the swipe. The finger is still on the screen. But the gesture detector will no longer process the swipe gesture. This can be caused for example when a behavior is taking exclusive control over the touch event handling. Like the list behavior does it when it enters touch based scrolling mode.

To limit the condition to a certain direction just enable the direction. The default will be set to left (e.g. a next gesture in a menu screen or delete gesture in a message list). You can change it to Right, Up or Down. The direction is always in the local coordinate system of your control (e.g. if you have to implement a UI for a rotated display you will still receive the swipe up event even if it is swipe right in the display coordinate system).

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-14"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>Type</td><td>[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;SwipeType::Enum&gt;</td><td>The type of the swipe gesture.

*Possible values: Begin, Swiping, End, Flick, Abort*

</td></tr><tr><td>Direction</td><td>[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;SwipeDirection::Enum&gt;</td><td>The direction of the swipe.

*Possible values: Left, Right, Up, Down*

</td></tr></tbody></table>

</div></div>##### **Transform Gesture**

Use this condition to trigger actions in an event handler whenever a transform gesture has been detected (pan, pinch and rotate).

**Common Properties**

This behavior does not have any configurable properties.

---

#### **Logic Condition Behaviors**

##### **Check Logic Condition**

The logic condition combines multiple conditions with the configured logical operation.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-15"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.5637%;">**Property Name**</th><th style="width: 34.8554%;">**Type**</th><th style="width: 48.5809%;">**Description**</th></tr><tr><td style="width: 16.5637%;">Operation</td><td style="width: 34.8554%;">LogicConditionBehaviorOperator::Enum</td><td style="width: 48.5809%;">Specifies logical operator that is used on values returned by the Conditions. The resulting value is returned.

*Possible values: And, Or, XOr*

</td></tr><tr><td style="width: 16.5637%;">Conditions</td><td style="width: 34.8554%;">Candera::ConditionBehaviorArrayProperty</td><td style="width: 48.5809%;">ConditionBehaviors that are combined with the ConditionOperator.</td></tr></tbody></table>

</div></div>##### **Check Not Condition**

Acts as a 'NOT' operand by inverting a value returned by a ConditionBehavior and returns it.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-16"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>Condition</td><td>Candera::ConditionBehavior\*</td><td>ConditionBehavior whose value NotConditionBehavior inverts.</td></tr></tbody></table>

</div></div>---

#### **Scroll Condition Behaviors**

##### **Check Scroll Condition**

Evaluates the configured ScrollableDirectionChanged event condition. The event gets sent from Scroll View Behavior. To be used within a trigger behavior to trigger a certain action.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-17"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.8109%;">**Property Name**</th><th style="width: 19.5349%;">**Type**</th><th style="width: 63.6543%;">**Description**</th></tr><tr><td style="width: 16.8109%;">ScrollDirection</td><td style="width: 19.5349%;">ScrollDirection::Enum</td><td style="width: 63.6543%;">If the value that the ScrollDirectionConditionBehavior receives matches the set ScrollDirection, it will return a positive response.

*Possible values: Vertical, Horizontal*

</td></tr></tbody></table>

</div></div>---

#### **Check Culture Change**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_set_culture_action_behavior.html)</small>

Checks if the culture has changed. This condition is satisfied when the culture matches the culture ID specified in the Local property, and an action behavior is subsequently invoked. Can be used to change the text culture with a button press.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-18"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>Locale</td><td>[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td>Locale of a culture which will be checked.  
</td></tr></tbody></table>

</div></div>

# Control Behaviors

### **Construction Kit Control Behaviors**

#### **Map Control Behaviors**

##### **Map**

Provides the map rendering and navigation functionality.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>TouchableId  
</td><td>String  
</td><td>Touchable Id of the behavior.</td></tr><tr><td>Bearing</td><td>Float</td><td>Clockwise angle relative to North that the users currently faces.</td></tr><tr><td>Longitude</td><td>Candera::Variant</td><td>Longitude of current users location.</td></tr><tr><td>Latitude</td><td>Candera::Variant</td><td>Latitude of current users location.</td></tr><tr><td>SimulateDriving</td><td>bool</td><td>Simulate driving along computed route when in navigation mode.</td></tr><tr><td>NaviMessageNode</td><td>AbstractNodePointer</td><td>Node to which navigation instructions will be sent.</td></tr><tr><td>LocationMesh</td><td>AbstractNodePointer</td><td>Node containing mesh(es) used to render the location indicator.</td></tr><tr><td>RouteOverlayColor</td><td>Candera::Color</td><td>Color used by the route overlay.</td></tr><tr><td>AvoidTolls</td><td>bool</td><td>Avoid tolls during route computation.</td></tr><tr><td>AvoidMotorways</td><td>bool</td><td>Avoid motorways during route computation.</td></tr><tr><td>AvoidFerry</td><td>bool</td><td>Avoid ferrys during route computation.</td></tr></tbody></table>

</div></div>##### **Map Bridge**

Builds a bridge to MapBehavior forwarding touch events.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-0"><div class="contents"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>TouchableId  
</td><td>String  
</td><td>Touchable Id of the behavior.</td></tr><tr><td>TargetNode</td><td>AbstractNodePointer</td><td>Node containing the target MapBehavior to which events will be forwarded.</td></tr></tbody></table>

</div></div></div>---

#### **Scroll Control Behaviors**

##### **List Behavior**

ListBehavior is a list supporting scrolling itemwise and pagewise combined with either relative or absolute scrolling.

**About implicit roles of ChildNodes**

The first child node is used as content (Group2D) and the second as scrollable (Scrollbar).

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-1"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 22.3641%;">**Property Name**</th><th style="width: 20.6343%;">**Type**</th><th style="width: 56.9605%;">**Description**</th></tr><tr><td style="width: 22.3641%;">TouchableId  
</td><td style="width: 20.6343%;">String  
</td><td style="width: 56.9605%;">Touchable Id of the behavior.</td></tr><tr><td style="width: 22.3641%;">ScrollDirection</td><td style="width: 20.6343%;">ScrollDirection::Enum</td><td style="width: 56.9605%;">The direction in which the ListBehavior scrolls.

*Possible values: Vertical, Horizontal*

</td></tr><tr><td style="width: 22.3641%;">Position</td><td style="width: 20.6343%;">FeatStd::Float</td><td style="width: 56.9605%;">The pixel position of the visible content within the list content.</td></tr><tr><td style="width: 22.3641%;">AnimationDuration</td><td style="width: 20.6343%;">FeatStd::UInt32</td><td style="width: 56.9605%;">Duration of the scrolling animation.</td></tr><tr><td style="width: 22.3641%;">DecelerationFactor</td><td style="width: 20.6343%;">FeatStd::Float</td><td style="width: 56.9605%;">Loss of flick animation speed over time.</td></tr><tr><td style="width: 22.3641%;">MaxSpeedPerFlick</td><td style="width: 20.6343%;">FeatStd::Float</td><td style="width: 56.9605%;">Maximum amount of speed each flick motion adds to the flick animation.</td></tr><tr><td style="width: 22.3641%;">MinSpeedPerFlick</td><td style="width: 20.6343%;">FeatStd::Float</td><td style="width: 56.9605%;">Minimum speed required to count a touch gesture as a flick and start or continue the flick animation.</td></tr><tr><td style="width: 22.3641%;">MinMovementToScrolling</td><td style="width: 20.6343%;">FeatStd::UInt32</td><td style="width: 56.9605%;">Minimum distance a touch gesture needs to move to start a scrolling animation.</td></tr><tr><td style="width: 22.3641%;">MaxTouchSampleAge</td><td style="width: 20.6343%;">FeatStd::UInt32</td><td style="width: 56.9605%;">Maximum age in milliseconds of touch movement speed counted towards generating flick animation speed.</td></tr><tr><td style="width: 22.3641%;">Items</td><td style="width: 20.6343%;">ListPropertyType&lt;DataContextItem::SharedPointer&gt;  
</td><td style="width: 56.9605%;">The items property is used for binding of dynamic items. It can only be set via databinding. Only one visible list control should be bound to a fragment list in the model. Otherwise the list fragments in the model are not able to provide data for both list controls. Use a separate list model that is filled with the same data if such a use case is required.</td></tr><tr><td style="width: 22.3641%;">ListFragmentTriggerOffset</td><td style="width: 20.6343%;">FeatStd::SizeType</td><td style="width: 56.9605%;">A dynamic list is requested in fragments to reduce memory consumption and overall performance overhead. This trigger offset value defines an area at the begin and end of the list fragment. Whenever the list shows a part of these areas a new fragment is requested from the model.</td></tr><tr><td style="width: 22.3641%;">ListFragmentSize</td><td style="width: 20.6343%;">FeatStd::SizeType</td><td style="width: 56.9605%;">A dynamic list is requested in fragments to reduce memory consumption and overall performance overhead. This buffer size defines how large this fragment should be. By default it is set to 0 which results in an automatic calculation. The automatic calculation assumes the number of item nodes is configured to match the maximum number of visible nodes for one page. By multiplying this number by three and adding the trigger offset one time for the begin and one additional time for the end to calculate for the automatic buffer size the list has a spare page on each side before a new fragment has to be requested</td></tr><tr><td style="width: 22.3641%;">HandleKeyboardEvents  
</td><td style="width: 20.6343%;">bool  
</td><td style="width: 56.9605%;">Makes the behavior handle KeyboardFocusNavigation events internally.</td></tr><tr><td style="width: 22.3641%;">WrapAround  
</td><td style="width: 20.6343%;">bool  
</td><td style="width: 56.9605%;">Set this flag to true for static list to wrap around the list items on the top and bottom of the list</td></tr></tbody></table>

</div></div></div>##### **Scrollbar**

Reflects the position of the scrollable behavior. E.g. ListBehavior2D.

**About implicit roles of ChildNodes**

A variable number of child nodes is used to control the following features.

\- background: a RenderNode2D used as background  
\- prevItem: a control to navigate to the previous item  
\- nextItem: a control to navigate to the next item  
\- prevPage: a control to navigate to the previous page  
\- nextPage: a control to navigate to the next page  
\- marker: a control used as a thumb

Depending on the number of provided child nodes, the nodes are interpreted as follows.

\- 1 child: marker  
\- 2 children: background, marker  
\- 3 children: prevPage, nextPage, marker  
\- 4 children: background, prevPage, nextPage, marker  
\- 5 children: prevItem, nextItem, prevPage, nextPage, marker  
\- 6 children: background, prevItem, nextItem, prevPage, nextPage, marker

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-2"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%; height: 305.156px;"><tbody><tr style="height: 46.7969px;"><th style="width: 22.2405%; height: 46.7969px;">**Property Name**</th><th style="width: 25.2059%; height: 46.7969px;">**Type**</th><th style="width: 52.5124%; height: 46.7969px;">**Description**</th></tr><tr><td style="width: 22.2405%;">TouchableId  
</td><td style="width: 25.2059%;">String  
</td><td style="width: 52.5124%;">Touchable Id of the behavior.</td></tr><tr style="height: 49.5938px;"><td style="width: 22.2405%; height: 49.5938px;">TouchListenerNode</td><td style="width: 25.2059%; height: 49.5938px;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 52.5124%; height: 49.5938px;">This node defines the area on which the ScrollbarBehavior will listen for the touch events.</td></tr><tr style="height: 52.1875px;"><td style="width: 22.2405%; height: 52.1875px;">ScrollDirection</td><td style="width: 25.2059%; height: 52.1875px;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt; ScrollDirection::Enum &gt;</td><td style="width: 52.5124%; height: 52.1875px;">The direction in which the ListBehavior scrolls. By default it is configured as a vertical scrollbar.</td></tr><tr style="height: 63.3906px;"><td style="width: 22.2405%; height: 63.3906px;">ScrollbarVisibility</td><td style="width: 25.2059%; height: 63.3906px;">ScrollbarVisibility::Enum</td><td style="width: 52.5124%; height: 63.3906px;">Configure the visibility of the scrollbar. By default it is set to Automatic which will determine the visibility based on the actual content.

*Possible values: Automatic, Collapsed, Visible*

</td></tr><tr style="height: 46.5938px;"><td style="width: 22.2405%; height: 46.5938px;">HandleMinimumSize</td><td style="width: 25.2059%; height: 46.5938px;">FeatStd::UInt32</td><td style="width: 52.5124%; height: 46.5938px;">The minimum height (for vertical scrollbar) or minimum width (for horizontal scrollbar) of the handle in pixels.</td></tr><tr style="height: 46.5938px;"><td style="width: 22.2405%; height: 46.5938px;">MinMovementToScrolling</td><td style="width: 25.2059%; height: 46.5938px;">FeatStd::UInt32</td><td style="width: 52.5124%; height: 46.5938px;">Minimum distance a touch gesture needs to move to start scrolling.</td></tr><tr><td style="width: 22.2405%;">ScrollableNode  
</td><td style="width: 25.2059%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 52.5124%;">Node of the scrollable behavior.</td></tr></tbody></table>

</div></div></div>##### **Scroll View**

Scroll View is a Touchable Control that has a ContentAnchor which can be filled with various content. Depending on the size of the content and the configured Scroll View's Layout Size, a horizontal and/or vertical scrollbar appears.

Because of the fact that Scroll View supports horizontal and vertical scrolling, it receives the ScrollableEvent from Send Scrollable Event Behavior (can also be forwarded from a <span style="color: rgb(230, 126, 35);">[Scrollbar Behavior](https://doc316en.candera.eu/link/598#bkmrk-scrollbar-behavior)</span> Scrollbar via <span style="color: rgb(230, 126, 35);">[Event Bridge Behavior](https://doc316en.candera.eu/link/598#bkmrk-event-bridge)</span>).

Example Usage

<div class="contents" id="bkmrk-scroll-view-example"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Scroll View Example](https://doc316en.candera.eu/link/572#bkmrk-scroll-view-example)</span>

</div></div></div>**Common Properties**

This behavior does not have any configurable properties.

**About implicit roles of ChildNodes**

The first child node is used as content (Group2D), the second as vertical scrollbar (Scrollbar) and the third as horizontal scrollbar (Scrollbar).

##### **Snap List Item Configuration**

Allows the user to define the snap position of a list or list item by setting its item alignment (for example, Center) and offset. This is then applied when navigating or scrolling to align the list item. Can be used with the [<span style="color: rgb(230, 126, 35);">List Control</span>](https://doc316en.candera.eu/books/controls-and-behaviors/page/touchable#bkmrk-list).

**Common Properties**

<table border="1" class="doxtable" id="bkmrk-property-name-type-d-4" style="border-collapse: collapse; width: 800px;"><tbody><tr><th style="width: 167.375px;">**Property Name**</th><th style="width: 133.75px;">**Type**</th><th style="width: 497.875px;">**Description**</th></tr><tr><td style="width: 167.375px;">ItemAlignment</td><td style="width: 133.75px;">SnapAlignmentOrientation::Enum</td><td style="width: 497.875px;">The location of the alignment base point within the list item.

*Possible values: Begin, Center, End*

</td></tr><tr><td style="width: 167.375px;">ItemAlignmentOffset</td><td style="width: 133.75px;">FeatStd::Float</td><td style="width: 497.875px;">The offset of the alignment point from the configured alignment base point. For End alignment a positive offset will move the alignment point from the list item end towards the list item begin.

</td></tr><tr><td style="width: 167.375px;">ItemAlignmentOffsetInPercent</td><td style="width: 133.75px;">bool</td><td style="width: 497.875px;">The offset is either in percent (when set to true) or in pixel (when set to false). In case of percent the item size will be taken to calculate the pixel offset.

</td></tr></tbody></table>

##### **Snap List Item Extension**

SnapListItemExtensionBehavior registers a ListBehaviorExtension on the given ListBehavior for snapping the focused item to the configured list according to the snapping configuration of the list and the list item node.

Information on how to use this behavior can be found in the chapter of the [List Control](https://doc316en.candera.eu/books/controls-and-behaviors/page/touchable#bkmrk-list).

**Common Properties**

<table border="1" class="doxtable" id="bkmrk-property-name-type-d-3" style="border-collapse: collapse; width: 800px;"><tbody><tr><th style="width: 152.433px;">**Property Name**</th><th style="width: 154.8px;">**Type**</th><th style="width: 492.1px;">**Description**</th></tr><tr><td style="width: 152.433px;">ListBehavior</td><td style="width: 154.8px;">ListBehavior\*</td><td style="width: 492.1px;">The ListBehavior that shall be extended.

*This property can be set in the right side of the Scene Tree Panel.*

</td></tr><tr><td style="width: 152.433px;">ListAlignment</td><td style="width: 154.8px;">SnapAlignmentOrientation::Enum</td><td style="width: 492.1px;">The location of the alignment base point within the list item.

*Possible values: Begin, Center, End*

</td></tr><tr><td style="width: 152.433px;">ListAlignmentOffset</td><td style="width: 154.8px;">FeatStd::Float</td><td style="width: 492.1px;">The offset of the alignment point from the configured alignment base point. For End alignment a positive offset will move the alignment point from the list item end towards the list item begin.</td></tr><tr><td style="width: 152.433px;">ListAlignmentOffsetInPercent</td><td style="width: 154.8px;">bool</td><td style="width: 492.1px;">The offset is either in percent (when set to true) or in pixel (when set to false). In case of percent the item size will be taken to calculate the pixel offset.</td></tr><tr><td style="width: 152.433px;">ItemAlignment</td><td style="width: 154.8px;">SnapAlignmentOrientation::Enum</td><td style="width: 492.1px;">The location of the alignment base point within the list item. *Possible values: Begin, Center, End*

</td></tr><tr><td style="width: 152.433px;">ItemAlignmentOffset</td><td style="width: 154.8px;">FeatStd::Float</td><td style="width: 492.1px;">The offset of the alignment point from the configured alignment base point. For End alignment a positive offset will move the alignment point from the list item end towards the list item begin.</td></tr><tr><td style="width: 152.433px;">ItemAlignmentOffsetInPercent</td><td style="width: 154.8px;">bool</td><td style="width: 492.1px;">The offset is either in percent (when set to true) or in pixel (when set to false). In case of percent the item size will be taken to calculate the pixel offset.</td></tr></tbody></table>

##### **SubList Behavior**

SubListBehavior extends the ListBehavior by special handling when being used in a child node of a ListBehavior.

SubListBehavior is a list supporting scrolling itemwise and pagewise combined with either relative or absolute scrolling.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-5"><div class="textblock"><table class="doxtable" style="width: 100%; height: 714.934px;"><tbody><tr style="height: 29.4667px;"><th style="width: 22.3641%; height: 29.4667px;">**Property Name**</th><th style="width: 19.2751%; height: 29.4667px;">**Type**</th><th style="width: 58.3196%; height: 29.4667px;">**Description**</th></tr><tr style="height: 29.4667px;"><td style="width: 22.3641%; height: 29.4667px;">TouchableId  
</td><td style="width: 19.2751%; height: 29.4667px;">String  
</td><td style="width: 58.3196%; height: 29.4667px;">Touchable Id of the behavior.</td></tr><tr style="height: 29.4667px;"><td style="width: 22.3641%; height: 29.4667px;">ScrollDirection</td><td style="width: 19.2751%; height: 29.4667px;">ScrollDirection::Enum</td><td style="width: 58.3196%; height: 29.4667px;">The direction in which the SubListBehavior scrolls.

*Possible values: Vertical, Horizontal*

</td></tr><tr style="height: 29.4667px;"><td style="width: 22.3641%; height: 29.4667px;">Position</td><td style="width: 19.2751%; height: 29.4667px;">FeatStd::Float</td><td style="width: 58.3196%; height: 29.4667px;">The pixel position of the visible content within the list content.</td></tr><tr style="height: 29.4667px;"><td style="width: 22.3641%; height: 29.4667px;">AnimationDuration</td><td style="width: 19.2751%; height: 29.4667px;">FeatStd::UInt32</td><td style="width: 58.3196%; height: 29.4667px;">Duration of the scrolling animation.</td></tr><tr style="height: 29.4667px;"><td style="width: 22.3641%; height: 29.4667px;">DecelerationFactor</td><td style="width: 19.2751%; height: 29.4667px;">FeatStd::Float</td><td style="width: 58.3196%; height: 29.4667px;">Loss of flick animation speed over time.</td></tr><tr style="height: 29.4667px;"><td style="width: 22.3641%; height: 29.4667px;">MaxSpeedPerFlick</td><td style="width: 19.2751%; height: 29.4667px;">FeatStd::Float</td><td style="width: 58.3196%; height: 29.4667px;">Maximum amount of speed each flick motion adds to the flick animation.</td></tr><tr style="height: 46.2667px;"><td style="width: 22.3641%; height: 46.2667px;">MinSpeedPerFlick</td><td style="width: 19.2751%; height: 46.2667px;">FeatStd::Float</td><td style="width: 58.3196%; height: 46.2667px;">Minimum speed required to count a touch gesture as a flick and start or continue the flick animation.</td></tr><tr style="height: 46.2667px;"><td style="width: 22.3641%; height: 46.2667px;">MinMovementToScrolling</td><td style="width: 19.2751%; height: 46.2667px;">FeatStd::UInt32</td><td style="width: 58.3196%; height: 46.2667px;">Minimum distance a touch gesture needs to move to start a scrolling animation.</td></tr><tr style="height: 46.2667px;"><td style="width: 22.3641%; height: 46.2667px;">MaxTouchSampleAge</td><td style="width: 19.2751%; height: 46.2667px;">FeatStd::UInt32</td><td style="width: 58.3196%; height: 46.2667px;">Maximum age in milliseconds of touch movement speed counted towards generating flick animation speed.</td></tr><tr style="height: 96.6667px;"><td style="width: 22.3641%; height: 96.6667px;">Items</td><td style="width: 19.2751%; height: 96.6667px;">ListPropertyType&lt; ::Courier::DataContextItem::SharedPointer &gt;</td><td style="width: 58.3196%; height: 96.6667px;">The items property is used for binding of dynamic items. It can only be set via databinding. Only one visible list control should be bound to a fragment list in the model. Otherwise the list fragments in the model are not able to provide data for both list controls. Use a separate list model that is filled with the same data if such a use case is required.</td></tr><tr style="height: 79.8667px;"><td style="width: 22.3641%; height: 79.8667px;">ListFragmentTriggerOffset</td><td style="width: 19.2751%; height: 79.8667px;">FeatStd::SizeType</td><td style="width: 58.3196%; height: 79.8667px;">A dynamic list is requested in fragments to reduce memory consumption and overall performance overhead. This trigger offset value defines an area at the begin and end of the list fragment. Whenever the list shows a part of these areas a new fragment is requested from the model.</td></tr><tr style="height: 163.867px;"><td style="width: 22.3641%; height: 163.867px;">ListFragmentSize</td><td style="width: 19.2751%; height: 163.867px;">FeatStd::SizeType</td><td style="width: 58.3196%; height: 163.867px;">A dynamic list is requested in fragments to reduce memory consumption and overall performance overhead. This buffer size defines how large this fragment should be. By default it is set to 0 which results in an automatic calculation. The automatic calculation assumes the number of item nodes is configured to match the maximum number of visible nodes for one page. By multiplying this number by three and adding the trigger offset one time for the begin and one additional time for the end to calculate for the automatic buffer size the list has a spare page on each side before a new fragment has to be requested</td></tr><tr style="height: 29.4667px;"><td style="width: 22.3641%; height: 29.4667px;">HandleKeyboardEvents  
</td><td style="width: 19.2751%; height: 29.4667px;">bool  
</td><td style="width: 58.3196%; height: 29.4667px;">Makes the behavior handle KeyboardFocusNavigation events internally.</td></tr><tr><td style="width: 22.3641%;">ParentListNode  
</td><td style="width: 19.2751%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 58.3196%;">The node with a ListBehavior that acts as a parent to this SubListBehavior.</td></tr></tbody></table>

</div></div>---


##### **Circular Slider Behavior**

This behavior provides the functionality of CircularSlider control by creating a radial mask and setting a rotation of knob node. This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-6"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.3195%;">**Property Name**</th><th style="width: 20.5124%;">**Type**</th><th style="width: 64.1269%;">**Description**</th></tr><tr><td style="width: 15.3195%;">Receivers  
</td><td style="width: 20.5124%;">Candera::ProcessValueBehaviorArrayProperty</td><td style="width: 64.1269%;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree Panel.*

</td></tr><tr><td style="width: 15.3195%;">Value</td><td style="width: 20.5124%;">[FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html)</td><td style="width: 64.1269%;">Value of the slider</td></tr><tr><td style="width: 15.3195%;">MinimumValue</td><td style="width: 20.5124%;">[FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html)</td><td style="width: 64.1269%;">Minimum value of the slider</td></tr><tr><td style="width: 15.3195%;">MaximumValue</td><td style="width: 20.5124%;">[FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html)</td><td style="width: 64.1269%;">Maximum value of the slider</td></tr><tr><td style="width: 15.3195%;">StepSize</td><td style="width: 20.5124%;">[FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html)</td><td style="width: 64.1269%;">Step size for Value</td></tr><tr><td style="width: 15.3195%;">MinimumAngle</td><td style="width: 20.5124%;">FeatStd::Float</td><td style="width: 64.1269%;">Angle of the slider, corresponding to minimum value.</td></tr><tr><td style="width: 15.3195%;">MaximumAngle</td><td style="width: 20.5124%;">FeatStd::Float</td><td style="width: 64.1269%;">Angle of the slider, corresponding to maximum value.</td></tr><tr><td style="width: 15.3195%;">ThumbNode</td><td style="width: 20.5124%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 64.1269%;">Thumb node which will be rotated.</td></tr><tr><td style="width: 15.3195%;">ImageNode</td><td style="width: 20.5124%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 64.1269%;">Image node which will be masked.</td></tr></tbody></table>

</div></div>##### **Drawer Behavior** 

The Drawer is a Layouting Behavior that can hide or show its content via Events or Touch Inputs. This will only work if the Node has a Group called 'Content' as Child. To support Touch Inputs there needs to be a Node called 'Knob' as Child.

Drawer Behavior to switch node on/off.

This behavior is available for 2D scenes only.

**About implicit roles of ChildNodes**

The first child node is used as content (Group2D) and the second as knob (RenderNode2D).  
The knob node must be named "Knob" for proper dragging support (Touch).

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-7"><div class="contents"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td style="width: 15.3195%;">Receivers  
</td><td style="width: 20.5124%;">Candera::ProcessValueBehaviorArrayProperty</td><td style="width: 64.1269%;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree Panel.*

</td></tr><tr><td>Open</td><td>bool</td><td>Shows the Drawer in its opened appearance.</td></tr><tr><td>AppearDirection</td><td>AppearDirection::Enum</td><td>The direction from which the Drawer will open.

*Possible values: Top, Left, Right, Bottom*

</td></tr><tr><td>DragEnabled</td><td>bool</td><td>Set to true to allow the Drawer to be controlled by Touch Inputs.</td></tr></tbody></table>

</div></div></div>##### **Linear Slider Behavior**

This behavior provides the functionality of a linear Slider control. It must be used as a receiver in a process value chain and expects a normalized value in the range of 0.0 to 1.0.

This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-8"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%; height: 230.619px;"><tbody><tr style="height: 29.7017px;"><th style="width: 17.6381%; height: 29.7017px;">**Property Name**</th><th style="width: 26.6929%; height: 29.7017px;">**Type**</th><th style="width: 55.6582%; height: 29.7017px;">**Description**</th></tr><tr style="height: 63.3097px;"><td style="width: 17.6381%; height: 63.3097px;">Receivers  
</td><td style="width: 26.6929%; height: 63.3097px;">Candera::ProcessValueBehaviorArrayProperty</td><td style="width: 55.6582%; height: 63.3097px;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree Panel.*

</td></tr><tr style="height: 35.2983px;"><td style="width: 17.6381%; height: 35.2983px;">KnobNode  
</td><td style="width: 26.6929%; height: 35.2983px;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 55.6582%; height: 35.2983px;">Knob node which will be shifted.</td></tr><tr style="height: 35.2983px;"><td style="width: 17.6381%; height: 35.2983px;">SliderBarNode</td><td style="width: 26.6929%; height: 35.2983px;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 55.6582%; height: 35.2983px;">Image node which will be scaled according to value.</td></tr><tr style="height: 46.5057px;"><td style="width: 17.6381%; height: 46.5057px;">BackgroundNode</td><td style="width: 26.6929%; height: 46.5057px;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 55.6582%; height: 46.5057px;">Image node which will provide background image and also control slider total size.</td></tr><tr style="height: 20.5057px;"><td style="width: 17.6381%; height: 20.5057px;">UseBitmapClipping</td><td style="width: 26.6929%; height: 20.5057px;">bool</td><td style="width: 55.6582%; height: 20.5057px;">If true, the slider bar image will be resized using bitmap clipping instead of the layouter.</td></tr></tbody></table>

</div></div></div></div>---

#### **Internal Control Behaviors**

##### **Caret**

Behavior which receives the CaretPositionChanged Event from the EditTextBehavior. It forwards the value to other behaviors (e.g. SetSize) and switches the blinking state.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-9"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 19.6458%;">**Property Name**</th><th style="width: 25.7002%;">**Type**</th><th style="width: 54.6128%;">**Description**</th></tr><tr><td style="width: 19.6458%;">Receivers  
</td><td style="width: 25.7002%;">Candera::ProcessValueBehaviorArrayProperty</td><td style="width: 54.6128%;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree Panel.*

</td></tr><tr><td style="width: 19.6458%;">CaretNode</td><td style="width: 25.7002%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 54.6128%;">Node which will be set as caret..</td></tr><tr><td style="width: 19.6458%;">IntervalSwitchBehavior</td><td style="width: 25.7002%;">[Candera::Behavior](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_behavior.html "Behaviors are small re-usable functional blocks that communicate via events. Behaviors are based on W...")\*</td><td style="width: 54.6128%;">The Caret Behavior will change the state of the given IntervalSwitch Behavior.

*This property can be set in the right side of the Scene Tree Panel.*

</td></tr></tbody></table>

</div></div>##### **Handle Control State**

Manages how a control responds to user actions like clicks, touches, or hover. Sends state events when the control is pressed, selected, or highlighted. State conditions behaviors react to these events to update the control accordingly.

**Example Usage**

<div class="contents" id="bkmrk-hover---hover-leave-"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Hover - Hover Leave Example](https://doc316en.candera.eu/link/572#bkmrk-hover---hover-leave-)</span>
- <span style="color: rgb(230, 126, 35);">[Move Node Example](https://doc316en.candera.eu/link/572#bkmrk-move-node-example)</span>
- <span style="color: rgb(230, 126, 35);">[OnClick Example](https://doc316en.candera.eu/link/572#bkmrk-onclick-example)</span>
- <span style="color: rgb(230, 126, 35);">[Set Alpha Value Example](https://doc316en.candera.eu/link/572#bkmrk-set-alpha-value-exam)</span>
- <span style="color: rgb(230, 126, 35);">[Set Position Example](https://doc316en.candera.eu/link/572#bkmrk-set-position-example)</span>
- <span style="color: rgb(230, 126, 35);">[Set Rotation Example](https://doc316en.candera.eu/link/572#bkmrk-set-rotation-example)</span>
- <span style="color: rgb(230, 126, 35);">[Start Timer Example](https://doc316en.candera.eu/link/572#bkmrk-start-timer-example)</span>
- <span style="color: rgb(230, 126, 35);">[Switch Image Example](https://doc316en.candera.eu/link/572#bkmrk-switch-image-example)</span>
- <span style="color: rgb(230, 126, 35);">[Perform Transition Requests Example](https://doc316en.candera.eu/link/572#bkmrk-perform-transition-r)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-10"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 14.827%;">**Property Name**</th><th style="width: 26.0699%;">**Type**</th><th style="width: 59.0619%;">**Description**</th></tr><tr><td style="width: 14.827%; height: 29.4667px;">TouchableId  
</td><td style="width: 26.0699%; height: 29.4667px;">String  
</td><td style="width: 59.0619%; height: 29.4667px;">Touchable Id of the behavior.</td></tr><tr><td style="width: 14.827%;">Enabled</td><td style="width: 26.0699%;">bool</td><td style="width: 59.0619%;">If set to false it will not react on focus events and does not have to support different visualizations for the different states.</td></tr><tr><td style="width: 14.827%;">Highlighted</td><td style="width: 26.0699%;">bool</td><td style="width: 59.0619%;">If true, the controls state Highlighted is set to true.</td></tr><tr><td style="width: 14.827%;">Selected  
</td><td style="width: 26.0699%;">bool  
</td><td style="width: 59.0619%;">If true, the controls state Selected is set to true.</td></tr><tr><td style="width: 14.827%;">Focusable</td><td style="width: 26.0699%;">bool</td><td style="width: 59.0619%;">If true, the control is focusable. Otherwise the control can not be focused.</td></tr><tr><td style="width: 14.827%;">Identifier</td><td style="width: 26.0699%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 59.0619%;">Identifier which is used when emitting an Event (e.g. Click Event).</td></tr></tbody></table>

</div></div>##### **DataContext**

This behavior provides a local data context on the associated node that can act as a set of binding sources (if a binding source is set at that data context). It is internally used by other behaviors like the list behavior to set individual binding sources for items.

**Common Properties**

This behavior does not have any configurable properties.

##### **Edit Text**

Control Behavior to make a TextNode editable. Receives KeyEvents and emits CaretPositionChanged Events. These can be received by the CaretBehavior to set the position of the caret node.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-11"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td style="width: 15.3195%;">Receivers  
</td><td style="width: 20.5124%;">Candera::ProcessValueBehaviorArrayProperty</td><td style="width: 64.1269%;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree Panel.*

</td></tr><tr><td>InputText</td><td>[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td>Text which will be set as default text.</td></tr><tr><td>TextNode</td><td>[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td>Text Node which will be edited.</td></tr><tr><td>Placeholder</td><td>[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td>Text which will be shown as placeholder.</td></tr><tr><td>SetValueOnEachChange</td><td>bool</td><td>If true, the value will be set on each input.</td></tr><tr><td>MaxTextLength</td><td>FeatStd::UInt16</td><td>Maximum count of characters.</td></tr><tr><td>JustDigits</td><td>bool</td><td>If true, the Inputfield will receive just digits.</td></tr></tbody></table>

</div></div>##### **Selection Group**

Provides an ArrayProperty for Selection Objects. If one of them gets selected the others get deselected (Objects need a ChangeSelectionActionBehavior). Needs to be attached to a value Behavior.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-12"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>DefaultSelectedObject</td><td>[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td>Selection Object (e.g. RadioButton) which shall be selected by default.</td></tr></tbody></table>

</div></div>---

#### **Public Property Control Behaviors**

##### **Provide Alignment**

Provides properties to set the horizontal and vertical alignment. Especially for Controls.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-13"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 18.4178%;">**Property Name**</th><th style="width: 25.2146%;">**Type**</th><th style="width: 56.3676%;">**Description**</th></tr><tr><td style="width: 18.4178%;">HorizontalAlignment</td><td style="width: 25.2146%;">Candera::HorizontalAlignment</td><td style="width: 56.3676%;">Provides property to set the Horizontal Alignment (especially for Controls).

*Possible values: HLeft, HCenter, HRight, Hstretch, HstrechRight, HstrechCenter*

</td></tr><tr><td style="width: 18.4178%;">VerticalAlignment</td><td style="width: 25.2146%;">Candera::VerticalAlignment</td><td style="width: 56.3676%;">Provides property to set the Vertical Alignment (especially for Controls).

*Possible values: VTop, VCenter, VBottom, Vstretch, VstrechCenter, VstrechBottom*

</td></tr></tbody></table>

</div></div>##### **Copy Size**

Copies the layout size to a target node. Especially for Controls to transfer the size from the control node to an inner node.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-14"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 14.578%;">**Property Name**</th><th style="width: 23.478%;">**Type**</th><th style="width: 61.9028%;">**Description**</th></tr><tr><td style="width: 14.578%;">TargetNode</td><td style="width: 23.478%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 61.9028%;">The target node to which the events are routed from the source node. If the property is not set, the event will be routed to the node of the behavior</td></tr></tbody></table>

</div></div>##### **Provide Color**

Sets the color of a 2D node with a Color effect (e.g. BitmapBrushColorBlend, SolidColorBrush, MVGRender) or the diffuse color of a material in 3D.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-15"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 17.3053%;">**Property Name**</th><th style="width: 35.0971%;">**Type**</th><th style="width: 47.5976%;">**Description**</th></tr><tr><td style="width: 17.3053%;">PropertyReference</td><td style="width: 35.0971%;">CgiStudioControl::PropertyReference::Enum</td><td style="width: 47.5976%;">Choose how the property gets set. Via own property or from another Behavior.

*Possible values: Self, Other*

</td></tr><tr><td style="width: 17.3053%;">Color</td><td style="width: 35.0971%;">[Candera::Color](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_color.html "Represents a color by its red-, green-, blue- and alpha-value. Provides color arithmetic functions an...")</td><td style="width: 47.5976%;">The color to set.

*This property is only available if the PropertyReference is set to "Self".*

</td></tr></tbody></table>

</div></div></div>**Advanced Properties**

<div class="contents" id="bkmrk-property-name-type-d-16"><div class="textblock"><table class="doxtable" style="width: 102.469%;"><tbody><tr><th style="width: 21.1285%;">**Property Name**</th><th style="width: 26.083%;">**Type**</th><th style="width: 52.7473%;">**Description**</th></tr><tr><td style="width: 21.1285%;">PropertyProvider</td><td style="width: 26.083%;">Behavior\*</td><td style="width: 52.7473%;">Property Behavior which contains the color which has to be set on the effect.

*This property can be set in the right side of the Scene Tree Panel.*

*This property is only available if PropertyReference is set to "Other".*

</td></tr></tbody></table>

</div></div>##### **Provide Margin**

Provides property to set the margin. Especially for Controls.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-17"><div class="textblock"><table class="doxtable" style="width: 99.2593%;"><tbody><tr><th style="width: 20.4149%;">**Property Name**</th><th style="width: 27.2688%;">**Type**</th><th style="width: 52.2747%;">**Description**</th></tr><tr><td style="width: 20.4149%;">Margin</td><td style="width: 27.2688%;">[Candera::Margin](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_margin.html "A non-zero margin applies space outside the element layout's width and height. The values can be set ...")</td><td style="width: 52.2747%;">Provides property to set the Margin (especially for Controls).</td></tr></tbody></table>

</div></div>##### **Property Provider**

Offers to set a property of a selectable type. This property can then be used for other Behaviors (e.g. an image for Set Image or Provide Image).

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-18"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 17.1732%;">**Property Name**</th><th style="width: 33.2387%;">**Type**</th><th style="width: 49.547%;">**Description**</th></tr><tr><td style="width: 17.1732%;">PropertyDataType</td><td style="width: 33.2387%;">CgiStudioControl::PropertyDataTypes::Enum</td><td style="width: 49.547%;">Choose the type which should be offered by this behavior.

*Possible values: Color, Text, Style, Image, Appearance, Value, BlendType, Layout, VertexBuffer*

</td></tr></tbody></table>

</div></div></div>**Advanced Properties**

<div class="contents" id="bkmrk-property-name-type-d-19"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 14.5799%;">**Property Name**</th><th style="width: 35.832%;">**Type**</th><th style="width: 49.547%;">**Description**</th></tr><tr><td style="width: 14.5799%;">Color</td><td style="width: 35.832%;">[Candera::Color](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_color.html "Represents a color by its red-, green-, blue- and alpha-value. Provides color arithmetic functions an...")</td><td style="width: 49.547%;">The color which can be used from other Behaviors.

*This property is only available if PropertyDataType is set to "Color".*

</td></tr><tr><td style="width: 14.5799%;">Text</td><td style="width: 35.832%;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 49.547%;">The Text that will be set to the Text Node.

*This property is only available if PropertyDataType is set to "Text*".

</td></tr><tr><td style="width: 14.5799%;">Style  
</td><td style="width: 35.832%;">SharedPointer&lt;Candera::TextRendering::SharedStyle&gt;</td><td style="width: 49.547%;">The Style that will be set to the Text Node.

*This property is only available if PropertyDataType is set to "Style*".

</td></tr><tr><td style="width: 14.5799%;">Image</td><td style="width: 35.832%;">SharedPointer&lt;[Candera::Image2D](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_image2_d.html "Image2D encapsulates a surface handle which is retrieved when uploading an image.")&gt;</td><td style="width: 49.547%;">The image to set on the effect.

*This property is only available for 2D scenes if PropertyDataType is set to "Image*".

</td></tr><tr><td style="width: 14.5799%;">Texture</td><td style="width: 35.832%;">SharedPointer&lt;[Candera::TextureImage](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_texture_image.html "Abstract base class for Texture images.A texture image mainly encapsulates a texture handle in VRAM a...")&gt;</td><td style="width: 49.547%;">The texture to set on the effect.

*This property is only available for 3D scenes if PropertyDataType is set to "Image*".

</td></tr><tr><td style="width: 14.5799%;">Appearance</td><td style="width: 35.832%;">SharedPointer&lt;[Candera::Appearance](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_appearance.html "The class Appearance groups following render attributes: Material, Textures, RenderMode, and Shader. Render attributes define the distinctive visualization of a geometry like Mesh, Billboard, and PointSprite. Further, render attributes can be shared across multiple objects, which conserves memory and enables sharing of appearance characteristics. An Appearance object is mandatory for any object in order to get rendered. Per default all render attributes are initialized to null, which is a valid setting. If the Appearance is activated, all render attributes that are set become activated. If no RenderMode is defined (null), then the default RenderMode is used instead;.")&gt;</td><td style="width: 49.547%;">The appearance to set on the node.

*This property is only available for 3D scenes if PropertyDataType is set to "Appearance".*

</td></tr><tr><td style="width: 14.5799%;">Value</td><td style="width: 35.832%;">[FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html)</td><td style="width: 49.547%;">The value that will be set to the Send Value as Event action.

*This property is only available if PropertyDataType is set to "Value*".

</td></tr><tr><td style="width: 14.5799%;">BlendType  
</td><td style="width: 35.832%;">BlendType::Enum  
</td><td style="width: 49.547%;">The blend type that will be set.

*Possible values: Default, DefaultPremultiplied, DefaultTransparentLayer, Add, Multiply, Screen, Darken, Lighten, SourceAtop, SourceIn, SourceOut, SourceOver, DestinationIn, DestinationOut, DestinationOver, Off.*

*This property is only available if PropertyDataType is set to "BlendType*".

</td></tr><tr><td style="width: 14.5799%;">Layout</td><td style="width: 35.832%;">CgiStudioControl::LayoutType::Enum</td><td style="width: 49.547%;">The layouter type for node. See [Set Layout](#bkmrk-set-layout) for more information.

*Possible values: Horizontal, Vertical*

*This property is only available for 2D scenes if PropertyDataType is set to "Layout".*

</td></tr><tr><td style="width: 14.5799%;">StackArrangement  
</td><td style="width: 35.832%;">StackLayouter::Arrangement</td><td style="width: 49.547%;">Selects arrangement for stack layouter.

*This property is only available for 2D scenes if PropertyDataType is set to "Layout" and the property Layout is set to "Stack".*

</td></tr><tr><td style="width: 14.5799%;">VertexBuffer</td><td style="width: 35.832%;">SharedPointer&lt;[Candera::VertexBuffer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_vertex_buffer.html)&gt;</td><td style="width: 49.547%;">*You can set the VertexBuffer held by the mesh created when importing FBX. This property is only available for 3D scenes if PropertyDataType is set to "VertexBuffer*".

</td></tr></tbody></table>

</div></div>##### **Render Node**

Sets rendering of a node to enabled or disabled and provides the setting as a property for Controls.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-20"><div class="textblock"><table class="doxtable" style="width: 117.161%; height: 89.1051px;"><tbody><tr style="height: 29.7017px;"><th style="width: 20.3981%; height: 29.7017px;">**Property Name**</th><th style="width: 31.7435%; height: 29.7017px;">**Type**</th><th style="width: 47.8171%; height: 29.7017px;">**Description**</th></tr><tr style="height: 29.7017px;"><td style="width: 20.3981%; height: 29.7017px;">EnableRendering</td><td style="width: 31.7435%; height: 29.7017px;">bool</td><td style="width: 47.8171%; height: 29.7017px;">If true, rendering is enabled.</td></tr><tr style="height: 29.7017px;"><td style="width: 20.3981%; height: 29.7017px;">PostponeChange</td><td style="width: 31.7435%; height: 29.7017px;">bool</td><td style="width: 47.8171%; height: 29.7017px;">If set to true the render change will be handled during the next Update cyle, if false it will be handled immediately.</td></tr></tbody></table>

</div></div>##### **Provide Appearance**

Sets the Appearance of a Render Node and provides the Appearance as a property for Controls.

This behavior is available for 3D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-21"><div class="textblock"><table class="doxtable" style="width: 117.161%;"><tbody><tr><th style="width: 20.3872%;">**Property Name**</th><th style="width: 31.7545%;">**Type**</th><th style="width: 47.8171%;">**Description**</th></tr><tr><td style="width: 20.3872%;">PropertyReference</td><td style="width: 31.7545%;">CgiStudioControl::PropertyReference::Enum</td><td style="width: 47.8171%;">Choose how the property gets set. Via own property or from another Behavior.

*Possible values: Self, Other*

</td></tr><tr><td style="width: 20.3872%;">Appearance  
</td><td style="width: 31.7545%;">  
</td><td style="width: 47.8171%;">*This property is only available if "PropertyReference" is set to "Self".*</td></tr><tr><td style="width: 20.3872%;">PropertyProvider</td><td style="width: 31.7545%;">Behavior\*</td><td style="width: 47.8171%;">Property Behavior which contains the color which has to be set on the effect.

*This property is only available if "PropertyReference" is set to "Other".*

*This property can be set in the right side of the Scene Tree Panel.*

</td></tr></tbody></table>

</div></div>##### **Provide Image**

Sets the image of a node and provides the Image as a property for Controls.

**Example Usage**

<div class="contents" id="bkmrk-set-image-example"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Set Image Example](https://doc316en.candera.eu/link/572#bkmrk-set-image-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-22"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.4333%;">**Property Name**</th><th style="width: 37.9325%;">**Type**</th><th style="width: 45.5931%;">**Description**</th></tr><tr><td style="width: 16.4333%;">PropertyReference</td><td style="width: 37.9325%;">CgiStudioControl::PropertyReference::Enum</td><td style="width: 45.5931%;">Choose how the property gets set. Via own property or from another Behavior.

*Possible values: Self, Other*

</td></tr></tbody></table>

</div></div></div>**<span style="color: rgb(0, 0, 0);">Advanced Properties</span>**

<table class="doxtable" id="bkmrk-property-name-type-d-23" style="width: 100%;"><tbody><tr><th style="width: 16.4333%;">**Property Name**</th><th style="width: 37.9325%;">**Type**</th><th style="width: 45.5931%;">**Description**</th></tr><tr><td style="width: 16.4333%;">PropertyProvider</td><td style="width: 37.9325%;">Behavior\*</td><td style="width: 45.5931%;">Property Behavior which contains the color which has to be set on the effect.

*This property is only available if "PropertyReference" is set to "Other".*

*This property can be set in the right side of the Scene Tree Panel.*

</td></tr><tr><td style="width: 16.4333%;">Image</td><td style="width: 37.9325%;">SharedPointer&lt;[Candera::Image2D](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_image2_d.html "Image2D encapsulates a surface handle which is retrieved when uploading an image.")&gt;</td><td style="width: 45.5931%;">The image to set on the effect.

*This property is only available for 2D scenes if "PropertyReference" is set to "Self".*

</td></tr><tr><td style="width: 16.4333%;">Texture</td><td style="width: 37.9325%;">SharedPointer&lt;[Candera::TextureImage](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_texture_image.html "Abstract base class for Texture images.A texture image mainly encapsulates a texture handle in VRAM a...")&gt;</td><td style="width: 45.5931%;">The image to set on the appearance.

*This property is only available for 3D scenes if "PropertyReference" is set to "Self".*

</td></tr></tbody></table>

<div class="header" id="bkmrk-back-to-the-menu-5"><div class="headertitle">  
</div></div>##### **Set Layout**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_set_layout_behavior.html)</small>

Provides a published property to set the layout for Controls.

**Limitations**

<div class="contents" id="bkmrk-only-certain-built-i"><div class="textblock">

- Only certain built-in layout mechanisms are supported
- Scene Composer does not support displaying layout-related properties when layouter is assigned using SetLayout behavior.

</div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-24"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.9345%;">**Property Name**</th><th style="width: 35.3506%;">**Type**</th><th style="width: 47.7149%;">**Description**</th></tr><tr><td style="width: 16.9345%;">Layout</td><td style="width: 35.3506%;">CgiStudioControl::LayoutType::Enum</td><td style="width: 47.7149%;">Selects layout type for node.

*Possible values: None, Overlay, Stack, Baseline.*

*This property is only available if "PropertyReference" is set to "Self".*

</td></tr><tr><td style="width: 16.9345%;">PropertyReference</td><td style="width: 35.3506%;">CgiStudioControl::PropertyReference::Enum</td><td style="width: 47.7149%;">Choose how the property gets set. Via own property or from another Behavior.

*Possible values: Self, Other*

</td></tr></tbody></table>

</div></div></div></div>**Advanced Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-25" style="width: 100%;"><tbody><tr><th style="width: 16.9275%;">**Property Name**</th><th style="width: 35.3377%;">**Type**</th><th style="width: 47.6936%;">**Description**</th></tr><tr><td style="width: 16.9275%;">StackArrangement</td><td style="width: 35.3377%;">[Candera::StackLayouter::Arrangement](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_stack_layouter.html#a9fba093bd1960e18bd662b0785c7d773)</td><td style="width: 47.6936%;">Selects arrangement for stack layouter.

*This property is only available if Layout is set to "Stack".*

</td></tr><tr><td style="width: 16.9275%;">PropertyProvider</td><td style="width: 35.3377%;">Behavior\*</td><td style="width: 47.6936%;">Property Behavior which contains the layout which has to be set on the effect. See <span style="color: rgb(230, 126, 35);">[Property Provider](https://doc316en.candera.eu/link/598#bkmrk-property-provider)</span> for more information.

*This property is only available if "PropertyReference"" is set to "Other".*

</td></tr></tbody></table>

##### **Provide Text**

Modifies the text of a TextNode or CanvasText and provides the text as property for Controls.

**Example Usage**

<div class="contents" id="bkmrk-set-text-example"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Set Text Example](https://doc316en.candera.eu/link/572#bkmrk-set-text-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-26"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 17.0581%;">**Property Name**</th><th style="width: 37.7025%;">**Type**</th><th style="width: 45.2394%;">**Description**</th></tr><tr><td style="width: 17.0581%;">PropertyReference</td><td style="width: 37.7025%;">CgiStudioControl::PropertyReference::Enum</td><td style="width: 45.2394%;">Choose how the property gets set. Via own property or from another Behavior.</td></tr><tr><td style="width: 17.0581%;">Text</td><td style="width: 37.7025%;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 45.2394%;">The Text that will be set to the Text Node.</td></tr><tr><td style="width: 17.0581%;">Style</td><td style="width: 37.7025%;">SharedPointer&lt;[Candera::TextRendering::SharedStyle](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_text_rendering_1_1_shared_style.html)&gt;</td><td style="width: 45.2394%;">The Style that will be set to the Text Node.

</td></tr><tr><td style="width: 17.0581%;">Alignment</td><td style="width: 37.7025%;">Candera::TextNode2DLayouter::TextAlignment</td><td style="width: 45.2394%;">The horizontal text alignment, using the culture text direction, is used to define how text will be horizontally aligned within its layout area.

*Possible values: Auto, Left, Center, Right.*

</td></tr><tr><td style="width: 17.0581%;">Multiline</td><td style="width: 37.7025%;">bool</td><td style="width: 45.2394%;">If multi line is disabled then the new line control characters will be ignored and text will always be rendered in one line.

</td></tr><tr><td style="width: 17.0581%;">LineSpacing</td><td style="width: 37.7025%;">Candera::TextRendering::PixelSize</td><td style="width: 45.2394%;">Defines the distance between the baselines of successive lines of text.

</td></tr><tr><td style="width: 17.0581%;">WordWrap</td><td style="width: 37.7025%;">bool</td><td style="width: 45.2394%;">If word wrapping is enabled then the lines that exceed the client area will be split during arrangement into multiple lines.

</td></tr><tr><td style="width: 17.0581%;">Trimming</td><td style="width: 37.7025%;">Candera::TextNode2DLayouter::Trimming</td><td style="width: 45.2394%;">Trimming defines the behavior to employ when content overflows the content area.

*Possible values: None, Ellipsis, CustomText.*

</td></tr></tbody></table>

</div></div></div>**Advanced Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-27" style="width: 100%;"><tbody><tr><th style="width: 17.0511%;">**Property Name**</th><th style="width: 37.6853%;">**Type**</th><th style="width: 45.2224%;">**Description**</th></tr><tr><td style="width: 17.0511%;">PropertyProvider</td><td style="width: 37.6853%;">Behavior\*</td><td style="width: 45.2224%;">Property Behavior which contains the color which has to be set on the effect.

*This property is only available if "PropertyReference"" is set to "Other".*

</td></tr><tr><td style="width: 17.0511%;">TrimmingText</td><td style="width: 37.6853%;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 45.2224%;">Trimming text defines the text which replaces content overflowing the content area.

*This property is only available if "Trimming" is set to "CustomText".*

</td></tr></tbody></table>

---

#### **Align Pivot**

Aligns all child nodes according to their pivot point.

**Example Usage**

<div class="contents" id="bkmrk-align-pivot-example"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Align Pivot Example](https://doc316en.candera.eu/link/572#bkmrk-align-pivot-example)</span>

</div></div></div>**Common Properties**

This behavior does not have any configurable properties.

#### **Android Event Bridge**

Builds a bridge for events between CGIStudio and an Android application. Receives JsonEvents from an Android Control and transforms them to an equivalent CGI Studio event.

This behavior is only available for Android platform.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-28"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.5637%;">**Property Name**</th><th style="width: 26.4507%;">**Type**</th><th style="width: 56.9856%;">**Description**</th></tr><tr><td style="width: 16.5637%;">TargetNode</td><td style="width: 26.4507%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 56.9856%;">The target node to which the events are sent. If the property is not set, the event will be routed to the node of the behavior.</td></tr></tbody></table>

</div></div>#### **Arc Align**

Aligns child nodes in a circular layout. Provides properties for the radius, orientation offset and the min and max angle.

**Example Usage**

<div class="contents" id="bkmrk-arc-align-example"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Arc Align Example](https://doc316en.candera.eu/link/572#bkmrk-arc-align-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-29"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>Radius</td><td>Float</td><td>Radius of the digital needle indicators.</td></tr><tr><td>Orientation Offset</td><td>Float</td><td>Offset in the orientation of the needle indicators.</td></tr><tr><td>Angle Min Max</td><td>Vector2</td><td>Min/Max angle values (e.g. indicators displayed from -25 to 210 degrees).</td></tr></tbody></table>

</div></div>#### **Blend Mode**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_blend_option_behavior.html)</small>

Sets a blend mode from a given list of options. Depending on that option the behavior chooses the appropriate blend factors and operations. In 2D it sets the values on the effect and in 3D on the render-mode if one is attached on the same node.

The following blend modes are available:

<div drawio-diagram="2843"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1677553381.png" alt=""/></div>

<div class="contents" id="bkmrk-default-add-multiply"><div class="contents"><div class="textblock"><table border="0"><tbody><tr><td> </td><td style="vertical-align: top;">

- Default
- DefaultPremultiplied
- DefaultTransparentLayer
- Add
- Multiply
- Screen
- Darken (3D only)
- Lighten (3D only)
- Source Atop
- Source In
- SourceOut
- Source Over
- Destination Atop
- Destination In
- Destination Out
- Destination Over
- Off

</td></tr></tbody></table>

</div></div></div>The default blend mode comes in different variations, e.g. pre-multiplied, which should be applied if the alpha channel is pre-multiplied. The other blend modes are implemented according to the Porter-Duff composition modes.  
In 3D there are two additional blend modes available:

<div class="contents" id="bkmrk-lighten-darken."><div class="contents"><div class="textblock">

- Lighten
- Darken

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-30"><div class="textblock"><table class="doxtable" style="width: 100%; height: 151.467px;"><tbody><tr style="height: 29.4667px;"><th style="width: 16.5568%; height: 29.4667px;">**Property Name**</th><th style="width: 31.0153%; height: 29.4667px;">**Type**</th><th style="width: 52.3867%; height: 29.4667px;">**Description**</th></tr><tr style="height: 46.2667px;"><td style="width: 16.5568%; height: 46.2667px;">PropertyReference</td><td style="width: 31.0153%; height: 46.2667px;">CgiStudioControl::PropertyReference::Enum</td><td style="width: 52.3867%; height: 46.2667px;">Choose how the property gets set. Via own property or from another Behavior.

*Possible values: Self, Other*

</td></tr><tr style="height: 46.2667px;"><td style="width: 16.5568%; height: 46.2667px;">PropertyProvider</td><td style="width: 31.0153%; height: 46.2667px;">PropertyProviderBehavior\*   
</td><td style="width: 52.3867%; height: 46.2667px;">Property Behavior which contains the color which has to be set on the effect.

*This property is only available if PropertyReference is set to "Other".*

*This property can be set in the right side of the Scene Tree Panel.*

</td></tr><tr><td style="width: 16.5568%; height: 29.4667px;">Mode</td><td style="width: 31.0153%; height: 29.4667px;">BlendType::Enum</td><td style="width: 52.3867%; height: 29.4667px;">Sets a blend mode from a given list of options.

*Possible values: Default, DefaultPremultiplied, DefaultTransparentLayer, Add, Multiply, Screen, Darken (3D only), Lighten (3D only), Source Atop, Source In, SourceOut, Source Over, Destination Atop, Destination In, Destination Out, Destination Over, Off*

</td></tr></tbody></table>

</div></div>#### **Breadcrumb Behavior**

A breadcrumb used as a navigational aid in user interfaces. It allows users to keep track and maintain awareness of their location.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-31"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 17.9234%;">**Property Name**</th><th style="width: 25.4626%;">**Type**</th><th style="width: 56.614%;">**Description**</th></tr><tr><td style="width: 17.9234%;">StateMachineNode</td><td style="width: 25.4626%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 56.614%;">The node of the State Machine</td></tr><tr><td style="width: 17.9234%;">EllipsisText</td><td style="width: 25.4626%;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 56.614%;">When more elements are added than the breadcrumb can show, one element will be replaced with the text from this field (collapse effect).</td></tr><tr><td style="width: 17.9234%;">PathDelimiter</td><td style="width: 25.4626%;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 56.614%;">Tag that separates the elements that a path contains.</td></tr></tbody></table>

</div></div>#### **Disable Control**

This behavior is a Behavior Block. It can be dragged&amp;dropped on nodes just like any Behavior.

A set of actions can be configured, which will be executed when the node **gets disabled**.

#### **Enable Control**

This behavior is a Behavior Block. It can be dragged&amp;dropped on nodes just like any Behavior.

A set of actions can be configured, which will be executed when the node **gets enabled**.

#### **Event Bridge**

Builds a bridge for events between two nodes for direct event dispatching. The events are routed from the source node to the target node (only in one direction).

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-32"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 14.5859%;">**Property Name**</th><th style="width: 25.3367%;">**Type**</th><th style="width: 60.0774%;">**Description**</th></tr><tr><td style="width: 14.5859%;">TargetNode</td><td style="width: 25.3367%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 60.0774%;">The target node to which the events are routed from the source node. If the property is not set, the event will be routed to the node of the behavior.</td></tr></tbody></table>

</div></div>#### **Focus**

This behavior is a Behavior Block. It can be dragged&amp;dropped on nodes just like any Behavior.

A set of actions can be configured, which will be executed when the node **gets focused**.

#### **Focus Leave**

This behavior is a Behavior Block. It can be dragged&amp;dropped on nodes just like any Behavior.

A set of actions can be configured, which will be executed when the node's **focus is left**.

#### **Hover**

**See also:** <span style="color: rgb(230, 126, 35);">[HoverLeave](https://doc316en.candera.eu/link/598#bkmrk-hoverleave-0)</span>

This behavior is a Behavior Block. It can be dragged&amp;dropped on nodes just like any Behavior.

A set of actions can be configured, which will be executed when the node **gets hovered**.

**Example Usage**

<div class="contents" id="bkmrk-hover---hover-leave--0"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Hover - Hover Leave Example](https://doc316en.candera.eu/link/572#bkmrk-hover---hover-leave-)</span>

</div></div>#### **HoverLeave**

This behavior is a Behavior Block. It can be dragged&amp;dropped on nodes just like any Behavior.

A set of actions can be configured, which will be executed when the node's **hovering is left**.

**Example Usage**

<div class="contents" id="bkmrk-hover---hover-leave--1"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Hover - Hover Leave Example](https://doc316en.candera.eu/link/572#bkmrk-hover---hover-leave-)</span>

</div></div>#### **IntervalSwitch**

Sends Off or On value to Trigger Behaviors that belong to same node.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-33"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.822%;">**Property Name**</th><th style="width: 22.3722%;">**Type**</th><th style="width: 61.8058%;">**Description**</th></tr><tr><td style="width: 15.822%;">State</td><td style="width: 22.3722%;">IntervalSwitchState::Enum</td><td style="width: 61.8058%;">If set to On, sends only On value to Trigger Behaviors in the same node. If set to Off, sends only Off value to Trigger Behaviors in the same node. If set to Blinking, alternates between sending On or Off values. Use On Time Ms and Off Time Ms to specify the speed of blinking.

*Possible values: On, Off, Blinking*

</td></tr><tr><td style="width: 15.822%;">OnTimeMs</td><td style="width: 22.3722%;">FeatStd::UInt32</td><td style="width: 61.8058%;">If State is set to Blinking, IntervalSwitchBehavior will be sending On value for On Time Ms milliseconds before switching to sending Off value.</td></tr><tr><td style="width: 15.822%;">OffTimeMs</td><td style="width: 22.3722%;">FeatStd::UInt32</td><td style="width: 61.8058%;">If State is set to Blinking, IntervalSwitchBehavior will be sending Off value for Off Time Ms milliseconds before switching to sending On value.</td></tr><tr><td style="width: 15.822%;">AcceptValueEvent  
</td><td style="width: 22.3722%;">bool  
</td><td style="width: 61.8058%;">Set this flag to true to make the behavior changeable by events/actions.</td></tr></tbody></table>

</div></div>#### **Keyboard** 

This behavior provides the functionality of Keyboard control by managing the Keyboard Keys and setting their properties according to the Configuration Script.

This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-34"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%; height: 1316.83px;"><tbody><tr style="height: 29.7969px;"><th style="width: 22.3641%; height: 29.7969px;">**Property Name**</th><th style="width: 30.7661%; height: 29.7969px;">**Type**</th><th style="width: 46.8287%; height: 29.7969px;">**Description**</th></tr><tr style="height: 35.3906px;"><td style="width: 22.3641%; height: 35.3906px;">ConfigurationScript</td><td style="width: 30.7661%; height: 35.3906px;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 46.8287%; height: 35.3906px;">String that specifies symbols and layout of the Control</td></tr><tr><td style="width: 22.3641%;">KeyContent  
</td><td style="width: 30.7661%;">AbstractNodePointer</td><td style="width: 46.8287%;">Node containing Keyboard Keys.</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">StateMachineNode</td><td style="width: 30.7661%; height: 46.5938px;">AbstractNodePointer</td><td style="width: 46.8287%; height: 46.5938px;">State machine that reacts on events sent by a special key to change keyboard layout</td></tr><tr style="height: 29.7969px;"><td style="width: 22.3641%; height: 29.7969px;">KeyBackContentType</td><td style="width: 30.7661%; height: 29.7969px;">CgiStudioControl::KeyContent::Enum</td><td style="width: 46.8287%; height: 29.7969px;">Switch for Content of KEY\_BACK special key.

*Possible values: Text, Icon*

</td></tr><tr style="height: 49.5938px;"><td style="width: 22.3641%; height: 49.5938px;">KeyBackText</td><td style="width: 30.7661%; height: 49.5938px;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 46.8287%; height: 49.5938px;">KEY\_BACK is labeled with the text.

*This property is only visible if KeyBackContentType is set to "Text".*

</td></tr><tr><td style="width: 22.3641%; height: 46.5938px;">KeyBackImage</td><td style="width: 30.7661%; height: 46.5938px;">SharedPointer&lt;Candera::Image2D&gt;</td><td style="width: 46.8287%; height: 46.5938px;">KEY\_BACK is labeled with the image.

*This property is only visible if KeyBackContentType is set to "Icon".*

</td></tr><tr><td style="width: 22.3641%; height: 29.7969px;">KeyEnterContentType</td><td style="width: 30.7661%; height: 29.7969px;">CgiStudioControl::KeyContent::Enum</td><td style="width: 46.8287%; height: 29.7969px;">Switch for Content of KEY\_ENTER special key.

*Possible values: Text, Icon*

</td></tr><tr><td style="width: 22.3641%; height: 49.5938px;">KeyEnterText</td><td style="width: 30.7661%; height: 49.5938px;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 46.8287%; height: 49.5938px;">KEY\_ENTER is labeled with the text.

*This property is only visible if KeyBackContentType is set to "Text".*

</td></tr><tr><td style="width: 22.3641%; height: 46.5938px;">KeyEnterImage</td><td style="width: 30.7661%; height: 46.5938px;">SharedPointer&lt;Candera::Image2D&gt;</td><td style="width: 46.8287%; height: 46.5938px;">KEY\_ENTER is labeled with the image.

*This property is only visible if KeyBackContentType is set to "Icon".*

</td></tr><tr><td style="width: 22.3641%; height: 29.7969px;">KeySpaceContentType</td><td style="width: 30.7661%; height: 29.7969px;">CgiStudioControl::KeyContent::Enum</td><td style="width: 46.8287%; height: 29.7969px;">Switch for Content of KEY\_SPACE special key.

*Possible values: Text, Icon*

</td></tr><tr><td style="width: 22.3641%; height: 49.5938px;">KeySpaceText</td><td style="width: 30.7661%; height: 49.5938px;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 46.8287%; height: 49.5938px;">KEY\_SPACE is labeled with the text.

*This property is only visible if KeyBackContentType is set to "Text".*

</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">KeySpaceImage</td><td style="width: 30.7661%; height: 46.5938px;">SharedPointer&lt;Candera::Image2D&gt;</td><td style="width: 46.8287%; height: 46.5938px;">KEY\_SPACE is labeled with the image.

*This property is only visible if KeyBackContentType is set to "Icon".*

</td></tr><tr style="height: 29.7969px;"><td style="width: 22.3641%; height: 29.7969px;">KeySwitchContentType</td><td style="width: 30.7661%; height: 29.7969px;">CgiStudioControl::KeyContent::Enum</td><td style="width: 46.8287%; height: 29.7969px;">Switch for Content of SWITCH special key</td></tr><tr style="height: 49.5938px;"><td style="width: 22.3641%; height: 49.5938px;">KeySwitchText</td><td style="width: 30.7661%; height: 49.5938px;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 46.8287%; height: 49.5938px;">SWITCH is labeled with the text.

*This property is only visible if KeySwitchContentType is set to "Text".*

</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">KeySwitchImage</td><td style="width: 30.7661%; height: 46.5938px;">SharedPointer&lt;Candera::Image2D&gt;</td><td style="width: 46.8287%; height: 46.5938px;">SWITCH is labeled with the image.

*This property is only visible if KeySwitchContentType is set to "Icon".*

</td></tr><tr style="height: 29.7969px;"><td style="width: 22.3641%; height: 29.7969px;">KeyShiftContentType</td><td style="width: 30.7661%; height: 29.7969px;">CgiStudioControl::KeyContent::Enum</td><td style="width: 46.8287%; height: 29.7969px;">Switch for Content of SHIFT special key</td></tr><tr style="height: 49.5938px;"><td style="width: 22.3641%; height: 49.5938px;">KeyShiftText</td><td style="width: 30.7661%; height: 49.5938px;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 46.8287%; height: 49.5938px;">SHIFT is labeled with the text.

*This property is only visible if KeyShiftContentType is set to "Text".*

</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">KeyShiftImage</td><td style="width: 30.7661%; height: 46.5938px;">SharedPointer&lt;Candera::Image2D&gt;</td><td style="width: 46.8287%; height: 46.5938px;">SHIFT is labeled with the image.

*This property is only visible if KeyShiftContentType is set to "Icon".*

</td></tr><tr style="height: 29.7969px;"><td style="width: 22.3641%; height: 29.7969px;">KeyShiftOnceContentType</td><td style="width: 30.7661%; height: 29.7969px;">CgiStudioControl::KeyContent::Enum</td><td style="width: 46.8287%; height: 29.7969px;">Switch for Content of SHIFT ONCE special key</td></tr><tr style="height: 49.5938px;"><td style="width: 22.3641%; height: 49.5938px;">KeyShiftOnceText</td><td style="width: 30.7661%; height: 49.5938px;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 46.8287%; height: 49.5938px;">SHIFT ONCE is labeled with the text*:*

*This property is only visible if KeyShiftOnceContentType is set to "Text".*

</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">KeyShiftOnceImage</td><td style="width: 30.7661%; height: 46.5938px;">SharedPointer&lt;Candera::Image2D&gt;</td><td style="width: 46.8287%; height: 46.5938px;">SHIFT ONCE is labeled with the image.

*This property is only visible if KeyShiftOnceContentType is set to "icon".*

</td></tr><tr style="height: 29.7969px;"><td style="width: 22.3641%; height: 29.7969px;">KeyShiftLockContentType</td><td style="width: 30.7661%; height: 29.7969px;">CgiStudioControl::KeyContent::Enum</td><td style="width: 46.8287%; height: 29.7969px;">Switch for Content of SHIFT LOCK special key</td></tr><tr style="height: 49.5938px;"><td style="width: 22.3641%; height: 49.5938px;">KeyShiftLockText</td><td style="width: 30.7661%; height: 49.5938px;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 46.8287%; height: 49.5938px;">SHIFT LOCK is labeled with the text.

*This property is only visible if KeyShiftLockContentType is set to "Text".*

</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">KeyShiftLockImage</td><td style="width: 30.7661%; height: 46.5938px;">SharedPointer&lt;Candera::Image2D&gt;</td><td style="width: 46.8287%; height: 46.5938px;">LEFT is labeled with the image.

*This property is only visible if KeyShiftLockContentType is set to "Icon".*

</td></tr><tr><td style="width: 22.3641%; height: 29.7969px;">KeyCloseContentType</td><td style="width: 30.7661%; height: 29.7969px;">CgiStudioControl::KeyContent::Enum</td><td style="width: 46.8287%; height: 29.7969px;">Switch for Content of SHIFT LOCK special key</td></tr><tr style="height: 29.7969px;"><td style="width: 22.3641%; height: 49.5938px;">KeyCloseText</td><td style="width: 30.7661%; height: 49.5938px;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 46.8287%; height: 49.5938px;">CLOSE is labeled with the text.

*This property is only visible if KeyCloseContentType is set to "Text".*

</td></tr><tr style="height: 49.5938px;"><td style="width: 22.3641%; height: 46.5938px;">KeyCloseImage</td><td style="width: 30.7661%; height: 46.5938px;">SharedPointer&lt;Candera::Image2D&gt;</td><td style="width: 46.8287%; height: 46.5938px;">CLOSE is labeled with the image.

*This property is only visible if KeyCloseContentType is set to "Icon".*

</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">KeyLeftContentType</td><td style="width: 30.7661%; height: 29.7969px;">CgiStudioControl::KeyContent::Enum</td><td style="width: 46.8287%; height: 29.7969px;">Switch for Content of LEFT special key</td></tr><tr><td style="width: 22.3641%;">KeyLeftText  
</td><td style="width: 30.7661%; height: 49.5938px;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 46.8287%; height: 49.5938px;">LEFT is labeled with the text.

*This property is only visible if KeyLeftContentType is set to "Text".*

</td></tr><tr><td style="width: 22.3641%;">KeyLeftImage  
</td><td style="width: 30.7661%; height: 46.5938px;">SharedPointer&lt;Candera::Image2D&gt;</td><td style="width: 46.8287%; height: 46.5938px;">LEFT is labeled with the image.

*This property is only visible if KeyLeftContentType is set to "Icon".*

</td></tr><tr><td style="width: 22.3641%;">KeyRightContentType  
</td><td style="width: 30.7661%; height: 29.7969px;">CgiStudioControl::KeyContent::Enum</td><td style="width: 46.8287%; height: 29.7969px;">Switch for Content of RIGHT special key</td></tr><tr><td style="width: 22.3641%;">KeyRightText  
</td><td style="width: 30.7661%; height: 49.5938px;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 46.8287%; height: 49.5938px;">RIGHT is labeled with the text.

*This property is only visible if KeyRightContentType is set to "Text".*

</td></tr><tr><td style="width: 22.3641%;">KeyRightImage  
</td><td style="width: 30.7661%; height: 46.5938px;">SharedPointer&lt;Candera::Image2D&gt;</td><td style="width: 46.8287%; height: 46.5938px;">RIGHT is labeled with the image.

*This property is only visible if KeyRightContentType is set to "Icon".*

</td></tr><tr><td style="width: 22.3641%; height: 46.5938px;">NavigateUpKeyCode</td><td style="width: 30.7661%; height: 46.5938px;">Candera::KeyboardKeyCode::Enum</td><td style="width: 46.8287%; height: 46.5938px;">Key from a physical keyboard that moves focus to a key above the current focused</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">NavigateDownKeyCode</td><td style="width: 30.7661%; height: 46.5938px;">Candera::KeyboardKeyCode::Enum</td><td style="width: 46.8287%; height: 46.5938px;">Key from a physical keyboard that moves focus to a key below the current focused</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">NavigateNextKeyCode</td><td style="width: 30.7661%; height: 46.5938px;">Candera::KeyboardKeyCode::Enum</td><td style="width: 46.8287%; height: 46.5938px;">Key from a physical keyboard that moves focus to a key on the right from the current focused</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">NavigatePreviousKeyCode</td><td style="width: 30.7661%; height: 46.5938px;">Candera::KeyboardKeyCode::Enum</td><td style="width: 46.8287%; height: 46.5938px;">Key from a physical keyboard that moves focus to a key on the left from the current focused</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">NavigateStartOnDown</td><td style="width: 30.7661%; height: 46.5938px;">bool</td><td style="width: 46.8287%; height: 46.5938px;">Enables starting navigation with the same key as NavigateDownKeyCode</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">NavigateEndOnUp</td><td style="width: 30.7661%; height: 46.5938px;">bool</td><td style="width: 46.8287%; height: 46.5938px;">Enables finishing navigation with the same key as NavigateUpKeyCode</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">NavigateStartKeyCode</td><td style="width: 30.7661%; height: 46.5938px;">Candera::KeyboardKeyCode::Enum</td><td style="width: 46.8287%; height: 46.5938px;">Key from a physical keyboard that starts navigation within the Control</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">NavigateEndKeyCode</td><td style="width: 30.7661%; height: 46.5938px;">Candera::KeyboardKeyCode::Enum</td><td style="width: 46.8287%; height: 46.5938px;">Key from a physical keyboard that finishes navigation within the Control</td></tr><tr style="height: 29.7969px;"><td style="width: 22.3641%; height: 29.7969px;">NavigateCloseKeyCode</td><td style="width: 30.7661%; height: 29.7969px;">Candera::KeyboardKeyCode::Enum</td><td style="width: 46.8287%; height: 29.7969px;">Key from a physical keyboard that hides the Control</td></tr><tr style="height: 46.5938px;"><td style="width: 22.3641%; height: 46.5938px;">NavigateInvokeKeyCode</td><td style="width: 30.7661%; height: 46.5938px;">Candera::KeyboardKeyCode::Enum</td><td style="width: 46.8287%; height: 46.5938px;">Key from a physical keyboard that emulates clicking the current focused Key from the Control</td></tr></tbody></table>

</div></div></div>**Configuration String**

The most important feature of the Keyboard Control is Configuration Script. It is parsed during layouting a scene which a keyboard is embedded on and keys (their appearance and their special functionalities) are arranged according to it.

The configuration script is simply a string. Each line of the string specifies a row of keys in the instance of keyboard and consists of space-separated list of key strings. A key string specifies a value that will be sent to a connected InputField. The most typical key string is simply a character or figure but it is not limited to it.

Following key strings have a special meaning:

<div class="contents" id="bkmrk-key-string-meaning-e"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 28.9225%;">**Key String**</th><th style="width: 71.0775%;">**Meaning**</th></tr><tr><td style="width: 28.9225%;">enum from Candera::KeyboardKeyCode::Enum:  
KEY\_BACK, KEY\_SPACE, KEY\_ENTER</td><td style="width: 71.0775%;">For most keys KEY\_\* has the same meaning as \* (e.g. „KEY\_A“ is the same as simply „A“); it enables keys with non-printable characters like backspace etc.</td></tr><tr><td style="width: 28.9225%;">CLOSE()</td><td style="width: 71.0775%;">Represents a key that sends Close KeyboardAction to a state machine; it is designed to enable hiding (setting EnableRendering to false) an instance of the Control</td></tr><tr><td style="width: 28.9225%;">SWITCH(layoutName)</td><td style="width: 71.0775%;">Represents a key that sends ¬¬to a state machine an event with its argument; it is designed to enable permanent changing layout e.g. to uppercase letters, symbols or digits</td></tr><tr><td style="width: 28.9225%;">SHIFT(layoutName)</td><td style="width: 71.0775%;">Mostly the same as SWITCH() but is separated to enable changing layout only for a single input, it means after entering a single letter (e.g. first capital letter in a sentence) the layout will be reset to the previous one</td></tr><tr><td style="width: 28.9225%;">NULL()</td><td style="width: 71.0775%;">Represents a key that will NOT be rendered; it is designed for a layouting/padding purpose</td></tr></tbody></table>

</div></div></div>Keyboard Control has public properties that customize labels of keys with the special meaning described above. One can set them custom text or image label.

Each key string (both regular and special) can be extended by a scaling factor in square brackets, e.g. SHIFT(Uppercase/en/US)\[2\] defines a key that sends to a state machine event with “Uppercase/en/US” string and the key itself is counted “2” times (like two different keys) when counting default width of a key in its row.

It is not obligatory to connect the Control to a state machine. There is a default set of layouts with lower- and uppercase english letters as well as digits and symbols with full switching support without a state machine.

#### **Menu Item**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_menu_item_behavior.html)</small>

Menu Item Behavior defines the attached Node as an Menu Item. A Menu Item can interact with the Menu Screen Behavior. Sends Off or On value to Trigger Behaviors that belong to same node.

This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-35"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 21.3844%;">**Property Name**</th><th style="width: 37.9452%;">**Type**</th><th style="width: 40.794%;">**Description**</th></tr><tr><td style="width: 21.3844%;">DeleteButtonNode</td><td style="width: 37.9452%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 40.794%;">Delete button node needed to control visibility (render on/off).</td></tr><tr><td style="width: 21.3844%;">Focusable</td><td style="width: 37.9452%;">bool</td><td style="width: 40.794%;">If true then focus node will be visible.</td></tr><tr><td style="width: 21.3844%;">FocusNode</td><td style="width: 37.9452%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 40.794%;">Focus node needed to control visibility (render on/off) and change focus image.</td></tr><tr><td style="width: 21.3844%;">Enabled</td><td style="width: 37.9452%;">bool</td><td style="width: 40.794%;">If true then item is visible.</td></tr><tr><td style="width: 21.3844%;">FocusImageOnSelection</td><td style="width: 37.9452%;">SharedPointer&lt;[Candera::Image2D](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_image2_d.html "Image2D encapsulates a surface handle which is retrieved when uploading an image.")&gt;</td><td style="width: 40.794%;">The image to set on the effect.</td></tr><tr><td style="width: 21.3844%;">FocusImageOnDragging</td><td style="width: 37.9452%;">SharedPointer&lt;[Candera::Image2D](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_image2_d.html "Image2D encapsulates a surface handle which is retrieved when uploading an image.")&gt;</td><td style="width: 40.794%;">The image to set on the effect.</td></tr></tbody></table>

</div></div>#### **MenuScreen**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_menu_screen_behavior.html)</small>

The Control represents a menu in the form of a grid of icons (instances of the Menu Item Control). It has configurable number of rows and columns as well as default and maximum number of screens. A user can swipe between neighbouring screens. The Control handles user input and forwards proper information to children MenuItem nodes. The children nodes may be removed and reordered in runtime.

This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-36"><div class="textblock"><table class="doxtable" style="width: 100%; height: 1006.4px;"><tbody><tr style="height: 46.2667px;"><th style="width: 26.8122%; height: 46.2667px;">**Property Name**</th><th style="width: 22.4861%; height: 46.2667px;">**Type**</th><th style="width: 50.6605%; height: 46.2667px;">**Description**</th></tr><tr style="height: 46.2667px;"><td style="width: 26.8122%; height: 46.2667px;">ActiveScreenIndex  
</td><td style="width: 22.4861%; height: 46.2667px;">UInt32  
</td><td style="width: 50.6605%; height: 46.2667px;">Currently active index.</td></tr><tr style="height: 46.2667px;"><td style="width: 26.8122%; height: 46.2667px;">NumberOfScreens  
</td><td style="width: 22.4861%; height: 46.2667px;">UInt32</td><td style="width: 50.6605%; height: 46.2667px;">Number of active screens.</td></tr><tr style="height: 46.2667px;"><td style="width: 26.8122%; height: 46.2667px;">LimitOfScreens  
</td><td style="width: 22.4861%; height: 46.2667px;">UInt32</td><td style="width: 50.6605%; height: 46.2667px;">Limit of active screens.</td></tr><tr style="height: 29.4667px;"><td style="width: 26.8122%; height: 29.4667px;">Rows  
</td><td style="width: 22.4861%; height: 29.4667px;">UInt32</td><td style="width: 50.6605%; height: 29.4667px;">Number of rows.</td></tr><tr style="height: 29.4667px;"><td style="width: 26.8122%; height: 29.4667px;">Columns  
</td><td style="width: 22.4861%; height: 29.4667px;">UInt32</td><td style="width: 50.6605%; height: 29.4667px;">Number of columns.</td></tr><tr style="height: 46.2667px;"><td style="width: 26.8122%; height: 46.2667px;">ScreenChangeTime  
</td><td style="width: 22.4861%; height: 46.2667px;">Float  
</td><td style="width: 50.6605%; height: 46.2667px;">Time of dragging a Menu Item outside boundaries of the Menu Screen to change its screen to a neighbour.</td></tr><tr style="height: 82.6667px;"><td style="width: 26.8122%; height: 82.6667px;">SwapItemAnimationEasingFunction  
</td><td style="width: 22.4861%; height: 82.6667px;">EasingFunctions::Enum</td><td style="width: 50.6605%; height: 82.6667px;">Swap item animation easing function.

*Possible values: CircularInOut, Linear, SineIn, SineOut, SineInOut*

</td></tr><tr style="height: 63.0667px;"><td style="width: 26.8122%; height: 63.0667px;">SwapItemAnimationLength  
</td><td style="width: 22.4861%; height: 63.0667px;">Float  
</td><td style="width: 50.6605%; height: 63.0667px;">Swap item animation length</td></tr><tr style="height: 82.6667px;"><td style="width: 26.8122%; height: 82.6667px;">ChangeScreenAnimationEasingFunction  
</td><td style="width: 22.4861%; height: 82.6667px;">EasingFunctions::Enum</td><td style="width: 50.6605%; height: 82.6667px;">Change screen animation easing function.

*Possible values: CircularInOut, Linear, SineIn, SineOut, SineInOut*

</td></tr><tr style="height: 63.0667px;"><td style="width: 26.8122%; height: 63.0667px;">ChangeScreenAnimationLength  
</td><td style="width: 22.4861%; height: 63.0667px;">Float  
</td><td style="width: 50.6605%; height: 63.0667px;">Change screen animation length.</td></tr><tr style="height: 63.0667px;"><td style="width: 26.8122%; height: 63.0667px;">KeyCodeToMoveSelectionLeft  
</td><td style="width: 22.4861%; height: 63.0667px;">KeyboardKeyCode::Enum</td><td style="width: 50.6605%; height: 63.0667px;">Key code to move selection left.

*Possible values: Key\_None, ...&lt;all keyboard key codes&gt;... Key\_OEM8*

</td></tr><tr style="height: 63.0667px;"><td style="width: 26.8122%; height: 63.0667px;">KeyCodeToMoveSelectionRight</td><td style="width: 22.4861%; height: 63.0667px;">KeyboardKeyCode::Enum</td><td style="width: 50.6605%; height: 63.0667px;">Key code to move selection right.

*Possible values: Key\_None, ...&lt;all keyboard key codes&gt;... Key\_OEM8*

</td></tr><tr style="height: 63.0667px;"><td style="width: 26.8122%; height: 63.0667px;">KeyCodeToMoveSelectionUp</td><td style="width: 22.4861%; height: 63.0667px;">KeyboardKeyCode::Enum</td><td style="width: 50.6605%; height: 63.0667px;">Key code to move selection up.

*Possible values: Key\_None, ...&lt;all keyboard key codes&gt;... Key\_OEM8*

</td></tr><tr style="height: 63.0667px;"><td style="width: 26.8122%; height: 63.0667px;">KeyCodeToMoveSelectionDown</td><td style="width: 22.4861%; height: 63.0667px;">KeyboardKeyCode::Enum</td><td style="width: 50.6605%; height: 63.0667px;">Key code to move selection down.

*Possible values: Key\_None, ...&lt;all keyboard key codes&gt;... Key\_OEM8*

</td></tr><tr style="height: 46.2667px;"><td style="width: 26.8122%; height: 46.2667px;">PageIndicatorNode</td><td style="width: 22.4861%; height: 46.2667px;">Candera::AbstractNodePointer</td><td style="width: 50.6605%; height: 46.2667px;">Page indicator node.</td></tr><tr style="height: 79.8667px;"><td style="width: 26.8122%; height: 79.8667px;">Items</td><td style="width: 22.4861%; height: 79.8667px;">ListPropertyType&lt;::Courier::DataContextItem::SharedPointer&gt;</td><td style="width: 50.6605%; height: 79.8667px;">The items property is used for binding of dynamic items. It can only be set via databinding. Only one visible list control should be bound to a fragment list in the model. Otherwise the list fragments in the model are not able to provide data for both list controls. Use a separate list model that is filled with the same data if such a use case is required.</td></tr><tr style="height: 46.2667px;"><td style="width: 26.8122%; height: 46.2667px;">ContentNode</td><td style="width: 22.4861%; height: 46.2667px;">Candera::AbstractNodePointer</td><td style="width: 50.6605%; height: 46.2667px;">Content node.</td></tr></tbody></table>

</div></div>#### **Navigation Instruction View**

Behavior for displaying the instructions during navigation.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-37"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>SignDisplayNode</td><td>Candera::AbstractNodePointer</td><td>Node used to display the graphical sign.</td></tr><tr><td>PrimaryTextNode</td><td>Candera::AbstractNodePointer</td><td>Node used to display the primary message.</td></tr><tr><td>SecondaryTextNode</td><td>Candera::AbstractNodePointer</td><td>Node used to display the secondary message.</td></tr><tr><td>ManeuverTypeTextNode</td><td>Candera::AbstractNodePointer</td><td>Node used to display the maneuver type (as text).</td></tr></tbody></table>

</div></div>#### **OnClick**

This behavior is a Behavior Block. It can be dragged&amp;dropped on nodes just like any Behavior.

A set of actions can be configured, which will be executed when the node **is clicked**.

OnClick behavior allows to check for single, double or tripple (or any) Click events.

<div class="contents" id="bkmrk-note%3A-click-is-a-syn"><div class="contents"><div class="textblock"><dl class="note"><dt>**Note:**</dt><dd>Click is a synthetic event composed by combining two basic events: Press and Release.</dd></dl></div></div></div>**Example Usage**

<div class="contents" id="bkmrk-enable-rendering-exa"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Enable Rendering Example](https://doc316en.candera.eu/link/572#bkmrk-enable-rendering-exa)</span>
- <span style="color: rgb(230, 126, 35);">[Move Node Example](https://doc316en.candera.eu/link/572#bkmrk-move-node-example)</span>
- <span style="color: rgb(230, 126, 35);">[OnClick Example](https://doc316en.candera.eu/link/572#bkmrk-onclick-example)</span>
- <span style="color: rgb(230, 126, 35);">[Set Position Example](https://doc316en.candera.eu/link/572#bkmrk-set-position-example)</span>
- <span style="color: rgb(230, 126, 35);">[Set Rotation Example](https://doc316en.candera.eu/link/572#bkmrk-set-rotation-example)</span>
- <span style="color: rgb(230, 126, 35);">[Start Timer Example](https://doc316en.candera.eu/link/572#bkmrk-start-timer-example)</span>
- <span style="color: rgb(230, 126, 35);">[Perform Transition Requests Example](https://doc316en.candera.eu/link/572#bkmrk-perform-transition-r)</span>
- <span style="color: rgb(230, 126, 35);">[Switch Image Example](https://doc316en.candera.eu/link/572#bkmrk-switch-image-example)</span>

</div></div></div>#### **OnPressed**

This behavior is a Behavior Block. It can be dragged&amp;dropped on nodes just like any Behavior.

A set of actions can be configured, which will be executed when the node **is pressed**.

OnPressed behavior allows to check for Pressed and Released (and LongPressed) events.

**Example Usage**

<div class="contents" id="bkmrk-onpressed-example"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[OnPressed Example](https://doc316en.candera.eu/link/572#bkmrk-onpressed-example)</span>

</div></div>#### **OnTimer**

This behavior is a Behavior Block. It can be dragged&amp;dropped on nodes just like any Behavior.

A timer node and a set of actions can be configured. These actions will be executed when the **timer expires**.

**See also:** <span style="color: rgb(230, 126, 35);">[Check Timer](https://doc316en.candera.eu/link/597#bkmrk-check-timer)</span>, <span style="color: rgb(230, 126, 35);">[Start Timer](https://doc316en.candera.eu/link/582#bkmrk-start-timer)</span>

This behavior is a Behavior Block.

**Example Usage**

<div class="contents" id="bkmrk-start-timer-example"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Start Timer Example](https://doc316en.candera.eu/link/572#bkmrk-start-timer-example)</span>

</div></div>#### **Orbit Camera Transform**

When attached to a Node, the specified camera will orbit around that Node. PLAYER USE ONLY.

<span lang="EN-US" style="mso-fareast-language: ZH-CN;">And the options to limit the movement of the camera to specific parts of the spherical orbit. Setting the flag IsOrbitLimited allows the user to set minimum and maximum angles between the camera and the axes of the coordinate system, preventing the camera from moving too close to an axis. In this way, the user can define unwanted areas that the camera cannot move to, e.g., below the ground.</span>

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-38"><div class="textblock"><table border="1" class="doxtable" style="border-collapse: collapse; width: 700px;"><tbody><tr><th style="width: 175.05px;">**Property Name**</th><th style="width: 182.05px;">**Type**</th><th style="width: 342.1px;">**Description**</th></tr><tr><td style="width: 175.05px;">TouchableId  
</td><td style="width: 182.05px;">String  
</td><td style="width: 342.1px;">Touchable Id  
</td></tr><tr><td style="width: 175.05px;">Camera</td><td style="width: 182.05px;">CameraType</td><td style="width: 342.1px;">The camera that looks at the associated node.</td></tr></tbody></table>

</div></div>**Advanced Properties**

<table border="1" class="doxtable" id="bkmrk-property-name-type-d-39" style="border-collapse: collapse; width: 700px;"><tbody><tr><th style="width: 171.05px;">**Property Name**</th><th style="width: 191.05px;">**Type**</th><th style="width: 337.1px;">**Description**</th></tr><tr><td style="width: 171.05px;">IsOrbitLimited  
</td><td style="width: 191.05px;">bool  
</td><td style="width: 337.1px;">Enables setting of boundaries for the camera within the orbit.  
</td></tr><tr><td style="width: 171.05px;">AngleMinX</td><td style="width: 191.05px;">FeatStd::Float</td><td style="width: 337.1px;">Min angle between camera and X-axis (from 0 to 180 degrees). Must be less than AngleMaxX.</td></tr><tr><td style="width: 171.05px;">AngleMaxX</td><td style="width: 191.05px;">FeatStd::Float</td><td style="width: 337.1px;">Max angle between camera and X-axis (from 0 to 180 degrees). Must be greater than AngleMinX.</td></tr><tr><td style="width: 171.05px;">AngleMinY</td><td style="width: 191.05px;">FeatStd::Float</td><td style="width: 337.1px;">Min angle between camera and Y-axis (from 0 to 180 degrees). Must be less than AngleMaxY.</td></tr><tr><td style="width: 171.05px;">AngleMaxY</td><td style="width: 191.05px;">FeatStd::Float</td><td style="width: 337.1px;">Max angle between camera and Y-axis (from 0 to 180 degrees). Must be greater than AngleMinY.</td></tr><tr><td style="width: 171.05px;">AngleMinZ</td><td style="width: 191.05px;">FeatStd::Float</td><td style="width: 337.1px;">Min angle between camera and Z-axis (from 0 to 180 degrees). Must be less than AngleMaxZ.</td></tr><tr><td style="width: 171.05px;">AngleMaxZ</td><td style="width: 191.05px;">FeatStd::Float</td><td style="width: 337.1px;">Max angle between camera and Z-axis (from 0 to 180 degrees). Must be greater than AngleMinZ.</td></tr></tbody></table>

#### **Page Indicator**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_page_indicator_behavior.html)</small>

Send events to a PageIndicator behavior to update its state. Can change the number of pages, set the active page, or activate a specific dot via external controls or PageIndicatorElement. This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-40"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 18.0395%;">**Property Name**</th><th style="width: 28.7891%;">**Type**</th><th style="width: 53.1302%;">**Description**</th></tr><tr><td style="width: 18.0395%;">TargetNode</td><td style="width: 28.7891%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 53.1302%;">Target node that will receive a ChangeValueEvent when ActivePageIndex changes</td></tr><tr><td style="width: 18.0395%;">ActivePageIndex</td><td style="width: 28.7891%;">FeatStd::Int32</td><td style="width: 53.1302%;">Index of active page (range from 0 to NumberOfPages - 1)</td></tr><tr><td style="width: 18.0395%;">NumberOfPages</td><td style="width: 28.7891%;">FeatStd::Int32</td><td style="width: 53.1302%;">Total number of pages (you have to ensure that PageIndicator has at least this number of child elements)</td></tr><tr><td style="width: 18.0395%;">DecrementKeyCode</td><td style="width: 28.7891%;">Candera::KeyboardKeyCode::Enum</td><td style="width: 53.1302%;">Key used for decrementing value (if value is actually decremented, focus handling is suspended)

*Possible values: Key\_None, ...&lt;all keyboard key codes&gt;... Key\_OEM8*

</td></tr><tr><td style="width: 18.0395%;">IncrementKeyCode</td><td style="width: 28.7891%;">Candera::KeyboardKeyCode::Enum</td><td style="width: 53.1302%;">Key used for incrementing value (if value is actually incremented, focus handling is suspended)

*Possible values: Key\_None, ...&lt;all keyboard key codes&gt;... Key\_OEM8*

</td></tr></tbody></table>

</div></div>#### **Rectangle Clipping Behavior**

Clips the control to given rectangle.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-41"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>Width</td><td>Float</td><td>Width of the clipping rectangle.</td></tr><tr><td>Height</td><td>Float</td><td>Height of the clipping rectangle.</td></tr><tr><td>ClipPositionEnabled</td><td>bool</td><td>Enable Clipping Position.</td></tr><tr><td>ClipPosition  
</td><td>Candera::Vector2</td><td>Position of the clipping rectangle.

*This property is only available if ClipPositionEnabled is set to true.*

</td></tr></tbody></table>

</div></div>#### **Roll**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_roll_behavior.html)</small>

Displays a list of float values within a specified range, and lets the user select a value by rolling with touch or scrolling via configured arrow keys. This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-42"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%; height: 541.334px;"><tbody><tr style="height: 29.4667px;"><th style="width: 20.6343%; height: 29.4667px;">**Property Name**</th><th style="width: 28.5426%; height: 29.4667px;">**Type**</th><th style="width: 50.7819%; height: 29.4667px;">**Description**</th></tr><tr style="height: 35.0667px;"><td style="width: 20.6343%; height: 35.0667px;">ValueGroup</td><td style="width: 28.5426%; height: 35.0667px;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 50.7819%; height: 35.0667px;">Node containing a range of displayed values</td></tr><tr style="height: 35.0667px;"><td style="width: 20.6343%; height: 35.0667px;">LensGroup</td><td style="width: 28.5426%; height: 35.0667px;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 50.7819%; height: 35.0667px;">Node containing current value.

*This property is only available if 'LensVisible' is set to 'true'.*

</td></tr><tr style="height: 35.0667px;"><td style="width: 20.6343%; height: 35.0667px;">DecorationGroup</td><td style="width: 28.5426%; height: 35.0667px;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 50.7819%; height: 35.0667px;">Node containing lens decoration.

*This property is only available if 'LensVisible' is set to 'true'.*

</td></tr><tr style="height: 29.4667px;"><td style="width: 20.6343%; height: 29.4667px;">Value</td><td style="width: 28.5426%; height: 29.4667px;">FeatStd::Float</td><td style="width: 50.7819%; height: 29.4667px;">Current value</td></tr><tr style="height: 29.4667px;"><td style="width: 20.6343%; height: 29.4667px;">Min</td><td style="width: 28.5426%; height: 29.4667px;">FeatStd::Float</td><td style="width: 50.7819%; height: 29.4667px;">Minimum value</td></tr><tr style="height: 29.4667px;"><td style="width: 20.6343%; height: 29.4667px;">Max</td><td style="width: 28.5426%; height: 29.4667px;">FeatStd::Float</td><td style="width: 50.7819%; height: 29.4667px;">Maximum value</td></tr><tr style="height: 29.4667px;"><td style="width: 20.6343%; height: 29.4667px;">LensVisible</td><td style="width: 28.5426%; height: 29.4667px;">bool</td><td style="width: 50.7819%; height: 29.4667px;">Is lens group visible?</td></tr><tr style="height: 29.4667px;"><td style="width: 20.6343%; height: 29.4667px;">UseCyclicRoll</td><td style="width: 28.5426%; height: 29.4667px;">bool</td><td style="width: 50.7819%; height: 29.4667px;">Is roll cyclic?</td></tr><tr style="height: 46.2667px;"><td style="width: 20.6343%; height: 46.2667px;">AllowDraggingPastLimit</td><td style="width: 28.5426%; height: 46.2667px;">bool</td><td style="width: 50.7819%; height: 46.2667px;">Allow temporary over-dragging (dragging to blank values before first and after last entry)

*This property is only available if 'UseCyclicRoll' is set to 'false'.*

</td></tr><tr style="height: 102.267px;"><td style="width: 20.6343%; height: 102.267px;">DecrementKeyCode</td><td style="width: 28.5426%; height: 102.267px;">Candera::KeyboardKeyCode::Enum</td><td style="width: 50.7819%; height: 102.267px;">Key used for decrementing value (if value is actually decremented, focus handling is suspended)

*Possible values: Key\_None, ...&lt;all keyboard key codes&gt;... Key\_OEM8*

</td></tr><tr style="height: 46.2667px;"><td style="width: 20.6343%; height: 46.2667px;">IncrementKeyCode</td><td style="width: 28.5426%; height: 46.2667px;">Candera::KeyboardKeyCode::Enum</td><td style="width: 50.7819%; height: 46.2667px;">Key used for incrementing value (if value is actually incremented, focus handling is suspended)

*Possible values: Key\_None, ...&lt;all keyboard key codes&gt;... Key\_OEM8*

</td></tr><tr style="height: 35.0667px;"><td style="width: 20.6343%; height: 35.0667px;">TextEditNode</td><td style="width: 28.5426%; height: 35.0667px;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 50.7819%; height: 35.0667px;">Node containing text edit field</td></tr><tr style="height: 29.4667px;"><td style="width: 20.6343%; height: 29.4667px;">Step</td><td style="width: 28.5426%; height: 29.4667px;">FeatStd::Float</td><td style="width: 50.7819%; height: 29.4667px;">Value step (positive float value).</td></tr></tbody></table>

</div></div></div>**Advanced Properties**

<div class="contents" id="bkmrk-property-name-type-d-43"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 20.6428%;">**Property Name**</th><th style="width: 32.0106%;">**Type**</th><th style="width: 47.3467%;">**Description**</th></tr><tr><td style="width: 20.6428%;">Format</td><td style="width: 32.0106%;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 47.3467%;">Value display format (use '%f' for value)

*This property is only available if 'LensVisible' is set to 'false'.*

</td></tr><tr><td style="width: 20.6428%;">EditKeyCode</td><td style="width: 32.0106%;">Candera::KeyboardKeyCode::Key\_Enter</td><td style="width: 47.3467%;">Key used for entering text edit mode

*Possible values: Key\_None, ...&lt;all keyboard key codes&gt;... Key\_OEM8*

*This property is only available if 'LensVisible' is set to 'true' and a 'TextEditNode' is configured.*

</td></tr></tbody></table>

</div></div>#### **Touch Indication**

Used to display a touch indicator at the position where the screen is touched. Control must be positioned at position (0;0) if no offset to the touch location is desired.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-44"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 19.5222%;">**Property Name**</th><th style="width: 28.1713%;">**Type**</th><th style="width: 52.2652%;">**Description**</th></tr><tr><td style="width: 19.5222%;">TouchableId  
</td><td style="width: 28.1713%;">String  
</td><td style="width: 52.2652%;">Touchable Id  
</td></tr><tr><td style="width: 19.5222%;">IndicationNode</td><td style="width: 28.1713%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 52.2652%;">The node moved by the Touch Indication Behavior. It is moved to the touch location to point it out.</td></tr><tr><td style="width: 19.5222%;">TouchAreaNode</td><td style="width: 28.1713%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 52.2652%;">The node whose area the Touch Indication Behavior should indicate touch events on.</td></tr><tr><td style="width: 19.5222%;">Camera</td><td style="width: 28.1713%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 52.2652%;">The camera used to render the touch indicator. Will be used to correctly match touch position with object position in case the camera has a position offset.</td></tr><tr><td style="width: 19.5222%;">DistanceFromCamera</td><td style="width: 28.1713%;">FeatStd::Float</td><td style="width: 52.2652%;">How far from the camera should the touch indication node be rendered.

*This property is only available for 3D scenes.*

</td></tr><tr><td style="width: 19.5222%;">OnAnimation</td><td style="width: 28.1713%;">Candera::MemoryManagement::SharedPointer&lt;[Candera::Animation::AnimationPlayer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_animation_1_1_animation_player.html "AnimationPlayer is an AnimationPlayerBase that animates AnimationBlendedProperties.")&gt;</td><td style="width: 52.2652%;">Optional animation played when the indicator is shown.</td></tr><tr><td style="width: 19.5222%;">OffAnimation</td><td style="width: 28.1713%;">Candera::MemoryManagement::SharedPointer&lt;[Candera::Animation::AnimationPlayer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_animation_1_1_animation_player.html "AnimationPlayer is an AnimationPlayerBase that animates AnimationBlendedProperties.")&gt;</td><td style="width: 52.2652%;">Optional animation played when the indicator is hidden.</td></tr><tr><td style="width: 19.5222%;">HideIndicatorOnMove</td><td style="width: 28.1713%;">bool</td><td style="width: 52.2652%;">Hide the touch indicator when a move is detected, otherwise the indicator will stay visible during movement until the finger is lifted from the screen.</td></tr></tbody></table>

</div></div>#### **Transform Mesh2D**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_transform_mesh2_d_behavior.html)</small>

Performs a perspective projection of a 3D rotated effect (e.g. Bitmap or SolidColor effects) based on the configured origin, rotation and field of view.

This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-45"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 23.2386%;">**Property Name**</th><th style="width: 34.7222%;">**Type**</th><th style="width: 42.0392%;">**Description**</th></tr><tr><td style="width: 23.2386%;">Rotation</td><td style="width: 34.7222%;">FeatStd::Float</td><td style="width: 42.0392%;">Defines the rotation angle in degree around configured rotation axis at the configured origin</td></tr><tr><td style="width: 23.2386%;">CameraDistance</td><td style="width: 34.7222%;">FeatStd::Float</td><td style="width: 42.0392%;">Defines a normalized camera distance (the projection is based on a normalized geometry of widht and height 1) with a default value of 1.</td></tr><tr><td style="width: 23.2386%;">FitToMaximumSizeRotation</td><td style="width: 34.7222%;">FeatStd::Float</td><td style="width: 42.0392%;">Defines the rotation angle in degree that will be uses as maximum for the FitToMaximumSize fit strategy. Default is an angle of 90 degree.</td></tr><tr><td style="width: 23.2386%;">RotationAxis</td><td style="width: 34.7222%;">[Candera::Vector3](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_vector3.html "The default Vector3 class.")</td><td style="width: 42.0392%;">Defines the axis (default is the y axis) for the rotation as a 3D direction vector (the vector will be internally normalized).</td></tr><tr><td style="width: 23.2386%;">FieldOfView</td><td style="width: 34.7222%;">FeatStd::Float</td><td style="width: 42.0392%;">The area on the Y axis view field in degrees. It influences the perspective distortion of the projection. Higher angles will result in more distorted projection. Lower angles will result in less perspective distorted projections. The angle has to be higher than 0 and less than 180.</td></tr><tr><td style="width: 23.2386%;">FitStrategy</td><td style="width: 34.7222%;">TransformMesh2DFitStrategy::Enum</td><td style="width: 42.0392%;">Defines how the perspective projected mesh should fit into the original boundaries.</td></tr><tr><td style="width: 23.2386%;">HorizontalOrigin</td><td style="width: 34.7222%;">CgiStudioControl::HorizontalOrigin::Enum</td><td style="width: 42.0392%;">The origin influences where the rotation is performed and how the perspective projection looks. It is defined as a normalized (bitmap resolution independent) origin on the y axis as Left (0), Center (0.5), Right (1.0) or Custom (see CustomHorizontalOrigin).</td></tr><tr><td style="width: 23.2386%;">VerticalOrigin</td><td style="width: 34.7222%;">CgiStudioControl::VerticalOrigin::Enum</td><td style="width: 42.0392%;">The origin influences where the rotation is performed and how the perspective projection looks. It is defined as a normalized (bitmap resolution independent) origin on the y axis as Top (0), Center (0.5), Bottom (1.0) or Custom (see CustomVerticalOrigin).</td></tr><tr><td style="width: 23.2386%;">CustomHorizontalOrigin</td><td style="width: 34.7222%;">FeatStd::Float</td><td style="width: 42.0392%;">Defines a normalized (bitmap resolution independent) custom origin that can not be defined with Left, Center or Right.</td></tr><tr><td style="width: 23.2386%;">CustomVerticalOrigin</td><td style="width: 34.7222%;">FeatStd::Float</td><td style="width: 42.0392%;">Defines a normalized (bitmap resolution independent) custom origin that can not be defined with Top, Center or Bottom.</td></tr><tr><td style="width: 23.2386%;">OriginOffset</td><td style="width: 34.7222%;">[Candera::Vector2](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_vector2.html "The default Vector2 class.")</td><td style="width: 42.0392%;">In addition to the configured normalized origin this pixel based origin offset is added.</td></tr></tbody></table>

</div></div>#### **Event Handler**

Passes a value to a Condition Behavior and if the response is positive, invokes an Action behavior.

**Example Usage**

<div class="contents" id="bkmrk-render-child-nodes-e"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Render Child Nodes Example](https://doc316en.candera.eu/link/572#bkmrk-render-child-nodes-e)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-46"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.5748%;">**Property Name**</th><th style="width: 25.1046%;">**Type**</th><th style="width: 59.3206%;">**Description**</th></tr><tr><td style="width: 15.5748%;">Condition</td><td style="width: 25.1046%;">Candera::ConditionBehavior\*</td><td style="width: 59.3206%;">The ConditionBehavior that TriggerBehavior passes a value to and expect a response from to see if Action needs to be invoked.</td></tr><tr><td style="width: 15.5748%;">Actions</td><td style="width: 25.1046%;">ActionBehaviorArrayProperty</td><td style="width: 59.3206%;">The set of ActionBehaviors that TriggerBehavior invokes in the even that it receives a positive response from Condition.</td></tr><tr><td style="width: 15.5748%;">ConsumeEvent  
</td><td style="width: 25.1046%;">bool  
</td><td style="width: 59.3206%;">Set this flag to false if the event should not be consumed by the trigger. By default it is set to true and if the trigger evaluates to true the event will not be routed to any other behavior.</td></tr></tbody></table>

</div></div>#### **Virtual Key**

Receives a Change Value Event with a boolean. True will start emitting Key Events, false will stop emitting Key Events.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-47"><div class="textblock"><table class="doxtable" style="width: 100.494%; height: 88.4001px;"><tbody><tr style="height: 29.4667px;"><th style="width: 17.6705%; height: 29.4667px;">**Property Name**</th><th style="width: 23.598%; height: 29.4667px;">**Type**</th><th style="width: 58.6903%; height: 29.4667px;">**Description**</th></tr><tr><td style="width: 17.6705%;">KeyType  
</td><td style="width: 23.598%;">CgiStudioControl::KeyType::Enum</td><td style="width: 58.6903%;">Choose the type of key. With KeyCode you can select any key.

*Possible values: Modifier, KeyCode*

</td></tr><tr style="height: 29.4667px;"><td style="width: 17.6705%; height: 29.4667px;">KeyCode</td><td style="width: 23.598%; height: 29.4667px;">Candera::KeyboardKeyCode::Enum</td><td style="width: 58.6903%; height: 29.4667px;">With KeyCode you can select any key.

*Possible values: Key\_None, ...&lt;all keyboard key codes&gt;... Key\_OEM8*

*This property is only available if "KeyType" is set to "KeyCode".*

</td></tr><tr><td style="width: 17.6705%; height: 29.4667px;">Modifier</td><td style="width: 23.598%; height: 29.4667px;">Candera::KeyModifierEnum::Enum</td><td style="width: 58.6903%; height: 29.4667px;">Modifier Key (e.g. Shift)

*Possible values: None, Key\_Shift, Key\_Alt, Key\_Ctrl, Key\_CapsLock, Key\_Num*

*This property is only available if "KeyType" is set to "Modifier".*

</td></tr></tbody></table>

</div></div>---

# Demonstration

#### **Demo Mode Action**

Action to start or end the demo mode.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 18.4102%;">**Property Name**</th><th style="width: 33.1087%;">**Type**</th><th style="width: 48.4399%;">**Description**</th></tr><tr><td style="width: 18.4102%;">Activate</td><td style="width: 33.1087%;">bool</td><td style="width: 48.4399%;">Activates or deactivates a demo mode</td></tr><tr><td style="width: 18.4102%;">DemoModeExecutor</td><td style="width: 33.1087%;">CgiStudioControl::DemoModeBehavior\*</td><td style="width: 48.4399%;">Target demo mode behavior receiving the action</td></tr></tbody></table>

</div></div></div></div>#### **Demo Mode Execution**

Execution of user input simulation.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-1"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 19.272%;">**Property Name**</th><th style="width: 26.1976%;">**Type**</th><th style="width: 54.4893%;">**Description**</th></tr><tr><td style="width: 19.272%;">ExecutionResource</td><td style="width: 26.1976%;">FeatStd::String</td><td style="width: 54.4893%;">Resource containing the simulation instructions.</td></tr><tr><td style="width: 19.272%;">RestartDelay</td><td style="width: 26.1976%;">FeatStd::UInt32</td><td style="width: 54.4893%;">Delay in milliseconds between each repeat loop.</td></tr></tbody></table>

</div></div></div></div>#### **Demo Mode Changed**

Condition which reacts on 'activated' or 'deactivated' demo mode.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-2"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%; height: 88.4001px;"><tbody><tr style="height: 29.4667px;"><th style="width: 15.4448%; height: 29.4667px;">**Property Name**</th><th style="width: 30.0239%; height: 29.4667px;">**Type**</th><th style="width: 54.4901%; height: 29.4667px;">**Description**</th></tr><tr style="height: 29.4667px;"><td style="width: 15.4448%; height: 29.4667px;">Activated</td><td style="width: 30.0239%; height: 29.4667px;">bool</td><td style="width: 54.4901%; height: 29.4667px;">Condition matches if input is activated (ON) or deactivated (OFF)</td></tr></tbody></table>

</div></div></div></div>#### **Demo Mode Check Input type**

Condition behavior which reacts on input in respect of whether it is simulated input or not.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-3"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.4448%;">**Property Name**</th><th style="width: 30.0247%;">**Type**</th><th style="width: 54.4893%;">**Description**</th></tr><tr><td style="width: 15.4448%;">SimulatedInput</td><td style="width: 30.0247%;">bool</td><td style="width: 54.4893%;">Condition matches if input is simulated (ON) or user generated (OFF)</td></tr><tr><td style="width: 15.4448%;">MatchOnHover</td><td style="width: 30.0247%;">bool</td><td style="width: 54.4893%;">Condition matches in case of hover input (ON) or not (OFF)</td></tr></tbody></table>

</div></div></div></div>#### **Demo Mode Record Action**

Action to start or end the demo mode recording.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-4"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%; height: 105.2px;"><tbody><tr style="height: 29.4667px;"><th style="width: 18.2867%; height: 29.4667px;">**Property Name**</th><th style="width: 38.056%; height: 29.4667px;">**Type**</th><th style="width: 43.6161%; height: 29.4667px;">**Description**</th></tr><tr style="height: 29.4667px;"><td style="width: 18.2867%; height: 29.4667px;">Activate</td><td style="width: 38.056%; height: 29.4667px;">bool</td><td style="width: 43.6161%; height: 29.4667px;">Activates or deactivates a demo mode recording</td></tr><tr style="height: 46.2667px;"><td style="width: 18.2867%; height: 46.2667px;">DemoModeRecorder</td><td style="width: 38.056%; height: 46.2667px;">CgiStudioControl::DemoModeRecordBehavior\*</td><td style="width: 43.6161%; height: 46.2667px;">Target demo mode record behavior receiving the action.</td></tr></tbody></table>

</div></div></div></div>#### **Demo Mode Recording**

Execution of user input recording.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-5"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.4448%;">**Property Name**</th><th style="width: 30.0239%;">**Type**</th><th style="width: 54.4901%;">**Description**</th></tr><tr><td style="width: 15.4448%;">OutputFilePath</td><td style="width: 30.0239%;">FeatStd::String</td><td style="width: 54.4901%;">Location in which the output shall be stored.</td></tr></tbody></table>

</div></div></div></div>

# External Resource

This page explains how to use the behaviors that operate on external resources (such as images) located **outside** the Scene Composer solution: External Bitmap Provider, Set External Bitmap and Check External Resource Change.

<p class="callout info">For how to reference external resource files, see <span style="color: rgb(230, 126, 35);">[Referencing external resource](https://doc316en.candera.eu/books/scene-design/page/referencing-external-resource)</span>.</p>

A new **FileSystemResourceManager** (identified as `FileSystem`) has been introduced, extending the functionality of the **External Resource Behaviors** (such as `Set External Bitmap` and `External Bitmap Provider`), **removing execution device restrictions**. These behaviors are now available across **all platforms**. This allows users to dynamically load image files, such as PNG and JPEG files, from the file system at runtime using **relative paths**, without embedding them in the asset binary file. This functionality is primarily used for setting images on **2D Bitmap Nodes**. Since the `ExternalResourceManager ID` property defaults to `AndroidSystem`, users must **manually enter "FileSystem"** as the value to enable file system resource support.

For further details and limitations, please refer to the <span style="color: rgb(230, 126, 35);">[External Image Behavior](https://doc316en.candera.eu/books/controls-and-behaviors/page/external-image-behaviour)</span> page.

#### Use cases

- **Render external images:** Preview images residing under an Android Studio project in Scene Composer and verify the display in Player.
- **Switch the displayed image from the UI:** Attach <span style="color: rgb(230, 126, 35);">[External Bitmap Provider](#bkmrk-external-bitmap-prov)</span> to a bitmap node, then use a button with <span style="color: rgb(230, 126, 35);">[Set External Bitmap](#bkmrk-set-external-bitmap)</span> to switch the image according to `ExternalResourceId`.
- **Detect external-resource changes:** Use <span style="color: rgb(230, 126, 35);">[Check External Resource Change](#bkmrk-check-external-resou)</span> to detect changes in the external resource setup and reload cached external objects as needed.

---

#### Action External Resource Behavior

##### Set External Bitmap

Sets ExternalResourceId and ExternalResourceManagerId properties of an associated ExternalBitmapProvider when its action is triggered.

**Common Properties**

<table border="1" id="bkmrk-property-name-type-d" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 33.3745%;"></col><col style="width: 27.3177%;"></col><col style="width: 39.4314%;"></col></colgroup><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>ExternalResourceId</td><td>String</td><td>Full path to resource. (A unique ID to be provided.)

If the **ExternalResourceManagerId** is *Android*, provide the full path to the resource (a unique ID should be specified).

If the **ExternalResourceManagerId** is *FileSystemExternal*, provide the file system path in .*png* or *.jpg* format.

</td></tr><tr><td>ExternalResourceManagerId</td><td>String</td><td>External resource manager ID. (e.g., *Android*, *FileSystem*) used to retrieve the external resource.

</td></tr><tr><td>ImageProvider</td><td>ExternalBitmapProviderBehavior\*</td><td>External Bitmap Provider Behavior which sets an external image on a node and is the target receiving set resource on action.

</td></tr></tbody></table>


#### Condition External Resource Behavior

##### Check External Resource Change

Checks is external resource setup changed if test pass need to reload extand whole cache for external objects needs reload.

Reacts on ExternalResourceEvent if and only if the ExternalResourceId and ExternalResourceManagerId of the event match the condition’s properties, triggering the associated action.

**Common Properties**

<table border="1" id="bkmrk-property-name-type-d-1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 33.3745%;"></col><col style="width: 27.3177%;"></col><col style="width: 39.4314%;"></col></colgroup><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>ExternalResourceId</td><td>String</td><td>External resource name ID. (A unique ID to be provided.)  
</td></tr><tr><td>ExternalResourceManagerId</td><td>String</td><td>External resource manager ID. (A unique ID to retrieve the external resource from.)

</td></tr></tbody></table>




#### Value Processing External Resource Behavior

##### External Bitmap Provider

<span lang="EN-US">Sets an image on a Render Node based on External resource Id. Retrieves an external bitmap with ExternalResourceId from an external resource provider with ExternalResourceManagerId and provides the bitmap to an associated bitmap node.</span>

**Common Properties**

<table border="1" id="bkmrk-property-name-type-d-2" style="border-collapse: collapse; width: 100%; height: 169.563px;"><colgroup><col style="width: 33.3745%;"></col><col style="width: 27.3177%;"></col><col style="width: 39.4314%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><th style="height: 29.7969px;">**Property Name**</th><th style="height: 29.7969px;">**Type**</th><th style="height: 29.7969px;">**Description**</th></tr><tr style="height: 80.1719px;"><td style="height: 80.1719px;">TargetNode</td><td style="height: 80.1719px;">Candera::AbstractNodePointer</td><td style="height: 80.1719px;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">ExternalResourceId</td><td style="height: 29.7969px;">String</td><td style="height: 29.7969px;">Full path to resource. (A unique id of an external resource to be provided.)

If the **ExternalResourceManagerId** is *Android*, provide the full path to the resource (a unique ID should be specified).

If the **ExternalResourceManagerId** is *FileSystemExternal*, provide the file system path in \*.\**png* or *.jpg* format.

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">ExternalResourceManagerId</td><td style="height: 29.7969px;">String</td><td style="height: 29.7969px;">External resource manager ID. (e.g., *Android*, *FileSystem*) used to retrieve the external resource.

</td></tr></tbody></table>

---

#### Example Usage of External Resource Behaviors

Here is an example of the use of each External Resource behavior.

#### How to reference external resources

For information on referencing external resource files, see <span style="color: rgb(230, 126, 35);">[Referencing external resource](https://doc316en.candera.eu/books/scene-design/page/referencing-external-resource)</span>. The following usage example uses an external resource that was loaded into the solution during this operation.

#### External Bitmap Provider

1. Drag and drop the \[ Node 2D &gt; Bitmap Node \] from the toolbox onto the scene editor, or the scene tree.
2. Attach \[ Behavior &gt; External Resource &gt; Value Processing &gt; External Bitmap Provider \] in the Toolbox to the Behavior in the Extra Scene Tree of the placed bitmap node by drag-and-drop operation.  
    <div drawio-diagram="8560"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-09/drawing-4-1757035722.png" alt=""/></div>
3. Click ***External Bitmap Provider*** behavior and and specify the target image file to ExternalResourceId in the properties panel that appears. ExternalResourceId can be set in the following two ways. 
    1. - Enter the resource ID directly into the ExternalResourceId text box.
        - Press the select item button on the right side of ExternalResourceId, select the target file from the displayed dialog box, and press the \[ OK \] button.  
            <div drawio-diagram="8547"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-09/drawing-4-1756710241.png" alt=""/></div>
4. The selected external resource will appear in the scene editor. 
    - Save the solution and launch Player to confirm that this external resource is displayed.


#### Set External Bitmap

1. Drag and drop the \[ Node 2D &gt; Bitmap Node \] from the toolbox onto the scene editor, or the scene tree.
2. Attach \[ Behavior &gt; External Resource &gt; Value Processing &gt; External Bitmap Provider \] in the Toolbox to the Behavior in the Extra Scene Tree of the placed bitmap node by drag-and-drop operation.  
    <div drawio-diagram="8548"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-09/drawing-4-1756710276.png" alt=""/></div>
3. Drag and drop the \[ Controls &gt; Touchable &gt; Button \] from the toolbox onto the scene editor, or the scene tree. Take place this operation twice (add two button control nodes).
4. Attach \[ Behavior &gt; External Resource &gt; Action &gt; Set External Bitmap \] in the Toolbox to the Actions in the Extra Scene Tree of the placed Button control nodes by drag-and-drop operation.  
    <div drawio-diagram="8550"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-09/drawing-4-1756710338.png" alt=""/></div>
5. Select the Button control, then select the Set External Bitmap behavior in the Extra Scene tree that appears.
6. Click the select item button on the ImageProvider in the properties panel that appears and select the External Bitmap Provider connected to the BitmapNode (this operation is performed for the two Button controls).  
    <div drawio-diagram="8551"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-09/drawing-4-1756710563.png" alt=""/></div>
7. Select the Button control, then select the Set External Bitmap behavior in the Extra Scene tree that appears.
8. Click the select item button on the ExternalResourceId in the properties panel that appears and select the External Bitmap Provider connected to the BitmapNode (this operation is performed for the two Button controls).  
    <div drawio-diagram="8552"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-09/drawing-4-1756710635.png" alt=""/></div>
9. Run the player and press the placed buttons. By pressing each button, the image specified in Set External Bitmap will be displayed.   
    <div drawio-diagram="3911"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-06/drawing-4-1686892990.png" alt=""/></div>

#### Check External Resource Change

1. Drag and drop the \[ Node 2D &gt; Bitmap Node \] from the toolbox onto the scene editor, or the scene tree.
2. Attach \[ Behavior &gt; External Resource &gt; Value Processing &gt; External Bitmap Provider \] in the Toolbox to the Behavior in the Extra Scene Tree of the placed bitmap node by drag-and-drop operation.
3. <span lang="EN-US" style="mso-ansi-language: EN-US;"><span lang="EN-US" style="mso-ansi-language: EN-US;">Select Scene2D in the scene tree and attach \[ Behaviors &gt; Control &gt; Event Handler \] to the displayed extra scene tree by drag-and-drop operation.  
    </span></span><div drawio-diagram="8553"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-09/drawing-4-1756710711.png" alt=""/></div>
    
    <span lang="EN-US" style="mso-ansi-language: EN-US;">  
      
    </span>
4. Select the Scene2D in the scene tree, in the displayed extra scene tree, attach \[ Behavior &gt; External Resource &gt; Condition &gt; Check External Resource Change \] to the Condition of the Event Handler by drag-and-drop operation.  
    <div drawio-diagram="8554"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-09/drawing-4-1756710806.png" alt=""/></div>
5. Select the Scene2D in the scene tree, in the displayed extra scene tree, attach \[ Behavior &gt; External Resource &gt; Action &gt; Set External Bitmap \] to the Actions of the Event Handler by drag-and-drop operation.  
    <div drawio-diagram="8555"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-09/drawing-4-1756710880.png" alt=""/></div>
6. Select the Set External Bitmap behavior you added.
7. <span lang="EN-US" style="font-size: 11.0pt; line-height: 107%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 游明朝; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;"><span lang="EN-US" style="font-size: 11.0pt; line-height: 107%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 游明朝; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">Click the select item button on the ImageProvider in the properties panel that appears and select the External Bitmap Provider connected to the BitmapNode.  
    </span></span><div drawio-diagram="8556"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-09/drawing-4-1756711003.png" alt=""/></div>
    
    <span lang="EN-US" style="font-size: 11.0pt; line-height: 107%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 游明朝; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">  
    </span>
8. Select the Set External Bitmap behavior you added.
9. Click External Bitmap Provider behavior and and specify the target image file to ExternalResourceId in the properties panel that appears. ExternalResourceId can be set in the following two ways. 
    - Enter the resource ID directly into the ExternalResourceId text box.
    - Press the select item button on the right side of ExternalResourceId, select the target file from the displayed dialog box, and press the \[ OK \] button.
10. Select Check External Resource Change in the Event Handler.
11. Click the Select Item button for ExternalResourceId in the Properties panel that appears and select any external resource specified in step 9.
12. Each time the image definition is changed, the displayed image should be updated.

# Graph

#### **Bar Graph**

Creates a bar graph based on a provided list of numeric values, with configurable bar width, height, spacing between bars, and color for each value. This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>TemplateNode  
</td><td>  
</td><td>  
</td></tr><tr><td>BarWidth</td><td>FeatStd::UInt16</td><td>Width of each bar.</td></tr><tr><td>BarHeight</td><td>FeatStd::UInt16</td><td>Height of each bar.</td></tr><tr><td>SpaceWidth</td><td>FeatStd::UInt16</td><td>Width of space between each bar.</td></tr><tr><td>Color</td><td>[Candera::Color](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_color.html "Represents a color by its red-, green-, blue- and alpha-value. Provides color arithmetic functions an...")</td><td>Color of bars.</td></tr><tr><td>Value List</td><td>Courier::ListPropertyType&lt; FeatStd::Float &gt;</td><td>List of values.</td></tr></tbody></table>

</div></div>#### **Line Graph**

Draws a 2D line using a list of values with a specified width and color. Displays the result in the scene. Can be attached to a group node. This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-1"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 17.1817%;">**Property Name**</th><th style="width: 28.3043%;">**Type**</th><th style="width: 54.514%;">**Description**</th></tr><tr><td style="width: 17.1817%;">Values</td><td style="width: 28.3043%;">Courier::ListPropertyType&lt; Candera::Vector2 &gt;</td><td style="width: 54.514%;">List of values which will create the graph.</td></tr><tr><td style="width: 17.1817%;">MinX</td><td style="width: 28.3043%;">FeatStd::Optional&lt;FeatStd::Float&gt;</td><td style="width: 54.514%;">The minimal X value restricts the graph's X value range and creates its lower bounds.</td></tr><tr><td style="width: 17.1817%;">MaxX</td><td style="width: 28.3043%;">FeatStd::Optional&lt;FeatStd::Float&gt;</td><td style="width: 54.514%;">The maximal X value restricts the graph's X value range and creates its upper bounds.</td></tr><tr><td style="width: 17.1817%;">MinY</td><td style="width: 28.3043%;">FeatStd::Optional&lt;FeatStd::Float&gt;</td><td style="width: 54.514%;">The minimal Y value restricts the graph's Y value range and creates its lower bounds.</td></tr><tr><td style="width: 17.1817%;">MaxY</td><td style="width: 28.3043%;">FeatStd::Optional&lt;FeatStd::Float&gt;</td><td style="width: 54.514%;">The maximal Y value restricts the graph's Y value range and creates its upper bounds.</td></tr><tr><td style="width: 17.1817%;">Line Width</td><td style="width: 28.3043%;">FeatStd::Float</td><td style="width: 54.514%;">The line width defines the thickness of the line.</td></tr><tr><td style="width: 17.1817%;">Interpolation</td><td style="width: 28.3043%;">GraphInterpolationType::Enum</td><td style="width: 54.514%;">Defines the interpolation type of the line chart.</td></tr><tr><td style="width: 17.1817%;">Interpolation Steps</td><td style="width: 28.3043%;">FeatStd::UInt16</td><td style="width: 54.514%;">Defines the amount of interpolation points between each value. This increase the spline resolution by the cost of performance and memory.</td></tr><tr><td style="width: 17.1817%;">Color of line</td><td style="width: 28.3043%;">[Candera::Color](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_color.html "Represents a color by its red-, green-, blue- and alpha-value. Provides color arithmetic functions an...")</td><td style="width: 54.514%;">Color of line.</td></tr></tbody></table>

</div></div></div></div>

# IdentifierValueMap

Behaviors that can be used to check for certain keys and values in IdentifierValueMapEvents and execute actions accordingly. Such events are sent from application code to the node or behavior.

#### **Mapped Value Action**

Extracts and sends the value from a key-value pair inside an incoming map as value changed event.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 18.4132%;">**Property Name**</th><th style="width: 27.4401%;">**Type**</th><th style="width: 54.1219%;">**Description**</th></tr><tr><td style="width: 18.4132%;">TargetNode</td><td style="width: 27.4401%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html)</td><td style="width: 54.1219%;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 18.4132%;">Keyword</td><td style="width: 27.4401%;">FeatStd::String</td><td style="width: 54.1219%;">Specifies the keyword of the map entry which value should be sent as value changed event.</td></tr></tbody></table>

</div></div></div></div>**Advanced Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-1" style="width: 100%;"><tbody><tr><th style="width: 18.4132%;">**Property Name**</th><th style="width: 27.9292%;">**Type**</th><th style="width: 53.6329%;">**Description**</th></tr><tr><td style="width: 18.4132%;">Action</td><td style="width: 27.9292%;">Candera::ActionBehaviorArrayProperty</td><td style="width: 53.6329%;">The set of ActionBehaviors that receive the value changed event.</td></tr></tbody></table>

#### <span style="color: rgb(0, 0, 0);">**Mapped Key Condition**</span>

Checks the key from a key-value pair inside an incoming Identifier Value Map Event.

**Common Properties**

<div class="textblock" id="bkmrk-"></div><div class="textblock" id="bkmrk-property-name-type-d-2"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 18.4132%;">**Property Name**</th><th style="width: 27.9339%;">**Type**</th><th style="width: 53.6281%;">**Description**</th></tr><tr><td style="width: 18.4132%;">Keyword</td><td style="width: 27.9339%;">FeatStd::String</td><td style="width: 53.6281%;">Specifies the keyword which shall be present in the map.</td></tr><tr><td style="width: 18.4132%;">ValueCondition</td><td style="width: 27.9339%;">Candera::ConditionBehavior</td><td style="width: 53.6281%;">Condition which is checked on the value of matching keyword. The value can be checked by "Check Value Changed".</td></tr></tbody></table>

</div><div class="textblock" id="bkmrk--2"></div><div class="textblock" id="bkmrk--3"></div>

# Layer

#### **Switch Layer Image**

Sets on an Image Layer. This special functionality is only available for Amber and Traveo2 platform due to hardware support.

This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.4448%;">**Property Name**</th><th style="width: 30.0239%;">**Type**</th><th style="width: 54.4901%;">**Description**</th></tr><tr><td style="width: 15.4448%;">Images</td><td style="width: 30.0239%;">SharedPointer&lt;Candera::Image2D&gt; </td><td style="width: 54.4901%;">Images: [Candera](http://dev.doc.cgistudio.at/APILINK/namespace_candera.html "&#91;DataBinding&#95;RefTypeSample&#93;"):ArrayProperty&lt;FeatStd::MemoryManagement::SharedPointer&lt;Candera::Image2d&gt;&gt;.</td></tr><tr><td style="width: 15.4448%;">Rendertarget</td><td style="width: 30.0239%;">RenderTarget2D\*</td><td style="width: 54.4901%;">Rendertarget:Candera::RenderTarget2D\*.</td></tr></tbody></table>

</div></div></div></div><div class="contents" id="bkmrk--1"><div class="contents"><div class="textblock">---

</div></div></div>

# Map

#### **Geocoding**

Provides forward and reverse geocoding functionality.

**About implicit roles of ChildNodes**

- For forward geocoding the text from a child node with name "Name" is used.
- For backward geocoding the text from a child node with name "Address" is used.
- The child nodes should be of type Node2D with one child TextNode2D.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d"><div class="contents"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>LocationList</td><td>Candera::AbstractNodePointer</td><td>List to populate with matched locations.</td></tr><tr><td>ItemTemplate</td><td>Candera::AbstractNodePointer</td><td>Template used to populate the list.</td></tr><tr><td>MaxItems</td><td>FeatStd::Int16</td><td>Maximum number of matches to show.</td></tr><tr><td>DelayBetweenRequests</td><td>FeatStd::UInt32</td><td>Number of milliseconds to wait between geocoding requests.</td></tr></tbody></table>

</div></div></div></div></div>

# Mixed Reality Behaviors

### Internal

#### Poi Metadata Handler

Behavior that handles the meta data of a single poi.

This behavior is available for 3D scenes only.

**Common Properties**

<table class="doxtable" id="bkmrk-property-name-type-d" style="width: 100%;"><tbody><tr><th style="width: 16.804%;">**Property Name**</th><th style="width: 38.3031%;">**Type**</th><th style="width: 44.9753%;">**Description**</th></tr><tr><td style="width: 16.804%;">IconNodes</td><td style="width: 38.3031%;">ArrayProperty&lt;Candera::AbstractNodePointer&gt;</td><td style="width: 44.9753%;">A process value event is sent to this nodes, if a respective poi update event arrives.</td></tr><tr><td style="width: 16.804%;">NameNodes  
</td><td style="width: 38.3031%;">ArrayProperty&lt;Candera::AbstractNodePointer&gt;</td><td style="width: 44.9753%;">A process value event is sent to this nodes, if a respective poi update event arrives.</td></tr><tr><td style="width: 16.804%;">OpenNowNodes  
</td><td style="width: 38.3031%;">ArrayProperty&lt;Candera::AbstractNodePointer&gt;</td><td style="width: 44.9753%;">A process value event is sent to this nodes, if a respective poi update event arrives.</td></tr><tr><td style="width: 16.804%;">RatingNodes  
</td><td style="width: 38.3031%;">ArrayProperty&lt;Candera::AbstractNodePointer&gt;</td><td style="width: 44.9753%;">A process value event is sent to this nodes, if a respective poi update event arrives.</td></tr><tr><td style="width: 16.804%;">PriceLevelNodes  
</td><td style="width: 38.3031%;">ArrayProperty&lt;Candera::AbstractNodePointer&gt;</td><td style="width: 44.9753%;">A process value event is sent to this nodes, if a respective poi update event arrives.</td></tr><tr><td style="width: 16.804%;">InfoTextNodes  
</td><td style="width: 38.3031%;">ArrayProperty&lt;Candera::AbstractNodePointer&gt;</td><td style="width: 44.9753%;">A process value event is sent to this nodes, if a respective poi update event arrives.</td></tr></tbody></table>

---

#### Distance Alpha Fading

**Description**

Distance Alpha Fading is a Behavior Building Block available in Construction Kit.

It receives a value representing the camera position and performs arithmetic operations on it to calculate target node alpha value.

The following operations are performed on input value:

<div class="contents" id="bkmrk-map-%28scale%29-value-fr"><div class="contents"><div class="textblock">

- Map (scale) value from initial range (default 0.00..100.00) to target range (default 0.00..1.00)
- Negate scaled value (changes the range to 0.00..-1.00) by multiplication (default multiplicand is -1.00)
- Increase negated value (changes the range to 1.00..0.00) by addition (default addend is +1.00)
- Sets calculated alpha value on target node using <span style="color: rgb(230, 126, 35);">[Set Alpha Value](https://doc316en.candera.eu/link/647#bkmrk-set-alpha-value)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-0"><div class="textblock"><table class="doxtable"><tbody><tr><th>**Property Name**</th><th>**Type**</th><th>**Description**</th></tr><tr><td>Input Min</td><td>FeatStd::Optional&lt;FeatStd::Variant&gt;  
</td><td>This minimum value has to be set for input value scaling to take effect.

*FeatStd::Float expected.*

</td></tr><tr><td>Input Max</td><td>FeatStd::Optional&lt;FeatStd::Variant&gt;  
</td><td>This maximum value has to be set for input value scaling to take effect.

*FeatStd::Float expected.*

</td></tr><tr><td>Multiplication Value</td><td>[FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html)  
</td><td>Multiplies received value by this number (after scaling).

*FeatStd::Float expected.*

</td></tr><tr><td>Addition Value</td><td>[FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html)  
</td><td>Adds this number to received value (after multiplication).

*FeatStd::Float expected.*

</td></tr><tr><td>Target Node</td><td>[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td>Target node that will have its alpha value set.</td></tr></tbody></table>

</div></div>#### Navigation Path

Registers to navigation points and displays them as mesh in world space.

This behavior is available for 3D scenes only.

**Common Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-1" style="width: 100%; height: 385.734px;"><tbody><tr style="height: 29.4667px;"><th style="width: 19.028%; height: 29.4667px;">**Property Name**</th><th style="width: 30.1483%; height: 29.4667px;">**Type**</th><th style="width: 50.9061%; height: 29.4667px;">**Description**</th></tr><tr style="height: 57.4667px;"><td style="width: 19.028%; height: 57.4667px;">ColorMode</td><td style="width: 30.1483%; height: 57.4667px;">ColorMode::Enum</td><td style="width: 50.9061%; height: 57.4667px;">Select how color is displayed.

*Possible values: Color, RGBA*

</td></tr><tr style="height: 29.4667px;"><td style="width: 19.028%; height: 29.4667px;">Color  
</td><td style="width: 30.1483%; height: 29.4667px;">Candera::Color</td><td style="width: 50.9061%; height: 29.4667px;">Determines the color of the mesh.  
</td></tr><tr style="height: 29.4667px;"><td style="width: 19.028%; height: 29.4667px;">Width  
</td><td style="width: 30.1483%; height: 29.4667px;">FeatStd::Float</td><td style="width: 50.9061%; height: 29.4667px;">Determines the width of the mesh.</td></tr><tr style="height: 29.4667px;"><td style="width: 19.028%; height: 29.4667px;">Length  
</td><td style="width: 30.1483%; height: 29.4667px;">FeatStd::Float</td><td style="width: 50.9061%; height: 29.4667px;">Determines the length of the mesh</td></tr><tr style="height: 29.4667px;"><td style="width: 19.028%; height: 29.4667px;">YOffset  
</td><td style="width: 30.1483%; height: 29.4667px;">FeatStd::Float</td><td style="width: 50.9061%; height: 29.4667px;">Applies y-offset to the mesh.</td></tr><tr style="height: 63.0667px;"><td style="width: 19.028%; height: 63.0667px;">InputPoints  
</td><td style="width: 30.1483%; height: 63.0667px;">ListPropertyType&lt; CgiStudioControl::Internal::AR::ArPoint&gt;</td><td style="width: 50.9061%; height: 63.0667px;">This property is used to bind input points.</td></tr><tr style="height: 29.4667px;"><td style="width: 19.028%; height: 29.4667px;">InputPointHandling  
</td><td style="width: 30.1483%; height: 29.4667px;">InputPointHandling::Enum</td><td style="width: 50.9061%; height: 29.4667px;">Determines how new input points are used for the mesh.

*Possible values. Attach, Replace*

</td></tr><tr style="height: 29.4667px;"><td style="width: 19.028%; height: 29.4667px;">InterpolationType  
</td><td style="width: 30.1483%; height: 29.4667px;">InterpolationType::Enum</td><td style="width: 50.9061%; height: 29.4667px;">Determines which interpolation method is used.

*Possible values: Linear, Bezier, Spline, None*

</td></tr><tr style="height: 29.4667px;"><td style="width: 19.028%; height: 29.4667px;">MeshType  
</td><td style="width: 30.1483%; height: 29.4667px;">MeshType::Enum</td><td style="width: 50.9061%; height: 29.4667px;">Determines which primitive type is used.

*Possible values: Solid, Points*

</td></tr><tr style="height: 29.4667px;"><td style="width: 19.028%; height: 29.4667px;">IsAdvanced  
</td><td style="width: 30.1483%; height: 29.4667px;">bool  
</td><td style="width: 50.9061%; height: 29.4667px;">Enables advanced settings of the behavior.</td></tr></tbody></table>

**Advanced Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-2" style="width: 100%;"><tbody><tr><th style="width: 20.1391%;">**Property Name**</th><th style="width: 18.4111%;">**Type**</th><th style="width: 61.5321%;">**Description**</th></tr><tr><td style="width: 20.1391%;">Red  
</td><td style="width: 18.4111%;">FeatStd::UInt32</td><td style="width: 61.5321%;">Red color channel.

*This property is only available if 'ColorMode' is set to 'RGBA'.*

</td></tr><tr><td style="width: 20.1391%;">Green  
</td><td style="width: 18.4111%;">FeatStd::UInt32</td><td style="width: 61.5321%;">Green color channel.

*This property is only available if 'ColorMode' is set to 'RGBA'.*

</td></tr><tr><td style="width: 20.1391%;">Blue  
</td><td style="width: 18.4111%;">FeatStd::UInt32</td><td style="width: 61.5321%;">Blue color channel.

*This property is only available if 'ColorMode' is set to 'RGBA'.*

</td></tr><tr><td style="width: 20.1391%;">Alpha  
</td><td style="width: 18.4111%;">FeatStd::UInt32</td><td style="width: 61.5321%;">Alpha color channel.

*This property is only available if 'ColorMode' is set to 'RGBA'.*

</td></tr><tr><td style="width: 20.1391%;">InputPointMinDistance  
</td><td style="width: 18.4111%;">FeatStd::Float</td><td style="width: 61.5321%;">Minimum distance of two control points. Input points that are closer together will be rejected.

*This property is only available if 'IsAdvanced' is checked.*

</td></tr><tr><td style="width: 20.1391%;">ReqFragmentSize  
</td><td style="width: 18.4111%;">FeatStd::SizeType</td><td style="width: 61.5321%;">Size of the fragment that is requested from the input point list.

*This property is only available if 'IsAdvanced' is checked.*

</td></tr><tr><td style="width: 20.1391%;">ReqThresholdDistance  
</td><td style="width: 18.4111%;">FeatStd::Float</td><td style="width: 61.5321%;">If the distance between camera and the last point is below this threshold, request a new fragment of input points.

*This property is only available if 'IsAdvanced' is checked.*

</td></tr><tr><td style="width: 20.1391%;">PointSize  
</td><td style="width: 18.4111%;">FeatStd::Float</td><td style="width: 61.5321%;">Determines the point size.

*This property is only available if 'MeshType' is set to 'Points'.*

</td></tr><tr><td style="width: 20.1391%;">NumOfRowsPerInputPoint  
</td><td style="width: 18.4111%;">FeatStd::UInt32</td><td style="width: 61.5321%;">Determines how many vertex rows are used to interpolate between two input points. Increasing this value makes the mesh smoother, but will also shorten the distance of the overlay, as number of vertices per row remain constant.

*This property is only available if 'IsAdvanced' is checked and 'InterpolationType' is set to 'None'.*

</td></tr><tr><td style="width: 20.1391%;">NumOfVertexRows  
</td><td style="width: 18.4111%;">FeatStd::UInt32</td><td style="width: 61.5321%;">Amount of vertical vertices in the mesh.

*This property is only available if 'IsAdvanced' is checked.*

</td></tr><tr><td style="width: 20.1391%;">NumOfVertexColums  
</td><td style="width: 18.4111%;">FeatStd::UInt32</td><td style="width: 61.5321%;">Amount of horizontal vertices in the mesh.

*This property is only available if 'IsAdvanced' is checked.*

</td></tr></tbody></table>

#### Poi Configuration

Behavior that configures the mapping of a name to a assetId, such that it can be found by the PoiFactory.

This behavior is available for 3D scenes only.

**Common Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-3" style="width: 100%; height: 88.4001px;"><tbody><tr style="height: 29.4667px;"><th style="width: 19.0228%; height: 29.4667px;">**Property Name**</th><th style="width: 33.9838%; height: 29.4667px;">**Type**</th><th style="width: 47.0758%; height: 29.4667px;">**Description**</th></tr><tr style="height: 29.4667px;"><td style="width: 19.0228%; height: 29.4667px;">PoiName</td><td style="width: 33.9838%; height: 29.4667px;">FeatStd::UInt32</td><td style="width: 47.0758%; height: 29.4667px;">Name of this poi.</td></tr><tr style="height: 29.4667px;"><td style="width: 19.0228%; height: 29.4667px;">PoiControlAssetId  
</td><td style="width: 33.9838%; height: 29.4667px;">FeatStd::UInt32</td><td style="width: 47.0758%; height: 29.4667px;">ID of the control that is associated with PoiName.</td></tr></tbody></table>

#### Poi Manager

Manager of the poi control nodes.

This behavior is available for 3D scenes only.

**Common Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-4" style="width: 100%; height: 227.2px;"><tbody><tr style="height: 29.4667px;"><th style="width: 21.4971%; height: 29.4667px;">**Property Name**</th><th style="width: 31.5094%; height: 29.4667px;">**Type**</th><th style="width: 47.0758%; height: 29.4667px;">**Description**</th></tr><tr style="height: 46.2667px;"><td style="width: 21.4971%; height: 46.2667px;">StreetPoints</td><td style="width: 31.5094%; height: 46.2667px;">ListPropertyType&lt;CgiStudioControl::Internal::AR::ArPoint&gt;</td><td style="width: 47.0758%; height: 46.2667px;">List of points of the street. Used to align the rotation of POIs.</td></tr><tr style="height: 46.2667px;"><td style="width: 21.4971%; height: 46.2667px;">StreetPointsMinDistance</td><td style="width: 31.5094%; height: 46.2667px;">FeatStd::Float</td><td style="width: 47.0758%; height: 46.2667px;">Minimum distance between two street points. Street points that are closer together will be rejected.</td></tr><tr style="height: 29.4667px;"><td style="width: 21.4971%; height: 29.4667px;">ReqDistance</td><td style="width: 31.5094%; height: 29.4667px;">FeatStd::Float</td><td style="width: 47.0758%; height: 29.4667px;">The distance in which POIs are requested from the model.</td></tr><tr style="height: 46.2667px;"><td style="width: 21.4971%; height: 46.2667px;">ReqThresholdDistance</td><td style="width: 31.5094%; height: 46.2667px;">FeatStd::Float</td><td style="width: 47.0758%; height: 46.2667px;">Once the camera has moved this specified distance a new request will be sent.</td></tr><tr style="height: 29.4667px;"><td style="width: 21.4971%; height: 29.4667px;">PoiMetaData</td><td style="width: 31.5094%; height: 29.4667px;">ArrayProperty&lt;FeatStd::String&gt;</td><td style="width: 47.0758%; height: 29.4667px;">Use databinding to receive metadata updates for the POIs</td></tr></tbody></table>

#### Pose Tracking

Behavior that sets the pose of a target node.

This behavior is available for 3D scenes only.

**Common Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-5" style="width: 100%;"><tbody><tr><th style="width: 19.0228%;">**Property Name**</th><th style="width: 33.9838%;">**Type**</th><th style="width: 47.0758%;">**Description**</th></tr><tr><td style="width: 19.0228%;">Position</td><td style="width: 33.9838%;">Candera::Vector3</td><td style="width: 47.0758%;">Position on the target node.</td></tr><tr><td style="width: 19.0228%;">Rotation</td><td style="width: 33.9838%;">Candera::Vector3</td><td style="width: 47.0758%;">Rotation on the target node.</td></tr><tr><td style="width: 19.0228%;">EnableUserControl</td><td style="width: 33.9838%;">bool  
</td><td style="width: 47.0758%;">Enable to use WASD control to navigate the camera instead of databinding.</td></tr><tr><td style="width: 19.0228%;">EventReceivers</td><td style="width: 33.9838%;">ArrayProperty&lt;Candera::AbstractNodePointer&gt;</td><td style="width: 47.0758%;">List of nodes that will receive position and rotation update events.</td></tr></tbody></table>

# Particle

#### **Particle Emitter** 

Emits Particles when attached to a Node with a Bounding Box. The Appearance of the Node will be used for the Particles and needs to be configured as specified in the Documentation.

This behavior is available for 3D scenes only.

**Emitter Settings**

<div class="contents" id="bkmrk-property-name-type-d"><div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 18.9016%;">**Property Name**</th><th style="width: 26.5679%;">**Type**</th><th style="width: 54.4893%;">**Description**</th></tr><tr><td style="width: 18.9016%;">Emit Particles</td><td style="width: 26.5679%;">bool</td><td style="width: 54.4893%;">If set to true then the behavior will emit particles.</td></tr><tr><td style="width: 18.9016%;">Emitter Type</td><td style="width: 26.5679%;">ParticleEmitterType::Enum</td><td style="width: 54.4893%;">Specifies the behavior of the emitted Particle.

*Possible values: BoxEmitter, SphereEmitter*

</td></tr><tr><td style="width: 18.9016%;">Maximum Particles  
</td><td style="width: 26.5679%;">UInt32  
</td><td style="width: 54.4893%;">Determines the maximum number of particles that can be displayed (Requires Scene Refresh).</td></tr><tr><td style="width: 18.9016%;">Particles Per Second  
</td><td style="width: 26.5679%;">UInt32  
</td><td style="width: 54.4893%;">Determines how many particles will be generated each second</td></tr></tbody></table>

</div></div></div></div></div></div>**Particle Settings**

<table class="doxtable" id="bkmrk-property-name-type-d-1" style="width: 100%;"><tbody><tr><th style="width: 15.4448%;">**Property Name**</th><th style="width: 30.0239%;">**Type**</th><th style="width: 54.4901%;">**Description**</th></tr><tr><td style="width: 15.4448%;">Life Time</td><td style="width: 30.0239%;">UInt32</td><td style="width: 54.4901%;">Determines how long a particle will live in Milliseconds.</td></tr><tr><td style="width: 15.4448%;">Random Life Time</td><td style="width: 30.0239%;">UInt32</td><td style="width: 54.4901%;">Determines how long a particle will live in Milliseconds.</td></tr><tr><td style="width: 15.4448%;">Velocity  
</td><td style="width: 30.0239%;">Candera::Vector3  
</td><td style="width: 54.4901%;">Determines the initial velocity of an emitted particle.</td></tr><tr><td style="width: 15.4448%;">Gravity  
</td><td style="width: 30.0239%;">Candera::Vector3</td><td style="width: 54.4901%;">Determines the gravity effects for all emitted particles.</td></tr><tr><td style="width: 15.4448%;">Random Spread  
</td><td style="width: 30.0239%;">Float  
</td><td style="width: 54.4901%;">Determines how the randomness of the initial velocity angle.</td></tr><tr><td style="width: 15.4448%;">Start Size  
</td><td style="width: 30.0239%;">Float  
</td><td style="width: 54.4901%;">Determines how big a particle will be when it is emitted.</td></tr><tr><td style="width: 15.4448%;">End Size  
</td><td style="width: 30.0239%;">Float  
</td><td style="width: 54.4901%;">Determines how big a particle will be when it vanishes.</td></tr><tr><td style="width: 15.4448%;">Start Color  
</td><td style="width: 30.0239%;">Candera::Color  
</td><td style="width: 54.4901%;">Determines what color a particle has be when it is emitted.</td></tr><tr><td style="width: 15.4448%;">End Color  
</td><td style="width: 30.0239%;">Candera::Color</td><td style="width: 54.4901%;">Determines what color a particle has when it vanishes.</td></tr><tr><td style="width: 15.4448%;">Fade In Time  
</td><td style="width: 30.0239%;">Optional&lt;FeatStd::UInt32&gt;  
</td><td style="width: 54.4901%;">Determines how long a new particle needs to be alive until it is fully visible.</td></tr><tr><td style="width: 15.4448%;">Fade Out Time  
</td><td style="width: 30.0239%;">Optional&lt;FeatStd::UInt32&gt;</td><td style="width: 54.4901%;">Determines how long a particle will fade out before it vanishes.</td></tr></tbody></table>

# Scripting Behaviors

#### **Enable Scripting System**

Enables or disables the scripting system. For example, dragging and dropping to the scene tree disables script system execution at runtime using a checkbox, and it can be enabled again using the same checkbox.

<table class="doxtable" id="bkmrk-property-name-type-d" style="width: 100%;"><tbody><tr><th style="width: 16.5655%;">**Property Name**</th><th style="width: 23.7316%;">**Type**</th><th style="width: 59.692%;">**Description**</th></tr><tr><td style="width: 16.5655%;">Enabled</td><td style="width: 23.7316%;">bool</td><td style="width: 59.692%;">Enables/disables the scripting system.</td></tr></tbody></table>

#### **Set Script Parameters**

This behavior allows users to set public variables of Lua scripts.

1. The value to set. Lua variables can have the following types: 
    - bool
    - int64
    - double (if you have floats in the behavior, cast them to double)
    - char\* (a null-terminated character string).

<table class="doxtable" id="bkmrk-property-name-type-d-1" style="width: 100%;"><tbody><tr><th style="width: 21.9285%;">**Property Name**</th><th style="width: 26.9246%;">**Type**</th><th style="width: 51.136%;">**Description**</th></tr><tr><td style="width: 21.9285%;">ScriptParameterName</td><td style="width: 26.9246%;">FeatStd::String</td><td style="width: 51.136%;">The name of the script parameter whose value will be set.

</td></tr><tr><td style="width: 21.9285%;">NodeWithScript</td><td style="width: 26.9246%;">Candera::AbstractNodePointer</td><td style="width: 51.136%;">Node whose script parameter will be changed.

</td></tr></tbody></table>

####  

#### **Set Script Property as Animation Property**

Binds an Animation to a declared Animation property inside a script's table. The 'PropertyName' has to match the Animation property name in the script and 'Animation' sets the actual Animation value. This Behavior as well as the script need to be placed on the same node. Multiple instances of this Behavior on a node can handle the respective amount of script Animation properties.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-2"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.5637%;">**Property Name**</th><th style="width: 38.0723%;">**Type**</th><th style="width: 45.364%;">**Description**</th></tr><tr><td style="width: 16.5637%;">PropertyName</td><td style="width: 38.0723%;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 45.364%;">The name of the property in the script.</td></tr><tr><td style="width: 16.5637%;">Animation</td><td style="width: 38.0723%;">SharedPointer&lt;[Candera::Animation::AnimationPlayer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_animation_1_1_animation_player.html "AnimationPlayer is an AnimationPlayerBase that animates AnimationBlendedProperties.")&gt;</td><td style="width: 45.364%;">The animation that should be set as the value of the script animation property.</td></tr></tbody></table>

</div></div></div>

# State Machine Behaviors

#### **State Machine**

A state machine is able to implement the complex states of a node/scene/application (including sub state machines and history state machines). Transitions with conditions and actions are used to change between states.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 14.9567%;">**Property Name**</th><th style="width: 38.4398%;">**Type**</th><th style="width: 46.6035%;">**Description**</th></tr><tr><td style="width: 14.9567%;">StateMachine</td><td style="width: 38.4398%;">Candera::Internal::StateMachineBehaviorData\*</td><td style="width: 46.6035%;">A state machine is able to implement the complex states of a node/scene/application (including sub state machines and history state machines). Transitions with conditions and actions are used to change between states.</td></tr><tr><td style="width: 14.9567%;">ConsumeEvent</td><td style="width: 38.4398%;">bool</td><td style="width: 46.6035%;">Set this flag to false if the event should not be consumed by the trigger. By default it is set to true and if the trigger evaluates to true the event will not be routed to any other behavior.</td></tr><tr><td style="width: 14.9567%;">ExecutePostponedActions</td><td style="width: 38.4398%;">bool</td><td style="width: 46.6035%;">When set to true (default is true) this event handler is the one that will execute the postponed asynchronous actions that are part of this event handler (directly or indirectly). When set to false the surrounding event handler will execute the postponed actions.</td></tr></tbody></table>

</div></div></div></div>

# Streaming Behaviors

#### **Video Stream**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_video_stream_behavior.html)</small>

Displays a video stream from a given source on a texture. Reacts on VideoControl events (see also <span style="color: rgb(230, 126, 35);">[Configure and Play Stream](https://doc316en.candera.eu/link/582#bkmrk-configure-and-play-s)</span>), and emits VideoState events (see also <span style="color: rgb(230, 126, 35);">[Check Video State](https://doc316en.candera.eu/link/597#bkmrk-check-video-state)</span>).

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d"><div class="contents"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 17.6689%;">**Property Name**</th><th style="width: 26.5651%;">**Type**</th><th style="width: 55.7249%;">**Description**</th></tr><tr><td style="width: 17.6689%;">TargetNode</td><td style="width: 26.5651%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 55.7249%;">The node on which the video will be displayed. If nothing is selected, the node on the anchor will be used.</td></tr><tr><td style="width: 17.6689%;">VideoSource</td><td style="width: 26.5651%;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 55.7249%;">URI to video resource (e.g. path to file or URL).</td></tr><tr><td style="width: 17.6689%;">ScaleToVideoSource</td><td style="width: 26.5651%;">bool</td><td style="width: 55.7249%;">If enabled the texture will be resized to the video size, otherwise the size of the current texture will persist.</td></tr><tr><td style="width: 17.6689%;">FlipVertically</td><td style="width: 26.5651%;">bool</td><td style="width: 55.7249%;">Flips video vertically.</td></tr><tr><td style="width: 17.6689%;">Timestamp</td><td style="width: 26.5651%;">FeatStd::UInt32</td><td style="width: 55.7249%;"><span lang="EN-IN" style="font-size: 11.0pt; line-height: 115%;">Plays a video from a given source (file path or URL) on a texture or image, with the option to play it normally or flipped vertically.</span>

</td></tr></tbody></table>

</div></div></div></div>

# Value Processing Behaviors

#### **Animation Value Processing Behaviors**

##### **Jump to Animation Keyframe**

Expects a Float value between 0 and 1 (inclusive) as an event. Sets a selected animation to a frame corresponding to the value that the AnimationProcessValueBehavior receives.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d"><div class="contents"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 18.6573%;">**Property Name**</th><th style="width: 35.7127%;">**Type**</th><th style="width: 45.5888%;">**Description**</th></tr><tr><td style="width: 18.6573%;">Animation</td><td style="width: 35.7127%;">SharedPointer&lt;[Candera::Animation::AnimationPlayer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_animation_1_1_animation_player.html "AnimationPlayer is an AnimationPlayerBase that animates AnimationBlendedProperties.")&gt;</td><td style="width: 45.5888%;">The animation controlled. AnimationProcessValueBehavior sets the animation to the frame corresponding to the value it receives.</td></tr><tr><td style="width: 18.6573%; height: 33.2667px; border-width: 1px;">SequenceStartTime</td><td style="width: 35.7127%; height: 33.2667px; border-width: 1px;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;Candera::Animation::SequenceTimeType&gt;</td><td style="width: 45.5888%; height: 33.2667px; border-width: 1px;">The start point of the animation. \[ms\]</td></tr><tr><td style="width: 18.6573%; height: 31.2667px; border-width: 1px;">SequenceDurationTime</td><td style="width: 35.7127%; height: 31.2667px; border-width: 1px;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt;Candera::Animation::SequenceTimeType&gt;</td><td style="width: 45.5888%; height: 31.2667px; border-width: 1px;">The duration of the animation. \[ms\]</td></tr><tr><td style="width: 18.6573%;">ControlNode  
</td><td style="width: 35.7127%;"><span style="color: rgb(230, 126, 35);">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</span></td><td style="width: 45.5888%;">  
</td></tr></tbody></table>

</div></div></div><div class="contents" id="bkmrk-property-name-type-d-0"><div class="contents">  
</div></div><div class="contents" id="bkmrk--0"><div class="textblock">---

</div></div>#### **Diagnostics Value Processing Behaviors**

##### **Frame Measurement**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_frame_measurement_behavior.html)</small>

Outputs Frame Measure information of the specified Render Target. These Measurements can be Frames Per Seconds, Current Frame and Frame Time. This Behavior acts as Source for Process Value Behaviors.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-5"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 18.5338%;">**Property Name**</th><th style="width: 30.2718%;">**Type**</th><th style="width: 51.1532%;">**Description**</th></tr><tr><td style="width: 18.5338%;">RenderTarget</td><td style="width: 30.2718%;">Candera::GraphicDeviceUnit\*</td><td style="width: 51.1532%;">The render target which FPS should be monitored.</td></tr><tr><td style="width: 18.5338%;">Output</td><td style="width: 30.2718%;">OutputType::Enum</td><td style="width: 51.1532%;">Specifies which information will be output.</td></tr><tr><td style="width: 18.5338%;">DispatchThreshold</td><td style="width: 30.2718%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt; [FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html) &gt;</td><td style="width: 51.1532%;">Specifies how much the Output has to change to dispatch an event to its receivers.</td></tr><tr><td style="width: 18.5338%;">Receivers  
</td><td style="width: 30.2718%;"><span style="color: rgb(0, 0, 0);">Candera::ProcessValueBehaviorArrayProperty</span></td><td style="width: 51.1532%;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>---

#### **Effects Value Processing Behaviors**

##### **Set Alpha Value**

Sets the Alpha value of a node (expects a Float value).

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-1"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 14.5799%;">**Property Name**</th><th style="width: 17.6636%;">**Type**</th><th style="width: 67.7153%;">**Description**</th></tr><tr><td style="width: 14.5799%;">Target Node</td><td style="width: 17.6636%;"><span style="color: rgb(230, 126, 35);">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</span></td><td style="width: 67.7153%;">The Node which gets the resulting alpha value. If not set, then the node where the behavior is attached to, will be modified.</td></tr></tbody></table>

</div></div>##### **Switch Image**

Sets an image on a Render Node based on a float index received as event.

**Supports**

<div class="contents" id="bkmrk-controls%3A-flipbook"><div class="contents"><div class="textblock">

- Controls: 
    - [<span style="color: rgb(230, 126, 35);">FlipBook</span>](https://doc316en.candera.eu/books/controls-and-behaviors/page/common#bkmrk-flipbook)

</div></div></div>**Example Usage**

<div class="contents" id="bkmrk-flipbook-switch-imag"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Switch Image Example](https://doc316en.candera.eu/link/572#bkmrk-switch-image-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-2"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.4333%;">**Property Name**</th><th style="width: 19.0252%;">**Type**</th><th style="width: 64.5004%;">**Description**</th></tr><tr><td style="width: 16.4333%;">Upload Strategy</td><td style="width: 19.0252%;">Enum (OnInit, OnDemand)</td><td style="width: 64.5004%;">Specifies if images are uploaded on demand or when the behavior is instantiated. OnInit may cause an initial delay and keeps all images loaded. OnDemand avoids an initial delay and only keeps one image loaded.

*Possible values: OnInit, OnDemand*

</td></tr><tr><td style="width: 16.4333%;">Target Node</td><td style="width: 19.0252%;">RenderNode \*</td><td style="width: 64.5004%;">The Render Node SwitchImageProcessValueBehavior will switch images on.</td></tr><tr><td style="width: 16.4333%;">Images  
</td><td style="width: 19.0252%;">SharedPointer&lt;Candera::Image2D&gt;</td><td style="width: 64.5004%;">A list of images which should be available for selection.

*This property is only available for 2D scenes.*

</td></tr><tr><td style="width: 16.4333%;">Textures  
</td><td style="width: 19.0252%;">SharedPointer&lt;Candera::TextureImage&gt;</td><td style="width: 64.5004%;">A list of images which should be available for selection.

*This property is only available for 3D scenes.*

</td></tr><tr><td style="width: 16.4333%;">OutOfBoundsHandlingMode  
</td><td style="width: 19.0252%;">OutOfBoundsHandlingMode::Enum</td><td style="width: 64.5004%;">Behavior when an index greater than the number of images is given.

*Possible values: Hold, Clamping*

</td></tr></tbody></table>

</div></div>##### **Switch Text**

Sets a text on a Render Node based on a float index received as event.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-3"><div class="textblock"><table class="doxtable" style="width: 100%; height: 59.5938px;"><tbody><tr style="height: 29.7969px;"><th style="width: 16.4333%; height: 29.7969px;">**Property Name**</th><th style="width: 21.0005%; height: 29.7969px;">**Type**</th><th style="width: 62.5251%; height: 29.7969px;">**Description**</th></tr><tr style="height: 29.7969px;"><td style="width: 16.4333%; height: 29.7969px;">Target Node</td><td style="width: 21.0005%; height: 29.7969px;"><span style="color: rgb(230, 126, 35);">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</span></td><td style="width: 62.5251%; height: 29.7969px;">The Render Node SwitchTextProcessValueBehavior will switch the text on.</td></tr><tr><td style="width: 16.4333%;">Texts  
</td><td style="width: 21.0005%;">ArrayProperty&lt;FeatStd::String&gt;</td><td style="width: 62.5251%;">Use list of texts (strings) and switch between them.</td></tr></tbody></table>

</div></div>
##### **Zoom Effect**

Expects a Float value between 0 and 1 (inclusive) as an event. Applies scale and alpha on children of a group.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-4"><div class="textblock"><table border="1" class="doxtable" style="border-collapse: collapse; width: 100%;"><tbody><tr><th style="width: 21.9934%;">**Property Name**</th><th style="width: 21.9901%;">**Type**</th><th style="width: 55.9754%;">**Description**</th></tr><tr><td style="width: 21.9934%;">Target Node  
</td><td style="width: 21.9901%;"><span style="color: rgb(230, 126, 35);">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</span></td><td style="width: 55.9754%;">The node whose children are enabled or disabled by ZoomProcessValueBehavior. If not set, then the node where the behavior is attached to will be considered.</td></tr><tr><td style="width: 21.9934%;">Alpha Factors</td><td style="width: 21.9901%;">Vector2</td><td style="width: 55.9754%;">Min/Max transparency factors</td></tr><tr><td style="width: 21.9934%;">Zoom Factors</td><td style="width: 21.9901%;">Vector2</td><td style="width: 55.9754%;">Min/Max zoom factors</td></tr><tr><td style="width: 21.9934%;">Zoom Distribution</td><td style="width: 21.9901%;">Float</td><td style="width: 55.9754%;">Distribution of Zoom/Alpha to each side of the selection.</td></tr><tr><td style="width: 21.9934%;">ZoomByLayout</td><td style="width: 21.9901%;">bool</td><td style="width: 55.9754%;">Whether the zoom is accomplished by layout size.</td></tr></tbody></table>

</div></div>---

#### **Transformation Value Processing Behaviors**

##### **Resize Group Node**  


Expects a Float value as an event, and changes the layout size of a group node it is placed on. When mode is 'Relative' it scales the layout size (expected value is a normalized value). When mode is 'Absolute' the layout size is set in pixels.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-6"><div class="textblock"><table class="doxtable" style="width: 100%; height: 138.8px;"><tbody><tr style="height: 46.2667px;"><th style="width: 12.603%; height: 46.2667px;">**Property Name**</th><th style="width: 22.116%; height: 46.2667px;">**Type**</th><th style="width: 65.2399%; height: 46.2667px;">**Description**</th></tr><tr style="height: 46.2667px;"><td style="width: 12.603%; height: 46.2667px;">AffectXAxis</td><td style="width: 22.116%; height: 46.2667px;">bool</td><td style="width: 65.2399%; height: 46.2667px;">Enables or disables scaling in horizontal direction.</td></tr><tr style="height: 46.2667px;"><td style="width: 12.603%; height: 46.2667px;">AffectYAxis</td><td style="width: 22.116%; height: 46.2667px;">bool</td><td style="width: 65.2399%; height: 46.2667px;">Enables or disables scaling in vertical direction.</td></tr><tr><td style="width: 12.603%;">Mode  
</td><td style="width: 22.116%;">Mode::Enum</td><td style="width: 65.2399%;">Determines how the received value will be interpreted.</td></tr><tr><td style="width: 12.603%;">ScaleVector  
</td><td style="width: 22.116%;">Vector2  
</td><td style="width: 65.2399%;">This vector is multiplied by the received value and specifies the magnitude by which the node is scaled.</td></tr></tbody></table>

</div></div>##### **Set Node Size**

Expects a Float value as an event. Sets the layout size of a node on a given axis by the received value in pixels.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-7"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 12.603%;">**Property Name**</th><th style="width: 22.7309%;">**Type**</th><th style="width: 64.625%;">**Description**</th></tr><tr><td style="width: 12.603%;">Target Node</td><td style="width: 22.7309%;"><span style="color: rgb(230, 126, 35);">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</span></td><td style="width: 64.625%;">The target node which is modified. if not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 12.603%;">Size Axis</td><td style="width: 22.7309%;">AxisType2D::Enum </td><td style="width: 64.625%;">The axis along which the size is set.

*Possible values: AxisX, AxisY*

</td></tr></tbody></table>

</div></div>##### **Set Position**

Expects a Float value as an event. Translates Position Node along given axis by the received value in pixels.

**Example Usage**

<div class="contents" id="bkmrk-set-position-example"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Set Position Example](https://doc316en.candera.eu/link/572#bkmrk-set-position-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-8"><div class="textblock"><table border="1" class="doxtable" style="border-collapse: collapse; width: 100%;"><tbody><tr><th style="width: 21.0049%;">**Property Name**</th><th style="width: 25.208%;">**Type**</th><th style="width: 53.8695%;">**Description**</th></tr><tr><td style="width: 21.0049%;">Target Node</td><td style="width: 25.208%;"><span style="color: rgb(230, 126, 35);">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</span></td><td style="width: 53.8695%;">The target node to which the events are routed from the source node.</td></tr><tr><td style="width: 21.0049%;">Translation Axis 2D  
</td><td style="width: 25.208%;">AxisType2D::Enum</td><td style="width: 53.8695%;">The axis along which the position is set.

*Possible values: AxisX, AxisY*

*This property is only available for 2D scenes.*

</td></tr><tr><td style="width: 21.0049%;">Translation Axis 3D  
</td><td style="width: 25.208%;">AxisType3D::Enum</td><td style="width: 53.8695%;">The axis along which the position is set.

*Possible values: AxisX, AxisY,, AxisZ*

*This property is only available for 3D scenes.*

</td></tr></tbody></table>

</div></div>##### **Set Rotation**

Expects a Float value as an event. Rotates Rotation Node clockwise by the received value in degrees.

**Example Usage**

<div class="contents" id="bkmrk-set-rotation-example"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Set Rotation Example](https://doc316en.candera.eu/link/572#bkmrk-set-rotation-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-9"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 14.8331%;">**Property Name**</th><th style="width: 20.0237%;">**Type**</th><th style="width: 65.1432%;">**Description**</th></tr><tr><td style="width: 14.8331%;">Target Node</td><td style="width: 20.0237%;"><span style="color: rgb(230, 126, 35);">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</span></td><td style="width: 65.1432%;">The node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 14.8331%;">RotationAxis  
</td><td style="width: 20.0237%;"><span style="color: rgb(0, 0, 0);">AxisType3D::Enum</span></td><td style="width: 65.1432%;">The axis to rotate the node around.

*Possible values: AxisX, AxisY,, AxisZ*

*This property is only available for 3D scenes.*

</td></tr></tbody></table>

</div></div>##### **Set Scale**

Expects a Float value as an event. Scales Scaled Node by the received (scalar) value multiplied by Vector (X value for horizontal scaling, Y value for vertical scaling). Scaling along either axis can be enabled or disabled.

**Example Usage**

<div class="contents" id="bkmrk-set-scale-example"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Set Scale Example](https://doc316en.candera.eu/link/572#bkmrk-set-scale-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-10"><div class="textblock"><table class="doxtable" style="width: 100%; height: 256.667px;"><tbody><tr style="height: 29.4667px;"><th style="width: 14.7095%; height: 29.4667px;">**Property Name**</th><th style="width: 21.1412%; height: 29.4667px;">**Type**</th><th style="width: 64.1493%; height: 29.4667px;">**Description**</th></tr><tr style="height: 46.2667px;"><td style="width: 14.7095%; height: 46.2667px;">TargetNode</td><td style="width: 21.1412%; height: 46.2667px;"><span style="color: rgb(230, 126, 35);">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</span></td><td style="width: 64.1493%; height: 46.2667px;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr style="height: 29.4667px;"><td style="width: 14.7095%; height: 29.4667px;">ScaleAlongX</td><td style="width: 21.1412%; height: 29.4667px;">bool</td><td style="width: 64.1493%; height: 29.4667px;">Enables or disables scaling in horizontal direction.</td></tr><tr style="height: 29.4667px;"><td style="width: 14.7095%; height: 29.4667px;">ScaleAlongY</td><td style="width: 21.1412%; height: 29.4667px;">bool</td><td style="width: 64.1493%; height: 29.4667px;">Enables or disables scaling in vertical direction.</td></tr><tr style="height: 29.4667px;"><td style="width: 14.7095%; height: 29.4667px;">ScaleAlongZ</td><td style="width: 21.1412%; height: 29.4667px;">bool</td><td style="width: 64.1493%; height: 29.4667px;">Enables or disables scaling in Z-direction.

*This property is only available for 3D scenes.*

</td></tr><tr style="height: 46.2667px;"><td style="width: 14.7095%; height: 46.2667px;">ScaleVector2D</td><td style="width: 21.1412%; height: 46.2667px;">Vector2</td><td style="width: 64.1493%; height: 46.2667px;">This vector is multiplied by the received value and specifies the magnitude by which the node is scaled.

*This property is only available for 2D scenes.*

</td></tr><tr style="height: 46.2667px;"><td style="width: 14.7095%; height: 46.2667px;">ScaleVector3D</td><td style="width: 21.1412%; height: 46.2667px;">Vector3</td><td style="width: 64.1493%; height: 46.2667px;">This vector is multiplied by the received value and specifies the magnitude by which the node is scaled.

*This property is only available for 3D scenes.*

</td></tr></tbody></table>

</div></div>##### **Move Node**

Expects a Float value as an event. Translates Translated Node by the received (scalar) value multiplied by Vector X Y (Z).

**Example Usage**

<div class="contents" id="bkmrk-move-node-example"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Move Node Example](https://doc316en.candera.eu/link/572#bkmrk-move-node-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-11"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.9403%;">**Property Name**</th><th style="width: 19.3975%;">**Type**</th><th style="width: 64.6211%;">**Description**</th></tr><tr><td style="width: 15.9403%;">Target Node</td><td style="width: 19.3975%;"><span style="color: rgb(230, 126, 35);">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</span></td><td style="width: 64.6211%;">The node TranslateProcessBehavior moves.</td></tr><tr><td style="width: 15.9403%;">Multiplied Vector</td><td style="width: 19.3975%;">Vector3</td><td style="width: 64.6211%;">This vector is multiplied by the value TranslateProcessValueBehavior receives and specifies direction and magnitude by which TranslateProcessValueBehavior moves Translated Node. If not set, then the node where the behavior is attached to, will be modified.</td></tr></tbody></table>

</div></div>---

#### **AnimationMeter**

This behavior is a Behavior Block. It can be dragged&amp;dropped on nodes just like any Behavior. Controls an animation according to the passed value.

<table class="doxtable" id="bkmrk-property-name-type-d-12" style="width: 100%; height: 93.0114px;"><tbody><tr style="height: 29.7017px;"><th style="width: 15.9403%; height: 29.7017px;">**Property Name**</th><th style="width: 19.3975%; height: 29.7017px;">**Type**</th><th style="width: 64.6211%; height: 29.7017px;">**Description**</th></tr><tr style="height: 63.3097px;"><td style="width: 15.9403%; height: 63.3097px;">Animation</td><td style="width: 19.3975%; height: 63.3097px;">Candera::Animation::AnimationPlayer</td><td style="width: 64.6211%; height: 63.3097px;">TThe animation controlled. AnimtionMeter sets the animation to the frame corresponding to a mapped value it receives.

</td></tr><tr><td style="width: 15.9403%;">Minimum</td><td style="width: 19.3975%;"><span style="color: rgb(0, 0, 0);">FeatStd::Variant</span></td><td style="width: 64.6211%;">Minimum of the Variant value which will be mapped between 0 and 1.

</td></tr><tr><td style="width: 15.9403%;">Maximum</td><td style="width: 19.3975%;"><span style="color: rgb(0, 0, 0);">FeatStd::Variant</span></td><td style="width: 64.6211%;">Maximum of the Variant value which will be mapped between 0 and 1.

</td></tr></tbody></table>

#### **Arithmetic Operation**

Arithmetic operation behavior allows to perform addition, subtraction, multiplication and division operations on the passed value.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-13"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.1862%;">**Property Name**</th><th style="width: 36.9425%;">**Type**</th><th style="width: 46.8302%;">**Description**</th></tr><tr><td style="width: 16.1862%;">Operation</td><td style="width: 36.9425%;">ArithmeticOperationType::Enum</td><td style="width: 46.8302%;">Arithmetic operation to be performed.

*Possible values: Addition, Subtraction, Multiplication, Division, Modulo, Absolute*

</td></tr><tr><td style="width: 16.1862%;">Operand</td><td style="width: 36.9425%;">[FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html)</td><td style="width: 46.8302%;">A number to be used as addend/subtrahend/multiplicant/divisor on provided value.</td></tr><tr><td style="width: 16.1862%;">OutputType</td><td style="width: 36.9425%;">VariantValueType::Enum</td><td style="width: 46.8302%;">Type of the Variant forwarded as result.

*Possible values: FloatValue, Int32Value, UInt32Value, BoolValue, DoubleValue, Int8Value, Int16Value,  Int64Value, UInt8Value, UInt16Value, UInt64Value, StringValue*

</td></tr><tr><td style="width: 16.1862%;">Receivers  
</td><td style="width: 36.9425%;"><span style="color: rgb(0, 0, 0);">Candera::ProcessValueBehaviorArrayProperty</span></td><td style="width: 46.8302%;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>#### **Clock**

Converts a time integer into seconds, minutes and hours and passes those values to behavior-properties.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-14"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 27.3064%;">**Property Name**</th><th style="width: 31.5031%;">**Type**</th><th style="width: 41.2728%;">**Description**</th></tr><tr><td style="width: 27.3064%;">SecondsProcessValueBehavior</td><td style="width: 31.5031%;">[Candera::ProcessValueBehavior](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_process_value_behavior.html "The ProcessValueBehavior provides a Variant data type which is bindable. A value change results in a ...")\*</td><td style="width: 41.2728%;">The behavior that receives the seconds.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr><tr><td style="width: 27.3064%;">MinutesProcessValueBehavior</td><td style="width: 31.5031%;">[Candera::ProcessValueBehavior](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_process_value_behavior.html "The ProcessValueBehavior provides a Variant data type which is bindable. A value change results in a ...")\*</td><td style="width: 41.2728%;">The behavior that receives the minutes.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr><tr><td style="width: 27.3064%;">HoursProcessValueBehavior</td><td style="width: 31.5031%;">[Candera::ProcessValueBehavior](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_process_value_behavior.html "The ProcessValueBehavior provides a Variant data type which is bindable. A value change results in a ...")\*</td><td style="width: 41.2728%;">The behavior that receives the hours.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr><tr><td style="width: 27.3064%;">OffsetInMinutes</td><td style="width: 31.5031%;">FeatStd::Int32</td><td style="width: 41.2728%;">Offset in minutes to add to time (i.e. for different time zones).</td></tr><tr><td style="width: 27.3064%;">ShowFull24Hours</td><td style="width: 31.5031%;">bool</td><td style="width: 41.2728%;">If true, hours will be shown from 0-23, otherwise in AM/PM format.</td></tr><tr><td style="width: 27.3064%;">AMText</td><td style="width: 31.5031%;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 41.2728%;">The string of the AM label.</td></tr><tr><td style="width: 27.3064%;">PMText</td><td style="width: 31.5031%;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 41.2728%;">The string of the PM label.</td></tr><tr><td style="width: 27.3064%;">AMPMTextBehavior</td><td style="width: 31.5031%;">[Candera::Behavior](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_behavior.html "Behaviors are small re-usable functional blocks that communicate via events. Behaviors are based on W...")\*</td><td style="width: 41.2728%;">Sets text 'AM' or 'PM'.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr><tr><td style="width: 27.3064%;">ShowSeconds</td><td style="width: 31.5031%;">bool</td><td style="width: 41.2728%;">If true, seconds will be shown.</td></tr><tr><td style="width: 27.3064%;">SecondsNode</td><td style="width: 31.5031%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 41.2728%;">The node that will be turned off if showing of seconds is disabled.</td></tr></tbody></table>

</div></div>#### **Dial**

Receives an angle from a ProcessValueEvent or a value in a ChangeValueEvent. The knob changes its rotation according to that angle. The Behavior Transmits the changed value through events (ValueChangedEvent and ProcessValueEvent).

This behavior is available for 2D scenes only.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-15"><div class="textblock"><table border="1" class="doxtable" style="border-collapse: collapse; width: 100%;"><tbody><tr><th style="width: 23.5997%;">**Property Name**</th><th style="width: 26.9357%;">**Type**</th><th style="width: 49.547%;">**Description**</th></tr><tr><td style="width: 23.5997%;">CurrentValue</td><td style="width: 26.9357%;">FeatStd::Int32</td><td style="width: 49.547%;">Current value for the dial.</td></tr><tr><td style="width: 23.5997%;">MinimumRotation</td><td style="width: 26.9357%;">FeatStd::Float</td><td style="width: 49.547%;">Minimum rotation of the dial.</td></tr><tr><td style="width: 23.5997%;">MaximumRotation</td><td style="width: 26.9357%;">FeatStd::Float</td><td style="width: 49.547%;">Maximum rotation of the dial.</td></tr><tr><td style="width: 23.5997%;">StepSize</td><td style="width: 26.9357%;">FeatStd::Float</td><td style="width: 49.547%;">Step size in degrees.</td></tr><tr><td style="width: 23.5997%;">KnobNode</td><td style="width: 26.9357%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 49.547%;">Knob node which will be rotated.</td></tr><tr><td style="width: 23.5997%;">Receivers  
</td><td style="width: 26.9357%;"><span style="color: rgb(0, 0, 0);">Candera::ProcessValueBehaviorArrayProperty</span></td><td style="width: 49.547%;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>#### **Filter**

Filters the processed value via an attached Condition (e.g. Check processed Value).

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-16"><div class="textblock"><table class="doxtable" style="width: 97.9012%;"><tbody><tr><th style="width: 14.7668%;">**Property Name**</th><th style="width: 26.2521%;">**Type**</th><th style="width: 58.9411%;">**Description**</th></tr><tr><td style="width: 14.7668%;">Condition</td><td style="width: 26.2521%;">Candera::ConditionBehavior\*</td><td style="width: 58.9411%;">ConditionBehavior for passing the value to the next process value behavior.</td></tr><tr><td style="width: 14.7668%;">Receivers  
</td><td style="width: 26.2521%;"><span style="color: rgb(0, 0, 0);">Candera::ProcessValueBehaviorArrayProperty</span></td><td style="width: 58.9411%;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>#### **Forward Value**

Forwards a received value to the associated target (associated controls with a value property). Receives a ValueChanged-Event (change notification) and forwards it as a ChangeValue-Event(change request) to the target. The common usecase is to send the Value from a Value behavior to another Value behavior(or Control with a Value).

Emits a ChangeValueEvent which will be received by a Value Behavior.

<p class="callout info">Note that the target Value - Behavior must have 'Accept Value Event' property enabled.</p>

**Example Usage**

<div class="contents" id="bkmrk-forward-value-exampl"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Forward Value Example](https://doc316en.candera.eu/link/572#bkmrk-forward-value-exampl)</span>
- <span style="color: rgb(230, 126, 35);">[Thermometer Example](https://doc316en.candera.eu/link/572#bkmrk-thermometer-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-17"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 20.1483%;">**Property Name**</th><th style="width: 28.0522%;">**Type**</th><th style="width: 51.7995%;">**Description**</th></tr><tr><td style="width: 20.1483%;">Event Dispatch Strategy</td><td style="width: 28.0522%;">EventDispatchStrategyType::Enum</td><td style="width: 51.7995%;">The way the event gets sent.

*Possible values: Direct, Broadcast, Bubble, Tunnel, DedicatedBehavior*

</td></tr><tr><td style="width: 20.1483%;">Target Node</td><td style="width: 28.0522%;"><span style="color: rgb(230, 126, 35);">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</span></td><td style="width: 51.7995%;">The target node to which the events are routed. If this property is not set, the event will be routed to the node of the behavior.</td></tr><tr><td style="width: 20.1483%;">Dedicated Behavior  
</td><td style="width: 28.0522%;"><span style="color: rgb(0, 0, 0);">Candera::ProcessValueBehavior\*</span></td><td style="width: 51.7995%;">The dedicated process value behavior that will receive the change value event.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>#### **Interpolate Value**

Expects a Float value as an event. This behavior holds an internal Float value. It changes this internal value with given speed (Units Per Second) until it reaches the received value. Unless received value matches internal value, it sends internal value to a Process Value Behavior every frame.

If the *Animation Mode* property is set to *Instant*, no interpolation will be taking place - the received value will be applied immediately.

**Example Usage**

<div class="contents" id="bkmrk-interpolate-value-ex"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Interpolate Value Example](https://doc316en.candera.eu/link/572#bkmrk-interpolate-value-ex)</span>
- [<span style="color: rgb(230, 126, 35);">Set Scale Example</span>](https://doc316en.candera.eu/link/572#bkmrk-set-scale-example)

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-18"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 18.0395%;">**Property Name**</th><th style="width: 25.1965%;">**Type**</th><th style="width: 56.7228%;">**Description**</th></tr><tr><td style="width: 18.0395%;">Animation Mode</td><td style="width: 25.1965%;">InterpolationAnimationMode::Enum</td><td style="width: 56.7228%;">Animation mode sets a specific interpolation type.

*Possible values: SpeedBased, TimeBased, Instant*

</td></tr><tr><td style="width: 18.0395%;">Units Per Second</td><td style="width: 25.1965%;">Float</td><td style="width: 56.7228%;">Speed at which InterpolateProcessValueBehavior changes its internal value.

*This property can only be set when AnimationMode is set to "SpeedBased".*

</td></tr><tr><td style="width: 18.0395%;">Interpolation Time  
</td><td style="width: 25.1965%;">UInt32  
</td><td style="width: 56.7228%;">Time in ms the InterpolateProcessValueBehavior changes its internal value.

*This Property can only be set when AnimationMode is set to "TimeBased"*

</td></tr><tr><td style="width: 18.0395%;">Filter Time Constant</td><td style="width: 25.1965%;">Float</td><td style="width: 56.7228%;">The moment before InterpolateProcessValueBehavior’s internal value reaches the received value, the speed at which the former is changing slows down. This prevents a sudden end of movement that can be felt as artificial in some cases.

*This property can only be set when AnimationMode is set to either "SpeedBased" or "Timebased".*

</td></tr><tr><td style="width: 18.0395%;">Receivers  
</td><td style="width: 25.1965%;"><span style="color: rgb(0, 0, 0);">Candera::ProcessValueBehaviorArrayProperty</span></td><td style="width: 56.7228%;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>#### **Map Value**

Expects a Float value as an event. Maps the received value from one interval to another.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-19"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.3213%;">**Property Name**</th><th style="width: 31.5074%;">**Type**</th><th style="width: 53.1301%;">**Description**</th></tr><tr><td style="width: 15.3213%;">InputMin</td><td style="width: 31.5074%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt; [FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html) &gt;</td><td style="width: 53.1301%;">\[Optional\] Smallest value of the interval to check. If Minimum is given as greater than Maximum then the values are internally swapped.</td></tr><tr><td style="width: 15.3213%;">InputMax</td><td style="width: 31.5074%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt; [FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html) &gt;</td><td style="width: 53.1301%;">\[Optional\] Largest value of the interval to check. If Maximum is given as smaller than Minimum then the values are internally swapped.</td></tr><tr><td style="width: 15.3213%;">OutputMin</td><td style="width: 31.5074%;">FeatStd::Float</td><td style="width: 53.1301%;">Smallest value of the interval mapped to.</td></tr><tr><td style="width: 15.3213%;">OutputMax</td><td style="width: 31.5074%;">FeatStd::Float</td><td style="width: 53.1301%;">Largest value of the interval mapped to.</td></tr><tr><td style="width: 15.3213%;">OutputType</td><td style="width: 31.5074%;">VariantValueType::Enum</td><td style="width: 53.1301%;">Type of the Variant forwarded as result.

*Possible values: FloatValue, Int32Value, UInt32Value, BoolValue, DoubleValue, Int8Value, Int16Value,  Int64Value, UInt8Value, UInt16Value, UInt64Value, StringValue*

</td></tr><tr><td style="width: 15.3213%;">Receivers  
</td><td style="width: 31.5074%;"><span style="color: rgb(0, 0, 0);">Candera::ProcessValueBehaviorArrayProperty</span></td><td style="width: 53.1301%;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>#### **Map Value Normalized**

Maps the numeric value received via 'ProcessValueEvent' within an arbitrary range to the normalized range from 0.0 to 1.0 and dispatches the result locally to its receivers. Receivers of this Behavior must therefore be value processing behaviors operating on normalized values.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-20"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.939%;">**Property Name**</th><th style="width: 20.7559%;">**Type**</th><th style="width: 63.2639%;">**Description**</th></tr><tr><td style="width: 15.939%;">Reverse</td><td style="width: 20.7559%;">bool</td><td style="width: 63.2639%;">Toggles the mapping direction. If this property is true, the received value is assumed to be within range from 0.0 to 1.0 and the emitted value is mapped accordingly.</td></tr><tr><td style="width: 15.939%;">ValueForRange</td><td style="width: 20.7559%;">ValueBehaviorBase\*</td><td style="width: 63.2639%;">The input value behavior for defining the mapped range.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr><tr><td style="width: 15.939%;">Receivers  
</td><td style="width: 20.7559%;"><span style="color: rgb(0, 0, 0);">Candera::ProcessValueBehaviorArrayProperty</span></td><td style="width: 63.2639%;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>#### **Process Value Changed Event**

This behavior handles ValueChanged events and processes the new value within a set of ProcessValueBehaviors chains. By default ProcessValueChangedBehavior does consume the event, which will result in dispatching the event any further in the dispatching strategy. If further dispatching of the ValueChangedEvent is required set the ConsumeEvent flag to false.

**Example Usage**

- [<span style="color: rgb(230, 126, 35);">Process Value Changed Event - Slider Example</span>](https://doc316en.candera.eu/books/controls-and-behaviors/page/examples-using-predefined-behaviors#bkmrk-process-value-change)
- [<span style="color: rgb(230, 126, 35);">Process Value Changed Event - State Machine Example</span>](https://doc316en.candera.eu/books/controls-and-behaviors/page/examples-using-predefined-behaviors#bkmrk-process-value-change-1)

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-21"><div class="textblock"><table class="doxtable" style="width: 100%; height: 244px;"><tbody><tr style="height: 29.4667px;"><th style="width: 15.939%; height: 29.4667px;">**Property Name**</th><th style="width: 23.4728%; height: 29.4667px;">**Type**</th><th style="width: 60.547%; height: 29.4667px;">**Description**</th></tr><tr style="height: 46.2667px;"><td style="width: 15.939%; height: 46.2667px;">Sender</td><td style="width: 23.4728%; height: 46.2667px;"><span style="color: rgb(230, 126, 35);">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</span></td><td style="width: 60.547%; height: 46.2667px;">The node for which the event shall be emitted. If it is not set then the TargetNode or Node (if TargetNode is not set) will be taken instead.</td></tr><tr style="height: 29.4667px;"><td style="width: 15.939%; height: 29.4667px;">Minimum</td><td style="width: 23.4728%; height: 29.4667px;">Optional&lt;FeatStd::Variant&gt;</td><td style="width: 60.547%; height: 29.4667px;">Minimum threshold of the processed values.</td></tr><tr style="height: 29.4667px;"><td style="width: 15.939%; height: 29.4667px;">Maximum  
</td><td style="width: 23.4728%; height: 29.4667px;">Optional&lt;FeatStd::Variant&gt;  
</td><td style="width: 60.547%; height: 29.4667px;">Maximum threshold of the processed values.</td></tr><tr style="height: 63.0667px;"><td style="width: 15.939%; height: 63.0667px;">ConsumeEvent  
</td><td style="width: 23.4728%; height: 63.0667px;">bool  
</td><td style="width: 60.547%; height: 63.0667px;">Set this flag to false if the event should not be consumed by the trigger. By default it is set to true and if the trigger evaluates to true the event will not be routed to any other behavior.</td></tr><tr style="height: 46.2667px;"><td style="width: 15.939%; height: 46.2667px;">Receivers  
</td><td style="width: 23.4728%; height: 46.2667px;">ProcessValueBehavior ArrayProperty</td><td style="width: 60.547%; height: 46.2667px;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>#### **Render a Range**

This behavior is a Behavior Block. It can be dragged&amp;dropped on nodes just like any Behavior. Renders a range of nodes according to the passed value.

<table class="doxtable" id="bkmrk-property-name-type-d-22" style="width: 100%; height: 152.173px;"><tbody><tr style="height: 29.7017px;"><th style="width: 15.939%; height: 29.7017px;">**Property Name**</th><th style="width: 23.4728%; height: 29.7017px;">**Type**</th><th style="width: 60.547%; height: 29.7017px;">**Description**</th></tr><tr style="height: 46.2642px;"><td style="width: 15.939%; height: 46.2642px;">OperationMode</td><td style="width: 23.4728%; height: 46.2642px;">OperationModeType Enum</td><td style="width: 60.547%; height: 46.2642px;">When set to MultipleNodes, EnableNodesProcessValueBehavior will enable the first N children of Group Node. When Operation Mode is set to SingleNode, only Nth node is enabled. N is a number from 0 to number of all children nodes of Group Node. It corresponds linearly to the value EnableNodesProcessValueBehavior receives.</td></tr><tr style="height: 46.5057px;"><td style="width: 15.939%; height: 46.5057px;">Minimum</td><td style="width: 23.4728%; height: 46.5057px;">Optional&lt; FeatStd::Variant &gt;</td><td style="width: 60.547%; height: 46.5057px;">Minimum of the Variant value which gets mapped between 0 and 1.</td></tr><tr style="height: 29.7017px;"><td style="width: 15.939%; height: 29.7017px;">Maximum  
</td><td style="width: 23.4728%; height: 29.7017px;">Optional&lt; FeatStd::Variant &gt;</td><td style="width: 60.547%; height: 29.7017px;">Maximum of the Variant value which gets mapped between 0 and 1.</td></tr></tbody></table>

#### **Send ChangeValue on receiving ProcessValue event**

Sends out a new value. Associated controls with a value property receive the new values.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-23"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 20.6343%;">**Property Name**</th><th style="width: 26.9357%;">**Type**</th><th style="width: 52.3888%;">**Description**</th></tr><tr><td style="width: 20.6343%;">ChangeValue</td><td style="width: 26.9357%;">ChangeValue::Enum</td><td style="width: 52.3888%;">How the event value shall be handled by the receiving behavior</td></tr><tr><td style="width: 20.6343%;">Target Node  
</td><td style="width: 26.9357%;"><span style="color: rgb(230, 126, 35);">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</span></td><td style="width: 52.3888%;">The target node to which the events are routed. If this property is not set, the event will be routed to the node of the behavior.

*This property is only visible if EventDispatchStrategy is set to "Direct", "Broadcast", "Bubble" or "Tunnel".*

</td></tr><tr><td style="width: 20.6343%;">EventDispatchStrategy</td><td style="width: 26.9357%;">CgiStudioControl::EventDispatchStrategyType::Enum</td><td style="width: 52.3888%;">The way the event gets sent

*Possible values: Direct, Broadcast, Bubble, Tunnel, DedicatedBehavior*

</td></tr><tr><td style="width: 20.6343%;">DedicatedBehavior</td><td style="width: 26.9357%;">[Candera::ProcessValueBehavior](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_process_value_behavior.html "The ProcessValueBehavior provides a Variant data type which is bindable. A value change results in a ...")\*</td><td style="width: 52.3888%;">The dedicated process value behavior that will receive the change value event.

*This property can be set in the right side of the Scene Tree panel.*

*This property only visible if EventDispatchStrategy is set to "DedicatedBehavior".*

</td></tr><tr><td style="width: 20.6343%; height: 46.2667px;">Receivers  
</td><td style="width: 26.9357%; height: 46.2667px;">ProcessValueBehavior ArrayProperty</td><td style="width: 52.3888%; height: 46.2667px;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>#### **Set Selected State**

This behavior is a Behavior Block. It can be dragged&amp;dropped on nodes just like any Behavior.

Sets the state to selected or deselected according to the passed value.

#### **Smooth Value**

<small>[Class Reference](http://dev.doc.cgistudio.at/APILINK/class_cgi_studio_control_1_1_smoothing_process_value_behavior.html)</small>

Expects a numeric value as an event and applies exponent smoothing to that value and the previous calculated one.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-24"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 17.0511%;">**Property Name**</th><th style="width: 14.0857%;">**Type**</th><th style="width: 68.8221%;">**Description**</th></tr><tr><td style="width: 17.0511%;">SmoothingFactor</td><td style="width: 14.0857%;">FeatStd::Float</td><td style="width: 68.8221%;">The factor how fast the output value should adapt to the input value. Valid values are between 0.0 and 1.0</td></tr><tr><td style="width: 17.0511%; height: 46.2667px;">Receivers  
</td><td style="width: 14.0857%; height: 46.2667px;">ProcessValueBehavior ArrayProperty</td><td style="width: 68.8221%; height: 46.2667px;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>#### **Render Child Nodes**

Enables/Disables Child nodes corresponding to the received value and the behavior settings.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-25"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.6984%;">**Property Name**</th><th style="width: 26.2061%;">**Type**</th><th style="width: 58.0955%;">**Description**</th></tr><tr><td style="width: 15.6984%;">TargetNode</td><td style="width: 26.2061%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 58.0955%;">The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 15.6984%;">OperationMode</td><td style="width: 26.2061%;">OperationMode::Enum</td><td style="width: 58.0955%;">When set to MultipleNodes, EnableChildNodes will enable the first N children of Group Node. When Operation Mode is set to SingleNode, only the Nth node is enabled.

*Possible values: MultipleNodes, SingleNode*

</td></tr><tr><td style="width: 15.6984%;">Levels</td><td style="width: 26.2061%;">FeatStd::UInt8</td><td style="width: 58.0955%;">Number of levels to step down through groups. Default is zero.</td></tr><tr><td style="width: 15.6984%;">NormalizeValue</td><td style="width: 26.2061%;">bool</td><td style="width: 58.0955%;">If set to true, the received value has to be between 0 and 1 and will be mapped to the number of children. Otherwise the value has to be the index of the child.</td></tr></tbody></table>

</div></div>#### **Format String**

'Format String' modifies the Text of a TextNode Node and provides the Text as property for Controls. It supports formatted text that can display one variable.

**Example Usage**

<div class="contents" id="bkmrk-format-string-exampl"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Format String Example](https://doc316en.candera.eu/link/572#bkmrk-format-string-exampl)</span>
- <span style="color: rgb(230, 126, 35);">[Interpolate Value Example](https://doc316en.candera.eu/link/572#bkmrk-interpolate-value-ex)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-26"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 15.0803%;">**Property Name**</th><th style="width: 33.2474%;">**Type**</th><th style="width: 51.6722%;">**Description**</th></tr><tr><td style="width: 15.0803%;">Text</td><td style="width: 33.2474%;">String</td><td style="width: 51.6722%;">Text that TextBehavior will change the Node to. Supports formatting for one variable that corresponds to the value TextProcessValueBehavior2D receivers.</td></tr><tr><td style="width: 15.0803%;">Style</td><td style="width: 33.2474%;">[SharedPointer](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_memory_management_1_1_shared_pointer.html) &lt;Candera::TextRendering::SharedStyle&gt;</td><td style="width: 51.6722%;">The style that will be set to the Text Node.</td></tr><tr><td style="width: 15.0803%;">Alignment</td><td style="width: 33.2474%;">TextNode2DLayouter::TextAlignment</td><td style="width: 51.6722%;">The horizontal text alignment, using the culture text direction, is used to define how text will be horizontally aligned within its layout area.

*Possible values: Auto, Left, Center, Right*

</td></tr><tr><td style="width: 15.0803%;">Multiline</td><td style="width: 33.2474%;">bool</td><td style="width: 51.6722%;">If multi line is disabled, then the new line control characters will be ignored and text will always be rendered in one line.</td></tr><tr><td style="width: 15.0803%;">Line Spacing</td><td style="width: 33.2474%;">PixelSize (UInt16)</td><td style="width: 51.6722%;">Defines the distance between the baselines of successive lines of type.</td></tr><tr><td style="width: 15.0803%;">Word Wrap</td><td style="width: 33.2474%;">Bool</td><td style="width: 51.6722%;">If word wrapping is enabled then the lines that exceed the client area will be split during arrangement into multiple lines.</td></tr><tr><td style="width: 15.0803%;">Trimming</td><td style="width: 33.2474%;">TextNode2DLayouter::Trimming</td><td style="width: 51.6722%;">Trimming defines the behavior to employ when content overflows the content area.

*Possible values: None, Ellipsis, CustomText*

</td></tr><tr><td style="width: 15.0803%;">TrimmingText</td><td style="width: 33.2474%;">[FeatStd::String](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_string.html)</td><td style="width: 51.6722%;">Trimming text defines the text which replaces content overflowing the content area.

*This property is only visible if Trimming is set to "CustomText".*

</td></tr><tr><td style="width: 15.0803%;">TargetNode</td><td style="width: 33.2474%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 51.6722%;">The Node which gets the given text. If not set, then the node where the behavior is attached to, will be modified.</td></tr></tbody></table>

</div></div>#### **Track Angle on Drag**

Listens to the touch of the selected node, returns the angle between pressing, moving and releasing.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-27"><div class="textblock"><table border="1" class="doxtable" style="border-collapse: collapse; width: 100%;"><tbody><tr style="height: 29.4667px;"><th style="width: 16.804%; height: 29.4667px;">**Property Name**</th><th style="width: 29.0362%; height: 29.4667px;">**Type**</th><th style="width: 54.1186%; height: 29.4667px;">**Description**</th></tr><tr style="height: 35.0667px;"><td style="width: 16.804%; height: 35.0667px;">TouchNode</td><td style="width: 29.0362%; height: 35.0667px;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 54.1186%; height: 35.0667px;">A node that is used to collect information about the touch.</td></tr><tr><td style="width: 16.804%; height: 46.2667px;">Receivers  
</td><td style="width: 29.0362%; height: 46.2667px;">ProcessValueBehavior ArrayProperty</td><td style="width: 54.1186%; height: 46.2667px;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>#### **Drag on Track to Value**

Determines the position of a touch move in relation to the associated node and provides it as value in range from 0.0 to 1.0 (normalized). The horizontal boundary of the associated node is the track. The Dragged Node is used to determine the hit area and to determine the position change relative to its center. This behavior can be used as a source to a Value Behavior. Add a Value Behavior as a receiver.

**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-28"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 18.4102%;">**Property Name**</th><th style="width: 18.7809%;">**Type**</th><th style="width: 62.7677%;">**Description**</th></tr><tr><td style="width: 18.4102%;">TargetNode</td><td style="width: 18.7809%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 62.7677%;">The Node which gets the given text. If not set, then the node where the behavior is attached to, will be modified.</td></tr><tr><td style="width: 18.4102%;">UseCenter</td><td style="width: 18.7809%;">bool</td><td style="width: 62.7677%;">If true, the center value defined for the knob bitmap is used to align the knob to the value position, otherwise the calculated center.</td></tr><tr><td style="width: 18.4102%;">TrackDirection</td><td style="width: 18.7809%;">TrackDirection::Enum</td><td style="width: 62.7677%;">Defines if the position will be tracked horizontally or vertically

*Possible values: Vertical, Horizontal*

</td></tr><tr><td style="width: 18.4102%;">LeftTouchMargin</td><td style="width: 18.7809%;">FeatStd::Float</td><td style="width: 62.7677%;">Defines the size for extending or shrinking the touch-sensitive area at the left border of the knob. The size is given in percentage of the knob width. Positive values extend, negative values shrink the area.</td></tr><tr><td style="width: 18.4102%;">RightTouchMargin</td><td style="width: 18.7809%;">FeatStd::Float</td><td style="width: 62.7677%;">Defines the size for extending or shrinking the touch-sensitive area at the right border of the knob. The size is given in percentage of the knob width. Positive values extend, negative values shrink the area.</td></tr><tr><td style="width: 18.4102%;">TopTouchMargin</td><td style="width: 18.7809%;">FeatStd::Float</td><td style="width: 62.7677%;">Defines the size for extending or shrinking the touch-sensitive area at the top border of the knob. The size is given in percentage of the knob height. Positive values extend, negative values shrink the area.</td></tr><tr><td style="width: 18.4102%;">BottomTouchMargin</td><td style="width: 18.7809%;">FeatStd::Float</td><td style="width: 62.7677%;">Defines the size for extending or shrinking the touch-sensitive area at the bottom border of the knob. The size is given in percentage of the knob height. Positive values extend, negative values shrink the area.</td></tr><tr><td style="width: 18.4102%;">OnKnobDragOnly</td><td style="width: 18.7809%;">bool</td><td style="width: 62.7677%;">The position will only be updated when the Knob gets dragged, otherwise clicking on the control will move the knob to the position.</td></tr><tr><td style="width: 18.4102%;">UseExcclusiveMode  
</td><td style="width: 18.7809%;">bool  
</td><td style="width: 62.7677%;">Enabling the option prevents some controls (e.g. Slider) from loosing the touch when leaving the node area.  
</td></tr><tr><td style="width: 18.4102%;">DraggedNode  
</td><td style="width: 18.7809%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 62.7677%;">Defines the node to move along the track, to determine the hit area and to determine the position change relative to its center.

</td></tr><tr><td style="width: 18.4102%; height: 46.2667px;">Receivers  
</td><td style="width: 18.7809%; height: 46.2667px;">ProcessValueBehavior ArrayProperty</td><td style="width: 62.7677%; height: 46.2667px;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>#### **Action on Value**

Passes a Process Value to a Condition Behavior and if the response is positive, invokes an Action behavior.

**Example Usage**

<div class="contents" id="bkmrk-thermometer-example"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Thermometer Example](https://doc316en.candera.eu/link/572#bkmrk-thermometer-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-29"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 16.6873%;">**Property Name**</th><th style="width: 26.4486%;">**Type**</th><th style="width: 56.8641%;">**Description**</th></tr><tr><td style="width: 16.6873%;">Condition</td><td style="width: 26.4486%;">ConditionBehavior\*</td><td style="width: 56.8641%;">The ConditionBehavior that TriggerBehavior passes a value to and expect a response from to see if Action needs to be invoked.</td></tr><tr><td style="width: 16.6873%;">Actions</td><td style="width: 26.4486%;">ActionBehaviorArrayProperty</td><td style="width: 56.8641%;">The set of ActionBehaviors that TriggerBehavior invokes in the event that it receives a positive response form Condition.</td></tr><tr><td style="width: 16.6873%;">Consume Event</td><td style="width: 26.4486%;">bool</td><td style="width: 56.8641%;">Set this flag to false if the event should not be consumed by the trigger. By default it is set to true and if the trigger evaluates to true the event will not be routed to any other behavior.</td></tr></tbody></table>

</div></div>#### **Value**

ValueBehavior sends a value to any behavior derived from ProcessValueBehavior type. It supplies an input to process value behaviors via event.

**Example Usage**

<div class="contents" id="bkmrk-thermometer-example-"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Thermometer Example](https://doc316en.candera.eu/link/572#bkmrk-thermometer-example)</span>
- <span style="color: rgb(230, 126, 35);">[Format String Example](https://doc316en.candera.eu/link/572#bkmrk-format-string-exampl)</span>
- <span style="color: rgb(230, 126, 35);">[Interpolate Value Example](https://doc316en.candera.eu/link/572#bkmrk-interpolate-value-ex)</span>
- <span style="color: rgb(230, 126, 35);">[Move Node Example](https://doc316en.candera.eu/link/572#bkmrk-move-node-example)</span>
- <span style="color: rgb(230, 126, 35);">[Set Alpha Value Example](https://doc316en.candera.eu/link/572#bkmrk-set-alpha-value-exam)</span>
- <span style="color: rgb(230, 126, 35);">[Set Position Example](https://doc316en.candera.eu/link/572#bkmrk-set-position-example)</span>
- <span style="color: rgb(230, 126, 35);">[Set Rotation Example](https://doc316en.candera.eu/link/572#bkmrk-set-rotation-example)</span>
- <span style="color: rgb(230, 126, 35);">[Switch Image Example](https://doc316en.candera.eu/link/572#bkmrk-switch-image-example)</span>
- <span style="color: rgb(230, 126, 35);">[Set Scale Example](https://doc316en.candera.eu/link/572#bkmrk-set-scale-example)</span>

</div></div></div>**Common Properties**

<div class="contents" id="bkmrk-property-name-type-d-30"><div class="textblock"><table class="doxtable" style="width: 100%;"><tbody><tr><th style="width: 23.7232%;">**Property Name**</th><th style="width: 20.0165%;">**Type**</th><th style="width: 56.2191%;">**Description**</th></tr><tr><td style="width: 23.7232%;">Minimum</td><td style="width: 20.0165%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt; [FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html) &gt;</td><td style="width: 56.2191%;">Minimum of the Variant value. If Minimum is given as greater than Maximum then the values are internally swapped.

</td></tr><tr><td style="width: 23.7232%;">Maximum</td><td style="width: 20.0165%;">[FeatStd::Optional](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_optional.html "The template class Optional is a wrapper for representing optional objects that may not have been ini...")&lt; [FeatStd::Variant](http://dev.doc.cgistudio.at/APILINK/class_feat_std_1_1_variant.html) &gt;</td><td style="width: 56.2191%;">Maximum of the Variant value. If Maximum is given as smaller than Minimum then the values are internally swapped.</td></tr><tr><td style="width: 23.7232%;">IntervalHandling</td><td style="width: 20.0165%;">IntervalHandling::Enum</td><td style="width: 56.2191%;">Select how the behavior should react when the minimum or maximum limit is exceeded.

*Possible values: Limit, Cycle, Ignore*

</td></tr><tr><td style="width: 23.7232%;">AcceptValueEvent</td><td style="width: 20.0165%;">bool</td><td style="width: 56.2191%;">Set this flag to true to make the value changeable by events/actions.</td></tr><tr><td style="width: 23.7232%;">BroadcastProcessValueEvent</td><td style="width: 20.0165%;">bool</td><td style="width: 56.2191%;">Set this flag to true to broadcast ProcessValue event even if value did not change.</td></tr><tr><td style="width: 23.7232%;">DispatchStrategy  
</td><td style="width: 20.0165%;">CgiStudioControl::EventDispatchStrategyType::Enum</td><td style="width: 56.2191%;">By default the event that indicates that this value behavior has been changed (ValueChangedEvent) is dispatched only on the node to which the value behavior is attached (CgiStudioControl::EventDispatchStrategyType::Direct). To change this you have to select a different dispatch strategy.

*Possible values: Direct, Broadcast, Bubble, Tunnel, DedicatedBehavior*

</td></tr><tr><td style="width: 23.7232%;">DedicatedBehavior  
</td><td style="width: 20.0165%;">Candera::Behavior\*  
</td><td style="width: 56.2191%;">The dedicated behavior that will receive ValueChangedEvent when DedicatedBehavior dispatch strategy is selected.

*This property is only visible if DispatchStrategy is set to "DedicatedBehavior".*

*This property can be set in the right side of the Scene Tree panel.*

</td></tr><tr><td style="width: 23.7232%;">TargetNode  
</td><td style="width: 20.0165%;">[Candera::AbstractNodePointer](http://dev.doc.cgistudio.at/APILINK/class_candera_1_1_abstract_node_pointer.html "The class AbstractCameraPointer is an wrapper class to abstract 2D and 3D camera nodes.")</td><td style="width: 56.2191%;">The node on which the for which the EventDispatchStrategy will be applied. If it is not set then the Node will be taken instead.

*This property is only visible if DispatchStrategy is set to "Direct", "Broadcast", "Bubble" or "Tunnel".*

</td></tr><tr><td style="width: 23.7232%;">Variant  
</td><td style="width: 20.0165%;">Candera::Variant</td><td style="width: 56.2191%;">Specifies the type and the value to pass onto Process Value Behavior.</td></tr><tr><td style="width: 23.7232%; height: 46.2667px;">Receivers  
</td><td style="width: 20.0165%; height: 46.2667px;">ProcessValueBehavior ArrayProperty</td><td style="width: 56.2191%; height: 46.2667px;">The process value behaviors that will receive the value as next in the value processing chain.

*This property can be set in the right side of the Scene Tree panel.*

</td></tr></tbody></table>

</div></div>---

#### Value Generator

The Value Generator is a demo behavior. It allows you to configure minimum and maximum values, period, and update interval, and is used for UI verification and simulation purposes. It appears in the tool when CONTROLS\_DEMO\_BEHAVIORS\_ENABLED is enabled via CMake.

<p class="callout info">Related page: <span style="color: rgb(230, 126, 35);">[Control Behaviors Flags](https://doc316en.candera.eu/books/appendix-WCP/page/control-behaviors-flags)</span>  
</p>

**Common Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-31" style="width: 100%; height: 376px;"><tbody><tr style="height: 29.6px;"><th style="width: 23.7131%;">**Property Name**</th><th style="width: 20.0191%;">**Type**</th><th style="width: 56.244%;">**Description**</th></tr><tr style="height: 31.6px;"><td style="width: 23.7131%; height: 31.6px;">GeneratorFunction</td><td style="width: 20.0191%; height: 31.6px;">Enum</td><td style="width: 56.244%; height: 31.6px;">The type of function used to generate values (linear, sin, etc.)</td></tr><tr style="height: 29.6px;"><td style="width: 23.7131%; height: 29.6px;">Minimum</td><td style="width: 20.0191%; height: 29.6px;">Float</td><td style="width: 56.244%; height: 29.6px;">The minimum for the generated values.</td></tr><tr style="height: 32px;"><td style="width: 23.7131%; height: 32px;">Maximum</td><td style="width: 20.0191%; height: 32px;">Float</td><td style="width: 56.244%; height: 32px;">The maximum for the generated values.</td></tr><tr style="height: 29.6px;"><td style="width: 23.7131%; height: 29.6px;">OffsetMs</td><td style="width: 20.0191%; height: 29.6px;">Int</td><td style="width: 56.244%; height: 29.6px;">The time offset where the function is evaluated.</td></tr><tr style="height: 29.6px;"><td style="width: 23.7131%; height: 29.6px;">PeriodMs</td><td style="width: 20.0191%; height: 29.6px;">Int</td><td style="width: 56.244%; height: 29.6px;">The time period after which the generated values repeat.</td></tr><tr style="height: 25.2px;"><td style="width: 23.7131%; height: 25.2px;">SamplerateMs</td><td style="width: 20.0191%; height: 25.2px;">Int</td><td style="width: 56.244%; height: 25.2px;">The update rate of the generated value.</td></tr><tr style="height: 29.6px;"><td style="width: 23.7131%; height: 29.6px;">GenerateValues</td><td style="width: 20.0191%; height: 29.6px;">bool</td><td style="width: 56.244%; height: 29.6px;">Set this flag to true to generates values at sample rate. If set to false, no values are generated.

</td></tr><tr style="height: 46.4px;"><td style="width: 23.7131%; height: 46.4px;">Event Dispatch Strategy</td><td style="width: 20.0191%; height: 46.4px;">EventDispatchStrategyType::Enum</td><td style="width: 56.244%; height: 46.4px;">The way the event gets sent.

Possible values: Direct, Broadcast, Bubble, Tunnel, DedicatedBehavior

</td></tr><tr style="height: 46.4px;"><td style="width: 23.7131%; height: 46.4px;">Dedicated Behavior</td><td style="width: 20.0191%; height: 46.4px;">Candera::ProcessValueBehavior\*</td><td style="width: 56.244%; height: 46.4px;">The dedicated process value behavior that will receive the change value event. This property can be set in the right side of the Scene Tree panel.

</td></tr><tr style="height: 46.4px;"><td style="width: 23.7131%; height: 46.4px;">Target Node</td><td style="width: 20.0191%; height: 46.4px;">Candera::AbstractNodePointer</td><td style="width: 56.244%; height: 46.4px;">The target node to which the events are routed. If this property is not set, the event will be routed to the node of the behavior.

</td></tr></tbody></table>

# Set Uniform

#### **Set Uniform**

Sets the value of a specified uniform using the received input on a shader associated with a given node (NodeWithShader). The input value can be received from a value behavior. This behavior is available for 3D scenes only.

**Common Properties**

<table class="doxtable" id="bkmrk-property-name-type-d-1" style="width: 100%; height: 77.0001px;"><tbody><tr style="height: 29.4667px;"><th style="width: 17.2967%; height: 29.4667px;">**Property Name**</th><th style="width: 28.1729%; height: 29.4667px;">**Type**</th><th style="width: 54.4893%; height: 29.4667px;">**Description**</th></tr><tr style="height: 29.4667px;"><td style="width: 17.2967%; height: 29.4667px;">Uniform Name</td><td style="width: 28.1729%; height: 29.4667px;">FeatStd::String</td><td style="width: 54.4893%; height: 29.4667px;">The name of the uniform whose value will be set.</td></tr><tr style="height: 18.0667px;"><td style="width: 17.2967%; height: 18.0667px;">Node With Shader</td><td style="width: 28.1729%; height: 18.0667px;">Candera::Node\*</td><td style="width: 54.4893%; height: 18.0667px;">Node whose uniform setter's property will be changed.</td></tr></tbody></table>

# BehaviorGroup

BehaviorGroup (<span style="color: rgb(230, 126, 35);">[Fusion Group](https://doc316en.candera.eu/link/1060#bkmrk-fusion-group-%28behavi)</span>) is used to group multiple behaviors (Fusion nodes). This simplifies the organization of behaviors (Fusion nodes) in the extra scene tree and on the Fusion diagram, and makes overall management easier. Once created, BehaviorGroups can be renamed to anything you want and duplicated for other uses.

A similar function is the <span style="color: rgb(230, 126, 35);">[BehaviorBuildingBlock](https://doc316en.candera.eu/books/controls-and-behaviors/page/behavior-building-blocks-behavior-blocks)</span>, which can be instantiated by creating a template. For this reason, BehaviorGroup is easier and faster to use.

##### How to use

1. Add a BehaviorGroup to the extra scene tree of the target node by dragging and dropping it from the Behaviors in the Toolbox panel. 
    - A Fusion Group node will also be added on the target node's Fusion diagram (connected to the top node).
2. After selecting the behavior to be added, copy and paste it into the BehaviorGroup. 
    - It will be added in the same way on the Fusion diagram.

##### Renaming

After selecting the target BehaviorGroup in the extrascene tree, rename it in one of the following ways

- Select \[ Rename \] from the context menu.
- Change \[ General &gt; Name \] in the properties panel.

##### Copy

After selecting the target BehaviorGroup in the extrascene tree, select \[ Copy \] from the context menu and execute \[ Paste \] at the any location.