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