home *** CD-ROM | disk | FTP | other *** search
/ Inside Multimedia 1995 July / IMM0795.ISO / share / os2 / ssaver14 / sample.lzh / sample14.txt < prev    next >
Text File  |  1994-07-17  |  3KB  |  88 lines
  1. Hi ScreenSaver module developer!
  2. ================================
  3.  
  4. This is version 1.4 of the sample ScreenSaver module.
  5.  
  6.  
  7. Changes version 1.3 - > 1.4
  8. ---------------------------
  9. no changes.
  10.  
  11.  
  12. Changes version 1.2 - > 1.3
  13. ---------------------------
  14. no changes.
  15.  
  16.  
  17. Changes version 1.1 - > 1.2
  18. ---------------------------
  19.  
  20. There is a problem with OS/2 2.11 (to me it seems to be an OS/2 bug) which
  21. causes ScreenSaver to exit whenever a version 1.1 module ends. This problem
  22. is corrected in version 1.2. Unfortunately the problem had to be corrected in
  23. the module source code. The problem only occurs when "low priority" is enabled.
  24. (To those who are interested: the DosKillThread call kills thread 1 (the main
  25. thread) instead of the priority-controller-thread. Seems to be a bad bug in
  26. OS/2 2.11).
  27. The ScreenSaver program now checks if we run on OS/2 2.11 and if the modules
  28. is a version 1.1 module. If this is true, it runs the module with high
  29. priority although low priority may be selected in the options dialog.
  30. Animation speed setting added.
  31. Random seed now per thread.
  32. *.DEF file changed
  33.  
  34.  
  35. Changes version 1.0 - > 1.1
  36. ---------------------------
  37.  
  38. There are some minor enhancements to the original code.
  39. There is limited support for compiling with Borland C++ now. See below for
  40. more info on that.
  41. The old (version 1.0) code STILL WORKS. The code that was added since
  42. version 1.0 should solve the idle-priority problem that prevented the saver
  43. modules from doing their action when CPU usage of other programs was 100%.
  44. Most of the changes are to avoid compiler warnings from Borland C++.
  45.  
  46. It should not be too much work to incorporate the changes in SAMPLE.C if
  47. you have written code for version 1.0.
  48. I suggest you cut your code and paste it into the new SAMPLE.C. An utility
  49. like "Visual Compare" (all/diskutil/vc132.zip on ftp.cdrom.com) might be very
  50. useful for that.
  51.  
  52.  
  53. Compiling with Borland C++
  54. --------------------------
  55.  
  56. Because of initialization problems with the Borland C runtime library (RTL),
  57. you MUST NOT use ANY RTL-functions (malloc, free, strcpy, _beginthread, srand,
  58. rand, fopen, open, printf etc.).
  59. In the file MINIRTL.C you can find some useful C library functions as source
  60. code. If you link your module with MINIRTL.OBJ, you can use those
  61. functions in your module. DO NOT use any other rtl functions. DO NOT link
  62. your module with one of the Borland libraries (C2*.LIB) (OS2.LIB is ok).
  63. DO NOT link with the startup code supplied by Borland (C02*.OBJ). Use the
  64. startup code BCCDLL0.ASM instead.
  65.  
  66. This seems rather complicated, but in fact all you have to do is uncomment
  67. the "USE_BCC=1" line in SAMPLE.MAK and type "MAKE -F SAMPLE.MAK".
  68.  
  69.  
  70. ------------------------------------------------------
  71.  
  72. If you are going to write saver modules, please get in contact with me.
  73.  
  74. If you already have developed a module, please drop me a line where I can get
  75. it from. Better, uuencode the module and mail it to me.
  76.  
  77. If you have any questions, just contact me via e-mail.
  78.  
  79. Greetings
  80.  
  81. Siegfried Hanisch
  82. Internet e-mail: hanisch@ci.tuwien.ac.at
  83.  
  84. My e-mail address is going to change in a few months. If you can't reach me
  85. under the above address, please send a short e-mail to
  86.   p.wansch@ieee.org
  87. and ask him for my new address.
  88.