bmfed.txt

将bmf在DOS下显示出来

BMFED - BitMapFontEDitor
------------------------
<Place standard disclaimer here>

Syntax:
BMFED.EXE filename [-create|-fn] [-savequit]

BMFED is run from the command prompt, specifying the filename
that it either loads or creates and this file stays
to be edited until user quits the editor.
'-create' option is used if first parameter is non-existing
  file name that user wants the editor to create
'-fn' indicates conversion from the .FN format
  i.e. specified file is supposed to be monochromatic FN
'-savequit' saves the font in the latest version and quits

Load/Save:
F2 saves current font
F3 reloads the last saved version from disk.

Description of the screen:
+===========================+
|font/char attribute names  |
|font/char attribute values |
|P+------------+   statusbar|
|A|            |   +-------+|
|L|  character |   |       ||
|E|   bitmap   |   |CHARSET||
|T|            |   |       ||
|T+------------+   +-------+|
|E                          |
|                           |
|S A M P L E   T E X T B O X|
+===========================+
The top 2 lines are attributes of actual character and font.
char dec hex - actual char and its deci- and hexa- presentation
relx rely width height shift - actual char attributes
addspc szover szundr lnhigh - font attributes (add-space, 
size-over, size-under, line-height)
On the very left portion of the screen it is the palette line
with font's color indexes; charset table is on the right.
Between the top 2 lines and the charset there is a little
status bar, informing actual mode, coordinates or colors.
At the bottom there is a sample textbox with info string 
displayed. Area in the middle of the screen is destined for
editing chosen character.

Note: Some of following keyboard shortcuts are dependent on 
mouse position, state of keyboard locks and program modes;
ie. you can use different short-cuts while pointing to the
palette bar, charset table, character bitmap, etc.

Arrow keys scrolls within the charset choosing actual character
whose bitmap is displayed. Picking the char in the charset by
mouse does the same, as well as simple hitting the key of the
desired character. There are only these exceptions:
'+' and '-' keys zoom the bitmap of actual character (doesn't
affect appearance of characters of the font, just magnify them
while editing)
'?' picks color of the point under cursor in the bitmap

Caps-Lock:
With Caps-Lock set, you can soften pixels on bitmaps by mouse
or rows or columns of character bitmap with alt-h, alt-v
short-cuts, or directly by mouse.

Scroll-lock:
WHEN SCROLL-LOCK IS SET, ALL OPERATIONS FOR SINGLE CHARACTER
ARE MADE FOR THE ENTIRE CHARSET.

character operations:
When pointing inside the character bitmap,
these keyboard shortcuts can be applied to current char:
---------- ----------------------------------------
alt-h      horizontal flip
alt-v      vertical flip
alt-t      turn right by 90 degrees
alt-u      cycle up
alt-d      cycle down
alt-l      cycle left
alt-r      cycle right
alt-n      minimalize (strip empty edges)
alt-q      nibble top row
alt-a      nibble bottom row
alt-s      nibble right column
alt-e      cast a shadow by current color
alt-f      paint aimed line by current color
shift-del  delete character with its params
del        erase character bitmap
ctrl-bksp  clear character bitmap
alt-i      inverts the bitmap by current color
ctrl->,<-  change character's shift
alt-p      set character's shift to its relx+width
(with Caps-Lock on):
alt-h      horizontal gradient soften
alt-v      vertical gradient soften

Undo:
ctrl-z is the shortcut for a single undo. You can not undo
changes for entire charset.

Adjusting the font's attributes:
When mouse points to any of character's or font's attribute
in the first two lines, you can change them by pressing arrow
keys (while pointing those attributes). Left and right is for
incrementing/decrementing by 1; up and down does it by 10.
Pressing Enter under any character attribute with Scroll-lock
set, will cause all chars in charset to gain this value.

