home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / SHOW_BMP.ZIP / SHOW_BMP.DOC < prev    next >
Encoding:
Text File  |  1993-03-23  |  3.4 KB  |  66 lines
  1.  
  2.      Documentation For The Show_BMP Unit.
  3.      Compiled March 23, 1993.
  4.      Written By Mike Stone.
  5.  
  6.      The author hereby disclaims all warranties relating to this software,
  7.  whether expressed or implied, including without limitation any
  8.  implied warranties or merchantability or fitness for a particular
  9.  purpose. I will not be liable for any special, incidental, consequential,
  10.  indirect, or similar damages due to loss of data/damage to hardware or
  11.  any other reason, even if I have been advised of the possibility of
  12.  such damages.
  13.  
  14.      Moving right along.. this software is released as freeware and you
  15.  are welcome to distribute it to anyone and everyone, and to use it in
  16.  your own programs. (And don't worry about annoying "Please Register Me"
  17.  messages in the .tpu).
  18.  
  19.      All the unit does is display 64768 byte bitmapped files in
  20.  320x200x256c mode. I was messing around with bitmaps and had this code
  21.  around so I thought i'd release it after I saw some messages about
  22.  people trying to display bitmaps. Its nothing monumental but it works and
  23.  does so fairly fast. Although you won't get the compression you have in
  24.  gif's and pcx's, binary's are faster on the display and are much easier to
  25.  manipulate. There are two procedures you can all with show_bmp -
  26.  
  27.      1) SetVideoMode (mode:byte);
  28.      2) ShowBmp      (BitmapToBeShown:string);
  29.  
  30.      I included the SetVideomode procedure just in case you don't know how to
  31.  change the video mode to $13 (320x200x256c). Then all you have to do
  32.  once you have the correct mode, is call Showbmp with the filename of
  33.  the bitmapped you want displayed. So:
  34.  
  35.      SetVideoMode($13);
  36.      ShowBmp('Example.bin'); {Call ShowBmp with the name of the Bmp to show}
  37.      Textmode(co80);         {Don't forget this when ending your program!}
  38.  
  39.      Don't try initiating the .bgi drivers and calling ShowBmp! ShowBmp will
  40.  probably work with other resolutions other than 320x200, but you'll get a
  41.  smaller picture or really screw things up (so do it at your own risk!).
  42.      Now about the actual data files used. They MUST be 64768 bytes long, and
  43.  no error checking is made (neither is there any error checking when setting
  44.  the video mode to see if the users adapter can handle that mode). I came
  45.  across three utilities that can help in making the needed .bin files.
  46.      First there is the grab.exe utility that comes with Anivga11.zip.Although
  47.  it makes two files they can easily be combined, HOWEVER it seems that the
  48.  images they "grab" are sixteen copies of the picture captured (if you
  49.  understand what I mean), so although it makes for a nice special effect,
  50.  it isn't very useful (thought i'd mention it though in case someone tried
  51.  using it). Oh, and also it has a 3 byte .pic header, so that will really
  52.  mess things up.
  53.      Second I have heard of another grab.exe that makes .bin files (not .pic)
  54.  and that should work fine from what I know of it (although I have never
  55.  used it myself).
  56.      The third program is called intro.exe and I am not sure where it came
  57.  from but it works ideally.
  58.  
  59.      Anyhow, thats about it. I hope you find the unit useful and I might
  60.  do a couple upgrades to make it display bmp's in any resolution, and add
  61.  error checking. Working with bmp's isn't difficult at all so I also hope
  62.  that someone else does it first, so I don't have to ;)
  63.  
  64.      Btw.. the unit was written in Turbo Pascal 6.0 and Assembly and it
  65.  may not display properly on all VGA cards.
  66.