home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / vuebmp.zip / AboutTxt.h next >
Text File  |  1994-10-08  |  5KB  |  110 lines
  1. /* ********************************************************************** */
  2. /*                                                                        */
  3. /*    Readme.h                                                            */
  4. /*                                                                        */
  5. /*                                                                        */
  6. /* ********************************************************************** */
  7.  
  8. const char  acAboutBuffer[] =
  9. "\n\n    This program was written as a source code sample to accompany an"
  10. " article I wrote for the November 1994 issue of _OS/2 Devloper_"
  11. " magazine. The article discusses OS/2's color palette management APIs;"
  12. " ViewBMP was written as a demonstration of those APIs and their"
  13. " capabilities.\n"
  14. " \n"
  15. " FEATURES\n"
  16. " \n"
  17. "    ViewBMP displays bitmaps, which are loaded from files. Although"
  18. " I haven't thoroughly tested it with every possible format, it"
  19. " should handle most single-image OS/2 1.x, OS/2 2.x, and"
  20. " Windows bitmaps.  It will handle most color depths, including"
  21. " 24-bit, and will handle compressed formats (e.g. Huffman 1-D, 4-bit"
  22. " RLE, 8-bit RLE, etc). One key feature of ViewBMP is that it"
  23. " can load and display the bitmaps using either the system default"
  24. " color palette or using the custom color palette which is stored in"
  25. " the bitmap. The latter provides the best display results but requires the"
  26. " use of the OS/2 color palette management system; note that this option (and the"
  27. " menu item that selects it) will be disabled on systems that do not"
  28. " support color palettes.\n"
  29. " \n"
  30. "    The bitmap file to be displayed may be selected not only from the"
  31. " standard Open File Dialog, but also by entering the file name on the"
  32. " command line. One benefit of this feature is that ViewBMP may be"
  33. " associated with .BMP file extensions, and automatically invoked by"
  34. " opening a .BMP file.\n"
  35. " \n"
  36. "    It is important to note that ViewBMP was intended as an educational"
  37. " source code sample first, and as a bitmap viewing utility second."
  38. " Priority was given to source code simplicity and clarity. As such,"
  39. " many features (and most of the error checking) which would make ViewBMP a"
  40. " robust, production-level image application have been left out. If"
  41. " you are looking for a serious OS/2 image viewing application, I would"
  42. " highly recommend two shareware programs: PMJPEG and Galleria. Both"
  43. " support multiple image formats (e.g. BMP, GIF, JPEG, PCX, etc), image"
  44. " format conversions, image manipulation, and tons of other features."
  45. " Both are very reasonably priced. And although both do a terrific job,"
  46. " my personal favorite is PMJPEG.\n"
  47. " \n"
  48. " SOURCE CODE\n"
  49. " \n"
  50. "    Source code (and all necessary resources) should have accompanied"
  51. " this executable program; if not, you may request it from me at the"
  52. " E-mail address listed below. The code is provided free of charge."
  53. " The code was developed to demonstrate how an application would"
  54. " take advantage of OS/2 color palettes. It also allows for a comparison of"
  55. " the results (i.e. an image may be view both with and without color"
  56. " palettes ). The code demonstrates many techniques, including:\n"
  57. " \n"
  58.    " * How to read in and decode a single image bitmap file\n"
  59. " \n"
  60.    " * How to extract color info from a bitmap file\n"
  61. " \n"
  62.    " * How to create a color palette\n"
  63. " \n"
  64.    " * How to select a color palette into multiple Presentation Spaces\n"
  65. " \n"
  66.    " * How to create a memory bitmap maintaining original color"
  67. " integrity\n"
  68. " \n"
  69.    " * How to realize a color palette to maintain proper bitmap colors when"
  70. " drawing to the screen\n"
  71. " \n"
  72.    " * How to properly respond to WM_REALIZEPALETTE messages\n"
  73. " \n"
  74.    " * How to dispose of color palette and bitmap resources\n"
  75. " \n"
  76.    " * How to reset the system default color palette\n"
  77. " \n"
  78. "     The source code is relatively well commented and explains the"
  79. " techniques used. It was intended to be easily understood, and"
  80. " hopefully achieves that goal.\n"
  81. " \n"
  82. " WARRANTY ( unfortunate legality )\n"
  83. " \n"
  84. "    This application, and the associated source code, is provided to you"
  85. " solely for the purpose of assisting you in the development of your"
  86. " applications.  Both application and code are provided \"AS IS\", without warranty of any"
  87. " kind.  The author shall not be liable for any damages arising out of"
  88. " your use of the application and/or source code, even if he has"
  89. " been advised of the possibility of such damages.\n"
  90. " \n"
  91. " SUPPORT\n"
  92. " \n"
  93. " As I said above, this program (and source) are provided on an \"AS IS\""
  94. " basis.  I do not plan on updating or improving this program. But with the"
  95. " source code, you should be able to add (or fix) anything"
  96. " you like. Please feel free to incorporate the techniques demonstrated"
  97. " (and portions of the code) in any application you are writing;"
  98. " however I would ask that you make *significant* modifications to the"
  99. " code if you are going to sell it.\n"
  100. " \n"
  101. " I will try to respond to all comments and questions sent to my E-mail"
  102. " address below, but I can not guarantee that I will have timely"
  103. " or complete answers. Thanks for your interest and your time. I hope"
  104. " you find this sample application of value.\n"
  105. " \n"
  106. " John D. Webb\n"
  107. " CompuServe: 71075,1117\n"
  108. " Internet: 71075.1117@compuserve.com"
  109. ;
  110.