GSM_OPTION

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

gsm_option() --- customizing the GSM 06.10 implementation  

SYNOPSIS

#include "gsm.h"

int gsm_option(handle, option, valueP);
gsm handle;
int option;
int * valueP;  

DESCRIPTION

Gsm is an implementation of the final draft GSM 06.10 standard for full-rate speech transcoding, a lossy speech compression algorithm.

The gsm_option() function can be used to set and query various options or flags that are not needed for regular GSM 06.10 encoding or decoding, but might be of interest in special cases.

The second argument to gsm_option says what option should be changed. The third argument is either a null pointer, in which case the option is not changed, just returned; or it is a pointer to an integer containing the value you want to set, in which case the previous value will be returned.

The following options are currently defined:

GSM_OPT_VERBOSE Change or query the GSM 06.10 implementation's verbosity level.
This option is only supported if the library was compiled with debugging turned on, and may be used by developers of compression algorithms to aid debugging.
The verbosity level can be changed at any time during encoding or decoding.

GSM_OPT_FAST Enable, disable or query a faster compression algorithm.
This implementation offers a not strictly standard-compliant, but faster compression algorithm that is compatible with the regular method.
The value passed to

        gsm_option(handle, GSM_OPT_FAST, & value)

functions as a boolean flag; if it is zero, the regular algorithm will be used, if not, the faster version will be used.
The availability of this option depends on the hardware used; if it is not available, gsm_option will return -1 on an attempt to set or query it.
This option can be changed any time during encoding or decoding.
 

RETURN VALUE

gsm_option() returns -1 if an option is not supported, the previous value of the option otherwise.  

BUGS

Please direct bug reports to toast@tub.cs.tu-berlin.de.  

SEE ALSO

toast(1), gsm(3), gsm_explode(3), gsm_print(3)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
BUGS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 12:37:50 GMT, July 10, 2022