ClassDoubleUtil
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
AreClose(PointF, PointF)
Determines whether two PointF structures are close enough to be considered equal within epsilon tolerance.
AreClose(RectangleF, RectangleF)
Determines whether two RectangleF structures are close enough to be considered equal within epsilon tolerance.
Declaration
public static bool AreClose(RectangleF rect1, RectangleF rect2)Parameters
rect1
The first RectangleF to compare.
rect2
The second RectangleF to compare.
Returns
true if all rectangle properties (X, Y, Width, Height) are close enough to be considered equal; otherwise, false.
Remarks
Empty rectangles are compared for exact emptiness rather than using epsilon tolerance.
AreClose(SizeF, SizeF)
Determines whether two SizeF structures are close enough to be considered equal within epsilon tolerance.
Declaration
public static bool AreClose(SizeF size1, SizeF size2)Parameters
size1
The first SizeF to compare.
size2
The second SizeF to compare.
Returns
true if both Width and Height values are close enough to be considered equal; otherwise, false.
Remarks
This method compares both the Width and Height properties of the size structures using epsilon tolerance to account for floating-point precision errors.
AreClose(float, float)
Determines whether two float values are close enough to be considered equal within epsilon tolerance.
Declaration
public static bool AreClose(float value1, float value2)Parameters
value1
The first float value to compare.
value2
The second float value to compare.
Returns
true if the values are close enough to be considered equal; otherwise, false.
Remarks
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.
DoubleToInt(float)
Converts a float value to an integer using proper rounding.
Declaration
public static int DoubleToInt(float val)Parameters
val
The float value to convert.
Returns
The rounded integer value.
Remarks
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.
GreaterThan(float, float)
Determines whether the first value is greater than the second value with epsilon tolerance.
Declaration
public static bool GreaterThan(float value1, float value2)Parameters
value1
The first value to compare.
value2
The second value to compare.
Returns
true if value1 is greater than value2 and they are not close enough to be equal; otherwise, false.
Remarks
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.
GreaterThanOrClose(float, float)
Determines whether the first value is greater than or approximately equal to the second value.
Declaration
public static bool GreaterThanOrClose(float value1, float value2)Parameters
value1
The first value to compare.
value2
The second value to compare.
Returns
true if value1 is greater than value2 or they are close enough to be considered equal; otherwise, false.
Remarks
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.
IsBetweenZeroAndOne(float)
Determines whether a value is between 0 and 1 (inclusive) using epsilon tolerance.
Declaration
public static bool IsBetweenZeroAndOne(float val)Parameters
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.
Remarks
This method is commonly used for validating normalized values, percentages, and alpha values that should be constrained to the 0-1 range.
IsOne(float)
Determines whether a float value is approximately equal to 1.0 within epsilon tolerance.
Declaration
public static bool IsOne(float value)Parameters
value
The value to check.
Returns
true if the value is close enough to 1.0 to be considered equal; otherwise, false.
Remarks
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.
IsZero(float)
Determines whether a float value is approximately equal to 0.0 within epsilon tolerance.
Declaration
public static bool IsZero(float value)Parameters
value
The value to check.
Returns
true if the value is close enough to 0.0 to be considered equal; otherwise, false.
Remarks
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.