Mon Apr 28 2014 10:06:44

Asterisk developer's documentation


format_sln16.c File Reference

RAW SLINEAR 16 Format. More...

#include "asterisk.h"
#include "asterisk/mod_format.h"
#include "asterisk/module.h"
#include "asterisk/endian.h"
Include dependency graph for format_sln16.c:

Go to the source code of this file.

Defines

#define BUF_SIZE   640 /* 640 bytes, 320 samples */
#define SLIN_SAMPLES   320

Functions

static void __reg_module (void)
static void __unreg_module (void)
static int load_module (void)
static struct ast_frameslinear_read (struct ast_filestream *s, int *whennext)
static int slinear_seek (struct ast_filestream *fs, off_t sample_offset, int whence)
static off_t slinear_tell (struct ast_filestream *fs)
static int slinear_trunc (struct ast_filestream *fs)
static int slinear_write (struct ast_filestream *fs, struct ast_frame *f)
static int unload_module (void)

Variables

static struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "Raw Signed Linear 16KHz Audio support (SLN16)" , .key = "This paragraph is copyright (c) 2006 by Digium, Inc. \In order for your module to load, it must return this \key via a function called \"key\". Any code which \includes this paragraph must be licensed under the GNU \General Public License version 2 or later (at your \option). In addition to Digium's general reservations \of rights, Digium expressly reserves the right to \allow other parties to license this paragraph under \different terms. Any use of Digium, Inc. trademarks or \logos (including \"Asterisk\" or \"Digium\") without \express written permission of Digium, Inc. is prohibited.\n" , .buildopt_sum = AST_BUILDOPT_SUM, .load = load_module, .unload = unload_module, .load_pri = AST_MODPRI_APP_DEPEND }
static struct ast_module_infoast_module_info = &__mod_info
static struct ast_format slin_f

Detailed Description

RAW SLINEAR 16 Format.

  • File name extensions: sln16

Definition in file format_sln16.c.


Define Documentation

#define BUF_SIZE   640 /* 640 bytes, 320 samples */

Definition at line 38 of file format_sln16.c.

Referenced by slinear_read().

#define SLIN_SAMPLES   320

Definition at line 39 of file format_sln16.c.


Function Documentation

static void __reg_module ( void  ) [static]

Definition at line 167 of file format_sln16.c.

static void __unreg_module ( void  ) [static]

Definition at line 167 of file format_sln16.c.

static int load_module ( void  ) [static]
static struct ast_frame* slinear_read ( struct ast_filestream s,
int *  whennext 
) [static, read]

Definition at line 41 of file format_sln16.c.

References AST_FORMAT_SLINEAR16, AST_FRAME_SET_BUFFER, AST_FRAME_VOICE, AST_FRIENDLY_OFFSET, ast_log(), ast_filestream::buf, BUF_SIZE, ast_frame_subclass::codec, ast_frame::data, ast_frame::datalen, errno, ast_filestream::f, ast_filestream::fr, ast_frame::frametype, LOG_WARNING, ast_frame::mallocd, ast_frame::ptr, ast_frame::samples, and ast_frame::subclass.

{
   int res;
   /* Send a frame from the file to the appropriate channel */

   s->fr.frametype = AST_FRAME_VOICE;
   s->fr.subclass.codec = AST_FORMAT_SLINEAR16;
   s->fr.mallocd = 0;
   AST_FRAME_SET_BUFFER(&s->fr, s->buf, AST_FRIENDLY_OFFSET, BUF_SIZE);
   if ((res = fread(s->fr.data.ptr, 1, s->fr.datalen, s->f)) < 1) {
      if (res)
         ast_log(LOG_WARNING, "Short read (%d) (%s)!\n", res, strerror(errno));
      return NULL;
   }
   *whennext = s->fr.samples = res/2;
   s->fr.datalen = res;
   return &s->fr;
}
static int slinear_seek ( struct ast_filestream fs,
off_t  sample_offset,
int  whence 
) [static]

Definition at line 79 of file format_sln16.c.

References ast_log(), AST_LOG_WARNING, errno, ast_filestream::f, ast_frame::offset, and SEEK_FORCECUR.

