home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / TEGAS21.ZIP / TEGAS.DOC < prev    next >
Encoding:
Text File  |  1990-01-18  |  9.1 KB  |  257 lines
  1.                                         |
  2.                                         |
  3.                                         |
  4.                                         |
  5.                                         |
  6.                                         |
  7.                                         |
  8.                                         |
  9.                                         |
  10.                                         |
  11.   ██      ██                                                                |
  12.     █    █                                                                  |
  13.      █  █                                                                   |
  14.       ██                                                                    |
  15.      █  █                                                                   |
  16.     █    █                                                                  |
  17.   ██      ██                                                          Tegas |
  18.                                                                 Version 2.1 |
  19.                                         |
  20.   ██  ██████                                                                |
  21.   ██  █   ██                                                    A Shareware |
  22.   ██  █   ██                                 Turbo Pascal EGA Sprite Editor |
  23.   ██  █   ██                                                                |
  24.   ██  █   ██                                                                |
  25.   ██  █   ██                                                   User's Guide |
  26.   █████   ██                                                                |
  27.                                         |
  28.                                         |
  29.    ███ ████                                                                 |
  30.   █   █    █                                                                |
  31.   █   █    █                                                                |
  32.   █   █    █                                                                |
  33.   █   █    █                                                                |
  34.   █   █    █                                                                |
  35.   ██████████                                                                |
  36.                                         |
  37.   I n t e r n a t i o n a l                                                 |
  38.                                         |
  39.                                         |
  40.                                         |
  41.                                         |
  42.                                         |
  43.                                         |
  44.                                         |
  45.                                         |
  46.                                         |
  47.                                         |
  48.                                         |
  49.                                         |
  50.                                         |
  51.                                         |
  52.                                         |
  53.                                         |
  54.                                         |
  55.  
  56.  
  57.            BSX's No-License Nonsense Statement!
  58.  
  59.                  This product  (C) 1990 BSX International
  60.  
  61.    This software is provided "as is" with no guarantees of any kind. You,
  62. the user, are permitted and encouraged to distribute it and  use it,  but
  63. under the following conditions:
  64.  
  65.    1) You absolutely, positively may not sell  this  program  without the
  66. permission of BSX International.
  67.  
  68.    2) Under no  circumstances should you distribute versions of this pro-
  69. duct which  have  been altered in any way without the permission  of  BSX
  70. International.
  71.  
  72.    3) Under no circumstances should you remove the copyright notices from
  73. the code or from the documentation which is provided with it.
  74.  
  75.    4) This is a shareware product.  You may  use  it for free for a short
  76. period.  After that you must either register or stop  using it.  You  may
  77. still distribute it, however.
  78.    If you find this  program  to be  a blast,  you ought to  send along a
  79. $5.00 registration fee to:
  80.  
  81.                BSX International
  82.                806 Park Ridge Rd. Apt. A8
  83.                Durham, NC 27713
  84.  
  85.    Make checks payable to Robert Roberds.  Thanx!
  86.  
  87.         Pre-Documentation "Don't Panic" Reassurance
  88.  
  89.    Look, it's real easy.  These dox are nice, and you oughtta skim  them.
  90. But we gotta tell you:  It's a true gut to use TEGAS.
  91.  
  92.  
  93.              TEGAS:  THE BSX SPRITE EDITOR
  94.  
  95. 0. Facts and Stats
  96.  
  97. This system contains the following files:
  98.    TEGAS.EXE  -The executable program.
  99.    *.TPS      -The icon sprite files.
  100.    TEGAS.DOC  -This document.
  101.    BSXCAT.DOC -BSX International catalog.
  102.    ORDER.DOC  -BSX International order form.
  103.  
  104. System requirements:
  105.    IBM PC,XT,AT,PS/2 or compatible.
  106.    256K RAM at the very least.
  107.    EGA or VGA card with 256K of memory.
  108.    Microsoft Mouse or compatible.
  109.    DOS 2.1 or later.
  110.  
  111. I. General Information
  112.  
  113.    TEGAS is a sprite editor for Turbo Pascal graphics programmers.It lets
  114. you  create  files  containing the data for EGA  high  resolution  images
  115. (640x350 pixels by 16 color mode).  These files can then be  loaded  into
  116. memory and dumped to the screen via the PutImage function.  Sprites of up
  117. to 100x60 pixels can be created.
  118.    "I'm sure," yer no doubt thinking, "that there  are plenty of programs
  119. like that around."  Well,  that's what _we_ thought. It  started  back in
  120. the summer of 1989 when BSX was working on the first of our truly sprite-
  121. intensive programs.  It dawned on us that we were going to have  to write
  122. our own kludgy sprite-producing program in order to  get through with it.
  123. Well, in the finest capitalistic tradition, we decided  to  write a nice,
  124. versatile, user-lovable sprite editor to fill this gaping  market  niche.
  125. We hope you all find TEGAS useful.  We sure have.
  126.  
  127. II. Installation
  128.  
  129.    Installation is easy.  Just put  TEGAS.EXE  and all the included  .TPS
  130. files in a directory.  If that directory is in your path,  then  you  can
  131. now run TEGAS from anywhere.  Just type:
  132.  
  133.    tegas
  134.  
  135. at   the  DOS  command   line, regardless  of  the directory  you  happen
  136. to  be  in.  TEGAS should  load  with  no  problem.  If you want TEGAS to
  137. run  without  sound,  just use the -s command-line switch, as in
  138.  
  139.    tegas -s
  140.  
  141.  
  142. III. Using TEGAS
  143.  
  144.    On startup, you'll be greeted by the annoying BSX hello  screen,  then
  145. sent to the work screen.  From here you may choose:
  146.  
  147.    EXIT: Kicks you back to DOS.
  148.  
  149.    LOAD: Loads a sprite file from disk.  You must only give the name, not
  150.      the extension.  TEGAS sprite files all end with .TPS.
  151.  
  152.    SAVE: Saves a sprite to disk.  Once again, just give the file name  of
  153.      up to 8 characters; don't give the extension.
  154.  
  155.    NEW:  Creates  a new sprite.  You pick the width and height of the new
  156.      sprite with the mouse in a self-explanatory way.
  157.  
  158.    DRAW: Picks the default drawing mode, wherein each click of the  mouse
  159.      sets one pixel.
  160.  
  161.    FILL: Does a region fill in the selected color.  Click inside the reg-
  162.      ion to fill it.
  163.  
  164.    LINE: Draws a line in the selected color. Click on the endpoints.
  165.  
  166.    CIRCLE: Draws a circle in the selected color.  Click first at the cen-
  167.     ter, then on the circumference.
  168.  
  169.    RECTANGLE: Draws a rectangle in the  selected  color.   Click  on  the
  170.     opposite corners.
  171.  
  172.    FLIP/FLOP: Lets you either FLIP the sprite (turn it upside down),   or
  173.     FLOP it (turn it left-to-right).  A secondary menu pops up to let
  174.     you choose which.
  175.  
  176.    A color: Pick a color just by clicking on its square at the top of the
  177.     screen.
  178.  
  179.    Using TEGAS sprites in yer programs:
  180.  
  181.    OK, here's the fun part.  Let's say yer writing a program in which you
  182. would like to put a 60x40 pixel image in different parts of  the  screen.
  183. Then you should start TEGAS, choose NEW, click to make  a  60x40  sprite,
  184. and edit away.  When yer done, you SAVE it as MYSPRITE.TPS and EXIT.
  185.    Now you write yer program.  Say:
  186.  
  187.    program MyStuff;
  188.    uses CRT,graph;
  189.  
  190.    var
  191.       MSFile                                        :file;
  192.       buffer                                        :pointer;
  193.       MSSize                                        :word;
  194.    .
  195.    .
  196.    .
  197.    procedure LoadMysprite;
  198.    begin
  199.     Assign(MSFile,'MYSPRITE.TPS');
  200.     Reset(MSFILE,1);
  201.     MSSize:=ImageSize(0,0,59,39);
  202.     GetMem(buffer,MSSize);
  203.     BlockRead(MSFile,buffer^,MSSize);
  204.     Close(MSFile);
  205.     PutImage(200,200,buffer^,NormalPut);
  206.     FreeMem(buffer,MSSize);
  207.    end;
  208.  
  209.    begin
  210.     .
  211.     .
  212.     .
  213.     LoadMysprite;
  214.     Repeat until Keypressed;
  215.    end.
  216.  
  217.    You get the idea.  Have fun using TEGAS, and we hope you  find  it  as
  218. massively useful as we have.  Bet you do!
  219.    General rule of thumb: Left  button  does stuff, right  button  undoes
  220. stuff.  Think you can handle that?
  221.  
  222. IV. Technical Info
  223.  
  224.    Tegas was written in Turbo Pascal 5.5 on  an  IBM  PC  with  an  Intel
  225. Inboard 386, an Atasi 40MB hard drive, a VEGA EGA card, and  a  Microsoft
  226. bus mouse.  Mouse routines courtesy of Eduardo Martins, with  some  modi-
  227. fications.
  228.  
  229. V. Acknowledgements
  230.  
  231.    Thanx to everyone who has  has registered BSX International  programs!
  232.  
  233.    Additional gracias to Billy Dalrymple for pointing out  the  annoyance
  234.    of the flickering arrow.
  235.  
  236. VI. Version Info
  237.  
  238.    Version 2.1 released 18 Jan. 90.  Color and icon changes to make TEGAS
  239.    easier on the old eyes.  Clueless idiot realizes  that it's  apartment
  240.    "A8", not "8A", fer crimminy's sake.
  241.  
  242.    Version 2.0 released 9 Jan. 90.  Graphics sped and cleaned up.  TVGAS-
  243.    style intelligent "save as" questioning implemented.
  244.  
  245.    Version 1.1 released  23 Sept. 89. Flickering mouse cursor de-flicked.
  246.    Clueless   fool   learns   left  from  right  and  fixes  NEW  message
  247.    accordingly.
  248.  
  249.    Version 1.0 released  22 Sept. 89.  Initial release.
  250.  
  251. -----
  252. Bob Roberds                                             BSX International
  253. "The Ayatollah of Rock 'n' Rollah"
  254. Durham, North Carolina         January 1990
  255. "The Noriega of EGAga."
  256. PS: Quit whining and just wear yer (expletive deleted)ing seatbelt.
  257.