Declaration; Available Versions - Freescale Semiconductor DSP56800E User Manual

The MLIB_DivSat functions return the fractional division of the numerator and
denominator. The function saturates the output. See the following equation:

2.10.1 Available versions

This function is available in the following versions:
• Fractional output - the output is the fractional portion of the result; the result is
within the range <-1 ; 1). The result may saturate.
• Accumulator output - the output is the accumulator type, where the result may be out
of the range <-1 ; 1).
The available versions of the
Function name
MLIB_DivSat_F16 frac16_t
MLIB_DivSat_F16ls frac32_t
MLIB_DivSat_F16ll frac32_t
MLIB_DivSat_F32ls frac32_t
MLIB_DivSat_F32 frac32_t
MLIB_DivSat_A32as acc32_t

2.10.2 Declaration

The available MLIB_DivSat
Freescale Semiconductor, Inc.
Equation 8. Algorithm formula
MLIB_DivSat
Table 2-10. Function versions
Input type Result
type
Num. Denom.
frac16_t frac16_t
frac16_t frac16_t
frac32_t frac16_t
frac16_t frac32_t
frac32_t frac32_t
frac16_t acc32_t
functions have the following declarations:
MLIB User's Guide, Rev. 2, 10/2015
function are shown in the following table:
Description
Division of a 16-bit fractional numerator and denominator. The
output is within the range <-1 ; 1).
Division of a 32-bit fractional numerator by a 16-bit fractional
denominator; the output is a 16-bit fractional result. The output
is within the range <-1 ; 1).
Division of a 32-bit fractional numerator and denominator; the
output is a 16-bit fractional result. The output is within the range
<-1 ; 1).
Division of a 32-bit fractional numerator by a 16-bit fractional
denominator; the output is a 32-bit fractional result. The output
is within the range <-1 ; 1).
Division of a 32-bit fractional numerator and denominator. The
output is within the range <-1 ; 1).
Division of a 32-bit accumulator numerator by a 16-bit fractional
denominator; the output is a 32-bit accumulator result. The
output may be out of the range <-1 ; 1).
Chapter 2 Algorithms in detail
35