drawboard.sourceforge.net
Drawboard Manual v 151 last changes: 20 Jan 2004 Content * License * 1 Operating manual + 11 Blackboard + 12 Colorpicker 121 Rainbow 122 Grayscale 123 Old color set 124 Current color 125 New color preview + 13 Menu 131 Tool select 132 Thickness select 133 People counter 134 Reset button 135 Clipboard 136 Connection indicator 137 Copyright information + 14 Clipboard 141 Clipboard selector 142 Clipboard preview 143 Copy button 144 Show clipboard 145 Empty clipboard + 15 The "onlyview" mode 151 "Onlyview" applet configuration 152 Useful informations * 2 Installation + 21 Paths and directories + 22 HTML file + 23 Running server + 24 Server command line switches + 25 Image saving 251 Why PNG format?
you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 21 of the License, or (at your option) any later version. This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this software; As you see, it can be divided to three parts: blackboard, colorpicker and menu. Color of your pen is selected with colorpicker, tool - by clicking menu. When cursor is in "WAIT" mode, you have to wait for connection with server. NOTE: you can pick color by clicking with right mouse key on blackboard. Four earlier colors are moved one cell up (fifth, oldest color is lost). You can revert to one of the old colors by clicking selected square. You can select new color by clicking rainbow, grayscale or old color set. When you drag mouse (with mousekey pressed), the current color changes in realtime. NOTE: Menu can be customized by applying the "skins" (like WinAmp). In this case location and appearance of buttons can be completely different. If you have problems with modified design, write to your webmaster. Click to set start of line, drag mouse to the end of line and relase the mousekey. Click to set one corner, drag mouse to the opposite corner point and relase the mousekey. Click to set center point, drag to define ellipse size and relase the mousekey. Indicate place and use keyboard to enter characters 132 Thickness select Click the desired line to set current thickness. The line thickness affects freehand, line, rectangle and ellipse tools. The number tells you, how many people are currently connected to the Drawboard. The blackboard's background color is set to current color by default. If background image feature is used, this button will refresh the current background image. If the connection is lost, applet sets the "WAIT" cursor style and tries to restore it. Remember: all, what you draw during disconnection phase, will be lost. At reconnect whole image will be re-fetched from server. As you see, clipboard panel can be divided to five parts. If your webmaster allows it, you can save image to the file on server and/or send it to e-mail address. There can be one (or a few) drawing persons and much more thin-client students with read-only whiteboards. Notice, that in this case countercolor, menubgcolor, emptythumbnailcolor, skindef, menubgimagetransparentcolor, menubgimageoffsetx and menubgimageoffsety are no longer useful. jar file with compressed class files and skin directory with default skin files. The doc directory contains this documentation and you can delete it at your will. If you have account on Unix machine, create public_html dir in your home directory and unzip there Drawboard files. html - if doesn't work, ask your local admin for details. You have to load your WWW document to your vrowser through Apache (even on the same host). If you load local file, Drawboard will not be able to communicate with anybody. jar" WIDTH="600" HEIGHT="450"> </APPLET> Don't change "Main" to "main", whole text between quotation-marks is case-sensitive. Attention - Drawboard is distributed in JAR package since v 071. Server in the drawboard root directory (where HTML file is). Running server from other directory can cause problems, see p 24 and 25 You can treat server as a daemon and run it from startup scripts. You can also use the screen or nohup Unix utility to prevent server process kill at logout. class in drawboard directory, but Java treats this notation like "run instance of Server class from drawboard package" and everything works fine. You don't have to recompile anything before running server. This value must be equal to width parameter in HTML applet definition (see p 31). This value must be equal to height parameter in HTML applet definition (see p 31). Server and client must use the same port number to communicate. If you enable this funtion, server will handle additional socket. Anyone connecting to this socket will receive number of current users as a series of ASCII characters ('0' for zero, '14' for fourteen and so on). You can use this function with an CGI script to show number of users in your WWW page. It's recommended to disallow connection with this port from outer network. If you enable this funtion, server will send PNG file with current image to anyone connecting this port (and terminate connection immediately). You can use this function to preview current image on your WWW page. It's required to allow connection with this port from outer network. If you enable this funtion, you will be allowed to change bacground image at any moment. Just connect to desired socket and send as first and only line remote filename (relative or full path) or full URL to image (with "http://" at the beginning). Server will send answer string with "OK: " if image was loaded successfully or "ERR: " and error description, if it was failed. Notice, that users will see new bgimage after first image reset, not immediately. It's recommended to restrict connection with this port from outer network. "Ping" checks the connection and updates the people counter. Remember this is importand only for a few very first clients.
When this option is turned on, user can save his (Drawboard) clipboard content in a file on remote server host. Files are stored in directory indicated by -savepath option. This should be absolute path to directory with write permissions. This directory is relative to one, where you run server!
When this option is turned on, user can send his images through e-mail (using -smtp value as a SMTP host and -from as a "From:" field). The default value is nobody@localhost, but it won't work in most cases. The default value is localhost, but it won't work, if current host doesn't handle SMTP connections.
Notice, this option does not affect server messages nor user interface. If you define background image, Reset button will cause refresh this image, not fill board with specified color. You can specify local image file location or full URL to image. If file is not found, has incorrect dimension or wrong format, simple screen erase is performed. Server -d 60 -m 8 -savepath /tmp/ 25 Image saving There are several issues in image saving. If user requests saving his clipboard content, he transmits compressed data to server. Server creates PNG file and saves it in desired directory. Image can be saved if there is a Save image button under the image in clipboard viewer (p. It produces small, loseless files and handles true-color palette. In opposite GIF supports only 256 color palette and is copyrighted, JPEG saves images with quality loss. Drawboard server can be run at any operating system with JVM. The only difference is path indication in -savepath option. On Unix hosts write -savepath /home/user/images_to_save , on Windows -savepath d:\temp or -savepath "c:\My documents" for paths including spaces. If you are using multiuser OS, remember, that indicated directory must have write permissions for server process. We have tested this mechanism with Windows, Linux and Irix, and it worked. If you are defining relative path to image saving directory, you must run Drawboard server from base directory. html f...
|