===========================================================================
27AUG03 - EDITCPI.EXE - Replace Fonts in DOS/Windows' CPI File
===========================================================================

A Windows' CONSOLE program that allows you to replace the embedded fonts in 
a MS-DOS - or Windows - CPI (Codepage Information) file with font images
supplied in the form of binary files.

CPI files contain the country specific screen fonts that MS-DOS and Windows
use in full screen modes (both MS-DOS mode and full screen DOS "box" and
NT/2000/XP Console modes).

They are usually found in the Windows COMMAND (Windows 9x/Me) or SYSTEM32
(Windows NT/2000/XP) directory and have a CPI extension. If only one file
is present it will usually be named EGA.CPI.

EDITCPI will work on most standard MS-DOS and Windows CPI files - including 
Procon's HVEGA*.CPI files. (It may NOT work on proprietary OEM CPI files 
such as those distributed with DR-DOS, Caldera OpenDOS, Novell DOS, etc.). 

CPI files typically provide three different sized screen fonts for each 
supported codepage, These are:-
  8x 8 pixels - used in 43 and 50 line screen modes
  8x14 pixels - used in 28 and 30 line modes
  8x16 pixels - used in 25 line mode.

As EDITCPI changes the target CPI files(s) it will NOT work on a Windows
CPI file that is in use. You must work with a copy of the file and replace
the active file later. (See below for information on replacing active CPI
files.)

---------------------------------------------------------------------------
SYNTAX

   EDITCPI  CPIFile(s) [/Pnnn]  FntFile1 FntFile2 FntFile3 /B[lank]
      CPIFiles = the target CPI File(s) - can contain wildcards
      /P (Optional Switch) = Target Codepage (default = 437)
      FntFiles = One or more binary VGA FNT image files
      /B (Optional Switch) = use a Blank Space (ASCII 32) character

   Examples:

      EDITCPI  EGA.CPI  8X16.FNT 8X14.FNT 8X8.FNT
      EDITCPI  *.CPI  /P850  8X16.FNT 8X8.FNT  /B

---------------------------------------------------------------------------
PARAMETERS

The program accepts up to SIX command line parameters:-

The FIRST parameter
  is the target file specification. This can contain a full path and may
  contain wildcards. For example:-  C:\TEMP\EGA*.CPI

The Codepage parameter (/Pnnn) is optional.
  It can be used to specify a target Codepage
  (The default is 437 - the OEM US ASCII Codepage). 

From ONE to THREE Fontfile parameters are required.
  The filename can include a path but not wildcards.

The LAST parameter (/B) allows you to specify that the new SPACE character
  (ASCII 32) should be BLANK regardless of the content of the font file(s).


---------------------------------------------------------------------------
USING THE MODIFIED CPI FILE

See:-
   http://www.procon.com.au/HVCPIFnt.htm
for information on installing and using CPI files.


---------------------------------------------------------------------------
DEPENDENCIES

This program uses several Windows' DLL files. If these are not present you
will get an error message indicating which DLL is missing.

If this occurs, download the required DLLs from the links given in:-
   http://www.procon.com.au/UtilDLLs.htm


---------------------------------------------------------------------------
DISCLAIMER

Use this utility at your own risk! If you do not understand
  CONSOLE Mode,
  Command Line parameters,
  Windows' Codepage file usage,
  ASCII values,
  etc.,
you can only cause yourself grief.

===========================================================================

