Wed Oct 28 11:46:09 2009

Asterisk developer's documentation


frame.c File Reference

Frame and codec manipulation routines. More...

#include "asterisk.h"
#include "asterisk/_private.h"
#include "asterisk/lock.h"
#include "asterisk/frame.h"
#include "asterisk/channel.h"
#include "asterisk/cli.h"
#include "asterisk/term.h"
#include "asterisk/utils.h"
#include "asterisk/threadstorage.h"
#include "asterisk/linkedlists.h"
#include "asterisk/translate.h"
#include "asterisk/dsp.h"
#include "asterisk/file.h"

Include dependency graph for frame.c:

Go to the source code of this file.

Data Structures

struct  ast_codec_alias_table
struct  ast_frame_cache
struct  ast_frames
 This is just so ast_frames, a list head struct for holding a list of ast_frame structures, is defined. More...
struct  ast_smoother

Defines

#define FRAME_CACHE_MAX_SIZE   10
 Maximum ast_frame cache size.
#define SMOOTHER_SIZE   8000
#define TYPE_MASK   0x3

Enumerations

enum  frame_type { TYPE_HIGH, TYPE_LOW, TYPE_SILENCE, TYPE_DONTSEND }

Functions

int __ast_smoother_feed (struct ast_smoother *s, struct ast_frame *f, int swap)
static void __frame_free (struct ast_frame *fr, int cache)
static void __init_frame_cache (void)
 A per-thread cache of frame headers.
char * ast_codec2str (int codec)
 Get a name from a format Gets a name from a format.
int ast_codec_choose (struct ast_codec_pref *pref, int formats, int find_best)
 Pick a codec.
int ast_codec_get_len (int format, int samples)
 Returns the number of bytes for the number of samples of the given format.
int ast_codec_get_samples (struct ast_frame *f)
 Returns the number of samples contained in the frame.
int ast_codec_pref_append (struct ast_codec_pref *pref, int format)
 Append codec to list.
void ast_codec_pref_convert (struct ast_codec_pref *pref, char *buf, size_t size, int right)
 Shift an audio codec preference list up or down 65 bytes so that it becomes an ASCII string.
struct ast_format_list ast_codec_pref_getsize (struct ast_codec_pref *pref, int format)
 Get packet size for codec.
int ast_codec_pref_index (struct ast_codec_pref *pref, int index)
 Codec located at a particular place in the preference index.
void ast_codec_pref_prepend (struct ast_codec_pref *pref, int format, int only_if_existing)
 Prepend codec to list.
void ast_codec_pref_remove (struct ast_codec_pref *pref, int format)
 Remove codec from pref list.
int ast_codec_pref_setsize (struct ast_codec_pref *pref, int format, int framems)
 Set packet size for codec.
int ast_codec_pref_string (struct ast_codec_pref *pref, char *buf, size_t size)
 Dump audio codec preference list into a string.
static const char * ast_expand_codec_alias (const char *in)
int ast_frame_adjust_volume (struct ast_frame *f, int adjustment)
 Adjusts the volume of the audio samples contained in a frame.
void ast_frame_dump (const char *name, struct ast_frame *f, char *prefix)
void ast_frame_free (struct ast_frame *frame, int cache)
 Requests a frame to be allocated.
static struct ast_frameast_frame_header_new (void)
int ast_frame_slinear_sum (struct ast_frame *f1, struct ast_frame *f2)
 Sums two frames of audio samples.
struct ast_frameast_frdup (const struct ast_frame *f)
 Copies a frame.
struct ast_frameast_frisolate (struct ast_frame *fr)
 'isolates' a frame by duplicating non-malloc'ed components (header, src, data). On return all components are malloc'ed
struct ast_format_listast_get_format_list (size_t *size)
struct ast_format_listast_get_format_list_index (int index)
int ast_getformatbyname (const char *name)
 Gets a format from a name.
char * ast_getformatname (int format)
 Get the name of a format.
char * ast_getformatname_multiple (char *buf, size_t size, int format)
 Get the names of a set of formats.
int ast_parse_allow_disallow (struct ast_codec_pref *pref, int *mask, const char *list, int allowing)
 Parse an "allow" or "deny" line in a channel or device configuration and update the capabilities mask and pref if provided. Video codecs are not added to codec preference lists, since we can not transcode.
void ast_smoother_free (struct ast_smoother *s)
int ast_smoother_get_flags (struct ast_smoother *s)
struct ast_smootherast_smoother_new (int size)
struct ast_frameast_smoother_read (struct ast_smoother *s)
void ast_smoother_reconfigure (struct ast_smoother *s, int bytes)
 Reconfigure an existing smoother to output a different number of bytes per frame.
