'\" t
.\"     Title: SDL_StretchSurfaceRect
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 0.3.1
.\"    Manual: Manual Pages
.\"    Source: SDL_stretch
.\"  Language: English
.\"
.TH "SDL_STRETCHSURFACERE" "3" "0\&.3\&.1" "SDL_stretch" "Manual Pages"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SDL_StretchSurfaceRect \- Perform a stretch blit between two surfaces of the same format\&.
.SH "SYNOPSIS"
.sp
.ft B
.nf
 #include <SDL_stretch\&.h>
.fi
.ft
.HP \w'extern\ DECLSPEC\ int\ SDL_StretchSurfaceRect('u
.BI "extern DECLSPEC int SDL_StretchSurfaceRect(SDL_Surface\ *src, SDL_Rect\ *srcrect, SDL_Surface\ *dst, SDL_Rect\ *dstrect);"
.SH "DESCRIPTION"
.PP
NOTE:
\fBThe SDL_StretchSurfaceRect function\fR
is not safe to call from multiple threads!
.PP
\fBThe SDL_StretchSurfaceRect function\fR
will stretch a srcrect smoothly to the full area of the dst surface\&. If no srcrect is given then the full area of the src surface is stretched smoothly to the full dst surface\&. The dstrect is ignored always\&.
.PP
\fBThe SDL_StretchSurfaceRect function\fR
will also watch for a clip rectangle on the src surface\&. This may speed up handling in your programs by creating a larger src surface with an associated viewframe, and the srcrect argument needs not be recomputed\&.