home *** CD-ROM | disk | FTP | other *** search
/ Home Edutainment Collect…dows Multimedia Education / Aztech-HomeEdutainmentCollection-Vol6-WindowsMultimediaEducation.iso / randot9a / randot.txt < prev    next >
Text File  |  1994-03-11  |  15KB  |  329 lines

  1. Note:  This file is just extracted from the help file.  It is not in any
  2. special order, but I thought it would be easier to have a hard copy, so
  3. I did this thing.  All the info is exactly the same, it just isn't as
  4. user friendly.
  5.  
  6. New in version .9:
  7.  
  8. version .9a  3/10/94
  9. Fixed Saving routines to work finally.
  10. A new menu command, Show Stereogram, will bring up the last generated RDS
  11. The focusing bars are now in place (they were there in the last version, but what the heck)
  12. The Rotation command now works for Polygons (yes, only Polygons).  See the documentation for more info
  13. I have added a status line at the bottom of the screen.
  14. There is a Progress bar (in the status line) that shows you how close to done the RDS generation is.
  15. The Cut, Copy, and Paste routines now work.  Note that exiting Randot will clear the clipboard (if Randot changed it), and afetr something has been pasted from the clipboard, it is removed, and cannot be repasted.
  16. Printing now works to a limited degree.  Until I add adjustable dot density, it wont be very useful though.
  17. The menus now work better with the RDS on the screen.
  18. A few miscelaneous problems have been corrected.
  19.  
  20. version .1a  3/3/94
  21. first release, lots of bugs, minimal features.
  22.  
  23.  
  24. This is RanDot version .9 alpha.
  25.  
  26. While it is still only an alpha release, Randot is now much improved,
  27. and with just a few more changes, and one or two major bug fixes, it
  28. will be ready for the assembly line and will be released as version 1.0.
  29. I have spent al lot of time developing this program to be bug free
  30. (WHICH IT STILL ISN'T), user friendly, and support as many options as
  31. possible.  If you do happen to discover any undocumented bugs, please
  32. send me mail (snail or internet) telling me so I can fix the problem.
  33. Also PLEASE read the credits for my address, and a list of all
  34. contributors.  If you want to know what is new, go to the new menu,
  35. which lists most changes since the previous version.
  36.  
  37.  
  38.         RanDot is a program which makes random dot stereograms,
  39. supporting more features than any other program similar to it.
  40.  
  41. What is a Random Dot Stereogram?
  42.         A random dot stereogram (or RDS) is a picture which appears in
  43. three dimensions when you view it Cross Eyed or Wide Eyed.  This program
  44. can only generate them in black and white, because colored RDS pictures
  45. are much more dificult to see, and are of much lower quality.  There is
  46. one other type of "color" RDS pictures, which I may possibly support in
  47. the future.  These pictures simply have different background colors, and
  48. different colored dots.
  49.  
  50. how Do I Use RanDot?
  51.     See Using RanDot
  52.  
  53. how do RDS pictures work?
  54.         In truth, I still don't fully understand it, but in general,
  55. they are seen by defocusing the eyes so that you see more than one pont
  56. on the picture at the same time.  If you are totally confused, well, so
  57. am I, so get the book Random Dot Stereograms (see the credits for more
  58. info).
  59.  
  60.  
  61. Note: Cross Eyed viewing is not recomended.  The pictures do not look as
  62. good when viewing this way, and therefore this method should only be
  63. used if you cannot view the pictures Wide Eyed.
  64. To view RDS pictures cross eyed:
  65. first: load one of the precompiled pictures into either a paint program
  66. or into RanDot. The precompiled pictures have black dots at the top
  67. which facilitate learning to view RDS pictures.
  68. now place your head about 1 to 2 feet from the screen, and hold your
  69. index finger about halfway between your head and the monitor.  Now
  70. focusing on your finger (do NOT look at the screen) move it closer or
  71. farther from your head until the two dots at the top of the screen
  72. become three (If you see four dots, you are getting closer).  NOTE:
  73. You sill see the dots out of your peripheral vision. If you look at the
  74. screen instead of your finger, you will not be able to do this.
  75. After you see three dots, continue to stare at the tip of your finger
  76. until the 3-d picture forms on the screen.
  77. Some people can see these pictures almost instantaneously, while for
  78. others (like me) it takes quite a bit of practice, so try not to get
  79. discouraged.
  80. Unfortunately, I have not yet added the ability to place the black
  81. focusing dots onto the pictures generated by RanDot, so you will need to
  82. become proficient at viewing RDS's with the pictures I have distributed
  83. with this program.
  84. If you have a laser or inkjet printer, I recomend printing out the
  85. pictures.  RDS pictures do not print well using dot matrix printers so
  86. don't be too disapointed if you attempt to print them out with one.
  87.  
  88.  
  89. Wide Eyed viewing is the best way to see RDS pictures.  Unfortunately,
  90. most people find it harder than the Cross Eyed way.
  91. there are several ways to try to view RDS pictures Wide Eyed:
  92. first: load one of the precompiled pictures into either a paint program
  93. or into RanDot. The precompiled pictures have black dots at the top
  94. which facilitate learning to view RDS pictures.
  95.  
  96. 1)  If you have glare on your screen, get about 3 feet from the screen,
  97. and look at your reflection on the screen.  After maybe a minute or so
  98. you should see the 3-d picture "appear" on your screen.
  99.  
  100. 2) Move your head 1 to 2 inches from the screen and look straight ahead.
  101. Slowly move your head back always looking straight ahead (not at the
  102. monitor) until you start to see "depth" on the screen.  Stop then and
  103. try to hold the image.  After you see the image clearly you can move
  104. your head back farther until you are at a comfortable distance from your
  105. screen.
  106.  
  107. 3) With your head about 2 feet from the screen, try to look at something
  108. (a spot on the wall, etc) about 6 feet behind your monitor.  Then slowly
  109. move your head so that you are looking past your monitor, but can see it
  110. in your peripheral vision.  YOu should niotice some "depth" in the
  111. picture, and be able to focus on it, and "pull" it out.
  112.  
  113. NOTE:  Do NOT look directly at the monitor.  The only way to see these
  114. pictures is by defocusing your eyes, so looking directly at the picture
  115. will not help you at all.
  116.  
  117.  
  118. Ok...umm...most of the commands are self explanatory, and I am getting
  119. sick of writing this help file, so I will just skim over stuff, and let
  120. you just play around.
  121. In the Set Options menu, you can set whether you want to view the RDS
  122. Cross Eyed (X-Eyed) or Wide Eyed.  This just determines whether the
  123. objects come out at you or go in.  What can I say but play around with
  124. it.
  125. Also in the Set Options menu is a box which says angle.  That is the
  126. angle you want to rotate a polygon per step.  Therefore, if you have 10
  127. steps and want the polygon to do a 360 as it comes out, you would put 36
  128. in the box.
  129. When you select Create Stereogram, I have added the hourglass cursor,
  130. and a progress bar at the bottom right of the screen..  It takes a long
  131. time to make a picture, even on my 486/66...Give it a minute or so.
  132. Printing does work, but the quality is currently quite poor (although I
  133. haven't tried it on a laser or inkjet printer yet).  You can try playing
  134. around with the printer settings to ligheten the output, but I don't
  135. even know if they work yet.  This was a last minute change I tacked on
  136. in about 10 minutes.  NOtice that you can only print your stereograms.
  137. Therefore, if you haven't made one yet, the printout will not be very
  138. good.
  139.  
  140. There are 5 buuttons on the left side of the screen:
  141. Top left button:    This one will let you make ellipses, circles etc.
  142. Top right button:    This one will let you make rectangles, squares, etc.
  143. Middle left button:     This one will let you make polygons.  Just close
  144. the shape (put the last point on the first point), then slect the point
  145. you want to be the highest (or the lowest).  This is kind of hard to
  146. describe, just play around with it,
  147. Middle right button:    This one will let you place text in the window.
  148. Just click somewhere on the window to get the dialog box.  When you are
  149. done, hold down the mouse button and drag the text wherever you want
  150. it.
  151. Bottom left button:     This one is used to copy and paste parts of the
  152. bitmap to and from the clipboard.  To Cut or Copy to the clipboard,
  153. after selecteing the bottom left button, drag your mouse around the box
  154. you want to cut or copy.  then go and hit the appropriate button in the
  155. menu.  To paste, selcet the bottom left button, then click on the paste
  156. menu item.  Now hold down the mouse button, and move the pasted section
  157. wherever you want it to go.
  158.  
  159. There are two slide bars at the top left of the screen.the left one is the color (or height) that you want to start at, the right one is the color (or height) you want to end at.  The brighter the color, the "higher" it is.  Use the Height Levels setting in the Set Options box to change how many steps there are.  Don't put that number much above 15 or the computer will probably die.
  160.  
  161. Ok, here are all many of the things I want to add to this program in the
  162. future.  If you want stuff added, look at Contacting The Author or
  163. credits for how to get in touch with me.
  164.  
  165. 1) I want to be able to type text to the screen in real time (like in
  166. Windows Paintbrush).  I have no idea how to do this, so this one
  167. probably won't be too soon unless one of you would like to give me a
  168. suggestion or two.
  169.  
  170. 2) I want to add BETTER printer support.  This is not too hard, and
  171. should be in version 1.0.
  172.  
  173. 3) I want to add support for animation. This is really cool (I have seen
  174. something like it before), but requires a LOT of work on my part, and so
  175. it probably won't come around too soon.
  176.  
  177. 4) I want to add support for telescoping text,  This would be kind of
  178. neat, and might not be too hard.  I have no idea how long it will take
  179. to do.
  180.  
  181. 5) I want to be able to make background filler, so that the backgrounds
  182. aren't just flat.  This isn't too hard to do, and should be implemented
  183. fairly soon.
  184.  
  185. 6) I want to be able to save to other output formats. This isn't too
  186. bad, but requires me to do some rewriting of large code segments, and so
  187. I probably won't do it for a while.
  188.  
  189. 7) I want, I want, I want.....Well, I want to do a better job on the
  190. help file.  I just threw this one together in one night so I could
  191. distribute this thing FINALLY!
  192.  
  193. 8) I will optimize a lot of the code for the next revision.  The code is
  194. currently a mess, and while it probably won't be faster when I'm done,
  195. it will be much easier to work on. (well, I didn't get around to it in v
  196. .9, but 1.0 will definatly be neat and tidy)
  197.  
  198. 9) I want support for different sized pictures than just 640*480
  199.  
  200. 10) I will make a seperate window for the Stereograms (maybe), instead
  201. of having to hit the Show Stereogram button.
  202.  
  203. 11) The next release will include adjustable displacement, for easier
  204. viewing.
  205.  
  206. 12) In the next release I will also add adjustable dot density (This
  207. will fix the print output)
  208.  
  209. 13) The next release will include actual documentation, and a much more
  210. comprehensive Help file.
  211.  
  212. 14) The next release will probably have the option of a grid overlay to
  213. facilitate drawing.
  214.  
  215. 15) The next release will also have improved error handling, so the
  216. computer doesn't die off on you.
  217.  
  218. well that is it.  If you have any suggestions jsut send them to me.
  219.  
  220.  
  221.         The author of RanDot is Geoffrey L. Hausheer (that is me).  I am
  222. currently a freshman at Cornell University, and an Engineering major.
  223. This program was written because I have been interested in Random Dot
  224. Stereograms for about a year and a half, and have been looking for an
  225. exceptional computer program to create them.  I have seen many excelent
  226. viewers. and some good miscilaneous progams, but have not seen any
  227. programs specifically geared towards creating good 3-d RDSs.  This is
  228. the biggest program I have ever written, and the first program I've ever
  229. written for Windows.
  230.         I wrote this program completely from scratch with no prior
  231. training in Windows programming, and very litle help as far as writing
  232. bitmap routines goes.
  233.  
  234.  
  235.         This program is freeware, and can be used completely free of
  236. charge.  If you feel this is the most incredible program you've ever
  237. used, or you REALLY want to see some new features added, feel free to
  238. send me a donation, and i'll probably even include your name so that
  239. everyone else who gets this will see that you are a generous person, but
  240. I don't expect it.  I mean, I have only registered three pieces of
  241. public domain software in my entire life, and all of them because they
  242. offered tons of bonuses if I did,  I would, however, like to get e-mail
  243. from anyone who gets this program, just to see how many people actually
  244. find it useful.
  245.  
  246. Alright, now that all that is said, if you want to contact me, either:
  247.  
  248. 1) write mail to:
  249. Geoffrey L. Hausheer
  250. 48 Ten Eyck Ave
  251. Albany, NY 12209  
  252. (If you write something about RanDot on the outside of the envelope, I
  253. am gauranteed to get this at any time)
  254.  
  255. 2) Write mail to:
  256. Geoffrey L. Hausheer
  257. 433 Mary Donlon Hall
  258. Ithaca, NY 14853
  259. If it is before May 1994, I will get this, otherwise, I probably won't
  260.  
  261. 3) E-mail me at:
  262. glh1@cornell.edu
  263. I have no idea what will happen to this account once the summer comes,
  264. but for now, It is the fastest way to get a response.
  265.  
  266. Please also look at the credits  They contain lots of neat info (besides
  267. just names and ets).
  268.  
  269.  
  270. Alright, this program has been tested pretty well, but that doesn't mean
  271. too much.  There are a few known bugs though.  If you happen to find a
  272. bug, PLEASE contact me (see Contacting The Author or credits)
  273.  
  274. 1) The program will sometimes give a division by zero erro and crash.
  275. Why I haven't the foggiest..yet.
  276.  
  277. 2) The program will sometimes crash if you add too many points (or add
  278. them too fast) when creating a polygon.  I don't understand this one yet
  279. either.
  280.  
  281. 3) The program may not give you back 100% of the ram it allocates for
  282. pictures.  I have been working on this for a LONG time, yet the program
  283. still keeps between 2 and 5 k per time it is run.
  284.  
  285. 4) This help file must have lots of typos in it since I wrote the whole
  286. thing in one night.
  287.  
  288. 5) Setting the Height Levels much above 15 will crash the computer.  So
  289. don't.
  290.  
  291. 6) The program will crash the computer if is run too many times (about
  292. 10) without restarting Windows.  This is a side effect of my not being
  293. able to free all memory, and will be fixed whenever I fix problem 2.
  294.  
  295. Credits and other misc info:
  296. RanDot v.9 alpha was written by:
  297. Geoffrey L. Hausheer
  298. 48 Ten Eyck Ave
  299. Albany, NY 12209
  300.  
  301. Until May 1994, I can also be contacted at:
  302. 433 Mary Donlon Hall
  303. Cornell University
  304. Ithaca, NY 14853
  305.  
  306. my internet address is:
  307. glh1@cornell.edu
  308.  
  309. While I have not had any direct help in writing this program, I have found many useful sources of information:
  310.  
  311. This help file was generated using:
  312. Help Pre-Compiler v3.0 by Antonio Balcazar
  313.  
  314. A book containing over 50 RDS pictures, as well as miscilaneous source code and other cool information:
  315. Random Dot Stereograms by Andrew A. Kinsman
  316. Published by Kinsman Physics P.O. Box 22682, Rochester, N.Y., 14692-2682
  317. ISBN 0-9630142-1-8
  318.  
  319.  
  320. PC Magazine's Windows 3.1 Graphics Programming by Ben Ezzel
  321. ISBN 1-56276-055-6
  322.  
  323. Miscilaneous freeware source code from microsoft for dealing with Bitmaps
  324.  
  325. Windows 3.1  Programmer's Refrence by James W. McCord
  326. ISBN 0-88022-787-7
  327.  
  328. RanDot was written using Borland C++ 3.1
  329.