gsm_print.3 1.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
  1. .\"
  2. .\" Copyright 1992 by Jutta Degener and Carsten Bormann, Technische
  3. .\" Universitaet Berlin. See the accompanying file "COPYRIGHT" for
  4. .\" details. THERE IS ABSOLUTELY NO WARRANTY FOR THIS SOFTWARE.
  5. .\"
  6. .PU
  7. .TH GSM_PRINT 3
  8. .SH NAME
  9. gsm_print \(em GSM\ 06.10 supplementary function for debugging
  10. .SH SYNOPSIS
  11. #include "gsm.h"
  12. #include <stdio.h>
  13. int gsm_print(f, g, frame);
  14. .br
  15. FILE * f;
  16. .br
  17. gsm g;
  18. .br
  19. gsm_frame frame;
  20. .SH "DESCRIPTION"
  21. Gsm is an implementation of the final draft GSM 06.10
  22. standard for full-rate speech transcoding, a lossy
  23. speech compression algorithm.
  24. The compressed form involves 76 variables with different numbers
  25. of significant bits packed into 33 bytes.
  26. .PP
  27. If you are interested in investigating the details of this
  28. coding scheme, gsm_print() can be used to dump the contents
  29. of individual gsm_frames to a file pointer provided by
  30. the application.
  31. .PP
  32. .SH "RETURN VALUE"
  33. gsm_print() returns -1 if the frame is invalid, else 0.
  34. .SH EXAMPLE
  35. A single frame looks like this:
  36. .br
  37. .nf
  38. LARc: 29 32 20 11 08 05 06 07
  39. #1: Nc 0040 bc 0 Mc 1 xmaxc 60
  40. 06 04 00 03 03 06 04 02 02 04 05 04 01
  41. #2: Nc 0045 bc 1 Mc 1 xmaxc 48
  42. 03 07 01 03 04 04 07 01 03 02 04 05 03
  43. #3: Nc 0091 bc 1 Mc 1 xmaxc 46
  44. 00 03 03 07 01 06 02 04 05 03 03 02 04
  45. #4: Nc 0120 bc 0 Mc 1 xmaxc 47
  46. 07 03 06 00 03 03 06 05 00 03 02 07 04
  47. .nf
  48. .SH BUGS
  49. Please direct bug reports to jutta@cs.tu-berlin.de and cabo@cs.tu-berlin.de.
  50. .SH "SEE ALSO"
  51. gsm(3), gsm_explode(3)