4.2 ARexx interface

WebVision can be controlled through its ARexx port. For information about how to create ARexx scripts, you should refer to the manuals that came with your computer.

In order for ARexx to work SYS:System/RexxMaster needs to be running and ARexx needs to be turned on in the MUI configuration.

The arguments for the commands works exactly like ordinary AmigaDOS command arguments with respect to the flags /A, /S, etc.

For commands which returns a string in 'result' you need to execute the ARexx command 'options results' first. Remember also to have your script send its commands to the correct port. WebVision's ARexx port is called 'WebVision.1'.

The following commands are available.

QUIT FORCE/S Ends WebVision.

HIDE Hides (iconifies) WebVision.

SHOW Shows (pops up) an iconified WebVision.

INFO ITEM/A According to the given parameter the result string is filled with the following contents:

   - "title"       Title of the WebVision

   - "author"      Author of the WebVision

   - "copyright"   Copyright message

   - "description" Short description

   - "version"     Version string

   - "base"        Name of the ARexx port

   - "screen"      Name of the public screen

HELP FILE/A A list of all ARexx commands available in WebVision is written into the given file.

INSERTSITE NAME/A,COMMENT/K,HOMEPAGEURL/K,IMAGEURL/A,DELAY/K/N,REFERER/K, HEADERS/K,SAVEDIR/K,SAVEFILE/K,SAVECOMMENT/K,SHOWONSTART/S,AUTOSAVE/S, NODISPLAY/S,ADULT/S,SHOWNOW/S

This command is mostly meant for internal use, but it is documented in case you find a nice use for it. WebVision uses it internally when being started a second time with a camera site specified on the commandline. The newly started WebVision sends this command to the existing copy, and then quits.

The command inserts a new camera site in the list of sites, and optionally shows it. The arguments are as follows:

NAME/A - Name of the camera site as it will appear in the list.

COMMENT/K - Comment.

HOMEPAGEURL/K - Homepage URL.

IMAGEURL/A - Image URL.

DELAY/K/N - Refresh delay. 0 for continous, -1 for disabled. 30 is default.

REFERER/K - HTTP Referer string.

HEADERS/K - User HTTP headers.

SAVEDIR/K - Directory where to save camera images.

SAVEFILE/K - Filename of saved camera images.

SAVECOMMENT/K - Comment of saved camera images.

SHOWONSTART/S - If specified, WebVision will show the camera when starting up.

AUTOSAVE/S - Autosave enabled.

NODISPLAY/S - Don't display images.

ADULT/S - Sites displays adult material.

SHOWNOW/S - If specified, WebVision will open the display the site immediatedly after inserting it into the list.

Example script

/* get results */

options results

/* talk to WebVision */

address WebVision.1

/* show which version of WebVision we are running */

'info version'
say "Running " || substr(result, 7)

/* insert a way cool site */

'INSERTSITE "Party on" COMMENT "Always life at Durdham Hall" "http://sis.bris.ac.uk/~sk8466/trgutta.jpg" DELAY -1 SHOWONSTART SHOWNOW'