Penguin
Recent Changes
Blame: SDL_BlitSurface(3)
EditPageHistoryDiffInfoLikePages
Annotated edit history of SDL_BlitSurface(3) version 2, including all changes. View license author blame.
Rev Author # Line
2 perry 1 SDL_!BlitSurface
2 !!!SDL_!BlitSurface
1 perry 3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 RETURN VALUE
7 SEE ALSO
8 ----
9 !!NAME
10
11
2 perry 12 SDL_!BlitSurface- This performs a fast blit from the source surface to the destination surface.
1 perry 13 !!SYNOPSIS
14
15
16 __#include __
17
18
2 perry 19 __int SDL_!BlitSurface__(__SDL_Surface *src, SDL_Rect
1 perry 20 *srcrect, SDL_Surface *dst, SDL_Rect
21 *dstrect__);
22 !!DESCRIPTION
23
24
25 This performs a fast blit from the source surface to the
26 destination surface.
27
28
29 Only the position is used in the __dstrect__ (the width
30 and height are ignored).
31
32
33 If either __srcrect__ or __dstrect__ are __NULL__,
34 the entire surface (__src__ or __dst__) is
35 copied.
36
37
38 The final blit rectangle is saved in __dstrect__ after
39 all clipping is performed (__srcrect__ is not
40 modified).
41
42
43 The blit function should not be called on a locked
44 surface.
45
46
47 __Note:__
48
49
50 The results of blitting operations vary greatly depending on
51 whether __SDL_SRCAPLHA__ is set or not. See
2 perry 52 ''SDL_!SetAlpha''.
1 perry 53 !!RETURN VALUE
54
55
56 If the blit is successful, it returns __0__, otherwise it
57 returns __-1__.
58
59
60 If either of the surfaces were in video memory, and the blit
61 returns __-2__, the video memory was lost, so it should
62 be reloaded with artwork and re-blitted:
63
64
2 perry 65 while ( SDL_!BlitSurface(image, imgrect, screen, dstrect) == -2 ) {
66 while ( SDL_!LockSurface(image))
1 perry 67 This happens under DirectX 5.0 when the system switches away from your fullscreen application. Locking the surface will also fail until you have access to the video memory again.
68 !!SEE ALSO
69
70
2 perry 71 __SDL_!LockSurface__, __SDL_!FillRect__,
1 perry 72 __SDL_Surface__, __SDL_Rect__
73 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.