Add externs to avoid multiple definitions, and then add missing definitions.
[rrq/maintain_lilo.git] / images / README
1 README for project LILO / images
2 ================================
3
4 Picture files for boot menu must be rl-coded bmp files.
5
6 Files as distributed have been edited through 'lilo -E XXXX.bmp' to specify
7 useful boot table layouts, colors, and timer positions. The companion *.dat
8 files contain photo credits, where applicable, as well as the  'lilo -E ...'
9 parametric information contained in the LILO-bmp headers in the actual
10 picture files.
11
12 Naming convention:
13   "16c"  in the name indicates 640 x 480 x 4bit with 16 colors (mode 0x12)
14   "256c" in the name indicates 640 x 480 x 8bit with 256 colors (mode 0x101)
15
16 *16c* files will display on any IBM-compatible VGA display adapter.
17 *256c* files require a video adapter which supports VESA bios extensions;
18   specifically, mode 0x101 -- 640 x 480 x 256 colors.
19
20 If you have booted with LILO, then you may easily inquire of your video
21 adapter's capabilities with:
22
23   lilo -T video
24
25 The video adapter type, and the video modes supported by its BIOS, will be
26 displayed; i.e., those graphic modes of interest to the LILO bitmap
27 interface.
28
29 Creating image for background
30 -----------------------------
31
32 With ImageMagick you can use the convert command as follows:
33
34 for images with 16 colors:
35
36         convert -verbose "$INFILE" \
37           -resize 640x480 -density 72x72 -depth 4 -colors 16 \
38           -colorspace RGB -compress RunlengthEncoded "$OUTFILE"
39
40 for images with 256 colors:
41
42         convert -verbose "$INFILE" \
43           -resize 640x480 -density 72x72 -depth 8 -colors 256 \
44           -colorspace RGB -compress RunlengthEncoded "$OUTFILE"
45
46 Note: the Runlength-Encoding (RLE) will be made better by Gimp.
47
48
49 Example for syntax and colors
50 -----------------------------
51
52   color palette: 0 black,         3 magenta,       7 pink,
53                  8 middle grey,  10 bright grey,  13 white
54  
55   bmp-table  = <x>,<y>;<ncol>,<nrow>,<xsep>,<spill>
56   if <ncol> = 1 then there are only one menu column
57                 and <spill> will not be defined
58  
59   bmp-colors = <fg>,<bg>,<sh>;<high-fg>,<high-bg>,<high-sh>
60   if <bg> or <high-bg> not defined, than it is transparent
61   if <sh> or <high-sh> not defined, than it is no color
62  
63   bmp-timer  = <x>,<y>;<fg>,<bg>,<sh>
64
65 Details see lilo.conf(5).
66