home *** CD-ROM | disk | FTP | other *** search
/ Programming Tool Box / SIMS_2.iso / vb_code1 / alexrk / alexrkt.txt < prev   
Text File  |  1993-02-03  |  11KB  |  198 lines

  1. Alex's Rocket Programmer
  2. copyright, c. 1993 Stan Swigoda
  3. by VBKids (Very Bright Kids)
  4.  
  5. Registration
  6.  
  7. As you may imagine, a lot of time and effort went into this application, especially in the parsing routines used to manipulate the program text box. Please support the concept of Shareware development (and get me off my 286!) by registering this product now.
  8.  
  9. I am requesting a $10 registration fee. For that you will receive a free copy of Version 2.0 of Alex's Rocket Programmer.  This will include a spiffier help facility, an icon or picture of a rocket at the head of each line, some fancy cursor manipulation, some new programming do-dads such as loop processing and a turning meter, "true" direction control based on the direction that the rocket is pointing, a color-fill  option, a new shapes menu, more color options, and, at the request of my chief designer Alex, I may also experiment with adding sound to go with the rocket icon. Alex is never short on ideas!
  10.  
  11. This update will be made available in the spring of 1993 but only to those registered. In addition, if you act now (or anytime for that matter) you will receive free copies of two other children's games now being developed:
  12.  
  13.     Einstein on the Bench (a Math game)
  14.     The Doors of Perception (a Perceptual tricks demo)
  15.  
  16. These will be available in March 1993.
  17.  
  18. Please Register now.
  19. Registration information:
  20.  
  21.     Registration Fee $10
  22.  
  23.     Stan Swigoda - VBKids
  24.     217 Rhoads Av
  25.     Haddonfield, NJ. 08033
  26.     
  27. Please include any comments, complaints or suggestions. You may also reach me at Compuserve ID - 70632, 521.
  28.  
  29.  
  30. Quick Tour
  31.  
  32. To get a quick and dirty appreciation for the way Alex's Rocket Programmer works, simply draw a square by clicking the following buttons:
  33.  
  34. Forward
  35. Down
  36. Backward
  37. Up
  38.  
  39. Notice the commands have been saved in the Program Box on the right with the default Distance (50) and Color (Blue) options. Now, clear the Picture by clicking the Clear button and run the "program" you just wrote by clicking the Run Program button. Viola!
  40.  
  41. Now that you have a program you can embellish it be lengthing lines, changing colors or chaning commands. You can do this in a number of ways:
  42.  
  43. 1 - You can click on new commands - these will be added to the bottom of the "program".
  44.  
  45. 2 - You can directly edit the program by highlighing and changing the commands in the box (don't worry about spacing or capitalization - the only rule is that a comma separate each command).
  46.  
  47. 3 - Or you can type a command in the Single Line Entry text box above the program box and execute it by pressing Enter. This also places the command at the bottom of your program.
  48.  
  49. Program entries can be inserted, deleted or changed in any way simply by highlighting and typing. You can also save a program or open an old program using the File menu options - Save Command File and Open Command File.
  50.  
  51.  
  52. Quick Reference
  53. Commands
  54. Command Line structure:
  55.  
  56.     Draw Lines:
  57.     Direction Button, Distance, Color
  58. These must be seperated by a comma.
  59.  
  60.     Place Points:
  61.     XY, X point, Y point
  62. These must also be seperated by a comma.
  63. The X point and Y point represent point on the picture grid and are in the range from 100 to 200.
  64.  
  65.     Direction Commands
  66.         S - Star
  67.         F - Forward
  68.         B - Backward
  69.         U - Up
  70.         DUR - Diagonal Up Right
  71.         DUL - Diagonal Up Left
  72.         DDR - Diagonal Down Right
  73.         DDL - Diagonal Down Left
  74.  
  75.         XY - Place point from which next line will start
  76.  
  77.     Distance:
  78.         Option buttons:
  79.         10
  80.         20
  81.         30
  82.         40
  83.         50
  84.  
  85. Any number up to 99 can be used.
  86. Note: lines will not overshoot the edge of the picture frame. Rather distances will be shortened if they would result in overshooting.
  87.  
  88.     Color:
  89.         Options buttons:
  90.         Blue
  91.         Green
  92.         Red
  93.         Black
  94.         White.
  95.  
  96. These may also be typed into any program command. Case is not important but this must be the last parameter in a command.
  97.  
  98. Note: the XY command and the Color Fill Button described below use the color of the last line drawn.
  99.  
  100.  
  101. Control Buttons:
  102.     Draw a Star - draws a star from the current point using the current distance and color
  103.         options.
  104.  
  105.     Forward - draws a line in the forward direction (left to right)
  106.  
  107.     Backward - draws a line in the backward direction (right to left)
  108.  
  109.     Down - draws a line in the downward direction (top to bottom)
  110.  
  111.     Up - draws a line inthe upward direction (bottom to top)
  112.  
  113.     Diagonal Up Right - draws a diagonal line up and to the right (ie lower Left to upper Right)
  114.  
  115.     Diagonal Down Right - draws a diagonal line down and to the right (ie upper Left to lower Right)
  116.  
  117.     Diagonal Up Left - draws a diagonal line up and to the left (ie lower right to upper left)
  118.  
  119.     Diagonal Down Left - draws a diagonal line down and to the left(ie upper right to lower left)
  120.  
  121.  
  122. Clear - clears current images from picture box (but leaves Program intact)
  123.  
  124.  
  125. Point Placement - click mouse anywhere within the picture box. This will place a point within the box which will become the starting point of the next line drawn. It will also be written to the program box as an XY command.
  126.  
  127.  
  128. Scribble - a toggle switch which turns the capability to perform freeform scribbling on or off.
  129.  
  130. On - allows freeform scribbling within the picture box whenever the mouse button is pressed. These movements are not captured in the program however.
  131.  
  132. Off - Turns freeform scribbling off aloowing only point placement within the picture box using the mouse. Point Placement is captured in the program as described above.
  133.  
  134.  
  135. Color Fill - fills the picture box with the color option selected. Any picture in the box will be covered (this is opaque paint!), however the program will remain. Color Fill commands are not written to the program box.
  136.  
  137.  
  138. Program Box Editing - The program box can be edited as if it were a text editor. Lines can be highlighted and deleted or copied. New lines can be inserted and existing lines can be modified. The only real restrictions are that all parameters are separated by a comma and that all commands begin in a new line.
  139.  
  140.  
  141. Program Single Line Entry - use the single line entry box to enter and test individual commands. This is a useful way to test the impact of command sequences you've created. After you enter a command, you may execute just the line in the box by pressing enter. The line will execute and be added to the bottom of your program.
  142.  
  143.  
  144. Quit - unloads the form and quits the application
  145.  
  146.  
  147. Clear - Clears the picture box. This will not affect the program. The clear command is not written to the program box.
  148.  
  149.  
  150. Menu Commands
  151.     File Open - An input box will appear requesting the name of a file to open. Enter the full path and file name of any text file where you have either saved a previous program or written a new program from a freeform text editor such as Notepad.
  152.  
  153.     File Save - An input box will appear requesting the name of the file to save. Enter the full path and filename. The contents of the program box will be written to the file listed. The program will remain in the program box.
  154.  
  155.  
  156. Help - Allows viewing this file from a number of different locations - Quick Tour, Commands, Registration and the About information.
  157.  
  158.  
  159. Distance - the scale of the picture box goes from 100 to 200. Therefore no distance can be greater than 99. Options exist for distances of 10, 20, 30, 40 and 50. You may edit any command to change the distance up to a maximum of 99.
  160.  
  161. An elaborate min/max algorithm is employed whenever a line is drawn to determine if it will reach the end of the picture frame before the full distance is used. If it does then the line stops at the edge of the frame (positions 101 or 199).
  162.  
  163. For you techies in the audience - the real challenge here was determining whether an X or Y overflow was reached when drawing diagonal lines then reseting the points.
  164.  
  165.  
  166. Color - Five colors are available - Blue, Green, Red, Black and White. They can be selected through the option buttons provided or by entering them into program commands. (Case is not important).
  167.  
  168.  
  169. Slope - this is the traditional "m" slope where 1 = a 45 degree line, anything greater than 1 is steeper and anything less is shallower. Some neat effects can be made with diagonal lines. This does not affect the diagonal lines in the Star shape. Slope cannot be used in program commands, however, the slope value currently in effect will govern all diagonal lines written when a program runs.
  170.  
  171. About Alex's Rocket Programmer
  172. "Dad, can you draw a star for me on the computer?". My seven year old son Alex asked this question a month ago and I proceeded to demonstrate how easy this was to do in Visual Basic. Alex was satisfied with the image and line animation, but he's too savvy about Windows - he didn't want to draw it using LINE and PSET commands - no, why couldn't I just give him a button! So I drew the star and added a control button titled "Draw a Star" and the ideas started rolling in Alex's head.
  173.  
  174. First, he wanted color control, then size control, then placement control, then vertical, horizontal and diagonal lines, when he made a mistake he wanted to clear the picture, finally, dissatisfied with having his creation limited by the existing buttons, he wanted to control the program himself. This was the real breakthrough into creative programming. We designed the program box, run program command button and open/save file options quickly after that. These features were undoubtedly the most difficult programming chore for they involved translating complex VB commands and parameters into simple, easy to use commands, then developing a parsing/playback routine to execute the program.
  175.  
  176. Whew! - that kid can sure keep a programmer busy! He's a good designer  though because he has the vision of a child - the vision that shouts "anything's possible"! That is the spirit with which Alex's Rocket Programmer was created and the spirit which drives VBKids.
  177.  
  178. We hope you enjoy the product and would like to hear from you. But visions don't grow on trees, they must be fed and nurtured, so please don't forget to register. Thank you for you interest and support.!
  179.  
  180.  
  181. About VBKids - Very Bright Kids
  182. VBKids is dedicated to the development of computer activities for children which are first and foremost fun (otherwise how are you going to get their attention!) and secondly educational.
  183.  
  184. I developed Alex's Programmer on a 286 (yes, there are still a few around!) using Visual Basic Version 1.0. My goal was to give my own children an environment in which they could easily manipulate shapes at the push of a button and then see their actions in simple code statements which they could then directly manipulate. I hoped that this would foster further playing around with these rudimentary commands and stimulate the creative juices which are inherent in programming.
  185.  
  186.  
  187. Registration Information (for those of you who missed it the first time!):
  188.  
  189. Registration Fee: $10
  190.  
  191. Send To:
  192. Stan Swigoda - VBKids
  193. 217 Rhoads Av
  194. Haddonfield, NJ. 08033
  195.  
  196. Compuserve ID - 70632, 521.
  197. 
  198.