user documentation            XGAProc                     Veit Kannegieser


XGAProc is an file format procedure for MMOS2, for reading and
Phoenix BIOS suspend graphic files. Install it using MINSTALL.


file format
-----------
  The PHDISK.EXE/Phdskwin.exe programs to prepare a hiberate partition
  or file will embedd a file called save2dsk.xga into the created 
  partition or file. The BIOS will show it during suspend/wakeup.
  The BIOS chooses a VESA mode that matches the picture, so a please
  select a picture size that can displayed by the display in any 
  equipment situation. For likely this reason, the pictures found in use by
  Phoenix, IBM and Mitsubishi are all 800*600.
  The BIOS will display a progress bar on the picture, this file format
  procedure will automaticly set the bar to the bottom of the screen.
  Use the separate XGA_PPM to specify exact location.
  To install the produced *.XGA file, copy it to save2dsk.xga in the PHDISK
  directory, and use PHDISK to (re-)format the hibernate partition or file.

  
WPS
---

  The WPS will not offer converting to XGA,
  use the FM/2 image.exe, or similar.
  You can associate *.XGA with \mmos2\MPPM.EXE.
  Also CWMM should help.
    
  
Uninstall
---------
  
  There seems no common user accessible deinstallation procedure,
  but MMOS2 has one internaly. You can access it using the 
  mmbrowse.exe program from the toolkit.
  
  
Development notice
------------------

  Largest reason for the development of the XGA and LGO procedures 
  was not because of high demand for it, but to try out if it is possible,
  how hard it is. The code was adapted from IBM MMIOPROC sample code,
  and translated to Pascal. I found out that it was not possible to
  use thread local variables (hardly debuggable crash). Also MMOS2 seem
  to be unavailable for any later processes after an crash in an MMOS
  procedure. To avoid memory leaks, the code now has a bit too much of
  'gotos' for my taste... Ratio of source to binary is also very unusual: 
  source code size without runtime library is 82 KiB, (lxlited) binary 
  is 4 KiB. This seems to be a lot of source code, but it can reused
  for other file formats. Simplified expressed, the file format procedure
  makes a give file format look something like a BMP file, but translates
  file format to BMP and BMP to file format.
  
  
translation
-----------

  the file format procedure currently does not use string resources for
  its translateable strings, they are english only.
