home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Share Gallery 1
/
share_gal_1.zip
/
share_gal_1
/
UT
/
UT187.ZIP
/
DFE104.ZIP
/
DFE.DOC
< prev
next >
Wrap
Text File
|
1991-08-28
|
47KB
|
1,129 lines
DDDD FFFFF EEEEE
D D F E
D D FFF EE
D D F E
DDDD F EEEEE
Display Font Editor
Version 1.04
10 August 1991
Copyright (C) 1991 by Rimrock Software
All Rights Reserved
┌─────────┐
┌─────┴───┐ │ (R)
──│ │o │──────────────────
│ ┌─────┴╨──┐ │ Association of
│ │ │─┘ Shareware
└───│ o │ Professionals
──────│ ║ │────────────────────
└────╨────┘ MEMBER
Rimrock Software
P.O. Box 2406
Hayden, ID 83835
(208) 772-9347 (after 6 pm Pacific Time)
DFE Shareware Information
DFE is a shareware product. No matter how you obtained this product,
we encourage you to freely copy and distribute DFE, provided that
1. No fee is charged beyond normal media duplication and shipping
costs.
2. The DFE archive distribution file must be distributed in its
original form. Specifically, the files listed in the
PACKING.LST must be included. None of these files should be
altered, and no new files should be added. Advertising within
the DFE archive file is prohibited.
3. Commercial use of DFE is prohibited unless the program is
registered for the specific number of computers on which it
will be used.
See the ORDER.FRM file for more licensing information.
If you received DFE as shareware, i.e., you didn't pay a registration
fee for it or you got it from a shareware library, and you use it on a
regular basis, you must register the program using the accompanying
order form. Registering shareware encourages program authors to
continue making improvements to programs and to create newer and
better software.
For your $49 registration fee, you will receive the latest registered
version of DFE, all accompanying files, and a printed user's manual.
You will also receive an extensive set of raw font files for use with
DFE and the DFE Utilities.
Rimrock Software is a member of the Association of Shareware
Professionals (ASP). ASP wants to make sure that the shareware
principle works for you. If you are unable to resolve a shareware-
related problem with an ASP member by contacting the member directly,
ASP may be able to help. The ASP Ombudsman can help you resolve a
dispute or problem with an ASP member, but does not provide technical
support for members' products. Please write to the ASP Ombudsman at
545 Grover Road, Muskegon, MI 49442-9427 or send a CompuServe message
via easyplex to ASP Ombudsman 70007,3536
-i-
TABLE OF CONTENTS
Introduction to DFE . . . . . . . . . . . . . . . . . . 1
Overview. . . . . . . . . . . . . . . . . . . . . . 1
System Requirements . . . . . . . . . . . . . . . . 2
Technical Support . . . . . . . . . . . . . . . . . 2
Registration Information. . . . . . . . . . . . . . 2
Using DFE . . . . . . . . . . . . . . . . . . . . . . . 3
DFE Editing Display . . . . . . . . . . . . . . . . 3
The Menu Bar. . . . . . . . . . . . . . . . . . . 4
File Menu . . . . . . . . . . . . . . . . . . . 4
Edit Menu . . . . . . . . . . . . . . . . . . . 6
Motion Menu . . . . . . . . . . . . . . . . . . 7
Util Menu . . . . . . . . . . . . . . . . . . . 8
Info Menu . . . . . . . . . . . . . . . . . . . 9
The Font Display Area . . . . . . . . . . . . . . 9
The File Information Area . . . . . . . . . . . . 9
The Character Information Area. . . . . . . . . .10
The Character Edit Area . . . . . . . . . . . . .10
Editing Controls. . . . . . . . . . . . . . . . .11
DFE Utilities . . . . . . . . . . . . . . . . . . . . .13
DFLoad - Raw Font Loader. . . . . . . . . . . . . .14
DFKeep - Load a Raw Font and Keep it. . . . . . . .14
DFMap - Map a Raw Font . . . . . . . . . . . . . .14
Raw2Asc- Convert a Raw File to ASCII. . . . . . . .15
CPLoad - Code Page File Font Loader . . . . . . . .16
CPMap - Map a Code Page Font . . . . . . . . . . .16
CPInfo - Code Page File Information . . . . . . . .17
CPI2Asc- Convert a Code Page Font to ASCII. . . . .17
Error Messages. . . . . . . . . . . . . . . . . . . . .18
-ii-
Introduction to DFE
-------------------
Overview
--------
DFE and its utilities allow you to create and use new fonts on
your EGA or VGA display. This is exactly how the Norton Utilities
and PC-Tools create their pseudo-graphical interfaces.
DFE is a graphics-based editor for DOS code page display files
(.CPI files) or raw EGA/VGA font files. Code page files are used
by DOS to display characters other than those that would normally
be displayed when specific ASCII codes are sent to the display.
For instance, if you have set up your system with a russian
keyboard driver and wish to display russian cyrillic characters,
you would use a font from code page 866. DFE allows you to make
changes to existing code pages, or create your own code pages.
DFE is also capable of editing 'raw' font files. These are fonts
that can be loaded directly into an EGA or VGA using the included
DFLoad or DFKeep programs.
DFE allows you to change a particular font character on a pixel-
by-pixel basis. It also allows you to create character sets that
are as small as 7 pixels tall or as large as 32 pixels tall (7
pixels is a practical limit, not an actual limit).
The DFE Utilities are included as part of DFE. They provide useful
capabilities such as loading a raw font or code page font to the
display, mapping a font and converting a font to ASCII. The DFE
Utilities are DFLoad, DFKeep, DFMap, Raw2Asc, CPLoad, CPMap,
CPInfo and CPI2Asc.
Programmers who wish to include their own display font within
their applications can use DFE to create the font, then use
Raw2Asc to convert the font to a form that can be directly
incorporated into their C source code. The font used in DFE's
registration reminder screen was generated using Raw2Asc.
DFE was written in C and compiled with the Borland International
C++ compiler. It uses the TEGL graphics library for all its
graphic functions. TEGL is copyright (c) 1990-1991 by TEGL
Systems Corporation, all rights reserved.
The DFE Utilities were written in assembly language and assembled
with the Borland International TASM assembler. They use routines
from the Spontaneous Assembly (tm) library. Spontaneous Assembly
is copyright (c) 1989-1990 by Acclaim Technologies, Inc., all
rights reserved, and is a trademark of Acclaim Technologies, Inc.
-1-
System Requirements
-------------------
DOS Version: 2.10 or higher
Memory: 640k
Disk drives: 1 floppy or hard disk for file storage/retrieval.
Display: EGA, VGA or Hercules display required for DFE; EGA
or VGA required for use with DFLoad, DFKeep and
CPLoad. All other DFE Utilities have no particular
display requirements.
Other: A Microsoft compatible mouse and driver is optional
but desirable.
Technical Support
-----------------
If you have any questions regarding DFE or its utilities, you may
call Rimrock Software for technical assistance. Technical support
is available throughout the week, from 6:00 pm to 10:00 pm,
Pacific time. The phone number is (208) 772-9347. Technical
support is NOT limited to registered users, although we encourage
you to register the DFE package.
You may reach Rimrock Software on CompuServe. We regularly
monitor the SHAREWARE forum, section 1, for questions about our
software. Please direct your questions to Michael Burton,
71211,70.
You may obtain the latest shareware version of DFE, and ask
questions about it, on the Tech Board BBS, (208) 765-0180. The
Tech Board sysop is Dan Boss and he has kindly provided an area
for support of Rimrock Software products. Many thanks, Dan.
Registration Information
------------------------
The unregistered versions of DFE and its utilities are fully
functional, uncrippled programs. If you find these programs to be
useful, you can become a registered user. Registration entitles
you to the latest versions of the programs and a bound, printed
manual. The only difference between the registered and the
unregistered versions of the programs is that the registered
versions do not have any registration reminders. An order form is
included with DFE, and may be printed by entering the following at
the DOS prompt:
COPY ORDER.FRM PRN
Be sure to fill out all the information on the order form,
including the DFE unregistered version you are using.
-2-
Using DFE
---------
DFE is easy to use. The only file necessary is DFE.EXE. To run the
program, simply enter
DFE
No command line options are available. When DFE executes, you will
see a registration request screen. You may continue on to the DFE
editing display by pressing any key.
DFE Editing Display
-------------------
Other than the registration request screen, the only other display
in DFE is the editing display. There are six major areas in the
editing display (see figure 1); the menu bar, the font display
area, the file information area, the character information area,
the character edit area and the editing controls area.
+--------------------------------------------------------------------+
| File Edit Motion Util Info Unregistered Version |
+--------------------------------------------------------------------+
| |
| +-----------+ +-----------+ +---------------------------+ |
| | | |Char No: 0 | |File: Code Page:0 | |
| | | |Default: | |Device Name: Font:0 | |
| | | | | +---------------------------+ |
| | | |PX: | +------------------------------------+ |
| | | |PY: | | | |
| | | |Height: 14 | | | |
| | | +-----------+ | | |
| | |+--+ | | |
| | || | | | |
| | |+--+ +-------+ | | |
| | |+--+ |Display| | | |
| |[character || | |Font | | | |
| | edit area]|+--+ |Editor | | [font display area] | |
| | |+--+ +-------+ | | |
| | || | | | |
| | |+--+ | | |
| | |+--+ | | |
| | || | | | |
| | |+--+ | | |
| | |+--+ | | |
| | || | | | |
| | |+--+ | | |
| | |+--+ | | |
| | || | | | |
| | |+--+ | | |
| +-----------+ +------------------------------------+ |
| |
+--------------------------------------------------------------------+
Figure 1 DFE Editing Display
-3-
You may use either the cursor keys or your mouse to move the DFE
cursor around. The keyboard cursor keys give you fast movement
and the numeric keys give you fine control. When you wish to
select something, you can do so with the Enter key. If you use a
mouse, you may select something by clicking the left mouse button.
The right mouse button can be used to move some of the objects on
the screen, but you wouldn't normally want to do this.
The Menu Bar
------------
The Menu Bar contains functions that read and write files,
control editing, control motion within a font, control utility
functions and display information about DFE. Each Menu Bar
header is connected to a pull down menu of items that may be
selected for execution.
File Menu
---------
The file menu is used to load and save fonts, and to leave
DFE when you are finished. It contains five items,
detailed below (see figure 2).
File
+----------------+
| Load Code Page |
| Save Code Page |
+----------------+
| Load Raw Font |
| Save Raw Font |
+----------------+
| Quit to DOS |
+----------------+
Figure 2 File Menu
In general, when you select a file load or save item, a
pop up file selection window appears (see figure 3). This
window contains the name of the current directory, a list
of file names and subdirectories in the current directory,
an empty file name box, an up arrow, a horizontal bar, a
down arrow, a Cancel button and an Ok button.
To select a file for loading or saving, click on its name
and the file will be displayed in the file name box. Then
click on the Ok button and the file will be loaded or
saved. Alternatively, you may click on the file name box
and an editing cursor will appear. You may then type in a
file name. When you are finished, press the Enter key,
Then click on the Ok button.
-4-
If you want to move around in the file list, click on the
down arrow or up arrow. If you want to move to a sub-
directory, click on the directory in the file list. If you
want to move towards the root directory, click on the
horizontal bar between the arrows.
If you want to change disk drives, keep clicking on the
horizontal bar until you see a list of disk drives, then
click on the drive you want.
+---------------------------------+
|H:\DFE\*.* |
+---------------------------------+
| |
| * TEMP +------------+ |
| DFE .EXE | | |
| DFE .MAN +------------+ |
| BACKWARD.RAW ^ |
| BOLD .RAW / \ +------+ |
| ICONS .RAW | | |CANCEL| |
| +-+ +------+ |
| === |
| +-+ +------+ |
| | | | OK | |
| \ / +------+ |
| v |
+---------------------------------+
Figure 3 File Selection Window
Load Code Page
Load Code Page allows you to load a particular font from a
code page file and edit the font. You must select the
proper code page file, then you must select the proper
code page and font. The standard U.S. code page is 437,
and there are usually 3 fonts in it - an 8x16, an 8x14 and
an 8x8 font.
Save Code Page
Save Code Page allows you to save the font you are
currently working on into a code page file. This can be
any font, including a raw font. When selected, this item
first asks for a code page file name. It then asks for a
device name. In most code page display files, the device
name is either EGA or LCD. It then asks for a code page
id. This is where you enter the code page number, such as
437. Finally, if the code page id exists, it will tell
you how many fonts are currently in that code page
and will ask you where it should be saved. If you pick
-5-
one of the fonts already present, it will be replaced with
the font you are currently editing. If you pick the next
higher number, the font you are editing will be added to
the code page file.
Load Raw Font
Load Raw Font allows you to load a raw font for editing.
Simply pick the file of your choice and it will be loaded.
If the file you pick is not a raw font file, an error
message will indicate this fact.
Save Raw Font
Save Raw Font allows you to save your current work in a
raw font file. You may pick an already existing file to
save in, or you may enter your own file name. Although
you may use any extension you wish, we have picked an
extension of .RAW for our files. For consistency, we
suggest you do the same. Be careful - DFE will write over
an existing file without asking permission.
Quit to DOS
Quit to DOS allows you to leave DFE and return to DOS. BE
CAREFUL - DFE will return immediately to DOS regardless of
whether you have saved your work or not.
Edit Menu
---------
Edit menu items allow you to make changes to the currently
selected character or the entire selected font set. The
edit menu has five items (see figure 4).
Edit
+--------------+
| Clear Char |
| Clear All |
+--------------+
| Copy Char |
| Default Char |
| Default Set |
+--------------+
Figure 4 Edit Menu
Clear Char
Clear Char erases all the pixels in the currently selected
character.
-6-
Clear All
Clear All erases the entire font set. You will be asked
if you are sure before the set is erased.
Copy Char
When Copy Char is selected, you will be asked to select
another character from the font set. That character will
then be copied into the current character.
Default Char
Default Char copies the character in your display adapter
ROM that coincides with the current character into the
current character.
Default Set
Default Set copies the entire character set from your
display adapter ROM into the current font set. You will
be asked if you really want to do this before it is done.
This is a good way to create a basic character set that
you can then modify.
Motion Menu
-----------
The Motion Menu controls the current character. You may
move forward or backward in the font set, or you may
select a font character at random (see figure 5).
Motion
+--------------------+
| Next Character |
| Previous Character |
+--------------------+
| Select A Character |
+--------------------+
Figure 5 Motion Menu
Next Character
Next Character makes the next character in the font set
the current character. The character information area is
updated and the character is drawn in the character
editing area.
-7-
Previous Character
Previous Character makes the previous character in the
font set the current character. The character information
area is updated and the character is drawn in the
character editing area.
Select A Character
When Select A Character is activated, you are asked to
select a character from the font set. When you click on a
particular character, that character becomes the current
character. The character information area is updated and
the character is drawn in the character editing area.
Util Menu
---------
The Util Menu contains miscellaneous DFE functions. The
menu has three items (see figure 6).
Util
+-------------------+
| Character Height |
| Set Separation |
| Mouse Sensitivity |
+-------------------+
Figure 6 Util Menu
Character Height
Character Height allows you to change the number of pixel
rows in a character. Be careful, because if you change
from more rows to less rows and back to more rows, you may
lose the lower pixels of each character in the font set.
Set Separation
Set Separation is used to control how the font set is
displayed in the font display area. The initial display
is no separation - characters are displayed with no pixels
in between. Selecting this item alternates between
separation and no separation.
Mouse Sensitivity
Mouse Sensitivity allows you to control the speed and
sensitivity of the mouse in DFE. It allows you to change
horizontal and vertical sensitivity and the double speed
threshold of the mouse.
-8-
Info Menu
---------
The Info Menu contains information about DFE and how to
register the DFE package (see figure 7).
Info
+------------+
| About |
| Order Form |
+------------+
Figure 7 Info Menu
About DFE
About contains information about the date and version of
DFE and directs you to Order Form for more information.
Order Form
Order Form displays information about how to create an
order form, so you can register the DFE package.
The Font Display Area
---------------------
The Font Display Area shows you an accurate picture of every
character in the font set you are currently working on. Each font
character is initially displayed adjacent to the next, so you can
get an idea of how the font will look when you actually use it.
If you need to spread the characters out to get a better look at
them, you can click on the Set Separation item in the Util menu.
The File Information Area
-------------------------
The File Information Area contains information concerning where
the current font set came from. If the font set came from a raw
font file, the raw font file name will be displayed and all other
fields will be blank or zero. If the font set came from a code
page file, the file name will be displayed, along with the code
page id, device name and font number (see figure 8).
+----------------------------------+
| File: DFE.CPI Code Page: 437 |
| Device Name: EGA Font No: 2 |
+----------------------------------+
Figure 8 File Information Area
-9-
The Character Information Area
------------------------------
The Character Information Area contains information about the
currently selected character. The information includes the
character number (0-255), what the default character looks like,
what this character looks like, the current X/Y coordinates of the
mouse cursor within the Character Edit Area, and the current
height of the entire font set (see figure 9).
+-------------+
| Char No: 65 |
| Default: A |
| Current: A |
| |
| PX: 7 |
| PY: 3 |
| Height: 14 |
+-------------+
Figure 9 Character Information Area
The Character Edit Area
-----------------------
The Character Edit Area is where all the real action takes place
in DFE (see figure 10). The current character is displayed here in
a magnified view. You may set or clear any pixels of the
character. To set a pixel, move to it and click. To clear a
pixel, do the same thing. To set or clear several pixels, move to
the first pixel and press the left mouse button and hold it down,
then drag the mouse cursor to the next pixel, etc. The editing
controls also allow you to make changes to the character displayed
here.
-10-
+-+-+-+-+-+-+-+-+
| | | | | | | | |
+-+-+-+-+-+-+-+-+
| | | | | | | | |
+-+-+-+-+-+-+-+-+
| | |*|*|*| | | |
+-+-+-+-+-+-+-+-+
| |*|*| |*|*| | |
+-+-+-+-+-+-+-+-+
|*|*| | | |*|*| |
+-+-+-+-+-+-+-+-+
|*|*| | | |*|*| |
+-+-+-+-+-+-+-+-+
|*|*| | | |*|*| |
+-+-+-+-+-+-+-+-+
|*|*|*|*|*|*|*| |
+-+-+-+-+-+-+-+-+
|*|*| | | |*|*| |
+-+-+-+-+-+-+-+-+
|*|*| | | |*|*| |
+-+-+-+-+-+-+-+-+
|*|*| | | |*|*| |
+-+-+-+-+-+-+-+-+
| | | | | | | | |
+-+-+-+-+-+-+-+-+
| | | | | | | | |
+-+-+-+-+-+-+-+-+
| | | | | | | | |
+-+-+-+-+-+-+-+-+
| |
| |
| |
| |
| |
| |
| |
+---------------+
Figure 10 Character Edit Area
Editing Controls
----------------
The Editing Controls allow gross changes to be made to the
character. The controls are located adjacent to the Character
Edit Area. There are nine controls; up arrow, down arrow, left
arrow, right arrow, horizontal double arrow, vertical double
arrow, inverted A, NXT and PRV (see figure 11).
-11-
+---+
| ^ |
+---+
+---+
| v |
+---+
+---+
|<--|
+---+
+---+
|-->|
+---+
|<->|
+---+
+---+
|^v |
+---+
+---+
| A |
+---+
+---+
|NXT|
+---+
+---+
|PRV|
+---+
Figure 11 Editing Controls
When you click on the up arrow control, the entire character is
moved up by one pixel row. The top row of pixels is lost.
When you click on the down arrow control, the entire character is
moved down by one pixel row. The bottom row of pixels is lost.
When you click on the left arrow control, the entire character is
moved to the left by one pixel column. The left column of pixels
is lost.
When you click on the right arrow control, the entire character is
moved to the right by one pixel column. The right column of
pixels is lost.
Clicking on the horizontal double arrow flips the character over
horizontally, i.e., a left to right mirror image of the character
is produced.
Clicking on the vertical double arrow flips the character over
vertically, i.e., a top to bottom mirror image of the character is
produced.
-12-
Clicking on the inverted A inverts the character. All the pixels
that were set are cleared and all the pixels that were clear are
set.
Clicking on NXT is the same as selecting Next Character from the
motion menu - the next character in the font set is made the
current character. All the current character information is
updated and the new character will be displayed in the Character
Editing Area.
Clicking on PRV is the same as selecting Previous Character from
the motion menu - the previous character in the font set is made
the current character. All the current character information is
updated and the new character is displayed in the Character
Editing Area.
DFE Utilities
-------------
The DFE Utilities are a set of programs that helps you use and
maintain raw font and code page files. If you forget how to use a
particular program, each one has built-in help. Simply execute the
program with no command line arguments and a syntax message will be
displayed.
All of the DFE Utilities support DOS I/O redirection. All of the
screen display for a particular utility may be directed to another I/O
device. For instance, to print a DFMap of a raw font on your printer,
you enter
DFMAP ICONS.RAW >PRN
or
DFMAP ICONS.RAW >LPT1
To direct the output of DFMap to a file called ICONS.TXT instead of
printing it, you enter
DFMAP ICONS.RAW >ICONS.TXT
To append more to the file just created, you would enter
DFMAP BLOCK.RAW >>ICONS.TXT
Only the display I/O may be redirected. Normal file I/O cannot be
redirected.
-13-
DFLoad - Raw Font Loader
------------------------
DFLoad is the workhorse of the DFE utilities. It is used to load
a raw font into an EGA or VGA display adapter and make that font
the current display font. To use DFLoad, you enter
DFLOAD d:\path\filename.ext
where d is the drive, path is the directory path, filename is the
name of the raw font file and ext is the file extension. Don't
forget to include the file extension, if there is one. DFLoad
makes no assumptions about file extensions.
DFKeep - Load a Raw Font and Keep it
------------------------------------
DFKeep is a terminate and stay resident (TSR) version of DFLoad.
It loads a new font into your display adapter, but if you switch
display modes and then come back to text mode, DFKeep will reload
the font. This means you can go into Windows and when you leave
it, your fancy DFE raw font will be used. DFKeep is used the same
way as DFLoad
DFKEEP d:\path\filename.ext
where d is the drive, path is the directory path, filename is the
name of the raw font file and ext is the file extension. Don't
forget to include the file extension, if there is one. DFKeep
makes no assumptions about file extensions.
DFKeep will only be loaded into memory one time. Subsequent
execution of DFKeep will change the raw font being used. For
instance
DFKEEP BOLD.RAW will load DFKeep - BOLD.RAW is the font
DFKEEP ICONS.RAW will change the font to ICONS.RAW
DFKeep cannot be unloaded from memory once it is installed.
DFMap - Map a Raw Font
-----------------------
DFMap allows you to create a visual map of an entire raw font set.
An example portion of DFMap's output is shown in figure 12.
-14-
#48 30h
-------- -------- -------- -------- -------- -------- --------
-------- -------- -------- -------- -------- -------- --------
-@@@@@-- ---@@--- -@@@@@-- -@@@@@-- ----@@-- @@@@@@@- -@@@@@--
@@---@@- -@@@@--- @@---@@- @@---@@- ---@@@-- @@------ @@---@@-
@@--@@@- ---@@--- @@---@@- -----@@- --@@@@-- @@------ @@------
@@-@@@@- ---@@--- ----@@-- -----@@- -@@-@@-- @@------ @@------
@@@@-@@- ---@@--- ---@@--- --@@@@-- @@--@@-- @@@@@@-- @@@@@@--
@@@--@@- ---@@--- --@@---- -----@@- @@@@@@@- -----@@- @@---@@-
@@---@@- ---@@--- -@@----- -----@@- ----@@-- -----@@- @@---@@-
@@---@@- ---@@--- @@---@@- @@---@@- ----@@-- @@---@@- @@---@@-
-@@@@@-- -@@@@@@- @@@@@@@- -@@@@@-- ----@@-- -@@@@@-- -@@@@@--
-------- -------- -------- -------- -------- -------- --------
-------- -------- -------- -------- -------- -------- --------
-------- -------- -------- -------- -------- -------- --------
Figure 12 Sample DFMap Output
To use DFMap, you enter
DFMAP d:\path\filename.ext
where d is the drive, path is the directory path, filename is the
name of the raw font file and ext is the file extension. Don't
forget to include the file extension, if there is one. DFMap
makes no assumptions about file extensions.
Raw2Asc- Convert a Raw File to ASCII
------------------------------------
Raw2Asc is used to convert a raw font file into an ASCII form that
can be directly inserted into a C source file (see figure 13 for a
sample portion of a Raw2Asc .ASC file).
0x00,0x00,0x7E,0x81,0xA5,0x81,0x81,0xBD,0x99,0x81,0x7E,0x00,0x00,
0x00,0x00,0x7E,0xFF,0xDB,0xFF,0xFF,0xC3,0xE7,0xFF,0x7E,0x00,0x00,
0x00,0x00,0x00,0x6C,0xEE,0xFE,0xFE,0xFE,0x7C,0x38,0x10,0x00,0x00,
0x00,0x00,0x00,0x10,0x38,0x7C,0xFE,0x7C,0x38,0x10,0x00,0x00,0x00,
0x00,0x00,0x00,0x10,0x38,0x10,0x6C,0xEE,0x6C,0x10,0x38,0x00,0x00,
0x00,0x00,0x10,0x38,0x7C,0x7C,0xFE,0xFE,0x6C,0x10,0x38,0x00,0x00,
Figure 13 Sample Raw2Asc .ASC File Output
To use Raw2Asc, you enter
RAW2ASC d:\path\filename.ext
where d is the drive, path is the directory path, filename is the
name of the raw font file and ext is the file extension. Don't
forget to include the file extension, if there is one. Raw2Asc
makes no assumptions about file extensions.
-15-
Raw2Asc will create its ASCII file on the same drive and in the
same directory with the same file name, but with an extension of
.ASC.
CPLoad - Code Page File Font Loader
-----------------------------------
CPLoad is used to load a font from a code page file into an EGA or
VGA display adapter and make that font the current display font.
This gives you a reality check on the font without having to go
through the awkward DOS font loading process. To use CPLoad, you
enter
CPLOAD d:\path\filename.ext code_page font_number
where d is the drive, path is the directory path, filename is the
name of the code page file and ext is the .CPI extension. Don't
forget to include the .CPI file extension. CPLoad makes no
assumptions about file extensions.
code_page is the code page number that contains the font you wish
to load. font_number is the font number you wish to load. For
instance, if you wanted to load the 8x8 font (font #3) of code
page 437, you enter
CPLOAD DFE.CPI 437 3
CPMap - Map a Code Page Font
-----------------------------
CPMap allows you to create a visual map of a code page font.
CPMap's output is the same as DFMap's. See figure 12 for an
example.
To use CPMap, you enter
CPMAP d:\path\filename.ext code_page font_number
where d is the drive, path is the directory path, filename is the
name of the code page file and ext is the .CPI extension. Don't
forget to include the .CPI file extension. CPMap makes no
assumptions about file extensions.
code_page is the code page number that contains the font you wish
to map. font_number is the font number you wish to map. For
instance, if you wanted to map the 8x16 font (font #1) of code
page 850, you enter
CPMAP DFE.CPI 850 1
-16-
CPInfo - Code Page File Information
-----------------------------------
CPInfo provides you with specific information about the code pages
and fonts contained within a particular code page file (see figure
15).
Code Page File: dfe.cpi
Number of Code Pages: 7
Code Page: 437
Device Name: EGA
Number of fonts: 3
Font: 16 rows by 8 columns
Font: 14 rows by 8 columns
Font: 8 rows by 8 columns
Code Page: 850
Device Name: EGA
Number of fonts: 3
Font: 16 rows by 8 columns
Font: 14 rows by 8 columns
Font: 8 rows by 8 columns
Figure 15 Partial CPInfo Output
To use CPInfo, you enter
CPINFO d:\path\filename.ext
where d is the drive, path is the directory path, filename is the
name of the code page file and ext is the .CPI extension. Don't
forget to include the .CPI extension. CPInfo makes no assumptions
about file extensions.
For instance, to obtain information about DFE.CPI, enter
CPINFO DFE.CPI
CPI2Asc - Convert a Code Page Font to ASCII
-------------------------------------------
CPI2Asc is used to convert a code page font file into an ASCII
form that can be directly inserted into a C source file. The
ASCII file generated by CPI2Asc is identical to one generated by
Raw2Asc. See figure 13 for an example of file output.
To use CPI2Asc, you enter
CPI2ASC d:\path\filename.ext code_page font_number
-17-
where d is the drive, path is the directory path, filename is the
name of the code page file and ext is the .CPI extension. Don't
forget to include the .CPI extension. CPI2Asc makes no
assumptions about file extensions.
code_page is the code page number that contains the font you wish
to convert. font_number is the font number you wish to convert. For
instance, if you wanted to convert the 8x14 font (font #2) of code
page 852 to ASCII, you enter
CPI2ASC DFE.CPI 852 2
CPI2Asc will create its ASCII file on the same drive and in the
same directory with the same file name, but with an extension of
.ASC.
Error Messages
--------------
Error messages generated by DFE and its utilities are listed below
with an explanation of each message. The program(s) that generate the
message is shown in brackets below the error message.
Bad code page number
[CPLoad CPMap CPI2Asc]
The code page number you typed on the command line is not a code
page contained in this code page file. Use CPInfo to find out
what code pages are in the file.
Bad font number
[CPLoad CPMap CPI2Asc]
The font number you typed on the command line is not contained in
this code page. Use CPInfo to find out what fonts are contained
in this code page.
Bad raw font file. File not read.
[DFE]
The selected file is not a raw font file. File sizes for raw
fonts are all multiples of 256.
Can't open the .ASC file
[Raw2Asc CPI2Asc]
The program could not create the requested ASCII file. This
usually indicates a full disk or a write-protected disk.
-18-
Can't read the file
[CPLoad CPMap CPI2Asc]
The program found the file and opened it to be read, but for some
unknown reason it could not read anything from the file. This
could indicate some kind of hardware problem.
Can't read the font file
[CPInfo DFLoad DFMap Raw2Asc]
The program found the file and opened it to be read, but for some
unknown reason it could not read anything from the file. This
could indicate some kind of hardware problem.
Code page file not found.
[CPInfo CPLoad CPMap]
The code page file you specified on the command line was not found
where you said it was. Make sure you have the correct drive,
path, filename and extension.
Display adapter is not an EGA, VGA or MCGA
[CPLoad DFLoad]
The DFE loaders can only change display fonts for EGAs, VGAs (any
flavor), and MCGAs.
Font file not found
[DFLoad DFKeep DFMap Raw2Asc]
The raw font file you specified on the command line was not found
where you said it was. Make sure you have the correct drive,
path, filename and extension.
Not a code page file
[CPInfo CPLoad CPMap CPI2Asc]
The file entered on the command line is not a code page file.
Make sure you have entered the proper drive, path, file name AND
extension.
Not a display code page file
[CPInfo CPLoad CPMap CPI2Asc]
The file entered on the command line is a printer code page file,
not a display code page file.
Not a font file
[DFLoad DFMap Raw2Asc]
The selected file is not a raw font file. File sizes for raw
fonts are all multiples of 256.
-19-
Not a font file. File not read.
[DFE]
The selected .CPI is not a display file. It is probably a printer
code page file.
Not enough memory to run program
[CPInfo CPLoad CPMap DFLoad DFMap Raw2Asc CPI2Asc]
There isn't enough memory left to run the program. If you got
this message, something is really wrong with your system, since
each of these programs requires less than 20k to run in.
Out of memory. File not read.
[DFE]
There isn't enough memory left for DFE to read the code page file.
Free up some memory by removing TSRs or device drivers, then run
DFE again.
Can't read the file
[CPLoad CPMap CPI2Asc]
The program found the file and opened it to be read, but for some
unknown reason it could not read anything from the file. This
could indicate a bad .CPI file or some kind of hardware problem.
-20-