-.Dd January 4, 2008
+.\" Copyright (C) 2008-2010 Nick Bowler
+.\" Copying and distribution of this file, with or without modification,
+.\" are permitted in any medium without royalty provided the copyright
+.\" notice and this notice are preserved. This file is offered as-is,
+.\" without any warranty.
+.Dd February 9, 2010
.Os liblbx
.Dt LBXIMG \&1 "2ooM Reference Manual"
.Sh NAME
.Nm
.Op Fl i Ns | Ns Fl d
.Op Fl v
+.Op Fl n
.Op Fl p Ar palette_file
.Op Fl O Ar override_file
.Op Fl f Ar path
.It Fl f , -file Ar path
Read from the specified
.Ar path
-instead of standard input. If
-.Ar path
-is -,
-.Nm
-will read from standard input anyway.
+instead of standard input.
+.It Fl n , -no-palette
+Instead of looking up colour indices in the palette, use the index itself for
+each of the red, green and blue components of the output. This is mainly
+useful for debugging
+.Em liblbx .
.It Fl p , -palette Ar palette_file
Read the base palette from
.Ar palette_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. In Moo2, this is notably used to select the player
-colour for ship images. Colours in the override palette supersede those in
-both the base palette and the embedded palette.
+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.
.It Fl V , -version
Print a version message and exit.
.It Fl -usage
Decode all frames except the first 3.
.El
.El
+.Sh EXAMPLES
+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
+Print some information about the Simtex logo image.
+.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.
+.It Nm Li -dvf logo.lbx.001
+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
+Decodes an image of a red star fortress.
+.El
+.Sh SEE ALSO
+.Xr lbxtool 1 ,
+.Xr lbxgui 1