apps/app_image.c

   1 /*
   2  * Asterisk -- An open source telephony toolkit.
   3  *
   4  * Copyright (C) 1999 - 2005, Digium, Inc.
   5  *
   6  * Mark Spencer <markster@digium.com>
   7  *
   8  * See http://www.asterisk.org for more information about
   9  * the Asterisk project. Please do not directly contact
  10  * any of the maintainers of this project for assistance;
  11  * the project provides a web site, mailing lists and IRC
  12  * channels for your use.
  13  *
  14  * This program is free software, distributed under the terms of
  15  * the GNU General Public License Version 2. See the LICENSE file
  16  * at the top of the source tree.
  17  */
  18
  19 /*! \file
  20  *
  21  * \brief App to transmit an image
  22  *
  23  * \author Mark Spencer <markster@digium.com>
  24  *
  25  * \ingroup applications
  26  */
  27
  28 #include "asterisk.h"
  29
  30 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
  31
  32 #include <stdlib.h>
  33 #include <stdio.h>
  34 #include <string.h>
  35
  36 #include "asterisk/lock.h"
  37 #include "asterisk/file.h"
  38 #include "asterisk/logger.h"
  39 #include "asterisk/channel.h"
  40 #include "asterisk/pbx.h"
  41 #include "asterisk/module.h"
  42 #include "asterisk/translate.h"
  43 #include "asterisk/image.h"
  44 #include "asterisk/app.h"
  45 #include "asterisk/options.h"
  46
  47 static char *app = "SendImage";
  48
  49 static char *synopsis = "Send an image file";
  50
  51 static char *descrip =
  52 "  SendImage(filename): Sends an image on a channel. \n"
  53 "If the channel supports image transport but the image send\n"
  54 "fails, the channel will be hung up. Otherwise, the dialplan\n"
  55 "continues execution.\n"
  56 "The option string may contain the following character:\n"
  57 "       'j' -- jump to priority n+101 if the channel doesn't support image transport\n"
  58 "This application sets the following channel variable upon completion:\n"
  59 "       SENDIMAGESTATUS         The status is the result of the attempt as a text string, one of\n"
  60 "               OK | NOSUPPORT \n";
  61
  62
  63 static int sendimage_exec(struct ast_channel *chan, void *data)
  64 {
  65         int res = 0;
  66         struct ast_module_user *u;
  67         char *parse;
  68         int priority_jump = 0;
  69         AST_DECLARE_APP_ARGS(args,
  70                 AST_APP_ARG(filename);
  71                 AST_APP_ARG(options);
  72         );
  73
  74         u = ast_module_user_add(chan);
  75
  76         parse = ast_strdupa(data);
  77
  78         AST_STANDARD_APP_ARGS(args, parse);
  79
  80         if (ast_strlen_zero(args.filename)) {
  81                 ast_log(LOG_WARNING, "SendImage requires an argument (filename[|options])\n");
  82                 return -1;
  83         }
  84
  85         if (args.options) {
  86                 if (strchr(args.options, 'j'))
  87                         priority_jump = 1;
  88         }
  89
  90         if (!ast_supports_images(chan)) {
  91                 /* Does not support transport */
  92                 if (priority_jump || ast_opt_priority_jumping)
  93                         ast_goto_if_exists(chan, chan->context, chan->exten, chan->priority + 101);
  94                 pbx_builtin_setvar_helper(chan, "SENDIMAGESTATUS", "NOSUPPORT");
  95                 ast_module_user_remove(u);
  96                 return 0;
  97         }
  98
  99         res = ast_send_image(chan, args.filename);
 100
 101         if (!res)
 102                 pbx_builtin_setvar_helper(chan, "SENDIMAGESTATUS", "OK");
 103
 104         ast_module_user_remove(u);
 105
 106         return res;
 107 }
 108
 109 static int unload_module(void)
 110 {
 111         int res;
 112
 113         res = ast_unregister_application(app);
 114
 115         ast_module_user_hangup_all();
 116
 117         return res;
 118 }
 119
 120 static int load_module(void)
 121 {
 122         return ast_register_application(app, sendimage_exec, synopsis, descrip);
 123 }
 124
 125 AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Image Transmission Application");