home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1998 May / Pcwk5b98.iso / WEBSERVE / WEBMED / README.TXT < prev    next >
Text File  |  1997-09-18  |  10KB  |  278 lines
  1. ======================================================================
  2.   This package contains binaries of the Personal Web Media (PWM)
  3.   system for the Windows 95/NT operating system
  4. ======================================================================
  5.  
  6. developed at the Distributed Systems Dept, University of Ulm.
  7. For licence information read the file licence.txt.
  8.  
  9.  
  10. What is it?
  11. ===========
  12.  
  13. PWM is a live video and audio server that looks like a web server to 
  14. web clients. It grabs images from your local camera and distributes it 
  15. as an inline realtime-movie. Audio is recorded from the sound input
  16. device and provided as a GSM or ADPCM stream. PWM includes a small 
  17. WWW server (HTTP server).
  18.  
  19.  
  20. Requirements:
  21. =============
  22.  
  23. To use WebMedia you need a Windows95 PC with framegrabber and camera.
  24. (PWM will run with NT too but we did not that much testing.)
  25.  
  26. The video has been tested with these framegrabber-cards:
  27.  - MiroDC 1, MiroDC 20, MiroDC 30
  28.  - FAST Movie Machine, Movie Machine II
  29.  - Creative Labs Video Blaster SE100 (Bernie Breton<bcb@eng.cam.ac.uk>)
  30.  - Creative Labs Video Blaster RT300
  31.  - Winnov Videum (Blake Stewart <blake@mail.ntu.edu>)
  32.  - Intel Smart Video Recorder III (Blake Stewart <blake@mail.ntu.edu>)
  33.  - PCI Stinger videoboard (M.E. Kraan <info@widexs.com>)
  34.  - Connectix ColorQuickCam, B/W QuickCam
  35.  - Cardinal SnapshotPlus (tele monster <telmnstr@norfolk.infi.net>)
  36. It works with other grabber cards. Please drop us a note if you 
  37. succeeded using other cards.
  38.  
  39. A soundblaster 16 compatible soundcard is required to record audio.
  40. Fullduplex audio communication is possible with soundblaster driver
  41. version 4.30 (win 95) and 4.04 (NT) or higher.
  42.  
  43.  
  44. Who did it?
  45. ===========
  46.  
  47. Heiner Wolf <wolf@informatik.uni-ulm.de>
  48. Travis Heppe <>
  49. Rainer Birkenmaier <rbirkenm@hydra.informatik.uni-ulm.de>
  50. Theo Gross <tgross@hydra.informatik.uni-ulm.de>  
  51. Stephan Schmid <sschmid@hydra.informatik.uni-ulm.de>
  52.  
  53. Thanks to:
  54.  
  55. Konrad Froitzheim <frz@informatik.uni-ulm.de> for lots of comments and advice
  56. Holger Boenisch <hb@vs.informatik.uni-ulm.de> for testing and optimisations
  57. Steven Duntley Halpape <Username@ix.netcom.com> for the IRIX port
  58. Scott Furman <fur@netscape.com> for integration of GIF-streams into NETSCAPE 
  59. Tom Lane <tgl@netcom.com> for the JPEG library
  60. Thomas Boutell <boutell@boutell.com>
  61. ... and hundred thousends of beta testers who operated the interactive 
  62.     model railroad http://rr-vsinformatik.uni-ulm.de/rr/
  63.  
  64.  
  65. Files:
  66. ======
  67.  
  68. README.txt:                this file
  69. LICENSE.txt:               another file to read
  70. pwm.cfg                       settings file
  71. webmedia.exe   <----       executable binary
  72. notify.wav                 Notification sound
  73. htdocs\JPEGtest.html       html text example for video with MJPEG
  74. htdocs\GIFtest.html        html text example for video with animated GIF
  75. htdocs\comm.html       html text example for combined audio/video
  76. htdocs\[other files]       default web conferencing files
  77. webmedia.hlp               Windows online help file
  78.  
  79.  
  80. Usage:
  81. ======
  82.  
  83. - The unpacked archive is ready to use, simply start 'webmedia.exe'.
  84.  
  85. - Currently there are two video output modes:
  86.   1) a server-pushed sequence of JPEG compressed frames. Use this one, 
  87.      if more than half of the image is changing between frames. 
  88.   2) a infinite animated GIF sequence. Use this if only small regions (1/3) are
  89.      changing between frames.
  90.   MPEG output and diference JPEG is under development.
  91.  
  92. - If the grabber card provides JPEG compression and you want to serve 
  93.   in mode 1) then set the compression of the grabber card to JPEG.
  94.  
  95. - If you want to serve in mode 2) then set the grabber card to 24 bit
  96.   RGB-data output. 
  97.  
  98. - There are three example files for testing the WebMedia server:
  99.   1) JPEGtest.html
  100.   2) GIFtest.html
  101.   3) comm.html (JPEG+audio)
  102.  
  103. - Access them at http://webmediahost.domain/JPEGtest.html
  104.  
  105. - WebMedia writes some log files while running.
  106.  
  107. - The WWW file server will serve html, htm, gif, jpeg, jpg, sdf and class files 
  108.   with a proper Content-type. The WWW server's toplevel directory is relative
  109.   to the working directory of the binary: $WORKING_DIRECTORY_OF_WEBVIDEO\htdocs
  110.   Paths below this directory are allowed. There are no cgi's and no ways to 
  111.   configure the built-in WWW server beyond the basic functionality and the
  112.   server's toplevel directory.
  113.  
  114. - Settings are read at startup from the config file. The file is written 
  115.   at shutdown time. Do not edit it while WebMedia runs. Your changes will be 
  116.   overwritten. 
  117.  
  118. Tips:
  119. =====
  120. - Adapt the file comm.html to your needs, but leave it where it is. 
  121.   People try to reach you by accessing your default commpage (comm.html). 
  122.   WebMedia will provide audio and call answer capabilities in order to 
  123.   serve as a WWW based picturephone.
  124.  
  125. - The default personal information files contain a structured version of
  126.   the information, which is available on many users' homepages. The 
  127.   information will be used by conferencing services. E.g. the personal 
  128.   image/icon is used to represent the user. Provided information will 
  129.   be used to enhance conferencing services, but there is NO means to store
  130.   or change information from the network. REALLY.
  131.  
  132. - Default names of personal images are:
  133.   image.jpg, image.jpeg, image.gif and icon.gif
  134.   You can replace the provided icon.gif with your picture. An icon is the 
  135.   small version (32x32), an image is the large version of your picture.
  136.  
  137. - The notification sound can chosen by a file select dialog. the default is  
  138.   notify.wav.
  139.  
  140. - You can create your image.jpg easily using the "file/save image" menu 
  141.   command. Hint: save it into WWW server directory (this is the default). 
  142.  
  143. - Don't be confused, if you read about a program called sswin. Once upon
  144.   a time it was called sswin. But it grew up, married and became the Win95
  145.   version of WebMedia.
  146.  
  147.  
  148. Changes:
  149. ========
  150. 1.6.2
  151. new GUI (menu structure and dialogs)
  152. second version of framerate control
  153. PWM related directories/files (e.g. notification sound file) may now contain
  154. space characters
  155. some NT debugging
  156.  
  157. 1.6.1
  158. first stable PWM version due to various bug fixes
  159. first version of dynamic framerate control
  160. MMX support added for differential GIF
  161.  
  162. 1.6 
  163. Marriage of WebVideo and WebAudio to Personal Web Media (PWM)
  164.  
  165. 1.5.2
  166. less load while no client connected and if local display off 
  167.  
  168. 1.5.1
  169. support for !(JPEG || RGB) grabber. works hopefully for VideoBlaster RT300
  170. several algorithmic optimisations in GIF encoding
  171. write JPEG image.jpg snapshot even with RGB grabbers
  172. enhanced file select boxes
  173. removed YUV-based motion detection
  174.  
  175. 1.5
  176. fixed memory leak in the difflib (affects gif-part).
  177. streams are triggerd by the connections -> reduced system load.
  178. separated connect notification and acknowledge.
  179. choose video input device from config file
  180. a lot more minor fixes.
  181.  
  182. 1.4.5
  183. added support for B/W QuickCam
  184. added .sdf as MIME-type application/x-sdf to WWW server
  185. fixed memory leak in makeDiff
  186.  
  187. 1.4.4
  188. support for ColorQuickCam
  189. HTTP server: better support for user detail files 
  190.  
  191. 1.4.3
  192. fixed HTTP reply header for animated GIF
  193.  
  194. 1.4.2
  195. menu cosmetics
  196.  
  197. 1.4.1
  198. beep, when acknowledge dialog appears
  199. icon cosmetics
  200.  
  201. 1.4
  202. added list of connections
  203. acknowledge connections
  204. save and restore settings in a single settings file
  205. rearranged menus
  206. added http server
  207. debugging
  208. enhanced online help
  209.  
  210. 1.3
  211. added animated GIF
  212.  
  213. 1.2
  214. first release of WebVideo as http server
  215.  
  216. 1.2 - 1.0
  217. grabs video and sends it to the Unix streamserver
  218.  
  219.  
  220. Known Bugs:
  221. ===========
  222.  
  223. - The connected host display does not always update, if clients leave.
  224. - Many, many clients drive the program crazy. Even disconnecting them 
  225. does not help.
  226.  
  227.  
  228. Troubleshooting:
  229. ================
  230.  
  231. if (webvideo starts) then
  232.    if (crashes immediately) then
  233.       restart Windows 95
  234.       try {
  235.          change the grabbed data format to RGB 24 bit or MJPEG (if available)
  236.          using the MSDOS-box program vidconf.exe . Vidconf will show the 
  237.          source and format control panels of any frame grabber driver if 
  238.          they are supplied by the driver.
  239.       } else {
  240.          send email to rbirkenm@hydra.informatik.uni-ulm.de or
  241.                        wolf@informatik.uni-ulm.de 
  242.       }
  243.    else if (no local video visible) then
  244.       video input might be wrong
  245.       try {
  246.          changing the video input using the options/source menu
  247.       }
  248.    else if (no video in Netscape) then
  249.       URL in HTML file might be wrong
  250.       change the hostname of the IMG SRC URL to the host running webvideo
  251.    endif
  252. endif
  253.  
  254. History:
  255. ========
  256. 05.11.96 Rainer Birkenmaier rbirkenm@hydra.informatik.uni-ulm.de created
  257. 05.11.96 Heiner Wolf wolf@informatik.uni-ulm.de changes
  258. 07.11.96 hw added FAST card, Troubleshooting and WWW server description
  259. 12.11.97 hw added Quickcam
  260. 21.01.97 hw added Creative Labs Video Blaster SE100
  261. 10.02.97 hw adapted for version 1.4
  262. 12.02.97 hw added 2 grabber cards
  263. 13.02.97 hw added Changes section
  264. 17.02.97 hw ver 1.4.3
  265. 25.02.97 hw fiddled around to prepare for next version
  266. 03.03.97 hw ver 1.4.4
  267. 22.04.97 hw ver 1.4.5
  268. 09.04.97 rb new beta version (1.5.beta1) released.
  269. 08.05.97 hw 1.5
  270. 21.05.97 hw 1.5.1
  271. 26.05.97 hw 1.5.2
  272. 31.07.97 rb + S. Schmid merged WebVideo and WebAudio
  273. 20.08.97 H. Boenisch added MMX support
  274. 31.08.97 rb + hb 1.6.1
  275. 15.09.97 hb 1.6.2
  276.  
  277.  
  278.