using System; using System.Runtime.CompilerServices; // Make internals visible for BurstGlobalCompilerOptions [assembly: InternalsVisibleTo("Unity.Burst.CodeGen")] [assembly: InternalsVisibleTo("Unity.Burst.Editor")] // Make internals visible to Unity burst tests [assembly: InternalsVisibleTo("Unity.Burst.Tests.UnitTests")] [assembly: InternalsVisibleTo("Unity.Burst.Editor.Tests")] [assembly: InternalsVisibleTo("Unity.Burst.Benchmarks")] namespace Unity.Burst { /// /// How the code should be optimized. /// public enum OptimizeFor { /// /// The default optimization mode - uses . /// Default = 0, /// /// Optimize for performance - the compiler should make the most optimal binary possible. /// Performance = 1, /// /// Optimize for size - the compiler should make the smallest binary possible. /// Size = 2, /// /// Optimize for fast compilation - the compiler should perform some optimization, but take as little time as possible to do it. /// FastCompilation = 3, /// /// Optimize for balanced compilation - ensuring that good performance is obtained while keeping compile time as low as possible. /// Balanced = 4, } #if !BURST_COMPILER_SHARED // FloatMode and FloatPrecision must be kept in sync with burst.h / Burst.Backend /// /// Represents the floating point optimization mode for compilation. /// public enum FloatMode { /// /// Use the default target floating point mode - . /// Default = 0, /// /// No floating point optimizations are performed. /// Strict = 1, /// /// Reserved for future. /// Deterministic = 2, /// /// Allows algebraically equivalent optimizations (which can alter the results of calculations), it implies : /// optimizations can assume results and arguments contain no NaNs or +/- Infinity and treat sign of zero as insignificant. /// optimizations can use reciprocals - 1/x * y , instead of y/x. /// optimizations can use fused instructions, e.g. madd. /// Fast = 3, } /// /// Represents the floating point precision used for certain builtin operations e.g. sin/cos. /// public enum FloatPrecision { /// /// Use the default target floating point precision - . /// Standard = 0, /// /// Compute with an accuracy of 1 ULP - highly accurate, but increased runtime as a result, should not be required for most purposes. /// High = 1, /// /// Compute with an accuracy of 3.5 ULP - considered acceptable accuracy for most tasks. /// Medium = 2, /// /// Compute with an accuracy lower than or equal to , with some range restrictions (defined per function). /// Low = 3, } /// /// This attribute is used to tag jobs or function-pointers as being Burst compiled, and optionally set compilation parameters. /// [AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Method | AttributeTargets.Assembly)] public class BurstCompileAttribute : System.Attribute { /// /// Gets or sets the float mode of operation for this Burst compilation. /// /// /// The default is . /// public FloatMode FloatMode { get; set; } /// /// Gets or sets the floating point precision to use for this Burst compilation. /// Allows you to trade accuracy for speed of computation, useful when you don't require much precision. /// /// /// The default is . /// public FloatPrecision FloatPrecision { get; set; } internal bool? _compileSynchronously; /// /// Gets or sets whether or not to Burst compile the code immediately on first use, or in the background over time. /// /// The default is false, true will force this code to be compiled synchronously on first invocation. public bool CompileSynchronously { get => _compileSynchronously.HasValue ? _compileSynchronously.Value : false; set => _compileSynchronously = value; } internal bool? _debug; /// /// Gets or sets whether to compile the code in a way that allows it to be debugged. /// If this is set to true, the current implementation disables optimisations on this method /// allowing it to be debugged using a Native debugger. /// /// /// The default is false. /// public bool Debug { get => _debug.HasValue ? _debug.Value : false; set => _debug = value; } internal bool? _disableSafetyChecks; /// /// Gets or sets whether to disable safety checks for the current job or function pointer. /// If this is set to true, the current job or function pointer will be compiled /// with safety checks disabled unless the global 'Safety Checks/Force On' option is active. /// /// /// The default is false. /// public bool DisableSafetyChecks { get => _disableSafetyChecks.HasValue ? _disableSafetyChecks.Value : false; set => _disableSafetyChecks = value; } internal bool? _disableDirectCall; /// /// Gets or sets a boolean to disable the translation of a static method call as direct call to /// the generated native method. By default, when compiling static methods with Burst and calling /// them from C#, they will be translated to a direct call to the Burst generated method. /// code. /// /// /// The default is false. /// public bool DisableDirectCall { get => _disableDirectCall.HasValue ? _disableDirectCall.Value : false; set => _disableDirectCall = value; } /// /// How should this entry-point be optimized. /// /// /// The default is . /// public OptimizeFor OptimizeFor { get; set; } internal string[] Options { get; set; } /// /// Tags a struct/method/class as being Burst compiled, with the default , and . /// /// /// /// [BurstCompile] /// struct MyMethodsAreCompiledByBurstUsingTheDefaultSettings /// { /// //.... /// } /// /// public BurstCompileAttribute() { } /// /// Tags a struct/method/class as being Burst compiled, with the specified and . /// /// /// /// [BurstCompile(FloatPrecision.Low, FloatMode.Fast)] /// struct MyMethodsAreCompiledByBurstWithLowPrecisionAndFastFloatingPointMode /// { /// //.... /// } /// /// /// Specify the required floating point precision. /// Specify the required floating point mode. public BurstCompileAttribute(FloatPrecision floatPrecision, FloatMode floatMode) { FloatMode = floatMode; FloatPrecision = floatPrecision; } internal BurstCompileAttribute(string[] options) { Options = options; } } #endif }