3 .Dt LBXIMG \&1 "2ooM Reference Manual"
6 .Nd inspect and decode LBX images
13 .Op Fl p Ar palette_file
14 .Op Fl O Ar override_file
19 identifies and decodes LBX image files, using
21 LBX images are multi-frame, 256-colour paletted images with transparency.
23 can be used to convert some or all of the frames of an LBX image to other image
26 .Bl -tag -width indent
28 Sets the operating mode to identify the image format.
30 Sets the operating mode to decode frames to PNG.
32 Output additional information on standard output.
33 .It Fl F , -format Ar format
34 Select the desired output format. Some formats may not be available depending
35 on the compile-time settings of
37 If this option is not specified, the default is the first in the following list
38 which is enabled at build time.
39 .Bl -column -offset indent ".Em Format"
40 .It Em Format Ta Em Description
42 Output images in Portable Network Graphics (PNG) format. This is is a
43 compressed format which is well-supported by other tools. All features of
45 are supported with this format.
47 Output images in Netpbm PAM format. This is a simple uncompressed binary image
48 format supporting RGB and alpha channels. All features of
50 are supported with this format.
52 Output image colour data in Netpbm "plain" PPM format. This is a simple
53 7-bit clean uncompressed RGB format. It does not support transparency, so
54 images will have transparent pixels replaced with black. This format is
55 rather inefficient and provided mainly for testing.
57 Output image mask data in Netpbm "plain" PBM format. This is a simple 7-bit
58 clean uncompressed bitmap format. It does not support colour data; instead,
59 bitmap values represent whether or not a pixel is transparent. Black (1)
60 pixels are transparent, white (0) pixels are opaque. This format is extremely
61 inefficient and provided mainly for testing.
63 .It Fl f , -file Ar path
64 Read from the specified
66 instead of standard input.
67 .It Fl n , -no-palette
68 Instead of looking up colour indices in the palette, emit a grayscale image
69 where the intensity value of a pixel is equal to the palette index itself.
70 This is mainly useful for debugging the image decoder in
72 .It Fl p , -palette Ar palette_file
73 Read the base palette from
75 In Moo2, these files are found in
77 Without this option, the base palette is filled with a nice hot pink. Colours
78 in the base palette are superseded by those in the embedded palette and the
80 .It Fl O , -override Ar override_file
81 Use the embedded palette of an LBX image specified by
83 as the override palette. One example of where this is used is for selecting
84 the player colour for ship images. Colours in the override palette supersede
85 those in both the base palette and the embedded palette.
87 Print a version message and exit.
89 Print a short usage message and exit.
91 Print a help message and exit
93 Specifies the frames to decode as a sequence of intervals, with frames indexing
94 from zero. By default, all frames are decoded. Multiplicity is ignored, as is
95 the order in which frames are specified. For example:
98 Decode frames 3 and 6.
100 Decode frames 4 through 9, inclusive
102 Decode frames 1 through 9, except for frame 5.
104 Decode all frames except the first 3.
108 After extracting fonts.lbx, mainmenu.lbx, logo.lbx and ships.lbx with
110 .Bl -tag -width indent
111 .It Nm Li -ivf logo.lbx.000
112 Print some information about the Simtex logo image.
113 .It Nm Li -dvf mainmenu.lbx.000 -p fonts.lbx.006
114 Decodes all the frames of the main menu panel into a series of PNGs.
115 .It Nm Li -dvf logo.lbx.001
116 Decodes all the frames of the Microprose logo into a series of PNGs.
117 .It Nm Li -dvf ships.lbx.042 -p fonts.lbx.012 -O ships.lbx.049
118 Decodes an image of a red star fortress.
121 Nick Bowler <nbowler@draconx.ca>
123 Copyright \(co 2008\(en2010, 2013 Nick Bowler
125 Permission is granted to copy, distribute and/or modify this manual under the
126 terms of the Do What The Fuck You Want To Public License, version 2.