*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> dmedia/dmGSMEncode (3d)              
Title
Content
Arch
Section
 

Contents


dmGSMEncode(3dm)					      dmGSMEncode(3dm)


NAME    [Toc]    [Back]

     dmGSMEncode - implements the European GSM 06.10 provisional standard for
     full-rate speech transcoding, prI-ETS 300 036, which uses RPE/LTP
     (regular pulse excitation/long term prediction) coding at 13 kbit/s.

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/dm_audioutil.h>

     DMstatus dmGSMEncode(DMGSMencoder handle,
		       short *ibuf, unsigned char *obuf, int numSamples)

PARAMETER    [Toc]    [Back]

     handle    DMGSMencoder structure, created by dmGSMEncoderCreate(3dm),
	       specifies the signal processing parameters.


     ibuf      pointer to input	sample data buffer, an array of	size of	a
	       multiple	of 160.	 The data format is short (16-bit).  The
	       samples are assumed to be two's complement.   The sampling rate
	       must be 8 kHz.


     obuf      pointer to output data buffer, an array of a multiple of	33
	       bytes.  The data	format is unsigned char	(8-bit).


     numSamples
	       number of sample	in the input buffer to be processed.  the
	       value of	numSamples passed to the GSM decode/decode routines
	       must always be a	multiple of 160.  The compressed bitstrem
	       buffer consists of a multiple of	33 bytes.

RETURNED VALUE    [Toc]    [Back]

     Returns DM_FAILURE	or DM_SUCCESS.

DESCRIPTION    [Toc]    [Back]

     dmGSMEncode(3dm) implements GSM 06.10 compression.


     GSM compression uses a linear prediction scheme.  This means that the
     compressed	bits, which carrying compressed	information, are interrelated
     or	interdependent.	 If a application calls	afSeekFrame(3dm) to an offset
     into the compressed bit stream file and then starts reading bits in the
     middle of the bit stream and decompress them with dmGSMDecode(3dm), the
     interdependency of	the bits at the	cutting	point is lost.	The
     application will initially	get back data with a lower amplitude than if
     he	had read the same data back during a complete pass over	the file from
     the beginning.



									Page 1






dmGSMEncode(3dm)					      dmGSMEncode(3dm)



     There is no way to	exactly	recreate the decoded data in the middle	of the
     bit stream	file without going all the way back to the beginning.
     However, with a "preroll" value to	read ahead a portion of	the compressed
     file, application can compensate for the amplitude	problem.

NOTE    [Toc]    [Back]

     The compressed bitrate now	is 13200 bits/s.  This is not the same as
     standard specification of 13000 bits/s because the	first 4	bits of	each
     33	byte are not useful information	bits.  This bits arrangement was
     adopted using the original	scheme by Jutta	Degener	([email protected]-
     berlin.de)	and Carsten Bormann ([email protected]), Communications and
     Operating Systems Research	Group, TU Berlin for compatibility with
     typical UNIX applications.	 And may be modify later.

     GSM algorithm was developed for sampling rate of 8	kHz.

SEE ALSO    [Toc]    [Back]

      
      
     dmGSMEncoderCreate(3dm), dmGSMEncoderDestroy(3dm),	dmGSMDecode(3dm), ETSI
     GSM 06.10 standard.


									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
dmFS1016Decode IRIX implements the US Federal Standard 1016 4800/7200/9600 bits/s CELP (Code Excited Linear Predictive) Voice Code
dmFS1016Encode IRIX implements the US Federal Standard 1016 4800/7200/9600 bits/s CELP (Code Excited Linear Predictive) Voice Code
window Tru64 Implements a window environment
dmDVAudioEncode IRIX implements DV and DVCPRO audio encode
dmDVAudioDecode IRIX implements DV and DVCPRO audio decompression
iflDictionary IRIX implements a dictionary of named elements
dmG726Encode IRIX implements ITU (International Telecommunication Union)
dmG728Decode IRIX implements the ITU (International Telecommunication Union)
dmG728Encode IRIX implements the ITU (International Telecommunication Union)
tee Linux read from standard input and write to standard output and files
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service