Info

• When you need to set an object or a view to a certain configuration
• State is defined as a collection of state presets - AStateValuePreset
• State preset can be anything you want
  • Image sprite
  • Canvas alpha
  • Transform position
  • GameObject enabled state
  • You can change any property or state on a component or game object

Toggle States

• When you only need two states, usually On/Off, Enabled/Disabled, Visible/Hidden

• A state is defined by a bool

• All types inherit from AToggleState

  • Use SetState(bool state, bool immediate = false) to set the state
    • immediate usually does nothing if the state toggle is instant, but there may be animated implementations

• ToggleState

  • Can specify all kinds of state presets
  • Can be visually complex
  • Can be converted to ToggleStateObjects in the context menu / Convert to Objects

  

• ToggleStateObjects

  • Only toggles GameObjects enabled or disabled
  • Limited but compact, and can usually be all you need
  • Can be converted to ToggleState in the context menu / Convert to Presets

  

Multi States

• When the number of your states can be more than 2, eg, Unloaded/Loading/Loaded or A/B/C/D

• A state is defined by a string

• All types inherit from AMultiState

  • Use bool SetState(string state, bool immediate = false) to set the state
    • immediate usually does nothing if the state toggle is instant, but there may be animated implementations
    • Return if the state was set, false if the state was not found

• MultiState

  • Can specify all kinds of state presets
  • Can be visually complex
  • Can be converted to MultiStateObject in the context menu / Convert to Objects

  

• MultiStateObject

  • Only toggles GameObjects enabled or disabled
  • Limited but compact, and can usually be all you need
  • Can be converted to MultiState in the context menu / Convert to Presets