home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1995 November / PCWK1195.iso / inne / podstawy / os2 / ssaver / ssaver23.exe / SAMPLE.ZIP / sample23.txt < prev    next >
Text File  |  1995-05-30  |  5KB  |  121 lines
  1. Hi ScreenSaver module developer!
  2. ================================
  3.  
  4. This is version 2.3 of the sample ScreenSaver module.
  5.  
  6.  
  7. Changes version 2.2 - > 2.3
  8. ---------------------------
  9. no changes.
  10.  
  11. Changes version 2.1 - > 2.2
  12. ---------------------------
  13. no changes.
  14.  
  15. Changes version 2.0 - > 2.1
  16. ---------------------------
  17. increased stack size to 64KB
  18. added exception handling in modules. a crashing module now only stops
  19. executing, keeping the ScreenSaver program alive. a register dump is written
  20. to file CRASH.LOG. If you use this exception handling code, please make
  21. sure that the resources which your drawing thread has allocated are freed.
  22.  
  23. Changes version 1.5 - > 2.0
  24. ---------------------------
  25. module name is now stored in the configuarton data (there were module crashes
  26.   because of the "list box double entry" problem (2.0 has a workaround for
  27.   this OS/2 bug))
  28. the sample code to query the spin button allowed entry of invalid
  29.   values. corrected.
  30. instead of WinGetPS(..) / WinReleasePS(..) I now create a normal PS which is
  31.   much more flexible; code changed in WM_CREATE and WM_DESTROY.
  32.  
  33.  
  34. Changes version 1.4 - > 1.5
  35. ---------------------------
  36. code added to read from an alternate INI file instead of OS2.INI:
  37.   functions query_profile_data() and write_profile_data()
  38.   FUNCTION_SETINIFILENAME in SAVER_PROC(...)
  39. code added to move saver window to top regularly (IDT_ZORDERTIMER)
  40.  
  41.  
  42. Changes version 1.3 - > 1.4
  43. ---------------------------
  44. no changes.
  45.  
  46.  
  47. Changes version 1.2 - > 1.3
  48. ---------------------------
  49. no changes.
  50.  
  51.  
  52. Changes version 1.1 - > 1.2
  53. ---------------------------
  54.  
  55. There is a problem with OS/2 2.11 (to me it seems to be an OS/2 bug) which
  56. causes ScreenSaver to exit whenever a version 1.1 module ends. This problem
  57. is corrected in version 1.2. Unfortunately the problem had to be corrected in
  58. the module source code. The problem only occurs when "low priority" is enabled.
  59. (To those who are interested: the DosKillThread call kills thread 1 (the main
  60. thread) instead of the priority-controller-thread. Seems to be a bad bug in
  61. OS/2 2.11).
  62. The ScreenSaver program now checks if we run on OS/2 2.11 and if the modules
  63. is a version 1.1 module. If this is true, it runs the module with high
  64. priority although low priority may be selected in the options dialog.
  65. Animation speed setting added.
  66. Random seed now per thread.
  67. *.DEF file changed
  68.  
  69.  
  70. Changes version 1.0 - > 1.1
  71. ---------------------------
  72.  
  73. There are some minor enhancements to the original code.
  74. There is limited support for compiling with Borland C++ now. See below for
  75. more info on that.
  76. The old (version 1.0) code STILL WORKS. The code that was added since
  77. version 1.0 should solve the idle-priority problem that prevented the saver
  78. modules from doing their action when CPU usage of other programs was 100%.
  79. Most of the changes are to avoid compiler warnings from Borland C++.
  80.  
  81. It should not be too much work to incorporate the changes in SAMPLE.C if
  82. you have written code for version 1.0.
  83. I suggest you cut your code and paste it into the new SAMPLE.C. An utility
  84. like "Visual Compare" (all/diskutil/vc132.zip on ftp.cdrom.com) might be very
  85. useful for that.
  86.  
  87.  
  88. Compiling with Borland C++
  89. --------------------------
  90.  
  91. Because of initialization problems with the Borland C runtime library (RTL),
  92. you MUST NOT use ANY RTL-functions (malloc, free, strcpy, _beginthread, srand,
  93. rand, fopen, open, printf etc.).
  94. In the file MINIRTL.C you can find some useful C library functions as source
  95. code. If you link your module with MINIRTL.OBJ, you can use those
  96. functions in your module. DO NOT use any other rtl functions. DO NOT link
  97. your module with one of the Borland libraries (C2*.LIB) (OS2.LIB is ok).
  98. DO NOT link with the startup code supplied by Borland (C02*.OBJ). Use the
  99. startup code BCCDLL0.ASM instead.
  100.  
  101. This seems rather complicated, but in fact all you have to do is uncomment
  102. the "USE_BCC=1" line in SAMPLE.MAK and type "MAKE -F SAMPLE.MAK".
  103.  
  104.  
  105. ------------------------------------------------------
  106.  
  107. If you are going to write saver modules, please get in contact with me.
  108.  
  109. If you already have developed a module, please drop me a line where I can get
  110. it from. Better, uuencode the module and mail it to me.
  111.  
  112. If you have any questions, just contact me via e-mail.
  113.  
  114. Greetings
  115.  
  116. Siegfried Hanisch
  117.  
  118. Internet addresses:
  119.     ssaver@ibm.net        (preferred; ScreenSaver related mail only)
  120.     siggih@ibm.net
  121.