void ast_smoother_reset (struct ast_smoother *s, int bytes)
void ast_smoother_set_flags (struct ast_smoother *s, int flags)
int ast_smoother_test_flag (struct ast_smoother *s, int flag)
void ast_swapcopy_samples (void *dst, const void *src, int samples)
static void frame_cache_cleanup (void *data)
static int g723_len (unsigned char buf)
static int g723_samples (unsigned char *buf, int maxlen)
static unsigned char get_n_bits_at (unsigned char *data, int n, int bit)
int init_framer (void)
static char * show_codec_n (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char * show_codecs (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static int smoother_frame_feed (struct ast_smoother *s, struct ast_frame *f, int swap)
static int speex_get_wb_sz_at (unsigned char *data, int len, int bit)
static int speex_samples (unsigned char *data, int len)

Variables

static struct ast_format_list AST_FORMAT_LIST []
 Definition of supported media formats (codecs).
struct ast_frame ast_null_frame = { AST_FRAME_NULL, }
static struct ast_threadstorage frame_cache = { .once = PTHREAD_ONCE_INIT, .key_init = __init_frame_cache , .custom_init = NULL , }
static struct ast_cli_entry my_clis []


Detailed Description

Frame and codec manipulation routines.

Author:
Mark Spencer <markster@digium.com>

Definition in file frame.c.


Define Documentation

#define FRAME_CACHE_MAX_SIZE   10

Maximum ast_frame cache size.

In most cases where the frame header cache will be useful, the size of the cache will stay very small. However, it is not always the case that the same thread that allocates the frame will be the one freeing them, so sometimes a thread will never have any frames in its cache, or the cache will never be pulled from. For the latter case, we limit the maximum size.

Definition at line 58 of file frame.c.

Referenced by __frame_free(), and iax_frame_free().

#define SMOOTHER_SIZE   8000

Definition at line 70 of file frame.c.

Referenced by __ast_smoother_feed().

#define TYPE_MASK   0x3

Definition at line 79 of file frame.c.

Referenced by g723_len().


Enumeration Type Documentation

enum frame_type

Enumerator:
TYPE_HIGH 
TYPE_LOW 
TYPE_SILENCE 
TYPE_DONTSEND 

Definition at line 72 of file frame.c.

00072                 {
00073    TYPE_HIGH,     /* 0x0 */
00074    TYPE_LOW,      /* 0x1 */
00075    TYPE_SILENCE,  /* 0x2 */
00076    TYPE_DONTSEND  /* 0x3 */
00077 };


Function Documentation

int __ast_smoother_feed ( struct ast_smoother s,
struct ast_frame f,
int  swap 
)

Definition at line 199 of file frame.c.

References AST_FRAME_VOICE, ast_log(), AST_MIN_OFFSET, AST_SMOOTHER_FLAG_G729, ast_swapcopy_samples(), ast_frame::data, ast_frame::datalen, ast_smoother::flags, ast_smoother::format, ast_frame::frametype, ast_smoother::len, LOG_WARNING, ast_frame::offset, ast_smoother::opt, ast_smoother::opt_needs_swap, ast_frame::samples, ast_smoother::samplesperbyte, ast_smoother::size, smoother_frame_feed(), SMOOTHER_SIZE, and ast_frame::subclass.

00200 {
00201    if (f->frametype != AST_FRAME_VOICE) {
00202       ast_log(LOG_WARNING, "Huh?  Can't smooth a non-voice frame!\n");
00203       return -1;
00204    }
00205    if (!s->format) {
00206       s->format = f->subclass;
00207       s->samplesperbyte = (float)f->samples / (float)f->datalen;
00208    } else if (s->format != f->subclass) {
00209       ast_log(LOG_WARNING, "Smoother was working on %d format frames, now trying to feed %d?\n", s->format, f->subclass);
00210       return -1;
00211    }
00212    if (s->len + f->datalen > SMOOTHER_SIZE) {
00213       ast_log(LOG_WARNING, "Out of smoother space\n");
00214       return -1;
00215    }
00216    if (((f->datalen == s->size) ||
00217         ((f->datalen < 10) && (s->flags & AST_SMOOTHER_FLAG_G729))) &&
00218        !s->opt &&
00219        !s->len &&
00220        (f->offset >= AST_MIN_OFFSET)) {
00221       /* Optimize by sending the frame we just got
00222          on the next read, thus eliminating the douple
00223          copy */
00224       if (swap)
00225          ast_swapcopy_samples(f->data, f->data, f->samples);
00226       s->opt = f;
00227       s->opt_needs_swap = swap ? 1 : 0;
00228       return 0;
00229    }
00230 
00231    return smoother_frame_feed(s, f, swap);
00232 }

static void __frame_free ( struct ast_frame fr,
int  cache 
) [static]

Definition at line 331 of file frame.c.

References ast_free, AST_LIST_INSERT_HEAD, AST_MALLOCD_DATA, AST_MALLOCD_HDR, AST_MALLOCD_SRC, ast_threadstorage_get(), ast_frame::data, frame_cache, FRAME_CACHE_MAX_SIZE, frames, ast_frame_cache::list, ast_frame::mallocd, ast_frame::offset, ast_frame_cache::size, and ast_frame::src.

Referenced by ast_frame_free().

00332 {
00333    if (!fr->mallocd)
00334       return;
00335 
00336 #if !defined(LOW_MEMORY)
00337    if (cache && fr->mallocd == AST_MALLOCD_HDR) {
00338       /* Cool, only the header is malloc'd, let's just cache those for now 
00339        * to keep things simple... */
00340       struct ast_frame_cache *frames;
00341 
00342       if ((frames = ast_threadstorage_get(&frame_cache, sizeof(*frames))) &&
00343           (frames->size < FRAME_CACHE_MAX_SIZE)) {
00344          AST_LIST_INSERT_HEAD(&frames->list, fr, frame_list);
00345          frames->size++;
00346          return;
00347       }
00348    }
00349 #endif
00350    
00351    if (fr->mallocd & AST_MALLOCD_DATA) {
00352       if (fr->data) 
00353          ast_free(fr->data - fr->offset);
00354    }
00355    if (fr->mallocd & AST_MALLOCD_SRC) {
00356       if (fr->src)
00357          ast_free((void *) fr->src);
00358    }
00359    if (fr->mallocd & AST_MALLOCD_HDR) {
00360       ast_free(fr);
00361    }
00362 }

static void __init_frame_cache ( void   )  [static]

A per-thread cache of frame headers.

Definition at line 47 of file frame.c.

00064 {

char* ast_codec2str ( int  codec  ) 

Get a name from a format Gets a name from a format.

Parameters:
codec codec number (1,2,4,8,16,etc.)
Returns:
This returns a static string identifying the format on success, 0 on error.

Definition at line 635 of file frame.c.

References ARRAY_LEN, and ast_format_list::desc.

Referenced by moh_alloc(), show_codec_n(), and show_codecs().

00636 {
00637    int x;
00638    char *ret = "unknown";
00639    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
00640       if (AST_FORMAT_LIST[x].bits == codec) {
00641          ret = AST_FORMAT_LIST[x].desc;
00642          break;
00643       }
00644    }
00645    return ret;
00646 }

int ast_codec_choose ( struct ast_codec_pref pref,
int  formats,
int  find_best 
)

Pick a codec.

Select the best audio format according to preference list from supplied options. If "find_best" is non-zero then if nothing is found, the "Best" format of the format list is selected, otherwise 0 is returned.

Definition at line 1194 of file frame.c.

References ARRAY_LEN, ast_best_codec(), ast_debug, AST_FORMAT_AUDIO_MASK, ast_format_list::bits, and ast_codec_pref::order.

Referenced by __oh323_new(), gtalk_new(), jingle_new(), process_sdp(), sip_new(), and socket_process().

01195 {
01196    int x, ret = 0, slot;
01197 
01198    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01199       slot = pref->order[x];
01200 
01201       if (!slot)
01202          break;
01203       if (formats & AST_FORMAT_LIST[slot-1].bits) {
01204          ret = AST_FORMAT_LIST[slot-1].bits;
01205          break;
01206       }
01207    }
01208    if (ret & AST_FORMAT_AUDIO_MASK)
01209       return ret;
01210 
01211    ast_debug(4, "Could not find preferred codec - %s\n", find_best ? "Going for the best codec" : "Returning zero codec");
01212 
01213       return find_best ? ast_best_codec(formats) : 0;
01214 }

int ast_codec_get_len ( int  format,
int  samples 
)

Returns the number of bytes for the number of samples of the given format.

Definition at line 1458 of file frame.c.

References AST_FORMAT_ADPCM, AST_FORMAT_ALAW, AST_FORMAT_G722, AST_FORMAT_G723_1, AST_FORMAT_G726, AST_FORMAT_G726_AAL2, AST_FORMAT_G729A, AST_FORMAT_GSM, AST_FORMAT_ILBC, AST_FORMAT_SLINEAR, AST_FORMAT_SLINEAR16, AST_FORMAT_ULAW, ast_getformatname(), ast_log(), len(), and LOG_WARNING.

Referenced by moh_generate(), and monmp3thread().

01459 {
01460    int len = 0;
01461 
01462    /* XXX Still need speex, g723, and lpc10 XXX */ 
01463    switch(format) {
01464    case AST_FORMAT_G723_1:
01465       len = (samples / 240) * 20;
01466       break;
01467    case AST_FORMAT_ILBC:
01468       len = (samples / 240) * 50;
01469       break;
01470    case AST_FORMAT_GSM:
01471       len = (samples / 160) * 33;
01472       break;
01473    case AST_FORMAT_G729A:
01474       len = samples / 8;
01475       break;
01476    case AST_FORMAT_SLINEAR:
01477    case AST_FORMAT_SLINEAR16:
01478       len = samples * 2;
01479       break;
01480    case AST_FORMAT_ULAW:
01481    case AST_FORMAT_ALAW:
01482       len = samples;
01483       break;
01484    case AST_FORMAT_G722:
01485    case AST_FORMAT_ADPCM:
01486    case AST_FORMAT_G726:
01487    case AST_FORMAT_G726_AAL2:
01488       len = samples / 2;
01489       break;
01490    default:
01491       ast_log(LOG_WARNING, "Unable to calculate sample length for format %s\n", ast_getformatname(format));
01492    }
01493 
01494    return len;
01495 }

int ast_codec_get_samples ( struct ast_frame f  ) 

Returns the number of samples contained in the frame.

Definition at line 1414 of file frame.c.

References AST_FORMAT_ADPCM, AST_FORMAT_ALAW, AST_FORMAT_G722, AST_FORMAT_G723_1, AST_FORMAT_G726, AST_FORMAT_G726_AAL2, AST_FORMAT_G729A, AST_FORMAT_GSM, AST_FORMAT_ILBC, AST_FORMAT_LPC10, AST_FORMAT_SLINEAR, AST_FORMAT_SLINEAR16, AST_FORMAT_SPEEX, AST_FORMAT_ULAW, ast_getformatname(), ast_log(), ast_frame::data, ast_frame::datalen, g723_samples(), LOG_WARNING, speex_samples(), and ast_frame::subclass.

Referenced by ast_rtp_read(), isAnsweringMachine(), moh_generate(), schedule_delivery(), socket_process(), and socket_process_meta().

01415 {
01416    int samples=0;
01417    switch(f->subclass) {
01418    case AST_FORMAT_SPEEX:
01419       samples = speex_samples(f->data, f->datalen);
01420       break;
01421    case AST_FORMAT_G723_1:
01422       samples = g723_samples(f->data, f->datalen);
01423       break;
01424    case AST_FORMAT_ILBC:
01425       samples = 240 * (f->datalen / 50);
01426       break;
01427    case AST_FORMAT_GSM:
01428       samples = 160 * (f->datalen / 33);
01429       break;
01430    case AST_FORMAT_G729A:
01431       samples = f->datalen * 8;
01432       break;
01433    case AST_FORMAT_SLINEAR:
01434    case AST_FORMAT_SLINEAR16:
01435       samples = f->datalen / 2;
01436       break;
01437    case AST_FORMAT_LPC10:
01438       /* assumes that the RTP packet contains one LPC10 frame */
01439       samples = 22 * 8;
01440       samples += (((char *)(f->data))[7] & 0x1) * 8;
01441       break;
01442    case AST_FORMAT_ULAW:
01443    case AST_FORMAT_ALAW:
01444       samples = f->datalen;
01445       break;
01446    case AST_FORMAT_G722:
01447    case AST_FORMAT_ADPCM:
01448    case AST_FORMAT_G726:
01449    case AST_FORMAT_G726_AAL2:
01450       samples = f->datalen * 2;
01451       break;
01452    default:
01453       ast_log(LOG_WARNING, "Unable to calculate samples for format %s\n", ast_getformatname(f->subclass));
01454    }
01455    return samples;
01456 }

int ast_codec_pref_append ( struct ast_codec_pref pref,
int  format 
)

Append codec to list.

Append a audio codec to a preference list, removing it first if it was already there.

Definition at line 1053 of file frame.c.

References ARRAY_LEN, ast_codec_pref_remove(), and ast_codec_pref::order.

Referenced by ast_parse_allow_disallow().

01054 {
01055    int x, newindex = 0;
01056 
01057    ast_codec_pref_remove(pref, format);
01058 
01059    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01060       if (AST_FORMAT_LIST[x].bits == format) {
01061          newindex = x + 1;
01062          break;
01063       }
01064    }
01065 
01066    if (newindex) {
01067       for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01068          if (!pref->order[x]) {
01069             pref->order[x] = newindex;
01070             break;
01071          }
01072       }
01073    }
01074 
01075    return x;
01076 }

void ast_codec_pref_convert ( struct ast_codec_pref pref,
char *  buf,
size_t  size,
int  right 
)

Shift an audio codec preference list up or down 65 bytes so that it becomes an ASCII string.

Definition at line 955 of file frame.c.

References ast_codec_pref::order.

Referenced by check_access(), create_addr(), dump_prefs(), and socket_process().

00956 {
00957    int x, differential = (int) 'A', mem;
00958    char *from, *to;
00959 
00960    if (right) {
00961       from = pref->order;
00962       to = buf;
00963       mem = size;
00964    } else {
00965       to = pref->order;
00966       from = buf;
00967       mem = 32;
00968    }
00969 
00970    memset(to, 0, mem);
00971    for (x = 0; x < 32 ; x++) {
00972       if (!from[x])
00973          break;
00974       to[x] = right ? (from[x] + differential) : (from[x] - differential);
00975    }
00976 }

struct ast_format_list ast_codec_pref_getsize ( struct ast_codec_pref pref,
int  format 
) [read]

Get packet size for codec.

Definition at line 1155 of file frame.c.

References ARRAY_LEN, ast_format_list::bits, ast_format_list::cur_ms, ast_format_list::def_ms, format, ast_format_list::inc_ms, ast_format_list::max_ms, and ast_format_list::min_ms.

