For literal strings, we need to use \- instead of just - as some troff
processors turn plain "-" into "proper" unicode hyphens (as opposed to
hyphen-minus), which breaks copy+paste and searching.
Ensure that .Os follows .Dt in the mdoc prologue as apparently not doing
this results in broken manpage headings with groff 1.23.
-.Dd September 12, 2021
-.Os liblbx
.Dt LBXIMG \&1 "2ooM Reference Manual"
.Dt LBXIMG \&1 "2ooM Reference Manual"
.Sh NAME
.Nm lbximg
.Nd inspect and decode LBX images
.Sh NAME
.Nm lbximg
.Nd inspect and decode LBX images
formats.
.Sh OPTIONS
.Bl -tag -width indent
formats.
.Sh OPTIONS
.Bl -tag -width indent
Sets the operating mode to identify the image format.
Sets the operating mode to identify the image format.
Sets the operating mode to decode frames to PNG.
Sets the operating mode to decode frames to PNG.
Output additional information on standard output.
Output additional information on standard output.
-.It Fl F , -format Ar format
+.It Fl F , \-format Ar format
Select the desired output format. Some formats may not be available depending
on the compile-time settings of
.Nm .
Select the desired output format. Some formats may not be available depending
on the compile-time settings of
.Nm .
pixels are transparent, white (0) pixels are opaque. This format is extremely
inefficient and provided mainly for testing.
.El
pixels are transparent, white (0) pixels are opaque. This format is extremely
inefficient and provided mainly for testing.
.El
-.It Fl f , -file Ar path
+.It Fl f , \-file Ar path
Read from the specified
.Ar path
instead of standard input.
Read from the specified
.Ar path
instead of standard input.
-.It Fl -output-prefix Ar string
+.It Fl \-output\-prefix Ar string
Prefix each output filename with the given string. Filenames are produced by
adding a frame number and file extension to the given prefix. The default
prefix is
.Li out .
Prefix each output filename with the given string. Filenames are produced by
adding a frame number and file extension to the given prefix. The default
prefix is
.Li out .
+.It Fl n , \-no\-palette
Instead of looking up colour indices in the palette, emit a grayscale image
where the intensity value of a pixel is equal to the palette index itself.
This is mainly useful for debugging the image decoder in
.Em liblbx .
Instead of looking up colour indices in the palette, emit a grayscale image
where the intensity value of a pixel is equal to the palette index itself.
This is mainly useful for debugging the image decoder in
.Em liblbx .
-.It Fl p , -palette Ar palette_file
+.It Fl p , \-palette Ar palette_file
Read the base palette from
.Ar palette_file .
In Moo2, these files are found in
Read the base palette from
.Ar palette_file .
In Moo2, these files are found in
Without this option, the base palette is filled with a nice hot pink. Colours
in the base palette are superseded by those in the embedded palette and the
override palette.
Without this option, the base palette is filled with a nice hot pink. Colours
in the base palette are superseded by those in the embedded palette and the
override palette.
-.It Fl O , -override Ar override_file
+.It Fl O , \-override Ar override_file
Use the embedded palette of an LBX image specified by
.Ar override_file
as the override palette. One example of where this is used is for selecting
the player colour for ship images. Colours in the override palette supersede
those in both the base palette and the embedded palette.
Use the embedded palette of an LBX image specified by
.Ar override_file
as the override palette. One example of where this is used is for selecting
the player colour for ship images. Colours in the override palette supersede
those in both the base palette and the embedded palette.
Print a version message and exit.
Print a version message and exit.
Print a short usage message and exit.
Print a short usage message and exit.
Print a help message and exit
.It Ar frameno ...
Specifies the frames to decode as a sequence of intervals, with frames indexing
from zero. By default, all frames are decoded. Multiplicity is ignored, as is
the order in which frames are specified. For example:
.Bl -tag -width
Print a help message and exit
.It Ar frameno ...
Specifies the frames to decode as a sequence of intervals, with frames indexing
from zero. By default, all frames are decoded. Multiplicity is ignored, as is
the order in which frames are specified. For example:
.Bl -tag -width
Decode frames 4 through 9, inclusive
Decode frames 4 through 9, inclusive
Decode frames 1 through 9, except for frame 5.
Decode frames 1 through 9, except for frame 5.
Decode all frames except the first 3.
.El
.El
Decode all frames except the first 3.
.El
.El
After extracting fonts.lbx, mainmenu.lbx, logo.lbx and ships.lbx with
.Xr lbxtool 1 :
.Bl -tag -width indent
After extracting fonts.lbx, mainmenu.lbx, logo.lbx and ships.lbx with
.Xr lbxtool 1 :
.Bl -tag -width indent
-.It Nm Li -ivf logo.lbx.000
+.It Nm Li \-ivf logo.lbx.000
Print some information about the Simtex logo image.
Print some information about the Simtex logo image.
-.It Nm Li -dvf mainmenu.lbx.000 -p fonts.lbx.006
+.It Nm Li \-dvf mainmenu.lbx.000 \-p fonts.lbx.006
Decodes all the frames of the main menu panel into a series of PNGs.
Decodes all the frames of the main menu panel into a series of PNGs.
-.It Nm Li -dvf logo.lbx.001
+.It Nm Li \-dvf logo.lbx.001
Decodes all the frames of the Microprose logo into a series of PNGs.
Decodes all the frames of the Microprose logo into a series of PNGs.
-.It Nm Li -dvf ships.lbx.042 -p fonts.lbx.012 -O ships.lbx.049
+.It Nm Li \-dvf ships.lbx.042 \-p fonts.lbx.012 \-O ships.lbx.049
Decodes an image of a red star fortress.
.El
.Sh AUTHORS
Nick Bowler <nbowler@draconx.ca>
.Sh COPYRIGHT
Decodes an image of a red star fortress.
.El
.Sh AUTHORS
Nick Bowler <nbowler@draconx.ca>
.Sh COPYRIGHT
-Copyright \(co 2008, 2010, 2013, 2021 Nick Bowler
+Copyright \(co 2008, 2010, 2013, 2021, 2023 Nick Bowler
.Pp
Permission is granted to copy, distribute and/or modify this manual under the
terms of the GNU General Public License as published by the Free Software
.Pp
Permission is granted to copy, distribute and/or modify this manual under the
terms of the GNU General Public License as published by the Free Software
-.Dd September 12, 2021
-.Os liblbx
.Dt LBXTOOL \&1 "2ooM Reference Manual"
.Dt LBXTOOL \&1 "2ooM Reference Manual"
.Sh NAME
.Nm lbxtool
.Nd manipulate LBX archives
.Sh NAME
.Nm lbxtool
.Nd manipulate LBX archives
.Em liblbx .
.Sh OPTIONS
.Bl -tag -width indent
.Em liblbx .
.Sh OPTIONS
.Bl -tag -width indent
Sets the operating mode to list files in the archive.
Sets the operating mode to list files in the archive.
Sets the operating mode to extract files from the archive.
Sets the operating mode to extract files from the archive.
Output additional information on standard output.
Output additional information on standard output.
-.It Fl f , -file Ar path
+.It Fl f , \-file Ar path
Read from the specified
.Ar path
instead of standard input.
Read from the specified
.Ar path
instead of standard input.
Print a version message and exit.
Print a version message and exit.
Print a help message and exit
.It Ar
Limit the operation to these files in the archive. By default, all files are
Print a help message and exit
.It Ar
Limit the operation to these files in the archive. By default, all files are
.Sh AUTHORS
Nick Bowler <nbowler@draconx.ca>
.Sh COPYRIGHT
.Sh AUTHORS
Nick Bowler <nbowler@draconx.ca>
.Sh COPYRIGHT
-Copyright \(co 2008, 2010, 2021 Nick Bowler
+Copyright \(co 2008, 2010, 2021, 2023 Nick Bowler
.Pp
Permission is granted to copy, distribute and/or modify this manual under the
terms of the GNU General Public License as published by the Free Software
.Pp
Permission is granted to copy, distribute and/or modify this manual under the
terms of the GNU General Public License as published by the Free Software