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

Generated on Mon Oct 8 12:39:03 2012 for Asterisk - The Open Source Telephony Project by  doxygen 1.4.7