Wed Mar 3 22:56:25 2010

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_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)
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 idx)
 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 idx)
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.
 AST_LIST_HEAD_NOLOCK (ast_frames, ast_frame)
 This is just so ast_frames, a list head struct for holding a list of ast_frame structures, is defined.
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)
 AST_THREADSTORAGE_CUSTOM (frame_cache, NULL, frame_cache_cleanup)
 A per-thread cache of frame headers.
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_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(), iax_frame_free(), and iax_frame_new().

#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::ptr, 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.ptr, f->data.ptr, 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_dsp_frame_freed(), ast_filestream_frame_freed(), ast_free, AST_FRFLAG_FROM_DSP, AST_FRFLAG_FROM_FILESTREAM, AST_FRFLAG_FROM_TRANSLATOR, AST_LIST_INSERT_HEAD, AST_MALLOCD_DATA, AST_MALLOCD_HDR, AST_MALLOCD_SRC, ast_test_flag, ast_threadstorage_get(), ast_translate_frame_freed(), ast_frame::data, frame_cache, FRAME_CACHE_MAX_SIZE, frames, ast_frame_cache::list, ast_frame::mallocd, ast_frame::offset, ast_frame::ptr, ast_frame_cache::size, and ast_frame::src.

Referenced by ast_frame_free().

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

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 648 of file frame.c.

References ARRAY_LEN, and ast_format_list::desc.

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

00649 {
00650    int x;
00651    char *ret = "unknown";
00652    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
00653       if (AST_FORMAT_LIST[x].bits == codec) {
00654          ret = AST_FORMAT_LIST[x].desc;
00655          break;
00656       }
00657    }
00658    return ret;
00659 }

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 1205 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().

01206 {
01207    int x, ret = 0, slot;
01208 
01209    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01210       slot = pref->order[x];
01211 
01212       if (!slot)
01213          break;
01214       if (formats & AST_FORMAT_LIST[slot-1].bits) {
01215          ret = AST_FORMAT_LIST[slot-1].bits;
01216          break;
01217       }
01218    }
01219    if (ret & AST_FORMAT_AUDIO_MASK)
01220       return ret;
01221 
01222    ast_debug(4, "Could not find preferred codec - %s\n", find_best ? "Going for the best codec" : "Returning zero codec");
01223 
01224       return find_best ? ast_best_codec(formats) : 0;
01225 }

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 1469 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().

01470 {
01471    int len = 0;
01472 
01473    /* XXX Still need speex, g723, and lpc10 XXX */ 
01474    switch(format) {
01475    case AST_FORMAT_G723_1:
01476       len = (samples / 240) * 20;
01477       break;
01478    case AST_FORMAT_ILBC:
01479       len = (samples / 240) * 50;
01480       break;
01481    case AST_FORMAT_GSM:
01482       len = (samples / 160) * 33;
01483       break;
01484    case AST_FORMAT_G729A:
01485       len = samples / 8;
01486       break;
01487    case AST_FORMAT_SLINEAR:
01488    case AST_FORMAT_SLINEAR16:
01489       len = samples * 2;
01490       break;
01491    case AST_FORMAT_ULAW:
01492    case AST_FORMAT_ALAW:
01493       len = samples;
01494       break;
01495    case AST_FORMAT_G722:
01496    case AST_FORMAT_ADPCM:
01497    case AST_FORMAT_G726:
01498    case AST_FORMAT_G726_AAL2:
01499       len = samples / 2;
01500       break;
01501    default:
01502       ast_log(LOG_WARNING, "Unable to calculate sample length for format %s\n", ast_getformatname(format));
01503    }
01504 
01505    return len;
01506 }

int ast_codec_get_samples ( struct ast_frame f  ) 

Returns the number of samples contained in the frame.

Definition at line 1425 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, ast_frame::ptr, speex_samples(), and ast_frame::subclass.

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

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

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 1065 of file frame.c.

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

Referenced by ast_parse_allow_disallow().

01066 {
01067    int x, newindex = 0;
01068 
01069    ast_codec_pref_remove(pref, format);
01070 
01071    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01072       if (AST_FORMAT_LIST[x].bits == format) {
01073          newindex = x + 1;
01074          break;
01075       }
01076    }
01077 
01078    if (newindex) {
01079       for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01080          if (!pref->order[x]) {
01081             pref->order[x] = newindex;
01082             break;
01083          }
01084       }
01085    }
01086 
01087    return x;
01088 }

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 968 of file frame.c.

