apps/app_image.c

   1 /*
   2  * Asterisk -- A telephony toolkit for Linux.
   3  *
   4  * App to transmit an image
   5  *
   6  * Copyright (C) 1999 - 2005, Digium, Inc.
   7  *
   8  * Mark Spencer <markster@digium.com>
   9  *
  10  * This program is free software, distributed under the terms of
  11  * the GNU General Public License
  12  */
  13
  14 #include <string.h>
  15 #include <stdlib.h>
  16
  17 #include "asterisk.h"
  18
  19 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
  20
  21 #include "asterisk/lock.h"
  22 #include "asterisk/file.h"
  23 #include "asterisk/logger.h"
  24 #include "asterisk/channel.h"
  25 #include "asterisk/pbx.h"
  26 #include "asterisk/module.h"
  27 #include "asterisk/translate.h"
  28 #include "asterisk/image.h"
  29
  30 static char *tdesc = "Image Transmission Application";
  31
  32 static char *app = "SendImage";
  33
  34 static char *synopsis = "Send an image file";
  35
  36 static char *descrip =
  37 "  SendImage(filename): Sends an image on a channel. If the channel\n"
  38 "does not support  image transport, and there exists  a  step  with\n"
  39 "priority n + 101, then  execution  will  continue  at  that  step.\n"
  40 "Otherwise,  execution  will continue at  the  next priority level.\n"
  41 "SendImage only  returns  0 if  the  image was sent correctly or if\n"
  42 "the channel does not support image transport, and -1 otherwise.\n";
  43
  44 STANDARD_LOCAL_USER;
  45
  46 LOCAL_USER_DECL;
  47
  48 static int sendimage_exec(struct ast_channel *chan, void *data)
  49 {
  50         int res = 0;
  51         struct localuser *u;
  52         if (!data || !strlen((char *)data)) {
  53                 ast_log(LOG_WARNING, "SendImage requires an argument (filename)\n");
  54                 return -1;
  55         }
  56         LOCAL_USER_ADD(u);
  57         if (!ast_supports_images(chan)) {
  58                 /* Does not support transport */
  59                 if (ast_exists_extension(chan, chan->context, chan->exten, chan->priority + 101, chan->cid.cid_num))
  60                         chan->priority += 100;
  61                 return 0;
  62         }
  63         res = ast_send_image(chan, data);
  64         LOCAL_USER_REMOVE(u);
  65         return res;
  66 }
  67
  68 int unload_module(void)
  69 {
  70         STANDARD_HANGUP_LOCALUSERS;
  71         return ast_unregister_application(app);
  72 }
  73
  74 int load_module(void)
  75 {
  76         return ast_register_application(app, sendimage_exec, synopsis, descrip);
  77 }
  78
  79 char *description(void)
  80 {
  81         return tdesc;
  82 }
  83
  84 int usecount(void)
  85 {
  86         int res;
  87         STANDARD_USECOUNT(res);
  88         return res;
  89 }
  90
  91 char *key()
  92 {
  93         return ASTERISK_GPL_KEY;
  94 }