Wed Jan 8 2020 09:50:12

Asterisk developer's documentation


format_g729.c File Reference

Save to raw, headerless G729 data. More...

#include "asterisk.h"
#include "asterisk/mod_format.h"
#include "asterisk/module.h"
#include "asterisk/endian.h"

Go to the source code of this file.

Macros

#define BUF_SIZE   20 /* two G729 frames */
 
#define G729A_SAMPLES   160
 

Functions

static void __reg_module (void)
 
static void __unreg_module (void)
 
static struct ast_frameg729_read (struct ast_filestream *s, int *whennext)
 
static int g729_seek (struct ast_filestream *fs, off_t sample_offset, int whence)
 
static off_t g729_tell (struct ast_filestream *fs)
 
static int g729_trunc (struct ast_filestream *fs)
 
static int g729_write (struct ast_filestream *fs, struct ast_frame *f)
 
static int load_module (void)
 
static int unload_module (void)
 

Variables

static struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "Raw G.729 data" , .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 = "ac1f6a56484a8820659555499174e588" , .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 g729_f
 

Detailed Description

Save to raw, headerless G729 data.

Note
This is not an encoder/decoder. The codec fo g729 is only available with a commercial license from Digium, due to patent restrictions. Check http://www.digium.com for information.
  • Extensions: g729

Definition in file format_g729.c.

Macro Definition Documentation

#define BUF_SIZE   20 /* two G729 frames */

Definition at line 45 of file format_g729.c.

Referenced by g729_read(), g729_seek(), and g729_tell().

#define G729A_SAMPLES   160

Definition at line 46 of file format_g729.c.

Referenced by g729_read(), g729_seek(), and g729_tell().

Function Documentation

static void __reg_module ( void  )
static

Definition at line 165 of file format_g729.c.

static void __unreg_module ( void  )
static

Definition at line 165 of file format_g729.c.

static struct ast_frame* g729_read ( struct ast_filestream s,
int *  whennext 
)
static

Definition at line 48 of file format_g729.c.

References AST_FORMAT_G729A, 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, G729A_SAMPLES, LOG_WARNING, ast_frame::mallocd, ast_frame::ptr, ast_frame::samples, and ast_frame::subclass.

49 {
50  int res;
51  /* Send a frame from the file to the appropriate channel */
54  s->fr.mallocd = 0;
57  if ((res = fread(s->fr.data.ptr, 1, s->fr.datalen, s->f)) != s->fr.datalen) {
58  if (res && (res != 10)) /* XXX what for ? */
59  ast_log(LOG_WARNING, "Short read (%d) (%s)!\n", res, strerror(errno));
60  return NULL;
61  }
62  *whennext = s->fr.samples;
63  return &s->fr;
64 }
union ast_frame_subclass subclass
Definition: frame.h:146
#define BUF_SIZE
Definition: format_g729.c:45
#define G729A_SAMPLES
Definition: format_g729.c:46
void * ptr
Definition: frame.h:160
#define LOG_WARNING
Definition: logger.h:144
format_t codec
Definition: frame.h:137
#define AST_FORMAT_G729A
Definition: frame.h:258
#define AST_FRAME_SET_BUFFER(fr, _base, _ofs, _datalen)
Definition: frame.h:183
#define AST_FRIENDLY_OFFSET
Offset into a frame's data buffer.
Definition: frame.h:204
int datalen
Definition: frame.h:148
struct ast_frame fr
Definition: mod_format.h:117
void ast_log(int level, const char *file, int line, const char *function, const char *fmt,...)
Used for sending a log message This is the standard logger function. Probably the only way you will i...
Definition: logger.c:1207
int errno
int mallocd
Definition: frame.h:152
enum ast_frame_type frametype
Definition: frame.h:144
union ast_frame::@172 data
int samples
Definition: frame.h:150
static int g729_seek ( struct ast_filestream fs,
off_t  sample_offset,
int  whence 
)
static

Definition at line 88 of file format_g729.c.

References BUF_SIZE, ast_filestream::f, G729A_SAMPLES, ast_frame::offset, and SEEK_FORCECUR.

89 {
90  long bytes;
91  off_t min,cur,max,offset=0;
92  min = 0;
93  cur = ftello(fs->f);
94  fseeko(fs->f, 0, SEEK_END);
95  max = ftello(fs->f);
96 
97  bytes = BUF_SIZE * (sample_offset / G729A_SAMPLES);
98  if (whence == SEEK_SET)
99  offset = bytes;
100  else if (whence == SEEK_CUR || whence == SEEK_FORCECUR)
101  offset = cur + bytes;
102  else if (whence == SEEK_END)
103  offset = max - bytes;
104  if (whence != SEEK_FORCECUR) {
105  offset = (offset > max)?max:offset;
106  }
107  /* protect against seeking beyond begining. */
108  offset = (offset < min)?min:offset;
109  if (fseeko(fs->f, offset, SEEK_SET) < 0)
110  return -1;
111  return 0;
112 }
#define BUF_SIZE
Definition: format_g729.c:45
#define G729A_SAMPLES
Definition: format_g729.c:46
#define SEEK_FORCECUR
Definition: file.h:50
static off_t g729_tell ( struct ast_filestream fs)
static