Referenced by add_codec_to_sdp(), ast_rtp_bridge(), ast_rtp_codec_setpref(), ast_rtp_write(), handle_open_receive_channel_ack_message(), skinny_set_rtp_peer(), and transmit_connect().

01156 {
01157    int x, index = -1, framems = 0;
01158    struct ast_format_list fmt = { 0, };
01159 
01160    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01161       if (AST_FORMAT_LIST[x].bits == format) {
01162          fmt = AST_FORMAT_LIST[x];
01163          index = x;
01164          break;
01165       }
01166    }
01167 
01168    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01169       if (pref->order[x] == (index + 1)) {
01170          framems = pref->framing[x];
01171          break;
01172       }
01173    }
01174 
01175    /* size validation */
01176    if (!framems)
01177       framems = AST_FORMAT_LIST[index].def_ms;
01178 
01179    if (AST_FORMAT_LIST[index].inc_ms && framems % AST_FORMAT_LIST[index].inc_ms) /* avoid division by zero */
01180       framems -= framems % AST_FORMAT_LIST[index].inc_ms;
01181 
01182    if (framems < AST_FORMAT_LIST[index].min_ms)
01183       framems = AST_FORMAT_LIST[index].min_ms;
01184 
01185    if (framems > AST_FORMAT_LIST[index].max_ms)
01186       framems = AST_FORMAT_LIST[index].max_ms;
01187 
01188    fmt.cur_ms = framems;
01189 
01190    return fmt;
01191 }

int ast_codec_pref_index ( struct ast_codec_pref pref,
int  index 
)

Codec located at a particular place in the preference index.

Definition at line 1013 of file frame.c.

References ast_format_list::bits, and ast_codec_pref::order.

Referenced by _sip_show_peer(), add_sdp(), ast_codec_pref_string(), function_iaxpeer(), function_sippeer(), gtalk_invite(), handle_cli_iax2_show_peer(), jingle_accept_call(), print_codec_to_cli(), and socket_process().

01014 {
01015    int slot = 0;
01016 
01017    
01018    if ((index >= 0) && (index < sizeof(pref->order))) {
01019       slot = pref->order[index];
01020    }
01021 
01022    return slot ? AST_FORMAT_LIST[slot-1].bits : 0;
01023 }

void ast_codec_pref_prepend ( struct ast_codec_pref pref,
int  format,
int  only_if_existing 
)

Prepend codec to list.

Prepend an audio codec to a preference list, removing it first if it was already there.

Definition at line 1079 of file frame.c.

References ARRAY_LEN, ast_codec_pref::framing, and ast_codec_pref::order.

Referenced by create_addr().

01080 {
01081    int x, newindex = 0;
01082 
01083    /* First step is to get the codecs "index number" */
01084    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01085       if (AST_FORMAT_LIST[x].bits == format) {
01086          newindex = x + 1;
01087          break;
01088       }
01089    }
01090    /* Done if its unknown */
01091    if (!newindex)
01092       return;
01093 
01094    /* Now find any existing occurrence, or the end */
01095    for (x = 0; x < 32; x++) {
01096       if (!pref->order[x] || pref->order[x] == newindex)
01097          break;
01098    }
01099 
01100    if (only_if_existing && !pref->order[x])
01101       return;
01102 
01103    /* Move down to make space to insert - either all the way to the end,
01104       or as far as the existing location (which will be overwritten) */
01105    for (; x > 0; x--) {
01106       pref->order[x] = pref->order[x - 1];
01107       pref->framing[x] = pref->framing[x - 1];
01108    }
01109 
01110    /* And insert the new entry */
01111    pref->order[0] = newindex;
01112    pref->framing[0] = 0; /* ? */
01113 }

void ast_codec_pref_remove ( struct ast_codec_pref pref,
int  format 
)

Remove codec from pref list.

Remove audio a codec from a preference list.

Definition at line 1026 of file frame.c.

References ARRAY_LEN, ast_codec_pref::framing, and ast_codec_pref::order.

Referenced by ast_codec_pref_append(), and ast_parse_allow_disallow().

01027 {
01028    struct ast_codec_pref oldorder;
01029    int x, y = 0;
01030    int slot;
01031    int size;
01032 
01033    if (!pref->order[0])
01034       return;
01035 
01036    memcpy(&oldorder, pref, sizeof(oldorder));
01037    memset(pref, 0, sizeof(*pref));
01038 
01039    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01040       slot = oldorder.order[x];
01041       size = oldorder.framing[x];
01042       if (! slot)
01043          break;
01044       if (AST_FORMAT_LIST[slot-1].bits != format) {
01045          pref->order[y] = slot;
01046          pref->framing[y++] = size;
01047       }
01048    }
01049    
01050 }

int ast_codec_pref_setsize ( struct ast_codec_pref pref,
int  format,
int  framems 
)

Set packet size for codec.

Definition at line 1116 of file frame.c.

References ARRAY_LEN, ast_format_list::def_ms, ast_codec_pref::framing, ast_format_list::inc_ms, ast_format_list::max_ms, ast_format_list::min_ms, and ast_codec_pref::order.

Referenced by ast_parse_allow_disallow(), and process_sdp().

01117 {
01118    int x, index = -1;
01119 
01120    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01121       if (AST_FORMAT_LIST[x].bits == format) {
01122          index = x;
01123          break;
01124       }
01125    }
01126 
01127    if (index < 0)
01128       return -1;
01129 
01130    /* size validation */
01131    if (!framems)
01132       framems = AST_FORMAT_LIST[index].def_ms;
01133 
01134    if (AST_FORMAT_LIST[index].inc_ms && framems % AST_FORMAT_LIST[index].inc_ms) /* avoid division by zero */
01135       framems -= framems % AST_FORMAT_LIST[index].inc_ms;
01136 
01137    if (framems < AST_FORMAT_LIST[index].min_ms)
01138       framems = AST_FORMAT_LIST[index].min_ms;
01139 
01140    if (framems > AST_FORMAT_LIST[index].max_ms)
01141       framems = AST_FORMAT_LIST[index].max_ms;
01142 
01143 
01144    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01145       if (pref->order[x] == (index + 1)) {
01146          pref->framing[x] = framems;
01147          break;
01148       }
01149    }
01150 
01151    return x;
01152 }

int ast_codec_pref_string ( struct ast_codec_pref pref,
char *  buf,
size_t  size 
)

Dump audio codec preference list into a string.

Definition at line 978 of file frame.c.

References ast_codec_pref_index(), and ast_getformatname().

Referenced by dump_prefs(), and socket_process().

00979 {
00980    int x, codec; 
00981    size_t total_len, slen;
00982    char *formatname;
00983    
00984    memset(buf,0,size);
00985    total_len = size;
00986    buf[0] = '(';
00987    total_len--;
00988    for(x = 0; x < 32 ; x++) {
00989       if (total_len <= 0)
00990          break;
00991       if (!(codec = ast_codec_pref_index(pref,x)))
00992          break;
00993       if ((formatname = ast_getformatname(codec))) {
00994          slen = strlen(formatname);
00995          if (slen > total_len)
00996             break;
00997          strncat(buf, formatname, total_len - 1); /* safe */
00998          total_len -= slen;
00999       }
01000       if (total_len && x < 31 && ast_codec_pref_index(pref , x + 1)) {
01001          strncat(buf, "|", total_len - 1); /* safe */
01002          total_len--;
01003       }
01004    }
01005    if (total_len) {
01006       strncat(buf, ")", total_len - 1); /* safe */
01007       total_len--;
01008    }
01009 
01010    return size - total_len;
01011 }

static const char* ast_expand_codec_alias ( const char *  in  )  [static]

Definition at line 606 of file frame.c.

References ARRAY_LEN.

Referenced by ast_getformatbyname().

00607 {
00608    int x;
00609 
00610    for (x = 0; x < ARRAY_LEN(ast_codec_alias_table); x++) {
00611       if (!strcmp(in,ast_codec_alias_table[x].alias))
00612          return ast_codec_alias_table[x].realname;
00613    }
00614    return in;
00615 }

int ast_frame_adjust_volume ( struct ast_frame f,
int  adjustment 
)

Adjusts the volume of the audio samples contained in a frame.

Parameters:
f The frame containing the samples (must be AST_FRAME_VOICE and AST_FORMAT_SLINEAR)
adjustment The number of dB to adjust up or down.
Returns:
0 for success, non-zero for an error

Definition at line 1497 of file frame.c.

References AST_FORMAT_SLINEAR, AST_FRAME_VOICE, ast_slinear_saturated_divide(), ast_slinear_saturated_multiply(), ast_frame::data, ast_frame::frametype, ast_frame::samples, and ast_frame::subclass.

Referenced by audiohook_read_frame_single(), conf_run(), and volume_callback().

01498 {
01499    int count;
01500    short *fdata = f->data;
01501    short adjust_value = abs(adjustment);
01502 
01503    if ((f->frametype != AST_FRAME_VOICE) || (f->subclass != AST_FORMAT_SLINEAR))
01504       return -1;
01505 
01506    if (!adjustment)
01507       return 0;
01508 
01509    for (count = 0; count < f->samples; count++) {
01510       if (adjustment > 0) {
01511          ast_slinear_saturated_multiply(&fdata[count], &adjust_value);
01512       } else if (adjustment < 0) {
01513          ast_slinear_saturated_divide(&fdata[count], &adjust_value);
01514       }
01515    }
01516 
01517    return 0;
01518 }

void ast_frame_dump ( const char *  name,
struct ast_frame f,
char *  prefix 
)

Dump a frame for debugging purposes

Definition at line 737 of file frame.c.

