home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / MAC2GIF.ZIP / MAC2GIF.DOC next >
Text File  |  1988-09-18  |  13KB  |  332 lines
  1.  
  2.  
  3.  
  4.            MAC2GIF v1.00 (c) 1988 Lawrence Gozum & Marvin Gozum
  5.            ────────────────────────────────────────────────────
  6.  
  7.                                 User Manual
  8.  
  9.     DISCLAIMER
  10.  
  11.     This  product  is distributed AS IS.  The authors specifically disclaim
  12.     all  warranties  ,expressed  or implied, including ,but not limited to,
  13.     implied  warranties  of  merchantability  and  fitness for a particular
  14.     purpose  with respect to defects in the diskette and documentation, and
  15.     program  license  granted  herein,  in particular, and without limiting
  16.     operation  of  the  program  license  with  respect  to  any particular
  17.     application  use  or  purpose.  In no event shall the authors be liable
  18.     for  any  loss  of  profit or any other commercial damage including but
  19.     not limited to special,incidental, consequential or other damages.  
  20.  
  21.  
  22.     LICENSING AGREEMENT
  23.  
  24.     You  may  use  this program on a TRIAL BASIS only;  this means that you
  25.     may  freely  evaluate the usefulness of this program for a 10-day trial
  26.     period.    Should  you  find  this program useful, you must register it
  27.     (see  last  section  of  this manual).   You will then be provided with
  28.     the  latest  releases (or updates) of applications or utilities for EGA
  29.     or VGA.
  30.  
  31.     You  may  freely  distribute  copies  of this program in its UNMODIFIED
  32.     state  (i.e., including all files listed in README.1st) provided you do
  33.     not  include  it  in  other  software  packages,  with the exception of
  34.     distributing  it  as  part  of  a  bundle of Public Domain or Shareware
  35.     programs  on  a  single  diskette.  In addition you may not charge more
  36.     that  $3.50 for copying and/or distributing this program in the absence
  37.     of any recognized Users Group guidelines.
  38.  
  39.  
  40.     WHAT IS MAC2GIF ?
  41.  
  42.     MAC2GIF  is  a  viewer/colorizer/conversion  utility for creating files
  43.     which  follow  CompuServe's  GIF  ("Graphics Interchange Format") which
  44.     allows  the  transmittal and porting of your pictures to other machines
  45.     inany graphics mode, as well as through communication software.  
  46.  
  47.     MAC2GIF  will view and convert any .MAC (MacPaint or "readmac") file in
  48.     EGA,  VGA  or  MCGA.   All pictures are colorized (greys or EGA colors)
  49.     and  view  the entire picture with correct aspect ratios.  No scrolling
  50.     is  needed since the entire .MAC file is interpolated to fit the screen
  51.     in any of the selected EGA, VGA or MCGA modes.
  52.  
  53.     VGA/MCGA  users  can Bsave 320x200x256 screen in the .BLD & .PLT format
  54.     for  editing,  garnishing, colorizing and image processing in VGACAD or
  55.     incorporation in their own BASIC or QuickBASIC programs.
  56.  
  57.  
  58.     MAC2GIF Copyright (c) 1988 Lawrence & Marvin Gozum
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.     REQUIREMENTS
  71.  
  72.     You  MUST have an EGA or VGA or MCGA adaptor (at least BIOS compatible)
  73.     present.    Floppy disk users MUST have COMMAND.com present in Drive A;
  74.     Hard disk users must have COMMAND.com in ther DOS PATH.
  75.  
  76.     For  the  record,  512KB  of  free memory is required (although it uses
  77.     much  less than that).  Hard disk users must have 368,640 bytes of free
  78.     disk  space.    Dual  floppy users must have 184,320 bytes of free disk
  79.     space in BOTH drives (A & B).
  80.  
  81.  
  82.     SPECIFYING INPUT AND OUTPUT FILES
  83.  
  84.     After   running  the  program,  you  will  first  be  asked  what  disk
  85.     configuration  you  have  [H]arddisk  or  [D]ual Floppies;  the program
  86.     will then check for the right overlay files and diskspace.
  87.  
  88.     You  will  be asked for if you want to view files and and set the path.
  89.     The  selected  path  will be the default sub-directory that the program
  90.     will  access  for  all  your .MAC files;  MacPaint pictures that do not
  91.     have the .MAC extension should be renamed to this convention.
  92.  
  93.     PATHNAMES MUST END WITH THE BACKSLASH CHARACTER (e.g. "C:\MACPICS\").
  94.  
  95.     Now  input the filename (e.g., "NJANUD.mac"); if you skipped specifying
  96.     then  the filename must include the path as well (e.g., "B:\NJANUD.mac"
  97.     or  "C:\MACPICS\NJANUD.mac").  IF  THE  FILE DOES NOT EXIST, ABEEP WILL
  98.     SOUND AND YOUR INPUT WILL BE REJECTED.
  99.  
  100.     Next  input  the  GIF  filename  the  picture  will  be saved to (e.g.,
  101.     "NJANUD.gif");  WITH  HARDDISK  USERS, CONVERTED FILES WILL BE SAVED TO
  102.     THE  DEFAULT  DRIVE/DIRECTORY;  NO PATHNAMES MUST PRECEDE THE FILENAME.
  103.     FOR DUAL FLOPPY USERS CONVERTED FILES WILL BE SAVED IN DRIVE B.
  104.  
  105.     IF  THE  SPECIFIED  .GIF  FILE  EXISTS  THEN A BEEP WILL SOUND AND YOUR
  106.     INPUT WILL BE REJECTED.
  107.  
  108.          VGA/MCGA users:
  109.  
  110.          You  will  be  prompted  for  an optional .BLD & .PLT filename for
  111.          saving  MCGA  320x200x256 screens.  Use this option if you want to
  112.          convert pics for use in VGACAD or in BASIC applications.
  113.  
  114.  
  115.     VIEWING AND SAVING CONVERTED PICTURES
  116.  
  117.     There are four viewing options, VGA cards can use any or all options:
  118.  
  119.          [V]GA  288x360x5  greys
  120.          [X]VGA 384x480x5  greys
  121.          [M]CGA 192x200x13 greys
  122.          [E]GA  384x350x5 colors
  123.  
  124.     MAC2GIF Copyright (c) 1988 Lawrence & Marvin Gozum
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.     All  modes  will  show  the  entire  .MAC  picture.  Pcitures that were
  137.     viewed  and  saved on an IBM machine will have distorted aspect ratios.
  138.     Only  original .MAC pictures will show correct aspect ratios (which are
  139.     about 95% of all pictures in the Public Domain).
  140.  
  141.     After  viewing any of the pictures press <RETURN> and your picture will
  142.     be  saved  to  a .GIF file as specified.  Press <ESC> to go back to the
  143.     main  menu.    You  can  view  the  pictures in ANY or ALL of the modes
  144.     before  saving  as long as your video card supports that mode.  If your
  145.     video  card  does  not  support that mode an error beep will result and
  146.     return  you  to  the main menu.  Once saved, if you view the picture in
  147.     another   mofde  and  save  the  picture,  it  will  replace  the  file
  148.     previously saved; only one file is saved at a time.
  149.  
  150.     The  [M]CGA  option offers the option to save in the .BLD & .PLT format
  151.     if  you  elected  that option at the start; otherwise it will save as a
  152.     .GIF  file.    Only  one  of the two formats will be saved as specified
  153.     during the INPUT & OUTPUT FILE SPECIFICATION.
  154.  
  155.     In  [E]GA  mode,  you  can  change  the  palettes  to 9 different color
  156.     combinations  by  simply  pressing  numbers  1  to  9 after the picture
  157.     appears;  monochrome  users  can  try  different  palettes  to  get the
  158.     maximum number of viewavble shades. 
  159.  
  160.     REMEMBER  ONLY  THE  <ESC>  WILL  BRING  YOU BACK TO THE MAIN MENU; ALL
  161.     OTHER KEYS WILL RESULT IN AN ERROR BEEP.
  162.  
  163.  
  164.     BLOADING CONVERTED SCREENS IN BASIC
  165.  
  166.     The  following  lines  will  load  one  of  the  captured  screens from
  167.     QuickBASIC  4.0;    if you are using QuickBASIC 1.0, 2.0 or 3.0, I have
  168.     included  VGAMODE.obj which you can include in your UserLib.exe through
  169.     BUILDLIB.exe.
  170.  
  171.     VGAMODE  is  a BIOS compatible assembly routine which can call the more
  172.     exotic  graphic  modes  of your compatible VGA card (e.g. 800x600x256);
  173.     check your user manual for the correct hex codes.
  174.  
  175.  
  176.          USAGE:  Call VGAMODE(&H13) :    'MCGA 256 color mode
  177.          or      Call VGAMODE(mode%):    'where mode is an integer that
  178.                                          'corresponds to the videomode
  179.                                          'after translating it from HEX
  180.  
  181.     The following lines will perform just as well as the listing above.
  182.  
  183.          Call VGAMODE(&H13):             'init MCGA 256 color mode
  184.          DEF SEG=&HA000:                 'point data segment to
  185.                                          'screen buffer A0000H 
  186.          Bload "MYPIC.BLD",0:            'load the screen
  187.          DEF SEG:                        'restore data segment
  188.  
  189.  
  190.     MAC2GIF Copyright (c) 1988 Lawrence & Marvin Gozum
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.     For  QuickBASIC  (any  version  from  1.0  to  4.0),  I  have  included
  203.     WRITEPAL.obj,  which  is, also a VGA BIOS routines written in assembly,
  204.     that  you  can  include  in your UserLib.exe through BUILDLIB.exe (v3.0
  205.     and  lower)  or  LINK  (v4.0).    WRITEPAL  is  also  a BIOS compatible
  206.     assembly  routine  that  writes to 256 palette registers.  Although its
  207.     main  purpose  is  to  facilitate  the  overriding  of  the VGA or MCGA
  208.     standard  palette,  since  it  is  an  all-purpose BIOS routine it will
  209.     facilitate  changing  the  palettes of more exotic screen modes such as
  210.     640x480x256  or  800x600x256.    This  function  is similar to "PALETTE
  211.     USING"  in  QuickBASIC  with  the major advantage of following the BIOS
  212.     convention which MAC2GIF and VGACAD uses.
  213.  
  214.          USAGE:  Call WritePal (Dseg%,Offset%)
  215.  
  216.          WHERE:  Dseg%  =result of VARSEG for array storage
  217.                  Offset%=result of VARPTR for array storage
  218.  
  219.     The following lines illustrate its use.
  220.  
  221.          REM: Example Routine
  222.          DIM UserPal%(769)               :' 256 colors x 3 registers=768
  223.                                          :' registers= red grn blu
  224.          Dseg%=VARSEG(UserPal(1))        :' get data segment
  225.          Offset%=VARPTR(UserPal(1))      :' get offset
  226.          DEF SEG=Dseg%                   :' override data segment
  227.          BLOAD "MYPIC.PLT",Offset%       :' bload in correct offset
  228.          DEF SEG                         ;' restore data segment
  229.          Call WritePal (Dseg%,Offset%)
  230.  
  231.  
  232.     USING VGABLD
  233.  
  234.     The  "bloadable"  format  has several advantages.  If you intend to use
  235.     your  pictures  primarily  in IBM machines in VGA or MCGA mode then you
  236.     will  notice  that  the  pictures  load  INSTANTANEOUSLY  !  Bloading a
  237.     screen  is  simply  a  memory  dump  into  your  display area;  this is
  238.     particularly crucial for presentations.
  239.  
  240.     In  addition, keeping the screen and palette separate allows you to use
  241.     one  palette for several pictures or for creating special effects.  For
  242.     example,  you  can  make a picture shift from a "day scene" to a "night
  243.     scene"  by  simply  changing the palette; you can also create animation
  244.     effects.
  245.  
  246.     You  need not go through the tedium of writing your own program just to
  247.     view  converted  pictures.    VGABLD  will  load a picture for viewing.
  248.     Captured  screen  and  palette  MUST  have the .BLD and .PLT extensions
  249.     respectively  for  the same picture.  The BASIC source code is included
  250.     and is ready for compilation.
  251.  
  252.  
  253.  
  254.  
  255.  
  256.     MAC2GIF Copyright (c) 1988 Lawrence & Marvin Gozum
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.     REGISTRATION
  269.  
  270.     To  register  your  copy,  send  in the registration form and check for
  271.     $14.95 or $19.95 payable to
  272.  
  273.                              Dr. Marvin Gozum
  274.                       2 Independence Place Apt. 303-2
  275.                             6th & Locust Street
  276.                           Philadelphia, PA 19106
  277.  
  278.  
  279.     BONUS:    Registered  users  of  VGACAD v1.40 or VGA2EGA are registered
  280.               for  MAC2GIF.  Copy your REGISTER.OVL file into the directory
  281.               of  MAC2GIF  and it will operate as a registered version.  IF
  282.               YOU  HAVE  NOT REGISTERED VGACAD v1.40 or VGA2EGA, DO SO NOW;
  283.               THIS OFFER IS VALID ONLY WITH VGACAD v1.40 or VGA2EGA v1.00.
  284.  
  285.  
  286.     For  $19.95  you  will  be entitled to the latest update of MAC2GIF and
  287.     VGA2EGA  (EGA  users)  or  VGACAD  (VGA  users)  as well as one copy or
  288.     upgrade  of  any  EGA  or VGA applications that we have or may release.
  289.     Among the utilities that support EGA and VGA to be released are:
  290.  
  291.          VGAPRN  v2.00 - prints 256 color GIFs to Epson and IBM compatibles
  292.          in 7 (hopefully 13) user-assignable grey shades.
  293.  
  294.          VGAPUB  -  converts  256 color GIFs to B&W images of varying sizes
  295.          for desktop publishing/printing as .GIF, .PCX and other formats.
  296.  
  297.     If  you  support  maverick authors like us, we will continue to develop
  298.     innovative  products  like  nothing  seen commercially - otherwise they
  299.     will,  as  many  (sigh!)  good Shareware programs, become commercial or
  300.     simply die from lack of support. 
  301.  
  302.  
  303.  
  304.  
  305.     ───────────────────────────────────────────────────────
  306.     Graphics Interchange Format and GIF are trademarks (tm)
  307.     of CompuServe Inc. an H&R Block Company. 
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.     MAC2GIF Copyright (c) 1988 Lawrence & Marvin Gozum
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.