home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Developer / objc / screen / ScreenMunger.README < prev   
Encoding:
Text File  |  1992-05-12  |  4.9 KB  |  136 lines
  1.                 ScreenMunger
  2.             Low level video display hacks
  3.  
  4.  
  5. INTRODUCTION:
  6. ScreenMunger is a small collection of *very* low level programs that play
  7. with screen memory directly.  It may prove useful for understanding how
  8. to implement signal trapping, write ioctl calls, and/or use screen memory
  9. directly for really fast drawing.  It also does some pretty cool graphic
  10. effects :-).
  11.  
  12.  
  13. LEGAL:
  14. Copyright (C) 1992 by William Bumgarner and Charles Swiger
  15.  
  16. This code is provided for free; you may modify and/or redistribute it under
  17. the terms of the GNU General Public License as published by the Free Software
  18. Foundation.  This program is distributed WITHOUT ANY WARRANTY and without any
  19. guaruntee of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  20. A copy of the GNU Public License is included in the file "LICENSE".
  21.  
  22. You might be able to reach the authors at wb1j+@andrew.cmu.edu and
  23. cs4w+@andrew.cmu.edu.  Your comments, suggestions, and criticisms are most
  24. welcome.
  25.  
  26.  
  27. CREDITS:
  28. Bill Bumgarner       - primary author of version 1.0
  29. Adam Swift           - random chunks of code, testing
  30. Chuck Swiger         - primary author of version 2.0
  31. Pete Wickerscham     - some code, and color support hopefully RSN
  32. Julie Zelenski       - a suggestion to use the evs driver
  33.  
  34.  
  35. VERSION HISTORY
  36. Version 2.0:
  37.  
  38. The examples here have been modified to use signal trapping.  They are much
  39. friendlier now, in that they restore the screen memory to its original
  40. state when the program stops or is paused.  Much of the code has been
  41. rewritten for clarity.  It has also been rewritten to avoid core dumps.
  42.  
  43. The following programs use the evs driver (/dev/evs0) to control the screen
  44. brightness: br, bright, bright2, and flash.  They should work on any type
  45. of display.
  46.  
  47. The other programs need to have direct access to /dev/vid0.  To do this, type
  48. "chmod 666 /private/dev/vid0" while logged in as root.  Note that this could
  49. represent a security hole.  If security is an issue, be sure to change
  50. the permissions back to their original state when you are through.
  51.  
  52. At the moment, the programs that write directly to screen memory assume a
  53. monochrome display.  They break in interesting ways on a color machine.
  54. This may be fixed soon.  (Come on, Pete!)
  55.  
  56. You can run more than one screen munger at a time; just be sure that you
  57. kill the first process last, or you'll end up with a fairly mangled video
  58. buffer.  No harm can come of this, but it is visually annoying.  Either
  59. reboot your machine or move the windows, menus, and icons around to redraw the
  60. screen.
  61.  
  62. -cws
  63.  
  64.  
  65. Version 1.0:
  66. (Annotated from the original README to include changes made by v2.0.)
  67.  
  68. An example of using an ioctl call to control video.  This is not
  69. documented or supported and will probably break in some future release
  70. of the software.  The original thought came from elsewhere.
  71.  
  72. But, hey, its only a hack...
  73.  
  74. Notes (about brightness control):
  75.  
  76. - Under 2.0, there is a proper way to do this... this is NOT that way.
  77. [Fixed, uses evs. -cws]
  78.  
  79. - Under 2.0, /dev/vid has access rights of crw-------.  Either this
  80. code must be run as root or root must change the access rights to
  81. /dev/vid.  Under 1.0, /dev/vid was apparently set to crw-rw-rw-;
  82. leaving open all sorts of interesting potential destruction via networks.
  83.  
  84. - This is an undocumented sort of thing;  I haven't played long enough
  85. to figure out how to READ a value from /dev/vid0...  At this point in
  86. time, this code only controls the brightness of the monitor but can't
  87. tell you what it was set to in the first place.
  88. [Try "man evs." -cws]
  89.  
  90. - br.c is the only documented piece of code-- the rest is just as
  91. straightforward.  How much documentation can one have for something so
  92. few lines long?
  93. [The code is now documented.  Well, somewhat.  -cws]
  94.  
  95. ---
  96.  
  97. Notes (about memory munging):
  98.  
  99. - This code only works correctly on a mono system. To get it to work
  100. on a NeXTstation Color would not be that difficult;  just change some
  101. of the constants (VIDEO_MW, NPPB, VIDEO_H, and the like-- see
  102. /usr/include/nextdev/video for more information) to deal w/the
  103. colorstation's memory layout:
  104.  
  105. 12 bit color:  4 bits/sample, 3 samples/pixel, 1.5(!) bytes/pixel
  106.  
  107. [      pixel1       ][      pixel2       ][      pixel1       ]...
  108. [samp1][samp2][samp3][samp1][samp2][samp3][samp1][samp2][samp3]...
  109. [   data[0]  ][   data[1]  ][   data[2]  ][   data[3]  ][   data[4]  ]...
  110.  
  111. - On NeXTdimension, this code will not work at all.  I have heard
  112. rumors that it is possible to get the 'base-address' of ND video
  113. memory, but have seen no confirmation or information in regards to how
  114. to do such a thing (if anyone figures it out, PLEASE mail me).
  115.  
  116. - If you really want to diddle points directly, check out
  117. GraphicsWrap-- it is available from the sonata.cc.purdue.edu archive.
  118.  
  119. ---
  120.  
  121. A final warning:
  122.  
  123. This code is a HACK.  It is NOT a supported thing to do to your
  124. system;  it WILL break in the future.  But... it is cool, and it could
  125. be used to write some really COOL game/animation stuff.  Have fun
  126. w/it, and send me anything cool you create... I would definitely be
  127. interested.
  128.  
  129. b.bum
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.