References AST_CONTROL_ANSWER, AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_FLASH, AST_CONTROL_HANGUP, AST_CONTROL_HOLD, AST_CONTROL_OFFHOOK, AST_CONTROL_OPTION, AST_CONTROL_RADIO_KEY, AST_CONTROL_RADIO_UNKEY, AST_CONTROL_RING, AST_CONTROL_RINGING, AST_CONTROL_T38_PARAMETERS, AST_CONTROL_TAKEOFFHOOK, AST_CONTROL_UNHOLD, AST_CONTROL_WINK, ast_copy_string(), AST_FRAME_CONTROL, AST_FRAME_DTMF_BEGIN, AST_FRAME_DTMF_END, AST_FRAME_HTML, AST_FRAME_IAX, AST_FRAME_IMAGE, AST_FRAME_MODEM, AST_FRAME_NULL, AST_FRAME_TEXT, AST_FRAME_VIDEO, AST_FRAME_VOICE, ast_getformatname(), AST_HTML_BEGIN, AST_HTML_DATA, AST_HTML_END, AST_HTML_LDCOMPLETE, AST_HTML_LINKREJECT, AST_HTML_LINKURL, AST_HTML_NOSUPPORT, AST_HTML_UNLINK, AST_HTML_URL, AST_MODEM_T38, AST_MODEM_V150, ast_strlen_zero(), AST_T38_NEGOTIATED, AST_T38_REFUSED, AST_T38_REQUEST_NEGOTIATE, AST_T38_REQUEST_TERMINATE, AST_T38_TERMINATED, ast_verbose(), COLOR_BLACK, COLOR_BRCYAN, COLOR_BRGREEN, COLOR_BRMAGENTA, COLOR_BRRED, COLOR_YELLOW, ast_frame::data, ast_frame::datalen, ast_frame::frametype, ast_control_t38_parameters::request_response, ast_frame::subclass, and term_color().

Referenced by __ast_read(), and ast_write().

00738 {
00739    const char noname[] = "unknown";
00740    char ftype[40] = "Unknown Frametype";
00741    char cft[80];
00742    char subclass[40] = "Unknown Subclass";
00743    char csub[80];
00744    char moreinfo[40] = "";
00745    char cn[60];
00746    char cp[40];
00747    char cmn[40];
00748    const char *message = "Unknown";
00749 
00750    if (!name)
00751       name = noname;
00752 
00753 
00754    if (!f) {
00755       ast_verbose("%s [ %s (NULL) ] [%s]\n", 
00756          term_color(cp, prefix, COLOR_BRMAGENTA, COLOR_BLACK, sizeof(cp)),
00757          term_color(cft, "HANGUP", COLOR_BRRED, COLOR_BLACK, sizeof(cft)), 
00758          term_color(cn, name, COLOR_YELLOW, COLOR_BLACK, sizeof(cn)));
00759       return;
00760    }
00761    /* XXX We should probably print one each of voice and video when the format changes XXX */
00762    if (f->frametype == AST_FRAME_VOICE)
00763       return;
00764    if (f->frametype == AST_FRAME_VIDEO)
00765       return;
00766    switch(f->frametype) {
00767    case AST_FRAME_DTMF_BEGIN:
00768       strcpy(ftype, "DTMF Begin");
00769       subclass[0] = f->subclass;
00770       subclass[1] = '\0';
00771       break;
00772    case AST_FRAME_DTMF_END:
00773       strcpy(ftype, "DTMF End");
00774       subclass[0] = f->subclass;
00775       subclass[1] = '\0';
00776       break;
00777    case AST_FRAME_CONTROL:
00778       strcpy(ftype, "Control");
00779       switch(f->subclass) {
00780       case AST_CONTROL_HANGUP:
00781          strcpy(subclass, "Hangup");
00782          break;
00783       case AST_CONTROL_RING:
00784          strcpy(subclass, "Ring");
00785          break;
00786       case AST_CONTROL_RINGING:
00787          strcpy(subclass, "Ringing");
00788          break;
00789       case AST_CONTROL_ANSWER:
00790          strcpy(subclass, "Answer");
00791          break;
00792       case AST_CONTROL_BUSY:
00793          strcpy(subclass, "Busy");
00794          break;
00795       case AST_CONTROL_TAKEOFFHOOK:
00796          strcpy(subclass, "Take Off Hook");
00797          break;
00798       case AST_CONTROL_OFFHOOK:
00799          strcpy(subclass, "Line Off Hook");
00800          break;
00801       case AST_CONTROL_CONGESTION:
00802          strcpy(subclass, "Congestion");
00803          break;
00804       case AST_CONTROL_FLASH:
00805          strcpy(subclass, "Flash");
00806          break;
00807       case AST_CONTROL_WINK:
00808          strcpy(subclass, "Wink");
00809          break;
00810       case AST_CONTROL_OPTION:
00811          strcpy(subclass, "Option");
00812          break;
00813       case AST_CONTROL_RADIO_KEY:
00814          strcpy(subclass, "Key Radio");
00815          break;
00816       case AST_CONTROL_RADIO_UNKEY:
00817          strcpy(subclass, "Unkey Radio");
00818          break;
00819       case AST_CONTROL_HOLD:
00820          strcpy(subclass, "Hold");
00821          break;
00822       case AST_CONTROL_UNHOLD:
00823          strcpy(subclass, "Unhold");
00824          break;
00825       case AST_CONTROL_T38_PARAMETERS:
00826          if (f->datalen != sizeof(struct ast_control_t38_parameters)) {
00827             message = "Invalid";
00828          } else {
00829             struct ast_control_t38_parameters *parameters = f->data;
00830             enum ast_control_t38 state = parameters->request_response;
00831             if (state == AST_T38_REQUEST_NEGOTIATE)
00832                message = "Negotiation Requested";
00833             else if (state == AST_T38_REQUEST_TERMINATE)
00834                message = "Negotiation Request Terminated";
00835             else if (state == AST_T38_NEGOTIATED)
00836                message = "Negotiated";
00837             else if (state == AST_T38_TERMINATED)
00838                message = "Terminated";
00839             else if (state == AST_T38_REFUSED)
00840                message = "Refused";
00841          }
00842          snprintf(subclass, sizeof(subclass), "T38_Parameters/%s", message);
00843          break;
00844       case -1:
00845          strcpy(subclass, "Stop generators");
00846          break;
00847       default:
00848          snprintf(subclass, sizeof(subclass), "Unknown control '%d'", f->subclass);
00849       }
00850       break;
00851    case AST_FRAME_NULL:
00852       strcpy(ftype, "Null Frame");
00853       strcpy(subclass, "N/A");
00854       break;
00855    case AST_FRAME_IAX:
00856       /* Should never happen */
00857       strcpy(ftype, "IAX Specific");
00858       snprintf(subclass, sizeof(subclass), "IAX Frametype %d", f->subclass);
00859       break;
00860    case AST_FRAME_TEXT:
00861       strcpy(ftype, "Text");
00862       strcpy(subclass, "N/A");
00863       ast_copy_string(moreinfo, f->data, sizeof(moreinfo));
00864       break;
00865    case AST_FRAME_IMAGE:
00866       strcpy(ftype, "Image");
00867       snprintf(subclass, sizeof(subclass), "Image format %s\n", ast_getformatname(f->subclass));
00868       break;
00869    case AST_FRAME_HTML:
00870       strcpy(ftype, "HTML");
00871       switch(f->subclass) {
00872       case AST_HTML_URL:
00873          strcpy(subclass, "URL");
00874          ast_copy_string(moreinfo, f->data, sizeof(moreinfo));
00875          break;
00876       case AST_HTML_DATA:
00877          strcpy(subclass, "Data");
00878          break;
00879       case AST_HTML_BEGIN:
00880          strcpy(subclass, "Begin");
00881          break;
00882       case AST_HTML_END:
00883          strcpy(subclass, "End");
00884          break;
00885       case AST_HTML_LDCOMPLETE:
00886          strcpy(subclass, "Load Complete");
00887          break;
00888       case AST_HTML_NOSUPPORT:
00889          strcpy(subclass, "No Support");
00890          break;
00891       case AST_HTML_LINKURL:
00892          strcpy(subclass, "Link URL");
00893          ast_copy_string(moreinfo, f->data, sizeof(moreinfo));
00894          break;
00895       case AST_HTML_UNLINK:
00896          strcpy(subclass, "Unlink");
00897          break;
00898       case AST_HTML_LINKREJECT:
00899          strcpy(subclass, "Link Reject");
00900          break;
00901       default:
00902          snprintf(subclass, sizeof(subclass), "Unknown HTML frame '%d'\n", f->subclass);
00903          break;
00904       }
00905       break;
00906    case AST_FRAME_MODEM:
00907       strcpy(ftype, "Modem");
00908       switch (f->subclass) {
00909       case AST_MODEM_T38:
00910          strcpy(subclass, "T.38");
00911          break;
00912       case AST_MODEM_V150:
00913          strcpy(subclass, "V.150");
00914          break;
00915       default:
00916          snprintf(subclass, sizeof(subclass), "Unknown MODEM frame '%d'\n", f->subclass);
00917          break;
00918       }
00919       break;
00920    default:
00921       snprintf(ftype, sizeof(ftype), "Unknown Frametype '%d'", f->frametype);
00922    }
00923    if (!ast_strlen_zero(moreinfo))
00924       ast_verbose("%s [ TYPE: %s (%d) SUBCLASS: %s (%d) '%s' ] [%s]\n",  
00925              term_color(cp, prefix, COLOR_BRMAGENTA, COLOR_BLACK, sizeof(cp)),
00926              term_color(cft, ftype, COLOR_BRRED, COLOR_BLACK, sizeof(cft)),
00927              f->frametype, 
00928              term_color(csub, subclass, COLOR_BRCYAN, COLOR_BLACK, sizeof(csub)),
00929              f->subclass, 
00930              term_color(cmn, moreinfo, COLOR_BRGREEN, COLOR_BLACK, sizeof(cmn)),
00931              term_color(cn, name, COLOR_YELLOW, COLOR_BLACK, sizeof(cn)));
00932    else
00933       ast_verbose("%s [ TYPE: %s (%d) SUBCLASS: %s (%d) ] [%s]\n",  
00934              term_color(cp, prefix, COLOR_BRMAGENTA, COLOR_BLACK, sizeof(cp)),
00935              term_color(cft, ftype, COLOR_BRRED, COLOR_BLACK, sizeof(cft)),
00936              f->frametype, 
00937              term_color(csub, subclass, COLOR_BRCYAN, COLOR_BLACK, sizeof(csub)),
00938              f->subclass, 
00939              term_color(cn, name, COLOR_YELLOW, COLOR_BLACK, sizeof(cn)));
00940 }

