Asterisk data retrieval API.
[asterisk/asterisk.git] / apps / app_image.c
index e23b274..af4abd7 100644 (file)
 /*! \file
  *
  * \brief App to transmit an image
 /*! \file
  *
  * \brief App to transmit an image
+ *
+ * \author Mark Spencer <markster@digium.com>
  * 
  * \ingroup applications
  */
  
  * 
  * \ingroup applications
  */
  
-#include <stdlib.h>
-#include <stdio.h>
-#include <string.h>
-
 #include "asterisk.h"
 
 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 
 #include "asterisk.h"
 
 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 
-#include "asterisk/lock.h"
-#include "asterisk/file.h"
-#include "asterisk/logger.h"
-#include "asterisk/channel.h"
 #include "asterisk/pbx.h"
 #include "asterisk/module.h"
 #include "asterisk/pbx.h"
 #include "asterisk/module.h"
-#include "asterisk/translate.h"
 #include "asterisk/image.h"
 #include "asterisk/image.h"
-#include "asterisk/app.h"
-#include "asterisk/options.h"
-
-static char *tdesc = "Image Transmission Application";
 
 static char *app = "SendImage";
 
 
 static char *app = "SendImage";
 
-static char *synopsis = "Send an image file";
-
-static char *descrip = 
-"  SendImage(filename): Sends an image on a channel. \n"
-"If the channel supports image transport but the image send\n"
-"fails, the channel will be hung up. Otherwise, the dialplan\n"
-"continues execution.\n"
-"The option string may contain the following character:\n"
-"      'j' -- jump to priority n+101 if the channel doesn't support image transport\n"
-"This application sets the following channel variable upon completion:\n"
-"      SENDIMAGESTATUS         The status is the result of the attempt as a text string, one of\n"
-"              OK | NOSUPPORT \n";                     
-
-STANDARD_LOCAL_USER;
-
-LOCAL_USER_DECL;
-
-static int sendimage_exec(struct ast_channel *chan, void *data)
+/*** DOCUMENTATION
+       <application name="SendImage" language="en_US">
+               <synopsis>
+                       Sends an image file.
+               </synopsis>
+               <syntax>
+                       <parameter name="filename" required="true">
+                               <para>Path of the filename (image) to send.</para>
+                       </parameter>
+               </syntax>
+               <description>
+                       <para>Send an image file on a channel supporting it.</para>
+                       <para>Result of transmission will be stored in <variable>SENDIMAGESTATUS</variable></para>
+                       <variablelist>
+                               <variable name="SENDIMAGESTATUS">
+                                       <value name="SUCCESS">
+                                               Transmission succeeded.
+                                       </value>
+                                       <value name="FAILURE">
+                                               Transmission failed.
+                                       </value>
+                                       <value name="UNSUPPORTED">
+                                               Image transmission not supported by channel.
+                                       </value>
+                               </variable>
+                       </variablelist>
+               </description>
+               <see-also>
+                       <ref type="application">SendText</ref>
+                       <ref type="application">SendURL</ref>
+               </see-also>
+       </application>
+ ***/
+
+static int sendimage_exec(struct ast_channel *chan, const char *data)
 {
 {
-       int res = 0;
-       struct localuser *u;
-       char *parse;
-       int priority_jump = 0;
-       AST_DECLARE_APP_ARGS(args,
-               AST_APP_ARG(filename);
-               AST_APP_ARG(options);
-       );
-       
-       LOCAL_USER_ADD(u);
 
 
-       if (!(parse = ast_strdupa(data))) {
-               ast_log(LOG_WARNING, "Memory Error!\n");
-               LOCAL_USER_REMOVE(u);
+       if (ast_strlen_zero(data)) {
+               ast_log(LOG_WARNING, "SendImage requires an argument (filename)\n");
                return -1;
        }
 
                return -1;
        }
 
-       AST_STANDARD_APP_ARGS(args, parse);
-
-       if (ast_strlen_zero(args.filename)) {
-               ast_log(LOG_WARNING, "SendImage requires an argument (filename[|options])\n");
-               return -1;
-       }
-
-       if (args.options) {
-               if (strchr(args.options, 'j'))
-                       priority_jump = 1;
-       }
-
        if (!ast_supports_images(chan)) {
                /* Does not support transport */
        if (!ast_supports_images(chan)) {
                /* Does not support transport */
-               if (priority_jump || option_priority_jumping)
-                       ast_goto_if_exists(chan, chan->context, chan->exten, chan->priority + 101);
-               pbx_builtin_setvar_helper(chan, "SENDIMAGESTATUS", "NOSUPPORT");
-               LOCAL_USER_REMOVE(u);
+               pbx_builtin_setvar_helper(chan, "SENDIMAGESTATUS", "UNSUPPORTED");
                return 0;
        }
 
                return 0;
        }
 
-       res = ast_send_image(chan, args.filename);
-       
-       if (!res)
-               pbx_builtin_setvar_helper(chan, "SENDIMAGESTATUS", "OK");
-       
-       LOCAL_USER_REMOVE(u);
+       if (!ast_send_image(chan, data)) {
+               pbx_builtin_setvar_helper(chan, "SENDIMAGESTATUS", "SUCCESS");
+       } else {
+               pbx_builtin_setvar_helper(chan, "SENDIMAGESTATUS", "FAILURE");
+       }
        
        
-       return res;
-}
-
-int unload_module(void)
-{
-       int res;
-
-       res = ast_unregister_application(app);
-
-       STANDARD_HANGUP_LOCALUSERS;
-
-       return res; 
+       return 0;
 }
 
 }
 
-int load_module(void)
+static int unload_module(void)
 {
 {
-       return ast_register_application(app, sendimage_exec, synopsis, descrip);
+       return ast_unregister_application(app);
 }
 
 }
 
-char *description(void)
+static int load_module(void)
 {
 {
-       return tdesc;
+       return ast_register_application_xml(app, sendimage_exec);
 }
 
 }
 
-int usecount(void)
-{
-       int res;
-       STANDARD_USECOUNT(res);
-       return res;
-}
-
-char *key()
-{
-       return ASTERISK_GPL_KEY;
-}
+AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Image Transmission Application");