+========================================================================+ = = =   = =  Spots version 1.1  30-08-'92 = =   = = = =   = =   Spots - DocFile.   = =   © ASWare '92   = =   by: Ekke Verheul   = =   = = = +========================================================================+ +========================================================================+ = = = SERIOUS DISCLAIMER = = = = Spots is in the Public Domain. = = = = This program may be distributed in free electronic form, via = = bulletin board or as part of a fully non-commercial and freely = = redistributable disk. This manual and the examples (if any) must = = be included, without modification, in any copy. All other rights = = reserved. No warranties are made. All use is at your own risk. = = Neither ASWare nor the author assume any responsibility or = = liability whatsoever with respect to your use of this software. = = = +========================================================================+ WARNING: You need "arp.library" when you're working with WBench 1.3! ------------------- QUICK START: 1. Start "Spots" from WorkBench. 2. Press the "SPACE", "RETURN" or "HELP" key. 3. Press the Left Mouse Button - place a spot somewhere. 4. Handle the color-requester; give it some color. 5. Goto "2" a number of times. 6. Select "ACTION/RENDER" from the menu. 7. Wait, wait, wait... and look! It's pretty! 8. Read the rest of this manual. SCREENSIZE ------------------------------------------------------------- The picture will get the size of one of the standard DPaint4 HAM sizes. The overscan bordersize will be taken from the WorkBench. Possible sizes are: PAL : 320x256, 352x283, 368x290 NTSC : 320x200, 352x240, 368x241 MANUAL ----------------------------------------------------------------- ------------------- MENU OPTIONS: +----------+------------+-------------+--------------------------------+ | Picture | Action | Edit | | +----------+------------+-------------+--------------------------------+ | Save HAM | Edit | Load Spots | | Save RGB | Render | Save Spots | | About | Run Script | New Spot | | Exit | Break | Edit Spot | +----------+------------| Delete Spot | | Kill All | +-------------+ Save HAM (R-Amiga-"H") *-------- Save the visable screen as a HAM picture. "Spots" does not save color- information, the only register that matters is color 0 - it should be black. Make that black in DPaintIV before you use this picture or anim. Save RGB (R-Amiga-"G") *-------- The more professional users will appreciate this option. All Spots-pictures were rendered in 24-bits, so why not save it. These files can be used in ADPro, Real3D, PageStream, ect. or displayed with AVideo, DCTV, IV24, ect. About *----- Hmm, a not very usefull copyright thing... Exit (R-Amiga-"Q") *---- Exits the program without warning (!). Edit (R-Amiga-"E") *---- This "action" must be used to add/change/delete/load/save spots. The HAM picture will be lost but the RGB information will be valid until the next "render". Render (R-Amiga-"R") *------ Renders a HAM (and RGB) picture directly into the bitmap - don't use the menus in the beginning; it will corrupt the picture. Run Script *---------- The scripts to run must contain the following two commands: . . ----------------------------------------------------------------------- . +-- has no fuction yet, maybe later? :-) . | . | +-- value between 0 and the screen-width . | | . | | +-- value between 0 and the screen-height . | | | . | | | +-- blue value, -255 'till 255 . | | | | . | | | | +-- green value, -255 'till 255 . | | | | | . | | | | | +-- red value, -255 'till 255 . | | | | | | . v v v v v v . . POINT [comment] . . ----------------------------------------------------------------------- . +-- must be one of those . | . | +-- the filename may contain spaces, . | | but don't add any comments! . v v . . RENDER . . ----------------------------------------------------------------------- . . All lines NOT beginning with "POINT" or "RENDER" will be ignored. . A "spotlist" file holds all "POINT" commands for one picture. Break (R-Amiga-"P") *----- This action will be chosen by "Spots" when "Render" or "Run Script" were ready. Now you can save the picture or choose "Edit". Load/Save Spots (R-Amiga-"L"/"S") *---------- A spotlist-file holds all information for one picture. The file looks like a script but contains only "POINT" commands. All spotlist-files saved by "Spots" start with "/********** SPOTS **********/" in the first line. This line must stay intact, but all POINT's can be changed in an editor. These files can be easily changed to scriptfiles. New Spot (R-Amiga-"N") *-------- Place a new spot on the screen. There are three keys for this action too. After you've placed the spot a color-requester will appear. Give the spot the color you want (R,G,B from -255 to 255) and place a new one or render. Edit Spot (R-Amiga-"C") *--------- Reset the color information for the active spot. Delete Spot (R-Amiga-"X") *----------- Delete the active spot. The next (or previous) spot will become active. Kill All (R-Amiga-"K") *-------- Delete all spots. ------------------- KEYS: HELP, RETURN or Space *--------------------- Create a "New Spot". TAB *--- Activate the next spot in the list. Esc *--- WorkBench to front (the ONLY way!); render will continue. Del *--- Mousepointer on/off, like in DPaint. ------------------------------------------------------------------------ Have fun, ASWare, Ekke Verheul Postbus 2521 3000 CM Rotterdam The Netherlands