References ast_codec_pref::order.

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

00969 {
00970    int x, differential = (int) 'A', mem;
00971    char *from, *to;
00972 
00973    if (right) {
00974       from = pref->order;
00975       to = buf;
00976       mem = size;
00977    } else {
00978       to = pref->order;
00979       from = buf;
00980       mem = 32;
00981    }
00982 
00983    memset(to, 0, mem);
00984    for (x = 0; x < 32 ; x++) {
00985       if (!from[x])
00986          break;
00987       to[x] = right ? (from[x] + differential) : (from[x] - differential);
00988    }
00989 }

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

Get packet size for codec.

Definition at line 1166 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().

01167 {
01168    int x, idx = -1, framems = 0;
01169    struct ast_format_list fmt = { 0, };
01170 
01171    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01172       if (AST_FORMAT_LIST[x].bits == format) {
01173          fmt = AST_FORMAT_LIST[x];
01174          idx = x;
01175          break;
01176       }
01177    }
01178 
01179    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01180       if (pref->order[x] == (idx + 1)) {
01181          framems = pref->framing[x];
01182          break;
01183       }
01184    }
01185 
01186    /* size validation */
01187    if (!framems)
01188       framems = AST_FORMAT_LIST[idx].def_ms;
01189 
01190    if (AST_FORMAT_LIST[idx].inc_ms && framems % AST_FORMAT_LIST[idx].inc_ms) /* avoid division by zero */
01191       framems -= framems % AST_FORMAT_LIST[idx].inc_ms;
01192 
01193    if (framems < AST_FORMAT_LIST[idx].min_ms)
01194       framems = AST_FORMAT_LIST[idx].min_ms;
01195 
01196    if (framems > AST_FORMAT_LIST[idx].max_ms)
01197       framems = AST_FORMAT_LIST[idx].max_ms;
01198 
01199    fmt.cur_ms = framems;
01200 
01201    return fmt;
01202 }

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 1026 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().

01027 {
01028    int slot = 0;
01029 
01030    if ((idx >= 0) && (idx < sizeof(pref->order))) {
01031       slot = pref->order[idx];
01032    }
01033 
01034    return slot ? AST_FORMAT_LIST[slot - 1].bits : 0;
01035 }

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 1091 of file frame.c.

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

Referenced by create_addr().

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

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 1038 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().

01039 {
01040    struct ast_codec_pref oldorder;
01041    int x, y = 0;
01042    int slot;
01043    int size;
01044 
01045    if (!pref->order[0])
01046       return;
01047 
01048    memcpy(&oldorder, pref, sizeof(oldorder));
01049    memset(pref, 0, sizeof(*pref));
01050 
01051    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01052       slot = oldorder.order[x];
01053       size = oldorder.framing[x];
01054       if (! slot)
01055          break;
01056       if (AST_FORMAT_LIST[slot-1].bits != format) {
01057          pref->order[y] = slot;
01058          pref->framing[y++] = size;
01059       }
01060    }
01061    
01062 }

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

Set packet size for codec.

Definition at line 1128 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().

01129 {
01130    int x, idx = -1;
01131 
01132    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01133       if (AST_FORMAT_LIST[x].bits == format) {
01134          idx = x;
01135          break;
01136       }
01137    }
01138 
01139    if (idx < 0)
01140       return -1;
01141 
01142    /* size validation */
01143    if (!framems)
01144       framems = AST_FORMAT_LIST[idx].def_ms;
01145 
01146    if (AST_FORMAT_LIST[idx].inc_ms && framems % AST_FORMAT_LIST[idx].inc_ms) /* avoid division by zero */
01147       framems -= framems % AST_FORMAT_LIST[idx].inc_ms;
01148 
01149    if (framems < AST_FORMAT_LIST[idx].min_ms)
01150       framems = AST_FORMAT_LIST[idx].min_ms;
01151 
01152    if (framems > AST_FORMAT_LIST[idx].max_ms)
01153       framems = AST_FORMAT_LIST[idx].max_ms;
01154 
01155    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
01156       if (pref->order[x] == (idx + 1)) {
01157          pref->framing[x] = framems;
01158          break;
01159       }
01160    }
01161 
01162    return x;
01163 }

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 991 of file frame.c.

