www.pudn.com > sswf-1.7.4-src.zip > ft2sswf.1

.\"
.\" MAN PAGE COMMENTS
.\"
.\" Written by Alexis Wilke for Made to Order Software, Ltd. (c) 2002-2006
.\"
.if \n(zZ=1 .ig zZ
.if \n(zY=1 .ig zY
.TH FT2SSWF 1 "2002 Oct 22" "FT2SSWF-1.3"
.de }1
.  ds ]X \&\\*(]B\\
.  nr )E 0
.  if !"\\$1"" .nr )I \\$1n
.  }f
.  ll \\n(LLu
.  in \\n()Ru+\\n(INu+\\n()Iu
.  ti \\n(INu
.  ie !\\n()Iu+\\n()Ru-\w\\*(]Xu-3p \{\\*(]X
.  br\}
.  el \\*(]X\h|\\n()Iu+\\n()Ru\c
.  }f
..
.\"
.\" File Name macro.  This used to be `.PN', for Path Name,
.\" but Sun doesn't seem to like that very much.
.\"
.de FN
\fI\|\\$1\|\fP
..
.SH NAME
ft2sswf \- Font convertor for the SSWF compiler
.SH SYNOPSIS
.B ft2sswf
[options]
file ...
.SH DESCRIPTION
.B ft2sswf
can be used to generate script files later compiled by
.IR sswf
to use fonts in your Flash movies.
.PP
All the fonts supported by the freetype v2.1.x library are
supported by the ft2sswf tool. Note that the resulting
glyphs are likely to be approximations of the source
font images. Most TrueType fonts will use Bezier curves
with two or more control points whereas the SSWF format
only supports one.
.SH OPTIONS
The following options are understood by \fBft2sswf\fR.
The short options are likely to change in the future.
.TP
.BR \-\-\^advance "[ |=]\fIvalue\fP"
Define the default advance. All the characters using this
value will not have an advance number specified. At this
time the default advance is taken as the width of the
space character. This will later change to the most used
advance parameter among all the glyphs included in the
script.
.TP
.BR \-\^c "[0|1]"
Print comments in the output file (1 - default) or not (0).
.TP
.BR \-\-\^control
By default, no control character is printed in the output
because the Flash plugins don't really use them. Use this
option to get the glyphs corresponding to all the characters
including the controls. Note that the NUL character can
never be printed out (it is always skipped since it can't
be used in a Flash movie).
.TP
.BR \-\^e "[0|1|2]"
Print out a list of the supported encodings within the specified
font(s). Selecting one of these encodings with \fB--map\fP can
be useful to ensure you get all of the characters you want in
the output script. Use \fB-e0\fP or \fB-e\fP to turn off this option,
\fB-e1\fP to see the list of encodings available in a font and
\fB-e2\fP to see a complete list of encodings supported by the
freefont library and understood by \fBft2sswf\fP.
.TP
.BR \-\^f "[ ]"
The fonts are usually written so they appear in the 1024x1024
EM square as defined by Macromedia (at least in their documentation
since it seems this generates fonts 20 times too large... could
it be that the EM square was given in TWIPs?).
This usually creates a really large but high precision set of
glyphs. If you only need much smaller glyphs, you can use
this option to define a divisor factor. It will be applied to
all the values as required.
.TP
.BR \-\^g "[ ]\fIglyphs\fP or " \-\-\^glyph "[ |=]\fIglyphs\fB"
When you use this option, only the glyphs specified in \fIglyphs\fP
will be printed in the output script. Thus, if you need to print
out a few stings like "This is a test" and "Hello World!" you will
only get the characters necessary to write these two sentences.
Only the last such option is taken in account so you need to merge
the strings ("This is a testHello World!" will work in this case.)
.TP
.BR \-\^h " or " \-\-\^help
Prints out a quick help screen about all the options supported
by \fBft2sswf\fP.
.TP
.BR \-\^m "[ ]\fIname\fP or " \-\-\^map "( |=)[\fIname\fP]"
Gives the name of the encoding of the font to be used. At this time
it is also used as the output encoding. This will change in the
future (you will be able to define a specific output format).
In order to see the list of available encodings in a font,
use \fB-e1\fP on the command line.
.TP
.BR \-\^n "[0|1] or " \-\-\^include-null " or " \-\-\^no-null
By default, ft2sswf doesn't include empty characters
- these characters which have no outline at all - except the space
character. If you wish to have all of the glyphs listed, including
the empty ones, use \fB-n0\fP or \fB--include-null\fP. Use
\fB-n1\fP or \fB--no-null\fP to revert back to normal.
.TP
.BR \-\^o " \fIfilename\fP or " \-\-\^output "=\fIfilename\fP"
Defines the name of the output file. When no name is specified,
\fBft2sswf\fP sends the output in \fIstdout\fP.
.TP
.BR \-\^q
Makes \fBft2sswf\fP as quiet as possible. Only warnings and
errors are printed out (beside the resulting script).
.TP
.BR \-\^v
Increase the verbosity by one. Different information may be
printed when the verbosity is higher.
.TP
.BR \-\-\^version
Prints out the \fIft2sswf\fP version and exit with an error.
.SH ARGUMENTS
All the other arguments are taken as font file names. Note that
options can appear in between each file name. Thus, if you want
to transform two fonts in one go, you can write the following:
.IP
\fBft2sswf -o font1.sswf font1.ttf -o font2.sswf font2.ttf\fP
.PP
As many options as you need can be specified between file names
in this way. This is why most of the options have an opposite
to cancel its effect.
.PP
The special option \fB--\fP can be used after all the options
to specify that any of the following arguments are font
filenames.
.SH "SEE ALSO"
\fIAlexis' SWF Reference\fP, Alexis Wilke (\fIhttp://sswf.sourceforge.net/SWFalexref.html\fP)
.PP
\fISSWF Reference Manual\fP, Alexis Wilke (\fIhttp://sswf.sourceforge.net/ScriptSWF.html\fP)
.PP
swf_dump(1), sswf(1), jpg2swf(1)
.SH BUGS
.TP
You are welcome to report bugs to me at: alexis_wilke@users.sourceforge.net
.B "Thank you in advance for the info!"
.PP
The output map can't actually be specified.
.PP
The font information (comments, copyrights, etc.) should be printed
automatically in the output file.
.PP
The code used to reduce Bezier curves should be enhanced to make sure
it doesn't make too bad an approximation. This should certainly be
part of the \fBsswf\fP tool also.
.SH "VERSION"
.PP
This manual page is part of version  of SSWF.
.PP
This file was last updated on .
.SH COPYRIGHT
.if n ft2sswf is Copyright (c) 2002-2006 by Made to Order Software, Ltd.
.if t ft2sswf is Copyright \(co 2002-2006 by Made to Order Software, Ltd.
.PP
Permission is hereby granted, free of charge, to any
person obtaining a copy of this software and
associated documentation files (the "Software"), to
deal in the Software without restriction, including
without limitation the rights to use, copy, modify,
merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom
the Software is furnished to do so, subject to the
following conditions:
.PP
The above copyright notice and this permission notice
shall be included in all copies or substantial
portions of the Software.
.PP
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
.zZ
.zY