----------------------------------------------------------------------- The TOYBOX.PRG module is copyright 1991 W.D.Parks. All rights Reserved. It may be freely distributed as long as this text file is included with it and if neither the program nor this text file are altered. ----------------------------------------------------------------------- 22 February, 1991 Hear Ye, Hear Ye... Let it be known that Dr. Bob's Modules Disk #1 is in the home stretch. All modules are completed, tested and documented with a coordinated style to match the v2.0 manual. ------------------------------------------------------------------------- Contents ------------------------------------------------------------------------- DB_Gem A 'most excellent' GEM Meta file reader that provides for easy resizing and zooming of teeny tiny areas too! Save to ClipBoard or Main Image. Easy operation! ------------------------------------------------------------------------- MultiCap Capture up to 50 screens into MVG's main image. Preserve or overwrite MVG's image. Number of screens, of course, depends on available memory. ------------------------------------------------------------------------- LoadQuad Load 4 Degas files (PI3/PC3) into a large 1280x800 image. You pick the file. You pick the quadrant. ------------------------------------------------------------------------- MultiLoad Load up to 99 Degas files (PI3/PC3) into one very very tall image. You pick the file. You pick the slot. You made a mistake? No problem. Erase, Delete, Insert and even copy one slot to another. Preserve existing image. Number of files limited by available memory up to a max of 99! ------------------------------------------------------------------------- ToCells Convert a normal bitimage into a grey-scaled file for use with ReadGRY. Select weighting. ReadGRY Convert grey-scaled file back into bi-level bitimage with variable brightness and size x1, x2, x3 or x4! Offers an excellent half-toning function even better than my pal Floyd... This is the best way to enlarge a dithered or toned image! (sister to ToCells) ------------------------------------------------------------------------- GE File Graphic Examiner (for the stout of heart) reads ANY file from disk and displays as a bitimage. Great for modifying those title screens that are plain raw images. Also great for extracting imbedded mouse icons and whatnot. You tell it the width and height. Scrolling etc... WriteRaw Write you image as a plain raw bitimage, no header, no file format, no tricks, just raw image. For application title screens (sister to GE File). ------------------------------------------------------------------------- (tba) Even more! ------------------------------------------------------------------------- ToyBox Oh boy! This is a cache of small utilities, all centered around a clipping box. Provides Resizing, Tiling, Blitting, Masking Patterns and Rotating in single degree steps. Oh Boy = This one's for FREE! Right here in this ARC file! ----------------------------------------------------------------------- ----------------------------------------------------------------------- The TOYBOX.PRG module is copyright 1991 W.D.Parks. All rights Reserved. It may be freely distributed as long as this text file is included with it and if neither the program nor this text file are altered. ----------------------------------------------------------------------- ----------------------------------------------------------------------- ------------------------------------------------------------------------- ----------------------------------------------------------------------- All of the modules are designed to be used with MVG. They are NOT stand-alone programs but utility modules for MVG. On Modules Disk#1, the TOYBOX requires MVG v2.0. All others will also work with MVG 1.3. ----------------------------------------------------------------------- ------------------------------------------------------------------------- MVG Modules Disk #1 Price: $29.95 from WizWorks! Post Office Box #45 Girard, OH 44420 216 539-5623 chk/mo/cod/visa/mc $1.00 shipping all orders No surcharge on Visa/MC ------------------------------------------------------------------------- ------------------------------------------------------------------------- ------------------------------- Date : 02/12/91 Title : TOYBOX.prg MVG ver: 2.0+ Purpose: Multiple sub-functions Author : W.D.Parks ------------------------------- The TOYBOX contains 5 separate functions (or toys;). All of the functions in the TOYBOX are designed to work their magic within a rectangular area similar to MVG's clip box. Each will await this box's definition and then proceed to its own special dialog. Although MVG's clip box uses fullscreen crosshairs to provide an accurate alignment, the TOYBOX reverts to the standard GEM (or AES) stretch box. The reason for this is twofold; the second reason being that many MVG users expressed their desire to use just this kind of box rather than MVG's method. So this TOYBOX is also an experiment; Maybe MVG's clip box will be redesigned... maybe it won't... Let's Cover starting a box, this new old way. Each item in the main dialog will first ask for a clip box. The standard arrow icon is used while it waits for you to set the TOP-LEFT corner. o Position the arrow where you want the TOP-LEFT of the clip box o Press and Hold the left mouse button... o While holding the button, stretch the box to the desired size. o Release the button. The box is drawn and a marker is placed in it's LOWER-RIGHT corner to facilitate any further resizing. To resize the box, click on the marker and while holding the button drag the box to the new size (larger or smaller). To move the box, click anywhere within it and, while holding that same ol' button, move it to the new position. When all is as you want it, click the RIGHT mouse button and away we go! Got that? ;-) Ok. The main dialog (or main menu): [Cancel] will, of course, cancel any changes and return to MVG. [OK] will save the current screen back to MVG's main image and exit the TOYBOX. The Image size is not altered. The image is. What this points out is, you can scroll your image in MVG to the area that you want. You are not limited to the top left corner nor to a fixed sized image. [-> ClipBoard] allows you to save the current screen to MVG's Clipboard (not the main image buffer) and allows you to continue playing with another toy. (this is a one-shot deal. [OK] will ALWAYS write to the main image. [->ClipBoard] always overwrites whatever was in the ClipBoard.) Note: [Cancel] does NOT undo any writes to the CLipBoard. [the Header Bar] allows you to RESTORE the original screen. This way, you can re-start... The Toys --------------------------------------------------------------------- RESIZER: Allows you to enlarge or shrink the image in the clip box. Default at powerup is 100% (or no change). You can select any percentage from 1% to 400% by using either the dialog's arrow buttons or the keyboards "+" and "-" keys. Additional keys: Cursor Up/Down: Adjust Height % only. Cursor Left/Rgt: Adjust Width % only. Undo: Reset both to 100% Home: ReSynch Width and Height to lower of the two. Return/Enter: Draw Notes: Clip's original dimensions are shown in headerbar area. Resized dimensions are shown in lower white box. Maximum resize is 400% or 640x380, whichever comes first. (or... to screen edges) --------------------------------------------------------------------- PATTERNIZER: This allows you to cover the clipped area with a pattern. The initial design was to overlay any black area with a pattern, making the area into that pattern (but only the pixels that were set). Then WHITE was provided for also, allowing you to overlay only the white (or un-set) pixels. Finally, you can select any of the operating system's logical write modes 1-14. What this does is allows you to write a pattern to the screen in any of the 16 VDI writing modes. Masking is performed by the operating system's VDI. A variety of results can be achieved. The two most common selections (Black-only and White-only) and their inverses are provided for as dialog buttons. Other write modes are selected by the small arrow keys on either side of the Mode Number. All 36 GEM patterns are accessible by either the dialogs arrow buttons (the larger arrows) or by the keyboard's "+" and "-" keys. When selecting the various write-modes, the PATTERN is the SOURCE and the IMAGE is the DESTINATION (S=Source, D=Destination). VDI write-modes: 0 not enabled 8 /S .OR. /D 1 S .AND. D 9 /S .XOR. /D 2 S .AND. /D 10 /D 3 S (replace) 11 S .OR. /D 4 /S .AND. D 12 /S 5 D (no change) 13 /S .OR. D 6 S .XOR. D 14 /S .AND. /D 7 S .OR. D 15 not enabled Notes: [BLACK] is write mode #1, S AND D [BLKrvs] is write mode #4, /S AND D [WHITE] is write mode #7, S OR D [WHTrvs] is write mode #13, /S OR D "/S" is NOT(S) NOT(SOURCE) NOT(pattern) "/D" is NOT(D) NOT(DESTINATION) NOT(image) .AND. = Boolean AND, 1 and 1 =1 1, only if BOTH are 1 1 and 0 =0 0 and 1 =0 0 and 0 =0 .OR. = Boolean OR, 1 or 1 =1 1, if either are 1 1 or 0 =1 0 or 1 =1 0 or 0 =0 .XOR. = Exclusive OR, 1 xor 1 =0 1, if only one is 1 1 xor 0 =1 0 xor 1 =1 0 xor 0 =0 NOT = inverse NOT(1) =0 ( 1's becomes 0's, 0's becomes 1's) NOT(0) =1 ( ditto) --------------------------------------------------------------------- CELLULIZER: Hands-off operation. Clip Box and Cellulizer will place as many as will fit onto the screen in rows and columns. OK and CANCEL are only selections. --------------------------------------------------------------------- BLITTERIZER: Almost hands-off operation. Clip box and Blitterizer will BLIT up to a thousand copies onto the screen in random locations. Options are 100, 200, 300, 500, 750, 1000 times or Cancel. 02/21/91 New Option: Blit Once! In Center! --------------------------------------------------------------------- ROTATIZER: Rotate the clipped area in single degree increments from 1 to 90. Since this is only a toy, a few defaults have been assigned and are not alterable: The center of rotation is always the upper left corner and rotation is always counter-clockwise (or leftward). The method used here is exceptionally fast but the rotated image is not displayed until rotation is complete. There will be a short period when nothing seems to be happening. Fear not. Plenty is going on! The ROTATIZER uses a highly optimized assembly routine complete with custom floating point math and trigonomic functions. All the design, coding and optimization is the sole work of our dear doctor (with a little help from his friends, namely, a 32 year old highschool text book, two #2 pencils, one eraser, a clicking ball-point pen and a few pages of quadril paper ;) Either the plus and minus buttons in the dialog or the keyboard's "+" and "-" keys will step the percentage. A percentage of 0 will exit with no changes made. ----------------------------------------------------------------------- NOTES ----------------------------------------------------------------------- The TOYBOX uses four screen buffers which total 128k in addition to the space used by the program code itself. RAM required by ToyBox is 161k. ----------------------------------------------------------------------- The TOYBOX.PRG module is copyright 1991 W.D.Parks. All rights Reserved. It may be freely distributed as long as this text file is included with it and if neither the program nor this text file are altered. ----------------------------------------------------------------------- All of the modules are designed to be used with MVG. They are NOT stand-alone programs but utility modules for MVG. On Modules Disk#1, the TOYBOX requires MVG v2.0. All others will also work with MVG 1.3. ----------------------------------------------------------------------- Bye: Dr. Bob