References ast_codec_pref_index(), and ast_getformatname().

Referenced by dump_prefs(), and socket_process().

00992 {
00993    int x, codec; 
00994    size_t total_len, slen;
00995    char *formatname;
00996    
00997    memset(buf,0,size);
00998    total_len = size;
00999    buf[0] = '(';
01000    total_len--;
01001    for(x = 0; x < 32 ; x++) {
01002       if (total_len <= 0)
01003          break;
01004       if (!(codec = ast_codec_pref_index(pref,x)))
01005          break;
01006       if ((formatname = ast_getformatname(codec))) {
01007          slen = strlen(formatname);
01008          if (slen > total_len)
01009             break;
01010          strncat(buf, formatname, total_len - 1); /* safe */
01011          total_len -= slen;
01012       }
01013       if (total_len && x < 31 && ast_codec_pref_index(pref , x + 1)) {
01014          strncat(buf, "|", total_len - 1); /* safe */
01015          total_len--;
01016       }
01017    }
01018    if (total_len) {
01019       strncat(buf, ")", total_len - 1); /* safe */
01020       total_len--;
01021    }
01022 
01023    return size - total_len;
01024 }

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

Definition at line 619 of file frame.c.

References ARRAY_LEN.

Referenced by ast_getformatbyname().

00620 {
00621    int x;
00622 
00623    for (x = 0; x < ARRAY_LEN(ast_codec_alias_table); x++) {
00624       if (!strcmp(in,ast_codec_alias_table[x].alias))
00625          return ast_codec_alias_table[x].realname;
00626    }
00627    return in;
00628 }

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 1508 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::ptr, ast_frame::samples, and ast_frame::subclass.

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

01509 {
01510    int count;
01511    short *fdata = f->data.ptr;
01512    short adjust_value = abs(adjustment);
01513 
01514    if ((f->frametype != AST_FRAME_VOICE) || (f->subclass != AST_FORMAT_SLINEAR))
01515       return -1;
01516 
01517    if (!adjustment)
01518       return 0;
01519 
01520    for (count = 0; count < f->samples; count++) {
01521       if (adjustment > 0) {
01522          ast_slinear_saturated_multiply(&fdata[count], &adjust_value);
01523       } else if (adjustment < 0) {
01524          ast_slinear_saturated_divide(&fdata[count], &adjust_value);
01525       }
01526    }
01527 
01528    return 0;
01529 }

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

Dump a frame for debugging purposes

Definition at line 750 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_frame::ptr, ast_control_t38_parameters::request_response, ast_frame::subclass, and term_color().

Referenced by __ast_read(), and ast_write().

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

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 373 of file frame.c.

References __frame_free(), and AST_LIST_NEXT.

Referenced by mixmonitor_thread().

00374 {
00375    struct ast_frame *next;
00376 
00377    for (next = AST_LIST_NEXT(frame, frame_list);
00378         frame;
00379         frame = next, next = frame ? AST_LIST_NEXT(frame, frame_list) : NULL) {
00380       __frame_free(frame, cache);
00381    }
00382 }

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 1531 of file frame.c.

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

01532 {
01533    int count;
01534    short *data1, *data2;
01535 
01536    if ((f1->frametype != AST_FRAME_VOICE) || (f1->subclass != AST_FORMAT_SLINEAR))
01537       return -1;
01538 
01539    if ((f2->frametype != AST_FRAME_VOICE) || (f2->subclass != AST_FORMAT_SLINEAR))
01540       return -1;
01541 
01542    if (f1->samples != f2->samples)
01543       return -1;
01544 
01545    for (count = 0, data1 = f1->data.ptr, data2 = f2->data.ptr;
01546         count < f1->samples;
01547         count++, data1++, data2++)
01548       ast_slinear_saturated_add(data1, data2);
01549 
01550    return 0;
01551 }

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 470 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::ptr, ast_frame::samples, ast_frame::seqno, ast_frame_cache::size, ast_frame::src, ast_frame::subclass, ast_frame::ts, and ast_frame::uint32.

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(), recordthread(), rpt(), and rpt_exec().

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

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 389 of file frame.c.

