ksplash-readme.txt for the Debian theme proposal "The Journey".
Written by: uhansen@debianart.org, 01.03.2012
--------------------------------

File: 
journey-ksplash.tar.gz

This archive contains the KSplash files of the Debian GNU/Linux theme.
The content:

/journey
/journey/1024x768/
/journey/1024x768/background.png     --- 4:3 background picture
/journey/1280x1024/
/journey/1280x1024/background.png    --- 5:4 background picture
/journey/1366x768/
/journey/1366x768/background.png     --- 16:9 background picture
/journey/1600x1200/
/journey/1600x1200/background.png    --- 4:3 background picture
/journey/1600x1200/description.txt   --- Configuration file for the splash animation
/journey/1600x1200/icon1_anim.png    --- Animated harddisk symbol
/journey/1600x1200/icon1.png		 --- harddisk symbol
/journey/1600x1200/icon2_anim.png    --- Animated tool symbol
/journey/1600x1200/icon2.png		 --- tool symbol
/journey/1600x1200/icon3_anim.png    --- Animated network symbol
/journey/1600x1200/icon3.png		 --- network symbol
/journey/1600x1200/icon4_anim.png    --- Animated desktop symbol
/journey/1600x1200/icon4.png		 --- desktop symbol
/journey/1600x1200/icon5_anim.png    --- Animated KDE logo
/journey/1600x1200/icon5.png		 --- KDE logo
/journey/1600x1200/rectangle.png     --- background for animations
/journey/1920x1080/
/journey/1920x1080/background.png    --- 16:9 background picture
/journey/1920x1200/
/journey/1920x1200/background.png    --- 16:10 background picture
/journey/600x400/
/journey/600x400/background.png      --- 3:2 background picture
/journey/800x600/
/journey/800x600/background.png      --- 4:3 background picture
/journey/Preview.png			     --- Preview picture
/journey/Theme.rc				     --- Information about the theme


--------------------------------

Intended location in the filesystem:

Unzip the archive
tar -xzvf journey-ksplash.tar.gz

Copy the folder "journey" to
/usr/share/kde4/apps/ksplash/Themes/journey

--------------------------------

Intended location in the desktop-base source package:

Unzip the archive
tar -xzvf journey-ksplash.tar.gz

Copy the folder "journey" to
/ksplash-theme/journey



CONFIGURATION:
--------------

The KSPlash theme is set by Debian in:

/usr/share/desktop-base/profiles/kde-profile/share/config/ksplashrc
(/profiles/kde-profile/share/config/kspashrc in the source package)

ksplashrc should have these lines:

[KSplash]
Theme=journey

The second line selects the "journey" theme from the various themes at
/usr/share/kde4/apps/ksplash/Themes/

Every theme consists of images in several resolutions, which must be placed in subfolders named after the resolution. The "1600x1200" folder also contains the .png images for the splash screen animations and the file "description.txt". This file controls the appearance of the splashscreen.

An explanation of "description.txt" can be found here:
http://websvn.kde.org/*checkout*/branches/KDE/4.4/kdebase/workspace/ksplash/ksplashx/README

In theory KSplash now detects the correct resolution and selects a fitting background image from the subfolders.

If you change the KSplash screen, it may be helpful to erase the cache files first.

They are located here:
/var/tmp/kdecache-$user/
or (as symlink) here:
/home/.kde/cache-debian/

KSPlashX will be replaced by Qt quick splash screens in near future.