Penguin
Recent Changes
Blame: SDL_SetVideoMode(3)
EditPageHistoryDiffInfoLikePages
Annotated edit history of SDL_SetVideoMode(3) version 2, including all changes. View license author blame.
Rev Author # Line
2 perry 1 SDL_!SetVideoMode
2 !!!SDL_!SetVideoMode
1 perry 3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 RETURN VALUE
7 SEE ALSO
8 ----
9 !!NAME
10
11
2 perry 12 SDL_!SetVideoMode- Set up a video mode with the specified width, height and bits-per-pixel.
1 perry 13 !!SYNOPSIS
14
15
16 __#include __
17
18
2 perry 19 __SDL_Surface *SDL_!SetVideoMode__(__int width, int
1 perry 20 height, int bpp, Uint32 flags__);
21 !!DESCRIPTION
22
23
24 Set up a video mode with the specified width, height and
25 bits-per-pixel.
26
27
28 If __bpp__ is 0, it is treated as the current display
29 bits per pixel.
30
31
32 The __flags__ parameter is the same as the __flags__
33 field of the __SDL_Surface__ structure. OR'd combinations
34 of the following values are valid.
35
36
37 __SDL_SWSURFACE__
38
39
40 Create the video surface in system memory
41
42
43 __SDL_HWSURFACE__
44
45
46 Create the video surface in video memory
47
48
49 __SDL_ASYNCBLIT__
50
51
52 Enables the use of asynchronous to the display surface. This
53 will usually slow down blitting on single CPU machines, but
54 may provide a speed increase on SMP systems.
55
56
57 __SDL_ANYFORMAT__
58
59
60 Normally, if a video surface of the requested depth
61 (__bpp__) is not available, SDL will emulate one with a
62 shadow surface. Passing __SDL_ANYFORMAT__ prevents this
63 and causes SDL to use the video surface, regardless of its
64 depth.
65
66
67 __SDL_HWPALETTE__
68
69
70 Give SDL exclusive palette access. Without this flag you may
71 not always get the the colors you request with
2 perry 72 __SDL_!SetColors__.
1 perry 73
74
75 __SDL_DOUBLEBUF__
76
77
78 Enable double buffering. Calling __SDL_Flip__ will flip
79 the buffers and update the screen. If double buffering could
80 not be enabled then __SDL_Flip__ will just perform a
2 perry 81 __SDL_!UpdateRect__ on the entire screen.
1 perry 82
83
84 __SDL_FULLSCREEN__
85
86
87 SDL will attempt to use a fullscreen mode
88
89
90 __SDL_OPENGL__ Create an OpenGL rendering context. You
91 should have previously set OpenGL video attributes with
2 perry 92 __SDL_GL_!SetAttribute__.
1 perry 93
94
95 __SDL_OPENGLBLIT__
96
97
98 Create an OpenGL rendering context, like above, but allow
99 normal blitting operations.
100
101
102 __SDL_RESIZABLE__
103
104
105 Create a resizable window. When the window is resized by the
106 user a __SDL_VIDEORESIZE__ event is generated and
2 perry 107 __SDL_!SetVideoMode__ can be called again with the new
1 perry 108 size.
109
110
111 __Note:__
112
113
2 perry 114 Whatever __flags SDL_!SetVideoMode__ could satisfy are set
1 perry 115 in the __flags__ member of the returned
116 surface.
117 !!RETURN VALUE
118
119
120 The framebuffer surface, or __NULL__ if it
121 fails.
122 !!SEE ALSO
123
124
2 perry 125 __SDL_!LockSurface__, __SDL_!SetColors__,
1 perry 126 __SDL_Flip__, __SDL_Surface__
127 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.