user documentation            LGOProc                     Veit Kannegieser


LGOProc is an file format procedure for MMOS2, for reading and
writing OS/2 boot logo files. Install it using MINSTALL.


file format
-----------
  when converting other bitmap formats to LGO, keep in
  mind that the size has to be 640x480 (or 640x400 - Warp 3),
  else the request will be rejected.

  
this implementation
-------------------

  used compression is not the most efficient, for
  example PMView compresses better.
  Depending on the machine, the compression process may take some
  time. Do not exit from the application before the process is complete,
  else MMOS2 may be unavailable thereafter.
    
  
WPS
---

  The WPS will not offer converting to LGO,
  use the FM/2 image.exe, or similar.
  You can associate *.LGO and OS2LOGO 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 126 KiB, (lxlited) binary 
  is 7.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.
  