home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / TEGAS11.ZIP / TEGAS.DOC next >
Encoding:
Text File  |  1980-01-01  |  9.9 KB  |  292 lines
  1.                                         |
  2.                                         |
  3.                                         |
  4.                                         |
  5.                                         |
  6.                                         |
  7.                                         |
  8.                                         |
  9.                                         |
  10.                                         |
  11.   ██      ██                                                                |
  12.     █    █                                                                  |
  13.      █  █                                                                   |
  14.       ██                                                                    |
  15.      █  █                                                                   |
  16.     █    █                                                                  |
  17.   ██      ██                                                          Tegas |
  18.                                 Version 1.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) 1989 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.  
  102. System requirements:
  103.    IBM PC,XT,AT,PS/2 or compatible.
  104.    256K RAM at the very least.
  105.    EGA or VGA card with 256K of memory.
  106.    Microsoft Mouse or compatible.
  107.    DOS 2.1 or later.
  108.  
  109. I. General Information
  110.  
  111.    TEGAS is a sprite editor for Turbo Pascal graphics programmers.It lets
  112. you  create  files  containing the data for EGA  high  resolution  images
  113. (640x350 pixels by 16 color mode).  These files can then be  loaded  into
  114. memory and dumped to the screen via the PutImage function.  Sprites of up
  115. to 100x60 pixels can be created.
  116.    "I'm sure," yer no doubt thinking, "that there  are plenty of programs
  117. like that around."  Well,  that's what _we_ thought. It  started  back in
  118. the summer of 1989 when BSX was working on the first of our truly sprite-
  119. intensive programs.  It dawned on us that we were going to have  to write
  120. our own kludgy sprite-producing program in order to  get through with it.
  121. Well, in the finest capitalistic tradition, we decided  to  write a nice,
  122. versatile, user-lovable sprite editor to fill this gaping  market  niche.
  123. We hope you all find TEGAS useful.  We sure have.
  124.  
  125. II. Installation
  126.  
  127.    If yer interested in using TEGAS then you are most likely  an  experi-
  128. enced PC user and Turbo Pascal programmer.  Therefore,  we're  not  gonna
  129. coddle you or hold yer hand while  explaing  the  installation and proper
  130. usage of TEGAS.  We're sure you can handle a no-nonsense approach.
  131.    SO:
  132.    Here are the step-by-step installation instructions:
  133.  
  134.    1: Create a directory for the TEGAS program and its support files:
  135.  
  136.       Example:  md c:\tegas
  137.  
  138.    2: Set the TEGAS environment variable equal to the name of the  direc-
  139.       tory  in which you plan to put the TEGAS files.  For example, place
  140.       this  line in yer AUTOEXEC.BAT file:
  141.  
  142.       set TEGAS=C:\TEGAS\
  143.  
  144.       It is vital that you set this variable if you  plan  to  run  TEGAS
  145.       a directory other than the  directory  in  which  the  TEGAS  files
  146.       reside.  It is also crucial that you include the final slash in the
  147.       variable directory name. Thus is is _not_ permissible to say  this:
  148.  
  149.       set TEGAS=C:\TEGAS
  150.  
  151.    3: Append the name of the TEGAS directory to the DOS search path.  For
  152.       example, add
  153.  
  154.       path = C:\TEGAS
  155.  
  156.       to yer AUTOEXEC.BAT file.
  157.  
  158.    4: Unzip the files in this zipfile  into  the directory you just made.
  159.       All of the included files should be put into this directory, except
  160.       of course for this .DOC file.
  161.  
  162.    5: Yer all set.  Now you may just type
  163.  
  164.       tegas
  165.  
  166.       from the DOS command line, regardless of the directory  you  happen
  167.       to be in.  TEGAS should load with no problem.  If you want TEGAS to
  168.       run without sound, just use the -s command-line switch, as in
  169.  
  170.       tegas -s
  171.  
  172.  
  173. III. Using TEGAS
  174.  
  175.    On startup, you'll be greeted by the annoying BSX hello  screen,  then
  176. sent to the work screen.  From here you may choose:
  177.  
  178.    EXIT: Kicks you back to DOS.
  179.  
  180.    LOAD: Loads a sprite file from disk.  You must only give the name, not
  181.      the extension.  TEGAS sprite files all end with .TPS.
  182.  
  183.    SAVE: Saves a sprite to disk.  Once again, just give the file name  of
  184.      up to 8 characters; don't give the extension.
  185.  
  186.    NEW:  Creates  a new sprite.  You pick the width and height of the new
  187.      sprite with the mouse in a self-explanatory way.
  188.  
  189.    DRAW: Picks the default drawing mode, wherein each click of the  mouse
  190.      sets one pixel.
  191.  
  192.    FILL: Does a region fill in the selected color.  Click inside the reg-
  193.      ion to fill it.
  194.  
  195.    LINE: Draws a line in the selected color. Click on the endpoints.
  196.  
  197.    CIRCLE: Draws a circle in the selected color.  Click first at the cen-
  198.     ter, then on the circumference.
  199.  
  200.    RECTANGLE: Draws a rectangle in the  selected  color.   Click  on  the
  201.     opposite corners.
  202.  
  203.    FLIP/FLOP: Lets you either FLIP the sprite (turn it upside down),   or
  204.     FLOP it (turn it left-to-right).  A secondary menu pops up to let
  205.     you choose which.
  206.  
  207.    A color: Pick a color just by clicking on its square at the top of the
  208.     screen.
  209.  
  210.    Using TEGAS sprites in yer programs:
  211.  
  212.    OK, here's the fun part.  Let's say yer writing a program in which you
  213. would like to put a 60x40 pixel image in different parts of  the  screen.
  214. Then you should start TEGAS, choose NEW, click to make  a  60x40  sprite,
  215. and edit away.  When yer done, you SAVE it as MYSPRITE.TPS and EXIT.
  216.    Now you write yer program.  Say:
  217.  
  218.    program MyStuff;
  219.    uses CRT,graph;
  220.  
  221.    var
  222.       MSFile                                        :file;
  223.       buffer                                        :pointer;
  224.       MSSize                                        :word;
  225.    .
  226.    .
  227.    .
  228.    procedure LoadMysprite;
  229.    begin
  230.     Assign(MSFile,'MYSPRITE.TPS');
  231.     Reset(MSFILE,1);
  232.     MSSize:=ImageSize(0,0,59,39);
  233.     GetMem(buffer,MSSize);
  234.     BlockRead(MSFile,buffer^,MSSize);
  235.     Close(MSFile);
  236.     PutImage(200,200,buffer^,NormalPut);
  237.     FreeMem(buffer,MSSize);
  238.    end;
  239.  
  240.    begin
  241.     .
  242.     .
  243.     .
  244.     LoadMysprite;
  245.     Repeat until Keypressed;
  246.    end.
  247.  
  248.    You get the idea.  Have fun using TEGAS, and we hope you  find  it  as
  249. massively useful as we have.  Bet you do!
  250.    General rule of thumb: Left  button  does stuff, right  button  undoes
  251. stuff.  Think you can handle that?
  252.  
  253. IV. Technical Info
  254.  
  255.    Tegas was written in Turbo Pascal 5.5 on  an  IBM  PC  with  an  Intel
  256. Inboard 386, an Atasi 40MB hard drive, a VEGA EGA card, and  a  Microsoft
  257. bus mouse.  Mouse routines courtesy of Eduardo Martins, with  some  modi-
  258. fications.
  259.  
  260. V. Acknowledgements
  261.  
  262.    Thanx to everyone who has  has registered BSX International  programs!
  263.  
  264.    Additional gracias to Billy Dalrymple for pointing out  the  annoyance
  265.    of the flickering arrow.
  266.  
  267. VI. Version Info
  268.  
  269.    Version 1.1 released  23 Sept. 89. Flickering mouse cursor de-flicked.
  270.    Clueless   fool   learns   left  from  right  and  fixes  NEW  message
  271.    accordingly.
  272.  
  273.    Version 1.0 released  22 Sept. 89.  Initial release.
  274.  
  275. -----
  276. Bob Roberds                                             BSX International
  277. "The Ayatollah of Rock 'n' Rollah"
  278. Durham, North Carolina         September 1989
  279. "Ex-Lax cleans like a white tornado."
  280. PS: Quit whining and just wear yer (expletive deleted)ing seatbelt.
  281.  
  282. │ █████
  283. │ █   █
  284. │ █████
  285. │
  286. │ █████
  287. │ █   █
  288. │ █████
  289. │
  290. │
  291. │       Hugo who?
  292.