home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / windows / grafwk50.zip / DRIVERS.DOC < prev    next >
Text File  |  1991-01-19  |  14KB  |  278 lines
  1. This file contains information about super VGA drivers 
  2. and dot matrix printer drivers for Graphic Workshop.
  3.  
  4.  
  5.  
  6. Dot matrix printer drivers for Graphic Workshop
  7. _______________________________________________
  8.  
  9. This version of Graphic Workshop includes the following dot 
  10. matrix printer drivers. All the supplied drivers print to LPT1. 
  11. You can redirect this with the DOS MODE command. If you write a 
  12. custom driver you can have it print to any port you like.
  13.  
  14. Note that while the external printer driver facility was 
  15. implemented in Graphic Workshop to support dot matrix printers, 
  16. you can write a driver to support pretty well any output device, 
  17. including film recorders, FAX boards and so on.
  18.  
  19. This release of Graphic Workshop is a bit thin on specialized 
  20. drivers... yes, two is a bit thin. We're working on borrowing 
  21. some of the popular printers to write drivers for them.
  22.     
  23. EPSNFX80.PDR    This is a driver for the generic Epson FX-80 
  24.                 modes. It will work with many dot matrix 
  25.                 printers, although with far less resolution than 
  26.                 some newer printers can manage.
  27.  
  28. EPSNFX80.ASM    This is the source code for the generic Epson FX-
  29.                 80 driver, for use as a starting point in writing 
  30.                 your own custom driver. If you come up with a 
  31.                 printer driver of your own, please send us the 
  32.                 source and we'll include it in future releases of 
  33.                 Graphic Workshop with suitable credit.
  34.  
  35. GEMINI.PDR    This is a driver for the 480 dot wide mode of the 
  36.                 arcane Star Micronics Gemini 10X. The output from 
  37.                 this printer is pretty ugly. The double 
  38.                 resolution graphics mode of the Gemini 10X is a 
  39.                 bit narrow, and pictures come out with badly 
  40.                 distorted aspect ratios, so we didn't use this 
  41.                 mode.
  42.  
  43. Registered users of Graphic Workshop wishing to write their own 
  44. drivers are welcome to whatever help we can supply. We can't 
  45. teach you to program in assembler over the phone, but we can 
  46. probably help you with basic questions and suggest ways around 
  47. any problems you encounter.
  48.  
  49.  
  50. Super VGA card drivers for Graphic Workshop
  51. ___________________________________________
  52.  
  53. NOTE: As of version 2.4 of Graphic Workshop, the internal 
  54. structure of the super VGA drivers changed a bit. The old drivers 
  55. will no longer work with GWS.EXE. New versions of all the current 
  56. drivers are included with this release... delete your old 
  57. drivers.
  58.  
  59. MORE NOTES: As of version 2.7, all the drivers were changed 
  60. slightly. This involved using a slightly different technique for 
  61. setting the VGA palette to make palette adjustments from within 
  62. the VGA 256 colour mode look nicer. Older drivers... written after 
  63. version 2.4 of Graphic Workshop... will still work, but you'll 
  64. see a bit of screen trash when you adjust the VGA palette.
  65.  
  66. This version of Graphic Workshop includes the following drivers:
  67.  
  68. AMST1512.DRV    This driver was developed by Marcel Ward in 
  69.                 Aberystwyth, Wales. It allows owners of Amstrad 
  70.                 PCs with the custom sixteen colour display cards 
  71.                 supplied with these systems to look at colour 
  72.                 images. We haven't tested this driver, lacking an 
  73.                 Amstrad, but the source code looks right. The 
  74.                 source code in A86 is also included.
  75.  
  76. TSENG.DRV    This driver was developed Gregory Weeks and 
  77.                 should work with most super VGA cards based on 
  78.                 the Tseng Labs chips. We haven't tested this 
  79.                 driver, but it looks to be well written. Run 
  80.                 TSNGINST.EXE to configure the driver for the 
  81.                 various Tseng chips. The source code for the 
  82.                 driver is included in TSENG.A86. This is an A86 
  83.                 source file, and may need a bit of fine tuning to 
  84.                 assemble with MASM. This driver was updated by 
  85.                 the author as of the version 5.0 release of 
  86.                 Graphic Workshop.
  87.  
  88. VGA640.DRV      This is a very clever driver by Gregory Weeks 
  89.                 (the author of TSENG.DRV, above) which displays 
  90.                 640 pixel wide 256-colour files on a 320 pixel 
  91.                 wide screen by leaving out every alternate pixel. 
  92.                 As the author notes in his remarks in the 
  93.                 VGA640.A86 file, nothing is free and some detail 
  94.                 is lost. However, if you have a VGA card with no 
  95.                 640 pixel wide, 256-colour mode... or one which 
  96.                 there is no driver for as yet... you'll find that 
  97.                 this driver is often preferable to the stock 320 
  98.                 by 200 pixel MCGA mode.    
  99.  
  100. ORCH512.DRV    This driver was developed by Richard A. Bross for 
  101.                 the Orchid 512K boards. This is a Tseng based 
  102.                 board as well. It supports up to 800 by 600 
  103.                 pixels at 256 colours. Once again, we haven't 
  104.                 tested this driver but it looks to be properly 
  105.                 written. The source is in ORCH512.ASM.
  106.  
  107.         Thanks to all these authors for these drivers.
  108.  
  109. TIGA.DRV    This driver supports true 24-bit colour on a 
  110.                 Hercules Graphic Station card. Note that a VGA 
  111.                 card only actually does 18-bit colour. The 24 bit 
  112.                 colour mode of the Graphic Station card has a 
  113.                 resolution of 512 by 480 pixels. Its aspect ratio 
  114.                 isn't all that good, but you can fiddle the 
  115.                 monitor controls... for most monitors... to get 
  116.                 pretty reasonable pictures. Surprisingly, 24-bit 
  117.                 colour does not make an inordinate difference to 
  118.                 most GIF files, as few scanners really make use 
  119.                 of this degree of colour resolution. This driver 
  120.                 is a bit slow, because of the way the Graphic 
  121.                 Station card requires its video memory be updated 
  122.                 in this mode. In answer to an obvious question, 
  123.                 this driver should work on other cards supporting 
  124.                 the Texas Instrument TIGA chip, but no 
  125.                 promises...
  126.  
  127. TRIDENT.DRV    This is a driver for the Trident VGA graphic 
  128.                 cards. It drives the card in its 640 by 400, 256 
  129.                 colour mode, and will work with cards having 256 
  130.                 kilobytes or more of onboard memory. We 
  131.                 originally found the Trident card this driver was 
  132.                 developed on in a Sun Moon Star 386SX we were 
  133.                 loaned. It turned out that the monitor provided 
  134.                 with this computer would not sync in the 640 by 
  135.                 400 256 colour mode, even though the card was 
  136.                 doing fine. If you have this system, you probably 
  137.                 won't be able to use this driver unless you 
  138.                 spring for a multisync monitor.
  139.  
  140. TRDNT512.DRV    This will drive Trident cards with 512 kilobytes 
  141.                 of memory on board to 480 lines in 256 colour 
  142.                 mode. This is even harder on cheap monitors. We 
  143.                 smoked one while developing this driver... 
  144.                 fortunately, it was on loan.
  145.  
  146. VIDEO7.DRV    This is a driver for the Headland Technologies 
  147.                 Video Seven VRAM and Video Seven 1024i cards. It 
  148.                 supports the 640 by 480 line 256-colour mode. It 
  149.                 uses the standard VGA and EGA 16-colour and 
  150.                 monochrome modes... we decided not to implement 
  151.                 the 1024 by 768 16-colour mode. There are very 
  152.                 few 16-colour images around which could take 
  153.                 advantage of this mode, but there are a lot of 
  154.                 monitors which cannot.
  155.  
  156. PARAPLUS.DRV    This is a full featured driver for the Western 
  157.                 Digital Paradise Plus card. This driver also 
  158.                 works with the Dell Super VGA card, which is 
  159.                 actually a Paradise 16-bit card.
  160.  
  161. PARAPRO.DRV    This is a driver for the Paradise Professional 
  162.                 card (and clones thereof). It supports both the 
  163.                 640 by 400 and 640 by 480 pixel, 256 colour 
  164.                 modes.
  165.  
  166. DELLVGA.DRV    This is a version of PARAPLUS.DRV, above. It has 
  167.                 been modified not to use the 800 by 600 pixel EGA 
  168.                 and monochrome modes of the Paradise card, as 
  169.                 this causes the super VGA monitor on a Dell to 
  170.                 click a (loud) internal relay every time it 
  171.                 changes modes. If you don't mind the relay, or 
  172.                 you want the 800 by 600 modes, use PARAPLUS.DRV, 
  173.                 above.
  174.  
  175.                 Note: rumour has it that some Dell systems have 
  176.                 been shipped with Headland Video 7 cards rather 
  177.                 than Paradise cards. If your Dell system is so 
  178.                 equipped... or if you can't get GWS to work in 
  179.                 the super VGA modes with one of the above two 
  180.                 drivers... try VIDEO7.DRV.
  181.  
  182. PARADELL.DRV    This is a 512K version of DELLVGA.DRV, that is, a 
  183.                 Paradise driver with the 800 by 600 monochrome 
  184.                 mode disabled.
  185.  
  186. ATIWONDR.DRV    This is a driver for the ATI VGA Wonder and ATI 
  187.                 VGA Edge cards. It drives the 256 colour screen 
  188.                 in the 400 line mode, and will work with cards 
  189.                 having 256K on them. The upper 256K on half meg 
  190.                 cards will be ignored by this driver.
  191.  
  192. ATI512.DRV    This is a driver for ATI Wonder cards having 512K 
  193.                 of memory on board. It will display pictures in 
  194.                 up to 800 by 600 pixel resolution, selecting 
  195.                 among the three available 256 colour display 
  196.                 modes based on the dimensions of the image to be 
  197.                 viewed.
  198.         
  199. GRAFDRV.DRV    This is a stock VGA card driver. You might want 
  200.                 to use this if there is no super VGA card driver 
  201.                 available for your card, however, as it handles 
  202.                 the 16-colour and monochrome modes in potentially 
  203.                 more useful ways than the internal VGA driver of 
  204.                 Graphic Workshop does.
  205.  
  206. VGA400.DRV    This is a "gadget" driver for a stock VGA card 
  207.                 which reprograms the beast into an undocumented 
  208.                 320 by 400 line mode. It should work on any VGA 
  209.                 card, but being undocumented one cannot be sure. 
  210.                 In any case, while interesting, this mode has 
  211.                 such a squashed aspect ratio that it's not really 
  212.                 useful for anything. In addition, having heavily 
  213.                 interlaced memory, it's painfully slow to update.
  214.  
  215. VGA480.DRV    This is another undocumented mode. It gets still 
  216.                 more on the screen, with still more distortion.
  217.  
  218. To use one of these drivers, use GWSINSTL to select EXTERNAL for 
  219. display type and enter the path to your driver in the path name 
  220. field at the bottom of GWSINSTL screen. This should be the 
  221. complete path, including the drive letter. Graphic Workshop does 
  222. not assume that driver file names end in .DRV... you can call 'em 
  223. anything you like.
  224.     The name of the driver you've loaded should appear in the 
  225. F10 "About" window when you're running GWS.EXE.
  226.     
  227.  
  228. Writing your own driver
  229.  
  230. Also included with this version of Graphic Workshop is 
  231. GRAFDRV.ASM, the source code for GRAFDRV.DRV. This file can be 
  232. used as the boilerplate for writing your own super VGA card 
  233. driver. You will need a pretty good grasp of assembly language 
  234. and the hardware specific details of the card you want to write a 
  235. driver for to get this together. This file should be assembled 
  236. with Microsoft's MASM assembler, version 4.0 or better.
  237.     The following batch file is useful in assembling 
  238. GRAFDRV.ASM into GRAFDRV.DRV... or any other driver you happen to 
  239. write.
  240.  
  241. MASM %1 %1 NUL NUL
  242. IF ERRORLEVEL 1 GOTO PROBLEM
  243. LINK %1 @AUTOLINK
  244. EXE2BIN %1 %1.DRV
  245. DEL %1.EXE
  246. DEL %1.OBJ
  247. :PROBLEM
  248.  
  249.     The file AUTOLINK must be present... it contains four 
  250. carriage returns, that is, four blank lines.
  251.     In future releases we hope to include a number of SVGA 
  252. drivers with Graphic Workshop. If you write one using the 
  253. GRAFDRV.ASM skeletal driver and care to send us the source, we'll 
  254. be pleased to include it with future releases, with suitable credit.
  255.     Registered users of Graphic Workshop who want to write 
  256. their own drivers are welcome to the source code for all the 
  257. above drivers... you might find some of the techniques used in 
  258. them helpful in writing your driver. The only conditions are that 
  259. you must be a registered user and we'd like to have the source 
  260. code for the driver you write when you get it working... we'll 
  261. include the object file in with future releases of Graphic 
  262. Workshop.
  263.     We'll be happy to give you whatever help we can in 
  264. writing your driver, too.
  265.     If you want the driver source files, please phone or 
  266. write us and we'll send 'em off to you.
  267.  
  268.  
  269. Custom drivers
  270.  
  271. We've been asked on a few occasions whether we'll write custom 
  272. drivers for Graphic Workshop on behalf of various interested 
  273. parties. We might be able to, depending on time and whathaveyou. 
  274. If you really want a specific SVGA driver for Graphic Workshop... 
  275. for example, if you want to licence it for inclusion with a 
  276. particular card or computer... and you can't get it together 
  277. yourself, contact us. Our address is in GRAFWORK.DOC.
  278.