File	Date	Author	Commit
adoc	2018-11-24	Sébastien Ballet	[d6683f] fixed a typo in adoc/read-me.txt and rebuild ./...
bitmaps	2018-11-24	Sébastien Ballet	[18f1cb] Initial commit.
LICENSE	2018-11-24	Sébastien Ballet	[18f1cb] Initial commit.
README	2018-11-24	Sébastien Ballet	[18f1cb] Initial commit.
lilo-slackware-theme.xcf	2018-11-24	Sébastien Ballet	[18f1cb] Initial commit.
read-me.html	2018-11-24	Sébastien Ballet	[d6683f] fixed a typo in adoc/read-me.txt and rebuild ./...
setlilobmp.1	2018-11-24	Sébastien Ballet	[18f1cb] Initial commit.
setlilobmp.sh	2018-11-24	Sébastien Ballet	[18f1cb] Initial commit.

Read Me

lilo-slackware-theme
====================

I. Presentation
   ------------
This lilo theme comes with 'setlilobmp' to ease setting Lilo 
background image, and, with the predefined bitmaps below which
are stored in /usr/share/lilo-slackware-theme :

  * Aurora-Borealis-From-Space
  * Bruegel_01_Christ_And_The_Apostles_At_The_Sea_Of_Tiberias_1553
  * Bruegel_02_Parable_Of_The_Sower_1557
  * Bruegel_03_Naval_Battle_In_The_Gulf_Of_Napless_1558
  * Bruegel_04_The_Fight_Between_Carnival_And_Lent_1559
  * Bruegel_05_The_Fall_Of_the_Rebel_Angels_1562
  * Bruegel_06_The_Suicide_Of_Saul_1562
  * Bruegel_07_The_Triumph_Of_Death_1562
  * Bruegel_08_The_Flight_Into_Egypt_1563
  * Bruegel_09_The_Tower_Of_Babel_1563_1565
  * Bruegel_10_The_Tower_Of_Babel_1563
  * Bruegel_11_The_Mill_And_The_Cross_1564
  * Bruegel_12_Gloomy_Day_1565
  * Bruegel_13_The_Hay_Harvest_1565
  * Bruegel_14_The_Corn_Harvest_1565
  * Bruegel_15_The_Hunters_In_The_Snow_1565
  * Bruegel_16_Massacre_Of_The_Innocents_1565_1567
  * Bruegel_17_The_Magpie_On_The_Gallows_1568
  * Colorado-Farms
  * Earth-From-Discovery
  * Earth-From-ISS
  * Evening
  * Geminid-Meteor-Shower
  * Green-Hills
  * Heart-Nebula
  * Horsehead-Nebula
  * Hurricane-Elena
  * Lake-Powell-n-Grand-Staircase-Escalante
  * Mars-Bending-Horizon
  * Mars-Olympus-Mons
  * North-Pole-From-Space
  * Space-Outer-Nature
  * Sunset-Shore


II. Setting lilo background
    -----------------------
The bitmap used by Lilo as background (on which a boot menu is 
displayed) can be set :

  * manually
  
  * with command 'setlilobmp'
  
  1. Setting Lilo background manually
     --------------------------------
  To manually set, for instance, the bitmap "Evening" as Lilo 
  background, proceed (as root) as below :
  
    * Copy the bitmap in +/boot+ :
       
      8<----------------------------------------------------------------
       $ cp /usr/share/lilo-slackware-theme/Evening/lilo-background.bmp \
            /boot
      8<----------------------------------------------------------------

    * Open /etc/lilo.conf. In the main section, add (or updates) the
      entries 'bitmap=', 'bmp-table=', 'bmp-colors=', 'bmp-timer=', 
      as shown below :
      
      8<----------------------------------------------------------------
       bitmap=/boot/lilo-background.bmp
       bmp-table=492p,8,1,16
       bmp-colors=255,33,,33,255,,
       bmp-timer=540p,460p,255,17,,
      8<----------------------------------------------------------------
      
      For more about these entries see point "IV. Notes about the
      entries bmp-table, bmp-colors and bmp-timer".
       
  2. Setting Lilo background with setlilobmp
     ---------------------------------------
  To set, for instance, the bitmap "Green-Hills" as Lilo background
  with command +setlilobmp+, proceed (as root) as in example below :

    8<----------------------------------------------------------------
     $ setlilobmp /usr/share/lilo-slackware-theme/Green-Hills
     setlilobmp ver. 2018.1123, (c) 2018 Sébastien Ballet

     Saves /etc/lilo.conf into /etc/lilo.conf.bak_181124_161043

     Cleans /etc/lilo.conf ...
       removed line #6: [bitmap=/boot/lilo-background.bmp]
       removed line #7: [bmp-table=492p,8,1,16...]
       removed line #8: [bmp-colors=255,132,,132,255,,...]
       removed line #9: [bmp-timer=540p,460p,255,107,,...]
     Done.

     Copies /usr/share/lilo-slackware-theme/Green-Hills/lilo-background.bmp to /boot/lilo-background.bmp ...
     Updates /etc/lilo.conf ...
       at #6, inserts [bitmap=/boot/lilo-background.bmp]
       at #7, inserts [bmp-table=492p,8,1,16]
       at #8, inserts [bmp-colors=255,132,,132,255,,]
       at #9, inserts [bmp-timer=540p,460p,255,107,,]
     Done.

     /etc/lilo.conf updated. Do not forget to run /sbin/lilo before reboot.
    8<----------------------------------------------------------------

    To prevent setlilobmp to make backup of +/etc/lilo.conf+, pass
    option +--no-backup+.

    To tell +setlilobmp+ to run the command +/sbin/lilo+ before
    exit, pass option +--run-lilo+.

    For more about +setlilobmp+, read the manual page.


