Thu May 14 14:49:11 2009

Asterisk developer's documentation


slinfactory.c

Go to the documentation of this file.
00001 /*
00002  * Asterisk -- An open source telephony toolkit.
00003  *
00004  * Copyright (C) 2005, Anthony Minessale II.
00005  *
00006  * Anthony Minessale <anthmct@yahoo.com>
00007  *
00008  * See http://www.asterisk.org for more information about
00009  * the Asterisk project. Please do not directly contact
00010  * any of the maintainers of this project for assistance;
00011  * the project provides a web site, mailing lists and IRC
00012  * channels for your use.
00013  *
00014  * This program is free software, distributed under the terms of
00015  * the GNU General Public License Version 2. See the LICENSE file
00016  * at the top of the source tree.
00017  */
00018 
00019 /*! \file
00020  *
00021  * \brief A machine to gather up arbitrary frames and convert them
00022  * to raw slinear on demand.
00023  *
00024  * \author Anthony Minessale <anthmct@yahoo.com>
00025  */
00026 
00027 #include "asterisk.h"
00028 
00029 ASTERISK_FILE_VERSION(__FILE__, "$Revision: 171621 $")
00030 
00031 #include <string.h>
00032 
00033 #include "asterisk/frame.h"
00034 #include "asterisk/slinfactory.h"
00035 #include "asterisk/logger.h"
00036 #include "asterisk/translate.h"
00037 
00038 void ast_slinfactory_init(struct ast_slinfactory *sf) 
00039 {
00040    memset(sf, 0, sizeof(*sf));
00041    sf->offset = sf->hold;
00042 }
00043 
00044 void ast_slinfactory_destroy(struct ast_slinfactory *sf) 
00045 {
00046    struct ast_frame *f;
00047 
00048    if (sf->trans) {
00049       ast_translator_free_path(sf->trans);
00050       sf->trans = NULL;
00051    }
00052 
00053    while ((f = AST_LIST_REMOVE_HEAD(&sf->queue, frame_list)))
00054       ast_frfree(f);
00055 }
00056 
00057 int ast_slinfactory_feed(struct ast_slinfactory *sf, struct ast_frame *f)
00058 {
00059    struct ast_frame *begin_frame = f, *duped_frame = NULL, *frame_ptr;
00060    unsigned int x;
00061 
00062    /* In some cases, we can be passed a frame which has no data in it, but
00063     * which has a positive number of samples defined. Once such situation is
00064     * when a jitter buffer is in use and the jitter buffer interpolates a frame.
00065     * The frame it produces has data set to NULL, datalen set to 0, and samples
00066     * set to either 160 or 240.
00067     */
00068    if (!f->data) {
00069       return 0;
00070    }
00071 
00072    if (f->subclass != AST_FORMAT_SLINEAR) {
00073       if (sf->trans && f->subclass != sf->format) {
00074          ast_translator_free_path(sf->trans);
00075          sf->trans = NULL;
00076       }
00077 
00078       if (!sf->trans) {
00079          if ((sf->trans = ast_translator_build_path(AST_FORMAT_SLINEAR, f->subclass)) == NULL) {
00080             ast_log(LOG_WARNING, "Cannot build a path from %s to slin\n", ast_getformatname(f->subclass));
00081             return 0;
00082          } else {
00083             sf->format = f->subclass;
00084          }
00085       }
00086 
00087       if (!(begin_frame = ast_translate(sf->trans, f, 0))) 
00088          return 0;
00089       
00090       duped_frame = ast_frdup(begin_frame);
00091 
00092       ast_frfree(begin_frame);
00093 
00094       if (!duped_frame)
00095          return 0;
00096    } else {
00097       if (!(duped_frame = ast_frdup(f)))
00098          return 0;
00099    }
00100 
00101    x = 0;
00102    AST_LIST_TRAVERSE(&sf->queue, frame_ptr, frame_list)
00103       x++;
00104 
00105    AST_LIST_INSERT_TAIL(&sf->queue, duped_frame, frame_list);
00106 
00107    sf->size += duped_frame->samples;
00108 
00109    return x;
00110 }
00111 
00112 int ast_slinfactory_read(struct ast_slinfactory *sf, short *buf, size_t samples) 
00113 {
00114    struct ast_frame *frame_ptr;
00115    unsigned int sofar = 0, ineed, remain;
00116    short *frame_data, *offset = buf;
00117 
00118    while (sofar < samples) {
00119       ineed = samples - sofar;
00120 
00121       if (sf->holdlen) {
00122          if (sf->holdlen <= ineed) {
00123             memcpy(offset, sf->hold, sf->holdlen * sizeof(*offset));
00124             sofar += sf->holdlen;
00125             offset += sf->holdlen;
00126             sf->holdlen = 0;
00127             sf->offset = sf->hold;
00128          } else {
00129             remain = sf->holdlen - ineed;
00130             memcpy(offset, sf->offset, ineed * sizeof(*offset));
00131             sofar += ineed;
00132             sf->offset += ineed;
00133             sf->holdlen = remain;
00134          }
00135          continue;
00136       }
00137       
00138       if ((frame_ptr = AST_LIST_REMOVE_HEAD(&sf->queue, frame_list))) {
00139          frame_data = frame_ptr->data;
00140          
00141          if (frame_ptr->samples <= ineed) {
00142             memcpy(offset, frame_data, frame_ptr->samples * sizeof(*offset));
00143             sofar += frame_ptr->samples;
00144             offset += frame_ptr->samples;
00145          } else {
00146             remain = frame_ptr->samples - ineed;
00147             memcpy(offset, frame_data, ineed * sizeof(*offset));
00148             sofar += ineed;
00149             frame_data += ineed;
00150             if (remain > (AST_SLINFACTORY_MAX_HOLD - sf->holdlen)) {
00151                remain = AST_SLINFACTORY_MAX_HOLD - sf->holdlen;
00152             }
00153             memcpy(sf->hold, frame_data, remain * sizeof(*offset));
00154             sf->holdlen = remain;
00155          }
00156          ast_frfree(frame_ptr);
00157       } else {
00158          break;
00159       }
00160    }
00161 
00162    sf->size -= sofar;
00163    return sofar;
00164 }
00165 
00166 unsigned int ast_slinfactory_available(const struct ast_slinfactory *sf)
00167 {
00168    return sf->size;
00169 }
00170 
00171 void ast_slinfactory_flush(struct ast_slinfactory *sf)
00172 {
00173    struct ast_frame *fr = NULL;
00174 
00175    if (sf->trans) {
00176       ast_translator_free_path(sf->trans);
00177       sf->trans = NULL;
00178    }
00179 
00180    while ((fr = AST_LIST_REMOVE_HEAD(&sf->queue, frame_list)))
00181       ast_frfree(fr);
00182 
00183    sf->size = sf->holdlen = 0;
00184    sf->offset = sf->hold;
00185 
00186    return;
00187 }

Generated on Thu May 14 14:49:11 2009 for Asterisk - the Open Source PBX by  doxygen 1.4.7