.\"                                      Hey, EMACS: -*- nroff -*-.\" First parameter, NAME, should be all caps.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection.\" other parameters are allowed: see man(7), man(1).TH FBLOGO 1 "August 07, 2002".\" Please adjust this date whenever revising the manpage..\".\" Some roff macros, for reference:.\" .nh        disable hyphenation.\" .hy        enable hyphenation.\" .ad l      left justify.\" .ad b      justify to both left and right margins.\" .nf        disable filling.\" .fi        enable filling.\" .br        insert line break.\" .sp <n>    insert n+1 empty lines.\" for manpage-specific macros, see man(7).SH NAMEfblogo \- Converts images to framebuffer-logo header file.SH SYNOPSIS.B fblogo[-2] [-h] [-d] [-v] [\fIinputfile\fP [\fIoutputfile\fP]].SH DESCRIPTION.PP.\" TeX users may be more comfortable with the \fB<whatever>\fP and.\" \fI<whatever>\fP escape sequences to invode bold face and italics, .\" respectively.\fBfblogo\fP takes a png image as input and generates an appropriate linux_logo.h which can simply be included in the kernel. It will be displayed when the framebuffer device is enabled. You can also use it to generate full screen splash screens for the Linux Progress Patch..SH OPTIONS.TP.B -2, --linux-2.2Use this option to create a linux_logo.h suitable for 2.2.x kernels. By default, a 2.4.x/2.5.x - suitable linux_logo.h will be created.TP.B -4, --linux-2.4Create a linux_logo.h suitable for 2.4.x kernels (default)..TP.B -h, --helpDisplays a short help message.TP.B -v, --versionDisplay version string.TP.B -d, --verboseVerbose mode, give some feedback..TP.B \fIinputfile\fPThe input file, has to be a PNG with \fBless\fP than 224 colours. Ifomitted, stdin will be used..TP.B \fIoutputfile\fPThis will most likely be linux_logo.h, so you can simply replace the file in the linux source tree. If omitted, stdout will be used..SH REQUIREMENTSIn order to actually see the resulted logo at boot time, framebuffer-support needs to be enabled in the kernel..Tp.B CONFIG_EXPERIMENTAL=y.TP.B CONFIG_FB=y.TP.B CONFIG_FB_VESA=y - or whichever driver suits your graphics card..TPYou also need to tell the kernel to boot with the correct resolution, e.g. if you use lilo, specify a correct value for the vga-Parameter:.TP.B vga=791.TPThis will enable booting with a resolution of 1024x768 at 16bpp. See Documentation/fb/vesafb.txt in the linux source tree for more modes..SH USAGEGenerate a linux_logo.h using fblogo. This is actually the mostdifficult part, it is tough to get the colours looking good. The bestresults can be achieved by using netpbm or ImageMagick to do thequantization like so:.TP.B Using netpbm:.TPpngtopnm imagefile.png | ppmquant -fs 223 | pnmtopng | fblogo > linux_logo.h.TP.B Using ImageMagick:.TPconvert -colors 223 -dither <inputimage> <image>.png ; fblogo <image>.png linux_logo.h.TPPlace this file in include/linux/linux_logo.h.TPUpdate drivers/video/fbcon.c to reflect the new size of the logo:.TP#define LOGO_H                  80.TP#define LOGO_W                  80.TPIf you are going to compile a Linux 2.2 kernel, you have to do one additional step: .TPEdit the file linux/include/asm-<arch>/linux_logo.h and change to the correct LINUX_LOGO_COLORS to the right number, as pointed out when using -v or inside the linux_logo.h produced by fblogo..TPRecompile your new kernel..SH SEE ALSO.B fblogo_patch(1).SH AUTHORfblogo was originally written by Daniel Ved鴜 <daniel@kongsberg.online.no>, then adopted by Gordon Fraser <gordon@debian.org>. It is licensed under the terms of the GNU  General Public License.