Monotype macro:
alt-m sets all characters in font to unified shift (except
chars with no bitmap whose shift will be to zero) and adjusts
their relx so that each of them appear in the center of their
(mono)space. As a referece shift, the shift of space (char #32)
is taken.

Palette bar:
If the palette bar/any color within is pointed by mouse,
you can choose it by clicking it, or increase or decrease
red/green/blue components of selected color by pressing 
r,g,b or shift-r,shift-g,shift-b shortcuts respectively.
(You can see the values like {r,g,b} in the status bar.)
Alt-p makes fade from black (color #0) to white (actual color);
ctrl-p loads palette from external file (bmfed.col) in simple 
binary format (the same that Autodesk Animator exports).
'x' fills pointed color with selected color in char(s),
'X' exchanges pointed and selected color in char(s),
'o' draws a outline around character(s) with selected color.
Note these shortcuts can be combined with Scroll-Lock to be
aplied onto entire charset.

Moving mode:
Arrow keys serve normally to pick current character to edit.
In the charset at the right you see this character highlited.
You can press spacebar to toggle to `moving` mode, in which 
you adjust relx, rely (or width and height with shift held) of
current character, directly. Blue bottom bar indicates that
we are in the moving mode.

Scrolling all chars:
ctrl-[, ctrl-] scrolls whole character set (useful if chars'
bitmaps don't fit their appropriate ascii codes)

Adjusting bitmaps with keyboard:
While pointing into the character bitmap, PgUp and PgDn keys
quickly increase or decrease pixel under cursor on character 
bitmap

Color picking:
'?' key picks up the color attribute of the point under the
mouse cursor (if pointing into character bitmap).
ctrl-alt-f finds the pixel of highest color attribute
in whole font (suitable for diagnostics of the font).

Bottom textbox:
Press Enter to test chars in font fit in regular text.
Press it again to return to normal mode.
Note: During saving, content of the textbox is used as the
font's basic description, stored in the file.

Clipboard:
There are two clipboards in this program: one for characters
as a whole (ie with all its attributes) and special clipboard
for selection (portions, clips) of character bitmap.
ctrl-c copies whole character in the clipboard
ctrl-x is like ctrl-c, with erasing the source
ctrl-v replaces the actual character with the clipboard content
ctrl-a copies whole character bitmap into clipboard as a clip

Copying bitmap selection into clipboard:
Hold right shift key and select the area you want to copy in
the clipboard using right mouse button. After releasing it, 
marked rectangular area is copied into the clipboard.
Only contents gained this way (and the one by ctrl-a) 
can be pasted in another character bitmap without replacing 
it as a whole.

Paste mode:
After pressing the 'Ins' key, clipboard content
appears in "host" character bitmap in `paste` mode.
You can edit where and how this clipboard will be pasted
in the host bitmap, using these keys or shortcuts:
---------- --------------------------------------
arrow_keys move clipboard accross the host bitmap
home,end   align clipboard to the left or right
pgup,pgdn  align clipboard to the top or bottom
alt-h      flip clipboard horizontally
alt-v      flip clipboard vertically
alt-t      turn clipboard right by 90 degrees
alt-i      invert clipboard by current color
ins        toggle color #0 of clipboard transparent/opaque
enter      confirm and paste
esc,del    cancel

Drawing a filled rectangle:
Select a rectangle by mouse using left mouse button while
holding right shift key. Releasing the button fills a
rectangular area selected. While selecting, a little info
between top lines and the charset refreshes, giving dimensions
of currently selected area.

Drawing a line:
Hold left shift key, point into the bitmap and plot a starting
point of the line pressing the left mouse button. Move with
the mouse to the ending point of the line while still holding
the mouse button. Release the button to finish - after that
a line of actual color will be drawed.

Flood-filling:
Point into the character bitmap, then press the alt-y shortcut.
This will flood-fill the coherent area of color under cursor
with the actual color.

that's all you may know about BMFed to be able working with it.
ngage'n'njoy
crs/broncs