Class NumericExtensions

Namespace

Plugin.BaseTypeExtensions

Assembly

Plugin.BaseTypeExtensions.dll

Provides extension methods for generic numeric operations, including angle conversions, clamping, and percentage calculations.

public static class NumericExtensions

Inheritance

object

NumericExtensions

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Methods

Clamp<T>(T, T, T)

Clamps a numeric value between a minimum and maximum value for any numeric type.

public static T Clamp<T>(this T value, T min, T max) where T : INumber<T>

Parameters

value T

The value to clamp

min T

The minimum allowed value

max T

The maximum allowed value

Returns

T

The clamped value

Type Parameters

T

Any numeric type that implements INumber<T>

DegreeToRadian<T>(T)

Converts an angle from degrees to radians for any numeric type.

public static T DegreeToRadian<T>(this T angleInDegrees) where T : INumber<T>

Parameters

angleInDegrees T

The angle in degrees

Returns

T

The angle in radians

Type Parameters

T

Any numeric type that implements INumber<T>

GetInvertedSafe<T>(T, bool, T)

Returns the value as-is or inverted based on the isInverted flag for any numeric type. When inverted, returns maxValue - value. When not inverted, returns the original value.

public static T GetInvertedSafe<T>(this T value, bool isInverted, T maxValue) where T : INumber<T>

Parameters

value T

The value to potentially invert

isInverted bool

Whether to apply inversion

maxValue T

The maximum value used for inversion calculation

Returns

T

The original value if not inverted, or maxValue - value if inverted

Type Parameters

T

Any numeric type that implements INumber<T>

PercentageToByte<T>(T)

Converts a percentage (0.0 to 1.0) to a byte value (0-255) for any numeric type.

public static byte PercentageToByte<T>(this T percentage) where T : INumber<T>

Parameters

percentage T

The percentage value (0.0 to 1.0)

Returns

byte

A byte value in the range 0-255

Type Parameters

T

Any numeric type that implements INumber<T>

PercentageToValue<T>(T, T, T)

Converts a percentage (0.0 to 1.0) to a value within the specified range for any numeric type.

public static T PercentageToValue<T>(this T percentage, T minBound, T maxBound) where T : INumber<T>

Parameters

percentage T

The percentage value (0.0 to 1.0)

minBound T

The minimum bound of the target range

maxBound T

The maximum bound of the target range

Returns

T

The calculated value within the specified range

Type Parameters

T

Any numeric type that implements INumber<T>

Exceptions

ArgumentOutOfRangeException

Thrown when minBound is greater than maxBound

RadianToDegree<T>(T)

Converts an angle from radians to degrees for any numeric type.

public static T RadianToDegree<T>(this T angleInRadians) where T : INumber<T>

Parameters

angleInRadians T

The angle in radians

Returns

T

The angle in degrees

Type Parameters

T

Any numeric type that implements INumber<T>

ToByte<T>(T)

Converts a numeric value to a byte, clamping to valid byte range (0-255) for any numeric type.

public static byte ToByte<T>(this T input) where T : INumber<T>

Parameters

input T

The numeric value to convert

Returns

byte

A byte value clamped to the range 0-255

Type Parameters

T

Any numeric type that implements INumber<T>

ValueToPercentage<T>(T, T, T)

Converts a value within a range to a percentage (0.0 to 1.0) for any numeric type.

public static T ValueToPercentage<T>(this T value, T minBound, T maxBound) where T : INumber<T>

Parameters

value T

The value to convert

minBound T

The minimum bound of the source range

maxBound T

The maximum bound of the source range

Returns

T

The percentage representation (0.0 to 1.0)

Type Parameters

T

Any numeric type that implements INumber<T>

Exceptions

ArgumentOutOfRangeException

Thrown when minBound is greater than maxBound