home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Hits 1995 June / Image.iso / demos / woodruff / wing / readme.txt < prev    next >
Encoding:
Text File  |  1994-06-27  |  5.4 KB  |  122 lines
  1. Microsoft WinG - Beta release - June 27, 1994
  2. -------------------------------------------------
  3. This file describes known bugs, gotchas, and helpful hints for the WinG
  4. Beta release. Please remember that this is a beta version and is
  5. subject to the usual Beta Disclaimers.
  6.  
  7.  
  8. Reporting Bugs
  9. --------------
  10. The main goal of this Beta release, in addition to providing you with
  11. a solid foundation for writing great graphics-intensive Windows
  12. applications, is to flush out compatibility problems with WinG. We
  13. want to know when you encounter bugs, and want to hear suggestions
  14. and/or recommendations you have about WinG or its support files.
  15.  
  16. With this in mind, we have included WINGBUG.EXE in the WinG Beta
  17. Development Kit (in the BIN directory of the SDK), an automated tool for
  18. gathering information on your configuration for reporting bugs to the
  19. WinG development team. This tool creates a complete bug report by
  20. prompting you for information about the bug, your configuration,
  21. and the steps used to reproduce the bug. The resulting bug 
  22. report text file should be sent to the wingbug@microsoft.com
  23. address, or sent to Microsoft on floppy disk.
  24.  
  25. Before reporting a bug, please be sure that it's not one we already
  26. know about by looking through the Known Bugs and Limitations section
  27. below.  If there is any doubt, send the bug anyway--it's better to have a
  28. duplicate bug on file than not know about one.
  29.  
  30. Known Bugs And Limitations
  31. --------------------------
  32. The following are known problems with the beta version of WinG.
  33.  
  34. These bugs and design decisions will be fixed or resolved before the final
  35. release. Their presence here serves only as a warning to programmers
  36. coding for this release.
  37.  
  38. - WinGBitmaps must be created with full 256 entry color tables.
  39.  
  40. - WinG will assert on 8bpp non-palette devices, like the ATI Mach32 8bpp
  41.    non-palette mode.
  42.  
  43. - CMACRO32.INC from the doggie sample application requires Microsoft MASM
  44.   5.1 to compile. You must specify the /NOPACKCODE option when linking
  45.   segments produced with CMACRO32.INC.
  46.  
  47. - Calling WinGStretchBlt and WinGBitBlt with source coordinates outside
  48.   of the source boundary can crash WinG.
  49.  
  50. - WinGBitBlt and WinGStretchBlt only support bltting from WinGDCs to the
  51.   screen.
  52.  
  53. - Several GDI APIs that should work into WinGDCs don't right now.  If
  54.   you discover others not on this list we'd appreciate hearing about them.
  55.  
  56.     StrechDIBits with non-1:1 ratio screws up
  57.     hatched brushes sometimes draw incorrectly
  58.     FloodFill with a NULL brush draws incorrectly
  59.     FloodFill outside of the bounds of a WinGBitmap can flood the
  60.       whole image
  61.     PALETTERGBs may map differently when compared to the display
  62.     brushes created with CreatePatternBrush fault when selected
  63.     some drawing operations draw slightly differently than standard GDI
  64.     DrawIcon will crash
  65.     WinGDCs will incorrectly map non-exact matchs in the color-table
  66.  
  67. - You cannot change the origin of halftone brushes.
  68.  
  69. - The sample programs's makefiles are named sample.mk (where sample is
  70.   the name of the sample) instead of makefile because of limitations
  71.   with Microsoft Setup.
  72.  
  73. - Some GP Faults within the SVGA256.DRV driver have been found. If
  74.   you encounter one, please use WINGBUG.EXE and send mail to
  75.   wingbug@microsoft.com.
  76.  
  77. - WinG does not unload when a GP Fault occurs. For accurate
  78.   performance, be sure to unload WinG.DLL or reboot Windows after a
  79.   GP Fault in a WinG application.
  80.  
  81. - WinGBitBlt and WinGStretchBlt sometimes have trouble clipping to
  82.   non-rectangular clipping regions. If you encounter incorrect
  83.   behavior, please use WINGBUG.EXE and send mail to
  84.   wingbug@microsoft.com.
  85.  
  86. - 16-bit WinG applications will not run on Daytona Beta 1 (build 612).
  87.   You must have Daytona Beta 2 (build 683) to use 16-bit WinG
  88.   applications under Windows NT. 32-bit WinG applications will run on
  89.   all versions of Daytona.
  90.  
  91. - Noticeable timing differences have been found while running the
  92.   WinG profiler on a computer connected to a network. For accurate
  93.   results, disconnect your computer from the network the first time you
  94.   run a WinG application. After the profile is complete, you can plug the
  95.   net in again. 
  96.  
  97. A Note on Speed
  98. ---------------
  99. WinG is designed to be the absolute fastest way to blt DIBs under
  100. Windows.  The goal is to blt at memory bandwidth to the display device.
  101. In other words, we are competing with BitBlt and DOS blts, not
  102. StretchDIBits or SetDIBitsToDevice.
  103.  
  104. On most 8bpp devices, if you use the recommended DIB format (returned
  105. by WinGRecommendDIBFormat) you should get speeds comparable to BitBlt,
  106. and much faster than StretchDIBits. The timewing sample application
  107. will show you various blt speeds on your display.
  108.  
  109. The only time WinG (in its final release) will not be able to beat or
  110. match BitBlt is on some "device bitmap" drivers.  These are drivers that
  111. keep HBITMAPs in video ram and use the display hardware to copy to the
  112. screen at much higher speeds than one can copy from main memory.
  113.  
  114. If you run timewing and the WinGStretchBlt performance is not as good or
  115. better than the StretchBlt case and is not much faster than the StretchDIBits
  116. case, please use WINGBUG.EXE and send a bug report to
  117. wingbug@microsoft.com.  We treat performance problems as priority 1 bugs.
  118. After all, if it's not fast it's not worth using.
  119.  
  120. Thanks a lot for your participation in the WinG Beta program!
  121. 
  122.