List of Defines

Aura can be configured by a set of defines that enable or disable certain blocks of code at compile-time. You can set the defines in your project's khafile.js:

// Set a valueless define:
project.addDefine("AURA_DEBUG");

// Set a define with a value:
project.addDefine("AURA_ASSERT_LEVEL=Error");

List of Defines

The following list contains all defines that are meant to be set by the user.

There exist more defines that are automatically set during compilation that are listed in other places:

• Backend specific defines
• Profiling

---

• AURA_ASSERT_LEVEL: The minimum level for assertions to include in the build output, assertions below this level are completely ignored and are not included in the build output.

  • Values:
    • Debug
    • Warning
    • Error
    • Critical (default)
    • NoAssertions
  • Targets: all

• AURA_ASSERT_QUIT: Whether to quit the running application in case of assertion failures.

  • Values: valueless
  • Targets: all

• AURA_BENCHMARK: Enables benchmarking functionality that will measure the times of the audio callback (e.g. for calculating average values). See Time.hx. Use this feature with Time.startBenchmark().

  • Values: valueless
  • Targets: all

• AURA_DEBUG: Enables debug functionality. See Debug.hx.

  • Values: valueless
  • Targets: all

• AURA_WITH_IRON: Enable support for Iron's vector types. This requires Iron to be available for the project. If you use Armory, there is no need to set this flag as Armory is automatically recognized by its armory flag.

  • Values: valueless
  • Targets: all