3 .Dt LBXIMG \&1 "2ooM Reference Manual"
6 .Nd inspect and decode LBX images
11 .Op Fl p Ar palette_file
12 .Op Fl O Ar override_file
17 identifies and decodes LBX image files, using
19 LBX images are multi-frame, 256-colour paletted images with transparency.
21 can be used to convert some or all of the frames of an LBX image to PNG.
23 .Bl -tag -width indent
25 Sets the operating mode to identify the image format.
27 Sets the operating mode to decode frames to PNG.
29 Output additional information on standard output.
30 .It Fl f , -file Ar path
31 Read from the specified
33 instead of standard input. If
37 will read from standard input anyway.
38 .It Fl p , -palette Ar palette_file
39 Read the base palette from
41 In Moo2, these files are found in
43 Without this option, the base palette is filled with a nice hot pink. Colours
44 in the base palette are superseded by those in the embedded palette and the
46 .It Fl O , -override Ar override_file
47 Use the embedded palette of an LBX image specified by
49 as the override palette. In Moo2, this is notably used to select the player
50 colour for ship images. Colours in the override palette supersede those in
51 both the base palette and the embedded palette.
53 Specifies the frames to decode as a sequence of intervals, with frames indexing
54 from zero. By default, all frames are decoded. Multiplicity is ignored, as is
55 the order in which frames are specified. For example:
58 Decode frames 3 and 6.
60 Decode frames 4 through 9, inclusive
62 Decode frames 1 through 9, except for frame 5.
64 Decode all frames except the first 3.