Eric Lengyel: Created page with "NOTOC The '''Oscillation Controller''' is a type of controller that causes a node to oscillate between two positions on a sine wave. The Oscillation Controller is built into the core engine, and it is one of four ''kinematic'' controllers that cause an object to follow an exact motion. Rigid bodies controlled by the Physics Manager are able to interact with kinematic objects, but they cannot stop kinematic objects or alter their motions. A kinematic object pushes rig..."

2023-07-15T10:42:25Z

Created page with "__NOTOC__ The '''Oscillation Controller''' is a type of controller that causes a node to oscillate between two positions on a sine wave. The Oscillation Controller is built into the core engine, and it is one of four ''kinematic'' controllers that cause an object to follow an exact motion. Rigid bodies controlled by the Physics Manager are able to interact with kinematic objects, but they cannot stop kinematic objects or alter their motions. A kinematic object pushes rig..."

New page

__NOTOC__
The '''Oscillation Controller''' is a type of controller that causes a node to oscillate between two positions on a sine wave. The Oscillation Controller is built into the core engine, and it is one of four ''kinematic'' controllers that cause an object to follow an exact motion. Rigid bodies controlled by the Physics Manager are able to interact with kinematic objects, but they cannot stop kinematic objects or alter their motions. A kinematic object pushes rigid bodies out of its way no matter what.

== Settings ==

The following settings are available for Oscillation Controllers.

{| {{Table}}
{{Tablehead|Setting|Description}}
|-
{{HeadingSetting|'''Kinematic Controller Settings'''}}
|-
{{Setting|'''Wake intersecting rigid bodies'''|Specifies whether sleeping rigid bodies in the path of the kinematic object are detected and awakened. If this is disabled, then the kinematic object will pass straight through any sleeping rigid bodies that it comes in contact with. If this is enabled, then sleeping rigid bodies that intersect the bounding box of the kinematic object are automatically awakened so they can interact with the kinematic object. For best performance, this setting should be disabled if it's known that the kinematic object will not come in contact with sleeping rigid bodies.}}
|-
{{HeadingSetting|'''Oscillation Controller Settings'''}}
|-
{{Setting|'''Oscillation speed (cycles/s)'''|The speed at which the target node oscillates between two positions, measured in the number of complete cycles per second. The reciprocal of this number gives the period of one full oscillation in seconds.}}
|-
{{Setting|'''Start position connector key'''|The name of the connector attached to the target node that is connected to the start position for the oscillation.}}
|-
{{Setting|'''Finish position connector key'''|The name of the connector attached to the target node that is connected to the finish position for the oscillation.}}
|}

== Script Functions ==

The Oscillation Controller defines the following functions that can be called from a [[Script Editor | script]] using the '''Call Controller Function''' method.

{| {{Table}}
{{Tablehead|Widget|Description}}
|-
{{Tablerow|'''Get Oscillation Speed'''|Returns the oscillation speed and completes immediately.}}
|-
{{Tablerow|'''Set Oscillation Speed'''|Sets the oscillation speed and completes immediately.

* The '''Oscillation speed (cycles/s)''' setting specifies the new oscillation speed in cycles per second.
* The '''Acceleration time (s)''' setting specifies the length of time, in seconds, it takes to reach the new oscillation speed.}}
|}

== See Also ==

* [http://c4engine.com/docs/PhysicsMgr/OscillationController.html <code>OscillationController</code>] class
* [[Oscillation Tutorial]]
* [[Movement Controller]]
* [[Rotation Controller]]
* [[Spin Controller]]
* [[Physics]]

[[Category:Physics]]
[[Category:Controllers]]

Oscillation Controller - Revision history