home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / dlib06.zip / README.TXT < prev   
Text File  |  1994-07-12  |  5KB  |  107 lines
  1. dLib v0.5
  2.  
  3.  
  4.  
  5. dLib is simple, sort of fast, graphics library for OS/2. It requires MMPM/2
  6. software motion video to be installed. It currently only runs on 256 color
  7. OS/2 display drivers. My video card (ET4000/W32) has no high color drivers,
  8. so I couldn't test higher colors. I decided to leave them out rather than
  9. guess. I will add them later if I manage to borrow a card that has OS/2 
  10. drivers for greater than 256 colors.
  11.  
  12. dLib is supplied as a .DLL, so that programs written today, with no 64k
  13. color support, or 16.8m color, or 16 color, will work on these number of
  14. colors as I add support for them. I may not add 16 color support. 
  15. Newer .DLL's will be faster, with added functionality, whilst still being 
  16. compatiable with older programs.
  17.  
  18. It uses the DIVE interface. ATI 8514 drivers dont support the video
  19. aperture, so they dont work, sorry. There may be others that don't work,
  20. I don't know. If you do code changes to make it work, send me a copy and 
  21. I'll include it in any posible future releases.
  22.  
  23. This code was thrown together (over a week) from bits and pieces of
  24. code I use for my own demos. I thought I'd share it with others. Hopefully
  25. it may benefit the OS/2 community in some way.
  26.  
  27.  
  28. The demos-(nothing too startling, I wanted to keep the code easy to follow)
  29. DEMO1.EXE
  30.     This is a simple demo that shows what frame rate is posible with what
  31.     size window/video card. The frame rate is displayed in the title bar.
  32.     I'd be interested in knowing the frame rates are on various cards.
  33.  
  34. DEMO2.EXE
  35.     This demo just shows a few of its features in actions. Simple scrolling,
  36.     lines and circles, and bitmaps/sprites/animation. This demo was kept
  37.     short, so others could follow the code very easily.
  38.  
  39. DEMO3.EXE
  40.     Shows a rotation API that will be supported in future releases.
  41.  
  42.  
  43.  
  44. My code is written with Watcom C/C++ v10.0, but should be compatiable with
  45. most compilers, except for a few of the bitmap routines. The codes there,
  46. feel free to port to other compilers. Portio.* files are based on the files
  47. in portio.zip on ftp-os2.cdrom.com. They are slightly modified to work with
  48. Watcom C. I didn't include the source, because its not my code. The complete
  49. package is available in /os2/2_x/program/portio2.zip, ftp-os2.cdrom.com.
  50.  
  51. I have compiled the examples with both the CSet++ and the Watcom compilers.
  52. The library appears to be compatiable. Mabey someone could let me know if
  53. it works with Borland C.
  54.  
  55. The dLib functions are documented in dlib.h.
  56.  
  57. Although this was intended for Graphics stuff running in a PM window, DIVE
  58. also works for fullscreen video modes(eg 320x200) with a few small changes.
  59.  
  60. In my routines I've decided to use a 'virtual' screen in memory (with blts
  61. to screen) rather than direct screen writes. The added complexity of direct
  62. screen writes would have slowed the code too much, ie checking for the end
  63. of the video aperture. At the heart of my code, is bits of code from
  64. Linden DeCarmo's DIVE.ZIP, off ftp-os2.cdrom.com (used with permission).
  65.  
  66. I've only included simple functions in this version, to keep things clear.
  67. This so that OS/2er's can follow whats going on easily. I may release newer
  68. versions with more functions, ie 3D, clipping etc, if people are interested.
  69.  
  70. Hopefully theres enough to get you started. I thought including source,
  71. aswell as a few sample programs, would give you a fair idea of its workings.
  72.  
  73. Please use this OS/2 code as you see fit. Its SHARE/FREE WARE. If you cant
  74. afford to send a contribution, dont.  Although any money received will be put
  75. back into the project. ie my internet/pizza/compuserve time costs, as does 
  76. ftp'ing the file to ftp-os2. ....blah...blah..supporting OS/2 shareware
  77. developers...blah...blah....blah....(I bet not one of you buggers send me
  78. a cent  :-)
  79.  
  80. It would also be nice if you'd send me a copy of any cool games/demos
  81. you write.
  82.  
  83. Remeber dLib is fast(ish), but it cant work miracles. Games can waste
  84. alot of time thru bad algorithm. A fast graphics library isn't everything.
  85. Slow video card/computer/large view window, can also help cause shocking
  86. performance.
  87.  
  88. Oh, anybody got any job openings? I'm currently working as a Software Engineer
  89. in New Zealand, but would like to relocate to the US.( :-) its worth a shot)
  90. Resume/code samples/demos available on request. NZ is an OS/2 dead end.....
  91.  
  92.  
  93. Any comments? Question?
  94.  
  95. I can be contacted at,
  96.    Graeme Blackley
  97.    32/2 Webb street
  98.    Wellington
  99.    New Zealand
  100.    ph (NZ) 4382 8119
  101. or,
  102.    (internet)g_blackl@kai.ee.cit.ac.nz
  103. or,
  104.    in fidonet OS2PROG international area.
  105.  
  106.  
  107.