void ast_frame_free ( struct ast_frame fr,
int  cache 
)

Requests a frame to be allocated.

Parameters:
source Request a frame be allocated. source is an optional source of the frame, len is the requested length, or "0" if the caller will supply the buffer
Frees a frame or list of frames
Parameters:
fr Frame to free, or head of list to free
cache Whether to consider this frame for frame caching

Definition at line 365 of file frame.c.

References __frame_free(), AST_LIST_NEXT, ast_frame::frame_list, and ast_frame::next.

Referenced by mixmonitor_thread().

00366 {
00367    struct ast_frame *next;
00368 
00369    for (next = AST_LIST_NEXT(frame, frame_list);
00370         frame;
00371         frame = next, next = frame ? AST_LIST_NEXT(frame, frame_list) : NULL) {
00372       __frame_free(frame, cache);
00373    }
00374 }

static struct ast_frame* ast_frame_header_new ( void   )  [static, read]

Definition at line 289 of file frame.c.

References ast_calloc, ast_calloc_cache, AST_LIST_REMOVE_HEAD, AST_MALLOCD_HDR, ast_threadstorage_get(), f, frame_cache, frames, ast_frame_cache::list, ast_frame::mallocd, ast_frame::mallocd_hdr_len, and ast_frame_cache::size.

Referenced by ast_frisolate().

00290 {
00291    struct ast_frame *f;
00292 
00293 #if !defined(LOW_MEMORY)
00294    struct ast_frame_cache *frames;
00295 
00296    if ((frames = ast_threadstorage_get(&frame_cache, sizeof(*frames)))) {
00297       if ((f = AST_LIST_REMOVE_HEAD(&frames->list, frame_list))) {
00298          size_t mallocd_len = f->mallocd_hdr_len;
00299          memset(f, 0, sizeof(*f));
00300          f->mallocd_hdr_len = mallocd_len;
00301          f->mallocd = AST_MALLOCD_HDR;
00302          frames->size--;
00303          return f;
00304       }
00305    }
00306    if (!(f = ast_calloc_cache(1, sizeof(*f))))
00307       return NULL;
00308 #else
00309    if (!(f = ast_calloc(1, sizeof(*f))))
00310       return NULL;
00311 #endif
00312 
00313    f->mallocd_hdr_len = sizeof(*f);
00314    
00315    return f;
00316 }

int ast_frame_slinear_sum ( struct ast_frame f1,
struct ast_frame f2 
)

Sums two frames of audio samples.

Parameters:
f1 The first frame (which will contain the result)
f2 The second frame
Returns:
0 for success, non-zero for an error
The frames must be AST_FRAME_VOICE and must contain AST_FORMAT_SLINEAR samples, and must contain the same number of samples.

Definition at line 1520 of file frame.c.

References AST_FORMAT_SLINEAR, AST_FRAME_VOICE, ast_slinear_saturated_add(), ast_frame::data, ast_frame::frametype, ast_frame::samples, and ast_frame::subclass.

01521 {
01522    int count;
01523    short *data1, *data2;
01524 
01525    if ((f1->frametype != AST_FRAME_VOICE) || (f1->subclass != AST_FORMAT_SLINEAR))
01526       return -1;
01527 
01528    if ((f2->frametype != AST_FRAME_VOICE) || (f2->subclass != AST_FORMAT_SLINEAR))
01529       return -1;
01530 
01531    if (f1->samples != f2->samples)
01532       return -1;
01533 
01534    for (count = 0, data1 = f1->data, data2 = f2->data;
01535         count < f1->samples;
01536         count++, data1++, data2++)
01537       ast_slinear_saturated_add(data1, data2);
01538 
01539    return 0;
01540 }

struct ast_frame* ast_frdup ( const struct ast_frame fr  )  [read]

Copies a frame.

Parameters:
fr frame to copy Duplicates a frame -- should only rarely be used, typically frisolate is good enough
Returns:
Returns a frame on success, NULL on error

Definition at line 459 of file frame.c.

References ast_calloc_cache, ast_copy_flags, AST_FRFLAG_HAS_TIMING_INFO, AST_FRIENDLY_OFFSET, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, AST_MALLOCD_HDR, ast_threadstorage_get(), buf, ast_frame::data, ast_frame::datalen, ast_frame::delivery, frame_cache, frames, ast_frame::frametype, ast_frame::len, len(), ast_frame_cache::list, ast_frame::mallocd, ast_frame::mallocd_hdr_len, ast_frame::offset, ast_frame::samples, ast_frame::seqno, ast_frame_cache::size, ast_frame::src, ast_frame::subclass, and ast_frame::ts.

Referenced by __ast_queue_frame(), ast_frisolate(), ast_jb_put(), ast_rtp_write(), ast_slinfactory_feed(), audiohook_read_frame_both(), audiohook_read_frame_single(), autoservice_run(), and recordthread().

00460 {
00461    struct ast_frame *out = NULL;
00462    int len, srclen = 0;
00463    void *buf = NULL;
00464 
00465 #if !defined(LOW_MEMORY)
00466    struct ast_frame_cache *frames;
00467 #endif
00468 
00469    /* Start with standard stuff */
00470    len = sizeof(*out) + AST_FRIENDLY_OFFSET + f->datalen;
00471    /* If we have a source, add space for it */
00472    /*
00473     * XXX Watch out here - if we receive a src which is not terminated
00474     * properly, we can be easily attacked. Should limit the size we deal with.
00475     */
00476    if (f->src)
00477       srclen = strlen(f->src);
00478    if (srclen > 0)
00479       len += srclen + 1;
00480    
00481 #if !defined(LOW_MEMORY)
00482    if ((frames = ast_threadstorage_get(&frame_cache, sizeof(*frames)))) {
00483       AST_LIST_TRAVERSE_SAFE_BEGIN(&frames->list, out, frame_list) {
00484          if (out->mallocd_hdr_len >= len) {
00485             size_t mallocd_len = out->mallocd_hdr_len;
00486 
00487             AST_LIST_REMOVE_CURRENT(frame_list);
00488             memset(out, 0, sizeof(*out));
00489             out->mallocd_hdr_len = mallocd_len;
00490             buf = out;
00491             frames->size--;
00492             break;
00493          }
00494       }
00495       AST_LIST_TRAVERSE_SAFE_END;
00496    }
00497 #endif
00498 
00499    if (!buf) {
00500       if (!(buf = ast_calloc_cache(1, len)))
00501          return NULL;
00502       out = buf;
00503       out->mallocd_hdr_len = len;
00504    }
00505 
00506    out->frametype = f->frametype;
00507    out->subclass = f->subclass;
00508    out->datalen = f->datalen;
00509    out->samples = f->samples;
00510    out->delivery = f->delivery;
00511    /* Set us as having malloc'd header only, so it will eventually
00512       get freed. */
00513    out->mallocd = AST_MALLOCD_HDR;
00514    out->offset = AST_FRIENDLY_OFFSET;
00515    if (out->datalen) {
00516       out->data = buf + sizeof(*out) + AST_FRIENDLY_OFFSET;
00517       memcpy(out->data, f->data, out->datalen); 
00518    }
00519    if (srclen > 0) {
00520       /* This may seem a little strange, but it's to avoid a gcc (4.2.4) compiler warning */
00521       char *src;
00522       out->src = buf + sizeof(*out) + AST_FRIENDLY_OFFSET + f->datalen;
00523       src = (char *) out->src;
00524       /* Must have space since we allocated for it */
00525       strcpy(src, f->src);
00526    }
00527    ast_copy_flags(out, f, AST_FRFLAG_HAS_TIMING_INFO);
00528    out->ts = f->ts;
00529    out->len = f->len;
00530    out->seqno = f->seqno;
00531    return out;
00532 }

struct ast_frame* ast_frisolate ( struct ast_frame fr  )  [read]

'isolates' a frame by duplicating non-malloc'ed components (header, src, data). On return all components are malloc'ed

Makes a frame independent of any static storage.

Definition at line 381 of file frame.c.

References ast_copy_flags, ast_frame_header_new(), ast_frdup(), ast_free, AST_FRFLAG_HAS_TIMING_INFO, AST_FRIENDLY_OFFSET, ast_malloc, AST_MALLOCD_DATA, AST_MALLOCD_HDR, AST_MALLOCD_SRC, ast_strdup, ast_test_flag, ast_frame::data, ast_frame::datalen, ast_frame::frametype, ast_frame::len, ast_frame::mallocd, ast_frame::offset, ast_frame::samples, ast_frame::seqno, ast_frame::src, ast_frame::subclass, and ast_frame::ts.

Referenced by __ast_answer(), ast_dsp_process(), ast_slinfactory_feed(), ast_trans_frameout(), ast_write(), autoservice_run(), dahdi_decoder_frameout(), dahdi_encoder_frameout(), jpeg_read_image(), and read_frame().

