.\" 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" "" "06 October 2005" "" ""

.SH NAME
fb_find_mode \- finds a valid video mode
.SH SYNOPSIS
"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.