114 lines
5.2 KiB
Plaintext
114 lines
5.2 KiB
Plaintext
Font2DTest
|
|
-----------
|
|
|
|
To run Font2DTest:
|
|
|
|
% java -jar Font2DTest.jar
|
|
|
|
These instructions assume that the java command is in your path.
|
|
If they aren't, then you should either specify the complete path to the commands
|
|
or update your PATH environment variable as described in the
|
|
installation instructions for the Java(TM) SE Development Kit.
|
|
|
|
If you wish to modify any of the source code, you may want to extract
|
|
the contents of the Font2DTest.jar file by executing this command:
|
|
|
|
% jar -xvf Font2DTest.jar
|
|
|
|
-----------------------------------------------------------------------
|
|
Introduction
|
|
-----------------------------------------------------------------------
|
|
|
|
Font2DTest is an encompassing application for testing various fonts
|
|
found on the user's system. A number of controls are available to
|
|
change many attributes of the current font including style, size, and
|
|
rendering hints. The user can select from multiple display modes,
|
|
such as one Unicode range at a time, all glyphs of a particular font,
|
|
user-edited text, or text loaded from a file.
|
|
In addition, the user can control which method will
|
|
be used to render the text to the screen (or to be printed out).
|
|
|
|
-----------------------------------------------------------------------
|
|
Tips on usage
|
|
-----------------------------------------------------------------------
|
|
|
|
- The "Font" combobox will show a tick mark if some of the characters in
|
|
selected unicode range can be displayed by this font. No tick is shown,
|
|
if none of the characters can be displayed. A tooltip is shown with this
|
|
information. This indication is available only if "Unicode Range" is
|
|
selected in "Text to use" combobox.
|
|
|
|
This feature is enabled by default. For disabling this feature, use
|
|
command line flag -disablecandisplaycheck or -dcdc.
|
|
|
|
java -jar Font2DTest.jar -dcdc
|
|
|
|
- For the "Font Size" field to have an effect, it is necessary to press
|
|
ENTER when finished inputting data in those fields.
|
|
|
|
- When "Unicode Range" or "All Glyphs" is selected for Text to Use,
|
|
the status bar will show the range of the characters that is
|
|
currently being displayed. If mouse cursor is pointed to one of
|
|
the character drawn, the message will be changed to indicate
|
|
what character the cursor is pointing to.
|
|
By clicking on a character displayed, one can also "Zoom" a character.
|
|
Options can be set to show grids around each character,
|
|
or force the number of characters displayed across the screen to be 16.
|
|
These features are not available in "User Text" or "File Text" mode.
|
|
|
|
- The default number of columns in a Unicode Range or All Glyphs drawing
|
|
is "fit as many as possible". If this is too hard to read, then you
|
|
can force number of columns to be 16. However, this will not resize the
|
|
window to fit all 16 columns, so if the font size is too big, this will
|
|
overflow the canvas. (Unfortunately, I could not add horizontal space
|
|
bar due to design restrictions)
|
|
|
|
- If font size is too large to fit a character, then a message will
|
|
inform that smaller font size or larger canvas size is needed.
|
|
|
|
- Custom Unicode Range can be displayed by selecting "Custom..."
|
|
at the bottom of the Unicode Range menu. This will bring up
|
|
a dialog box to specify the starting and ending index
|
|
of the unicode characters to be drawn.
|
|
|
|
- To enter a customized text, select "User Text" from Text to Use menu.
|
|
A dialog box with a text area will come up. Enter any text here,
|
|
and then press update; the text on screen will then be redrawn to
|
|
draw the text just entered. To hide the user text dialog box,
|
|
switch to different selection in Text to Use menu.
|
|
(Closing the dialog box will not work...)
|
|
If a escape sequence of form \uXXXX is entered, it is will be
|
|
converted into the character that it maps to.
|
|
|
|
- drawBytes will only work for characters in Unicode range 0x00-0xFF
|
|
by its method definition. This program will warn when such text is
|
|
being drawn in "Range Text" mode. But since there is no way to detect
|
|
this from User Text, the warning will not be given even though
|
|
wrong text seems to be drawn on screen when it contains any character
|
|
beyond 0xFF.
|
|
|
|
- In the "All Glyphs" mode which displays all available glyphs for the
|
|
current font, only drawGlyphVector is available as the draw method.
|
|
Similary, when "Text File" mode is used, the file will always be wrapped
|
|
to canvas width using LineBreakMeasurer, so TextLayout.draw is used.
|
|
|
|
- With "User Text" mode, no text wrapping operation is done.
|
|
When displaying or printing text that does not fit in a given canvas,
|
|
the text will overflow to the right side of the page.
|
|
|
|
- It is also possible to display a text loaded from a file.
|
|
Font2DTest will handle is UTF-16 and the platform default encoding.
|
|
The text will then be reformatted to fit in the screen with
|
|
LineBreakMeasurer, and drawn with TextLayout.draw.
|
|
Most major word processor softwares support this format.
|
|
|
|
- When printing, the program will ask to select 1 of 3 options.
|
|
First "Print one full page..." will print as much
|
|
characters/lines of text as it can fit in one page, starting from
|
|
the character/line that is currently drawn at the top of the page.
|
|
Second option, "Print all characters..." will print all characters
|
|
that are within the selected range. Third option, "Print all text..."
|
|
is similar, and it will print all lines of text that user has put in.
|
|
|
|
====================================================================
|