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 *tdesc = "Image Transmission Application";
  48
  49 static char *app = "SendImage";
  50
  51 static char *synopsis = "Send an image file";
  52
  53 static char *descrip =
  54 "  SendImage(filename): Sends an image on a channel. \n"
  55 "If the channel supports image transport but the image send\n"
  56 "fails, the channel will be hung up. Otherwise, the dialplan\n"
  57 "continues execution.\n"
  58 "The option string may contain the following character:\n"
  59 "       'j' -- jump to priority n+101 if the channel doesn't support image transport\n"
  60 "This application sets the following channel variable upon completion:\n"
  61 "       SENDIMAGESTATUS         The status is the result of the attempt as a text string, one of\n"
  62 "               OK | NOSUPPORT \n";
  63
  64 LOCAL_USER_DECL;
  65
  66 static int sendimage_exec(struct ast_channel *chan, void *data)
  67 {
  68         int res = 0;
  69         struct localuser *u;
  70         char *parse;
  71         int priority_jump = 0;
  72         AST_DECLARE_APP_ARGS(args,
  73                 AST_APP_ARG(filename);
  74                 AST_APP_ARG(options);
  75         );
  76
  77         LOCAL_USER_ADD(u);
  78
  79         parse = ast_strdupa(data);
  80
  81         AST_STANDARD_APP_ARGS(args, parse);
  82
  83         if (ast_strlen_zero(args.filename)) {
  84                 ast_log(LOG_WARNING, "SendImage requires an argument (filename[|options])\n");
  85                 return -1;
  86         }
  87
  88         if (args.options) {
  89                 if (strchr(args.options, 'j'))
  90                         priority_jump = 1;
  91         }
  92
  93         if (!ast_supports_images(chan)) {
  94                 /* Does not support transport */
  95                 if (priority_jump || ast_opt_priority_jumping)
  96                         ast_goto_if_exists(chan, chan->context, chan->exten, chan->priority + 101);
  97                 pbx_builtin_setvar_helper(chan, "SENDIMAGESTATUS", "NOSUPPORT");
  98                 LOCAL_USER_REMOVE(u);
  99                 return 0;
 100         }
 101
 102         res = ast_send_image(chan, args.filename);
 103
 104         if (!res)
 105                 pbx_builtin_setvar_helper(chan, "SENDIMAGESTATUS", "OK");
 106
 107         LOCAL_USER_REMOVE(u);
 108
 109         return res;
 110 }
 111
 112 static int unload_module(void *mod)
 113 {
 114         int res;
 115
 116         res = ast_unregister_application(app);
 117
 118         STANDARD_HANGUP_LOCALUSERS;
 119
 120         return res;
 121 }
 122
 123 static int load_module(void *mod)
 124 {
 125         return ast_register_application(app, sendimage_exec, synopsis, descrip);
 126 }
 127
 128 static const char *description(void)
 129 {
 130         return tdesc;
 131 }
 132
 133 static const char *key(void)
 134 {
 135         return ASTERISK_GPL_KEY;
 136 }
 137
 138 STD_MOD1;