103 lines
2.7 KiB
Groff
103 lines
2.7 KiB
Groff
.TH "MKG3A" "1" "May 2012"
|
|
|
|
.SH NAME
|
|
mkg3a \- a program packer for Casio FX-CG calculators
|
|
|
|
.SH SYNOPSIS
|
|
|
|
\fBmkg3a\fR
|
|
[[\-n \fIlang\fR:\fIname\fR]...]
|
|
[[\-i (\fIuns\fR|\fIsel\fR):\fIfile\fR]...]
|
|
\fIinfile.bin\fR [\fIoutfile.g3a\fR]
|
|
|
|
.SH DESCRIPTION
|
|
.B mkg3a
|
|
wraps an input file into a g3a file suitable for loading and running on a
|
|
Casio FX-CG calculator.
|
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
|
\fB\-n \fIlang\fB:\fIname\fR
|
|
Set the localized name of the resultant g3a to \fIname\fR. See the
|
|
\fBLOCALIZATION\fR section for details on values of \fIlang\fR.
|
|
|
|
.TP
|
|
\fB\-i (\fIuns\fB|\fIsel\fB):\fIicon.png\fR
|
|
Embed \fIicon.png\fR as the icon to show when the add-in is shown but not
|
|
selected (\fIuns\fBelected), or when \fIsel\fRected on the calculator.
|
|
Acceptable image formats are \fBBMP\fR, or \fBPNG\fR if your \fBmkg3a\fR
|
|
was built with libpng support. Icons must be 92 by 64 pixels.
|
|
|
|
.TP
|
|
\fB\-V \fIver\fR
|
|
Set the version string of the output file to \fIver\fR. This may technically
|
|
be any string, but convention suggests it be of the form "01.00.0000", which
|
|
is also the default value if not specified.
|
|
|
|
.TP
|
|
\fB\-v\fR
|
|
Show version and license information then exit.
|
|
|
|
.TP
|
|
\fB\-h\fR
|
|
Show usage information then exit.
|
|
|
|
.SH LOCALIZATION
|
|
Every g3a file contains fields for a number of localized addin names.
|
|
\fBmkg3a\fR supports setting these individually, via the \fB-n\fR option,
|
|
with the following legal values for \fIlang\fR.
|
|
.TP
|
|
\fBen\fR
|
|
English
|
|
.TP
|
|
\fBes\fR
|
|
Spanish
|
|
.TP
|
|
\fBde\fR
|
|
German
|
|
.TP
|
|
\fBfr\fR
|
|
French
|
|
.TP
|
|
\fBpt\fR
|
|
Portugese
|
|
.TP
|
|
\fBzh\fR
|
|
Chinese
|
|
.TP
|
|
\fBbasic\fR
|
|
Default (unlocalized) name.
|
|
.TP
|
|
\fBinternal\fR
|
|
A field that appears to be used internally by the calculator. This should
|
|
not usually be set explicitly, and will default to a reasonable value.
|
|
|
|
.PP
|
|
When shown in calculator menus, the localized name will be displayed as
|
|
appropriate according to the user's language settings.
|
|
If \fIlang\fR is empty, it is assumed to be \fIbasic\fR
|
|
(see \fBEXAMPLE\fR for a demonstration).
|
|
|
|
Any unspecified localized names will be automatically be filled from the
|
|
value of \fIbasic\fR. If \fIbasic\fR is not specified, it defaults to
|
|
the name of the output file.
|
|
|
|
.SH EXAMPLE
|
|
The following invocation packs the file example.bin into example.g3a, with
|
|
basic name "James". The localized name in French is "Jacques", and
|
|
the icons are read from files foo.png and bar.bmp.
|
|
|
|
mkg3a \-n :James \-n fr:Jacques \-i uns:foo.png \-i sel:bar.bmp example.bin
|
|
|
|
.SH SEE ALSO
|
|
gcc(1), ld(1)
|
|
|
|
FX-CG software development is documented extensively on WikiPrizm, at
|
|
\fIhttp://prizm.cemetech.net/\fR. The homepage for \fBmkg3a\fR is
|
|
\fIhttp://www.taricorp.net/projects/mkg3a\rR.
|
|
|
|
.SH AUTHOR
|
|
\fBmkg3a\fR and this manual page were written by Peter Marheine
|
|
<peter@taricorp.net>.
|