- Notifications
You must be signed in to change notification settings - Fork64
Optimized OpenType builder and inspector.
License
caryll/otfcc
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Theotfcc
is a C library and utility used for parsing and writing OpenType font files.
- JSON serialization of TrueType and CFF OpenType fonts.
- Building OpenType fonts from JSON.
- Full support for OpenType features (
GSUB
,GPOS
andGDEF
), CID-keyed CFF, vertical metrics, and more. - 4× faster than
ttx
on CFF OTF, and 40× on TTF. - 900× faster than
makeotf
for building a fully-optimized CFF OTF.
You can download the prebuilt binarieshere.
If you haveHomebrew, just run the following in your terminal.
brew tap caryll/tapbrew install otfcc-mac64
Note: a full Xcode installation is required. Please refer to the instructionshere if you see an error related toxcode-select
.
Otherwise, you may need to click the “Releases” above, and download the archives in it.
The packageotfcc
can be foundhere.
See below.
otfccdump [OPTIONS] input.[otf|ttf|ttc] -h, --help : Display this help message and exit. -v, --version : Display version information and exit. -o <file> : Set output file path to <file>. When absent the dump will be written to STDOUT. -n <n>, --ttc-index <n> : Use the <n>th subfont within the input font. --pretty : Prettify the output JSON. --ugly : Force uglify the output JSON. --verbose : Show more information when building. --ignore-glyph-order : Do not export glyph order information. --glyph-name-prefix pfx : Add a prefix to the glyph names. --ignore-hints : Do not export hinting information. --decimal-cmap : Export 'cmap' keys as decimal number. --name-by-hash : Name glyphs using its hash value. --add-bom : Add BOM mark in the output. (It is default on Windows when redirecting to another program. Use --no-bom to turn it off.)
Usage : otfccbuild [OPTIONS] [input.json] -o output.[ttf|otf] input.json : Path to input file. When absent the input will be read from the STDIN. -h, --help : Display this help message and exit. -v, --version : Display version information and exit. -o <file> : Set output file path to <file>. -s, --dummy-dsig : Include an empty DSIG table in the font. For some Microsoft applications, DSIG is required to enable OpenType features. -O<n> : Specify the level for optimization. -O0 Turn off any optimization. -O1 Default optimization. -O2 More aggressive optimizations for web font. In this level, the following options will be set: --merge-features --short-post --subroutinize -O3 The most aggressive opptimization strategy will be used. In this level, these options will be set: --force-cid --ignore-glyph-order --verbose : Show more information when building. --ignore-hints : Ignore the hinting information in the input. --keep-average-char-width : Keep the OS/2.xAvgCharWidth value from the input instead of stating the average width of glyphs. Useful when creating a monospaced font. --keep-unicode-ranges : Keep the OS/2.ulUnicodeRange[1-4] as-is. --keep-modified-time : Keep the head.modified time in the json, instead of using current time. --short-post : Don't export glyph names in the result font. --ignore-glyph-order, -i : Ignore the glyph order information in the input. --keep-glyph-order, -k : Keep the glyph order information in the input. Use to preserve glyph order under -O2 and -O3. --dont-ignore-glyph-order : Same as --keep-glyph-order. --merge-features : Merge duplicate OpenType feature definitions. --dont-merge-features : Keep duplicate OpenType feature definitions. --merge-lookups : Merge duplicate OpenType lookups. --dont-merge-lookups : Keep duplicate OpenType lookups. --force-cid : Convert name-keyed CFF OTF into CID-keyed. --subroutinize : Subroutinize CFF table. --stub-cmap4 : Create a stub `cmap` format 4 subtable if format 12 subtable is present.
otfcc
can be built on a number of platforms. It uses thepremake build system.
It was developed and optimized for Clang/LLVM, therefore it isstrongly recommended to compile with Clang/LLVM, but if that's not possible GCC is also supported, GCC version 5.1 or later being the preferred choice for performance.
On Linux, Either Clang/LLVM or GCC can be used to buildotfcc
.
- Install the latest Clang/LLVM or GCC if you do not have it already.
- Installpremake5 and make it available in your path.
- Run the following from the command line (Change config when necessary):
premake5 gmakecd build/gmakemake config=release_x64
If you haveNinja installed on your system, you can use ninja either:
premake5 ninjacd build/ninjaninja otfccdump_release_x64 otfccbuild_release_x64
Change the targets above when necessary.
On Windows, buildingotfcc
is tested under the toolchains listed below. The defaultpremake5 vs2015
will produce a Visual Studio solution using Clang-CL as its compiler.
GCC 5.1 included in
TDM-GCC
, or GCC 6.1.0 in MinGW-W64. Run the following from the command line (Change theconfig
when necessary):premake5 gmakecd build/gmakemake config=release_x64
To use Ninja like that in Linux, you need to specify the
--os=linux
when usingpremake5 ninja
.Visual C++ Building Tools (Mar 2016) withClang/LLVM 3.9. Only Release build is tested. Run the following from the Visual C++ Command Prompt:
premake5 vs2015msbuild build\vs\otfcc.sln /property:Configuration=Release
premake5 (can be installed viabrew install premake --devel
, or be found in thedep/bin-osx
directory) provides ability to produce XCode projects. Run
premake5 xcode4
And then you can openbuild/xcode/otfcc.xcworkspace
and build with XCode. You can find built binaries inbin/
.
Please ensure that Xcode’s Developer Mode is enabled.
To build binaries in your terminal, run
xcodebuild -workspace build/xcode/otfcc.xcworkspace -scheme otfccbuild -configuration Releasexcodebuild -workspace build/xcode/otfcc.xcworkspace -scheme otfccdump -configuration Release
About
Optimized OpenType builder and inspector.