home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / gamegif / grafwk48.lzh / GRAFWORK.DOC < prev    next >
Text File  |  1990-11-10  |  66KB  |  1,427 lines
  1. GRAPHIC WORKSHOP 4.8
  2. __________________________________________________________________
  3.  
  4. If you like this program, please do one of the following:
  5.  
  6.     Go down to your local bookstore and buy a copy of "Coven: A 
  7.     Novel", by Steven William Rimmer, published by Ballantine 
  8.     Books. Read the book and tell your friends about it if you 
  9.     like it. Send us some comments about the book or a photocopy 
  10.     of the cover and we'll consider you a registered user of this 
  11.     program.
  12.  
  13.     If your local bookstore doesn't have Coven, ask them to order 
  14.     it for you.
  15.  
  16.     Alternately, send us $35.00, the normal user fee for this 
  17.     software. (The book is $3.95 or $5.50 in Canada: considerably 
  18.     cheaper than cash.) 
  19.  
  20.     Printed documentation for Graphic Workshop is available to 
  21.     registered users for $10.00 extra.
  22.  
  23.     Registered users of this software are entitled to phone 
  24.     support, notification of upgrades and good karma. When you 
  25.     register Graphic Workshop we'll send you a copy of the latest 
  26.     version, as well as several other graphic related programs we 
  27.     do. Please tell us the version number of your copy of Graphic 
  28.     Workshop when you register. Our address can be found at the 
  29.     end of this file.
  30.  
  31. NOTE: If you're searching for Coven and having trouble finding 
  32. it, you can mail order it from the following book store: 
  33. Christies of Cookstown, P.O. Box 392, Cookstown, Ontario L0L 1L0, 
  34. Canada, (705) 458-1562. The cost is $6.50, which includes 
  35. the postage. The author would like to thank everyone who's thus 
  36. far chased it down (or tried).
  37. __________________________________________________________________
  38.  
  39. ----> NEW:     Pictor/PC Paint support
  40.         Windows 3 BMP support
  41.         Image Scaling
  42.         Windows 3 PIF and icon
  43.         TIFF and LBM details
  44.         Grey scale TIFF support.
  45.         WordPerfect Graphic file support.
  46.         Microsoft Paint support.
  47.         VGA palette adjustment.
  48.         Driver update: Please see DRIVERS.DOC.
  49.         Dot Matrix Printer support: Also see DRIVERS.DOC.
  50.         Image rotation and flipping.
  51.         IFF/LBM/CE support.
  52.         Non-dither halftoning
  53.  
  54. Welcome to Graphic Workshop...
  55.  
  56.  
  57. WHAT IT IS
  58. __________
  59.  
  60. Graphic Workshop is a program for working with computer graphic 
  61. files. It will handle most of the popular formats:
  62.  
  63. - MacPaint files
  64. - PC Paintbrush files with up to 256 colours
  65. - GEM/IMG files of the sort used by Ventura Publisher
  66. - GIF files of any size and up to 256 colours
  67. - TIFF files (with some restrictions)
  68. - EPS files... encapsulated PostScript... for some operations
  69. - WordPerfect graphic (WPG) files.
  70. - Microsoft Windows Paint (MSP) files.
  71. - IFF/LBM/CE files (from Deluxe Paint, among others)
  72. - BMP files (as found in Windows 3)
  73. - Pictor / PC Paint (PIC) files... also used by Grasp.
  74.  
  75. Graphic workshop is a simple, menu driven environment which will 
  76. let you perform the following operations on the aforementioned 
  77. files.
  78.  
  79. - View them.
  80. - Convert between any two formats (with a few restrictions).
  81. - Print them to any LaserJet Plus compatible or PostScript laser   
  82.   and many dot matrix printers.
  83. - Dither the colour ones to black and white.
  84. - Reverse the monochrome ones black for white.
  85. - Rotate and flip them.
  86. - Scale them
  87.  
  88. Using Graphic Workshop, you can have your image files in the formats 
  89. that your software wants to use them in, all without keeping 
  90. track of numerous funky utilities. In addition, using the 
  91. halftoning and dithering facilities of Graphic Workshop, you can 
  92. convert full colour digitized photographs... most notably GIF 
  93. files... for use as really excellent black and white clip art, 
  94. suitable for inclusion in your documents.
  95.  
  96. Graphic Workshop will handle image files of any size. It will use 
  97. extended or expanded memory if you have some, and disk space if 
  98. you don't. It has a fast and easily understood user interface. 
  99. Hopefully, it lacks even the merest vestiges of bugs... a likely 
  100. story, but we hope so.
  101.  
  102. Graphic Workshop will drive all of the popular display cards. At 
  103. present, it will support the following.
  104.  
  105. - CGA card (Ugh!)
  106. - Hercules card
  107. - EGA card
  108. - VGA card
  109. - Paradise Plus card
  110. - Dell super VGA card (which is actually a Paradise card)
  111. - ATI VGA Wonder card or ATI VGA Edge
  112. - Headland Video 7 
  113. - Trident 
  114. - Hercules Graphic Station card
  115.  
  116. As it comes out of the box... or out of the ZIP... Graphic 
  117. Workshop is configured like this. If you want to change some of 
  118. these parameters, see the installation section at the end of this 
  119. file.
  120.  
  121. - Attempts to autodetect the display card type
  122. - Uses expanded memory
  123. - Uses colour text
  124. - Prints titles on its hard copy
  125. - Uses the following file name extensions:
  126.     - MAC: MacPaint files
  127.     - IMG: GEM/IMG files
  128.     - PCX: PC Paintbrush files
  129.     - GIF: GIF files
  130.     - TIF: TIFF files
  131.     - EPS: EPS files
  132.     - WPG: WordPerfect graphic files
  133.     - MSP: Microsoft Windows Paint files.
  134.     - LBM: IFF files (Deluxe Paint and others)
  135.     - BMP: BMP files (Windows 3)
  136.     - PIC: Pictor / PC Paint (also Grasp) files.
  137.  
  138. FILE FORMATS
  139. ____________
  140.  
  141. A NOTE ABOUT MEMORY AND FILE FORMATS: One of the design criteria 
  142. of Graphic Workshop is that it should have enough memory left 
  143. over on a 640 kilobyte PC to be able to unpack a 640 by 480 
  144. pixel, 256 colour file without having to resort to using extra 
  145. memory, which would slow it down. This requires a minimum of 300 
  146. kilobytes plus a bit for various internal things. To achieve 
  147. this, the size of the program itself has to remain at a 
  148. reasonable degree of hugeness. This is why, for example, the 
  149. installation functions, GWSINSTL.EXE, is separate from the main 
  150. program.
  151.     The lesser used functions of Graphic Workshop, dithering, 
  152. scaling, halftoning and image transformation, have been 
  153. implemented for the GIF file format only in order to keep the 
  154. code size down. This is a bit of an inconvenience, as you will 
  155. have to convert files in other formats to GIF to use these 
  156. facilities with them, and then probably convert the results back 
  157. to the format your files started off in. However, not 
  158. implementing these features for all the formats supported by 
  159. Graphic Workshop reduced the code size of the program by 
  160. something over a hundred kilobytes by our estimates. The result 
  161. is a much faster program at the expense of a bit of 
  162. inconvenience.
  163.     A long time ago someone decided that 640 kilobytes was 
  164. more memory than anyone could possibly want. Someone should find 
  165. the person responsible and paint something easily recognizable 
  166. on his bald head, such that the rest of us will know where to 
  167. throw things.
  168.  
  169.  
  170. MacPaint files
  171. These can come in two flavours. The most common one is straight 
  172. ported MacPaint files, that is, files having the "MacBinary" 
  173. header. The other is "headerless" files, these being the ones 
  174. used with PFS:First Publisher. Graphic Workshop reads both types, 
  175. but if you convert a file to MacPaint format you can select which 
  176. of these two variations on the format you want to use.
  177.     Files converted to the MacPaint format from other formats 
  178. will be cropped or padded out as necessary to fit in the MacPaint 
  179. format's 576 by 720 format. Only monochrome files can be 
  180. converted to MacPaint files, since MacPaint in a monochrome-only 
  181. format.
  182.  
  183. GEM/IMG files
  184. There are actually quite a few variations on IMG files. Only the 
  185. monochrome ones are currently supported by Graphic Workshop. 
  186. This is the format used by Ventura for its monochrome image file 
  187. format. Any size monochrome image can be converted to this 
  188. format.
  189.  
  190. PCX files
  191. These are the files used to hold images for Z-Soft's PC 
  192. Paintbrush package. These can range from monochrome to 256-colour 
  193. images. All the various formats are supported by Graphic 
  194. Workshop. Note, however, that Graphic Workshop will allow you to 
  195. create 256-colour PCX files from GIF files which may be too large 
  196. to work with using the current version of PC-Paintbrush.
  197.  
  198. GIF files
  199. These can range from monochrome to 256-colour images in any size 
  200. you can find 'em.
  201.  
  202. TIFF files
  203. Graphic workshop supports monochrome and grey scale TIFF files. 
  204. If you convert a colour file from PCX or GIF to TIFF, the 
  205. resulting file will be a grey scale version of the colour file. 
  206. These import into desktop publishing packages such as Ventura for 
  207. sharp looking PostScript halftones.
  208.     Some applications, such as Ventura Publisher, have 
  209. trouble reading grey scale TIFF files which have been compressed. 
  210. Others, such as Corel draw, read 'em fine. for this reason, 
  211. Graphic Workshop defaults to creating uncompressed grey scale 
  212. TIFF files but you can tell it to compress them if you're sure 
  213. whatever you'll be importing them into will read them. You can 
  214. set the grey scale TIFF compression in GWSINSTL or by using the 
  215. command line switches TGN and TGC.
  216.     Note that due to the wide variations among the programs 
  217. which produce TIFF files, Graphic Workshop would be lying rather 
  218. badly if it claimed to be able to read all TIFF files. 
  219. Specifically, it does not read Huffman or LZW compressed TIFF 
  220. files as yet, as we haven't devised code to do this in a 
  221. reasonable amount of space.
  222.     In most cases you will want to create TIFF files using 
  223. the Intel number format. This is what Graphic Workshop defaults 
  224. to using, and you can safely ignore this setting most of the 
  225. time. If you need Motorola format TIFF files... for example, if 
  226. you intend to port them to a 68000 based system... you can enable 
  227. Motorola format numbers in the installer or by using the /TFM 
  228. command line switch.
  229.     When you are creating TIFF files which will be used as 
  230. desktop publishing art or in other situations wherein they'll be 
  231. printed to a PostScript printer, you should create them with 
  232. greyscale expansion enabled. If they will be displayed on a 
  233. monitor or edited in a paint program, you may want to create them 
  234. with greyscale expansion disabled. You can set the greyscale 
  235. exapnsion on or off permanently using GWSINSTL. The command line 
  236. switches /TXP and /TXN will set it temporarily when you run GWS.
  237.  
  238.     
  239. EPS files
  240. These are encapsulated PostScript files, and are not strictly 
  241. speaking image files at all. Graphic Workshop treats them a bit 
  242. differently.
  243.     Many EPS files which are created with the intent of 
  244. importing them into a desktop publishing package include 
  245. bitmapped "preview" images to be used for positioning. If you 
  246. attempt to view an EPS file with Graphic Workshop, you will see 
  247. the preview image. If there is no preview image in the EPS file 
  248. you select, Graphic Workshop will tell you so.
  249.     Graphic Workshop will print EPS files to a PostScript 
  250. printer. It will also convert other graphic files into EPS files, 
  251. suitable for use with desktop publishing programs. If you convert 
  252. a colour graphic into an EPS file, the result will be a black and 
  253. white halftone when you print it... pretty slick, this.
  254.  
  255. WPG files
  256. These are the native import graphic files for WordPerfect. These 
  257. files can contain both bitmaps and line art, or vector graphics. 
  258. Graphic Workshop can only deal with the bitmapped parts of them. 
  259. If you view, print or convert a WPG file containing both 
  260. bitmapped and vector elements, the vector elements will be 
  261. discarded.
  262.     WPG files which refuse to read with Graphic Workshop are 
  263. usually those which contain only vector elements and no bitmaps. 
  264. If you use the F4 function on a WPG file which does not read, the 
  265. comments field of the file information box will say "No bitmap" 
  266. if this is the case.
  267.     Graphic Workshop will deal with WPG files having one, 
  268. four or eight bits of colour information, that is, monochrome 
  269. files, sixteen colour files and 256-colour files. It doesn't work 
  270. with two bit files as these are exceedingly rare.
  271.  
  272. MSP files
  273. These are the image files used by the paint program which comes 
  274. with Microsoft Windows. Don't confuse these with PCX files... 
  275. some versions of Windows came with a Windows implementation of PC 
  276. Paintbrush from ZSoft as well. The two programs... and the two 
  277. file formats... are not compatible. MSP files are monochrome 
  278. only.
  279.  
  280. IFF files
  281. These started out on the Amiga. The IFF file standard is 
  282. extremely flexible, and allows all sorts of things besides images 
  283. to be stored in IFF files. IFF files are found on the PC having 
  284. been ported from Amiga systems. They are also created on the PC 
  285. by several applications such as Electronic Arts' Deluxe Paint 
  286. package and Digital Vision's Computer Eyes video scanner board. 
  287. In the first case they are given the extension LBM. In the second 
  288. they are given the extension CE. The basic file structure is the 
  289. same, however.
  290.     Note that Deluxe Paint seems to be a bit particular about 
  291. the dimensions of the LBM files it will inhale... it likes them 
  292. to fit in standard sizes, and for this reason Graphic Workshop 
  293. pads them to fit in the next larger standard IFF screen format. A 
  294. picture 512 by 392, for example, would be inset into the upper 
  295. left corner of an area 640 by 400, which keeps Deluxe Paint 
  296. happy. Because the extra area is blank, and compresses down to 
  297. almost nothing, this does not increase the file size a great 
  298. deal.
  299.     Deluxe Paint is a bit of a problem in the way it deals 
  300. with IFF files, actually. This affects 256 colour files. Its 
  301. native format is a subclass of IFF called PBM, and compresses its 
  302. images as bytes. It's somewhat unique to Deluxe Paint, and 
  303. Electronic Arts won't tell anyone quite how it works. You can 
  304. actually work it out to a large degree, but every so often a file 
  305. created in this format in the way it seems like it should be done 
  306. refuses to load into Deluxe Paint.
  307.     The standard form for IFF image files is called ILBM, 
  308. compressing all images as planes. This is much slower, but it 
  309. means that files thus compressed will be readable by pretty well 
  310. all IFF readers... even if you port 'em back to the Amiga. This 
  311. is how Graphic Workshop creates IFF files. Unfortunately, there's 
  312. a problem with Deluxe Paint which will occasionally cause it to 
  313. stop reading one of these files part way through the image. This 
  314. happens to IFF files from sources other than Graphic Workshop, so 
  315. it's probably a bug in Deluxe Paint.
  316.     If you encounter an image which, when converted into an 
  317. IFF file will not read into Deluxe Paint, use the IFN command 
  318. line switch when you run Graphic Workshop. This will disable the 
  319. IFF compression. Uncompressed files read into Deluxe Paint with 
  320. no difficulty.
  321.     You can permanently set IFF compression off when you 
  322. install Graphic Workshop if you like.
  323.  
  324. BMP files
  325. These are the files which are used as "wallpaper" under Windows 
  326. 3. They can be created using the version of PC Paintbrush 
  327. supplied with Windows.
  328.     You can convert any monochrome or sixteen colour image 
  329. into a BMP file. Graphic Workshop does not support 256-colour BMP 
  330. files as yet. 
  331.     BMP files use no image compression, as the intention 
  332. appears to be to make them really fast to load. Plan on your BMP 
  333. files being very big.
  334.     There is a very important aspect of colour BMP files 
  335. which you should bear in mind when you use this format. Windows 
  336. uses a fixed palette which PC paintbrush cannot go about 
  337. changing, as doing so would make the screen and boarder colours 
  338. change too. Thus, files converted into the BMP format have their 
  339. palettes altered to the standard BMP palette. The pixels in the 
  340. image are then remapped to represent the closest approximation of 
  341. their original colours afforded by the BMP palette.
  342.     This means that transferring an image to the BMP format 
  343. will generally result in some colour shifts. Once this is done, 
  344. you can't get the colours back the way they were unless you have 
  345. the original image file in some other format.
  346.     Note also that the colour approximation algorithm in 
  347. Graphic Workshop isn't precisely the same as the one in PC 
  348. Paintbrush, and it will occasionally produce slightly different 
  349. sets of colours than PC Paintbrush under Windows 3 would have.
  350.     It's also worth mentioning that as of this writing we've 
  351. been unable to get any official details from Microsoft on how BMP 
  352. files work. The BMP support in Graphic Workshop was written 
  353. entirely by debugging the files provided with Windows 3. As such, 
  354. there may be some holes in the BMP functions as they stand.
  355.  
  356. PC files
  357. These should not be confused with Lotus 1-2-3 PIC drawing files.
  358.     PIC files are created by PC Paint (not PC Paintbrush) and 
  359. are used by Grasp, among other things. They come in many 
  360. flavours. Graphic Workshop has been tested with the most common 
  361. ones. In theory it should support them all, but that's only a 
  362. theory.
  363.  
  364.  
  365. MEMORY REQUIREMENTS
  366. ___________________
  367.  
  368. Graphic Workshop will use whatever memory you have going. If you 
  369. ask it to do something which needs a large amount of memory, it 
  370. will try to use your normal DOS memory, which is fastest. If 
  371. there isn't enough DOS memory, it will use extra memory.
  372.     There are three sorts of "extra" memory which Graphic 
  373. Workshop can use, to wit, extended, expanded and virtual. 
  374. Extended memory is also called XMS memory, and is only available 
  375. on AT and 386 systems. Expanded memory, also called EMS or LIM 
  376. memory, is available if you have a LIM board and driver in your 
  377. machine. Virtual memory means using a big disk file and making 
  378. believe it's memory. Virtual memory is very slow compared to real 
  379. memory.
  380.     You must tell Graphic Workshop what to do about extra 
  381. memory when you install it. See the section on installation.
  382.     Graphic Workshop can run in restricted memory, such as 
  383. that which is found in a really old PC or when running "shelled 
  384. out" of another program. However, it can do nasty things when 
  385. it's really starved for memory. Some virtual memory operations 
  386. will not work in this condition, and if it's really stuck for 
  387. RAM... if there's only a few tens of kilobytes free... it may 
  388. manage to crash. Try not to run it when there's almost no room 
  389. left for it to store things. The help menu will tell you how much 
  390. memory is free.
  391.  
  392.  
  393. PRINTERS
  394. ________
  395.  
  396. You can print to any sort of LaserJet Plus compatible printer 
  397. with one megabyte of memory or more or any sort of PostScript 
  398. printer. You can print to any dot matrix printer which is 
  399. supported by a Graphic Workshop external printer driver. These 
  400. are described in greater detail in DRIVERS.DOC. Note that if you 
  401. attempt to print PostScript data to a LaserJet or a dot matrix 
  402. printer you'll get reams of meaningless ASCII text.
  403.     Graphic Workshop allows you to print a picture in four 
  404. resolution modes to laser printers, ranging from 75 to 300 dots 
  405. per inch. This will determine the resulting size of your picture.
  406.     Each page of Graphic Workshop output can include any 
  407. combination of data about the picture on it you like. See the 
  408. installation section for more information about enabling this 
  409. feature. 
  410.     The size and resolution of dot matrix printing is 
  411. determined by the driver being used. 
  412.     Note that if you have a printer for which there is no 
  413. driver available, one of the Epson FX-80 drivers will probably 
  414. work, as most dot matrix printers support the Epson FX-80 
  415. standard. The print might not be as good as your printer can 
  416. manage, but it'll be better than a blank sheet of paper.
  417.  
  418.  
  419. RUNNING GRAPHIC WORKSHOP
  420. ________________________
  421.  
  422. To run Graphic Workshop, type GWS at the DOS prompt. Depending on 
  423. your installation procedure, you may also want to type some 
  424. command line switches, as described in the installation section.
  425.     The main file screen will appear. Graphic Workshop always 
  426. shows you all the names of the image files it knows how to deal 
  427. with in the current directory, along with all the visible 
  428. subdirectory names, if any. If you are in a subdirectory, you 
  429. will also see a subdirectory entry which is two periods.
  430.     The cursor mover keys will move the file selector bar 
  431. around. If you move it to a directory entry... shown in dim 
  432. text... and hit Enter, you will move into that directory. If you 
  433. select the two period entry, you will move back up your directory 
  434. tree by one step.
  435.     If there are too many files in your current directory to 
  436. see all at once, Graphic Workshop will organize them into pages. 
  437. The PgUp and PgDn keys will step you through the pages.
  438.     If you place the selector bar on a file name and hit 
  439. Enter, Graphic Workshop will attempt to show you the file. It 
  440. will start by showing you a wait box, which has a bar graph in it 
  441. to show you the status of what you've asked Graphic Workshop to 
  442. do. When the picture is fully unpacked, Graphic Workshop will 
  443. switch to your display card's graphic mode and show you the 
  444. picture.
  445.     You can always abort an operation when the wait box is 
  446. visible by hitting the Esc key.
  447.     If the picture is larger than your screen, the cursor 
  448. keys will allow you to pan around it.
  449.     Esc will return you to the main screen.
  450.     Several things can go wrong here. If you have installed 
  451. Graphic Workshop for the wrong kind of display card, you might 
  452. see random characters rather than a picture. In this case, check 
  453. your installation.
  454.     If Graphic Workshop could not find enough memory to unpack 
  455. your picture into, it will abort the process and say so.
  456.     Finally, if your picture requires more colours than your 
  457. card can display, Graphic Workshop will tell you this. There is a 
  458. specific exception to this. Graphic Workshop will show you GIF 
  459. files having more than sixteen colours on a sixteen colour EGA 
  460. card by fudging the colours. Bear in mind that while you'll get 
  461. to see an approximation of the actual colours in the GIF file... 
  462. it will not be the real thing.
  463.     This does not work for 256 colour PCX files, just GIF 
  464. files. You must have a VGA card of some sort to see 256 colour 
  465. PCX files.
  466.     You can see how many colours a colour image has by using 
  467. the Get Info key, as discussed below.
  468.     Note that you cannot view grey scale TIFF files without a 
  469. VGA card.
  470.     In the VGA display mode... and in the super VGA modes 
  471. provided by external VGA drivers... you can make small 
  472. adjustments to the VGA colour palette while a picture is being 
  473. displayed. The 'r' and 'R' keys will increase and decrease the 
  474. amount of red in a picture, the 'g' and 'G' keys will adjust the 
  475. amount of green, the 'b' and 'B' keys will adjust the amount of 
  476. blue. The 'i' and 'I' keys will adjust the overall intensity of 
  477. the picture. The '=' key will return the picture to its normal 
  478. state. Note that these adjustments only affect the picture that 
  479. you're viewing... they do not alter the palette in the file on 
  480. your disk.
  481.     If you hear a beep while you're playing with these keys, 
  482. you've gone to the limit of whichever of the adjustments you're 
  483. using. Graphic Workshop will not allow you to adjust the palette 
  484. to the point where the picture would start looking weird.
  485.     Because Graphic Workshop will not allow you to actually 
  486. distort the colour balance of the palette, there will be some GIF 
  487. files which will not be adjustable using this feature.
  488.  
  489.  
  490. OTHER KEYS
  491. __________
  492.  
  493. If you hit "?", you'll see a menu of the keys which control the 
  494. main file screen of Graphic Workshop. This box also tells you how 
  495. much free DOS memory is available.
  496.  
  497. The Esc key will allow you to quit Graphic Workshop and return to 
  498. DOS.
  499.  
  500. If you hit "T", the currently selected file name will be 
  501. "tagged". The "U" key will untag it. The batch operations 
  502. described below will work with multiple files if you have some of 
  503. them tagged. If you hit "C", all the tags will be cleared.
  504.  
  505. If you hit "L", Graphic Workshop will allow you to log in a new 
  506. disk drive. 
  507.  
  508. If you hit "D", you will be prompted to delete the current file. 
  509. Note that this is not a batch command... it only works on one 
  510. file at a time. 
  511.  
  512. If you hit "R", you can rename the current file. Note that it the 
  513. renamed file will have the same extension as the old one, no 
  514. matter what extension you give it.
  515.  
  516. If you hit F5, Graphic Workshop will shell out to the DOS prompt 
  517. if there's enough memory. If you do this, Graphic Workshop will 
  518. still be in memory. Type EXIT at the DOS prompt to return to it 
  519. right where you left off. If you change drives or subdirectories 
  520. while you have the DOS prompt active, Graphic Workshop will 
  521. restore the previous drive and subdirectory when you return to 
  522. it.
  523.  
  524. The F10 key will show you some information about Graphic Workshop 
  525. as well as your current display adapter and memory settings. 
  526.  
  527.  
  528. GRAPHIC FUNCTIONS
  529. _________________
  530.  
  531. The graphic functions of Graphic Workshop are accessed through 
  532. the function keys. They may be used on individual files or in 
  533. batch mode. If no files are tagged, the operation you select will 
  534. take place using the file name the selector bar is currently on. 
  535. If one or more files are tagged, the operation will take place
  536. on all the tagged files.
  537.     Hitting Esc will abort any operation.
  538.  
  539. F1 - Print
  540.  
  541.     This function will print one or more files to the printer 
  542. of your choice. Hit it and a menu of printers and resolution 
  543. settings will pop up. As with all menus under Graphic Workshop, 
  544. hitting Esc will make it go away if you discover you've gotten to 
  545. it in error.
  546.     Colour files printed to a PostScript printer will be 
  547. halftoned. Colour files cannot be printed to a LaserJet or a dot 
  548. matrix printer directly... you can dither them to black and 
  549. white, though, as described in a moment.
  550.     Big files can take a long time to print... be patient.
  551.     All printing to laser printers takes place through LPT1. 
  552. If you want to drive a different printer port, use the DOS MODE 
  553. command to redirect the output of Graphic Workshop to a different 
  554. port. Printing to dot matrix printers takes place through 
  555. whatever port the driver was written to work with.
  556.     One of the options in Graphic Workshop's installation 
  557. involves the default screen size for printing colour graphics to 
  558. PostScript printers. This can be set to anything you like for 
  559. special effects. However, the best results can usually be had by 
  560. allowing the PostScript printer to choose the optimum screen 
  561. setting.
  562.     Note that there's a potential memory problem involved in 
  563. printing to a dot matrix printer under Graphic Workshop. We've 
  564. never encountered it, but it could happen. In order to print to a 
  565. dot matrix printer through a PDR driver, Graphic Workshop has to 
  566. create a buffer which holds anywhere from eight to twenty-four 
  567. lines of your image, depending on how many pins your printer's 
  568. print head has. It also has to buffer the picture you're 
  569. printing, of course.
  570.     Now, it could happen that there's just enough memory to 
  571. buffer the picture but not enough to create the line buffer. 
  572. Graphic Workshop will refuse to print the picture under these 
  573. conditions.
  574.     This is a pretty unlikely occurrence. If you think it has 
  575. happened, you can easily check it. See how much free memory there 
  576. is by hitting a question mark, then open the F4 get info box. See 
  577. how much memory your picture needs to unpack into. Whipping out a 
  578. calculator, see how much memory is left over. Figure out how many 
  579. bytes a line of your picture takes to hold by dividing the 
  580. horizontal dimension by eight, rounding this number up if the 
  581. result isn't even. Multiply this number by the number of print 
  582. head pins in your printer... probably either eight or twenty-
  583. four. If the result is bigger than the amount of free memory left 
  584. when your picture is loaded, you've encountered the 
  585. aforementioned condition.
  586.     Note that none of this applies if the help box tells you 
  587. there isn't enough memory to buffer your picture all by itself. 
  588. If this happens, Graphic Workshop will use extended, expanded or 
  589. virtual memory for your picture, leaving the DOS memory free for 
  590. a line buffer. We'll assume here that there's at least enough 
  591. memory free for a line buffer all by itself. Note that if you use 
  592. expanded memory, Graphic Workshop will need thirty-two kilobytes 
  593. of DOS memory to manage the expanded memory.
  594.     If you happen to encounter this condition, you can trick 
  595. Graphic Workshop into getting around it by forcing it to use 
  596. extended, expanded or virtual memory rather than DOS memory for 
  597. its picture buffer, thus freeing up the DOS memory for a line 
  598. buffer. Simply shell out to DOS and run a second copy of GWS. 
  599. Print from that. When you're done, quit the second copy and type 
  600. EXIT at the DOS prompt to get back to the first copy.
  601.     All this is a very unlikely situation, and one you'll 
  602. probably never run into.    
  603.  
  604. F2 - Convert
  605.  
  606.     You can convert a file of any format into a file of any 
  607. other format... with a few restrictions. The new file will have 
  608. the same name as the original but a new extension. Converting 
  609. PICTURE.MAC into an IMG file will create PICTURE.IMG. PICTURE.MAC 
  610. will not be touched.
  611.     As noted above, large images converted into MacPaint 
  612. files will be cropped to fit. Colour files cannot be converted 
  613. directly into monochrome-only formats, that is, to MacPaint, 
  614. Microsoft Paint or IMG. 
  615.     Colour files converted to TIFF will be written as grey 
  616. scale files.
  617.     EPS files cannot be converted to any other format.
  618.     Any file can be converted into an EPS file. If you enable 
  619. the preview option during installation, the resulting EPS file 
  620. will have both the original image and a dithered preview image, 
  621. making it ideal for use with a desktop publishing package such as 
  622. Ventura. The results are stunning.
  623.     Note that Ventura will print an EPS file to a PostScript 
  624. printer. If you attempt to print a chapter with an EPS file in it 
  625. to a LaserJet, Ventura will print the preview image.
  626.     See the Ventura section below for more information about 
  627. using EPS files with Ventura.
  628.     Note that you can convert monochrome image files to EPS 
  629. files, but there's no good reason for doing so.
  630.     EPS files are huge, far larger than a compressed image 
  631. would be. Leave lots of disk space if you intend to use one. As 
  632. a rule of thumb, you can figure the size of a colour image packed 
  633. into an EPS file as being 
  634.  
  635.     width * depth * 2 plus a few hundred bytes
  636.  
  637.     The width and depth can be worked out using the Get Info 
  638. function, below.
  639.     EPS files created by Graphic Workshop do not have 
  640. trailing showpage operators... ignore this remark if it doesn't 
  641. mean anything to you.
  642.     Note that you can batch convert any mixture of file types 
  643. using Graphic Workshop. Any files which are inappropriate for the 
  644. conversion you've requested will simply be ignored. The ongoing 
  645. status will appear at the bottom of the screen.
  646.  
  647. F3 - Dither/HT (Halftone)
  648.  
  649.     Dithering is a sort of magical process by which colour 
  650. images can be converted into pretty excellent black and white 
  651. versions for reproduction on a monochrome screen or a black and 
  652. white laser printer. Graphic Workshop allows you to dither GIF 
  653. files down to monochrome IMG, PCX, MSP, WPG or TIFF files.
  654.     Dithering often works a lot better if you scale the 
  655. original image up. Graphic Workshop lets you dither with images 
  656. of anywhere from "size as" up to 500 percent expansion if you 
  657. have enough memory.
  658.     Aside from dithering to a file, you can dither to the 
  659. screen to see what your selection of dithering parameters will 
  660. look like.
  661.     Dithering is a fairly slow process, and the better the 
  662. dithering algorithm, the slower it gets. Big files and really 
  663. good dithering can take half an hour or more, although the 
  664. results are usually worth it.
  665.     At its best, dithering can look better than halftoning, 
  666. and a dithered file can be printed on both PostScript and 
  667. LaserJet printers.
  668.     If you have Graphic Workshop dither a file, it will 
  669. create a new file for you of the type selected and with "D_" 
  670. before the name. Thus PICTURE.GIF would be dithered to 
  671. D_PICTUR.IMG, for example. PICTURE.GIF would be left untouched.
  672.     If you want to dither a colour PCX file, you must first 
  673. convert it to a GIF file. Dithering only works on colour GIF 
  674. files.
  675.     The simplest... and fastest... form of dithering is a 
  676. Bayer dither. This does not produce great results, but it's 
  677. extremely quick. The EPS preview images created by Graphic 
  678. Workshop use Bayer dithering.
  679.     The remaining three dithering algorithms use what is 
  680. called "error diffusion". These produce really nice looking 
  681. dithers, but they're quite slow. The fastest... and least 
  682. attractive... is Floyd-Steinberg. The best... and by far the 
  683. slowest... is Stucki. The Burkes dither is somewhere in the 
  684. middle.
  685.     All three of these dithers come in two flavours, UD... 
  686. unidirectional... and BD... bidirectional. These options will 
  687. produce slightly different results.
  688.     You should plan to experiment with the dithering options 
  689. of Graphic Workshop a bit to see what it's capable of.
  690.     Dithering scans an image line by line, starting in the 
  691. upper left corner and working down to the lower right corner. For 
  692. this reason, you will find that if you rotate an image by ninety 
  693. degrees, dither it and then rotate the dithered version by a 
  694. further two hundred and seventy degrees, you'll get different 
  695. results than you would have had you dithered the original image. 
  696.     The last two items in the dither menu are not really 
  697. dithering functions at all, but rather true halftones
  698. They will produce sixteen and sixty-four grey level halftones 
  699. respectively from a colour image. They do this by approximating 
  700. the grey levels in dot sizes, just like newspaper halftones do. 
  701. The destination image will always have four or eight times the 
  702. dimensions of the source image. There is absolutely no advantage 
  703. to expanding images for halftoning, so the expansion menu will 
  704. not appear for sixteen and sixty-four level halftoning.
  705.     Halftones often look more realistic than dithers. The 
  706. drawback to using halftones is that the files can get enormous, 
  707. and even a sixty-four grey level halftone doesn't really handle 
  708. grey levels as well as an error diffused dither... although in 
  709. some cases it may look better.
  710.  
  711. F4 - Get Info
  712.  
  713.     This box will show you some basic information about one 
  714. or more selected files. Among other things, it will tell you how 
  715. much memory the file needs to unpack into. You can use this 
  716. number to figure out whether the file in question will fit in 
  717. your available DOS memory or whether extra memory will be 
  718. required, as discussed previously. The amount of available DOS 
  719. memory is available by hitting the "?" key from within the main 
  720. screen.
  721.     The last field in this box displays the file comments if 
  722. there were any, or "No comments". File comments are, in fact, 
  723. Macintosh file names if they're present or, in some cases, 
  724. information about the internal structure of the file. You will 
  725. find Mac comments in some GIF files and many MacPaint files.
  726.     Some file formats actually contain a lot more information 
  727. than can be displayed in the normal Get Info box. TIFF files, for 
  728. example, can contain the name of the artist responsible for them, 
  729. the type of software used to create them and so on. You can this 
  730. sort of optional information for formats which support it by 
  731. using the "details" option of the F4 box when it's available. The 
  732. arrow keys will scroll you through the detail window. Details are 
  733. available, for example, if you get information about TIFF and IFF 
  734. files.
  735.     You may need some external assistance in fully 
  736. interpreting the details. 
  737.  
  738. F6 - Reverse
  739.  
  740.     This function will create a reversed version of any 
  741. monochrome image file. The new file will have the same name as 
  742. the original file, with "R_" appended to the front of it. Thus, 
  743. reversing PICTURE.MAC will leave you with R_PICTUR.MAC. This 
  744. function will ignore any files which are not monochrome.
  745.  
  746. F7 - Transform
  747.  
  748.     This key will pop up a menu offering you five image 
  749. transformations. You can rotate an image in ninety degree 
  750. increments and you can flip it horizontally or vertically. These 
  751. functions work on images of any number of colours, but only if 
  752. the source images are in the GIF format. You'll have to convert 
  753. images from other formats to GIF if you want to use the 
  754. transformation functions on them.
  755.     Note that the ninety and two hundred and seventy degree 
  756. rotation functions will take a very long time if your images are 
  757. large and require the use of virtual memory... this assumes that 
  758. you lack extended or expanded memory. Them's the breaks.
  759.     Transformed images will be stored in files with "T_" in front 
  760. of the names. Thus PICTURE.GIF will become T_PICTUR.GIF after any 
  761. of the five transformations have been wrought upon it. If you 
  762. rotate it and then flip the rotated image, for example, it will 
  763. become T_T_PICT.GIF, and so on, with intermediate files along the 
  764. way.
  765.  
  766. F8 - Scale
  767.  
  768.     This key will allow you to scale GIF files from twenty 
  769. five to five hundred percent. Once again, we've limited this 
  770. function to working with GIF files to keep the code size down. If 
  771. you wish to scale other types of files, you'll have to convert 
  772. them to GIF first.
  773.     Your original files will not be altered when you scale 
  774. them. New files with the prefix "S_" will be created. Thus, 
  775. PICTURE.GIF will produce S_PICTUR.GIF after scaling.
  776.     Scaling a picture can produce some really ugly results, 
  777. depending on what you scale. Bear in mind that scaling by 
  778. integral values... down to seventy five or fifty percent, up to 
  779. two hundred percent and so on... will produce less ugly results 
  780. than scaling by arbitrary values.
  781.     The scaling values you enter will be rounded to the 
  782. nearest lower integral value. Thus, 42.5 percent will really be 
  783. forty-two percent.
  784.     Scaling is fairly time consuming.
  785.     You should probably avoid scaling dithered monochrome 
  786. pictures down. Nothing terribly bad will happen, but for reasons 
  787. which will become obvious if you think about it, the results will 
  788. almost always be really ugly.
  789.     The maximum horizontal image dimension which Graphic 
  790. Workshop can deal with is 8192 pixels. Avoid scaling pictures to 
  791. something larger than this. This may not be a common problem... a 
  792. picture having the dimensions 8192 by 8192 pixels would require 
  793. sixty-seven megabytes of memory.
  794.     Note that the scaling percentage you enter determines the 
  795. size of the destination image relative to the source image, not 
  796. the actual percentage of scaling. Thus, entering 25 will produce 
  797. a destination image which is one quarter... twenty-five percent... of 
  798. the original image. Entering 200 will create a destination image 
  799. twice as big... two hundred percent of... the original. Entering 
  800. 100 will produce a destination image identical to the source 
  801. image.
  802.  
  803.  
  804. INSTALLATION
  805. ____________
  806.  
  807. Making permanent changes to the modifiable features of Graphic 
  808. Workshop involves using the installer, GWSINSTL.EXE. The 
  809. configuration of Graphic Workshop is handled by a separate 
  810. program in order to keep GWS.EXE as small as possible, leaving 
  811. lots of memory for putting graphics in.
  812.  
  813.  
  814. Using the Installer
  815.  
  816. The GWSINSTL program actually modifies GWS.EXE. In order for it 
  817. to work, GWS.EXE and GWSINSTL.EXE must be in the same directory 
  818. and must be so named. Both programs must be of the same version. 
  819. Be aware that as it directly modifies GWS.EXE, there is the 
  820. outside chance that a bug in the installer might crop up and kill 
  821. GWS.EXE beyond repair. Make sure you have a virgin copy of 
  822. GWS.EXE somewhere before you use the installer.
  823.     Place GWSINSTL.EXE and GWS.EXE in the same directory and 
  824. type GWSINSTL. The installation screen will appear. It looks 
  825. something like this:
  826.  
  827.                Screen colours: COLOUR
  828.                   Memory type: VIRTUAL
  829.                  Display type: EXTERNAL
  830.               Default printer: LASERJET - 150 DPI
  831.        PostScript Screen size: PRINTER'S DEFAULT
  832.    Default dither destination: IMG
  833.           Default dither type: FLOYD BIDIRECTIONAL
  834.       Default conversion type: IMG
  835.      Default expansion factor: SIZE AS
  836.            PostScript preview: ON
  837.       MacPaint file extension: MAC
  838.        GEM/IMG file extension: IMG
  839.            PCX file extension: PCX
  840.            GIF file extension: GIF
  841.           TIFF file extension: TIF
  842.            EPS file extension: EPS
  843.               Print filenames: ON
  844.                   Print dates: OFF
  845.              Print image size: OFF
  846.           Print image colours: OFF
  847.       Print output resolution: OFF
  848.              Print EPS titles: ON
  849.          External driver path: GRAFDRV.DRV
  850.  
  851. Move the section bar to the option you want to change and hit 
  852. Enter to step through the available options. The PgUp and PgDn 
  853. keys will show you additional options. When you're all done, hit 
  854. F10 to save your changes or Esc to abort and return to DOS.
  855.     The file name extension fields allow you to type in new 
  856. extensions. Hit enter, change the field and hit enter again to 
  857. save the changes.
  858.  
  859.  
  860. Installing in Windows 3
  861.  
  862. You can install Graphic Workshop in Windows 3 as a non-Windows 
  863. application. It gets along well with Windows. Use the PIF 
  864. provided, open a new application and fill in the blanks. You'll 
  865. probably have to use the Windows PIF editor to change things like 
  866. where your copy of GWS.EXE lives.
  867.     Use the Properties item of the program manager file menu 
  868. to change the default DOS icon initially assigned to Graphic 
  869. Workshop to GWS-1.ICO, provided with the software.    
  870.  
  871.  
  872. The Configurable Options
  873.  
  874. These are the things which you can change in Graphic Workshop. 
  875. These parameters can be changed permanently by using the 
  876. installer or temporarily by using the command line switches. 
  877. Having installed GWS.EXE for a particular set of options, you 
  878. might find it convenient to boot it up with one or more of these 
  879. switches to override the installed configuration for particular 
  880. circumstances, such as to use virtual memory for a particularly 
  881. large file when you know you won't have enough extended memory, 
  882. or to use a different PostScript screen size.
  883.  
  884. Memory:     
  885. Select EMS for expanded memory.
  886. Select XMS for extended memory.
  887. Select VIRTUAL to use a disk file if you have neither extended 
  888. nor expanded memory. Consult your system documentation to if 
  889. you're unsure about the memory situation of your machine. Note 
  890. that in order to use EMS or XMS memory, you will need the 
  891. appropriate driver installed in your machine, as provided with 
  892. your memory board. Also note that XMS memory will not work 
  893. properly if you have VDISK.SYS installed.
  894.  
  895. Display card:
  896. If you have a fairly typical display adapter, select AUTODETECT. 
  897. If this doesn't work... if your card refuses to go into the 
  898. graphics mode you expect... select the specific card type you 
  899. have. If you have a VGA card and there's a driver available for 
  900. it, you can set this to EXTERNAL. See below for some additional 
  901. discussion of drivers. Otherwise, select the straight VGA setting.
  902.     Note that some ATI EGA Wonder cards will not go into 
  903. their Hercules graphics modes reliably under Graphic Workshop. 
  904. We're looking into this one.
  905.  
  906. Print options:
  907. This controls the printing of information at the bottom of each 
  908. page of hard copy. You can enable none, some or all of these 
  909. items, as follows:
  910.     - Print the image file name.
  911.     - Print the date.
  912.     - Print the image dimensions.
  913.     - Print the number of colours in the original image.
  914.     - Print the resolution mode selected.
  915.     - Print the EPS title for EPS files only.    
  916.  
  917. Preview:
  918. You can enable or disable the creation of a preview image when 
  919. Graphic Workshop converts files to the EPS format.
  920.  
  921. Screen size:
  922. You can select the screen size for printing colour images as 
  923. halftones to a PostScript printer. This does not effect 
  924. converting colour images to EPS files. Unless you particularly 
  925. want to create special effects, it's recommended that you leave 
  926. this at its default setting. Note that having printed one image 
  927. with a fixed size screen, all subsequent ones will print at that 
  928. size until you reset you PostScript printer or specify a new 
  929. screen size.
  930.  
  931. Command line switches
  932.  
  933. You can always see a complete list of these by typing GWS ? at the 
  934. DOS prompt.
  935.  
  936. /EXT - use extended memory
  937. /EXP - use expanded memory
  938. /VIR - use virtual memory
  939. /CGA - use CGA card
  940. /HER - use Hercules card
  941. /EGA - use EGA card
  942. /PAR - use Paradise card
  943. /ATI - use ATI VGA Wonder card 
  944. /PRD - disable all print options
  945. /S80 - set screen size to 80 lines
  946. /S60 - set screen size to 60 lines
  947. /S40 - set screen size to 40 lines
  948. /S30 - set screen size to 30 lines
  949. /S20 - set screen size to 20 lines
  950. /S10 - set screen size to 10 lines
  951. /SDF - set screen size to printer default
  952. /PRE - enable EPS preview creation
  953. /NOP - disable EPS preview creation
  954. /PFN - enable printing filenames on hard copy
  955. /PDT - enable printing dates on hard copy
  956. /PPS - enable printing image size on hard copy
  957. /PCL - enable printing number of colours on hard copy
  958. /PRS - enable printing resolution on hard copy
  959. /PET - enable printing EPS title on hard copy
  960. /DRV - use the named external graphics driver (defaults to GRAFDRV.DRV)
  961. /PRX - use the named external printer driver (defaults to PRINTER.PRD)
  962.  
  963.  
  964. VENTURA PUBLISHER TRICKS
  965. ________________________
  966.  
  967. Graphic Workshop is great for getting images into Ventura 
  968. Publisher documents. Here are a few tips for getting the most out 
  969. of it.
  970.     Monochrome bitmapped images... anything other than EPS 
  971. files... should be converted into IMG files for use with Ventura. 
  972. Note that while Ventura will import colour PCX files with up to 
  973. 16 colours, the results are rarely pretty. You'll do much better 
  974. to halftone or dither colour PCX files for use with Ventura.
  975.     Having poured an image into a frame, use the Sizing and 
  976. Scaling box in the Frames menu to select "By Scale Factors." Set 
  977. the scale width to the natural size of the image... as it 
  978. defaults to... or to some integral multiple of it. This will 
  979. eliminate distortion or plaiding of the image.
  980.     Using EPS files is a bit different if you want to get the 
  981. optimum image quality. (If you aren't too fussy, just pour 'em, 
  982. stretch 'em and see what happens.) In this case, you must load 
  983. the EPS file as line art... it's a PostScript file... and use the 
  984. "Fit in Frame" option of the Sizing and Scaling box. Set the 
  985. frame size initially to the natural size of the picture. If you are 
  986. working in inches, you can work this out by dividing the 
  987. dimensions of the image in pixels by 300. 
  988.     If you have forgotten the dimensions of the original GIF 
  989. file you halftoned the picture from, use the DOS TYPE command to 
  990. look at the first few lines of your EPS file. You should see 
  991. something like this:
  992.  
  993.     /width 640 def
  994.     /depth 480 def
  995.  
  996. These are the natural dimensions of the image in pixels.
  997.     The initial frame dimensions for this picture would be 
  998. 2.13 by 1.60 inches. 
  999.     Next, select "By Scale Factors" and "Distorted". Set the 
  1000. scale dimensions to the same values as the frame size.
  1001.     You can now change the frame size if you want to. You can 
  1002. also expand the image dimensions by some integral amount.
  1003.     EPS files used this way can be cropped just like any 
  1004. other picture.
  1005.     In addition to EPS files, you can create halftones from 
  1006. colour images by converting them to grey scale TIFF files. There 
  1007. are several advantages to producing halftones this way rather 
  1008. than using EPS files. The files will be much smaller... by about 
  1009. half... and Ventura will import them with less requisite fiddling 
  1010. in the Sizing and Scaling box. In addition, Ventura allows you a 
  1011. great deal of control over the way the grey scale and screening 
  1012. information is handled in a TIFF file.
  1013.     You might want to experiment a bit with these two types 
  1014. of files to get a feel for the results produced by them in 
  1015. Ventura chapters.
  1016.     If you use the Define Colours option of the Frame menu to 
  1017. display colours as shades of grey rather than as colours... and 
  1018. if you're using an EGA or VGA monitor... grey scale TIFF files 
  1019. will appear in your chapters as pretty slick little photographs.
  1020.  
  1021.  
  1022. COREL DRAW TRICKS
  1023. -----------------
  1024.  
  1025. If you import bitmapped images into Corel Draw, you can decide 
  1026. how they'll be handled once they get there by choosing the image 
  1027. type you use. Imported PCX files will be scaled to an arbitrary 
  1028. size upon entering Corel Draw, with the result that it's almost 
  1029. impossible to adjust them to get a one to one relationship 
  1030. between the image pixels and the printer pixels. This will make 
  1031. many PCX print badly.
  1032.     TIFF files, on the other hand, import initially with one 
  1033. to one scaling. If you use TIFF files and leave them at their 
  1034. initial size, or stretch them to integral multiples of their 
  1035. original sizes, they'll print without distortion or plaiding.
  1036.     Grey scale TIFF files imported into Corel Draw come up as 
  1037. PostScript halftones... these can look very slick as part of a 
  1038. line drawing.
  1039.     Another book plug here: you might want to check out 
  1040. "Mastering Corel Draw" by Steven William Rimmer, published by 
  1041. Sybex Books. This will be available in May of 1990.
  1042.  
  1043.  
  1044. CUSTOM SCREEN DRIVERS
  1045. _____________________
  1046.  
  1047. If you have a super VGA card you can use its super VGA modes by 
  1048. having Graphic Workshop drive your card through an external 
  1049. driver. External drivers are little blocks of code which know all 
  1050. about your specific VGA card, and present it to Graphic Workshop 
  1051. in a useful form.
  1052.     In order to have Graphic Workshop use an external driver, 
  1053. you must select EXTERNAL for the display type in GWSINSTL and set 
  1054. the screen driver path to reflect the name and location of your 
  1055. driver. For example, if your driver was called TATUNG.DRV and it 
  1056. lived in the directory \COMMON\DRIVERS on drive C:, you would 
  1057. enter C:\COMMON\DRIVERS\TATUNG.DRV in this field.
  1058.     The drivers included with this version of Graphic 
  1059. Workshop are discussed in a separate file called DRIVERS.DOC.
  1060.     Note that every super VGA card must have a custom 
  1061. Graphic Workshop driver if it is to work in its super VGA modes. 
  1062. The driver for one brand of card will not work for a different 
  1063. card. If there's no driver for your particular card you can still 
  1064. use Graphic Workshop in its default VGA mode, but you'll see 
  1065. fewer pixels on your screen at a time.
  1066.     In future releases we hope to include a number of SVGA 
  1067. drivers. If you write one using the GRAFDRV.ASM skeletal driver 
  1068. and care to send us the source, we'll be pleased to include it 
  1069. with future releases of Graphic Workshop, with suitable credit.
  1070.  
  1071.  
  1072. CUSTOM DOT MATRIX PRINTER DRIVERS
  1073. _________________________________
  1074.  
  1075. Custom dot matrix printer drivers are used to support dot matrix 
  1076. printers or other similar output devices which Graphic Workshop 
  1077. doesn't know how to deal with directly. In order to load one, you 
  1078. must enable the external printer driver option in GWSINSTL and 
  1079. fill in the path to your printer driver.
  1080.     When Graphic Workshop boots up with an external printer 
  1081. driver in place, a ninth entry will be added to the printer 
  1082. selection menu, this being the name of the printer your driver 
  1083. drives.
  1084.     Only monochrome pictures can be printed to dot matrix 
  1085. printers... even if you have a colour dot matrix printer.
  1086.  
  1087.  
  1088. BUGS
  1089. ____    
  1090.  
  1091. There are bound to be some. If you encounter a problem with 
  1092. Graphic Workshop, please contact us. We'll also be interested in 
  1093. hearing your suggestions for future releases of this software. If 
  1094. you encounter a file which Graphic Workshop won't read, we'll be 
  1095. interested in having a look at it.
  1096.  
  1097.  
  1098. COMING NEXT VERSION
  1099. ___________________
  1100.  
  1101. These are the features we're working on for the next major 
  1102. release of Graphic Workshop:
  1103.     - Targa support
  1104. If you register your copy of Graphic Workshop, you'll be notified 
  1105. when the next release is available.    
  1106.  
  1107.  
  1108. ROLL YOUR OWN
  1109. _____________
  1110.  
  1111. This is yet another book plug. If you're interested in writing 
  1112. programs which use graphics, you'll find everything you need to 
  1113. know in "The Book of Bitmapped Graphics", also by Steven William 
  1114. Rimmer. It's published by TAB books, (TAB book 3558) and should 
  1115. be available in August 1990. It features code to pack and unpack 
  1116. MacPaint, IMG, PCX, GIF and TIFF files, as well as chapters on 
  1117. screen drivers, dithering and printing.
  1118.  
  1119.  
  1120. SHAREWARE DISTRIBUTORS
  1121. ______________________
  1122.  
  1123. We are happy to have Graphic Workshop distributed by shareware 
  1124. distributors, provided you distribute a copy which has come 
  1125. directly from us and that you don't modify the package in any 
  1126. way. 
  1127.  
  1128. We will provide a free master copy of the current version of this 
  1129. software to those distributors which we feel make a reasonable 
  1130. effort to promote the registration of our shareware. Other 
  1131. distributors are welcome to distribute the package if they 
  1132. purchase a registered copy of it.
  1133.  
  1134. If you wish to request a free master copy of this package for 
  1135. distribution, please send us a copy of your current catalog and a 
  1136. letter requesting a copy on your letterhead. We will not consider 
  1137. requests which are not accompanied by a printed catalog.
  1138.  
  1139. Sorry... we've been getting deluged with requests.    
  1140.  
  1141.  
  1142. MORAL DOGMA
  1143. ___________
  1144.  
  1145. If you like this program and find it useful, you are requested to 
  1146. support it either by buying the book mentioned at the top of this 
  1147. file or by sending us $35.00. We'd rather you bought the book. 
  1148. This will entitle you to telephone support, notification of 
  1149. updates, a free copy of the latest version of Graphic Workshop 
  1150. and other good things like that. More to the point, though, it'll 
  1151. make you feel good. We've not infested the program with excessive 
  1152. beg notices, crippled it or had it verbally insult you after ten 
  1153. days. We trust you to support Graphic Workshop if you like it.
  1154.     Oh yes, should you fail to support this program and 
  1155. continue to use it, a leather winged demon of the night will tear 
  1156. itself, shrieking blood and fury, from the endless caverns of the 
  1157. nether world, hurl itself into the darkness with a thirst for 
  1158. blood on its slavering fangs and search the very threads of time 
  1159. for the throbbing of your heartbeat. Just thought you'd want to 
  1160. know that.
  1161.  
  1162. We are
  1163.                       Alchemy Mindworks Inc.
  1164.                           P.O. Box 500
  1165.                          Beeton, Ontario
  1166.                              L0G 1A0
  1167.                              Canada
  1168.  
  1169. Other programs we've done that you might like include:
  1170.  
  1171. VFM      -  Ventura soft font manager deluxe with a side of fries. 
  1172.             Adds new fonts and creates width tables with menu 
  1173.             driven simplicity.
  1174.  
  1175. GRAFCAT  -  Prints a visual catalog of your image files, with 
  1176.             sixteen pictures to a page. Drives all LaserJet and 
  1177.             PostScript laser printers, and works with any mixture 
  1178.             of GIF, PCX, MacPaint, TIFF, WPG, MSP, IFF/LBM, EPS, 
  1179.         BMP, PIC and IMG files.
  1180.  
  1181. CROPGIF   - allows you to crop smaller fragments out of your GIF 
  1182.             files. Use graphic Workshop, above, to convert other 
  1183.             formats into GIF files for cropping. This program 
  1184.             uses a simple mouse interface to make cropping image 
  1185.             fragments no more complicated than using a paint 
  1186.             program Requires a Microsoft compatible mouse.
  1187.  
  1188. CINEMA    - Display a continuous "slide show" of image files. You 
  1189.             can set up the images to be displayed using a simple 
  1190.             script language. Cinema works with most super VGA 
  1191.             cards, using the same drivers as Graphic Workshop, 
  1192.             and with CGA, EGA and Hercules cards. It works with 
  1193.             any mixture of GIF, PCX, MacPaint, TIFF, WPG, MSP, 
  1194.             IFF/LBM, EPS and IMG files.
  1195.  
  1196. FI        - File Information... this is a small utiltity which 
  1197.             will examine mystery image files and tell you what 
  1198.             they are and some details of what's inside them. 
  1199.  
  1200. GIFINFO   - Creates catalog files from your GIF collection, 
  1201.             allowing you to store fifty or more miniature full 
  1202.             colour representations of GIF files on a single quad 
  1203.             floppy.
  1204.  
  1205. STORYTELLER -
  1206.         A hypertext program with a mouse driven graphical 
  1207.             user interface which will allow you to create 
  1208.             reports, manuals and interactive fiction, among other 
  1209.             things, which has a tree stucture. Each page of a 
  1210.             storyteller document can lead to related sub-pages, 
  1211.             which can in turn have their own sub-sub pages, and 
  1212.             so on. It looks slick and is exceedingly user 
  1213.             friendly.
  1214.  
  1215. If you can't find them in the public domain, they're available 
  1216. from us for $35.00 each.
  1217.  
  1218.  
  1219. REVISION HISTORY
  1220. ________________
  1221.  
  1222. For them what cares...
  1223.  
  1224. Version 4.8 - Fixed an IFF bug that caused some odd sized 16 
  1225. colour IFF files to be incorrectly saved. Added selectable TIFF 
  1226. grey scale expansion. Added two Tseng Labs super VGA card 
  1227. drivers... see DRIVERS.DOC.
  1228.  
  1229. Version 4.7 - Fixed another obscure TIFF bug and a MacPaint bug.
  1230.  
  1231. Version 4.6 - Fixed an obscure TIFF bug.
  1232.  
  1233. Version 4.5 - Added PIC file support.
  1234.  
  1235. Version 4.4 - Several bug fixes.
  1236.  
  1237. Version 4.3 - Fixed a bug in the EPS file conversion routine.
  1238.  
  1239. Version 4.2 - Tidied up the file finder functions. The rename and
  1240. delete commands don't reset the cursor position and the program 
  1241. can survive attempting to log onto an empty floppy drive with its 
  1242. dignity intact. Tidied up the TIFF details. The TIFF functions 
  1243. can now read files with Macbinary headers, and can generate 
  1244. Motorola format TIFF files.
  1245.  
  1246. Version 4.1 - Fixed a bug which prevented BMP files from printing 
  1247. or being converted into other formats.
  1248.  
  1249. Version 4.0 - Added Windows 3 BMP support.
  1250.  
  1251. Version 3.9 - Allowed for optional IFF file compression and fixed 
  1252. some IFF bugs. All IFF files generated by Graphic Workshop are 
  1253. now ILBM compressed... ignore this if it doesn't mean anything to 
  1254. you... and all files with colours in them get Deluxe Paint 
  1255. previews.
  1256.  
  1257. Version 3.8 - Fixed several TIFF bugs.
  1258.  
  1259. Version 3.7 - Fixed a few cosmetic bugs and one persistent one 
  1260. which would cause error messages and deletion of incomplete files 
  1261. to use the previous file name, rather than the current one in 
  1262. some cases. This tended to delete good files in conditions when 
  1263. one's disk was full and such.
  1264.  
  1265. Version 3.6 - Got the IFF/LBM compression working properly, 
  1266. improved the IFF details, allowed for optional TIFF grey scale 
  1267. file compression. Added Deluxe Paint preview images for 256 
  1268. colour files.
  1269.  
  1270. Version 3.5 - Added scaling, perhaps against our better 
  1271. judgement. Changed the TIFF compression routine so the version of 
  1272. Graphic Workshop used to create files is included as a tag. You 
  1273. can see it in the TIFF details. Improved a few cosmetic things.
  1274.  
  1275. Version 3.4 - Fixed a bug in the monochrome EPS previews. There 
  1276. aren't many uses for monochrome EPS files. Improved the 
  1277. monochrome IMG file reader considerably... it now loads pretty 
  1278. well any two colour IMG file, even the weird ones which Ventura 
  1279. creates when it imports EPS files.
  1280.  
  1281. Version 3.3 - Added halftoning to the dither... now the 
  1282. dither/halftone... functions.
  1283.  
  1284. Version 3.2 - Added detailed tag analysis for tag based formats. 
  1285. Also added drop shadows to the menus and such... this adds four
  1286. bytes of code to the program. Fixed a bug of sorts in the TIFF 
  1287. display code which made it a bit finicky.
  1288.  
  1289. Version 3.1 - Improved several of the image compression 
  1290. functions... they're a lot more effective now. Also fixed a 
  1291. cosmetic bug in the wait box which caused it to completely close 
  1292. on files longer than about 1600 lines.
  1293.  
  1294. Version 3.0 - Added descriptive comments to some of the F4 Get 
  1295. Info functions. Added IFF/LBM/CE support.
  1296.  
  1297. Version 2.9 - Fixed a potential bug in the PCX palette code, 
  1298. added file renaming in the finder. Also, one of our users pointed 
  1299. out that the compiler was adding a debug table to the final EXE 
  1300. file without being asked to do so. Eliminating this has made the 
  1301. code about twenty kilobytes smaller. Thanks, Don... things you 
  1302. learn...
  1303.  
  1304. Version 2.8 - Added loadable drivers for dot matrix support, 
  1305. fixed a few obscure bugs in the printing and display code. Added 
  1306. image rotation and flipping.
  1307.  
  1308. Version 2.7 - Added VGA colour adjustment in the view mode. Added 
  1309. Microsoft Windows Paint (MSP) file support. One might ask why... 
  1310. Microsoft Windows Paint is not one of the leading lights in 
  1311. digital artistry. It was mostly in the interest of completeness. 
  1312. We had the format details and it was a hot Saturday afternoon 
  1313. with nothing better to do.
  1314.  
  1315. Version 2.6 - Added WordPerfect Graphics support, fixed a bug 
  1316. which kept some EGA cards from autodetecting properly, made the 
  1317. TIFF and IMG packing code tighter still for large images. Fixed a 
  1318. bug in the grey scale TIFF printing function.
  1319.  
  1320. Version 2.5 - Fixed a bug in the monochrome GIF file decoder 
  1321. which caused files with horizontal dimensions not an even 
  1322. multiple of eight to display incorrectly... but only on Tuesdays.
  1323.  
  1324. Version 2.4 - Fixed some bugs in the external super VGA graphics 
  1325. drivers. Be sure to read DRIVERS.WS if you use and external 
  1326. driver.
  1327.  
  1328. Version 2.3 - Added grey scale TIFF support (at last). Removed 
  1329. the built in Paradise Plus and ATI VGA Wonder card drivers in 
  1330. favour of the external ones, which frees up a bit of memory and 
  1331. makes maintaining these drivers much simpler. Improved the TIFF 
  1332. file creation routines, such that they now conform to TIFF 5.0, 
  1333. and will import into most applications which accept TIFF, 
  1334. including Corel Draw... which is a bit particular about the sorts 
  1335. of TIFF files it want to deal with. Fixed a bug in the expanded 
  1336. memory manager which caused a few hangs on really immense files.
  1337.  
  1338. Version 2.2 - Fixed a bug in the dithering code. This would cause 
  1339. some machines to hang if an attempt was made to dither colour GIF 
  1340. files to the screen with an external VGA driver loaded. Nasty but 
  1341. obscure.
  1342.  
  1343. Version 2.1 - Added Macintosh GIF file reading. Macintosh GIF 
  1344. files ported to a PC have a 128 byte "Macbinary" header before 
  1345. the GIF file proper. Graphic Workshop now detects this, gets 
  1346. around it and reads the GIF information normally. Also added a 
  1347. comment field to the F4 file information box. This will display 
  1348. the Macintosh file names of GIF and MacPaint files with Macbinary 
  1349. headers. Fixed some very obscure bugs in the IMG and TIFF file 
  1350. compression routines. These would occasionally cause very large 
  1351. dithered files to compress incorrectly.
  1352.  
  1353. Version 2.0 - Fixed a fairly obscure bug in the 16 colour PCX 
  1354. file compression code. 
  1355.  
  1356. Version 1.9 - Added image reversal for monochrome files. The 
  1357. menus got larger.
  1358.  
  1359. Version 1.8 - Added monochrome GIF file packing... monochrome 
  1360. files in other formats can now be converted into GIF files. Added 
  1361. an external driver for Headland Technologies Video Seven VGA 
  1362. cards. Fixed (or rather sidestepped) a weird bug in the EPS 
  1363. preview code which very occasionally generated unreadable preview 
  1364. images.
  1365.  
  1366. Version 1.7 - Added loadable custom drivers for super VGA cards 
  1367. other than the ones supported by the built in drivers.
  1368.  
  1369. Version 1.6 - Fixed a bug in the TIFF decoder and another really 
  1370. tiny one in the file finder. Gettin' down to the aphids and fleas 
  1371. now.
  1372.  
  1373. Version 1.5 - Added file deletion and fixed an obscure bug in the 
  1374. dithering code. Added EGA palette reduction for GIF files.
  1375.  
  1376. Version 1.4 - Fixed a bug in the file finder that kept batch 
  1377. processes from working across multiple pages. Also, a cosmetic 
  1378. bug the in the wait bar graph that happened on files longer than 
  1379. about two thousand lines. 
  1380.  
  1381. Version 1.3 - Fixed a few persistent bugs in the ATI VGA Wonder 
  1382. card driver. ATI cards were put in this dimension to vex us.
  1383.  
  1384. Version 1.2 - Fixed several bugs which prohibited PCX to GIF 
  1385. conversion for 32 colour files, kept some extremely large 
  1386. monochrome PCX files from converting and so on.
  1387.  
  1388. Version 1.1 - Added ATI VGA Wonder card driver
  1389.  
  1390. Version 1.0 - Sprung GWS on an unsuspecting universe.
  1391.  
  1392.  
  1393. SOURCE CODE
  1394. ___________
  1395.  
  1396. After considerable meditation and several bad experiences, we 
  1397. have decided not to release the source code for Graphic Workshop. 
  1398. We do licence parts of it for specific applications... if you 
  1399. want more information about using some of the functions of 
  1400. Graphic Workshop in your software, please contact us.
  1401.  
  1402.  
  1403. BUNDLING GRAPHIC WORKSHOP
  1404. _________________________
  1405.  
  1406. If you'd like to include Graphic Workshop with your product, 
  1407. please get in touch with us. We have several ways to help you do 
  1408. this so your users get the most out of Graphic Workshop and we 
  1409. don't have to set our leather winged demon of the night on 'em.
  1410.     
  1411.  
  1412. LEGAL DOGMA
  1413. ___________
  1414.  
  1415. The author assumes no responsibility for any damage or loss 
  1416. caused by the use of these programs, however it comes down. If 
  1417. you can think of a way a picture program can cause you damage 
  1418. or loss you've a sneakier mind than mine.
  1419.  
  1420. All the trademarks used herein are registered to whoever it is 
  1421. that owns them. This notification is given in lieu of any 
  1422. specific list of trademarks and their owners, which would not be 
  1423. as inclusive and would probably take a lot longer to type. 
  1424.  
  1425. That's it...
  1426.  
  1427.