{
   off_t offset = 0, min = 0, cur, max;

   sample_offset <<= 1;

   if ((cur = ftello(fs->f)) < 0) {
      ast_log(AST_LOG_WARNING, "Unable to determine current position in sln16 filestream %p: %s\n", fs, strerror(errno));
      return -1;
   }

   if (fseeko(fs->f, 0, SEEK_END) < 0) {
      ast_log(AST_LOG_WARNING, "Unable to seek to end of sln16 filestream %p: %s\n", fs, strerror(errno));
      return -1;
   }

   if ((max = ftello(fs->f)) < 0) {
      ast_log(AST_LOG_WARNING, "Unable to determine max position in sln16 filestream %p: %s\n", fs, strerror(errno));
      return -1;
   }

   if (whence == SEEK_SET)
      offset = sample_offset;
   else if (whence == SEEK_CUR || whence == SEEK_FORCECUR)
      offset = sample_offset + cur;
   else if (whence == SEEK_END)
      offset = max - sample_offset;

   if (whence != SEEK_FORCECUR)
      offset = (offset > max) ? max : offset;

   /* always protect against seeking past begining. */
   offset = (offset < min) ? min : offset;

   return fseeko(fs->f, offset, SEEK_SET);
}
static off_t slinear_tell ( struct ast_filestream fs) [static]

Definition at line 133 of file format_sln16.c.

References ast_filestream::f.

{
   return ftello(fs->f) / 2;
}
static int slinear_trunc ( struct ast_filestream fs) [static]

Definition at line 116 of file format_sln16.c.

References ast_log(), AST_LOG_WARNING, errno, and ast_filestream::f.

{
   int fd;
   off_t cur;

   if ((fd = fileno(fs->f)) < 0) {
      ast_log(AST_LOG_WARNING, "Unable to determine file descriptor for sln16 filestream %p: %s\n", fs, strerror(errno));
      return -1;
   }
   if ((cur = ftello(fs->f)) < 0) {
      ast_log(AST_LOG_WARNING, "Unable to determine current position in sln16 filestream %p: %s\n", fs, strerror(errno));
      return -1;
   }
   /* Truncate file to current length */
   return ftruncate(fd, cur);
}
static int slinear_write ( struct ast_filestream fs,
struct ast_frame f 
) [static]

Definition at line 60 of file format_sln16.c.

References AST_FORMAT_SLINEAR16, AST_FRAME_VOICE, ast_getformatname(), ast_log(), ast_frame_subclass::codec, ast_frame::data, ast_frame::datalen, errno, ast_filestream::f, ast_frame::frametype, LOG_WARNING, ast_frame::ptr, and ast_frame::subclass.

{
   int res;

   if (f->frametype != AST_FRAME_VOICE) {
      ast_log(LOG_WARNING, "Asked to write non-voice frame!\n");
      return -1;
   }
   if (f->subclass.codec != AST_FORMAT_SLINEAR16) {
      ast_log(LOG_WARNING, "Asked to write non-slinear16 frame (%s)!\n", ast_getformatname(f->subclass.codec));
      return -1;
   }
   if ((res = fwrite(f->data.ptr, 1, f->datalen, fs->f)) != f->datalen) {
      ast_log(LOG_WARNING, "Bad write (%d/%d): %s\n", res, f->datalen, strerror(errno));
      return -1;
   }
   return 0;
}
static int unload_module ( void  ) [static]

Definition at line 158 of file format_sln16.c.

References ast_format_unregister(), and ast_format::name.


Variable Documentation

struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "Raw Signed Linear 16KHz Audio support (SLN16)" , .key = "This paragraph is copyright (c) 2006 by Digium, Inc. \In order for your module to load, it must return this \key via a function called \"key\". Any code which \includes this paragraph must be licensed under the GNU \General Public License version 2 or later (at your \option). In addition to Digium's general reservations \of rights, Digium expressly reserves the right to \allow other parties to license this paragraph under \different terms. Any use of Digium, Inc. trademarks or \logos (including \"Asterisk\" or \"Digium\") without \express written permission of Digium, Inc. is prohibited.\n" , .buildopt_sum = AST_BUILDOPT_SUM, .load = load_module, .unload = unload_module, .load_pri = AST_MODPRI_APP_DEPEND } [static]

Definition at line 167 of file format_sln16.c.

Definition at line 167 of file format_sln16.c.

struct ast_format slin_f [static]

Definition at line 138 of file format_sln16.c.