home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 1183.dms / 1183.adf / Spright / Spright.doc < prev    next >
Text File  |  1991-07-17  |  7KB  |  171 lines
  1. Spright V1.2 Copyright (c) 1991    SHAREWARE
  2.  
  3.             Code Size = 71508 bytes
  4.             Maximum Code Size = 169268 bytes        
  5.  
  6.     Spright is a sprite paint program which will save simple
  7.   or attached sprite(s) to a file.
  8.       Spright is freely distributable as long as both files (Spright_V1.2
  9.   & Spright_V1.2.doc) remain intact.  Spright is SHAREWARE.  If you decide 
  10.   you like & can use the program a minimum of 10$ is requested.
  11.   
  12.       To send comments, suggestions, or money, send to:
  13.     
  14.     Todd Neumiller
  15.     P.O. Box 18591
  16.     Spokane, WA     
  17.              99208
  18.              
  19.       Spright will allow a sprite height to be from 1 to 200.  Since 
  20.   the width of a sprite is only 16 pixels, Spright has a Dual mode which
  21.   sets up two sprites side by side for editing.  If more colors is what
  22.   you want? Attached sprites (15 colors + background color) also can be
  23.   created.  3 colors + background is all that is possible for a simple 
  24.   sprite.  The colors used (which can be changed anytime) will also be 
  25.   saved in the file in case they are needed.
  26.       In the center of the screen there is a boxed area which is the 
  27.   paint area.  The pixel painted will be a 4x4 sized pixel. And on the
  28.   right side of the screen the sprite will be shown.  
  29.       To attach two sprites in a program select a pair of sprites that
  30.   use the same color register (0-1)(2-3) ect. Place them at the same
  31.   spot on the screen.  Set the second control word at the beginning 
  32.   of the shape data on the second sprite to 0x80 (SPRITE_ATTACHED). 
  33.   From then on only the first sprite has to be called when moving ect.
  34.   
  35.   Directions:
  36.   
  37.   Quit             This gadget will terminate the program.  No warnings given.
  38.   
  39.   Dual      The Dual mode is used if two sprites are wanted side by 
  40.           side.  Each sprite will be the same length. Different 
  41.         colors can be used for each sprite if attach mode is 
  42.         not on.
  43.         Activation = DUAL gadget.
  44.     
  45.   Switch    If you are in Dual mode, this will switch the sprite in
  46.            the editing box area.  There are brackets by the sprite(s)
  47.         to show which sprite & what section of the sprite is in
  48.         the editing box.
  49.         Activation = Switch gadget & space bar. If the space bar
  50.         is used the pointer has to be out side of the editing box.
  51.         (unless in copymode)
  52.         
  53.   Attach     This will attach another sprite to your sprite(s).  This
  54.           allows the sprites to have 15 colors + the background 
  55.         color.  Otherwise 3 colors + background.
  56.         Activation = Attach gadget.
  57.         
  58.   Erase        This will erase your sprite(s) to the background color.
  59.           Activation = Erase gadget.
  60.         
  61.   Save         The save gadget will open another window with path &
  62.           file string gadgets for the file information. Click 
  63.         the OK gadget when done.  Cancel gadget to return without
  64.         saving the file.
  65.         
  66.   Load        The load gadget will also open another window. The 
  67.           directory of the path chosen will be displayed. Simply
  68.         click the file desired then choose OK.
  69.     
  70.   Print        This will give a print out of the rastport.  The sprites
  71.           themselves will not be printed only the edit area with 
  72.         the enlarged sprite image. The background is changed to
  73.         white during the dump.
  74.         
  75.   Snapshot     This will save the sprite separately in memory.  If
  76.           you make a few changes and don't like them the sprite
  77.         can be restored to the way it was when snapshot was 
  78.         clicked.  If Dual mode is on switch to the 2nd sprite
  79.         to snapshot it also.  They won't be stored together.
  80.            
  81.   Restore       This restores the sprite selected to the way it was
  82.           when snapshot was clicked.
  83.         
  84.   RGB Slider Gadgets
  85.           
  86.         These will change the colors of the sprites.  Change
  87.         your pen color by clicking the pen gadget desired,
  88.         then adjust the RGB.
  89.         
  90.   Color Gadgets
  91.           Clicking a color gadget will change you pen color.  If
  92.         you have a simple sprite only 4 gadgets will be present.
  93.         The top being the background.  If Dual mode is on 3
  94.         more gadgets will appear below these for the other sprite. 
  95.         Both will share the background gadget. With attach on
  96.         all 16 color gadgets will appear.
  97.         
  98.   String Gadget
  99.           The string gadget is for the sprite height.  It can be
  100.         changed at anytime before saving the file. Min 1 Max 200.
  101.         
  102.   Copy         This gadget is the box with a C in the center. When
  103.           selected go to the top left area you want to copy in
  104.         the editing box. 
  105.         If you want to copy the source image to the destination
  106.         image with out source background being copied, click the
  107.         copy gadget again.
  108.         Click the mouse button down & hold it down. Move the 
  109.         mouse to the bottom right corner of the area wanted. 
  110.         Then release the mouse button. At this time it is possible 
  111.         to use keyboard commands. Switch, scrollup, scrolldown, 
  112.         left, right, & center. (these will be explained later)
  113.         Place the image following your mouse over the area desired
  114.         and press the button. If the copied section fits it will
  115.         appear in the sprite data.
  116.                 
  117.   Rotate Left   This gadget is the arrow left of the copy gadget.  This
  118.           will rotate the area 90 degrees counter-clockwise. To
  119.         mark the area, select the rotate size before clicking the 
  120.         rotate gadget. These are the gadgets numbered 2 to 16.
  121.         A high-lighted box will follow the mouse, place it over
  122.         the area & press the mouse button.  If the box is not
  123.         inside the edit area the rotate mode will abort.
  124.         Activation = Rotate Left gadget & numeric keypad 4.
  125.                 
  126.   Rotate Right  This gadget is the arrow right of the copy gadget.  Use
  127.           the same instructions as rotate left.
  128.         Activation = Rotate Right gadget & numeric keypad 6.
  129.         
  130.   Home        If your sprite is more the 48 pixels in height it will
  131.           be larger than the edit box.  To have the edit area
  132.         move to the top of the sprite use this.
  133.         Activation = numeric keypad 7.
  134.         
  135.   PageUp        To move your edit box up 48 pixels on the sprite, 
  136.           (if over 48 rows high) Page up can be used.
  137.         Activation = numeric keypad 9.
  138.         
  139.   Center        This will put the edit box to the center of the sprite.
  140.           Activation = numeric keypad 5.
  141.         
  142.   End        Move the edit box to the end of the sprite.
  143.           Activation = numeric keypad 1.
  144.         
  145.   PageDown      Move the edit box 48 pixels down.
  146.           Activation = numeric keypad 3.
  147.         
  148.   Scroll Left   This shifts all the data of the sprite to the left.  If
  149.           Dual sprites are used the data will shift to the sprite 
  150.         next to it. The data on the very left side will wrap to 
  151.         the data on the right side. If you only want to change
  152.         one sprite try using Snapshot to restore the sprite back
  153.         after the scroll. The scroll left gadget is the left 
  154.         arrow that you will see in a group of 4 pointing up, down
  155.         left, & right.
  156.         Activation = Scroll left gadget & keyboard arrow left.
  157.         
  158.   Scroll right  This will shift all the data to the right.
  159.           Activation = Scroll right gadget & keyboard arrow right.
  160.         
  161.   Scroll up     If your sprite is over 48 pixels in height.  Scroll up
  162.           is used to move one pixel at a time in the edit box up.
  163.         Activation = Scroll up gadget & keyboard arrow up.
  164.         
  165.   Scroll down   This moves one pixel at a time down.
  166.           Activation = Scroll down gadget & keyboard arrow down.
  167.                                      
  168.       
  169.     
  170.                                  
  171.