Compu-Fix

home *** CD-ROM | disk | FTP | other *** search

/ Compu-Fix / Compu-Fix.iso / misc / display / dfe.doc < prev next >

Wrap

Text File | 1993-03-01 | 45.8 KB | 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-