fblogo.1

arm-linux下

.\"                                      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 NAME
fblogo \- 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.2
Use 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.4
Create a linux_logo.h suitable for 2.4.x kernels (default).
.TP
.B -h, --help
Displays a short help message
.TP
.B -v, --version
Display version string
.TP
.B -d, --verbose
Verbose mode, give some feedback.
.TP
.B \fIinputfile\fP
The input file, has to be a PNG with \fBless\fP than 224 colours. If
omitted, stdin will be used.
.TP
.B \fIoutputfile\fP
This 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 REQUIREMENTS
In 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.
.TP
You 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
.TP
This will enable booting with a resolution of 1024x768 at 16bpp. See Documentation/fb/vesafb.txt in the linux source tree for more modes.
.SH USAGE
Generate a linux_logo.h using fblogo. This is actually the most
difficult part, it is tough to get the colours looking good. The best
results can be achieved by using netpbm or ImageMagick to do the
quantization like so:
.TP
.B Using netpbm:
.TP
pngtopnm imagefile.png | ppmquant -fs 223 | pnmtopng | fblogo > linux_logo.h
.TP
.B Using ImageMagick:
.TP
convert -colors 223 -dither <inputimage> <image>.png ; fblogo <image>.png linux_logo.h

.TP
Place this file in include/linux/linux_logo.h
.TP
Update drivers/video/fbcon.c to reflect the new size of the logo:
.TP
#define LOGO_H                  80
.TP
#define LOGO_W                  80
.TP
If you are going to compile a Linux 2.2 kernel, you have to do one additional step: 
.TP
Edit 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.
.TP
Recompile your new kernel.
.SH SEE ALSO
.B fblogo_patch
(1)

.SH AUTHOR
fblogo was originally written by Daniel Ved鴜 <[e-mail]>, then adopted by Gordon Fraser <[e-mail]>. It is licensed under the terms of the GNU  General Public License.