00382 {
00383    struct ast_frame *out;
00384    void *newdata;
00385 
00386    /* if none of the existing frame is malloc'd, let ast_frdup() do it
00387       since it is more efficient
00388    */
00389    if (fr->mallocd == 0) {
00390       return ast_frdup(fr);
00391    }
00392 
00393    /* if everything is already malloc'd, we are done */
00394    if ((fr->mallocd & (AST_MALLOCD_HDR | AST_MALLOCD_SRC | AST_MALLOCD_DATA)) ==
00395        (AST_MALLOCD_HDR | AST_MALLOCD_SRC | AST_MALLOCD_DATA)) {
00396       return fr;
00397    }
00398 
00399    if (!(fr->mallocd & AST_MALLOCD_HDR)) {
00400       /* Allocate a new header if needed */
00401       if (!(out = ast_frame_header_new())) {
00402          return NULL;
00403       }
00404       out->frametype = fr->frametype;
00405       out->subclass = fr->subclass;
00406       out->datalen = fr->datalen;
00407       out->samples = fr->samples;
00408       out->offset = fr->offset;
00409       /* Copy the timing data */
00410       ast_copy_flags(out, fr, AST_FRFLAG_HAS_TIMING_INFO);
00411       if (ast_test_flag(fr, AST_FRFLAG_HAS_TIMING_INFO)) {
00412          out->ts = fr->ts;
00413          out->len = fr->len;
00414          out->seqno = fr->seqno;
00415       }
00416    } else {
00417       out = fr;
00418    }
00419    
00420    if (!(fr->mallocd & AST_MALLOCD_SRC) && fr->src) {
00421       if (!(out->src = ast_strdup(fr->src))) {
00422          if (out != fr) {
00423             ast_free(out);
00424          }
00425          return NULL;
00426       }
00427    } else {
00428       out->src = fr->src;
00429       fr->src = NULL;
00430       fr->mallocd &= ~AST_MALLOCD_SRC;
00431    }
00432    
00433    if (!(fr->mallocd & AST_MALLOCD_DATA))  {
00434       if (!(newdata = ast_malloc(fr->datalen + AST_FRIENDLY_OFFSET))) {
00435          if (out->src != fr->src) {
00436             ast_free((void *) out->src);
00437          }
00438          if (out != fr) {
00439             ast_free(out);
00440          }
00441          return NULL;
00442       }
00443       newdata += AST_FRIENDLY_OFFSET;
00444       out->offset = AST_FRIENDLY_OFFSET;
00445       out->datalen = fr->datalen;
00446       memcpy(newdata, fr->data, fr->datalen);
00447       out->data = newdata;
00448    } else {
00449       out->data = fr->data;
00450       memset(&fr->data, 0, sizeof(fr->data));
00451       fr->mallocd &= ~AST_MALLOCD_DATA;
00452    }
00453 
00454    out->mallocd = AST_MALLOCD_HDR | AST_MALLOCD_SRC | AST_MALLOCD_DATA;
00455    
00456    return out;
00457 }

struct ast_format_list* ast_get_format_list ( size_t *  size  )  [read]

Definition at line 550 of file frame.c.

References ARRAY_LEN.

00551 {
00552    *size = ARRAY_LEN(AST_FORMAT_LIST);
00553    return AST_FORMAT_LIST;
00554 }

struct ast_format_list* ast_get_format_list_index ( int  index  )  [read]

Definition at line 545 of file frame.c.

00546 {
00547    return &AST_FORMAT_LIST[index];
00548 }

int ast_getformatbyname ( const char *  name  ) 

Gets a format from a name.

Parameters:
name string of format
Returns:
This returns the form of the format in binary on success, 0 on error.

Definition at line 617 of file frame.c.

References ARRAY_LEN, ast_expand_codec_alias(), ast_format_list::bits, and format.

Referenced by ast_parse_allow_disallow(), iax_template_parse(), load_moh_classes(), local_ast_moh_start(), reload_config(), and try_suggested_sip_codec().

00618 {
00619    int x, all, format = 0;
00620 
00621    all = strcasecmp(name, "all") ? 0 : 1;
00622    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
00623       if (all || 
00624            !strcasecmp(AST_FORMAT_LIST[x].name,name) ||
00625            !strcasecmp(AST_FORMAT_LIST[x].name,ast_expand_codec_alias(name))) {
00626          format |= AST_FORMAT_LIST[x].bits;
00627          if (!all)
00628             break;
00629       }
00630    }
00631 
00632    return format;
00633 }

char* ast_getformatname ( int  format  ) 

Get the name of a format.

Parameters:
format id of format
Returns:
A static string containing the name of the format or "unknown" if unknown.

Definition at line 556 of file frame.c.

References ARRAY_LEN, ast_format_list::bits, and ast_format_list::name.

Referenced by __ast_play_and_record(), __ast_read(), __ast_register_translator(), _sip_show_peer(), add_codec_to_answer(), add_codec_to_sdp(), add_tcodec_to_sdp(), add_vcodec_to_sdp(), agent_call(), ast_codec_get_len(), ast_codec_get_samples(), ast_codec_pref_string(), ast_dsp_process(), ast_frame_dump(), ast_openvstream(), ast_rtp_write(), ast_slinfactory_feed(), ast_streamfile(), ast_translator_build_path(), ast_unregister_translator(), ast_writestream(), background_detect_exec(), dahdi_read(), do_waiting(), eagi_exec(), func_channel_read(), function_iaxpeer(), function_sippeer(), gtalk_show_channels(), handle_cli_core_show_file_formats(), handle_cli_core_show_translation(), handle_cli_iax2_show_channels(), handle_cli_iax2_show_peer(), handle_cli_moh_show_classes(), handle_core_show_image_formats(), iax2_request(), iax_show_provisioning(), jingle_show_channels(), login_exec(), moh_release(), oh323_rtp_read(), phone_setup(), print_codec_to_cli(), rebuild_matrix(), register_translator(), set_format(), set_local_capabilities(), set_peer_capabilities(), show_codecs(), sip_request_call(), sip_rtp_read(), socket_process(), start_rtp(), unistim_request(), unistim_rtp_read(), and unistim_write().

00557 {
00558    int x;
00559    char *ret = "unknown";
00560    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
00561       if (AST_FORMAT_LIST[x].bits == format) {
00562          ret = AST_FORMAT_LIST[x].name;
00563          break;
00564       }
00565    }
00566    return ret;
00567 }

char* ast_getformatname_multiple ( char *  buf,
size_t  size,
int  format 
)

Get the names of a set of formats.

Parameters:
buf a buffer for the output string
size size of buf (bytes)
format the format (combined IDs of codecs) Prints a list of readable codec names corresponding to "format". ex: for format=AST_FORMAT_GSM|AST_FORMAT_SPEEX|AST_FORMAT_ILBC it will return "0x602 (GSM|SPEEX|ILBC)"
Returns:
The return value is buf.

Definition at line 569 of file frame.c.

References ARRAY_LEN, ast_copy_string(), ast_format_list::bits, len(), and name.

Referenced by __ast_read(), _sip_show_peer(), add_sdp(), ast_streamfile(), function_iaxpeer(), function_sippeer(), gtalk_is_answered(), gtalk_newcall(), handle_cli_iax2_show_peer(), handle_showchan(), handle_skinny_show_line(), iax2_bridge(), process_sdp(), serialize_showchan(), set_format(), show_channels_cb(), sip_new(), sip_request_call(), sip_show_channel(), sip_show_settings(), and sip_write().

00570 {
00571    int x;
00572    unsigned len;
00573    char *start, *end = buf;
00574 
00575    if (!size)
00576       return buf;
00577    snprintf(end, size, "0x%x (", format);
00578    len = strlen(end);
00579    end += len;
00580    size -= len;
00581    start = end;
00582    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
00583       if (AST_FORMAT_LIST[x].bits & format) {
00584          snprintf(end, size,"%s|",AST_FORMAT_LIST[x].name);
00585          len = strlen(end);
00586          end += len;
00587          size -= len;
00588       }
00589    }
00590    if (start == end)
00591       ast_copy_string(start, "nothing)", size);
00592    else if (size > 1)
00593       *(end -1) = ')';
00594    return buf;
00595 }

int ast_parse_allow_disallow ( struct ast_codec_pref pref,
int *  mask,
const char *  list,
int  allowing 
)

Parse an "allow" or "deny" line in a channel or device configuration and update the capabilities mask and pref if provided. Video codecs are not added to codec preference lists, since we can not transcode.

Returns:
Returns number of errors encountered during parsing

Definition at line 1216 of file frame.c.

References ast_codec_pref_append(), ast_codec_pref_remove(), ast_codec_pref_setsize(), ast_debug, AST_FORMAT_AUDIO_MASK, ast_getformatbyname(), ast_log(), ast_strdupa, format, LOG_WARNING, parse(), and strsep().

Referenced by action_originate(), apply_outgoing(), build_device(), build_peer(), build_user(), gtalk_create_member(), gtalk_load_config(), jingle_create_member(), jingle_load_config(), reload_config(), set_config(), and update_common_options().

01217 {
01218    int errors = 0;
01219    char *parse = NULL, *this = NULL, *psize = NULL;
01220    int format = 0, framems = 0;
01221 
01222    parse = ast_strdupa(list);
01223    while ((this = strsep(&parse, ","))) {
01224       framems = 0;
01225       if ((psize = strrchr(this, ':'))) {
01226          *psize++ = '\0';
01227          ast_debug(1, "Packetization for codec: %s is %s\n", this, psize);
01228          framems = atoi(psize);
01229          if (framems < 0) {
01230             framems = 0;
01231             errors++;
01232             ast_log(LOG_WARNING, "Bad packetization value for codec %s\n", this);
01233          }
01234       }
01235       if (!(format = ast_getformatbyname(this))) {
01236          ast_log(LOG_WARNING, "Cannot %s unknown format '%s'\n", allowing ? "allow" : "disallow", this);
01237          errors++;
01238          continue;
01239       }
01240 
01241       if (mask) {
01242          if (allowing)
01243             *mask |= format;
01244          else
01245             *mask &= ~format;
01246       }
01247 
01248       /* Set up a preference list for audio. Do not include video in preferences 
01249          since we can not transcode video and have to use whatever is offered
01250        */
01251       if (pref && (format & AST_FORMAT_AUDIO_MASK)) {
01252          if (strcasecmp(this, "all")) {
01253             if (allowing) {
01254                ast_codec_pref_append(pref, format);
01255                ast_codec_pref_setsize(pref, format, framems);
01256             }
01257             else
01258                ast_codec_pref_remove(pref, format);
01259          } else if (!allowing) {
01260             memset(pref, 0, sizeof(*pref));
01261          }
01262       }
01263    }
01264    return errors;
01265 }