III. How to create new bitmaps
     -------------------------
Other bitmaps can be generated using *GIMP* and the template 
lilo-slackware-theme.xcf (in /usr/doc/lilo-slackware-theme-<version>), 
which includes the following layers to ease construction of bitmaps
for Lilo :

  * Logo-Black
    ----------
    Contains the (Black) Slackware Logo in the upper left corner.
    
  * Logo-White
    ----------
    Contains the (White) Slackware Logo in the upper left corner.
    
  * Logo-BonW
    ---------
    Contains a Black on White Slackware Logo in the upper left corner.
    
  * Logo-WonB
    ---------
    Contains a White on Black Slackware Logo in the upper left corner.
    
  * OS-Selector(dark-cerulean) and Status Bar
    -----------------------------------------
    Contains the status bar and the panel in which Lilo will print the 
    list of available OSes.
    
  * Background-images
    -----------------
    Layer group for background images.
  
Lilo accepts only bitmaps to format *.bmp* in +16+ or +256+ colors. To 
export an image to format +.bmp+ with 16/256 colors with GIMP, proceed 
as below :

  * [Image] > [Mode] > [Indexed], then set the maximum number of 
    colors and click [Convert].

  * [File] > [Export] (or Shift+Ctrl+E), enter a *.bmp* filename,
    then in [Export image as BMP], drop down [Compatibility Options], 
    then check [Do not write color space information].


IV. Notes about entries bmp-table, bmp-colors and bmp-timer
    -------------------------------------------------------

  1. The entry 'bmp-table'
     ---------------------
  This entry defines the location and layout of the menu table. 
  
  In case of slackware theme, the table is at x=492 (pixel) and 
  y=8 (row) and has 1 column of 16 rows.
  
  2. The entry 'bmp-colors'
     ----------------------
  This entry defines the colors (foreground, background, shadow, 
  hi-foreground, hi-background, hi-shadow) used to prints OSes 
  entries in the boot selection table. 
  
  3. The entry 'bmp-timer'
     ---------------------
  This entry defines the position of the timeout timer and its 
  colors (foreground, background, shadow).
  
The color values in argument of bmp-colors and bmp-timer must be 
color indexes in the color table of the bitmap specified by entry
'bitmap='. 

For instance, in case of bitmap "Green-Hills", the colors used as 
foreground (#f9fdf8) and background(#461002) to prints OSes entries
are at indexes #255 and #33.

To display the color table of a .bmp image in GIMP : 
  
  [Windows] > [Dockable dialogs] > [colormap]


V. Credits
   -------
The predefined bitmaps in /usr/share/lilo-slackware-theme are
based on images found :

  * at commons.wikimedia.org/wiki/Pieter_Bruegel_(I) :
  
    + Bruegel_01_Christ_And_The_Apostles_At_The_Sea_Of_Tiberias_1553
    + Bruegel_02_Parable_Of_The_Sower_1557
    + Bruegel_03_Naval_Battle_In_The_Gulf_Of_Napless_1558
    + Bruegel_04_The_Fight_Between_Carnival_And_Lent_1559
    + Bruegel_05_The_Fall_Of_the_Rebel_Angels_1562
    + Bruegel_06_The_Suicide_Of_Saul_1562
    + Bruegel_07_The_Triumph_Of_Death_1562
    + Bruegel_08_The_Flight_Into_Egypt_1563
    + Bruegel_09_The_Tower_Of_Babel_1563_1565
    + Bruegel_10_The_Tower_Of_Babel_1563
    + Bruegel_11_The_Mill_And_The_Cross_1564
    + Bruegel_12_Gloomy_Day_1565
    + Bruegel_13_The_Hay_Harvest_1565
    + Bruegel_14_The_Corn_Harvest_1565
    + Bruegel_15_The_Hunters_In_The_Snow_1565
    + Bruegel_16_Massacre_Of_The_Innocents_1565_1567
    + Bruegel_17_The_Magpie_On_The_Gallows_1568

  * at www.nasa.gov/sites/default/files/thumbnails/image/iss048e073279_lrg.jpg :
    
    + Lake-Powell-n-Grand-Staircase-Escalante
    
  * from KDE 4.14.3 :
  
    + Colorado-Farms
    + Evening

  * at sevenentertainmentoflight.com/north-pole-from-space :
  
    + North-Pole-From-Space

  * at alamnature.com/wp-content/uploads/2016/05/Space-Nasa-Nice-Nature-Wallpapers-For-Mobile.jpg :
  
    + Space-Outer-Nature

  * at ravefinity.com :
  
    + Sunset-Shore

The source of other bitmaps not listed above is unknown.