utilUint64ScaleRound

Scale val by the rational number num / denom, avoiding overflows and underflows and without loss of precision.

This function can potentially be very slow if val and num are both greater than G_MAXUINT32.

ulong
utilUint64ScaleRound
(
ulong val
,
ulong num
,
ulong denom
)

Parameters

val ulong

the number to scale

num ulong

the numerator of the scale ratio

denom ulong

the denominator of the scale ratio

Return Value

Type: ulong

val * num / denom. In the case of an overflow, this function returns G_MAXUINT64. If the result is not exactly representable as an integer, it is rounded to the nearest integer (half-way cases are rounded up). See also gst.global.utilUint64Scale, gst.global.utilUint64ScaleCeil, gst.global.utilUint64ScaleInt, gst.global.utilUint64ScaleIntRound, gst.global.utilUint64ScaleIntCeil.