home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / graphics / artst232 / artst232.doc next >
Text File  |  1990-03-30  |  23KB  |  420 lines
  1.                             Art-ST Version 2.32
  2.                             ===================
  3.  
  4.                             A Shareware program
  5.                                 Written by
  6.                            Robert M. Birmingham
  7.  
  8.                      Copyright 1990, Axolotl Software
  9.                            All Rights Reserved.
  10.  
  11.  
  12.  
  13.      Art-ST 2.32 is a powerful drawing program that operates in low,
  14. medium, or high resolution.  Not only will you find many of the features
  15. expected in a drawing program (such as; Boxes, Circles/Ellipses, Area
  16. Fills, Copy & Paste, and Fine Pixel Editing), but Art-ST also explores some
  17. rather unique areas of its own!  One of the more interesting aspects of
  18. Art-ST is that it uses all of your computer's memory to support multiple
  19. picture buffers.  This can range from approximately eight picture buffers
  20. on a 520 ST, to over 110 picture buffers on a Mega ST4!  You may also
  21. create your own animation sequences using these picture buffers by using
  22. Art-ST's built in Slide Show feature.
  23.  
  24.  
  25.  
  26.                              Shareware Notice!
  27.                              -----------------
  28.  
  29.      Art-ST is a shareware program and may be freely distributed as long as
  30. the program and the documentation are kept together as one package, and are
  31. not changed in any way.  I have spent a great deal of time designing and
  32. developing Art-ST, and have tried to make it as solid and dependable as
  33. possible.  If you find the program useful, please make my efforts
  34. worthwhile and send a check or money order for $15.00 to:
  35.  
  36.  
  37.                            Robert M. Birmingham
  38.                            13630 S.W. 101 Lane
  39.                            Miami, FL 33186
  40.  
  41.      If you would like to see any new features added to Art-ST, or if you
  42. have a suggestion that would improve an existing feature, please write me a
  43. letter with your ideas!  I'm looking forward to hearing from you!
  44.  
  45.  
  46.  
  47.                              Getting Started:
  48.                              ----------------
  49.  
  50.      Once you have run Art-ST (and have gotten past the opening dialog),
  51. you will see the main screen of the program.  On the left side of the
  52. screen is the menu area, which contains the options that you may use to
  53. create your drawings.  The currently selected item in the menu is shown in
  54. inverse (highlighted).  To select a different item, move the mouse cursor
  55. into the desired box, and click the left mouse button.
  56.  
  57.      Any item in the menu that begins with an asterisk (*) has a secondary,
  58. or alternate, function.  This alternate function is usually just a slight
  59. variation of the original menu selection.  For example: *LINE and *K-LINE,
  60. or *SQUARE and *BOX.  To choose the alternate function of a menu option,
  61. select the desired item then click the mouse button on it again.
  62.  
  63.      When the menu is displayed, the area you may draw on is less than the
  64. full screen.  To draw on the remaining area, use the left and right SCROLL
  65. arrows.  This will move the work area over so other sections of your
  66. picture are visible.  You may hold the left mouse button down while over a
  67. SCROLL arrow and the work area will repeatedly move in the desired
  68. direction.
  69.  
  70.      To draw on the entire screen at once, move the mouse into the work
  71. area, and click the right mouse button.  You may return to the menu screen
  72. by pressing the right mouse button again.
  73.  
  74.      One of the most interesting, and flexible, features of Art-ST is the
  75. ability to support multiple pictures or 'frames' in memory at one time.  To
  76. change to a different frame, use the arrows next to the FRAME box located
  77. in the lower half of the menu area.  Clicking the left mouse button when
  78. the cursor is over the left arrow will show the previous frame, and
  79. clicking over the right arrow will show the next frame.  As you will see
  80. later, this capability lets you produce some impressive animation
  81. sequences.  The number of frames available depends on whether you have a
  82. 520 ST, 1040 ST, or a MEGA ST.  Also, you might want to disable any
  83. accessories and ramdisks you have installed, this will give the the maximum
  84. number of frames possible on your ST.
  85.  
  86.      In addition to selecting the drawing tools, the menu also lets you
  87. control the current drawing color as well as the text, line, and fill
  88. attributes.
  89.  
  90.      To select a different color, click on the color boxes in the lower
  91. half of the menu area.  Art-ST shows the active color in the box directly
  92. below the color selections.  If the program was run in low or medium
  93. resolution, the numbers denoting the Red, Green, and Blue (RGB) content of
  94. the color will be displayed in this box as well (RGB does not apply in the
  95. high resolution mode).  To alter the individual R, G, or B component of the
  96. color, click on (or near) the number you want to change.  The left mouse
  97. button increases the R, G, or B value, and the right button decreases the
  98. value.  By manipulating these values you can access all of the 512 possible
  99. colors supported by the ST.  Although you can't change the RGB content of a
  100. color in the high resolution mode, you can swap the two colors by clicking
  101. the left mouse button inside the box below the color selections.  This lets
  102. you draw with white on a black background, or with black on a white
  103. background.
  104.  
  105.      The explanations for changing the text, line, and fill attributes are
  106. given below in descriptions for the TEXT, *LINE, and FILL drawing tools.
  107.  
  108.      If you make a mistake while you're drawing, you may either press the
  109. UNDO key, or you may click the left mouse button on the UNDO menu option.
  110. However, since an UNDO will only negate the last drawing operation you
  111. performed, be sure to use it before doing any other operations.
  112.  
  113.  
  114.  
  115.                             The Drawing Tools:
  116.                             ------------------
  117.  
  118.      DRAW, With this tool you can draw freehand in the work area by
  119. pressing the left mouse button and moving the mouse.  DRAW uses the
  120. currently selected color, line style, and line thickness.  If you hold the
  121. Alternate key down while drawing, the paintbrush becomes whatever is in the
  122. clipboard area (the buffer area used to hold the material from COPY and
  123. MAGNIFY for the PASTE command).
  124.  
  125.      *LINE, To draw a line, specify the starting point of the line by
  126. pressing the left mouse button.  You may then move the mouse around the
  127. work area and the line will follow the cursor.  To specify the ending
  128. point, press the left mouse button again.  You are able to draw lines using
  129. the current color, line type, line width, and write mode (see MODES).
  130. After you have specified the starting point of the line you may press the
  131. right mouse button to abort this function.  *LINE has an alternate function
  132. called *K-LINE which lets you to continually draw rubber band lines.  After
  133. you have specified the starting point of the first line, then whenever you
  134. specify the ending point, it will automatically become the starting point
  135. for the next line.  To stop drawing lines, press the right mouse button.
  136.  
  137.      To change to a different line pattern, use the arrows next to the line
  138. display box in the lower part of the menu area.  There are six different
  139. patterns for you to choose from.  The first line pattern (the solid line)
  140. is special because you can change its thickness.  Click the left mouse
  141. button inside the line display box to increase its thickness, or click the
  142. right button to decrease its thickness.  The thicknesses of the remaining
  143. five lines may not be changed.  However, the other lines are special in
  144. there own respect, because you can change their patterns to suit your
  145. needs.  See the description of the EDIT tool for more information.
  146.  
  147.      *SQUARE, To draw an outline of a box, press the left mouse button
  148. inside the work area to specify the upper left corner of the box.  Next,
  149. move the mouse until the box is the desired size and shape, then press the
  150. left mouse button to finish the box.  You may abort this function when
  151. specifying the rectangle by pressing the right mouse button.  This function
  152. uses the current color, line type, and thickness.  *SQUARE also has an
  153. alternate function called *BOX; this lets you draw a square filled with the
  154. current fill pattern in a single step.  However, *BOX does not use the
  155. current line style and thickness.
  156.  
  157.      *CIRCLE, After selecting this tool, point to a spot in the work area
  158. that will be the center of the circle and click the left mouse button.  A
  159. "rubber-band" circle will now appear on the screen.  You may control the
  160. circle's radius by moving the mouse cursor toward or away from the center
  161. point.  When you get a circle you like, click the left mouse button again
  162. to place it on the screen.  While you're specifying the circle, you may
  163. cancel it by pressing the right mouse button.  The alternate to this
  164. function is *DISK.  This lets you draw a filled circle or ellipsoid using
  165. the current fill pattern.
  166.  
  167.      FILL, To fill an enclosed shape with the current fill pattern, select
  168. this tool, point to the area you want to fill, then press the left mouse
  169. button.  To select a different pattern, use the arrows next to the fill
  170. pattern box in the lower part of the menu.
  171.  
  172.      Art-ST supports two types of fill patterns; single color and
  173. multicolor.  There are 36 predefined patterns for each fill mode.  If you
  174. are using the single color patterns, FILL will use the color and write mode
  175. you have selected.  If you are using multicolor fill patterns, the current
  176. color is ignored, and the REPLACE write mode will be used.  See the
  177. description of the MODES selection below for more information.
  178.  
  179.      TEXT, To print text, move the cursor into the work area and type in
  180. the desired text.  You may then use the mouse to place the text wherever
  181. desired.  To print the text at this location press the left mouse button,
  182. to abort the text function press the right mouse button or the Undo key.
  183.  
  184.      To change the text style used for the TEXT menu selection, use the
  185. arrows next to the text display box in the lower half of the menu area.  To
  186. change the size of the text, press the right or left mouse button while the
  187. cursor is inside the text display box.  The left button will increase the
  188. size of the text and the right button will decrease the size of the text.
  189.  
  190.      MAGNIFY, This tool lets you grab a section of your picture, magnify
  191. it, and paste it back down like a rubber stamp.  After selecting MAGNIFY,
  192. move the cursor into the work area.  The normal crosshair cursor will
  193. disappear, and you will see a pair of intersecting lines instead.  To
  194. select the upper left corner of the area to magnify, move the point where
  195. these lines meet to the desired position, then click the left mouse button.
  196. When the rubber-band square appears, stretch it out to enclose the desired
  197. area, and click the left mouse button again.  A dialog box will now ask you
  198. for the degree of magnification; 2X, 3X, 4X, 5X, 6X, 7X, 8X, or 9X.  You
  199. can either select the magnification and click on the OK button, or abort
  200. the MAGNIFY function by clicking on the QUIT button.
  201.  
  202.      If you click OK, there will be a delay while the program performs the
  203. calculations necessary to blow up the image.  The length of this delay will
  204. depend on the degree of the magnification and the size of the area to
  205. magnify.  When the magnified image appears, the *PASTE tool is
  206. automatically activated so you may place the image wherever you like.
  207.  
  208.      PIXEL, This tool lets you perform fine editing on a section of your
  209. picture (pixels are the the tiny screen dots that make up a video image).
  210. The first step is to select the area that you want to edit.  Move the
  211. cursor into the work area and you will see see it has changed into a box.
  212. Move this box over your picture until the desired area is within its
  213. confines, then press the left mouse button.  If it's difficult to see
  214. exactly what is inside the box-shaped cursor, refer to the area that has
  215. replaced the lower section of the menu.  This area not only shows what is
  216. inside the cursor, but also shows the surrounding area which can be used as
  217. a reference while you're editing pixels.  While you're making the selection
  218. of the area you want to edit, you may also turn the box in the lower menu
  219. area ON or OFF by pressing the space bar.  This lets you see the exact area
  220. you're going to edit as it appears in the main screen.
  221.  
  222.      After you have selected an area to edit, it will be displayed in an
  223. enlarged form.  You may then edit it as necessary, choosing a new color if
  224. you like.  If you make a mistake, rather than fixing the picture, you may
  225. press the UNDO key instead.
  226.  
  227.      To return to the normal-sized work area, press the right mouse button.
  228. You may then choose a new area to enlarge for additional fine editing.  You
  229. may also select a different menu item to get out of the pixel mode.  (Note:
  230. while using the pixel tool, you cannot select the SLIDE, EDIT, MODES, SAVE,
  231. LOAD, DELETE and QUIT functions.)
  232.  
  233.      *COPY, This lets you copy a section of the current picture into the
  234. clipboard area.  Move the mouse cursor into the work area, and you will see
  235. a horizontal and vertical line.  Move the point where the two lines
  236. intersect to the upper left corner of the box you want to copy, then click
  237. the left mouse button.  Next, move the mouse around to change the size of
  238. the rubber band box until you have found the exact area you wish to copy,
  239. then press the left mouse button.  The area will then be copied into the
  240. clipboard.  To abort the rubber band box, press the right mouse button.
  241.  
  242.      The alternate function of *COPY is *CUT, this acts exactly as above
  243. except that it will erase the area selected after it has been copied to the
  244. clipboard.  You may press UNDO to replace the area erased by *CUT, but the
  245. area specified will still remain in the clipboard.
  246.  
  247.      *PASTE, This tool lets you place the clipboard image anywhere in your
  248. picture (Of course this assumes that you have already copied something into
  249. the clipboard using the *COPY, *CUT, or MAGNIFY tool).  After selecting
  250. *PASTE, move the mouse into the work area of the screen.  You'll notice
  251. that the cursor changes into the image of whatever is stored in the
  252. clipboard.  Position the image as desired; then click the left mouse
  253. button.
  254.  
  255.      *PASTE even lets you move an image from one screen to another (an
  256. extremely useful feature when you're creating frame animation).  Normally,
  257. however, the color palette of the screen that you want to copy the
  258. clipboard image to won't be the same as the palette of the screen from
  259. which you copied the clipboard image.  To paste an image with its original
  260. colors use the alternate function *PASTE+.  Also to change the logic mode
  261. used to paste the image use the MODES option which is discussed later.
  262.  
  263.      EDIT, This selection displays a dialog box that lets you edit the fill
  264. patterns and line patterns that Art-ST uses for its graphics operations.
  265. If you are using the program on a monochrome monitor, you will have 36
  266. single color fill patterns that you can change.  But, if you have a color
  267. monitor, you will have 36 single color fill patterns and 36 multicolor fill
  268. patterns that you can edit.  Although Art-ST supports six different line
  269. patterns, the first line pattern must always remain solid, so its pattern
  270. cannot be changed.  However, the remaining five line patterns can be freely
  271. edited.
  272.  
  273.      On the left side of the dialog, you will find all the controls for
  274. editing the fill patterns.  In the upper left corner you will see the
  275. colors boxes that you can use when changing a fill pattern.  The active
  276. color box will have a '+' character inside it.  Below the color boxes you
  277. will see an enlarged view of the current fill pattern, and a view of how
  278. the fill pattern appears normally right next to it.  To edit the fill
  279. pattern, move the mouse cursor into the box containing the enlarged view,
  280. and click the left mouse button at any position where you want to place the
  281. current color.  Any changes you make will also show up in the normal sized
  282. fill pattern.
  283.  
  284.      You may flip through all the fill patterns by using the left and right
  285. arrows located under the normal sized fill box.  In addition, if you are
  286. using Art-ST with a color monitor, you will see two buttons labeled MONO
  287. and COLOR (They are invisible when using a monochrome monitor).  Use these
  288. to change between the single color and multicolor fill patterns.
  289.  
  290.      On the right side of the dialog you will find all the controls which
  291. let you change Art-ST's line patterns.  The patterns are shown in a series
  292. of boxes, with the currently selected line displayed in a box with a
  293. thicker outline.  Below the line patterns are sixteen small boxes that
  294. represent a magnified view of the the current line pattern.  When you click
  295. on one of these boxes, the corresponding pixel in the selected line will be
  296. be set or erased.
  297.  
  298.      Once you have changed the fill patterns and line patterns to the way
  299. you want them, click on OK to return back to the main program.  However, if
  300. you decide that you don't want to use the patterns you have created, select
  301. CANCEL and all the fill and line patterns will be restored to the way they
  302. were before you began editing them.
  303.  
  304.      MODES, This option lets you control which 'mode' Art-ST will use when
  305. performing; PASTE operations, general graphics operations, and FILL
  306. operations.  When you select MODES, a dialog box will be displayed on the
  307. screen.  You may change the desired mode by pressing the left mouse button
  308. in the appropriate box.
  309.  
  310.      When the PASTE MODE is set to REPLACE, the image in the clipboard will
  311. completely overwrite the area it is placed at.  When the PASTE MODE is set
  312. to TRANSPARENT, any area in the clipboard that is the background color will
  313. not overwrite what is under it.
  314.  
  315.      The settings for the WRITE MODE have the same meanings as the ones for
  316. PASTE MODE.  However, the WRITE MODE is used for the general graphics
  317. operations, such as; DRAW, LINE, CIRCLE, etc.
  318.  
  319.      The MODES dialog also lets you control whether MONO or COLOR fill
  320. patterns are used by any function that needs to fill an area.  Due to a
  321. limitation of GEM, if you have selected COLOR fill patterns, the write mode
  322. will be forced to REPLACE after you press OK.
  323.  
  324.      SLIDE, This function will let you page flip through the pictures you
  325. have created.  When selected, a dialog box will ask you for the frame that
  326. you want to start the animation with, and the frame that you want to end
  327. the animation with.  To select the starting or ending frame click the mouse
  328. cursor on the appropriate left arrow to decrement the frame number, or
  329. click the mouse cursor on the appropriate right arrow to increment the
  330. frame number.  You may also choose an option to either wrap around when a
  331. limit has been reached or to reverse the flipping direction when a limit
  332. has been reached.  When the program is actually flipping through the
  333. pictures you may change the speed by pointing to a different horizontal
  334. position and pressing the left mouse button.  Towards the left will speed
  335. up the rate, and towards the right will slow down the rate.  To exit the
  336. slide show option and return to the main program, press the right mouse
  337. button.
  338.  
  339.      DELETE, This function lets you delete a picture file or any other type
  340. of file from your disk.  When chosen, a file selector dialog box will be
  341. displayed.  Enter the name of the file you want to delete, then press the
  342. OK button.
  343.  
  344.      SAVE, This option lets you save several different types of files.
  345.  
  346.      Art-ST will let you save picture files that are 100 percent compatible
  347. with other drawing programs.  These picture types are; Degas, Degas Elite
  348. Compressed, and NeoChrome files (Neo can only be selected when in low
  349. resolution).  Select the desired picture type, enter its name in the file
  350. selector, and press OK.
  351.  
  352.      Art-ST also lets you save a series of frames all at once.  This can be
  353. a real timesaver if have alot of pictures in memory!  To save a range of
  354. frames, click on the "Multiple Pictures" button, then press OK.  A dialog
  355. box now lets you select the beginning and ending frames of the range that
  356. you want to save.  Use the arrows to increment or decrement the starting or
  357. ending frame then press OK.  Finally, enter the name of the file in the
  358. file selector dialog, and press OK.
  359.  
  360.      If you have created your own fill patterns using the EDIT menu option,
  361. you will probably want to save them for later use.  You can save all 36
  362. single color fill patterns or all 36 multicolor fill patterns by selecting
  363. the appropriate button.
  364.  
  365.      The remaining two types of files that you can save are mostly of
  366. interest to programmers.  They are "Clipboard -> .C" which allows you to
  367. save the image in the clipboard buffer as a C source file, and "Clipboard
  368. -> .S" which allows you to save the clipboard buffer as an Assembly
  369. language source file.  These two options make it easy to include the images
  370. you have drawn in your own programs.  In addition to the data, the color
  371. palette, and the information that indicates the size of the clipboard area
  372. is also saved.
  373.  
  374.      LOAD, This option lets you load a picture file, or a fill pattern
  375. file.
  376.  
  377.      If you want to load a picture file, Art-ST will let you load a; Degas,
  378. Degas Elite Compressed, NeoChrome, or 'Multiple' picture file.  Select the
  379. type that you want to load, then press the OK button.  Now, choose the name
  380. of the file and click on the OK button.
  381.  
  382.      If you want to load a fill pattern file, select the "Mono Fill
  383. Patterns" or "Color Fill Patterns" button.  If you selected 'mono', you
  384. will see all the ".FLM" files on the disk.  If you chose 'color', then you
  385. will see all the ".FL1" files if you are in low resolution, or all the
  386. ".FL2" files if your are in medium resolution.  Select the fill pattern
  387. file you want to load, then press OK.
  388.  
  389.      CLRSCR, This option lets you clear the screen in three different ways.
  390. To quickly clear just the current work area, click the left mouse button
  391. within the CLRSCR box.  If you clear the work area by accident, you may
  392. press the UNDO key to restore your picture.  The drawback to this method is
  393. that it will only clear the portion of your picture that is showing.
  394.  
  395.      If you wish to erase the entire picture, press the right mouse button
  396. within the CLRSCR box.  An alert box will be displayed to verify that you
  397. wish to erase your picture.  Warning: Once you have selected OK, you will
  398. not be able to restore your picture by pressing the UNDO key.
  399.  
  400.      In addition, while you are in the PIXEL edit mode, you may clear the
  401. pixel edit area all at once by selecting CLRSCR.  You may press UNDO to
  402. restore the area that you were editing.
  403.  
  404.      QUIT, Quit the program.  You will be asked if you want to leave the
  405. program so as not to lose any important pictures.
  406.  
  407.  
  408.  
  409.  
  410.  
  411. ==================================
  412. Art-ST Version 2.32
  413. Written by Robert M. Birmingham
  414. Copyright 1990, Axolotl Software
  415. All Rights Reserved.
  416.  
  417. Please support shareware authors!
  418.  
  419. ==================================
  420.