void ast_smoother_free ( struct ast_smoother s  ) 

Definition at line 284 of file frame.c.

References ast_free.

Referenced by ast_rtp_destroy(), and ast_rtp_write().

00285 {
00286    ast_free(s);
00287 }

int ast_smoother_get_flags ( struct ast_smoother s  ) 

Definition at line 184 of file frame.c.

References ast_smoother::flags.

00185 {
00186    return s->flags;
00187 }

struct ast_smoother* ast_smoother_new ( int  size  )  [read]

Definition at line 174 of file frame.c.

References ast_malloc, ast_smoother_reset(), and s.

Referenced by ast_rtp_codec_setpref(), and ast_rtp_write().

00175 {
00176    struct ast_smoother *s;
00177    if (size < 1)
00178       return NULL;
00179    if ((s = ast_malloc(sizeof(*s))))
00180       ast_smoother_reset(s, size);
00181    return s;
00182 }

struct ast_frame* ast_smoother_read ( struct ast_smoother s  )  [read]

Definition at line 234 of file frame.c.

References ast_format_rate(), AST_FRAME_VOICE, AST_FRIENDLY_OFFSET, ast_log(), ast_samp2tv(), AST_SMOOTHER_FLAG_G729, ast_tvadd(), ast_tvzero(), ast_smoother::data, ast_frame::data, ast_frame::datalen, ast_smoother::delivery, ast_frame::delivery, ast_smoother::f, ast_smoother::flags, ast_smoother::format, ast_smoother::framedata, ast_frame::frametype, ast_smoother::len, len(), LOG_WARNING, ast_frame::offset, ast_smoother::opt, ast_frame::samples, ast_smoother::samplesperbyte, ast_smoother::size, and ast_frame::subclass.

Referenced by ast_rtp_write().

00235 {
00236    struct ast_frame *opt;
00237    int len;
00238 
00239    /* IF we have an optimization frame, send it */
00240    if (s->opt) {
00241       if (s->opt->offset < AST_FRIENDLY_OFFSET)
00242          ast_log(LOG_WARNING, "Returning a frame of inappropriate offset (%d).\n",
00243                      s->opt->offset);
00244       opt = s->opt;
00245       s->opt = NULL;
00246       return opt;
00247    }
00248 
00249    /* Make sure we have enough data */
00250    if (s->len < s->size) {
00251       /* Or, if this is a G.729 frame with VAD on it, send it immediately anyway */
00252       if (!((s->flags & AST_SMOOTHER_FLAG_G729) && (s->len % 10)))
00253          return NULL;
00254    }
00255    len = s->size;
00256    if (len > s->len)
00257       len = s->len;
00258    /* Make frame */
00259    s->f.frametype = AST_FRAME_VOICE;
00260    s->f.subclass = s->format;
00261    s->f.data = s->framedata + AST_FRIENDLY_OFFSET;
00262    s->f.offset = AST_FRIENDLY_OFFSET;
00263    s->f.datalen = len;
00264    /* Samples will be improper given VAD, but with VAD the concept really doesn't even exist */
00265    s->f.samples = len * s->samplesperbyte;   /* XXX rounding */
00266    s->f.delivery = s->delivery;
00267    /* Fill Data */
00268    memcpy(s->f.data, s->data, len);
00269    s->len -= len;
00270    /* Move remaining data to the front if applicable */
00271    if (s->len) {
00272       /* In principle this should all be fine because if we are sending
00273          G.729 VAD, the next timestamp will take over anyawy */
00274       memmove(s->data, s->data + len, s->len);
00275       if (!ast_tvzero(s->delivery)) {
00276          /* If we have delivery time, increment it, otherwise, leave it at 0 */
00277          s->delivery = ast_tvadd(s->delivery, ast_samp2tv(s->f.samples, ast_format_rate(s->format)));
00278       }
00279    }
00280    /* Return frame */
00281    return &s->f;
00282 }

void ast_smoother_reconfigure ( struct ast_smoother s,
int  bytes 
)

Reconfigure an existing smoother to output a different number of bytes per frame.

Parameters:
s the smoother to reconfigure
bytes the desired number of bytes per output frame
Returns:
nothing

Definition at line 152 of file frame.c.

References ast_smoother::opt, ast_smoother::opt_needs_swap, ast_smoother::size, and smoother_frame_feed().

Referenced by ast_rtp_codec_setpref().

00153 {
00154    /* if there is no change, then nothing to do */
00155    if (s->size == bytes) {
00156       return;
00157    }
00158    /* set the new desired output size */
00159    s->size = bytes;
00160    /* if there is no 'optimized' frame in the smoother,
00161     *   then there is nothing left to do
00162     */
00163    if (!s->opt) {
00164       return;
00165    }
00166    /* there is an 'optimized' frame here at the old size,
00167     * but it must now be put into the buffer so the data
00168     * can be extracted at the new size
00169     */
00170    smoother_frame_feed(s, s->opt, s->opt_needs_swap);
00171    s->opt = NULL;
00172 }

void ast_smoother_reset ( struct ast_smoother s,
int  bytes 
)

Definition at line 146 of file frame.c.

References ast_smoother::size.

Referenced by ast_smoother_new().

00147 {
00148    memset(s, 0, sizeof(*s));
00149    s->size = bytes;
00150 }

void ast_smoother_set_flags ( struct ast_smoother s,
int  flags 
)

Definition at line 189 of file frame.c.

References ast_smoother::flags.

Referenced by ast_rtp_codec_setpref(), and ast_rtp_write().

00190 {
00191    s->flags = flags;
00192 }

int ast_smoother_test_flag ( struct ast_smoother s,
int  flag 
)

Definition at line 194 of file frame.c.

References ast_smoother::flags.

Referenced by ast_rtp_write().

00195 {
00196    return (s->flags & flag);
00197 }

void ast_swapcopy_samples ( void *  dst,
const void *  src,
int  samples 
)

Definition at line 534 of file frame.c.

Referenced by __ast_smoother_feed(), iax_frame_wrap(), phone_write_buf(), and smoother_frame_feed().

00535 {
00536    int i;
00537    unsigned short *dst_s = dst;
00538    const unsigned short *src_s = src;
00539 
00540    for (i = 0; i < samples; i++)
00541       dst_s[i] = (src_s[i]<<8) | (src_s[i]>>8);
00542 }

static void frame_cache_cleanup ( void *  data  )  [static]

Definition at line 319 of file frame.c.

References ast_free, AST_LIST_REMOVE_HEAD, f, ast_frame::frame_list, frames, and ast_frame_cache::list.

00320 {
00321    struct ast_frame_cache *frames = data;
00322    struct ast_frame *f;
00323 
00324    while ((f = AST_LIST_REMOVE_HEAD(&frames->list, frame_list)))
00325       ast_free(f);
00326    
00327    ast_free(frames);
00328 }

static int g723_len ( unsigned char  buf  )  [static]

Definition at line 1267 of file frame.c.

References ast_log(), LOG_WARNING, type, TYPE_DONTSEND, TYPE_HIGH, TYPE_LOW, TYPE_MASK, and TYPE_SILENCE.

Referenced by g723_samples().

01268 {
01269    enum frame_type type = buf & TYPE_MASK;
01270 
01271    switch(type) {
01272    case TYPE_DONTSEND:
01273       return 0;
01274       break;
01275    case TYPE_SILENCE:
01276       return 4;
01277       break;
01278    case TYPE_HIGH:
01279       return 24;
01280       break;
01281    case TYPE_LOW:
01282       return 20;
01283       break;
01284    default:
01285       ast_log(LOG_WARNING, "Badly encoded frame (%d)\n", type);
01286    }
01287    return -1;
01288 }

static int g723_samples ( unsigned char *  buf,
int  maxlen 
) [static]

Definition at line 1290 of file frame.c.

References g723_len().

Referenced by ast_codec_get_samples().

01291 {
01292    int pos = 0;
01293    int samples = 0;
01294    int res;
01295    while(pos < maxlen) {
01296       res = g723_len(buf[pos]);
01297       if (res <= 0)
01298          break;
01299       samples += 240;
01300       pos += res;
01301    }
01302    return samples;
01303 }

static unsigned char get_n_bits_at ( unsigned char *  data,
int  n,
int  bit 
) [static]

Definition at line 1305 of file frame.c.

Referenced by speex_get_wb_sz_at(), and speex_samples().

01306 {
01307    int byte = bit / 8;       /* byte containing first bit */
01308    int rem = 8 - (bit % 8);  /* remaining bits in first byte */
01309    unsigned char ret = 0;
01310    
01311    if (n <= 0 || n > 8)
01312       return 0;
01313 
01314    if (rem < n) {
01315       ret = (data[byte] << (n - rem));
01316       ret |= (data[byte + 1] >> (8 - n + rem));
01317    } else {
01318       ret = (data[byte] >> (rem - n));
01319    }
01320 
01321    return (ret & (0xff >> (8 - n)));
01322 }

int init_framer ( void   ) 

Provided by frame.c

Definition at line 949 of file frame.c.

References ast_cli_register_multiple().

Referenced by main().

00950 {
00951    ast_cli_register_multiple(my_clis, sizeof(my_clis) / sizeof(struct ast_cli_entry));
00952    return 0;   
00953 }

static char* show_codec_n ( struct ast_cli_entry e,
int  cmd,
struct ast_cli_args a 
) [static]

Definition at line 703 of file frame.c.

