home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: Programmierung / SOURCE.mdf / programm / windows / c / shobit / read.me next >
Encoding:
Text File  |  1994-08-16  |  5.2 KB  |  159 lines
  1.  
  2. ***************************************************************
  3.           SHOWBIT.DLL
  4. ***************************************************************
  5.  
  6. This DLL is helpful when large bitmaps or many
  7. different bitmaps, which otherwise
  8. must be integrated into the help file, are to be displayed.
  9. 16,256 and more colors as well as gray scales can be shown
  10. under different resolutions of your graphic card.
  11. It is the ideal tool for electronic manual projects, 
  12. hypertext books or simply to illustrate and "pop up" the winhelp 
  13. source files you have already written. In addition, easy 
  14. winhelp integration of multimedia elements (ShowBmp.dll) as well as 
  15. execution of windows applications 'right from the winhelp text' 
  16. is now provided.
  17. SHOWBIT enables the display of up to 16 bitmaps on one 
  18. single help topic. It also enables to combine several animated bitmaps 
  19. on one help topic. 
  20.  
  21. - BAGGAGE file support for all bitmaps and MCI files
  22. - GIF file display
  23. - PCX file display
  24. - works from different help projects at the same time
  25. - ** high resolution hotspot display **
  26. - hotspot functions: ** jumps, popups, legends and immediate sound play **
  27. - all DLL's very much smaller than before. 
  28.  
  29. SHOWBIT is the younger brother of SHOWBMP.DLL, and is included 
  30. in the total software package. 
  31.  
  32. Installation
  33.  
  34. (a) Copy the zipped file in a new subdirectory 
  35. (b) Unzip it with the pkunzip -d option. 
  36. (c) Then start winhelp.exe and open the file showbit.hlp 
  37.     (you can compile showbit.hlp from showbit.rtf with hc.exe
  38.     [available in the CIS winsdk forum, libary winhelp]) 
  39.     and install the supplemented help and demonstration file. 
  40.  
  41.  
  42. Quick reference: 
  43.  
  44. Calling SHOWBIT.DLL from a help file is dead easy:
  45. In case you save your documents in RTF-format,
  46. copy SHOWBIT.DLL into an execution directory (HERE: C:\WINDOWS)
  47. and integrate the following line in your help document:
  48.  
  49. {ewl SHOWBIT.DLL,ShowBit_DLL,c:\pictures\test.bmp}
  50.  
  51. Explanation:
  52.  
  53.      ewl SHOWBIT.DLL
  54.                  -> Fist argument: Execute command
  55.                      and complete path to SHOWBMP.DLL or
  56.                      use subdirectory known to system. 
  57.                      ewc will center the bitmap
  58.                      (id the whole cmd line is centered), 
  59.                      ewl will place it on the left side,
  60.                      ewr will place it on the right side
  61.                      of the topic window. ewl and ewr
  62.                      will allow text right or left from
  63.                      the bitmap.
  64.  
  65.      ShowBit_DLL            ->  Second argument: DLL's Window class
  66.  
  67.      c:\pictures\test.bmp   ->  Third argument : Complete path to
  68.                      bitmap .
  69.  
  70. {ewl C:\WINDOWS\SHOWBIT.DLL,ShowBit_DLL,c:\pictures\test.bmp [CMD]}
  71.                                   *****
  72.  
  73.     [CMD]                   ->  Fourth argument: Special command
  74.                      (optional! To date, the commands
  75.                      available are (many others may follow):
  76.  
  77.     MOVER n    lets the bitmap slide in from the right side  (n=speed)
  78.     MOVEL n    lets the bitmap slide in from the left side
  79.     MOVET n    lets the bitmap slide in from the top
  80.     MOVEB n    lets the bitmap slide in from the bottom
  81.  
  82.  
  83.     STRETCH n s
  84.                   lets the bitmap grow (speed n) from the initial size s
  85.                   [in % of total bitmap]
  86.  
  87.     HOTSPOT_EDIT  enables to define hotspots on high resolution images. 
  88.  
  89.  
  90.  
  91.  
  92.      *********           Note            *************
  93.  
  94. Device independent bitmap files (*.bmp, *.dib), GIF bitmap files  
  95. and PCX files can be displayed with this version. Others might follow.  
  96.  
  97. The DLL reads the bitmap file and corresponds with the Winhelp
  98. engine to adjust the client window size for the size of the bitmap.
  99. The DLL is removed from memory when WinHelp finishes.
  100.  
  101. Only in the shareware version 
  102. of the program, which is for evaluation purposes,  
  103. every bitmap will be displayed with a small title "evaluation display". 
  104. If you register, you will receive a 
  105. copy without limitations. 
  106.  
  107. Registration: GO SWREG
  108.  
  109. # ID 2365  Single user version   -> $ 49
  110. # ID 2500  Development version   -> $ 149
  111.  
  112. The software package contains ShowBmp.dll and ShowBit.dll and demo 
  113. material. In the development version you are allowed to pass the 
  114. DLL's to you customers without royalty. 
  115.  
  116.  
  117. Current limitations: 
  118.  
  119. - 16 bitmaps on one help topic page; 
  120. - One instance of sound,video,animation 
  121.   at one time on one help topic page;
  122. - printing not supported
  123.  
  124.  
  125. Further Notes:
  126.  
  127. {ewl SHOWBIT.DLL,ShowBit_DLL,.\BITMAPS\test.bmp [CMD]}
  128.  
  129. .... will work, if the dll is located in an execution directory
  130. (see "PATH" documentation) and if a subdirectory in the current
  131. help directory named "BITMAPS", which contains a file named
  132. "test.bmp", exists. Note the "." in front of "\BITMAPS\".
  133. This way to call the DLL will enable system
  134. independent file location of your help file, dll's and bitmaps.
  135.  
  136. Developed and tested on a 486 33 MHz 8 Mb System using
  137. Borland C++ 4.0 and WfW 3.11. Also runs with Visual Help and
  138. RoboHelp.
  139.  
  140. Have fun. Please contact me, as usual, in case of problems
  141. or suggestions.
  142.  
  143.  
  144. Munich, 16.8.94
  145.  
  146.  
  147. Dr. Rudolf Bumm
  148. Munich
  149. Germany
  150. (100025,2206)
  151.  
  152. Copyright 1993, 1994 and all rights reserved.
  153.  
  154. WINDOWS is a trademark of Microsoft Corp.
  155. All other brand and product names are trademarks or registered 
  156. trademarks of their respective holders.
  157. GIF is a file format of the COMPUSERVE coorp. 
  158. PCX is a file format of Microsoft Corp. 
  159.