User Tools

Site Tools


en:orx:config:settings_structure:orxfx

orxFX structure

Summary

FX

[FXTemplate]
SlotList    = FXSlotTemplate1#FXSlotTemplate2#...
Stagger     = <bool> # <float>
KeepInCache = <bool>
DoNotCache  = <bool>
Loop        = <bool>

FXSlot

[FXSlotTemplate]
Type          = alpha | color | rgb | hsl | hsv | scale | rotation | position | speed | volume | pitch
Curve         = linear | smooth | smoother | triangle | square | sine
StartTime     = <float>
EndTime       = <float>
StartValue    = <float> | <vector>
EndValue      = <float> | <vector>
Phase         = <float>
Period        = <float>
Absolute      = <bool>
Stagger       = <bool>
Acceleration  = <float>
Amplification = <float>
Pow           = <float>
UseRotation   = <bool>
UseScale      = <bool>

Details

FX

Here's a list of the available properties for an orxFX structure:

  • SlotList: List of all the slots that will be used by that FX. Each slot will affect one attribute of the object one which the FX is applied. Up to 8 slots can be defined for a single FX. This property needs to be defined.
  • Stagger: If the first value is true, this FX will be added after all already existing FXs. Defaults to false. The second value, optional, is an additional time offset, in seconds, when the FX will start, staggered or not. Defaults to 0.0f.
  • KeepInCache: Specifies if the FX data should be kept in memory even when no FX of this type is used. This gives better performances but costs memory. Its default value is false.
  • DoNotCache: If true, the FX won't get cached and will be recreated from config every time, which allows random values & variations but is more expensive. Defaults to false.
  • Loop: Specifies if the FX should be applied in loop. Its default value is false.

FXSlot

Here's a list of the available properties for FX slots:

  • Type: Defines which object attribute will be modified by this slot. It can be one of the following: position, rotation, scale, speed, color, alpha, volume or pitch. This property needs to be defined.
  • Curve: Defines which type of curve is used by this slot. It can be one of the following: linear (aka sawtooth when cycling), smooth & smoother (aka smoothstep), triangle, square or sine. This property needs to be defined.
  • StartTime/EndTime: Defines the start and end times of this slot, relatively to its orxFX parent. If both StartTime and EndTime have the same value, this slot be be instantly applied at this precise time, in a single frame. If no values are defined, 0.0 will be used.
  • StartValue/EndValue: Defines the start and end values of the curve for this slot. Depending on the Type of the slot, it can be a float and/or a vector.1) If no values are specified, 0.0/(0.0, 0.0, 0.0) will be used.
  • Phase: Defines the phase of the cyclic curve at the beginning of the slot. Its value can range from 0.0 (start of the defined curve) to 1.0 (end of the defined curve). By default its value is 0.0.
  • Period: Defines the length (period) of the cyclic curve (ie. 1/frequency), in seconds. By default the period will be EndTime - StartTime so as to span on the whole slot duration.
  • Absolute: Should the slot apply absolute value to the object's attribute instead of relative ones? If an absolute slot is defined for a orxFX, it will override any other relative slot of the same orxFX of the same Type. By default, its value is false.
  • Stagger: If true, this slot will be added after all already existing slots. Defaults to false.
  • Acceleration: Defines the 'acceleration' of the curve over time (ie. the evolution of its frequency). A value < 1.0 means the frequency will decrease whereas a value > 1.0 means the frequency will increase. By default its value is 1.0, which means its frequency won't change.
  • Amplification: Defines the evolution of the amplitude of the curve over time. A value < 1.0 means the amplitude will decrease whereas a value > 1.0 means the amplitude will increase. By default its value is 1.0, which means its amplitude won't change.
  • Pow: Exponent applies to the curve. By default its value is 1.0 which means the curve is a 'regular' one.
  • UseRotation: This property is only used for slots of Type = position or speed, it will be ignored otherwise. If set to true, the slot will use object's current rotation to compute resulting values. By default its value is false.
  • UseScale: This property is only used for slots of Type = position or speed, it'll be ignored otherwise. If set to true, the slot will use object's current scale to compute resulting values. By default its value is false.

Latest config settings for the Development Version

We endeavor to keep the config properties on this page up to date as often as possible. For up to the minute config information for the latest version of Orx, check the most recent published at:

CreationTemplate.ini and

SettingsTemplate.ini

Additionally these files can be found under your orx source tree in the orx/code/bin folder.

1)
Vectors are used for position, speed, color and anisotropic scale
en/orx/config/settings_structure/orxfx.txt · Last modified: 2021/08/09 05:50 (3 years ago) by sausage