home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 231 / 231.d81 / t.vdot < prev    next >
Text File  |  2022-08-26  |  15KB  |  594 lines
  1. u
  2.                V D O T
  3.     DOTBASIC VISUAL DESIGN UTILITY
  4.  
  5.    Mr. Mouse Image Construction Kit
  6.            by Dave Moorman
  7.  
  8.     The first step in creating slick
  9. DOTBASIC programs is to visually
  10. design the screen using VDOT.
  11.  
  12.     VDOT is a text screen designer,
  13. built on MR.MICK, which is similar to
  14. Screen Dazzler by Brian Eddy,
  15. published on LOADSTAR #90. The
  16. difference here is that MR.MICK and
  17. VDOT are mouse-driven, include a font
  18. editor, and the ability to save and
  19. load screens in a format which
  20. includes the font.
  21.  
  22.     And VDOT allows you to define and
  23. assign Event Regions for use with
  24. DOTBASIC!
  25.  
  26.     Text screens are not like DOODLE
  27. or KOALA screens. Text screens are
  28. made using Commodore graphics, more
  29. appropriately called "font graphics,"
  30. pieced together with font characters.
  31. For instance, the LOADSTAR at the top
  32. of our main menu is not a DOODLE, but
  33. a font graphic that's been typed or
  34. printed to the regular text screen.
  35. How artistic can a graphic screen be
  36. with only text? Well, check out any
  37. of Phil Sampson's "Black Knight"
  38. pictures and you'll see what can be
  39. done with only the graphics
  40. characters supplied by the C-64
  41. default character set. With a custom
  42. set (which LOADSTAR practically
  43. requires) you can really get fancy.
  44.  
  45.     It's easy to make text screens,
  46. even artsy ones, but you're limited
  47. by the font, which only has 256
  48. unique characters. If you want to
  49. type text on the screen, you'll have
  50. to alter characters other than text
  51. characters in the font. The trade is
  52. usually the C= key characters,
  53. most of which are rarely used.
  54.  
  55.     VDOT has multiple file
  56. formats, two based on the .TBS
  57. format.
  58.  
  59.  [Note from Jeff:] TBS stands for
  60. Toolbox Stash Format. I didn't know
  61. when I designed my screen stash
  62. subroutine that I was designing an
  63. official, usable file "format,"
  64. worthy of a file extension. All I
  65. can say is that today I consider
  66. myself the luckiest man on the face
  67. of the earth.
  68.  
  69.     This screen editor sports a
  70. built-in font tool that does nearly
  71. everything a font editor does -- but
  72. all right on the screen where you can
  73. see the interaction of custom
  74. characters. In short, VDOT has
  75. everything you need for dramatic text
  76. screen design.
  77.  
  78.     You will need an intelligent
  79. mouse in port 1, or a joystick in
  80. port 2. On boot-up, you will see a
  81. Menu Bar and pointer on a black
  82. screen. This is [MOUSE MODE] -- and
  83. every function is available on the
  84. three pull-down menus. You can call
  85. the menus with a point and click, or
  86. press:
  87.  
  88.  CONTROL-F for File
  89.  CONTROL-E for Edit
  90.  CONTROL-C for Control.
  91.  
  92.     Note that the functions on the
  93. Control Menu have hot keys listed.
  94. The F-keys are easier than slogging
  95. through the menu:
  96.  
  97.  F1 - Toggle Menu Bar On/Off
  98.  F3 - Toggle Window On/Off
  99.  F5 - Switch Font/Color Windows
  100.  UP ARROW - Window to Top/Bottom
  101.  
  102.     The Menu Bar and Window are non-
  103. destructive, giving you access to the
  104. whole screen. Press F3 and F5 until
  105. you have the Font Window visible on
  106. the screen.
  107.  
  108.     In FontMouse Mode, you can pick
  109. up any visible character with a point
  110. and click, then move it to any place
  111. on the screen and place it with
  112. another click. You can only pick up
  113. characters from the Font display.
  114. Press the right mouse button or F7 to
  115. drop a character without placing it
  116. on the screen.
  117.  
  118.     At the right of the Font display
  119. is the character editor. Point and
  120. click a cell to toggle the pixel. The
  121. cursor keys move the box cursor on
  122. the display to select the current
  123. character.
  124.  
  125.     While the font is visible,
  126. pressing F6 (or Font Edit Control
  127. from the Control Menu) will display a
  128. menu of ten useful character
  129. manipulators. The pointer is trapped
  130. in the Font Control Menu until you
  131. press the right mouse button or F7.
  132. The first nine controls are obvious
  133. and immediate. To Copy one character
  134. to another, first choose the
  135. character to be copied using the
  136. cursor keys. Then click on [Copy].
  137. The pointer will jump to the Font
  138. display (and is trapped there). Point
  139. to the character to receive the copy
  140. and click. (To cancel, point at the
  141. character in the box cursor.)
  142.  
  143.  
  144.  [COLORMOUSE MODE]
  145.  [{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}]
  146.  
  147.     Press F5 to switch to the Color
  148. Window. The pointer becomes a "Paint
  149. Bucket." Point and click one for the
  150. colors on the palette to set the
  151. current color. Then simply hold down
  152. the left mouse button (or fire) and
  153. move around to paint the characters on
  154. the screen.
  155.  
  156.     To the left of the palette is the
  157. border/background box. Move the
  158. "Bucket" to the far left edge of the
  159. Color Window and click to paint the
  160. border. Point to the center of the box
  161. and click to paint the background. If
  162. the background and Menu Bar are the
  163. same color, press F4 to cycle through
  164. menu colors. All menus and dialog
  165. boxes will be in the Menu Bar color.
  166.  
  167.     VDOT lets you work in any C-64
  168. color mode. With the Color Window
  169. visible, press F2 (or use the Control
  170. Menu <F2 To .... Mode>). You will
  171. cycle through each color mode. In
  172. Extended Background, the background
  173. colors are displayed in four
  174. quadrants. In Multi-Color, the three
  175. background colors are displayed in
  176. three rows.
  177.  
  178.  [Note:] If the border color is 0-7,
  179. you will not see the extra multi-
  180. colors. Choose colors 8 - 15 and
  181. click the border rim of the color box
  182. to see the two other background
  183. colors in the center of the box. The
  184. three rows WILL respond correctly to
  185. painting even if they do not display
  186. the colors. Just chalk it up to the
  187. nature of our favorite beast!
  188.  
  189.     We have just three other Control
  190. Menu functions left. F8 is a
  191. QuikSave, which you can perform once
  192. an image has been named. The BACK
  193. ARROW cycles you through fonts:
  194.  
  195.     Custom
  196.     to Default Upper Case
  197.     to Default Lower Case.
  198.  
  199.  
  200.  [TEXT MODE]
  201.  [{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}]
  202.  
  203.     Point and click are nice -- but
  204. the keyboard is better for straight
  205. typing. Use the Control Menu <Shift-
  206. RET: To Text Mode>, or press Shift-
  207. RETURN. The menus are not available
  208. in Text Mode, and the only Function
  209. key functioning is F1. To exit Text
  210. Mode, press Shift-RETURN or F1.
  211.  
  212.  [Clue:] Remember F1! In a stroke or
  213. two, F1 will get the Menu Bar back on
  214. the screen.
  215.  
  216.     In Text Mode, the keyboard works
  217. almost exactly like the native C-64
  218. screen editor. I have excluded the
  219. irritating line links and bottom
  220. scrolling. Insert and Delete only
  221. affect the cursor row. Set colors and
  222. Reverse On/Off in the normal way. CLR
  223. clears the screen. However, if you
  224. press CLR again, the screen will be
  225. restored to the point where you
  226. entered Text Mode.
  227.  
  228.     F1 or Shift-RETURN returns you to
  229. Mouse Mode.
  230.  
  231.  
  232.  [THE MENUS]
  233.  [{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}{SHIFT-*}]
  234.  
  235.  
  236.  [File Menu]
  237.  
  238.  New -- clears work in progress.
  239.  
  240.  Load --
  241.  
  242.  VDOT will load:
  243.  
  244.  ToolBoxStash   (.TBS)
  245.  Meddlefile     (.MED)
  246.  SuperToolStash (.STS)
  247.  Font    ( F. )
  248.  Screen    (from 1024)
  249.  Color    (from 55296)
  250.  
  251.     The Meddlefile (.MED) loads a
  252. font followed by .TBS format data,
  253. followed by Region and Event data.
  254. This the file format used by DOTBASIC
  255. for the visually designed screen.
  256.  
  257.     SuperToolStash is a group of one
  258. to four .TBS images in one file --
  259. particularly handy for bringing
  260. several images into a program with a
  261. single bload. The .STS file fits
  262. nicely at page 160 or 224 under ROM.
  263.  
  264.     Screen and Color files have been
  265. included to bring data in from less
  266. sophisticated programs.
  267.  
  268.  [SAVE]
  269.  
  270.  Choose the file-type:
  271.  
  272.  F.   Font
  273.  .TBS  ToolBoxStash
  274.  .MED  Meddlefile (DOTBASIC)
  275.  .STS  SuperToolStash
  276.  
  277.     Next input the filename and
  278. confirm. See below in Put/Get Image
  279. about saving .STS files.
  280.  
  281.  [QUIKSAVE]
  282.  
  283.     Once a .TBS or .FTS file is
  284. saved, the filename is embedded in
  285. the data. QuikSave saves the .TBS
  286. file to the same filename with auto-
  287. replace. F8 will do a QuikSave in one
  288. keystroke.
  289.  
  290.  [PUT/GET IMAGE]
  291.  
  292.     MR.MICK has four buffers to hold
  293. .TBS images, which can be saved
  294. together as an .STS file. If the
  295. image has no name, Put will ask you
  296. for one. The image names are listed
  297. on the Buffer Menu -- making swapping
  298. between images extremely easy.
  299.  
  300.     When you save the .STS buffer,
  301. you are asked which images to save.
  302. The file will contain images down to
  303. the one you choose. Only the images
  304. saved will load. For instance, if you
  305. saved images 1 and 2, you can later
  306. load them on top of 1, 2, 3, and 4,
  307. replacing only the first two images.
  308. This way, you can easily shuffle
  309. around between images.
  310.  
  311.  [PUT/GET FONT BUFFER]
  312.  
  313.