Definition at line 131 of file format_g729.c.

References BUF_SIZE, ast_filestream::f, G729A_SAMPLES, and ast_frame::offset.

132 {
133  off_t offset = ftello(fs->f);
134  return (offset/BUF_SIZE)*G729A_SAMPLES;
135 }
#define BUF_SIZE
Definition: format_g729.c:45
#define G729A_SAMPLES
Definition: format_g729.c:46
static int g729_trunc ( struct ast_filestream fs)
static

Definition at line 114 of file format_g729.c.

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

115 {
116  int fd;
117  off_t cur;
118 
119  if ((fd = fileno(fs->f)) < 0) {
120  ast_log(AST_LOG_WARNING, "Unable to determine file descriptor for g729 filestream %p: %s\n", fs, strerror(errno));
121  return -1;
122  }
123  if ((cur = ftello(fs->f)) < 0) {
124  ast_log(AST_LOG_WARNING, "Unable to determine current position in g729 filestream %p: %s\n", fs, strerror(errno));
125  return -1;
126  }
127  /* Truncate file to current length */
128  return ftruncate(fd, cur);
129 }
#define AST_LOG_WARNING
Definition: logger.h:149
void ast_log(int level, const char *file, int line, const char *function, const char *fmt,...)
Used for sending a log message This is the standard logger function. Probably the only way you will i...
Definition: logger.c:1207
int errno
static int g729_write ( struct ast_filestream fs,
struct ast_frame f 
)
static

Definition at line 66 of file format_g729.c.

References AST_FORMAT_G729A, 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.

67 {
68  int res;
69  if (f->frametype != AST_FRAME_VOICE) {
70  ast_log(LOG_WARNING, "Asked to write non-voice frame!\n");
71  return -1;
72  }
73  if (f->subclass.codec != AST_FORMAT_G729A) {
74  ast_log(LOG_WARNING, "Asked to write non-G729 frame (%s)!\n", ast_getformatname(f->subclass.codec));
75  return -1;
76  }
77  if (f->datalen % 10) {
78  ast_log(LOG_WARNING, "Invalid data length, %d, should be multiple of 10\n", f->datalen);
79  return -1;
80  }
81  if ((res = fwrite(f->data.ptr, 1, f->datalen, fs->f)) != f->datalen) {
82  ast_log(LOG_WARNING, "Bad write (%d/10): %s\n", res, strerror(errno));
83  return -1;
84  }
85  return 0;
86 }
union ast_frame_subclass subclass
Definition: frame.h:146
void * ptr
Definition: frame.h:160
#define LOG_WARNING
Definition: logger.h:144
format_t codec
Definition: frame.h:137
#define AST_FORMAT_G729A
Definition: frame.h:258
int datalen
Definition: frame.h:148
char * ast_getformatname(format_t format)
Get the name of a format.
Definition: frame.c:578
void ast_log(int level, const char *file, int line, const char *function, const char *fmt,...)
Used for sending a log message This is the standard logger function. Probably the only way you will i...
Definition: logger.c:1207
int errno
enum ast_frame_type frametype
Definition: frame.h:144
union ast_frame::@172 data
static int load_module ( void  )
static

Definition at line 149 of file format_g729.c.

References ast_format_register, AST_MODULE_LOAD_FAILURE, and AST_MODULE_LOAD_SUCCESS.

150 {
154 }
#define ast_format_register(f)
Definition: mod_format.h:131
static struct ast_format g729_f
Definition: format_g729.c:137
static int unload_module ( void  )
static

Definition at line 156 of file format_g729.c.

References ast_format_unregister(), and ast_format::name.

157 {
159 }
int ast_format_unregister(const char *name)
Unregisters a file format.
Definition: file.c:104
char name[80]
Definition: mod_format.h:44
static struct ast_format g729_f
Definition: format_g729.c:137

Variable Documentation

struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "Raw G.729 data" , .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 = "ac1f6a56484a8820659555499174e588" , .load = load_module, .unload = unload_module, .load_pri = AST_MODPRI_APP_DEPEND }
static

Definition at line 165 of file format_g729.c.

Definition at line 165 of file format_g729.c.

struct ast_format g729_f
static

Definition at line 137 of file format_g729.c.