.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.48) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "MAKE_VOLT 1" .TH MAKE_VOLT 1 2026-10-03 "perl v5.44.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NAME make_volt \- Create VOLT code from a TrueType Font .SH SYNOPSIS .IX Header "SYNOPSIS" .Vb 2 \& make_volt [\-a file] [\-l ligtype] [\-i file] [\-n] infile outfile \& make_volt \-t [\-a file] [\-l ligtype] [\-i file] [\-n] infile .Ve .PP Creates a copy of the infile font file adding a VOLT table to it. .SH OPTIONS .IX Header "OPTIONS" .Vb 10 \& \-a file Attachment Point database .xml file \& \-b Set un\-typed glyphs to type "BASE" \& \-c classfile xml file of class and property information to merge in \& \-\-classprops specifies whether classes are made for property values in \& the classfile \& \-\-classwarn issue warnings if classfile contains references to glyphs \& that are not in the font. \& \-e file A file containing names (1 per line) of glyphs that are \& known to have no outline (thus shouldn\*(Aqt generate warning). \& \-f level Force value for adding OpenType lookups: \& 0 create lookups only if not already present [default] \& 1 re\-create lookups even if same named exist \& 2 don\*(Aqt build any lookups \& \-h print manpage \& \-i fontfile Merge VOLT table from this font or text file \& \-l type How ligatures are built: type = \& first \- class name is first code, contents other codes \& last \- class name is last code, contents other codes \& firstcomp \- treat extensions as part of elements, as first \& lastcomp \- treat extensons as part of elements, as last \& \-m "list" List of anchors that do not imply a MARK glyph (e.g. "_R") \& \-n Add a normalization ligature lookups \& \-o "list" List of AP names to omit \& \-t output volt code to stdout and don\*(Aqt generate a font file \& \-z bitfield Bitfield of various controls: \& 0 \- n/a \& 1 \- normalise even if presentation is only references \& 2 \- n/a .Ve .SH DESCRIPTION .IX Header "DESCRIPTION" make_volt aims to make the creation of OpenType fonts much easier. It allows for a font designer to make changes and to feed that changed font forward to merge previously created VOLT code without losing that work. It also creates glyph names, key classes and lookups that can save a lot of work in VOLT. .PP In addition, make_volt has the capability to merge the volt code it creates with existing volt code either in a font or in a text file. .SS "Glyph naming" .IX Subsection "Glyph naming" Glyphs are named based on the postscript name of the glyph with variants and illegal characters stripped from the name. Name clashes are simply numbered. .SS Classes .IX Subsection "Classes" make_volt creates a number of different kind of class. For each attachment point base name (\fIx\fR) a class is created. Class \f(CW\*(C`c\*(C'\fR\fIx\fR\f(CW\*(C`Dia\*(C'\fR contains a list of all the glyphs with the attachment point \f(CW\*(C`_\*(C'\fR\fIx\fR. Class \&\f(CW\*(C`cTakes\*(C'\fR\fIx\fR\f(CW\*(C`Dia\*(C'\fR contains all the glyphs with attachment point \fIx\fR. Class \&\f(CW\*(C`cn\*(C'\fR\fIx\fR\f(CW\*(C`Dia\*(C'\fR contains all the glyphs without attachment point \f(CW\*(C`_\*(C'\fR\fIX\fR. And the class \f(CW\*(C`cnTakes\*(C'\fR\fIx\fR\f(CW\*(C`Dia\*(C'\fR contains all the glyphs without the \fIx\fR attachment point. .PP In addition for each glyph name variant (as labelled in a postscript name for a glyh using \f(CW\*(C`.\*(C'\fR\fIvar\fR) a class named \f(CW\*(C`c\*(C'\fR\fIvar\fR is created with all the glyphs with that variant in their name. A class named \f(CW\*(C`c_no\*(C'\fR\fIvar\fR is also created containing all the corresponding glyphs without the variant, in direct correspondance, so that the non\-variant form may be mapped to the variant form using a single rule, for all the glyphs in the class. .PP Finally a class is created for ligature components. If a glyph is part of a ligature rule it is either the key glyph for the rule or part of the class for the rule. Thus for a rule keyed of a glyph named \fIx\fR there will be two classese: \f(CW\*(C`cl_\*(C'\fR\fIx\fR which is the ligatures involving \fIx\fR and \f(CW\*(C`clno_\*(C'\fR\fIx\fR which contains all the components that correspond to the ligatures found in the other class. This makes a ligature rule a simple 1:1 mapping from \&\f(CW\*(C`clno_\*(C'\fR\fIx\fR to \f(CW\*(C`cl_\*(C'\fR\fIx\fR. .SS Ligatures .IX Subsection "Ligatures" make_volt has the ability to create ligature mapping lookups. These are controlled by glyph names and follow the approach taken in \f(CW\*(C`make_gdl\*(C'\fR. .SH "SEE ALSO" .IX Header "SEE ALSO" ttfbuilder, make_gdl .SH AUTHOR .IX Header "AUTHOR" Martin Hosken . (see CONTRIBUTORS for other authors). .SH LICENSING .IX Header "LICENSING" Copyright (c) 1998\-2016, SIL International (http://www.sil.org) .PP This script is released under the terms of the Artistic License 2.0. For details, see the full text of the license in the file LICENSE.