.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "FB_FIND_MODE" "9" "17 July 2003" "" ""

.SH NAME
fb_find_mode \- finds a valid video mode
.SH SYNOPSIS
.sp
\fB
.sp
int __init fb_find_mode  (struct fb_var_screeninfo * \fIvar\fB, struct fb_info * \fIinfo\fB, const char * \fImode_option\fB, const struct fb_videomode * \fIdb\fB, unsigned int \fIdbsize\fB, const struct fb_videomode * \fIdefault_mode\fB, unsigned int \fIdefault_bpp\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIvar\fB\fR
frame buffer user defined part of display
.TP
\fB\fIinfo\fB\fR
frame buffer info structure
.TP
\fB\fImode_option\fB\fR
string video mode to find
.TP
\fB\fIdb\fB\fR
video mode database
.TP
\fB\fIdbsize\fB\fR
size of \fIdb\fR
.TP
\fB\fIdefault_mode\fB\fR
default video mode to fall back to
.TP
\fB\fIdefault_bpp\fB\fR
default color depth in bits per pixel
.SH "DESCRIPTION"
.PP
Finds a suitable video mode, starting with the specified mode
in \fImode_option\fR with fallback to \fIdefault_mode\fR.  If
\fIdefault_mode\fR fails, all modes in the video mode database will
be tried.
.PP
Valid mode specifiers for \fImode_option\fR:
.PP
<xres>x<yres>[-<bpp>][@<refresh>] or
<name>[-<bpp>][@<refresh>]
.PP
with <xres>, <yres>, <bpp> and <refresh> decimal numbers and
<name> a string.
.SH "NOTE"
.PP
The passed struct \fIvar\fR is _not_ cleared!  This allows you
to supply values for e.g. the grayscale and accel_flags fields.
.PP
Returns zero for failure, 1 if using specified \fImode_option\fR,
2 if using specified \fImode_option\fR with an ignored refresh rate,
3 if default mode is used, 4 if fall back to any valid mode.
.SH "ABOUT THIS DOCUMENT"
.PP
This documentation is free software; you can redistribute
it and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later
version.
.PP
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.
.PP
You should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
MA 02111-1307 USA
.PP
For more details see the file COPYING in the source
distribution of Linux.
.PP
If you have comments on the formatting of this manpage, then please contact
Michael Still (mikal@stillhq.com).
.PP
This documentation was generated with kernel version 2.5.71.