home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / TVGAS20.ZIP / TVGAS.DOC < prev    next >
Encoding:
Text File  |  1990-01-10  |  9.7 KB  |  259 lines
  1.                                         |
  2.                                         |
  3.                                         |
  4.                                         |
  5.                                         |
  6.                                         |
  7.                                         |
  8.                                         |
  9.                                         |
  10.                                         |
  11.   ██      ██                                                                |
  12.     █    █                                                                  |
  13.      █  █                                                                   |
  14.       ██                                                                    |
  15.      █  █                                                                   |
  16.     █    █                                                                  |
  17.   ██      ██                                                          Tvgas |
  18.                                                                 Version 2.0 |
  19.                                         |
  20.   ██  ██████                                                                |
  21.   ██  █   ██                                                    A Shareware |
  22.   ██  █   ██                               Turbo Pascal VGA Graphics 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 TVGAS.
  91.  
  92.  
  93.                      TVGAS:  THE BSX SPRITE EDITOR
  94.  
  95. 0. Facts and Stats
  96.  
  97. This system contains the following files:
  98.    TVGAS.EXE  -The executable program.
  99.    TVGAS.DOC  -This document.
  100.    BSXCAT.DOC -BSX International catalog.
  101.    ORDER.DOC  -BSX International order form.
  102.  
  103. System requirements:
  104.    IBM PC,XT,AT,PS/2 or compatible.
  105.    256K RAM at the very least.
  106.    VGA or MCGA display hardware with full memory.
  107.    Microsoft Mouse or compatible.
  108.    DOS 2.1 or later.
  109.    Hard disk recommended because, if you don't have one, yer a real loser.
  110.  
  111. I. General Information
  112.  
  113.    TVGAS is a sprite editor for Turbo Pascal graphics programmers.It lets
  114. you  create  files containing the data for VGA/MCGA low-resolution images
  115. (320x200 pixels by 256 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 60x40 pixels can be created. Since MCGA is rapidly becoming a standard
  118. mode  for graphics games, we figure  there'll be demand  for this kind of
  119. utility.
  120.    "I'm sure," yer no doubt thinking, "that there  are plenty of programs
  121. like that around."  Well,  that's what _we_ thought. It  started  back in
  122. the summer of 1989 when BSX was working on the first of our truly sprite-
  123. intensive programs.  It dawned on us that we were going to have  to write
  124. our own kludgy sprite-producing program in order to  get through with it.
  125. Well, in the finest capitalistic tradition, we decided  to  write a nice,
  126. versatile, user-lovable sprite editor to fill this gaping  market  niche.
  127. This led to the EGA utility TEGAS, which begat the  current VGA  product.
  128. We hope you all find TVGAS useful.  We sure have.
  129.  
  130. II. Installation
  131.  
  132.    All you have to do is put tvgas.exe on yer disk and go.  If you put it
  133. in a directory that is in yer  DOS  search path, then  you can run  TVGAS
  134. from the DOS   command line,  regardless  of  the  directory  you  happen
  135. to be in.   TVGAS should load  with  no problem.   If  you  want TVGAS to
  136. run without sound, just use  the -s command-line switch, as in
  137.  
  138.     tvgas -s
  139.  
  140.    Now yer all set.
  141.  
  142. III. Using TVGAS
  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.  TVGAS sprite files all end with .TPS.
  151.  
  152.    SAVE: Saves a sprite to disk.  Once again, just  give  the  file name;
  153.          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: 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.  Only 16 colors  are  displayed  at once,  but  you  have
  178.         access to all 256 by selecting...
  179.  
  180.    A palette: Above the big color selection squares are the smaller  pal-
  181.         ette selection squares.  Just click to select the palette you now
  182.         want to work with.  Note that the color of a  palette  square  is
  183.         the first color it corresponds to.  Any and all colors  from  any
  184.         and all palettes may be used in a given sprite, allowing for  256
  185.         colors in all.  Real pretty.
  186.  
  187.  
  188.    Using TVGAS images in yer programs:
  189.  
  190.    OK, here's the fun part.  Let's say yer writing a program in which you
  191. would like to put a 50x25 pixel image in different parts of  the  screen.
  192. Then you should start TVGAS, choose NEW, click to make  a  50x25  sprite,
  193. and edit away.  When yer done, you SAVE it as MYSPRITE.TPS and EXIT.
  194.    Now you write yer program. To use  VGA 320x200x256  mode  in  a  Turbo
  195. language, you'll need VGA256.BGI, the add-on graphics  driver.  This  can
  196. be obtained via Borland, or on any  number  of  BBSs worldwide.  Assuming
  197. you've taken care of that, write the code along these lines:
  198.  
  199.    program MyStuff;
  200.    uses CRT,graph;
  201.  
  202.    var
  203.       MSFile                                        :file;
  204.       buffer                                        :pointer;
  205.       MSSize                                        :word;
  206.    .
  207.    .
  208.    .
  209.    procedure LoadMysprite;
  210.    begin
  211.     Assign(MSFile,'MYSPRITE.TPS');
  212.     Reset(MSFILE,1);
  213.         MSSize:=ImageSize(0,0,49,24);
  214.     GetMem(buffer,MSSize);
  215.     BlockRead(MSFile,buffer^,MSSize);
  216.     Close(MSFile);
  217.         PutImage(100,100,buffer^,NormalPut);
  218.     FreeMem(buffer,MSSize);
  219.    end;
  220.  
  221.    begin
  222.     .
  223.     .
  224.     .
  225.     LoadMysprite;
  226.     Repeat until Keypressed;
  227.    end.
  228.  
  229.    You get the idea.  Have fun using TVGAS, and we hope you  find  it  as
  230. massively useful as we have.  Bet you do!
  231.    General rule of thumb: Left  button  does stuff, right  button  undoes
  232. stuff.  Think you can handle that?
  233.  
  234. IV. Technical Info
  235.  
  236.    TVGAS was written in Turbo Pascal 5.5 on  an  IBM  PC  with  an  Intel
  237. Inboard 386,  an Atasi  40MB hard drive,  a Paradise VGA Pro card, and  a
  238. Microsoft bus mouse.  Mouse routines  courtesy  of  Eduardo Martins, with
  239. some  modifications.
  240.  
  241. V. Acknowledgements
  242.  
  243.    Thanx to everyone who has  has registered BSX International  programs!
  244.  
  245. VI. Version Info
  246.  
  247.    Version 2.0 released  10 Jan. 90.  Improved  logic  for  prompting  of
  248.       what filename to use when saving.  Misc code cleanup.
  249.  
  250.    Version 1.0 released  4 Dec. 89.  Initial release.
  251.  
  252. -----
  253. Bob Roberds                                             BSX International
  254. "The Ayatollah of Rock 'n' Rollah"
  255. Durham, North Carolina         January 1990
  256. "You never sausage a place!  You're always a wiener at Pedro's!."
  257. (South of the Border billboard, I-95).
  258. PS: Quit whining and just wear yer (expletive deleted)ing seatbelt.
  259.