References ast_cli_args::argc, ast_cli_args::argv, ast_cli(), ast_codec2str(), CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_cli_args::fd, and ast_cli_entry::usage.

00704 {
00705    int codec, i, found=0;
00706 
00707    switch (cmd) {
00708    case CLI_INIT:
00709       e->command = "core show codec";
00710       e->usage = 
00711          "Usage: core show codec <number>\n"
00712          "       Displays codec mapping\n";
00713       return NULL;
00714    case CLI_GENERATE:
00715       return NULL;
00716    }
00717 
00718    if (a->argc != 4)
00719       return CLI_SHOWUSAGE;
00720 
00721    if (sscanf(a->argv[3], "%30d", &codec) != 1)
00722       return CLI_SHOWUSAGE;
00723 
00724    for (i = 0; i < 32; i++)
00725       if (codec & (1 << i)) {
00726          found = 1;
00727          ast_cli(a->fd, "%11u (1 << %2d)  %s\n",1 << i,i,ast_codec2str(1<<i));
00728       }
00729 
00730    if (!found)
00731       ast_cli(a->fd, "Codec %d not found\n", codec);
00732 
00733    return CLI_SUCCESS;
00734 }

static char* show_codecs ( struct ast_cli_entry e,
int  cmd,
struct ast_cli_args a 
) [static]

Definition at line 648 of file frame.c.

References ast_cli_args::argc, ast_cli_args::argv, ast_cli(), ast_codec2str(), ast_getformatname(), ast_opt_dont_warn, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_cli_args::fd, and ast_cli_entry::usage.

00649 {
00650    int i, found=0;
00651    char hex[25];
00652 
00653    switch (cmd) {
00654    case CLI_INIT:
00655       e->command = "core show codecs [audio|video|image]";
00656       e->usage = 
00657          "Usage: core show codecs [audio|video|image]\n"
00658          "       Displays codec mapping\n";
00659       return NULL;
00660    case CLI_GENERATE:
00661       return NULL;
00662    }
00663    
00664    if ((a->argc < 3) || (a->argc > 4))
00665       return CLI_SHOWUSAGE;
00666 
00667    if (!ast_opt_dont_warn)
00668       ast_cli(a->fd, "Disclaimer: this command is for informational purposes only.\n"
00669             "\tIt does not indicate anything about your configuration.\n");
00670 
00671    ast_cli(a->fd, "%11s %9s %10s   TYPE   %8s   %s\n","INT","BINARY","HEX","NAME","DESC");
00672    ast_cli(a->fd, "--------------------------------------------------------------------------------\n");
00673    if ((a->argc == 3) || (!strcasecmp(a->argv[3],"audio"))) {
00674       found = 1;
00675       for (i=0;i<13;i++) {
00676          snprintf(hex,25,"(0x%x)",1<<i);
00677          ast_cli(a->fd, "%11u (1 << %2d) %10s  audio   %8s   (%s)\n",1 << i,i,hex,ast_getformatname(1<<i),ast_codec2str(1<<i));
00678       }
00679    }
00680 
00681    if ((a->argc == 3) || (!strcasecmp(a->argv[3],"image"))) {
00682       found = 1;
00683       for (i=16;i<18;i++) {
00684          snprintf(hex,25,"(0x%x)",1<<i);
00685          ast_cli(a->fd, "%11u (1 << %2d) %10s  image   %8s   (%s)\n",1 << i,i,hex,ast_getformatname(1<<i),ast_codec2str(1<<i));
00686       }
00687    }
00688 
00689    if ((a->argc == 3) || (!strcasecmp(a->argv[3],"video"))) {
00690       found = 1;
00691       for (i=18;i<22;i++) {
00692          snprintf(hex,25,"(0x%x)",1<<i);
00693          ast_cli(a->fd, "%11u (1 << %2d) %10s  video   %8s   (%s)\n",1 << i,i,hex,ast_getformatname(1<<i),ast_codec2str(1<<i));
00694       }
00695    }
00696 
00697    if (!found)
00698       return CLI_SHOWUSAGE;
00699    else
00700       return CLI_SUCCESS;
00701 }

static int smoother_frame_feed ( struct ast_smoother s,
struct ast_frame f,
int  swap 
) [static]

Definition at line 124 of file frame.c.

References ast_log(), AST_SMOOTHER_FLAG_G729, ast_swapcopy_samples(), ast_tvzero(), ast_frame::data, ast_smoother::data, ast_frame::datalen, ast_smoother::delivery, ast_frame::delivery, ast_smoother::flags, ast_smoother::len, LOG_NOTICE, and ast_frame::samples.

Referenced by __ast_smoother_feed(), and ast_smoother_reconfigure().

00125 {
00126    if (s->flags & AST_SMOOTHER_FLAG_G729) {
00127       if (s->len % 10) {
00128          ast_log(LOG_NOTICE, "Dropping extra frame of G.729 since we already have a VAD frame at the end\n");
00129          return 0;
00130       }
00131    }
00132    if (swap) {
00133       ast_swapcopy_samples(s->data + s->len, f->data, f->samples);
00134    } else {
00135       memcpy(s->data + s->len, f->data, f->datalen);
00136    }
00137    /* If either side is empty, reset the delivery time */
00138    if (!s->len || ast_tvzero(f->delivery) || ast_tvzero(s->delivery)) { /* XXX really ? */
00139       s->delivery = f->delivery;
00140    }
00141    s->len += f->datalen;
00142 
00143    return 0;
00144 }

static int speex_get_wb_sz_at ( unsigned char *  data,
int  len,
int  bit 
) [static]

Definition at line 1324 of file frame.c.

References ast_log(), get_n_bits_at(), and LOG_WARNING.

Referenced by speex_samples().

01325 {
01326    static int SpeexWBSubModeSz[] = {
01327       0, 36, 112, 192,
01328       352, 0, 0, 0 };
01329    int off = bit;
01330    unsigned char c;
01331 
01332    /* skip up to two wideband frames */
01333    if (((len * 8 - off) >= 5) && 
01334       get_n_bits_at(data, 1, off)) {
01335       c = get_n_bits_at(data, 3, off + 1);
01336       off += SpeexWBSubModeSz[c];
01337 
01338       if (((len * 8 - off) >= 5) && 
01339          get_n_bits_at(data, 1, off)) {
01340          c = get_n_bits_at(data, 3, off + 1);
01341          off += SpeexWBSubModeSz[c];
01342 
01343          if (((len * 8 - off) >= 5) && 
01344             get_n_bits_at(data, 1, off)) {
01345             ast_log(LOG_WARNING, "Encountered corrupt speex frame; too many wideband frames in a row.\n");
01346             return -1;
01347          }
01348       }
01349 
01350    }
01351    return off - bit;
01352 }

static int speex_samples ( unsigned char *  data,
int  len 
) [static]

Definition at line 1354 of file frame.c.

References ast_log(), get_n_bits_at(), LOG_WARNING, and speex_get_wb_sz_at().

Referenced by ast_codec_get_samples().

01355 {
01356    static int SpeexSubModeSz[] = {
01357       5, 43, 119, 160,
01358       220, 300, 364, 492, 
01359       79, 0, 0, 0,
01360       0, 0, 0, 0 };
01361    static int SpeexInBandSz[] = { 
01362       1, 1, 4, 4,
01363       4, 4, 4, 4,
01364       8, 8, 16, 16,
01365       32, 32, 64, 64 };
01366    int bit = 0;
01367    int cnt = 0;
01368    int off;
01369    unsigned char c;
01370 
01371    while ((len * 8 - bit) >= 5) {
01372       /* skip wideband frames */
01373       off = speex_get_wb_sz_at(data, len, bit);
01374       if (off < 0)  {
01375          ast_log(LOG_WARNING, "Had error while reading wideband frames for speex samples\n");
01376          break;
01377       }
01378       bit += off;
01379 
01380       if ((len * 8 - bit) < 5) {
01381          ast_log(LOG_WARNING, "Not enough bits remaining after wide band for speex samples.\n");
01382          break;
01383       }
01384 
01385       /* get control bits */
01386       c = get_n_bits_at(data, 5, bit);
01387       bit += 5;
01388 
01389       if (c == 15) { 
01390          /* terminator */
01391          break; 
01392       } else if (c == 14) {
01393          /* in-band signal; next 4 bits contain signal id */
01394          c = get_n_bits_at(data, 4, bit);
01395          bit += 4;
01396          bit += SpeexInBandSz[c];
01397       } else if (c == 13) {
01398          /* user in-band; next 5 bits contain msg len */
01399          c = get_n_bits_at(data, 5, bit);
01400          bit += 5;
01401          bit += c * 8;
01402       } else if (c > 8) {
01403          /* unknown */
01404          break;
01405       } else {
01406          /* skip number bits for submode (less the 5 control bits) */
01407          bit += SpeexSubModeSz[c] - 5;
01408          cnt += 160; /* new frame */
01409       }
01410    }
01411    return cnt;
01412 }


Variable Documentation

struct ast_format_list AST_FORMAT_LIST[] [static]

Definition of supported media formats (codecs).

Definition at line 97 of file frame.c.

struct ast_frame ast_null_frame = { AST_FRAME_NULL, }

struct ast_threadstorage frame_cache = { .once = PTHREAD_ONCE_INIT, .key_init = __init_frame_cache , .custom_init = NULL , } [static]

Definition at line 47 of file frame.c.

Referenced by __frame_free(), ast_frame_header_new(), ast_frdup(), iax_frame_free(), and iax_frame_new().

struct ast_cli_entry my_clis[] [static]

Initial value:

 {
   AST_CLI_DEFINE(show_codecs, "Displays a list of codecs"),
   AST_CLI_DEFINE(show_codec_n, "Shows a specific codec"),
}

Definition at line 944 of file frame.c.


Generated on Wed Oct 28 11:46:09 2009 for Asterisk - the Open Source PBX by  doxygen 1.5.6