mirror of
https://github.com/cappuccino/cappuccino.git
synced 2026-08-25 13:07:02 +00:00
52 lines
2.2 KiB
Plaintext
52 lines
2.2 KiB
Plaintext
NAME
|
|
fontinfo -- retrieve information about a font
|
|
|
|
SYNOPSIS
|
|
fontinfo [-n] font [size [string]]
|
|
|
|
DESCRIPTION
|
|
fontinfo is a tiny utility that returns information about a font.
|
|
The font name must be a full PostScript name, not a display name. So you would use something
|
|
like "LucidaGrande-Bold", not "Lucida Grande Bold". The size can be any floating point number
|
|
greater than zero. If no size is given, it defaults to 12.
|
|
|
|
If the -n option is passed, the output will not be terminated with a linefeed.
|
|
|
|
If the string argument is passed, its width in the given font is measured and returned.
|
|
|
|
EXIT STATUS
|
|
fontinfo exits with a return status of zero if there are no errors.
|
|
fontinfo exits with a return status of 1 if any arguments are invalid, or a status of 2 if the font
|
|
cannot be found.
|
|
|
|
OUTPUT
|
|
fontinfo outputs a stringified JSON object with the following structure:
|
|
|
|
{
|
|
familyName:<string>,
|
|
bold:<boolean>,
|
|
italic:<boolean>,
|
|
ascender:<float>,
|
|
descender:<float>,
|
|
line-height:<float>
|
|
width:<float>
|
|
}
|
|
|
|
If -n is not passed, the JSON is terminated with a linefeed. The fields of the object are as follows:
|
|
|
|
familyName: The display name of the font's family
|
|
bold: Whether the font's stylistic traits are considered bold
|
|
italic: Whether the font's stylistic traits are considered italic
|
|
ascender: The offset from the baseline in points (not pixels!) of the longest ascender of the given font at
|
|
the given size.
|
|
descender: The negative offset from the baseline in points (not pixels!)
|
|
of the longest descender of the given font at the given size.
|
|
lineHeight: The height in points (not pixels!) of the largest glyph in the given font at the given size.
|
|
Note that glyphs include diacritical marks that may appear above and below the largest ascender
|
|
and descender, so the line height will almost always be greater than ascender + descender.
|
|
width: If a string is passed, the width in pixels of the string in the given font, otherwise zero
|
|
|
|
AUTHORS
|
|
Aparajita Fishman, Victory-Heart Productions
|
|
http://www.aparajita.com
|