mlib_SignalUpSample_S16_S1mediaLib Library Fmlib_SignalUpSample_S16_S16(3MLIB)NAME
mlib_SignalUpSample_S16_S16, mlib_SignalUpSample_S16S_S16S, mlib_Sig‐
nalUpSample_F32_F32, mlib_SignalUpSample_F32S_F32S - signal upsampling
SYNOPSIS
cc [ flag... ] file... -lmlib [ library... ]
#include <mlib.h>
mlib_status mlib_SignalUpSample_S16_S16(mlib_s16 *dst,
const mlib_s16 *src, mlib_s32 factor, mlib_s32 phase,
mlib_s32 n);
mlib_status mlib_SignalUpSample_S16S_S16S(mlib_s16 *dst,
const mlib_s16 *src, mlib_s32 factor, mlib_s32 phase,
mlib_s32 n);
mlib_status mlib_SignalUpSample_F32_F32(mlib_f32 *dst,
const mlib_f32 *src, mlib_s32 factor, mlib_s32 phase,
mlib_s32 n);
mlib_status mlib_SignalUpSample_F32S_F32S(mlib_f32 *dst,
const mlib_f32 *src, mlib_s32 factor, mlib_s32 phase,
mlib_s32 n);
DESCRIPTION
Each of these functions performs upsampling.
For monaural signals, the following equation is used:
dst[i] = src[k] if i == k*factor + phase
dst[i] = 0 if i != k*factor + phase
where k = 0, 1, ..., (n - 1); i = 0, 1, ..., (n*factor - 1).
For stereo signals, the following equation is used:
dst[2*i] = src[2*k] if i == k*factor + phase
dst[2*i] = 0 if i != k*factor + phase
dst[2*i + 1] = src[2*k + 1] if i == k*factor + phase
dst[2*i + 1] = 0 if i != k*factor + phase
where k = 0, 1, ..., (n - 1); i = 0, 1, ..., (n*factor - 1).
PARAMETERS
Each of the functions takes the following arguments:
dst Output signal array.
src Input signal array.
factor Factor by which to upsample. factor ≥ 1.
phase Parameter that determines relative position of an input
value, within the output signal. 0 ≤ phase < factor.
n Number of samples in the input signal array.
RETURN VALUES
Each of the functions returns MLIB_SUCCESS if successful. Otherwise it
returns MLIB_FAILURE.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOmlib_SignalDownSample_S16_S16(3MLIB), attributes(5)SunOS 5.10 2 Mar 2007mlib_SignalUpSample_S16_S16(3MLIB)