Sat Mar 10 01:54:19 2012

Asterisk developer's documentation


image.c

Go to the documentation of this file.
00001 /*
00002  * Asterisk -- An open source telephony toolkit.
00003  *
00004  * Copyright (C) 1999 - 2006, Digium, Inc.
00005  *
00006  * Mark Spencer <markster@digium.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 Image Management
00022  *
00023  * \author Mark Spencer <markster@digium.com> 
00024  */
00025 
00026 #include "asterisk.h"
00027 
00028 ASTERISK_FILE_VERSION(__FILE__, "$Revision: 200620 $")
00029 
00030 #include <sys/time.h>
00031 #include <sys/stat.h>
00032 #include <signal.h>
00033 
00034 #include "asterisk/paths.h"   /* use ast_config_AST_DATA_DIR */
00035 #include "asterisk/sched.h"
00036 #include "asterisk/channel.h"
00037 #include "asterisk/file.h"
00038 #include "asterisk/image.h"
00039 #include "asterisk/translate.h"
00040 #include "asterisk/cli.h"
00041 #include "asterisk/lock.h"
00042 
00043 /* XXX Why don't we just use the formats struct for this? */
00044 static AST_RWLIST_HEAD_STATIC(imagers, ast_imager);
00045 
00046 int ast_image_register(struct ast_imager *img)
00047 {
00048    AST_RWLIST_WRLOCK(&imagers);
00049    AST_RWLIST_INSERT_HEAD(&imagers, img, list);
00050    AST_RWLIST_UNLOCK(&imagers);
00051    ast_verb(2, "Registered format '%s' (%s)\n", img->name, img->desc);
00052    return 0;
00053 }
00054 
00055 void ast_image_unregister(struct ast_imager *img)
00056 {
00057    AST_RWLIST_WRLOCK(&imagers);
00058    img = AST_RWLIST_REMOVE(&imagers, img, list);
00059    AST_RWLIST_UNLOCK(&imagers);
00060 
00061    if (img)
00062       ast_verb(2, "Unregistered format '%s' (%s)\n", img->name, img->desc);
00063 }
00064 
00065 int ast_supports_images(struct ast_channel *chan)
00066 {
00067    if (!chan || !chan->tech)
00068       return 0;
00069    if (!chan->tech->send_image)
00070       return 0;
00071    return 1;
00072 }
00073 
00074 static int file_exists(char *filename)
00075 {
00076    int res;
00077    struct stat st;
00078    res = stat(filename, &st);
00079    if (!res)
00080       return st.st_size;
00081    return 0;
00082 }
00083 
00084 static void make_filename(char *buf, int len, const char *filename, const char *preflang, char *ext)
00085 {
00086    if (filename[0] == '/') {
00087       if (!ast_strlen_zero(preflang))
00088          snprintf(buf, len, "%s-%s.%s", filename, preflang, ext);
00089       else
00090          snprintf(buf, len, "%s.%s", filename, ext);
00091    } else {
00092       if (!ast_strlen_zero(preflang))
00093          snprintf(buf, len, "%s/%s/%s-%s.%s", ast_config_AST_DATA_DIR, "images", filename, preflang, ext);
00094       else
00095          snprintf(buf, len, "%s/%s/%s.%s", ast_config_AST_DATA_DIR, "images", filename, ext);
00096    }
00097 }
00098 
00099 struct ast_frame *ast_read_image(const char *filename, const char *preflang, int format)
00100 {
00101    struct ast_imager *i;
00102    char buf[256];
00103    char tmp[80];
00104    char *e;
00105    struct ast_imager *found = NULL;
00106    int fd;
00107    int len=0;
00108    struct ast_frame *f = NULL;
00109    
00110    AST_RWLIST_RDLOCK(&imagers);
00111    AST_RWLIST_TRAVERSE(&imagers, i, list) {
00112       if (i->format & format) {
00113          char *stringp=NULL;
00114          ast_copy_string(tmp, i->exts, sizeof(tmp));
00115          stringp = tmp;
00116          e = strsep(&stringp, "|");
00117          while (e) {
00118             make_filename(buf, sizeof(buf), filename, preflang, e);
00119             if ((len = file_exists(buf))) {
00120                found = i;
00121                break;
00122             }
00123             make_filename(buf, sizeof(buf), filename, NULL, e);
00124             if ((len = file_exists(buf))) {
00125                found = i;
00126                break;
00127             }
00128             e = strsep(&stringp, "|");
00129          }
00130       }
00131       if (found)
00132          break;   
00133    }
00134 
00135    if (found) {
00136       fd = open(buf, O_RDONLY);
00137       if (fd > -1) {
00138          if (!found->identify || found->identify(fd)) {
00139             /* Reset file pointer */
00140             lseek(fd, 0, SEEK_SET);
00141             f = found->read_image(fd, len); 
00142          } else
00143             ast_log(LOG_WARNING, "%s does not appear to be a %s file\n", buf, found->name);
00144          close(fd);
00145       } else
00146          ast_log(LOG_WARNING, "Unable to open '%s': %s\n", buf, strerror(errno));
00147    } else
00148       ast_log(LOG_WARNING, "Image file '%s' not found\n", filename);
00149    
00150    AST_RWLIST_UNLOCK(&imagers);
00151    
00152    return f;
00153 }
00154 
00155 int ast_send_image(struct ast_channel *chan, const char *filename)
00156 {
00157    struct ast_frame *f;
00158    int res = -1;
00159    if (chan->tech->send_image) {
00160       f = ast_read_image(filename, chan->language, -1);
00161       if (f) {
00162          res = chan->tech->send_image(chan, f);
00163          ast_frfree(f);
00164       }
00165    }
00166    return res;
00167 }
00168 
00169 static char *handle_core_show_image_formats(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
00170 {
00171 #define FORMAT "%10s %10s %50s %10s\n"
00172 #define FORMAT2 "%10s %10s %50s %10s\n"
00173    struct ast_imager *i;
00174    int count_fmt = 0;
00175 
00176    switch (cmd) {
00177    case CLI_INIT:
00178       e->command = "core show image formats";
00179       e->usage =
00180          "Usage: core show image formats\n"
00181          "       Displays currently registered image formats (if any).\n";
00182       return NULL;
00183    case CLI_GENERATE:
00184       return NULL;
00185    }
00186    if (a->argc != 4)
00187       return CLI_SHOWUSAGE;
00188    ast_cli(a->fd, FORMAT, "Name", "Extensions", "Description", "Format");
00189    ast_cli(a->fd, FORMAT, "----", "----------", "-----------", "------");
00190    AST_RWLIST_RDLOCK(&imagers);
00191    AST_RWLIST_TRAVERSE(&imagers, i, list) {
00192       ast_cli(a->fd, FORMAT2, i->name, i->exts, i->desc, ast_getformatname(i->format));
00193       count_fmt++;
00194    }
00195    AST_RWLIST_UNLOCK(&imagers);
00196    ast_cli(a->fd, "\n%d image format%s registered.\n", count_fmt, count_fmt == 1 ? "" : "s");
00197    return CLI_SUCCESS;
00198 }
00199 
00200 static struct ast_cli_entry cli_image[] = {
00201    AST_CLI_DEFINE(handle_core_show_image_formats, "Displays image formats")
00202 };
00203 
00204 int ast_image_init(void)
00205 {
00206    ast_cli_register_multiple(cli_image, ARRAY_LEN(cli_image));
00207    return 0;
00208 }

Generated on Sat Mar 10 01:54:19 2012 for Asterisk - The Open Source Telephony Project by  doxygen 1.4.7