References ast_clear_flag, ast_copy_flags, ast_frame_header_new(), ast_frdup(), ast_free, AST_FRFLAG_FROM_DSP, AST_FRFLAG_FROM_FILESTREAM, AST_FRFLAG_FROM_TRANSLATOR, 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::ptr, ast_frame::samples, ast_frame::seqno, ast_frame::src, ast_frame::subclass, and ast_frame::ts.

Referenced by __ast_answer(), ast_slinfactory_feed(), autoservice_run(), and jpeg_read_image().

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

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

Definition at line 563 of file frame.c.

References ARRAY_LEN.

00564 {
00565    *size = ARRAY_LEN(AST_FORMAT_LIST);
00566    return AST_FORMAT_LIST;
00567 }

struct ast_format_list* ast_get_format_list_index ( int  idx  )  [read]

Definition at line 558 of file frame.c.

00559 {
00560    return &AST_FORMAT_LIST[idx];
00561 }

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 630 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().

00631 {
00632    int x, all, format = 0;
00633 
00634    all = strcasecmp(name, "all") ? 0 : 1;
00635    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
00636       if (all || 
00637            !strcasecmp(AST_FORMAT_LIST[x].name,name) ||
00638            !strcasecmp(AST_FORMAT_LIST[x].name, ast_expand_codec_alias(name))) {
00639          format |= AST_FORMAT_LIST[x].bits;
00640          if (!all)
00641             break;
00642       }
00643    }
00644 
00645    return format;
00646 }

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 569 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().

00570 {
00571    int x;
00572    char *ret = "unknown";
00573    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
00574       if (AST_FORMAT_LIST[x].bits == format) {
00575          ret = AST_FORMAT_LIST[x].name;
00576          break;
00577       }
00578    }
00579    return ret;
00580 }

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 582 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().

00583 {
00584    int x;
00585    unsigned len;
00586    char *start, *end = buf;
00587 
00588    if (!size)
00589       return buf;
00590    snprintf(end, size, "0x%x (", format);
00591    len = strlen(end);
00592    end += len;
00593    size -= len;
00594    start = end;
00595    for (x = 0; x < ARRAY_LEN(AST_FORMAT_LIST); x++) {
00596       if (AST_FORMAT_LIST[x].bits & format) {
00597          snprintf(end, size,"%s|",AST_FORMAT_LIST[x].name);
00598          len = strlen(end);
00599          end += len;
00600          size -= len;
00601       }
00602    }
00603    if (start == end)
00604       ast_copy_string(start, "nothing)", size);
00605    else if (size > 1)
00606       *(end -1) = ')';
00607    return buf;
00608 }

AST_LIST_HEAD_NOLOCK ( ast_frames  ,
ast_frame   
)

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

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 1227 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().

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

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::ptr, 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.ptr = 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.ptr, 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 547 of file frame.c.

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

00548 {
00549    int i;
00550    unsigned short *dst_s = dst;
00551    const unsigned short *src_s = src;
00552 
00553    for (i = 0; i < samples; i++)
00554       dst_s[i] = (src_s[i]<<8) | (src_s[i]>>8);
00555 }

AST_THREADSTORAGE_CUSTOM ( frame_cache  ,
NULL  ,
frame_cache_cleanup   
)

A per-thread cache of frame headers.

static void frame_cache_cleanup ( void *  data  )  [static]

Definition at line 319 of file frame.c.

References ast_free, AST_LIST_REMOVE_HEAD, f, 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 1278 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().

01279 {
01280    enum frame_type type = buf & TYPE_MASK;
01281 
01282    switch(type) {
01283    case TYPE_DONTSEND:
01284       return 0;
01285       break;
01286    case TYPE_SILENCE:
01287       return 4;
01288       break;
01289    case TYPE_HIGH:
01290       return 24;
01291       break;
01292    case TYPE_LOW:
01293       return 20;
01294       break;
01295    default:
01296       ast_log(LOG_WARNING, "Badly encoded frame (%d)\n", type);
01297    }
01298    return -1;
01299 }

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

