DoubleUtil
Provides utility methods for floating-point number comparisons and operations with epsilon tolerance.
Definition
Namespace:Telerik.WinControls
Assembly:Telerik.WinControls.dll
Syntax:
public static class DoubleUtilInheritance: objectDoubleUtil
Methods
Determines whether two float values are close enough to be considered equal within epsilon tolerance.
public static bool AreClose(float value1, float value2)The first float value to compare.
value2floatThe second float value to compare.
Returns:true if the values are close enough to be considered equal; otherwise, false.
This method accounts for floating-point precision errors by using an epsilon tolerance value that adjusts based on the magnitude of the numbers being compared.
Determines whether two PointF structures are close enough to be considered equal within epsilon tolerance.
Determines whether two RectangleF structures are close enough to be considered equal within epsilon tolerance.
public static bool AreClose(RectangleF rect1, RectangleF rect2)The first RectangleF to compare.
rect2RectangleFThe second RectangleF to compare.
Returns:true if all rectangle properties (X, Y, Width, Height) are close enough to be considered equal; otherwise, false.
Empty rectangles are compared for exact emptiness rather than using epsilon tolerance.
Determines whether two SizeF structures are close enough to be considered equal within epsilon tolerance.
public static bool AreClose(SizeF size1, SizeF size2)The first SizeF to compare.
size2SizeFThe second SizeF to compare.
Returns:true if both Width and Height values are close enough to be considered equal; otherwise, false.
This method compares both the Width and Height properties of the size structures using epsilon tolerance to account for floating-point precision errors.
Converts a float value to an integer using proper rounding.
public static int DoubleToInt(float val)The float value to convert.
Returns:The rounded integer value.
This method performs proper rounding by adding or subtracting 0.5 based on the sign of the value before truncating to integer. This ensures consistent rounding behavior compared to simple casting.
For positive values, 0.5 is added before truncation. For negative values, 0.5 is subtracted. This provides symmetrical rounding around zero.
Determines whether the first value is greater than the second value with epsilon tolerance.
public static bool GreaterThan(float value1, float value2)The first value to compare.
value2floatThe second value to compare.
Returns:true if value1 is greater than value2 and they are not close enough to be equal; otherwise, false.
This method returns true only if value1 is definitively greater than value2, taking into account
floating-point precision. Values that are close enough to be considered equal will return false.
Determines whether the first value is greater than or approximately equal to the second value.
public static bool GreaterThanOrClose(float value1, float value2)The first value to compare.
value2floatThe second value to compare.
Returns:true if value1 is greater than value2 or they are close enough to be considered equal; otherwise, false.
This method returns true if value1 is either definitively greater than value2 or if they are
close enough to be considered equal within epsilon tolerance.
Determines whether a value is between 0 and 1 (inclusive) using epsilon tolerance.
public static bool IsBetweenZeroAndOne(float val)The value to check.
Returns:true if the value is greater than or equal to 0 and less than or equal to 1 (within epsilon tolerance); otherwise, false.
This method is commonly used for validating normalized values, percentages, and alpha values that should be constrained to the 0-1 range.
Determines whether a float value is approximately equal to 1.0 within epsilon tolerance.
public static bool IsOne(float value)The value to check.
Returns:true if the value is close enough to 1.0 to be considered equal; otherwise, false.
This method uses a tighter epsilon tolerance (10 times the base epsilon) to determine if a value represents unity, accounting for floating-point precision errors.
Determines whether a float value is approximately equal to 0.0 within epsilon tolerance.
public static bool IsZero(float value)The value to check.
Returns:true if the value is close enough to 0.0 to be considered equal; otherwise, false.
This method uses a tighter epsilon tolerance (10 times the base epsilon) to determine if a value represents zero, accounting for floating-point precision errors.