Definition at line 1301 of file frame.c.

References g723_len().

Referenced by ast_codec_get_samples().

01302 {
01303    int pos = 0;
01304    int samples = 0;
01305    int res;
01306    while(pos < maxlen) {
01307       res = g723_len(buf[pos]);
01308       if (res <= 0)
01309          break;
01310       samples += 240;
01311       pos += res;
01312    }
01313    return samples;
01314 }

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

Definition at line 1316 of file frame.c.

Referenced by speex_get_wb_sz_at(), and speex_samples().

01317 {
01318    int byte = bit / 8;       /* byte containing first bit */
01319    int rem = 8 - (bit % 8);  /* remaining bits in first byte */
01320    unsigned char ret = 0;
01321    
01322    if (n <= 0 || n > 8)
01323       return 0;
01324 
01325    if (rem < n) {
01326       ret = (data[byte] << (n - rem));
01327       ret |= (data[byte + 1] >> (8 - n + rem));
01328    } else {
01329       ret = (data[byte] >> (rem - n));
01330    }
01331 
01332    return (ret & (0xff >> (8 - n)));
01333 }

int init_framer ( void   ) 

Provided by frame.c

Definition at line 962 of file frame.c.

References ast_cli_register_multiple().

Referenced by main().

00963 {
00964    ast_cli_register_multiple(my_clis, sizeof(my_clis) / sizeof(struct ast_cli_entry));
00965    return 0;   
00966 }

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

Definition at line 716 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.

00717 {
00718    int codec, i, found=0;
00719 
00720    switch (cmd) {
00721    case CLI_INIT:
00722       e->command = "core show codec";
00723       e->usage = 
00724          "Usage: core show codec <number>\n"
00725          "       Displays codec mapping\n";
00726       return NULL;
00727    case CLI_GENERATE:
00728       return NULL;
00729    }
00730 
00731    if (a->argc != 4)
00732       return CLI_SHOWUSAGE;
00733 
00734    if (sscanf(a->argv[3], "%30d", &codec) != 1)
00735       return CLI_SHOWUSAGE;
00736 
00737    for (i = 0; i < 32; i++)
00738       if (codec & (1 << i)) {
00739          found = 1;
00740          ast_cli(a->fd, "%11u (1 << %2d)  %s\n",1 << i,i,ast_codec2str(1<<i));
00741       }
00742 
00743    if (!found)
00744       ast_cli(a->fd, "Codec %d not found\n", codec);
00745 
00746    return CLI_SUCCESS;
00747 }

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

Definition at line 661 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.

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

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, ast_frame::ptr, 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.ptr, f->samples);
00134    } else {
00135       memcpy(s->data + s->len, f->data.ptr, 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 1335 of file frame.c.

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

Referenced by speex_samples().

01336 {
01337    static int SpeexWBSubModeSz[] = {
01338       0, 36, 112, 192,
01339       352, 0, 0, 0 };
01340    int off = bit;
01341    unsigned char c;
01342 
01343    /* skip up to two wideband frames */
01344    if (((len * 8 - off) >= 5) && 
01345       get_n_bits_at(data, 1, off)) {
01346       c = get_n_bits_at(data, 3, off + 1);
01347       off += SpeexWBSubModeSz[c];
01348 
01349       if (((len * 8 - off) >= 5) && 
01350          get_n_bits_at(data, 1, off)) {
01351          c = get_n_bits_at(data, 3, off + 1);
01352          off += SpeexWBSubModeSz[c];
01353 
01354          if (((len * 8 - off) >= 5) && 
01355             get_n_bits_at(data, 1, off)) {
01356             ast_log(LOG_WARNING, "Encountered corrupt speex frame; too many wideband frames in a row.\n");
01357             return -1;
01358          }
01359       }
01360 
01361    }
01362    return off - bit;
01363 }

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

Definition at line 1365 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().

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


Variable Documentation

struct ast_format_list AST_FORMAT_LIST[] [static]

Definition of supported media formats (codecs).

Definition at line 96 of file frame.c.

struct ast_frame ast_null_frame = { AST_FRAME_NULL, }
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 957 of file frame.c.


Generated on 3 Mar 2010 for Asterisk - the Open Source PBX by  doxygen 1.6.1