File Coverage

lib/SDL2/FFI.pm

Criterion	Covered	Total	%
statement	256	301	85.0
branch			n/a
condition	2	3	66.6
subroutine	85	95	89.4
pod	0	5	0.0
total	343	404	84.9

line	stmt	cond	sub	pod	time	code
1						package SDL2::FFI 0.05 {
2	2		2		526474	use lib '../lib', 'lib';
	2				14
	2				12
3
4						# ABSTRACT: FFI Wrapper for SDL (Simple DirectMedia Layer) Development Library
5	2		2		1619	use strictures 2;
	2				3743
	2				100
6	2		2		1871	use experimental 'signatures';
	2				8029
	2				18
7	2		2		446	use base 'Exporter::Tiny';
	2				4
	2				1359
8	2		2		8318	use SDL2::Utils;
	2				20
	2				33
9	2		2		1381	use Config;
	2				7
	2				402
10	4	66	4	0	16	sub bigendian () { CORE::state $bigendian //= ( $Config{byteorder} != 4321 ); $bigendian }
	4				7
	4				154
	4				232
11						our %EXPORT_TAGS;
12
13						# I need these first
14						attach version => { SDL_GetVersion => [ ['SDL_version'] ] };
15						#
16						SDL_GetVersion( my $ver = SDL2::version->new() );
17						my $platform = $^O; # https://perldoc.perl.org/perlport#PLATFORMS
18						my $Windows = !!( $platform eq 'MSWin32' );
19						#
20	2		2		991	use SDL2::version;
	2				6
	2				87
21	2		2		2281	use SDL2::Enum;
	2				11
	2				190
22	2		2		1206	use SDL2::AudioCVT;
	2				8
	2				122
23	2		2		1022	use SDL2::AudioSpec;
	2				9
	2				113
24	2		2		1062	use SDL2::Event; # Includes all known events
	2				59
	2				82
25	2		2		819	use SDL2::Point;
	2				5
	2				107
26	2		2		710	use SDL2::FPoint;
	2				4
	2				76
27	2		2		700	use SDL2::FRect;
	2				6
	2				64
28	2		2		703	use SDL2::Rect;
	2				39
	2				71
29	2		2		737	use SDL2::DisplayMode;
	2				6
	2				72
30	2		2		730	use SDL2::Surface;
	2				6
	2				68
31	2		2		747	use SDL2::Window;
	2				10
	2				124
32	2		2		1143	use SDL2::WindowShaper;
	2				8
	2				121
33	2		2		911	use SDL2::Texture;
	2				6
	2				67
34	2		2		792	use SDL2::Renderer;
	2				5
	2				67
35	2		2		796	use SDL2::RendererInfo;
	2				6
	2				120
36	2		2		997	use SDL2::GameControllerButtonBind;
	2				6
	2				84
37	2		2		1147	use SDL2::HapticDirection;
	2				6
	2				89
38	2		2		881	use SDL2::HapticEffect;
	2				8
	2				102
39	2		2		930	use SDL2::Joystick;
	2				7
	2				66
40	2		2		774	use SDL2::JoystickGUID;
	2				5
	2				79
41	2		2		16	use SDL2::Keysym;
	2				3
	2				51
42	2		2		810	use SDL2::Locale;
	2				8
	2				93
43	2		2		878	use SDL2::MessageBoxData;
	2				9
	2				99
44	2		2		959	use SDL2::MetalView;
	2				7
	2				71
45	2		2		827	use SDL2::Mutex;
	2				6
	2				69
46	2		2		813	use SDL2::Semaphore;
	2				6
	2				72
47	2		2		795	use SDL2::Cond;
	2				6
	2				62
48	2		2		774	use SDL2::Color;
	2				7
	2				85
49	2		2		910	use SDL2::Palette;
	2				6
	2				143
50	2		2		882	use SDL2::PixelFormat;
	2				7
	2				126
51						#
52	2		2		1594	use Data::Dump;
	2				11517
	2				1945
53
54						# https://github.com/libsdl-org/SDL/blob/main/include/SDL.h
55						push @{ $EXPORT_TAGS{default} }, qw[:init];
56						attach init => {
57						SDL_Init => [ ['uint32'] => 'int' ],
58						SDL_InitSubSystem => [ ['uint32'] => 'int' ],
59						SDL_Quit => [ [] ],
60						SDL_QuitSubSystem => [ ['uint32'] ],
61						SDL_WasInit => [ ['uint32'] => 'uint32' ]
62						};
63						#
64						ffi->type( '(opaque,string,string,string)->void' => 'SDL_HintCallback' );
65						attach hints => {
66						SDL_SetHintWithPriority => [ [ 'string', 'string', 'int' ] => 'bool' ],
67						SDL_SetHint => [ [ 'string', 'string' ] => 'bool' ],
68						SDL_GetHint => [ ['string'] => 'string' ],
69						$ver->patch >= 5 ? ( SDL_GetHintBoolean => [ [ 'string', 'bool' ] => 'bool' ] ) : (),
70						SDL_AddHintCallback => [
71						[ 'string', 'SDL_HintCallback', 'opaque' ] => 'void' =>
72						sub ( $xsub, $name, $callback, $userdata ) { # Fake void pointer
73						my $cb = FFI::Platypus::Closure->new(
74						sub ( $ptr, @etc ) { $callback->( $userdata, @etc ) } );
75						$cb->sticky;
76						$xsub->( $name, $cb, $userdata );
77						return $cb;
78						}
79						],
80						SDL_DelHintCallback => [
81						[ 'string', 'SDL_HintCallback', 'opaque' ] => 'void' =>
82						sub ( $xsub, $name, $callback, $userdata ) { # Fake void pointer
83						my $cb = $callback;
84						$cb->unstick;
85						$xsub->( $name, $cb, $userdata );
86						return $cb;
87						}
88						],
89						SDL_ClearHints => [ [] => 'void' ],
90						},
91						error => {
92						SDL_SetError => [
93						['string'] => 'int' =>
94						sub ( $inner, $fmt, @params ) { $inner->( sprintf( $fmt, @params ) ); }
95						],
96						SDL_GetError => [ [] => 'string' ],
97						SDL_GetErrorMsg => [
98						[ 'string', 'int' ] => 'string' => sub ( $inner, $errstr, $maxlen = length $errstr ) {
99						$_[1] = ' ' x $maxlen if !defined $_[1] \|\| length $errstr != $maxlen;
100						$inner->( $_[1], $maxlen );
101						}
102						],
103						SDL_ClearError => [ [] => 'void' ]
104						};
105						ffi->type( '(opaque,int,int,string)->void' => 'SDL_LogOutputFunction' );
106						attach log => {
107						SDL_LogSetAllPriority => [ ['SDL_LogPriority'] ],
108						SDL_LogSetPriority => [ [ 'SDL_LogCategory', 'SDL_LogPriority' ] ],
109						SDL_LogGetPriority => [ ['SDL_LogCategory'] => 'SDL_LogPriority' ],
110						SDL_LogResetPriorities => [ [] ],
111						SDL_Log => [
112						['string'] => 'string' =>
113						sub ( $inner, $fmt, @args ) { $inner->( sprintf( $fmt, @args ) ) }
114						],
115						SDL_LogVerbose => => [
116						[ 'SDL_LogCategory', 'string' ] => sub ( $inner, $category, $fmt, @args ) {
117						$inner->( $category, sprintf( $fmt, @args ) );
118						}
119						],
120						SDL_LogDebug => => [
121						[ 'SDL_LogCategory', 'string' ] => sub ( $inner, $category, $fmt, @args ) {
122						$inner->( $category, sprintf( $fmt, @args ) );
123						}
124						],
125						SDL_LogInfo => => [
126						[ 'SDL_LogCategory', 'string' ] => sub ( $inner, $category, $fmt, @args ) {
127						$inner->( $category, sprintf( $fmt, @args ) );
128						}
129						],
130						SDL_LogWarn => => [
131						[ 'SDL_LogCategory', 'string' ] => sub ( $inner, $category, $fmt, @args ) {
132						$inner->( $category, sprintf( $fmt, @args ) );
133						}
134						],
135						SDL_LogError => => [
136						[ 'SDL_LogCategory', 'string' ] => sub ( $inner, $category, $fmt, @args ) {
137						$inner->( $category, sprintf( $fmt, @args ) );
138						}
139						],
140						SDL_LogCritical => => [
141						[ 'SDL_LogCategory', 'string' ] => sub ( $inner, $category, $fmt, @args ) {
142						$inner->( $category, sprintf( $fmt, @args ) );
143						}
144						],
145						SDL_LogMessage => [
146						[ 'SDL_LogCategory', 'SDL_LogPriority', 'string' ] =>
147						sub ( $inner, $category, $priority, $fmt, @args ) {
148						$inner->( $category, $priority, sprintf( $fmt, @args ) );
149						}
150						],
151
152						# TODO
153						SDL_LogGetOutputFunction => [ [ 'SDL_LogOutputFunction', 'opaque' ] ],
154						SDL_LogSetOutputFunction => [
155						[ 'SDL_LogOutputFunction', 'opaque' ] => 'void' => sub ( $xsub, $callback, $userdata )
156						{ # Fake void pointer
157						my $cb = FFI::Platypus::Closure->new(
158						sub ( $ptr, @etc ) { $callback->( $userdata, @etc ) } );
159						$cb->sticky;
160						$xsub->( $cb, $userdata );
161						return $cb;
162						}
163						]
164						};
165						#
166						package SDL2::AssertData {
167	2		2		22	use SDL2::Utils;
	2				4
	2				24
168						has
169						always_ignore => 'int',
170						trigger_count => 'uint',
171						condition => 'opaque', # string
172						filename => 'opaque', # string
173						linenum => 'int',
174						function => 'opaque', # string
175						next => 'opaque' # const struct SDL_AssertData *next
176						};
177						attach assert => {
178						SDL_ReportAssertion => [ [ 'opaque', 'string', 'string', 'int' ], 'opaque' ],
179						SDL_GetAssertionReport => [ ['SDL_AssertData'] ],
180						};
181						FFI::C::ArrayDef->new( # Used sparingly when I need to pass a list of SDL_Point objects
182						ffi,
183						name => 'SDL2x_PointList',
184						class => 'SDL2x::PointList',
185						members => ['SDL_Point'],
186						);
187						FFI::C::ArrayDef->new( # Used sparingly when I need to pass a list of SDL_Point objects
188						ffi,
189						name => 'SDL2x_FPointList',
190						class => 'SDL2x::FPointList',
191						members => ['SDL_Point'],
192						);
193						FFI::C::ArrayDef->new( # Used sparingly when I need to pass a list of SDL_Rect objects
194						ffi,
195						name => 'SDL2x_RectList',
196						class => 'SDL2x::RectList',
197						members => ['SDL_Rect'],
198						);
199						FFI::C::ArrayDef->new( # Used sparingly when I need to pass a list of SDL_Rect objects
200						ffi,
201						name => 'SDL2x_FRectList',
202						class => 'SDL2x::FRectList',
203						members => ['SDL_FRect'],
204						);
205						#
206						ffi->type( '(opaque,opaque,opaque)->int' => 'SDL_HitTest' );
207
208						# An opaque handle to an OpenGL context.
209	2		2		1646	package SDL2::GLContext { use SDL2::Utils; has() };
	2				4
	2				11
210						attach video => {
211						SDL_GetNumVideoDrivers => [ [], 'int' ],
212						SDL_GetVideoDriver => [ ['int'], 'string' ],
213						SDL_VideoInit => [ ['string'], 'int' ],
214						SDL_VideoQuit => [ [] ],
215						SDL_GetCurrentVideoDriver => [ [], 'string' ],
216						SDL_GetNumVideoDisplays => [ [], 'int' ],
217						SDL_GetDisplayName => [ ['int'], 'string' ],
218						SDL_GetDisplayBounds => [ [ 'int', 'SDL_Rect' ], 'int' ],
219						SDL_GetDisplayUsableBounds => [ [ 'int', 'SDL_Rect' ], 'int' ],
220						SDL_GetDisplayDPI => [ [ 'int', 'float ', 'float ', 'float *' ], 'int' ],
221						SDL_GetDisplayOrientation => [ ['int'], 'int' ],
222						SDL_GetNumDisplayModes => [ ['int'], 'int' ],
223						SDL_GetDisplayMode => [ [ 'int', 'int', 'SDL_DisplayMode' ], 'int' ],
224						SDL_GetDesktopDisplayMode => [ [ 'int', 'SDL_DisplayMode' ], 'int' ],
225						SDL_GetCurrentDisplayMode => [ [ 'int', 'SDL_DisplayMode' ], 'int' ],
226						SDL_GetClosestDisplayMode => [ [ 'int', 'SDL_DisplayMode', 'SDL_DisplayMode' ], 'opaque' ],
227						SDL_GetWindowDisplayIndex => [ ['SDL_Window'], 'int' ],
228						SDL_SetWindowDisplayMode => [ [ 'SDL_Window', 'SDL_DisplayMode' ], 'int' ],
229						SDL_GetWindowDisplayMode => [ [ 'SDL_Window', 'SDL_DisplayMode' ], 'int' ],
230						SDL_GetWindowPixelFormat => [ ['SDL_Window'], 'uint32' ],
231						SDL_CreateWindow => [ [ 'string', 'int', 'int', 'int', 'int', 'uint32' ] => 'SDL_Window' ],
232						SDL_CreateWindowFrom => [ ['opaque'] => 'SDL_Window' ],
233						SDL_GetWindowID => [ ['SDL_Window'] => 'uint32' ],
234						SDL_GetWindowFromID => [ ['uint32'] => 'SDL_Window' ],
235						SDL_GetWindowFlags => [ ['SDL_Window'] => 'uint32' ],
236						SDL_SetWindowTitle => [ [ 'SDL_Window', 'string' ] ],
237						SDL_GetWindowTitle => [ ['SDL_Window'], 'string' ],
238						SDL_SetWindowIcon => [ [ 'SDL_Window', 'SDL_Surface' ] ],
239
240						# These don't work correctly yet. (cast issues)
241						SDL_SetWindowData => [ [ 'SDL_Window', 'string', 'opaque' ], 'opaque' ],
242						SDL_GetWindowData => [ [ 'SDL_Window', 'string' ], 'opaque*' ],
243						SDL_SetWindowPosition => [ [ 'SDL_Window', 'int', 'int' ] ],
244						SDL_GetWindowPosition => [ [ 'SDL_Window', 'int', 'int' ] ],
245						SDL_SetWindowSize => [ [ 'SDL_Window', 'int', 'int' ] ],
246						SDL_GetWindowSize => [ [ 'SDL_Window', 'int', 'int' ] ],
247						SDL_GetWindowBordersSize => [ [ 'SDL_Window', 'int', 'int', 'int', 'int' ], 'int' ],
248						SDL_SetWindowMinimumSize => [ [ 'SDL_Window', 'int', 'int' ] ],
249						SDL_GetWindowMinimumSize => [ [ 'SDL_Window', 'int', 'int' ] ],
250						SDL_SetWindowMaximumSize => [ [ 'SDL_Window', 'int', 'int' ] ],
251						SDL_GetWindowMaximumSize => [ [ 'SDL_Window', 'int', 'int' ] ],
252						SDL_SetWindowBordered => [ [ 'SDL_Window', 'bool' ] ],
253						SDL_SetWindowResizable => [ [ 'SDL_Window', 'bool' ] ],
254						SDL_ShowWindow => [ ['SDL_Window'] ],
255						SDL_HideWindow => [ ['SDL_Window'] ],
256						SDL_RaiseWindow => [ ['SDL_Window'] ],
257						SDL_MaximizeWindow => [ ['SDL_Window'] ],
258						SDL_MinimizeWindow => [ ['SDL_Window'] ],
259						SDL_RestoreWindow => [ ['SDL_Window'] ],
260						SDL_SetWindowFullscreen => [ [ 'SDL_Window', 'uint32' ], 'int' ],
261						SDL_GetWindowSurface => [ ['SDL_Window'], 'SDL_Surface' ],
262						SDL_UpdateWindowSurface => [ ['SDL_Window'], 'int' ],
263						SDL_UpdateWindowSurfaceRects => [ [ 'SDL_Window', 'opaque*', 'int' ], 'int' ],
264						SDL_SetWindowGrab => [ [ 'SDL_Window', 'bool' ] ],
265						( $ver->patch >= 15 ? ( SDL_SetWindowKeyboardGrab => [ [ 'SDL_Window', 'bool' ] ] ) : () ),
266						( $ver->patch >= 15 ? ( SDL_SetWindowMouseGrab => [ [ 'SDL_Window', 'bool' ] ] ) : () ),
267						SDL_GetWindowGrab => [ ['SDL_Window'], 'bool' ],
268						( $ver->patch >= 15 ? ( SDL_GetWindowKeyboardGrab => [ ['SDL_Window'], 'bool' ] ) : () ),
269						( $ver->patch >= 15 ? ( SDL_GetWindowMouseGrab => [ ['SDL_Window'], 'bool' ] ) : () ),
270						SDL_GetGrabbedWindow => [ [], 'SDL_Window' ],
271						SDL_SetWindowBrightness => [ [ 'SDL_Window', 'float' ], 'int' ],
272						SDL_GetWindowBrightness => [ ['SDL_Window'], 'float' ],
273						SDL_SetWindowOpacity => [ [ 'SDL_Window', 'float' ], 'int' ],
274						SDL_GetWindowOpacity => [ [ 'SDL_Window', 'float*' ], 'int' ],
275						SDL_SetWindowModalFor => [ [ 'SDL_Window', 'SDL_Window' ], 'int' ],
276						SDL_SetWindowInputFocus => [ ['SDL_Window'], 'int' ],
277						SDL_SetWindowGammaRamp =>
278						[ [ 'SDL_Window', 'uint32[256]', 'uint32[256]', 'uint32[256]' ], 'int' ],
279						SDL_GetWindowGammaRamp => [
280						[ 'SDL_Window', 'uint32[256]', 'uint32[256]', 'uint32[256]' ], 'int'
281
282						#=> sub ( $inner, $window ) {
283						# my @red = my @blue = my @green = map { \0 } 1 .. 256;
284						# my $ok = $inner->( $window, \@red, \@green, \@blue );
285						# $ok == 0 ? ( \@red, \@green, \@blue ) : $ok;
286						#}
287						],
288						SDL_SetWindowHitTest => [
289						[ 'SDL_Window', 'SDL_HitTest', 'opaque' ],
290						'int' => sub ( $xsub, $window, $callback, $callback_data = () ) { # Fake void pointer
291						my $cb = $callback;
292						if ( defined $callback ) {
293						$cb = FFI::Platypus::Closure->new(
294						sub ( $win, $area, $data ) {
295						$callback->(
296						ffi->cast( 'opaque' => 'SDL_Window', $win ),
297						ffi->cast( 'opaque' => 'SDL_Point', $area ),
298						$callback_data
299						);
300						}
301						);
302						$cb->sticky;
303						}
304						$xsub->( $window, $cb, $callback_data );
305						return $cb;
306						}
307						],
308						( $ver->patch >= 15 ? ( SDL_FlashWindow => [ [ 'SDL_Window', 'uint32' ], 'int' ] ) : () ),
309						SDL_DestroyWindow => [ ['SDL_Window'] ],
310						SDL_IsScreenSaverEnabled => [ [], 'bool' ],
311						SDL_EnableScreenSaver => [ [] ],
312						SDL_DisableScreenSaver => [ [] ],
313						},
314						opengl => {
315						SDL_GL_LoadLibrary => [ ['string'], 'int' ],
316						SDL_GL_GetProcAddress => [ ['string'], 'opaque' ],
317						SDL_GL_UnloadLibrary => [ [] ],
318						SDL_GL_ExtensionSupported => [ ['string'], 'bool' ],
319						SDL_GL_ResetAttributes => [ [] ],
320						SDL_GL_SetAttribute => [ [ 'SDL_GLattr', 'int' ], 'int' ],
321						SDL_GL_GetAttribute => [ [ 'SDL_GLattr', 'int*' ], 'int' ],
322						SDL_GL_CreateContext => [ ['SDL_Window'], 'SDL_GLContext' ],
323						SDL_GL_MakeCurrent => [ [ 'SDL_Window', 'SDL_GLContext' ], 'int' ],
324						SDL_GL_GetCurrentWindow => [ [], 'SDL_Window' ],
325						SDL_GL_GetCurrentContext => [ [], 'SDL_GLContext' ],
326						SDL_GL_GetDrawableSize => [ [ 'SDL_Window', 'int', 'int' ], ],
327						SDL_GL_SetSwapInterval => [ ['int'], 'int' ],
328						SDL_GL_GetSwapInterval => [ [], 'int' ],
329						SDL_GL_SwapWindow => [ ['SDL_Window'] ],
330						SDL_GL_DeleteContext => [ ['SDL_GLContext'] ]
331						};
332						attach render => {
333						SDL_GetNumRenderDrivers => [ [], 'int' ],
334						SDL_GetRenderDriverInfo => [ [ 'int', 'SDL_RendererInfo' ], 'int' ],
335						SDL_CreateWindowAndRenderer => [
336						[ 'int', 'int', 'uint32', 'opaque', 'opaque' ], 'int'
337
338						#=> sub ( $inner, $width, $height, $window_flags ) {
339						# my $window = SDL2::Window->new;
340						# my $renderer = SDL2::Renderer->new;
341						# my $ok = $inner->( $width, $height, $window_flags, \$window, \$renderer );
342						# $ok == 0 ? (
343						# ffi->cast( 'opaque' => 'SDL_Window', $window ),
344						# ffi->cast( 'opaque' => 'SDL_Renderer', $renderer ),
345						# ) :
346						# $ok;
347						#}
348						],
349						SDL_CreateRenderer => [ [ 'SDL_Window', 'int', 'uint32' ], 'SDL_Renderer' ],
350						SDL_CreateSoftwareRenderer => [ ['SDL_Surface'], 'SDL_Renderer' ],
351						SDL_GetRenderer => [ ['SDL_Window'], 'SDL_Renderer' ],
352						SDL_GetRendererInfo => [ [ 'SDL_Renderer', 'SDL_RendererInfo' ], 'int' ],
353						SDL_GetRendererOutputSize => [ [ 'SDL_Renderer', 'int', 'int' ], 'int' ],
354						SDL_CreateTexture => [ [ 'SDL_Renderer', 'uint32', 'int', 'int', 'int' ], 'SDL_Texture' ],
355						SDL_CreateTextureFromSurface => [ [ 'SDL_Renderer', 'SDL_Surface' ], 'SDL_Texture' ],
356						SDL_QueryTexture => [ [ 'SDL_Texture', 'uint32', 'int', 'int', 'int' ], 'int' ],
357						SDL_SetTextureColorMod => [ [ 'SDL_Texture', 'uint8', 'uint8', 'uint8' ], 'int' ],
358						SDL_GetTextureColorMod => [ [ 'SDL_Texture', 'uint8', 'uint8', 'uint8*' ], 'int' ],
359						SDL_SetTextureAlphaMod => [ [ 'SDL_Texture', 'uint8' ], 'int' ],
360						SDL_GetTextureAlphaMod => [ [ 'SDL_Texture', 'uint8*' ], 'int' ],
361						SDL_SetTextureBlendMode => [ [ 'SDL_Texture', 'SDL_BlendMode' ], 'int' ],
362						SDL_GetTextureBlendMode => [ [ 'SDL_Texture', 'int*' ], 'int' ],
363						SDL_UpdateTexture => [ [ 'SDL_Texture', 'SDL_Rect', 'opaque*', 'int' ], 'int' ],
364						SDL_UpdateYUVTexture => [
365						[ 'SDL_Texture', 'SDL_Rect', 'uint8', 'int', 'uint8', 'int', 'uint8*', 'int' ], 'int'
366						], (
367						$ver->patch >= 15 ?
368						( SDL_UpdateNVTexture =>
369						[ [ 'SDL_Texture', 'SDL_Rect', 'uint8', 'int', 'uint8', 'int' ], 'int' ] ) :
370						()
371						),
372						SDL_LockTexture => [ [ 'SDL_Texture', 'SDL_Rect', 'opaque*' ], 'int' ],
373						SDL_LockTextureToSurface => [ [ 'SDL_Texture', 'SDL_Rect', 'SDL_Surface' ], 'int' ],
374						SDL_UnlockTexture => [ ['SDL_Texture'] ],
375						SDL_RenderTargetSupported => [ ['SDL_Renderer'], 'bool' ],
376						SDL_SetRenderTarget => [ [ 'SDL_Renderer', 'SDL_Texture' ], 'int' ],
377						SDL_GetRenderTarget => [ ['SDL_Renderer'], 'SDL_Texture' ],
378						SDL_RenderSetLogicalSize => [ [ 'SDL_Renderer', 'int', 'int' ], 'int' ],
379						SDL_RenderGetLogicalSize => [ [ 'SDL_Renderer', 'int', 'int' ], 'int' ],
380						SDL_RenderSetIntegerScale => [ [ 'SDL_Renderer', 'bool' ], 'int' ],
381						SDL_RenderGetIntegerScale => [ ['SDL_Renderer'], 'bool' ],
382						SDL_RenderSetViewport => [ [ 'SDL_Renderer', 'SDL_Rect' ], 'int' ],
383						SDL_RenderGetViewport => [ [ 'SDL_Renderer', 'SDL_Rect' ], 'int' ],
384						SDL_RenderSetClipRect => [ [ 'SDL_Renderer', 'SDL_Rect' ], 'int' ],
385						SDL_RenderGetClipRect => [ [ 'SDL_Renderer', 'SDL_Rect' ] ],
386						SDL_RenderIsClipEnabled => [ ['SDL_Renderer'], 'bool' ],
387						SDL_RenderSetScale => [ [ 'SDL_Renderer', 'float', 'float' ], 'int' ],
388						SDL_RenderGetScale => [ [ 'SDL_Renderer', 'float', 'float' ], ],
389						SDL_SetRenderDrawColor => [ [ 'SDL_Renderer', 'uint8', 'uint8', 'uint8', 'uint8' ], 'int' ],
390						SDL_GetRenderDrawColor =>
391						[ [ 'SDL_Renderer', 'uint8', 'uint8', 'uint8', 'uint8' ], 'int' ],
392						SDL_SetRenderDrawBlendMode => [ [ 'SDL_Renderer', 'SDL_BlendMode' ], 'int' ],
393						SDL_GetRenderDrawBlendMode => [ [ 'SDL_Renderer', 'int*' ], 'int' ],
394						SDL_RenderClear => [ ['SDL_Renderer'], 'int' ],
395						SDL_RenderDrawPoint => [ [ 'SDL_Renderer', 'int', 'int' ], 'int' ],
396						SDL_RenderDrawPoints => [
397						[ 'SDL_Renderer', 'SDL2x_PointList', 'int' ],
398						'int' => sub ( $inner, $renderer, @points ) {
399
400						# XXX - This is a workaround for FFI::C::Array not being able to accept a list of objects
401						# XXX - I can rethink this map when https://github.com/PerlFFI/FFI-C/issues/53 is resolved
402						$inner->(
403						$renderer,
404						SDL2x::PointList->new(
405						[ map { ref $_ eq 'HASH' ? $_ : { x => $_->x, y => $_->y } } @points ]
406						),
407						scalar @points
408						);
409						}
410						],
411						SDL_RenderDrawLine => [ [ 'SDL_Renderer', 'int', 'int', 'int', 'int' ], 'int' ],
412						SDL_RenderDrawLines => [
413						[ 'SDL_Renderer', 'SDL2x_PointList', 'int' ],
414						'int' => sub ( $inner, $renderer, @points ) {
415
416						# XXX - This is a workaround for FFI::C::Array not being able to accept a list of objects
417						# XXX - I can rethink this map when https://github.com/PerlFFI/FFI-C/issues/53 is resolved
418						$inner->(
419						$renderer,
420						SDL2x::PointList->new(
421						[ map { ref $_ eq 'HASH' ? $_ : { x => $_->x, y => $_->y } } @points ]
422						),
423						scalar @points
424						);
425						}
426						],
427						SDL_RenderDrawRect => [ [ 'SDL_Renderer', 'SDL_Rect' ], 'int' ],
428						SDL_RenderDrawRects => [
429						[ 'SDL_Renderer', 'SDL2x_RectList', 'int' ],
430						'int' => sub ( $inner, $renderer, @rects ) {
431
432						# XXX - This is a workaround for FFI::C::Array not being able to accept a list of objects
433						# XXX - I can rethink this map when https://github.com/PerlFFI/FFI-C/issues/53 is resolved
434						$inner->(
435						$renderer,
436						SDL2x::RectList->new(
437						[ map {
438						ref $_ eq 'HASH' ? $_ :
439						{ x => $_->x, y => $_->y, w => $_->w, h => $_->h }
440						} @rects
441						]
442						),
443						scalar @rects
444						);
445						}
446						],
447						SDL_RenderFillRect => [ [ 'SDL_Renderer', 'SDL_Rect' ], 'int' ],
448						SDL_RenderFillRects => [
449						[ 'SDL_Renderer', 'SDL2x_RectList', 'int' ],
450						'int' => sub ( $inner, $renderer, @rects ) {
451
452						# XXX - This is a workaround for FFI::C::Array not being able to accept a list of objects
453						# XXX - I can rethink this map when https://github.com/PerlFFI/FFI-C/issues/53 is resolved
454						$inner->(
455						$renderer,
456						SDL2x::RectList->new(
457						[ map {
458						ref $_ eq 'HASH' ? $_ :
459						{ x => $_->x, y => $_->y, w => $_->w, h => $_->h }
460						} @rects
461						]
462						),
463						scalar @rects
464						);
465						}
466						],
467						SDL_RenderCopy => [ [ 'SDL_Renderer', 'SDL_Texture', 'SDL_Rect', 'SDL_Rect' ], 'int' ],
468
469						# XXX - I do not have an example for this function in docs
470						SDL_RenderCopyEx => [
471						[ 'SDL_Renderer', 'SDL_Texture', 'SDL_Rect', 'SDL_Rect',
472						'double', 'SDL_Point', 'SDL_RendererFlip'
473						],
474						'int'
475						],
476						SDL_RenderDrawPointF => [ [ 'SDL_Renderer', 'float', 'float' ], 'int' ],
477						SDL_RenderDrawPointsF => [
478						[ 'SDL_Renderer', 'SDL2x_FPointList', 'int' ],
479						'int' => sub ( $inner, $renderer, @points ) {
480
481						# XXX - This is a workaround for FFI::C::Array not being able to accept a list of objects
482						# XXX - I can rethink this map when https://github.com/PerlFFI/FFI-C/issues/53 is resolved
483						$inner->(
484						$renderer,
485						SDL2x::PointFList->new(
486						[ map { ref $_ eq 'HASH' ? $_ : { x => $_->x, y => $_->y } } @points ]
487						),
488						scalar @points
489						);
490						}
491						],
492						SDL_RenderDrawLineF => [ [ 'SDL_Renderer', 'float', 'float', 'float', 'float' ], 'int' ],
493						SDL_RenderDrawLinesF => [
494						[ 'SDL_Renderer', 'SDL2x_FPointList', 'int' ],
495						'int' => sub ( $inner, $renderer, @points ) {
496
497						# XXX - This is a workaround for FFI::C::Array not being able to accept a list of objects
498						# XXX - I can rethink this map when https://github.com/PerlFFI/FFI-C/issues/53 is resolved
499						$inner->(
500						$renderer,
501						SDL2x::FPointList->new(
502						[ map { ref $_ eq 'HASH' ? $_ : { x => $_->x, y => $_->y } } @points ]
503						),
504						scalar @points
505						);
506						}
507						],
508						SDL_RenderDrawRectF => [
509						[ 'SDL_Renderer', 'SDL2x_FRectList', 'int' ],
510						'int' => sub ( $inner, $renderer, @rects ) {
511
512						# XXX - This is a workaround for FFI::C::Array not being able to accept a list of objects
513						# XXX - I can rethink this map when https://github.com/PerlFFI/FFI-C/issues/53 is resolved
514						$inner->(
515						$renderer,
516						SDL2x::FRectList->new(
517						[ map {
518						ref $_ eq 'HASH' ? $_ :
519						{ x => $_->x, y => $_->y, w => $_->w, h => $_->h }
520						} @rects
521						]
522						),
523						scalar @rects
524						);
525						}
526						],
527						SDL_RenderDrawRectsF => [
528						[ 'SDL_Renderer', 'SDL2x_FRectList', 'int' ],
529						'int' => sub ( $inner, $renderer, @rects ) {
530
531						# XXX - This is a workaround for FFI::C::Array not being able to accept a list of objects
532						# XXX - I can rethink this map when https://github.com/PerlFFI/FFI-C/issues/53 is resolved
533						$inner->(
534						$renderer,
535						SDL2x::FRectList->new(
536						[ map {
537						ref $_ eq 'HASH' ? $_ :
538						{ x => $_->x, y => $_->y, w => $_->w, h => $_->h }
539						} @rects
540						]
541						),
542						scalar @rects
543						);
544						}
545						],
546						SDL_RenderFillRectsF => [
547						[ 'SDL_Renderer', 'SDL2x_FRectList', 'int' ],
548						'int' => sub ( $inner, $renderer, @rects ) {
549
550						# XXX - This is a workaround for FFI::C::Array not being able to accept a list of objects
551						# XXX - I can rethink this map when https://github.com/PerlFFI/FFI-C/issues/53 is resolved
552						$inner->(
553						$renderer,
554						SDL2x::FRectList->new(
555						[ map {
556						ref $_ eq 'HASH' ? $_ :
557						{ x => $_->x, y => $_->y, w => $_->w, h => $_->h }
558						} @rects
559						]
560						),
561						scalar @rects
562						);
563						}
564						],
565
566						# XXX - I do not have an example for this function in docs
567						SDL_RenderCopyF => [ [ 'SDL_Renderer', 'SDL_Texture', 'SDL_Rect', 'SDL_FRect' ], 'int' ],
568
569						# XXX - I do not have an example for this function in docs
570						SDL_RenderCopyExF => [
571						[ 'SDL_Renderer', 'SDL_Texture', 'SDL_Rect', 'SDL_FRect',
572						'double', 'SDL_FPoint', 'SDL_RendererFlip'
573						],
574						'int'
575						],
576						SDL_RenderReadPixels =>
577						[ [ 'SDL_Renderer', 'SDL_Rect', 'uint32', 'opaque', 'int' ], 'int' ],
578						SDL_RenderPresent => [ ['SDL_Renderer'] ],
579						SDL_DestroyTexture => [ ['SDL_Texture'] ],
580						SDL_DestroyRenderer => [ ['SDL_Renderer'] ],
581						SDL_RenderFlush => [ ['SDL_Renderer'], 'int' ],
582						SDL_GL_BindTexture => [ [ 'SDL_Texture', 'float', 'float' ], 'int' ],
583						SDL_GL_UnbindTexture => [ ['SDL_Texture'], 'int' ],
584						SDL_RenderGetMetalLayer => [ ['SDL_Renderer'], 'opaque' ],
585						SDL_RenderGetMetalCommandEncoder => [ ['SDL_Renderer'], 'opaque' ]
586						};
587						ffi->type( '(int,opaque)->uint32' => 'SDL_TimerCallback' );
588						attach timer => {
589						SDL_GetTicks => [ [], 'uint32' ],
590						SDL_GetPerformanceCounter => [ [], 'uint64' ],
591						SDL_GetPerformanceFrequency => [ [], 'uint64' ],
592						SDL_Delay => [ ['uint32'] ],
593						SDL_AddTimer => [
594						[ 'uint32', 'SDL_TimerCallback', 'opaque' ],
595						'int' => sub ( $xsub, $interval, $callback, $param = () ) {
596
597						# Fake void pointer
598						my $cb = FFI::Platypus::Closure->new( sub { $callback->(@_); } );
599						$cb->sticky;
600						$xsub->( $interval, $cb, $param );
601						}
602						],
603						SDL_RemoveTimer => [ ['uint32'] => 'bool' ],
604						};
605						ffi->type( '(opaque,string,int)->void' => 'SDL_AudioCallback' );
606						ffi->type( 'int' => 'SDL_AudioFormat' );
607						ffi->type( '(opaque,uint16)->void' => 'SDL_AudioFilter' );
608
609						package SDL2::AudioStream {
610	2		2		5336	use SDL2::Utils;
	2				6
	2				12
611						has();
612						};
613
614						package SDL2::AudioDeviceID {
615	2		2		1165	use SDL2::Utils;
	2				15
	2				11
616						has();
617						};
618
619						package SDL2::RWops { # TODO: https://github.com/libsdl-org/SDL/blob/main/include/SDL_rwops.h
620	2		2		1110	use SDL2::Utils;
	2				4
	2				24
621						has();
622						};
623						define audio => [ [ SDL_AUDIOCVT_MAX_FILTERS => 9 ], ];
624						attach audio => {
625						SDL_AudioInit => [ ["string"], "int" ],
626						SDL_AudioQuit => [ [] ],
627						SDL_AudioStreamAvailable => [ ["SDL_AudioStream"], "int" ],
628						SDL_AudioStreamClear => [ ["SDL_AudioStream"] ],
629						SDL_AudioStreamFlush => [ ["SDL_AudioStream"], "int" ],
630						SDL_AudioStreamGet => [ [ "SDL_AudioStream", "opaque*", "int" ], "int" ],
631						SDL_AudioStreamPut => [ [ "SDL_AudioStream", "opaque*", "int" ], "int" ],
632						SDL_BuildAudioCVT => [
633						[ "SDL_AudioCVT", "SDL_AudioFormat", "uint8", "int",
634						"SDL_AudioFormat", "uint8", "int",
635						],
636						"int",
637						],
638						SDL_ClearQueuedAudio => [ ["SDL_AudioDeviceID"] ],
639						SDL_CloseAudio => [ [] ],
640						SDL_CloseAudioDevice => [ ["SDL_AudioDeviceID"] ],
641						SDL_ConvertAudio => [ ["SDL_AudioCVT"], "int" ],
642						SDL_DequeueAudio => [ [ "SDL_AudioDeviceID", "opaque*", "uint32" ], "uint32" ],
643						SDL_FreeAudioStream => [ ["SDL_AudioStream"] ],
644						SDL_FreeWAV => [ ["uint8 *"] ],
645						SDL_GetAudioDeviceName => [ [ "int", "int" ], "string" ], (
646						$ver->patch >= 15 ?
647						( SDL_GetAudioDeviceSpec => [ [ "int", "int", "SDL_AudioSpec" ], "int" ] ) :
648						()
649						),
650						SDL_GetAudioDeviceStatus => [ ["SDL_AudioDeviceID"], "SDL_AudioStatus" ],
651						SDL_GetAudioDriver => [ ["int"], "string" ],
652						SDL_GetAudioStatus => [ [], "SDL_AudioStatus" ],
653						SDL_GetCurrentAudioDriver => [ [], "string" ],
654						SDL_GetNumAudioDevices => [ ["int"], "int" ],
655						SDL_GetNumAudioDrivers => [ [], "int" ],
656						SDL_GetQueuedAudioSize => [ ["SDL_AudioDeviceID"], "uint32" ],
657
658						#SDL_LoadWAV_RW => [
659						# ["SDL_RWops", "int", "SDL_AudioSpec", "uint8*", "uint32 "],
660						# "SDL_AudioSpec",
661						# ],
662						SDL_LockAudio => [ [] ],
663						SDL_LockAudioDevice => [ ["SDL_AudioDeviceID"] ],
664						SDL_MixAudio => [ [ "uint8 ", "uint8 ", "uint32", "int" ] ],
665						SDL_MixAudioFormat => [ [ "uint8 ", "uint8 ", "SDL_AudioFormat", "uint32", "int" ] ],
666						SDL_NewAudioStream => [
667						[ "SDL_AudioFormat", "uint8", "int", "SDL_AudioFormat", "uint8", "int", ],
668						"SDL_AudioStream",
669						],
670						SDL_OpenAudio => [
671						[ 'SDL_AudioSpec', 'SDL_AudioSpec' ],
672						'int' => sub ( $inner, $desired, $obtained = () ) {
673						deprecate <<'END';
674						SDL_OpenAudio( ... ) remains for compatibility with SDL 1.2. The new, more
675						powerful, and preferred way to do this is SDL_OpenAudioDevice( ... );
676						END
677						$inner->( $desired, $obtained );
678						}
679						],
680						SDL_OpenAudioDevice =>
681						[ [ "string", "int", "SDL_AudioSpec", "SDL_AudioSpec", "int" ], "SDL_AudioDeviceID", ],
682						SDL_PauseAudio => [ ["int"] ],
683						SDL_PauseAudioDevice => [ [ "SDL_AudioDeviceID", "int" ] ],
684						SDL_QueueAudio => [ [ "SDL_AudioDeviceID", "opaque*", "uint32" ], "int" ],
685						SDL_UnlockAudio => [ [] ],
686						SDL_UnlockAudioDevice => [ ["SDL_AudioDeviceID"] ],
687						};
688
689						# Everything below this line will be rewritten!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
690						#
691						#https://github.com/libsdl-org/SDL/blob/main/include/SDL_surface.h#L327
692						push @{ $EXPORT_TAGS{'surface'} }, 'SDL_LoadBMP';
693						attach surface => { SDL_LoadBMP_RW => [ [ 'SDL_RWops', 'int' ], 'SDL_Surface' ], };
694	0		0	0		sub SDL_LoadBMP ($file) { SDL_LoadBMP_RW( SDL_RWFromFile( $file, "rb" ), 1 ) }
	0
	0
	0
695						push @{ $EXPORT_TAGS{'surface'} }, 'SDL_FreeSurface';
696						ffi->attach( SDL_FreeSurface => ['SDL_Surface'] );
697						ffi->attach( SDL_SaveBMP_RW => [ 'SDL_Surface', 'SDL_RWops', 'int' ], 'int' );
698						attach future => {
699						SDL_ComposeCustomBlendMode => [
700						[ 'SDL_BlendFactor', 'SDL_BlendFactor',
701						'SDL_BlendOperation', 'SDL_BlendFactor',
702						'SDL_BlendFactor', 'SDL_BlendOperation'
703						],
704						'SDL_BlendMode'
705						],
706						};
707						ffi->attach( SDL_RWFromFile => [ 'string', 'string' ], 'SDL_RWops' );
708
709	0		0	0		sub SDL_SaveBMP ( $surface, $file ) {
	0
	0
	0
710	0					SDL_SaveBMP_RW( $surface, SDL_RWFromFile( $file, 'wb' ), 1 );
711						}
712						ffi->attach( SDL_GetPlatform => [] => 'string' );
713						ffi->attach( SDL_CreateRGBSurface =>
714						[ 'uint32', 'int', 'int', 'int', 'uint32', 'uint32', 'uint32', 'uint32' ] =>
715						'SDL_Surface' );
716
717						# https://wiki.libsdl.org/CategoryCPU
718						ffi->attach( SDL_GetCPUCacheLineSize => [] => 'int' );
719						ffi->attach( SDL_GetCPUCount => [] => 'int' );
720						ffi->attach( SDL_GetSystemRAM => [] => 'int' );
721						ffi->attach( SDL_Has3DNow => [] => 'bool' );
722						ffi->attach( SDL_HasAVX => [] => 'bool' );
723						ffi->attach( SDL_HasAVX2 => [] => 'bool' );
724						ffi->attach( SDL_HasAltiVec => [] => 'bool' );
725						ffi->attach( SDL_HasMMX => [] => 'bool' );
726						ffi->attach( SDL_HasRDTSC => [] => 'bool' );
727						ffi->attach( SDL_HasSSE => [] => 'bool' );
728						ffi->attach( SDL_HasSSE2 => [] => 'bool' );
729						ffi->attach( SDL_HasSSE3 => [] => 'bool' );
730						ffi->attach( SDL_HasSSE41 => [] => 'bool' );
731						ffi->attach( SDL_HasSSE42 => [] => 'bool' );
732						ffi->attach( SDL_GetPowerInfo => [ 'int', 'int' ] => 'int' );
733
734						# https://wiki.libsdl.org/CategoryStandard
735						ffi->attach( SDL_acos => ['double'] => 'double' );
736						ffi->attach( SDL_asin => ['double'] => 'double' ); # Not in wiki
737
738						# https://wiki.libsdl.org/CategoryVideo
739						# Macros defined in SDL_video.h
740	0					define video => [
741						[ SDL_WINDOWPOS_UNDEFINED_MASK => 0x1FFF0000 ],
742						[ SDL_WINDOWPOS_UNDEFINED_DISPLAY =>
743	0		0			sub ($X) { ( SDL_WINDOWPOS_UNDEFINED_MASK() \| ($X) ) }
	0
	0
744	0		0			],
745	0					[ SDL_WINDOWPOS_UNDEFINED => sub () { SDL_WINDOWPOS_UNDEFINED_DISPLAY(0) } ],
	0
	0
746						[ SDL_WINDOWPOS_ISUNDEFINED =>
747	0		0			sub ($X) { ( ( ($X) & 0xFFFF0000 ) == SDL_WINDOWPOS_UNDEFINED_MASK() ) }
	0
	0
748	0		0			],
749						#
750	0					[ SDL_WINDOWPOS_CENTERED_MASK => sub () {0x2FFF0000} ],
	0
	0
751	0		0			[ SDL_WINDOWPOS_CENTERED_DISPLAY => sub ($X) { ( SDL_WINDOWPOS_CENTERED_MASK() \| ($X) ) } ],
	0
	0
	0
752	0					[ SDL_WINDOWPOS_CENTERED => sub() { SDL_WINDOWPOS_CENTERED_DISPLAY(0) } ],
	0
	0
753						[ SDL_WINDOWPOS_ISCENTERED =>
754	0		0			sub ($X) { ( ( ($X) & 0xFFFF0000 ) == SDL_WINDOWPOS_CENTERED_MASK() ) }
	0
	0
755						],
756						];
757						attach future => {
758						SDL_FillRect => [ [ 'SDL_Surface', 'opaque', 'uint32' ], 'int' ],
759						SDL_MapRGB => [
760						[ 'SDL_PixelFormat', 'uint8', 'uint8', 'uint8' ] => 'uint32' =>
761						sub ( $inner, $format, $r, $g, $b ) {
762						$format = ffi->cast( 'opaque', 'SDL_PixelFormat', $format ) if !ref $format;
763						$inner->( $format, $r, $g, $b );
764						}
765						]
766						};
767						ffi->type( '(opaque, opaque)->int' => 'SDL_EventFilter' );
768						attach events => {
769						SDL_PeepEvents =>
770						[ [ 'SDL_Event', 'int', 'SDL_EventAction', 'uint32', 'uint32' ] => 'int' ],
771						SDL_HasEvent => [ ['uint32'] => 'bool' ],
772						SDL_HasEvents => [ [ 'uint32', 'uint32' ] => 'bool' ],
773						SDL_FlushEvent => [ ['uint32'] ],
774						SDL_FlushEvents => [ [ 'uint32', 'uint32' ] ],
775						SDL_PollEvent => [ ['SDL_Event'] => 'int' ],
776						SDL_WaitEvent => [ ['SDL_Event'] => 'int' ],
777						SDL_WaitEventTimeout => [ [ 'SDL_Event', 'int' ] => 'int' ],
778						SDL_PushEvent => [ ['SDL_Event'] => 'int' ],
779						SDL_SetEventFilter => [ [ 'SDL_EventFilter', 'opaque' ] ],
780						SDL_GetEventFilter => [ [ 'SDL_EventFilter', 'opaque' ] => 'bool' ],
781						SDL_AddEventWatch => [ [ 'SDL_EventFilter', 'opaque' ] ],
782						SDL_DelEventWatch => [ [ 'SDL_EventFilter', 'opaque' ] ],
783						SDL_FilterEvents => [ [ 'SDL_EventFilter', 'opaque' ] ]
784						};
785						#
786						#
787						ffi->attach( SDL_EventState => [ 'uint32', 'int' ] => 'uint8' );
788	0		0	0		sub SDL_GetEventState ($type) { SDL_EventState( $type, SDL_QUERY ) }
	0
	0
	0
789						ffi->attach( SDL_RegisterEvents => ['int'] => 'uint32' );
790
791						# From src/events/SDL_mouse_c.h
792						package SDL2::Cursor {
793	2		2		3305	use SDL2::Utils;
	2				7
	2				11
794						has
795						next => 'opaque', # SDL_Cursor
796						driverdata => 'opaque' # void
797						};
798
799						# From SDL_mouse.h
800						ffi->attach( SDL_GetMouseFocus => [] => 'SDL_Window' );
801						ffi->attach( SDL_GetMouseState => [ 'int', 'int' ] => 'uint32' );
802						ffi->attach( SDL_GetGlobalMouseState => [ 'int', 'int' ] => 'uint32' );
803						ffi->attach( SDL_GetRelativeMouseState => [ 'int', 'int' ] => 'uint32' );
804						ffi->attach( SDL_WarpMouseInWindow => [ 'SDL_Window', 'int', 'int' ] );
805						ffi->attach( SDL_SetRelativeMouseMode => ['bool'] => 'int' );
806						ffi->attach( SDL_CaptureMouse => ['bool'] => 'int' );
807						ffi->attach( SDL_GetRelativeMouseMode => [] => 'bool' );
808						ffi->attach(
809						SDL_CreateCursor => [ 'uint8', 'uint8', 'int', 'int', 'int', 'int' ] => 'SDL_Cursor' );
810						ffi->attach( SDL_CreateSystemCursor => ['SDL_SystemCursor'] => 'SDL_Cursor' );
811						ffi->attach( SDL_SetCursor => ['SDL_Cursor'] );
812						ffi->attach( SDL_GetCursor => [] => 'SDL_Cursor' );
813						ffi->attach( SDL_GetDefaultCursor => [] => 'SDL_Cursor' );
814						ffi->attach( SDL_FreeCursor => [] => 'SDL_Cursor' );
815						ffi->attach( SDL_ShowCursor => ['int'] => 'int' );
816						#
817						# XXX - From SDL_stding.h
818						# Define a four character code as a Uint32
819	0		0	0		sub SDL_FOURCC ( $A, $B, $C, $D ) {
	0
	0
	0
	0
	0
820	0					( $A << 0 ) \| ( $B << 8 ) \| ( $C << 16 ) \| ( $D << 24 );
821						}
822
823						# Unsorted - https://github.com/libsdl-org/SDL/blob/c59d4dcd38c382a1e9b69b053756f1139a861574/include/SDL_keycode.h
824						# https://github.com/libsdl-org/SDL/blob/c59d4dcd38c382a1e9b69b053756f1139a861574/include/SDL_scancode.h#L151
825						attach(
826						all => {
827
828						# Unknown...
829						SDL_SetMainReady => [ [] => 'void' ]
830						}
831						);
832
833						# TODO
834						package SDL2::assert_data {
835	2		2		1550	use SDL2::Utils;
	2				4
	2				27
836						has;
837						};
838
839						package SDL2::atomic_t {
840	2		2		1028	use SDL2::Utils;
	2				5
	2				8
841						has value => 'int';
842						};
843
844						package SDL2::Finger {
845	2		2		1017	use SDL2::Utils;
	2				3
	2				7
846						ffi->type( 'sint64' => 'SDL_TouchID' );
847						ffi->type( 'sint64' => 'SDL_FingerID' );
848						has
849						id => 'SDL_FingerID',
850						x => 'float',
851						y => 'float',
852						pressure => 'float';
853						};
854
855						package SDL2::_GameController {
856	2		2		1300	use SDL2::Utils;
	2				5
	2				8
857						has;
858						};
859
860						package SDL2::GameCrontroller {
861	2		2		993	use SDL2::Utils;
	2				6
	2				56
862						has;
863						};
864
865						package SDL2::_Haptic {
866	2		2		1039	use SDL2::Utils;
	2				16
	2				12
867						has;
868						};
869
870						package SDL2::Haptic {
871	2		2		983	use SDL2::Utils;
	2				6
	2				7
872						has;
873						};
874
875						package SDL2::JoystickID {
876	2		2		1009	use SDL2::Utils;
	2				4
	2				8
877						has;
878						};
879
880						package SDL2::_JoyStick {
881	2		2		985	use SDL2::Utils;
	2				5
	2				8
882						has;
883						};
884						attach messagebox => {
885
886						#SDL_ShowSimpleMessageBox(SDL_MESSAGEBOX_ERROR, ("R.E.L.I.V.E. " + BuildString()).c_str(), msg, nullptr);
887						SDL_ShowSimpleMessageBox => [ [ 'uint32', 'string', 'string', 'SDL_Window' ], 'int' ]
888						};
889
890						package SDL2::Sensor {
891	2		2		1029	use SDL2::Utils;
	2				5
	2				8
892						has;
893						};
894
895						package SDL2::SensorID { }; # type
896
897						package SDL2::ControllerTouchpadEvent {
898	2		2		1118	use SDL2::Utils;
	2				5
	2				9
899						has;
900						};
901
902						package SDL2::Mixer {
903	2		2		999	use SDL2::Utils;
	2				3
	2				9
904						has;
905						};
906
907						package SDL2::Mixer::Mix::Chunk {
908	2		2		1068	use SDL2::Utils;
	2				3
	2				9
909						has;
910						};
911
912						package SDL2::Mixer::Mix::Fading {
913	2		2		1055	use SDL2::Utils;
	2				5
	2				10
914						has;
915						};
916
917						package SDL2::Mixer::Mix::MusicType {
918	2		2		1017	use SDL2::Utils;
	2				4
	2				9
919						has;
920						};
921
922						package SDL2::Mixer::Mix::Music {
923	2		2		1070	use SDL2::Utils;
	2				4
	2				8
924						has;
925						};
926
927						package SDL2::Mixer::Chunk {
928	2		2		999	use SDL2::Utils;
	2				4
	2				9
929						has;
930						};
931
932						package SDL2::Mixer::Fading {
933	2		2		1009	use SDL2::Utils;
	2				6
	2				9
934						has;
935						};
936
937						package SDL2::Mixer::MusicType {
938	2		2		1160	use SDL2::Utils;
	2				4
	2				8
939						has;
940						};
941
942						package SDL2::Mixer::Music {
943	2		2		1056	use SDL2::Utils;
	2				4
	2				8
944						has;
945						};
946
947						package SDL2::Image {
948	2		2		1041	use SDL2::Utils;
	2				3
	2				10
949						has;
950						};
951
952						package SDL2::iconv_t {
953	2		2		1007	use SDL2::Utils;
	2				4
	2				12
954						has;
955						}; # int ptr
956
957						package SDL2::WindowShapeMode {
958	2		2		983	use SDL2::Utils;
	2				3
	2				11
959						has;
960						};
961
962						package SDL2::WindowShapeParams {
963	2		2		995	use SDL2::Utils;
	2				5
	2				10
964						has;
965						}; # union
966
967						package SDL2::TTF {
968	2		2		1067	use SDL2::Utils;
	2				4
	2				11
969						has;
970						};
971
972						package SDL2::TTF::Image {
973	2		2		1116	use SDL2::Utils;
	2				4
	2				10
974						has;
975						};
976
977						package SDL2::TTF::Font {
978	2		2		1007	use SDL2::Utils;
	2				4
	2				16
979						has;
980						};
981
982						package SDL2::TTF::PosBuf {
983	2		2		974	use SDL2::Utils;
	2				15
	2				11
984						has;
985						};
986
987						package SDL2::Net {
988	2		2		3183	use SDL2::Utils;
	2				8
	2				19
989						has;
990						};
991
992						package SDL2::RTF {
993	2		2		1027	use SDL2::Utils;
	2				4
	2				7
994						has;
995						};
996
997						package SDL2::RTF::Context {
998	2		2		992	use SDL2::Utils;
	2				6
	2				8
999						has;
1000						};
1001
1002						package SDL2::RTF::FontEngine {
1003	2		2		1043	use SDL2::Utils;
	2				5
	2				8
1004						has;
1005						};
1006
1007						package SDL2::Thread {
1008	2		2		996	use SDL2::Utils;
	2				4
	2				19
1009						has();
1010						}
1011
1012						package SDL2::ShapeDriver { };
1013
1014						package SDL2::VideoDisplay {
1015	2		2		1088	use SDL2::Utils;
	2				5
	2				6
1016						has name => 'opaque', # string
1017						max_display_modes => 'int',
1018						num_display_modes => 'int',
1019						display_modes => 'opaque', # SDL_DisplayMode
1020						desktop_mode => 'opaque', # SDL_DisplayMode
1021						orientation => 'opaque', # SDL_DisplayOrientation
1022						fullscreen_window => 'opaque', # SDL_Window
1023						device => 'opaque', # SDL_VideoDevice
1024						driverdata => 'opaque'; # void *
1025						};
1026
1027						package SDL2::VideoDevice {
1028	2		2		1141	use SDL2::Utils;
	2				4
	2				16
1029						has;
1030						};
1031
1032						package SDL2::WindowUserData {
1033	2		2		998	use SDL2::Utils;
	2				5
	2				9
1034						has name => 'opaque', # string
1035						data => 'opaque', # void *
1036						next => 'opaque'; # SDL_WindowUserData
1037						};
1038
1039						package SDL2::SysWMinfo {
1040	2		2		1123	use SDL2::Utils;
	2				6
	2				9
1041						has;
1042						};
1043
1044						package SDL2::VideoBootStrap {
1045	2		2		1025	use SDL2::Utils;
	2				5
	2				9
1046						has;
1047						};
1048
1049						package SDL2::SpinLock {
1050	2		2		1422	use SDL2::Utils;
	2				3
	2				9
1051						has;
1052						};
1053
1054						package SDL2::AtomicLock {
1055	2		2		991	use SDL2::Utils;
	2				3
	2				7
1056						has;
1057						};
1058
1059						#warn SDL2::SDLK_UP();
1060						#warn SDL2::SDLK_DOWN();
1061						# https://github.com/libsdl-org/SDL/blob/main/include/SDL_hints.h
1062						# Export symbols!
1063						our @EXPORT_OK = map {@$_} values %EXPORT_TAGS;
1064
1065						#$EXPORT_TAGS{default} = []; # Export nothing by default
1066						$EXPORT_TAGS{all} = \@EXPORT_OK; # Export everything with :all tag
1067
1068						#use Data::Dump;
1069						#ddx \%EXPORT_TAGS;
1070						#ddx \%SDL2::;
1071						# plan for the future
1072						package SDL3 { };
1073						};
1074						1;
1075
1076						=encoding utf-8
1077
1078						=head1 NAME
1079
1080						SDL2::FFI - FFI Wrapper for SDL (Simple DirectMedia Layer) Development Library
1081
1082						=head1 SYNOPSIS
1083
1084						use SDL2::FFI qw[:all];
1085						die 'Error initializing SDL: ' . SDL_GetError() unless SDL_Init(SDL_INIT_VIDEO) == 0;
1086						my $win = SDL_CreateWindow( 'Example window!',
1087						SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, 640, 480, SDL_WINDOW_RESIZABLE );
1088						die 'Could not create window: ' . SDL_GetError() unless $win;
1089						my $event = SDL2::Event->new;
1090						SDL_Init(SDL_INIT_VIDEO);
1091						my $renderer = SDL_CreateRenderer( $win, -1, 0 );
1092						SDL_SetRenderDrawColor( $renderer, 242, 242, 242, 255 );
1093						do {
1094						SDL_WaitEventTimeout( $event, 10 );
1095						SDL_RenderClear($renderer);
1096						SDL_RenderPresent($renderer);
1097						} until $event->type == SDL_QUIT;
1098						SDL_DestroyRenderer($renderer);
1099						SDL_DestroyWindow($win);
1100						SDL_Quit();
1101
1102						=head1 DESCRIPTION
1103
1104						SDL2::FFI is an L backed bindings to the B~~imple~~
1105						BirectMedia Bayer - a cross-platform development library designed to
1106						provide low level access to audio, keyboard, mouse, joystick, and graphics
1107						hardware.
1108
1109						=head1 Initialization and Shutdown
1110
1111						The functions in this category are used to set SDL up for use and generally
1112						have global effects in your program. These functions may be imported with the
1113						C<:init> or C<:default> tag.
1114
1115						=head2 C
1116
1117						Initializes the SDL library. This must be called before using most other SDL
1118						functions.
1119
1120						SDL_Init( SDL_INIT_TIMER \| SDL_INIT_VIDEO \| SDL_INIT_EVENTS );
1121
1122						C simply forwards to calling L<< C
1123						)>\|/C >>. Therefore, the two may be used
1124						interchangeably. Though for readability of your code L<< C
1125						... )>\|/C >> might be preferred.
1126
1127						The file I/O (for example: L<< C\|/C
1128						)> >>) and threading (L<< C\|/C
1129						)> >>) subsystems are initialized by default. Message boxes ( L<<
1130						C\|/C >> )
1131						also attempt to work without initializing the video subsystem, in hopes of
1132						being useful in showing an error dialog when SDL_Init fails. You must
1133						specifically initialize other subsystems if you use them in your application.
1134
1135						Logging (such as L<< C\|/C >> ) works without
1136						initialization, too.
1137
1138						Expected parameters include:
1139
1140						=over
1141
1142						=item C which may be any be imported with the L<< C<:init>\|SDL2::Enum/C<:init> >> tag and may be OR'd together
1143
1144						=back
1145
1146						Subsystem initialization is ref-counted, you must call L<< C
1147						... )>\|/C >> for each L<< C
1148						)>\|/C >> to correctly shutdown a subsystem manually
1149						(or call L<< C\|/C >> to force shutdown). If a
1150						subsystem is already loaded then this call will increase the ref-count and
1151						return.
1152
1153						Returns C<0> on success or a negative error code on failure; call L<<
1154						C\|/C >> for more information.
1155
1156						=head2 C
1157
1158						Compatibility function to initialize the SDL library.
1159
1160						In SDL2, this function and L<< C\|/C >> are
1161						interchangeable.
1162
1163						SDL_InitSubSystem( SDL_INIT_TIMER \| SDL_INIT_VIDEO \| SDL_INIT_EVENTS );
1164
1165						Expected parameters include:
1166
1167						=over
1168
1169						=item C which may be any be imported with the L<< C<:init>\|SDL2::Enum/C<:init> >> tag and may be OR'd together.
1170
1171						=back
1172
1173						Returns C<0> on success or a negative error code on failure; call L<<
1174						C\|/C >> for more information.
1175
1176						=head2 C
1177
1178						Clean up all initialized subsystems.
1179
1180						SDL_Quit( );
1181
1182						You should call this function even if you have already shutdown each
1183						initialized subsystem with L<< C\|/C
1184						>>. It is safe to call this function even in the case of errors in
1185						initialization.
1186
1187						If you start a subsystem using a call to that subsystem's init function (for
1188						example L<< C\|/C >>) instead of L<<
1189						C\|/C >> or L<< C
1190						)>\|/C >>, then you must use that subsystem's quit
1191						function (L<< C\|/C >>) to shut it down
1192						before calling C. But generally, you should not be using those
1193						functions directly anyhow; use L<< C\|/C >>
1194						instead.
1195
1196						You can use this function in an C block to ensure that it is run
1197						when your application is shutdown.
1198
1199						=head2 C
1200
1201						Shut down specific SDL subsystems.
1202
1203						SDL_QuitSubSystem( SDL_INIT_VIDEO );
1204
1205						If you start a subsystem using a call to that subsystem's init function (for
1206						example L<< C \|/C >>) instead of L<<
1207						C\|/C >> or L<< C
1208						)>\|/C >>, L<< C
1209						)>\|/C >> and L<< C
1210						)>\|/C >> will not work. You will need to use that
1211						subsystem's quit function ( L<< C\|/C >>
1212						directly instead. But generally, you should not be using those functions
1213						directly anyhow; use L<< C\|/C >> instead.
1214
1215						You still need to call L<< C\|/C >> even if you close
1216						all open subsystems with L<< C\|/C
1217						... )> >>.
1218
1219						Expected parameters include:
1220
1221						=over
1222
1223						=item C which may be any be imported with the L<< C<:init>\|SDL2::Enum/C<:init> >> tag and may be OR'd together.
1224
1225						=back
1226
1227						=head2 C
1228
1229						Get a mask of the specified subsystems which are currently initialized.
1230
1231						SDL_Init( SDL_INIT_VIDEO \| SDL_INIT_AUDIO );
1232						warn SDL_WasInit( SDL_INIT_TIMER ); # false
1233						warn SDL_WasInit( SDL_INIT_VIDEO ); # true (32 == SDL_INIT_VIDEO)
1234						my $mask = SDL_WasInit( );
1235						warn 'video init!' if ($mask & SDL_INIT_VIDEO); # yep
1236						warn 'video timer!' if ($mask & SDL_INIT_TIMER); # nope
1237
1238						Expected parameters include:
1239
1240						=over
1241
1242						=item C which may be any be imported with the L<< C<:init>\|SDL2::Enum/C<:init> >> tag and may be OR'd together.
1243
1244						=back
1245
1246						If C is C<0>, it returns a mask of all initialized subsystems, otherwise
1247						it returns the initialization status of the specified subsystems.
1248
1249						The return value does not include C.
1250
1251						=head1 Configuration Variables
1252
1253						This category contains functions to set and get configuration hints, as well as
1254						listing each of them alphabetically.
1255
1256						The convention for naming hints is C, where C is the
1257						environment variable that can be used to override the default. You may import
1258						those recognised by SDL2 with the L<< C<:hints>\|SDL2::Enum/C<:hints> >> tag.
1259
1260						In general these hints are just that - they may or may not be supported or
1261						applicable on any given platform, but they provide a way for an application or
1262						user to give the library a hint as to how they would like the library to work.
1263
1264						=head2 C
1265
1266						Set a hint with a specific priority.
1267
1268						SDL_SetHintWithPriority( SDL_EVENT_LOGGING, 2, SDL_HINT_OVERRIDE );
1269
1270						The priority controls the behavior when setting a hint that already has a
1271						value. Hints will replace existing hints of their priority and lower.
1272						Environment variables are considered to have override priority.
1273
1274						Expected parameters include:
1275
1276						=over
1277
1278						=item C
1279
1280						the hint to set
1281
1282						=item C
1283
1284						the value of the hint variable
1285
1286						=item C
1287
1288						the priority level for the hint
1289
1290						=back
1291
1292						Returns a true if the hint was set, untrue otherwise.
1293
1294						=head2 C
1295
1296						Set a hint with normal priority.
1297
1298						SDL_SetHint( SDL_HINT_XINPUT_ENABLED, 1 );
1299
1300						Hints will not be set if there is an existing override hint or environment
1301						variable that takes precedence. You can use SDL_SetHintWithPriority( ) to set
1302						the hint with override priority instead.
1303
1304						Expected parameters:
1305
1306						=over
1307
1308						=item C
1309
1310						the hint to set
1311
1312						=item C
1313
1314						the value of the hint variable
1315
1316						=back
1317
1318						Returns a true value if the hint was set, untrue otherwise.
1319
1320						=head2 C
1321
1322						Get the value of a hint.
1323
1324						SDL_GetHint( SDL_HINT_XINPUT_ENABLED );
1325
1326						Expected parameters:
1327
1328						=over
1329
1330						=item C
1331
1332						the hint to query
1333
1334						=back
1335
1336						Returns the string value of a hint or an undefined value if the hint isn't set.
1337
1338						=head2 C
1339
1340						Get the boolean value of a hint variable.
1341
1342						SDL_GetHintBoolean( SDL_HINT_XINPUT_ENABLED, 0);
1343
1344						Expected parameters:
1345
1346						=over
1347
1348						=item C
1349
1350						the name of the hint to get the boolean value from
1351
1352						=item C
1353
1354						the value to return if the hint does not exist
1355
1356						=back
1357
1358						Returns the boolean value of a hint or the provided default value if the hint
1359						does not exist.
1360
1361						=head2 C
1362
1363						Add a function to watch a particular hint.
1364
1365						my $cb = SDL_AddHintCallback(
1366						SDL_HINT_XINPUT_ENABLED,
1367						sub {
1368						my ($userdata, $name, $oldvalue, $newvalue) = @_;
1369						...;
1370						},
1371						{ time => time( ), clicks => 3 }
1372						);
1373
1374						Expected parameters:
1375
1376						=over
1377
1378						=item C
1379
1380						the hint to watch
1381
1382						=item C
1383
1384						a code reference that will be called when the hint value changes
1385
1386						=item C
1387
1388						a pointer to pass to the callback function
1389
1390						=back
1391
1392						Returns a pointer to a L which you may pass to L<<
1393						C\|/C >>.
1394
1395						=head2 C
1396
1397						Remove a callback watching a particular hint.
1398
1399						SDL_AddHintCallback(
1400						SDL_HINT_XINPUT_ENABLED,
1401						$cb,
1402						{ time => time( ), clicks => 3 }
1403						);
1404
1405						Expected parameters:
1406
1407						=over
1408
1409						=item C
1410
1411						the hint to watch
1412
1413						=item C
1414
1415						L object returned by L<< C
1416						)>\|/C >>
1417
1418						=item C
1419
1420						a pointer to pass to the callback function
1421
1422						=back
1423
1424						=head2 C
1425
1426						Clear all hints.
1427
1428						SDL_ClearHints( );
1429
1430						This function is automatically called during L<< C\|/C
1431						>>.
1432
1433						=head1 Error Handling
1434
1435						Functions in this category provide simple error message routines for SDL. L<<
1436						C\|/C >> can be called for almost all SDL
1437						functions to determine what problems are occurring. Check the wiki page of each
1438						specific SDL function to see whether L<< C\|/C
1439						>> is meaningful for them or not. These functions may be imported with the
1440						C<:error> tag.
1441
1442						The SDL error messages are in English.
1443
1444						=head2 C
1445
1446						Set the SDL error message for the current thread.
1447
1448						Calling this function will replace any previous error message that was set.
1449
1450						This function always returns C<-1>, since SDL frequently uses C<-1> to signify
1451						an failing result, leading to this idiom:
1452
1453						if ($error_code) {
1454						return SDL_SetError( 'This operation has failed: %d', $error_code );
1455						}
1456
1457						Expected parameters:
1458
1459						=over
1460
1461						=item C
1462
1463						a C-style message format string
1464
1465						=item C<@params>
1466
1467						additional parameters matching % tokens in the C string, if any
1468
1469						=back
1470
1471						=head2 C
1472
1473						Retrieve a message about the last error that occurred on the current thread.
1474
1475						warn SDL_GetError( );
1476
1477						It is possible for multiple errors to occur before calling C.
1478						Only the last error is returned.
1479
1480						The message is only applicable when an SDL function has signaled an error. You
1481						must check the return values of SDL function calls to determine when to
1482						appropriately call C. You should B use the results of
1483						C to decide if an error has occurred! Sometimes SDL will set
1484						an error string even when reporting success.
1485
1486						SDL will B clear the error string for successful API calls. You B
1487						check return values for failure cases before you can assume the error string
1488						applies.
1489
1490						Error strings are set per-thread, so an error set in a different thread will
1491						not interfere with the current thread's operation.
1492
1493						The returned string is internally allocated and must not be freed by the
1494						application.
1495
1496						Returns a message with information about the specific error that occurred, or
1497						an empty string if there hasn't been an error message set since the last call
1498						to L<< C\|/C >>. The message is only
1499						applicable when an SDL function has signaled an error. You must check the
1500						return values of SDL function calls to determine when to appropriately call
1501						C.
1502
1503						=head2 C
1504
1505						Get the last error message that was set for the current thread.
1506
1507						my $x;
1508						warn SDL_GetErrorMsg($x, 300);
1509
1510						This allows the caller to copy the error string into a provided buffer, but
1511						otherwise operates exactly the same as L<< C\|/C
1512						)> >>.
1513
1514						=over
1515
1516						=item C
1517
1518						A buffer to fill with the last error message that was set for the current
1519						thread
1520
1521						=item C
1522
1523						The size of the buffer pointed to by the errstr parameter
1524
1525						=back
1526
1527						Returns the pointer passed in as the C parameter.
1528
1529						=head2 C
1530
1531						Clear any previous error message for this thread.
1532
1533						=head1 Log Handling
1534
1535						Simple log messages with categories and priorities. These functions may be
1536						imported with the C<:logging> tag.
1537
1538						By default, logs are quiet but if you're debugging SDL you might want:
1539
1540						SDL_LogSetAllPriority( SDL_LOG_PRIORITY_WARN );
1541
1542						Here's where the messages go on different platforms:
1543
1544						Windows debug output stream
1545						Android log output
1546						Others standard error output (STDERR)
1547
1548						Messages longer than the maximum size (4096 bytes) will be truncated.
1549
1550						=head2 C
1551
1552						Set the priority of all log categories.
1553
1554						SDL_LogSetAllPriority( SDL_LOG_PRIORITY_WARN );
1555
1556						Expected parameters:
1557
1558						=over
1559
1560						=item C
1561
1562						The SDL_LogPriority to assign. These may be imported with the L<<
1563						C<:logpriority>\|/C<:logpriority> >> tag.
1564
1565						=back
1566
1567						=head2 C
1568
1569						Set the priority of all log categories.
1570
1571						SDL_LogSetPriority( SDL_LOG_CATEGORY_APPLICATION, SDL_LOG_PRIORITY_WARN );
1572
1573						Expected parameters:
1574
1575						=over
1576
1577						=item C
1578
1579						The category to assign a priority to. These may be imported with the L<<
1580						C<:logcategory>\|/C<:logcategory> >> tag.
1581
1582						=item C
1583
1584						The SDL_LogPriority to assign. These may be imported with the L<<
1585						C<:logpriority>\|/C<:logpriority> >> tag.
1586
1587						=back
1588
1589						=head2 C
1590
1591						Get the priority of a particular log category.
1592
1593						SDL_LogGetPriority( SDL_LOG_CATEGORY_ERROR );
1594
1595						Expected parameters:
1596
1597						=over
1598
1599						=item C
1600
1601						The SDL_LogCategory to query. These may be imported with the L<<
1602						C<:logcategory>\|/C<:logcategory> >> tag.
1603
1604						=back
1605
1606						=head2 C
1607
1608						Get the priority of a particular log category.
1609
1610						SDL_LogGetPriority( SDL_LOG_CATEGORY_ERROR );
1611
1612						Expected parameters:
1613
1614						=over
1615
1616						=item C
1617
1618						The SDL_LogCategory to query. These may be imported with the L<<
1619						C<:logcategory>\|/C<:logcategory> >> tag.
1620
1621						=back
1622
1623						=head2 C
1624
1625						Reset all priorities to default.
1626
1627						SDL_LogResetPriorities( );
1628
1629						This is called by L<< C\|/C >>.
1630
1631						=head2 C
1632
1633						Log a message with C and
1634						C.
1635
1636						SDL_Log( 'HTTP Status: %s', $http->status );
1637
1638						Expected parameters:
1639
1640						=over
1641
1642						=item C
1643
1644						A C style message format string.
1645
1646						=item C<...>
1647
1648						Any additional parameters matching C<%> tokens in the C string, if any.
1649
1650						=back
1651
1652						=head2 C
1653
1654						Log a message with C.
1655
1656						SDL_LogVerbose( 'Current time: %s [%ds exec]', +localtime( ), time - $^T );
1657
1658						Expected parameters:
1659
1660						=over
1661
1662						=item C
1663
1664						The category of the message.
1665
1666						=item C
1667
1668						A C style message format string.
1669
1670						=item C<...>
1671
1672						Additional parameters matching C<%> tokens in the C string, if any.
1673
1674						=back
1675
1676						=head2 C
1677
1678						Log a message with C.
1679
1680						SDL_LogDebug( 'Current time: %s [%ds exec]', +localtime( ), time - $^T );
1681
1682						Expected parameters:
1683
1684						=over
1685
1686						=item C
1687
1688						The category of the message.
1689
1690						=item C
1691
1692						A C style message format string.
1693
1694						=item C<...>
1695
1696						Additional parameters matching C<%> tokens in the C string, if any.
1697
1698						=back
1699
1700						=head2 C
1701
1702						Log a message with C.
1703
1704						SDL_LogInfo( 'Current time: %s [%ds exec]', +localtime( ), time - $^T );
1705
1706						Expected parameters:
1707
1708						=over
1709
1710						=item C
1711
1712						The category of the message.
1713
1714						=item C
1715
1716						A C style message format string.
1717
1718						=item C<...>
1719
1720						Additional parameters matching C<%> tokens in the C string, if any.
1721
1722						=back
1723
1724						=head2 C
1725
1726						Log a message with C.
1727
1728						SDL_LogWarn( 'Current time: %s [%ds exec]', +localtime( ), time - $^T );
1729
1730						Expected parameters:
1731
1732						=over
1733
1734						=item C
1735
1736						The category of the message.
1737
1738						=item C
1739
1740						A C style message format string.
1741
1742						=item C<...>
1743
1744						Additional parameters matching C<%> tokens in the C string, if any.
1745
1746						=back
1747
1748						=head2 C
1749
1750						Log a message with C.
1751
1752						SDL_LogError( 'Current time: %s [%ds exec]', +localtime( ), time - $^T );
1753
1754						Expected parameters:
1755
1756						=over
1757
1758						=item C
1759
1760						The category of the message.
1761
1762						=item C
1763
1764						A C style message format string.
1765
1766						=item C<...>
1767
1768						Additional parameters matching C<%> tokens in the C string, if any.
1769
1770						=back
1771
1772						=head2 C
1773
1774						Log a message with C.
1775
1776						SDL_LogCritical( 'Current time: %s [%ds exec]', +localtime( ), time - $^T );
1777
1778						Expected parameters:
1779
1780						=over
1781
1782						=item C
1783
1784						The category of the message.
1785
1786						=item C
1787
1788						A C style message format string.
1789
1790						=item C<...>
1791
1792						Additional parameters matching C<%> tokens in the C string, if any.
1793
1794						=back
1795
1796						=head2 C
1797
1798						Log a message with the specified category and priority.
1799
1800						SDL_LogMessage( SDL_LOG_CATEGORY_APPLICATION, SDL_LOG_PRIORITY_CRITICAL,
1801						'Current time: %s [%ds exec]', +localtime( ), time - $^T );
1802
1803						Expected parameters:
1804
1805						=over
1806
1807						=item C
1808
1809						The category of the message.
1810
1811						=item C
1812
1813						The priority of the message.
1814
1815						=item C
1816
1817						A C style message format string.
1818
1819						=item C<...>
1820
1821						Additional parameters matching C<%> tokens in the C string, if any.
1822
1823						=back
1824
1825						=head2 C
1826
1827						Replace the default log output function with one of your own.
1828
1829						my $cb = SDL_LogSetOutputFunction( sub { ... }, {} );
1830
1831						Expected parameters:
1832
1833						=over
1834
1835						=item C
1836
1837						A coderef to call instead of the default callback.
1838
1839						This coderef should expect the following parameters:
1840
1841						=over
1842
1843						=item C
1844
1845						What was passed as C to C.
1846
1847						=item C
1848
1849						The category of the message.
1850
1851						=item C
1852
1853						The priority of the message.
1854
1855						=item C
1856
1857						The message being output.
1858
1859						=back
1860
1861						=item C
1862
1863						Data passed to the C.
1864
1865						=back
1866
1867						=head1 Querying SDL Version
1868
1869						These functions are used to collect or display information about the version of
1870						SDL that is currently being used by the program or that it was compiled
1871						against.
1872
1873						The version consists of three segments (C)
1874
1875						=over
1876
1877						=item X - Major Version, which increments with massive changes, additions, and enhancements
1878
1879						=item Y - Minor Version, which increments with backwards-compatible changes to the major revision
1880
1881						=item Z - Patchlevel, which increments with fixes to the minor revision
1882
1883						=back
1884
1885						Example: The first version of SDL 2 was 2.0.0
1886
1887						The version may also be reported as a 4-digit numeric value where the thousands
1888						place represents the major version, the hundreds place represents the minor
1889						version, and the tens and ones places represent the patchlevel (update
1890						version).
1891
1892						Example: The first version number of SDL 2 was 2000
1893
1894						=head2 C
1895
1896						Get the version of SDL that is linked against your program.
1897
1898						my $ver = SDL2::Version->new;
1899						SDL_GetVersion( $ver );
1900
1901						This function may be called safely at any time, even before L<< C
1902						)>\|/C >>.
1903
1904						Expected parameters include:
1905
1906						=over
1907
1908						=item C - An SDL2::Version object which will be filled with the proper values
1909
1910						=back
1911
1912						=head1 Display and Window Management
1913
1914						This category contains functions for handling display and window actions.
1915
1916						These functions may be imported with the C<:video> tag.
1917
1918						=head2 C
1919
1920						my $num = SDL_GetNumVideoDrivers( );
1921
1922						Get the number of video drivers compiled into SDL.
1923
1924						Returns a number >= 1 on success or a negative error code on failure; call L<<
1925						C\|/C >> for more information.
1926
1927						=head2 C
1928
1929						Get the name of a built in video driver.
1930
1931						CORE::say SDL_GetVideoDriver($_) for 0 .. SDL_GetNumVideoDrivers( ) - 1;
1932
1933						The video drivers are presented in the order in which they are normally checked
1934						during initialization.
1935
1936						Expected parameters include:
1937
1938						=over
1939
1940						=item C - the index of a video driver
1941
1942						=back
1943
1944						Returns the name of the video driver with the given C.
1945
1946						=cut
1947
1948						=head2 C
1949
1950						Initialize the video subsystem, optionally specifying a video driver.
1951
1952						SDL_VideoInit( 'x11' );
1953
1954						This function initializes the video subsystem, setting up a connection to the
1955						window manager, etc, and determines the available display modes and pixel
1956						formats, but does not initialize a window or graphics mode.
1957
1958						If you use this function and you haven't used the SDL_INIT_VIDEO flag with
1959						either SDL_Init( ) or SDL_InitSubSystem( ), you should call SDL_VideoQuit( )
1960						before calling SDL_Quit( ).
1961
1962						It is safe to call this function multiple times. SDL_VideoInit( ) will call
1963						SDL_VideoQuit( ) itself if the video subsystem has already been initialized.
1964
1965						You can use SDL_GetNumVideoDrivers( ) and SDL_GetVideoDriver( ) to find a
1966						specific `driver_name`.
1967
1968						Expected parameters include:
1969
1970						=over
1971
1972						=item C - the name of a video driver to initialize, or undef for the default driver
1973
1974						=back
1975
1976						Returns C<0> on success or a negative error code on failure; call L<<
1977						C\|/C >> for more information.
1978
1979						=head2 C
1980
1981						Shut down the video subsystem, if initialized with L<< C
1982						)>\|/C >>.
1983
1984						SDL_VideoQuit( );
1985
1986						This function closes all windows, and restores the original video mode.
1987
1988						=head2 C
1989
1990						Get the name of the currently initialized video driver.
1991
1992						my $driver = SDL_GetCurrentVideoDriver( );
1993
1994						Returns the name of the current video driver or NULL if no driver has been
1995						initialized.
1996
1997						=head2 C
1998
1999						Get the number of available video displays.
2000
2001						my $screens = SDL_GetNumVideoDisplays( );
2002
2003						Returns a number >= 1 or a negative error code on failure; call L<<
2004						C\|/C >> for more information.
2005
2006						=head2 C
2007
2008
2009						Get the name of a display in UTF-8 encoding.
2010
2011						my $screen = SDL_GetDisplayName( 0 );
2012
2013						Expected parameters include:
2014
2015						=over
2016
2017						=item C - the index of display from which the name should be queried
2018
2019						=back
2020
2021						Returns the name of a display or undefined for an invalid display index or
2022						failure; call L<< C\|/C >> for more
2023						information.
2024
2025						=head2 C
2026
2027						Get the desktop area represented by a display.
2028
2029						my $rect = SDL_GetDisplayBounds( 0 );
2030
2031						The primary display (C) is always located at 0,0.
2032
2033						Expected parameters include:
2034
2035						=over
2036
2037						=item C - the index of the display to query
2038
2039						=back
2040
2041						Returns the SDL2::Rect structure filled in with the display bounds on success
2042						or a negative error code on failure; call L<< C
2043						)>\|/C >> for more information.
2044
2045
2046						=head2 C
2047
2048						Get the usable desktop area represented by a display.
2049
2050						my $rect = SDL_GetDisplayUsableBounds( 0 );
2051
2052						The primary display (C) is always located at 0,0.
2053
2054						This is the same area as L<< C
2055						)>\|/C >> reports, but with portions reserved by
2056						the system removed. For example, on Apple's macOS, this subtracts the area
2057						occupied by the menu bar and dock.
2058
2059						Setting a window to be fullscreen generally bypasses these unusable areas, so
2060						these are good guidelines for the maximum space available to a non-fullscreen
2061						window.
2062
2063						Expected parameters include:
2064
2065						=over
2066
2067						=item C - the index of the display to query
2068
2069						=back
2070
2071						Returns the SDL2::Rect structure filled in with the display bounds on success
2072						or a negative error code on failure; call L<< C
2073						)>\|/C >> for more information. This function also returns
2074						C<-1> if the parameter C is out of range.
2075
2076						=head2 C
2077
2078						Get the dots/pixels-per-inch for a display.
2079
2080						my ( $ddpi, $hdpi, $vdpi ) = SDL_GetDisplayDPI( 0 );
2081
2082						Diagonal, horizontal and vertical DPI can all be optionally returned if the
2083						appropriate parameter is non-NULL.
2084
2085						A failure of this function usually means that either no DPI information is
2086						available or the C is out of range.
2087
2088						Expected parameters include:
2089
2090						=over
2091
2092						=item C - the index of the display from which DPI information should be queried
2093
2094						=back
2095
2096						Returns C<[ddpi, hdpi, vdip]> on success or a negative error code on failure;
2097						call L<< C\|/C >> for more information.
2098
2099						C is the diagonal DPI of the display, C is the horizontal DPI of
2100						the display, C is the vertical DPI of the display.
2101
2102						=head2 C
2103
2104						Get the orientation of a display.
2105
2106						my $orientation = SDL_GetDisplayOrientation( 0 );
2107
2108						Expected parameters include:
2109
2110						=over
2111
2112						=item C - the index of the display to query
2113
2114						=back
2115
2116						Returns a value which may be imported with C<:displayOrientation> or
2117						C if it isn't available.
2118
2119						=head2 C
2120
2121						Get the number of available display modes.
2122
2123						my $modes = SDL_GetNumDisplayModes( 0 );
2124
2125						The C needs to be in the range from C<0> to
2126						C.
2127
2128						Expected parameters include:
2129
2130						=over
2131
2132						=item C - the index of the display to query
2133
2134						=back
2135
2136						Returns a number >= 1 on success or a negative error code on failure; call L<<
2137						C\|/C >> for more information.
2138
2139
2140						=head2 C
2141
2142						Get information about a specific display mode.
2143
2144						my $mode = SDL_GetDisplayMode( 0, 0 );
2145
2146						The display modes are sorted in this priority:
2147
2148						=over
2149
2150						=item width - largest to smallest
2151
2152						=item height - largest to smallest
2153
2154						=item bits per pixel - more colors to fewer colors
2155
2156						=item packed pixel layout - largest to smallest
2157
2158						=item refresh rate - highest to lowest
2159
2160						=back
2161
2162						Expected parameters include:
2163
2164						=over
2165
2166						=item C - the index of the display to query
2167
2168						=item C - the index of the display mode to query
2169
2170						=back
2171
2172						Returns an L structure filled in with the mode at
2173						C on success or a negative error code on failure; call L<<
2174						C\|/C >> for more information.
2175
2176						=head2 C
2177
2178						Get information about the desktop's display mode.
2179
2180						my $mode = SDL_GetDesktopDisplayMode( 0 );
2181
2182						There's a difference between this function and L<< C
2183						... )>\|/C >> when SDL runs fullscreen and has
2184						changed the resolution. In that case this function will return the previous
2185						native display mode, and not the current display mode.
2186
2187						Expected parameters include:
2188
2189						=over
2190
2191						=item C - the index of the display to query
2192
2193						=back
2194
2195						Returns an L structure filled in with the current display
2196						mode on success or a negative error code on failure; call L<< C
2197						)>\|/C >> for more information.
2198
2199						=head2 C
2200
2201						my $mode = SDL_GetCurrentDisplayMode( 0 );
2202
2203						There's a difference between this function and L<< C
2204						... )>\|/C >> when SDL runs fullscreen and has
2205						changed the resolution. In that case this function will return the current
2206						display mode, and not the previous native display mode.
2207
2208						Expected parameters include:
2209
2210						=over
2211
2212						=item C - the index of the display to query
2213
2214						=back
2215
2216						Returns an L structure filled in with the current display
2217						mode on success or a negative error code on failure; call L<< C
2218						)>\|/C >> for more information.
2219
2220						=head2 C
2221
2222						Get the closes match to the requested display mode.
2223
2224						$mode = SDL_GetClosestDisplayMode( 0, $mode );
2225
2226						The available display modes are scanned and he closest mode matching the
2227						requested mode is returned. The mode format and refresh rate default to the
2228						desktop mode if they are set to 0. The modes are scanned with size being first
2229						priority, format being second priority, and finally checking the refresh rate.
2230						If all the available modes are too small, then an undefined value is returned.
2231
2232						Expected parameters include:
2233
2234						=over
2235
2236						=item C - index of the display to query
2237
2238						=item C - an L structure containing the desired display mode
2239
2240						=item C - an L structure filled in with the closest match of the available display modes
2241
2242						=back
2243
2244						Returns the passed in value C or an undefined value if no matching
2245						video mode was available; call L<< C\|/C >>
2246						for more information.
2247
2248						=head2 C
2249
2250						Get the index of the display associated with a window.
2251
2252						my $index = SDL_GetWindowDisplayIndex( $window );
2253
2254						Expected parameters include:
2255
2256						=over
2257
2258						=item C - the window to query
2259
2260						=back
2261
2262						Returns the index of the display containing the center of the window on success
2263						or a negative error code on failure; call L<< C
2264						)>\|/C >> for more information.
2265
2266						=head2 C
2267
2268						Set the display mode to use when a window is visible at fullscreen.
2269
2270						my $ok = !SDL_SetWindowDisplayMode( $window, $mode );
2271
2272						This only affects the display mode used when the window is fullscreen. To
2273						change the window size when the window is not fullscreen, use L<<
2274						C\|/C >>.
2275
2276						=head2 C
2277
2278						Query the display mode to use when a window is visible at fullscreen.
2279
2280						my $mode = SDL_GetWindowDisplayMode( $window );
2281
2282						Expected parameters include:
2283
2284						=over
2285
2286						=item C - the window to query
2287
2288						=back
2289
2290						Returns a L structure on success or a negative error code on
2291						failure; call L<< C\|/C >> for more
2292						information.
2293
2294						=head2 C
2295
2296						Get the pixel format associated with the window.
2297
2298						my $format = SDL_GetWindowPixelFormat( $window );
2299
2300						Expected parameters include:
2301
2302						=over
2303
2304						=item C - the window to query
2305
2306						=back
2307
2308						Returns the pixel format of the window on success or C
2309						on failure; call L<< C\|/C >> for more
2310						information.
2311
2312						=head2 C
2313
2314						Create a window with the specified position, dimensions, and flags.
2315
2316						my $window = SDL_CreateWindow( 'Example',
2317						SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED,
2318						1280, 720,
2319						SDL_WINDOW_SHOWN
2320						);
2321
2322						C may be any of the following OR'd together:
2323
2324						=over
2325
2326						=item C - fullscreen window
2327
2328						=item C - fullscreen window at desktop resolution
2329
2330						=item C - window usable with an OpenGL context
2331
2332						=item C - window usable with a Vulkan instance
2333
2334						=item C - window usable with a Metal instance
2335
2336						=item C - window is not visible
2337
2338						=item C - no window decoration
2339
2340						=item C - window can be resized
2341
2342						=item C - window is minimized
2343
2344						=item C - window is maximized
2345
2346						=item C - window has grabbed input focus
2347
2348						=item C - window should be created in high-DPI mode if supported (>= SDL 2.0.1)
2349
2350						=back
2351
2352						C is ignored by C. The SDL_Window is
2353						implicitly shown if C is not set. C may be
2354						queried later using L<< C\|/C
2355						)> >>.
2356
2357						On Apple's macOS, you B set the NSHighResolutionCapable Info.plist
2358						property to YES, otherwise you will not receive a High-DPI OpenGL canvas.
2359
2360						If the window is created with the C flag, its size in
2361						pixels may differ from its size in screen coordinates on platforms with
2362						high-DPI support (e.g. iOS and macOS). Use L<< C
2363						)>\|/C >> to query the client area's size in screen
2364						coordinates, and L<< C\|/C
2365						>> or L<< C\|/C >>
2366						to query the drawable size in pixels.
2367
2368						If the window is set fullscreen, the width and height parameters C and C
2369						will not be used. However, invalid size parameters (e.g. too large) may still
2370						fail. Window size is actually limited to 16384 x 16384 for all platforms at
2371						window creation.
2372
2373						If the window is created with any of the C or
2374						C flags, then the corresponding LoadLibrary function
2375						(SDL_GL_LoadLibrary or SDL_Vulkan_LoadLibrary) is called and the corresponding
2376						UnloadLibrary function is called by L<< C
2377						)>\|/C >>.
2378
2379						If C is specified and there isn't a working Vulkan driver,
2380						C will fail because L<< C
2381						)>\|/C >> will fail.
2382
2383						If C is specified on an OS that does not support Metal,
2384						C will fail.
2385
2386						On non-Apple devices, SDL requires you to either not link to the Vulkan loader
2387						or link to a dynamic library version. This limitation may be removed in a
2388						future version of SDL.
2389
2390						Expected parameters include:
2391
2392						=over
2393
2394						=item C - the title of the window, in UTF-8 encoding </td> </tr> <tr> <td class="h" > <a name="2395">2395</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2396">2396</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<x> - the x position of the window, C<SDL_WINDOWPOS_CENTERED>, or C<SDL_WINDOWPOS_UNDEFINED> </td> </tr> <tr> <td class="h" > <a name="2397">2397</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2398">2398</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<y> - the y position of the window, C<SDL_WINDOWPOS_CENTERED>, or C<SDL_WINDOWPOS_UNDEFINED> </td> </tr> <tr> <td class="h" > <a name="2399">2399</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2400">2400</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<w> - the width of the window, in screen coordinates </td> </tr> <tr> <td class="h" > <a name="2401">2401</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2402">2402</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<h> - the height of the window, in screen coordinates </td> </tr> <tr> <td class="h" > <a name="2403">2403</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2404">2404</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<flags> - 0, or one or more L<< C<:windowFlags>\|SDL2::Enum/C<:windowFlags> >> OR'd together </td> </tr> <tr> <td class="h" > <a name="2405">2405</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2406">2406</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2407">2407</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2408">2408</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the window that was created or an undefined value on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="2409">2409</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >> for more information. </td> </tr> <tr> <td class="h" > <a name="2410">2410</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2411">2411</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2412">2412</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_CreateWindowFrom( ... )> </td> </tr> <tr> <td class="h" > <a name="2413">2413</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2414">2414</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Create an SDL window from an existing native window. </td> </tr> <tr> <td class="h" > <a name="2415">2415</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2416">2416</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $window = SDL_CreateWindowFrom( $data ); </td> </tr> <tr> <td class="h" > <a name="2417">2417</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2418">2418</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> In some cases (e.g. OpenGL) and on some platforms (e.g. Microsoft Windows) the </td> </tr> <tr> <td class="h" > <a name="2419">2419</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> hint C<SDL_HINT_VIDEO_WINDOW_SHARE_PIXEL_FORMAT> needs to be configured before </td> </tr> <tr> <td class="h" > <a name="2420">2420</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> using C<SDL_CreateWindowFrom( ... )>. </td> </tr> <tr> <td class="h" > <a name="2421">2421</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2422">2422</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2423">2423</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2424">2424</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2425">2425</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2426">2426</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<data> - driver-dependant window creation data, typically your native window </td> </tr> <tr> <td class="h" > <a name="2427">2427</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2428">2428</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2429">2429</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2430">2430</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the window that was created or an undefined value on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="2431">2431</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >> for more information. </td> </tr> <tr> <td class="h" > <a name="2432">2432</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2433">2433</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowID( ... )> </td> </tr> <tr> <td class="h" > <a name="2434">2434</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2435">2435</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the numeric ID of a window. </td> </tr> <tr> <td class="h" > <a name="2436">2436</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2437">2437</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $id = SDL_GetWindowID( $window ); </td> </tr> <tr> <td class="h" > <a name="2438">2438</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2439">2439</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The numeric ID is what L<SDL2::WindowEvent> references, and is necessary to map </td> </tr> <tr> <td class="h" > <a name="2440">2440</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> these events to specific L<SDL2::Window> objects. </td> </tr> <tr> <td class="h" > <a name="2441">2441</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2442">2442</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2443">2443</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2444">2444</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2445">2445</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2446">2446</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query </td> </tr> <tr> <td class="h" > <a name="2447">2447</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2448">2448</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2449">2449</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2450">2450</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the ID of the window on success or C<0> on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="2451">2451</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >> for more information. </td> </tr> <tr> <td class="h" > <a name="2452">2452</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2453">2453</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowFromID( ... )> </td> </tr> <tr> <td class="h" > <a name="2454">2454</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2455">2455</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get a window from a stored ID. </td> </tr> <tr> <td class="h" > <a name="2456">2456</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2457">2457</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $window = SDL_GetWindowFromID( 2 ); </td> </tr> <tr> <td class="h" > <a name="2458">2458</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2459">2459</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The numeric ID is what L<SDL2::WindowEvent> references, and is necessary to map </td> </tr> <tr> <td class="h" > <a name="2460">2460</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> these events to specific L<SDL2::Window> objects. </td> </tr> <tr> <td class="h" > <a name="2461">2461</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2462">2462</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2463">2463</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2464">2464</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2465">2465</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2466">2466</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<id> - the ID of the window </td> </tr> <tr> <td class="h" > <a name="2467">2467</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2468">2468</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2469">2469</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2470">2470</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the window associated with C<id> or an undefined value if it doesn't </td> </tr> <tr> <td class="h" > <a name="2471">2471</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> exist; call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >> for more information. </td> </tr> <tr> <td class="h" > <a name="2472">2472</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2473">2473</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowFlags( ... )> </td> </tr> <tr> <td class="h" > <a name="2474">2474</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2475">2475</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the window flags. </td> </tr> <tr> <td class="h" > <a name="2476">2476</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2477">2477</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $id = SDL_GetWindowFlags( $window ); </td> </tr> <tr> <td class="h" > <a name="2478">2478</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2479">2479</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The numeric ID is what L<SDL2::WindowEvent> references, and is necessary to map </td> </tr> <tr> <td class="h" > <a name="2480">2480</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> these events to specific L<SDL2::Window> objects. </td> </tr> <tr> <td class="h" > <a name="2481">2481</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2482">2482</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2483">2483</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2484">2484</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2485">2485</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2486">2486</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query </td> </tr> <tr> <td class="h" > <a name="2487">2487</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2488">2488</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2489">2489</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2490">2490</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns a mask of the L<< C<:windowFlags>\|SDL2::Enum/C<:windowFlags> >> </td> </tr> <tr> <td class="h" > <a name="2491">2491</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> associated with C<window>. </td> </tr> <tr> <td class="h" > <a name="2492">2492</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2493">2493</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowTitle( ... )> </td> </tr> <tr> <td class="h" > <a name="2494">2494</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2495">2495</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the title of a window. </td> </tr> <tr> <td class="h" > <a name="2496">2496</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2497">2497</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowTitle( $window, 'Untitle file ' ); </td> </tr> <tr> <td class="h" > <a name="2498">2498</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2499">2499</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This string is expected to be in UTF-8 encoding. </td> </tr> <tr> <td class="h" > <a name="2500">2500</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2501">2501</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2502">2502</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2503">2503</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2504">2504</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2505">2505</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to change </td> </tr> <tr> <td class="h" > <a name="2506">2506</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2507">2507</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<title> - the desired window title in UTF-8 format </td> </tr> <tr> <td class="h" > <a name="2508">2508</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2509">2509</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2510">2510</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2511">2511</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowTitle( ... )> </td> </tr> <tr> <td class="h" > <a name="2512">2512</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2513">2513</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the title of a window. </td> </tr> <tr> <td class="h" > <a name="2514">2514</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2515">2515</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $title = SDL_GetWindowTitle( $window ); </td> </tr> <tr> <td class="h" > <a name="2516">2516</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2517">2517</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2518">2518</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2519">2519</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2520">2520</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2521">2521</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query </td> </tr> <tr> <td class="h" > <a name="2522">2522</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2523">2523</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2524">2524</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2525">2525</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the title of the window in UTF-8 format or C<""> (an empty string) if </td> </tr> <tr> <td class="h" > <a name="2526">2526</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> there is no title. </td> </tr> <tr> <td class="h" > <a name="2527">2527</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2528">2528</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowIcon( ... )> </td> </tr> <tr> <td class="h" > <a name="2529">2529</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2530">2530</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the icon for a window. </td> </tr> <tr> <td class="h" > <a name="2531">2531</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2532">2532</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowIcon( $window, $icon ); </td> </tr> <tr> <td class="h" > <a name="2533">2533</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2534">2534</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2535">2535</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2536">2536</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2537">2537</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2538">2538</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to change </td> </tr> <tr> <td class="h" > <a name="2539">2539</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2540">2540</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<icon> - an L<SDL2::Surface> structure containing the icon for the window </td> </tr> <tr> <td class="h" > <a name="2541">2541</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2542">2542</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2543">2543</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2544">2544</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowData( ... )> </td> </tr> <tr> <td class="h" > <a name="2545">2545</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2546">2546</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Associate an arbitrary named pointer with a window. </td> </tr> <tr> <td class="h" > <a name="2547">2547</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2548">2548</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $prev = SDL_SetWindowData( $window, 'test', $data ); </td> </tr> <tr> <td class="h" > <a name="2549">2549</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2550">2550</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2551">2551</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2552">2552</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2553">2553</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2554">2554</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to change </td> </tr> <tr> <td class="h" > <a name="2555">2555</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2556">2556</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<name> - the name of the pointer </td> </tr> <tr> <td class="h" > <a name="2557">2557</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2558">2558</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<userdata> - the associated pointer </td> </tr> <tr> <td class="h" > <a name="2559">2559</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2560">2560</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2561">2561</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2562">2562</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the previous value associated with C<name>. </td> </tr> <tr> <td class="h" > <a name="2563">2563</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2564">2564</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2565">2565</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowData( ... )> </td> </tr> <tr> <td class="h" > <a name="2566">2566</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2567">2567</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Retrieve the data pointer associated with a window. </td> </tr> <tr> <td class="h" > <a name="2568">2568</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2569">2569</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $data = SDL_SetWindowData( $window, 'test' ); </td> </tr> <tr> <td class="h" > <a name="2570">2570</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2571">2571</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2572">2572</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2573">2573</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2574">2574</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2575">2575</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query </td> </tr> <tr> <td class="h" > <a name="2576">2576</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2577">2577</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<name> - the name of the pointer </td> </tr> <tr> <td class="h" > <a name="2578">2578</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2579">2579</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2580">2580</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2581">2581</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the value associated with C<name>. </td> </tr> <tr> <td class="h" > <a name="2582">2582</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2583">2583</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowPosition( ... )> </td> </tr> <tr> <td class="h" > <a name="2584">2584</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2585">2585</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the position of a window. </td> </tr> <tr> <td class="h" > <a name="2586">2586</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2587">2587</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowPosition( $window, 100, 100 ); </td> </tr> <tr> <td class="h" > <a name="2588">2588</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2589">2589</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The window coordinate origin is the upper left of the display. </td> </tr> <tr> <td class="h" > <a name="2590">2590</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2591">2591</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2592">2592</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2593">2593</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2594">2594</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2595">2595</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to reposition </td> </tr> <tr> <td class="h" > <a name="2596">2596</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2597">2597</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<x> - the x coordinate of the window in screen coordinates, or C<SDL_WINDOWPOS_CENTERED> or C<SDL_WINDOWPOS_UNDEFINED> </td> </tr> <tr> <td class="h" > <a name="2598">2598</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2599">2599</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<y> - the y coordinate of the window in screen coordinates, or C<SDL_WINDOWPOS_CENTERED> or C<SDL_WINDOWPOS_UNDEFINED> </td> </tr> <tr> <td class="h" > <a name="2600">2600</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2601">2601</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2602">2602</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2603">2603</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowPosition( ... )> </td> </tr> <tr> <td class="h" > <a name="2604">2604</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2605">2605</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the position of a window. </td> </tr> <tr> <td class="h" > <a name="2606">2606</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2607">2607</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($x, $y) = SDL_GetWindowPosition( $window ); </td> </tr> <tr> <td class="h" > <a name="2608">2608</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2609">2609</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2610">2610</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2611">2611</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2612">2612</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2613">2613</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query </td> </tr> <tr> <td class="h" > <a name="2614">2614</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2615">2615</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2616">2616</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2617">2617</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the C<x> and C<y> positions of the window, in screen coordinates, </td> </tr> <tr> <td class="h" > <a name="2618">2618</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> either of which may be undefined. </td> </tr> <tr> <td class="h" > <a name="2619">2619</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2620">2620</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowSize( ... )> </td> </tr> <tr> <td class="h" > <a name="2621">2621</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2622">2622</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the size of a window's client area. </td> </tr> <tr> <td class="h" > <a name="2623">2623</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2624">2624</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowSize( $window, 100, 100 ); </td> </tr> <tr> <td class="h" > <a name="2625">2625</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2626">2626</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The window size in screen coordinates may differ from the size in pixels, if </td> </tr> <tr> <td class="h" > <a name="2627">2627</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the window was created with C<SDL_WINDOW_ALLOW_HIGHDPI> on a platform with </td> </tr> <tr> <td class="h" > <a name="2628">2628</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> high-dpi support (e.g. iOS or macOS). Use L<< C<SDL_GL_GetDrawableSize( ... </td> </tr> <tr> <td class="h" > <a name="2629">2629</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|C<SDL_GL_GetDrawableSize( ... )> >> or L<< C<SDL_GetRendererOutputSize( ... </td> </tr> <tr> <td class="h" > <a name="2630">2630</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GetRendererOutputSize( ... )> >> to get the real client area size in </td> </tr> <tr> <td class="h" > <a name="2631">2631</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> pixels. </td> </tr> <tr> <td class="h" > <a name="2632">2632</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2633">2633</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Fullscreen windows automatically match the size of the display mode, and you </td> </tr> <tr> <td class="h" > <a name="2634">2634</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> should use L<< C<SDL_SetWindowDisplayMode( ... )>\|/C<SDL_SetWindowDisplayMode( </td> </tr> <tr> <td class="h" > <a name="2635">2635</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ... )> >> to change their size. </td> </tr> <tr> <td class="h" > <a name="2636">2636</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2637">2637</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2638">2638</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2639">2639</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2640">2640</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2641">2641</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to change </td> </tr> <tr> <td class="h" > <a name="2642">2642</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2643">2643</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<w> - the width of the window in pixels, in screen coordinates, must be > 0 </td> </tr> <tr> <td class="h" > <a name="2644">2644</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2645">2645</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<h> - the height of the window in pixels, in screen coordinates, must be > 0 </td> </tr> <tr> <td class="h" > <a name="2646">2646</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2647">2647</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2648">2648</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2649">2649</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowSize( ... )> </td> </tr> <tr> <td class="h" > <a name="2650">2650</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2651">2651</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the position of a window. </td> </tr> <tr> <td class="h" > <a name="2652">2652</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2653">2653</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($w, $h) = SDL_GetWindowSize( $window ); </td> </tr> <tr> <td class="h" > <a name="2654">2654</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2655">2655</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The window size in screen coordinates may differ from the size in pixels, if </td> </tr> <tr> <td class="h" > <a name="2656">2656</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the window was created with C<SDL_WINDOW_ALLOW_HIGHDPI> on a platform with </td> </tr> <tr> <td class="h" > <a name="2657">2657</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> high-dpi support (e.g. iOS or macOS). Use L<< C<SDL_GL_GetDrawableSize( ... </td> </tr> <tr> <td class="h" > <a name="2658">2658</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|C<SDL_GL_GetDrawableSize( ... )> >>, L<< C<SDL_Vulkan_GetDrawableSize( ... </td> </tr> <tr> <td class="h" > <a name="2659">2659</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_Vulkan_GetDrawableSize( ... )> >>, or L<< </td> </tr> <tr> <td class="h" > <a name="2660">2660</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetRendererOutputSize( ... )>\|/C<SDL_GetRendererOutputSize( ... )> >> to </td> </tr> <tr> <td class="h" > <a name="2661">2661</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> get the real client area size in pixels. </td> </tr> <tr> <td class="h" > <a name="2662">2662</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2663">2663</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2664">2664</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2665">2665</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2666">2666</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2667">2667</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query the width and height from </td> </tr> <tr> <td class="h" > <a name="2668">2668</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2669">2669</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2670">2670</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2671">2671</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the C<width> and C<height> of the window, in screen coordinates, either </td> </tr> <tr> <td class="h" > <a name="2672">2672</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> of which may be undefined. </td> </tr> <tr> <td class="h" > <a name="2673">2673</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2674">2674</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowBordersSize( ... )> </td> </tr> <tr> <td class="h" > <a name="2675">2675</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2676">2676</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the size of a window's borders (decorations) around the client area. </td> </tr> <tr> <td class="h" > <a name="2677">2677</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2678">2678</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($top, $left, $bottom, $right) = SDL_GetWindowBorderSize( $window ); </td> </tr> <tr> <td class="h" > <a name="2679">2679</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2680">2680</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2681">2681</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2682">2682</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2683">2683</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2684">2684</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query the size values of the border (decorations) from </td> </tr> <tr> <td class="h" > <a name="2685">2685</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2686">2686</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2687">2687</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2688">2688</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the C<top>, C<left>, C<bottom>, and C<right> size values, any of which </td> </tr> <tr> <td class="h" > <a name="2689">2689</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> may be undefined. </td> </tr> <tr> <td class="h" > <a name="2690">2690</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2691">2691</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Note: If this function fails (returns -1), the size values will be initialized </td> </tr> <tr> <td class="h" > <a name="2692">2692</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> to C<0, 0, 0, 0>, as if the window in question was borderless. </td> </tr> <tr> <td class="h" > <a name="2693">2693</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2694">2694</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Note: This function may fail on systems where the window has not yet been </td> </tr> <tr> <td class="h" > <a name="2695">2695</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> decorated by the display server (for example, immediately after calling L<< </td> </tr> <tr> <td class="h" > <a name="2696">2696</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_CreateWindow( ... )>\|/C<SDL_CreateWindow( ... )> >> ). It is </td> </tr> <tr> <td class="h" > <a name="2697">2697</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> recommended that you wait at least until the window has been presented and </td> </tr> <tr> <td class="h" > <a name="2698">2698</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> composited, so that the window system has a chance to decorate the window and </td> </tr> <tr> <td class="h" > <a name="2699">2699</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> provide the border dimensions to SDL. </td> </tr> <tr> <td class="h" > <a name="2700">2700</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2701">2701</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function also returns C<-1> if getting the information is not supported. </td> </tr> <tr> <td class="h" > <a name="2702">2702</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2703">2703</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowMinimumSize( ... )> </td> </tr> <tr> <td class="h" > <a name="2704">2704</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2705">2705</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the minimum size of a window's client area. </td> </tr> <tr> <td class="h" > <a name="2706">2706</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2707">2707</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowMinimumSize( $window, 100, 100 ); </td> </tr> <tr> <td class="h" > <a name="2708">2708</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2709">2709</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2710">2710</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2711">2711</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2712">2712</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2713">2713</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to change </td> </tr> <tr> <td class="h" > <a name="2714">2714</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2715">2715</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<w> - the minimum width of the window in pixels </td> </tr> <tr> <td class="h" > <a name="2716">2716</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2717">2717</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<h> - the minimum height of the window in pixels </td> </tr> <tr> <td class="h" > <a name="2718">2718</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2719">2719</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2720">2720</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2721">2721</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowMinimumSize( ... )> </td> </tr> <tr> <td class="h" > <a name="2722">2722</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2723">2723</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the minimum size of a window's client area. </td> </tr> <tr> <td class="h" > <a name="2724">2724</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2725">2725</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($w, $h) = SDL_GetWindowMinimumSize( $window ); </td> </tr> <tr> <td class="h" > <a name="2726">2726</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2727">2727</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2728">2728</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2729">2729</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2730">2730</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2731">2731</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query the minimum width and minimum height from </td> </tr> <tr> <td class="h" > <a name="2732">2732</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2733">2733</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2734">2734</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2735">2735</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the minimum C<width> and minimum C<height> of the window, either of </td> </tr> <tr> <td class="h" > <a name="2736">2736</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> which may be undefined. </td> </tr> <tr> <td class="h" > <a name="2737">2737</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2738">2738</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowMaximumSize( ... )> </td> </tr> <tr> <td class="h" > <a name="2739">2739</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2740">2740</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the maximum size of a window's client area. </td> </tr> <tr> <td class="h" > <a name="2741">2741</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2742">2742</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowMaximumSize( $window, 100, 100 ); </td> </tr> <tr> <td class="h" > <a name="2743">2743</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2744">2744</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2745">2745</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2746">2746</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2747">2747</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2748">2748</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to change </td> </tr> <tr> <td class="h" > <a name="2749">2749</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2750">2750</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<w> - the maximum width of the window in pixels </td> </tr> <tr> <td class="h" > <a name="2751">2751</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2752">2752</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<h> - the maximum height of the window in pixels </td> </tr> <tr> <td class="h" > <a name="2753">2753</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2754">2754</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2755">2755</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2756">2756</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowMaximumSize( ... )> </td> </tr> <tr> <td class="h" > <a name="2757">2757</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2758">2758</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the maximum size of a window's client area. </td> </tr> <tr> <td class="h" > <a name="2759">2759</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2760">2760</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($w, $h) = SDL_GetWindowMaximumSize( $window ); </td> </tr> <tr> <td class="h" > <a name="2761">2761</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2762">2762</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2763">2763</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2764">2764</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2765">2765</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2766">2766</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query the maximum width and maximum height from </td> </tr> <tr> <td class="h" > <a name="2767">2767</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2768">2768</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2769">2769</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2770">2770</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the maximum C<width> and maximum C<height> of the window, either of </td> </tr> <tr> <td class="h" > <a name="2771">2771</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> which may be undefined. </td> </tr> <tr> <td class="h" > <a name="2772">2772</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2773">2773</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowBordered( ... )> </td> </tr> <tr> <td class="h" > <a name="2774">2774</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2775">2775</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the border state of a window. </td> </tr> <tr> <td class="h" > <a name="2776">2776</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2777">2777</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowBordered( $window, 1 ); </td> </tr> <tr> <td class="h" > <a name="2778">2778</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2779">2779</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This will add or remove the window's C<SDL_WINDOW_BORDERLESS> flag and add or </td> </tr> <tr> <td class="h" > <a name="2780">2780</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> remove the border from the actual window. This is a no-op if the window's </td> </tr> <tr> <td class="h" > <a name="2781">2781</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> border already matches the requested state. </td> </tr> <tr> <td class="h" > <a name="2782">2782</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2783">2783</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> You can't change the border state of a fullscreen window. </td> </tr> <tr> <td class="h" > <a name="2784">2784</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2785">2785</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2786">2786</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2787">2787</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2788">2788</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2789">2789</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window of which to change the border state </td> </tr> <tr> <td class="h" > <a name="2790">2790</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2791">2791</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<bordered> - false value to remove border, true value to add border </td> </tr> <tr> <td class="h" > <a name="2792">2792</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2793">2793</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2794">2794</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2795">2795</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowResizable( ... )> </td> </tr> <tr> <td class="h" > <a name="2796">2796</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2797">2797</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the user-resizable state of a window. </td> </tr> <tr> <td class="h" > <a name="2798">2798</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2799">2799</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowResizable( $window, 1 ); </td> </tr> <tr> <td class="h" > <a name="2800">2800</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2801">2801</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This will add or remove the window's C<SDL_WINDOW_RESIZABLE> flag and </td> </tr> <tr> <td class="h" > <a name="2802">2802</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> allow/disallow user resizing of the window. This is a no-op if the window's </td> </tr> <tr> <td class="h" > <a name="2803">2803</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> resizable state already matches the requested state. </td> </tr> <tr> <td class="h" > <a name="2804">2804</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2805">2805</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> You can't change the resizable state of a fullscreen window. </td> </tr> <tr> <td class="h" > <a name="2806">2806</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2807">2807</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2808">2808</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2809">2809</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2810">2810</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2811">2811</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window of which to change the border state </td> </tr> <tr> <td class="h" > <a name="2812">2812</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2813">2813</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<bordered> - true value to allow resizing, false value to disallow </td> </tr> <tr> <td class="h" > <a name="2814">2814</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2815">2815</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2816">2816</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2817">2817</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_ShowWindow( ... )> </td> </tr> <tr> <td class="h" > <a name="2818">2818</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2819">2819</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Show a window. </td> </tr> <tr> <td class="h" > <a name="2820">2820</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2821">2821</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_ShowWindow( $window ); </td> </tr> <tr> <td class="h" > <a name="2822">2822</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2823">2823</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2824">2824</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2825">2825</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2826">2826</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2827">2827</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to show </td> </tr> <tr> <td class="h" > <a name="2828">2828</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2829">2829</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2830">2830</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2831">2831</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_HideWindow( ... )> </td> </tr> <tr> <td class="h" > <a name="2832">2832</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2833">2833</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Hide a window. </td> </tr> <tr> <td class="h" > <a name="2834">2834</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2835">2835</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_HideWindow( $window ); </td> </tr> <tr> <td class="h" > <a name="2836">2836</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2837">2837</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2838">2838</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2839">2839</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2840">2840</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2841">2841</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to hide </td> </tr> <tr> <td class="h" > <a name="2842">2842</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2843">2843</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2844">2844</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2845">2845</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RaiseWindow( ... )> </td> </tr> <tr> <td class="h" > <a name="2846">2846</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2847">2847</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Raise a window above other windows and set the input focus. </td> </tr> <tr> <td class="h" > <a name="2848">2848</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2849">2849</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RaiseWindow( $window ); </td> </tr> <tr> <td class="h" > <a name="2850">2850</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2851">2851</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2852">2852</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2853">2853</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2854">2854</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2855">2855</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to raise </td> </tr> <tr> <td class="h" > <a name="2856">2856</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2857">2857</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2858">2858</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2859">2859</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_MaximizeWindow( ... )> </td> </tr> <tr> <td class="h" > <a name="2860">2860</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2861">2861</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Make a window as large as possible. </td> </tr> <tr> <td class="h" > <a name="2862">2862</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2863">2863</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_MaximizeWindow( $window ); </td> </tr> <tr> <td class="h" > <a name="2864">2864</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2865">2865</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2866">2866</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2867">2867</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2868">2868</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2869">2869</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to maximize </td> </tr> <tr> <td class="h" > <a name="2870">2870</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2871">2871</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2872">2872</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2873">2873</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_MinimizeWindow( ... )> </td> </tr> <tr> <td class="h" > <a name="2874">2874</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2875">2875</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Minimize a window to an iconic representation. </td> </tr> <tr> <td class="h" > <a name="2876">2876</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2877">2877</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_MinimizeWindow( $window ); </td> </tr> <tr> <td class="h" > <a name="2878">2878</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2879">2879</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2880">2880</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2881">2881</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2882">2882</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2883">2883</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to minimize </td> </tr> <tr> <td class="h" > <a name="2884">2884</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2885">2885</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2886">2886</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2887">2887</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RestoreWindow( ... )> </td> </tr> <tr> <td class="h" > <a name="2888">2888</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2889">2889</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Restore the size and position of a minimized or maximized window. </td> </tr> <tr> <td class="h" > <a name="2890">2890</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2891">2891</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RestoreWindow( $window ); </td> </tr> <tr> <td class="h" > <a name="2892">2892</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2893">2893</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2894">2894</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2895">2895</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2896">2896</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2897">2897</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to restore </td> </tr> <tr> <td class="h" > <a name="2898">2898</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2899">2899</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2900">2900</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2901">2901</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowFullscreen( ... )> </td> </tr> <tr> <td class="h" > <a name="2902">2902</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2903">2903</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set a window's fullscreen state. </td> </tr> <tr> <td class="h" > <a name="2904">2904</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2905">2905</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowFullscreen( $window, SDL_WINDOW_FULLSCREEN ); </td> </tr> <tr> <td class="h" > <a name="2906">2906</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2907">2907</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2908">2908</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2909">2909</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2910">2910</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2911">2911</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to change </td> </tr> <tr> <td class="h" > <a name="2912">2912</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2913">2913</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<flags> - C<SDL_WINDOW_FULLSCREEN>, C<SDL_WINDOW_FULLSCREEN_DESKTOP> or 0 </td> </tr> <tr> <td class="h" > <a name="2914">2914</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2915">2915</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2916">2916</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2917">2917</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns 0 on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="2918">2918</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >> for more information. </td> </tr> <tr> <td class="h" > <a name="2919">2919</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2920">2920</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowSurface( ... )> </td> </tr> <tr> <td class="h" > <a name="2921">2921</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2922">2922</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the SDL surface associated with the window. </td> </tr> <tr> <td class="h" > <a name="2923">2923</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2924">2924</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $surface = SDL_GetWindowSurface( $window ); </td> </tr> <tr> <td class="h" > <a name="2925">2925</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2926">2926</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> A new surface will be created with the optimal format for the window, if </td> </tr> <tr> <td class="h" > <a name="2927">2927</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> necessary. This surface will be freed when the window is destroyed. Do not free </td> </tr> <tr> <td class="h" > <a name="2928">2928</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> this surface. </td> </tr> <tr> <td class="h" > <a name="2929">2929</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2930">2930</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This surface will be invalidated if the window is resized. After resizing a </td> </tr> <tr> <td class="h" > <a name="2931">2931</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> window this function must be called again to return a valid surface. </td> </tr> <tr> <td class="h" > <a name="2932">2932</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2933">2933</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> You may not combine this with 3D or the rendering API on this window. </td> </tr> <tr> <td class="h" > <a name="2934">2934</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2935">2935</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function is affected by C<SDL_HINT_FRAMEBUFFER_ACCELERATION>. </td> </tr> <tr> <td class="h" > <a name="2936">2936</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2937">2937</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2938">2938</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2939">2939</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2940">2940</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2941">2941</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query </td> </tr> <tr> <td class="h" > <a name="2942">2942</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2943">2943</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2944">2944</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2945">2945</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the surface associated with the window, or an undefined on failure; </td> </tr> <tr> <td class="h" > <a name="2946">2946</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >> for more information. </td> </tr> <tr> <td class="h" > <a name="2947">2947</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2948">2948</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_UpdateWindowSurface( ... )> </td> </tr> <tr> <td class="h" > <a name="2949">2949</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2950">2950</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Copy the window surface to the screen. </td> </tr> <tr> <td class="h" > <a name="2951">2951</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2952">2952</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $ok = !SDL_UpdateWindowSurface( $window ); </td> </tr> <tr> <td class="h" > <a name="2953">2953</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2954">2954</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This is the function you use to reflect any changes to the surface on the </td> </tr> <tr> <td class="h" > <a name="2955">2955</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> screen. </td> </tr> <tr> <td class="h" > <a name="2956">2956</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2957">2957</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2958">2958</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2959">2959</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2960">2960</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2961">2961</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query </td> </tr> <tr> <td class="h" > <a name="2962">2962</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2963">2963</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2964">2964</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2965">2965</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="2966">2966</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >> for more information. </td> </tr> <tr> <td class="h" > <a name="2967">2967</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2968">2968</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_UpdateWindowSurfaceRects( ... )> </td> </tr> <tr> <td class="h" > <a name="2969">2969</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2970">2970</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Copy areas of the window surface to the screen. </td> </tr> <tr> <td class="h" > <a name="2971">2971</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2972">2972</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_UpdateWindowSurfaceRects( $window, @recs ); </td> </tr> <tr> <td class="h" > <a name="2973">2973</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2974">2974</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This is the function you use to reflect changes to portions of the surface on </td> </tr> <tr> <td class="h" > <a name="2975">2975</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the screen. </td> </tr> <tr> <td class="h" > <a name="2976">2976</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2977">2977</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="2978">2978</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2979">2979</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="2980">2980</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2981">2981</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to update </td> </tr> <tr> <td class="h" > <a name="2982">2982</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2983">2983</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rects> - an array of L<SDL2::Rect> structures representing areas of the surface to copy </td> </tr> <tr> <td class="h" > <a name="2984">2984</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2985">2985</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="2986">2986</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2987">2987</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="2988">2988</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >> for more information. </td> </tr> <tr> <td class="h" > <a name="2989">2989</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2990">2990</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowGrab( ... )> </td> </tr> <tr> <td class="h" > <a name="2991">2991</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2992">2992</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set a window's input grab mode. </td> </tr> <tr> <td class="h" > <a name="2993">2993</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2994">2994</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowGrab( $window, 1 ); </td> </tr> <tr> <td class="h" > <a name="2995">2995</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2996">2996</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> When input is grabbed the mouse is confined to the window. </td> </tr> <tr> <td class="h" > <a name="2997">2997</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="2998">2998</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If the caller enables a grab while another window is currently grabbed, the </td> </tr> <tr> <td class="h" > <a name="2999">2999</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> other window loses its grab in favor of the caller's window. </td> </tr> <tr> <td class="h" > <a name="3000">3000</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3001">3001</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3002">3002</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3003">3003</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3004">3004</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3005">3005</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window for which the input grab mode should be set </td> </tr> <tr> <td class="h" > <a name="3006">3006</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3007">3007</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<grabbed> - a true value to grab input or a false value to release input </td> </tr> <tr> <td class="h" > <a name="3008">3008</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3009">3009</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3010">3010</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3011">3011</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowKeyboardGrab( ... )> </td> </tr> <tr> <td class="h" > <a name="3012">3012</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3013">3013</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set a window's keyboard grab mode. </td> </tr> <tr> <td class="h" > <a name="3014">3014</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3015">3015</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowKeyboardGrab( $window, 1 ); </td> </tr> <tr> <td class="h" > <a name="3016">3016</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3017">3017</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If the caller enables a grab while another window is currently grabbed, the </td> </tr> <tr> <td class="h" > <a name="3018">3018</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> other window loses its grab in favor of the caller's window. </td> </tr> <tr> <td class="h" > <a name="3019">3019</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3020">3020</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3021">3021</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3022">3022</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3023">3023</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3024">3024</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - The window for which the keyboard grab mode should be set. </td> </tr> <tr> <td class="h" > <a name="3025">3025</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3026">3026</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<grabbed> - This is true to grab keyboard, and false to release. </td> </tr> <tr> <td class="h" > <a name="3027">3027</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3028">3028</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3029">3029</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3030">3030</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowMouseGrab( ... )> </td> </tr> <tr> <td class="h" > <a name="3031">3031</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3032">3032</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set a window's mouse grab mode. </td> </tr> <tr> <td class="h" > <a name="3033">3033</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3034">3034</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowMouseGrab( $window, 1 ); </td> </tr> <tr> <td class="h" > <a name="3035">3035</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3036">3036</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3037">3037</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3038">3038</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3039">3039</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3040">3040</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - The window for which the mouse grab mode should be set. </td> </tr> <tr> <td class="h" > <a name="3041">3041</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3042">3042</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<grabbed> - This is true to grab mouse, and false to release. </td> </tr> <tr> <td class="h" > <a name="3043">3043</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3044">3044</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3045">3045</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3046">3046</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If the caller enables a grab while another window is currently grabbed, the </td> </tr> <tr> <td class="h" > <a name="3047">3047</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> other window loses its grab in favor of the caller's window. </td> </tr> <tr> <td class="h" > <a name="3048">3048</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3049">3049</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowGrab( ... )> </td> </tr> <tr> <td class="h" > <a name="3050">3050</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3051">3051</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get a window's input grab mode. </td> </tr> <tr> <td class="h" > <a name="3052">3052</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3053">3053</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $grabbing = SDL_GetWindowGrab( $window ); </td> </tr> <tr> <td class="h" > <a name="3054">3054</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3055">3055</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3056">3056</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3057">3057</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3058">3058</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3059">3059</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query </td> </tr> <tr> <td class="h" > <a name="3060">3060</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3061">3061</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3062">3062</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3063">3063</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns true if input is grabbed, false otherwise. </td> </tr> <tr> <td class="h" > <a name="3064">3064</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3065">3065</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowKeyboardGrab( ... )> </td> </tr> <tr> <td class="h" > <a name="3066">3066</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3067">3067</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get a window's keyboard grab mode. </td> </tr> <tr> <td class="h" > <a name="3068">3068</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3069">3069</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $keyboard = SDL_GetWindowKeyboardGrab( $window ); </td> </tr> <tr> <td class="h" > <a name="3070">3070</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3071">3071</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3072">3072</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3073">3073</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3074">3074</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3075">3075</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query </td> </tr> <tr> <td class="h" > <a name="3076">3076</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3077">3077</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3078">3078</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3079">3079</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns true if keyboard is grabbed, and false otherwise. </td> </tr> <tr> <td class="h" > <a name="3080">3080</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3081">3081</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowMouseGrab( ... )> </td> </tr> <tr> <td class="h" > <a name="3082">3082</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3083">3083</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get a window's mouse grab mode. </td> </tr> <tr> <td class="h" > <a name="3084">3084</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3085">3085</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $mouse = SDL_GetWindowMouseGrab( $window ); </td> </tr> <tr> <td class="h" > <a name="3086">3086</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3087">3087</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3088">3088</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3089">3089</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3090">3090</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3091">3091</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query </td> </tr> <tr> <td class="h" > <a name="3092">3092</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3093">3093</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3094">3094</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3095">3095</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This returns true if mouse is grabbed, and false otherwise. </td> </tr> <tr> <td class="h" > <a name="3096">3096</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3097">3097</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetGrabbedWindow( )> </td> </tr> <tr> <td class="h" > <a name="3098">3098</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3099">3099</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the window that currently has an input grab enabled. </td> </tr> <tr> <td class="h" > <a name="3100">3100</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3101">3101</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $window = SDL_GetGrabbedWindow( ); </td> </tr> <tr> <td class="h" > <a name="3102">3102</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3103">3103</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the window if input is grabbed or undefined otherwise. </td> </tr> <tr> <td class="h" > <a name="3104">3104</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3105">3105</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowBrightness( ... )> </td> </tr> <tr> <td class="h" > <a name="3106">3106</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3107">3107</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the brightness (gamma multiplier) for a given window's display. </td> </tr> <tr> <td class="h" > <a name="3108">3108</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3109">3109</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $ok = !SDL_SetWindowBrightness( $window, 2 ); </td> </tr> <tr> <td class="h" > <a name="3110">3110</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3111">3111</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Despite the name and signature, this method sets the brightness of the entire </td> </tr> <tr> <td class="h" > <a name="3112">3112</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> display, not an individual window. A window is considered to be owned by the </td> </tr> <tr> <td class="h" > <a name="3113">3113</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> display that contains the window's center pixel. (The index of this display can </td> </tr> <tr> <td class="h" > <a name="3114">3114</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> be retrieved using L<< C<SDL_GetWindowDisplayIndex( ... </td> </tr> <tr> <td class="h" > <a name="3115">3115</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GetWindowDisplayIndex( ... )> >>.) The brightness set will not follow </td> </tr> <tr> <td class="h" > <a name="3116">3116</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the window if it is moved to another display. </td> </tr> <tr> <td class="h" > <a name="3117">3117</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3118">3118</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Many platforms will refuse to set the display brightness in modern times. You </td> </tr> <tr> <td class="h" > <a name="3119">3119</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> are better off using a shader to adjust gamma during rendering, or something </td> </tr> <tr> <td class="h" > <a name="3120">3120</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> similar. </td> </tr> <tr> <td class="h" > <a name="3121">3121</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3122">3122</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters includes: </td> </tr> <tr> <td class="h" > <a name="3123">3123</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3124">3124</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3125">3125</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3126">3126</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window used to select the display whose brightness will be changed </td> </tr> <tr> <td class="h" > <a name="3127">3127</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3128">3128</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<brightness> - the brightness (gamma multiplier) value to set where 0.0 is completely dark and 1.0 is normal brightness </td> </tr> <tr> <td class="h" > <a name="3129">3129</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3130">3130</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3131">3131</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3132">3132</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="3133">3133</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3134">3134</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3135">3135</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowBrightness( ... )> </td> </tr> <tr> <td class="h" > <a name="3136">3136</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3137">3137</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the brightness (gamma multiplier) for a given window's display. </td> </tr> <tr> <td class="h" > <a name="3138">3138</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3139">3139</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $gamma = SDL_GetWindowBrightness( $window ); </td> </tr> <tr> <td class="h" > <a name="3140">3140</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3141">3141</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Despite the name and signature, this method retrieves the brightness of the </td> </tr> <tr> <td class="h" > <a name="3142">3142</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> entire display, not an individual window. A window is considered to be owned by </td> </tr> <tr> <td class="h" > <a name="3143">3143</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the display that contains the window's center pixel. (The index of this display </td> </tr> <tr> <td class="h" > <a name="3144">3144</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> can be retrieved using L<< C<SDL_GetWindowDisplayIndex( ... </td> </tr> <tr> <td class="h" > <a name="3145">3145</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GetWindowDisplayIndex( ... )> >>.) </td> </tr> <tr> <td class="h" > <a name="3146">3146</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3147">3147</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3148">3148</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3149">3149</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3150">3150</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3151">3151</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window used to select the display whose brightness will be queried </td> </tr> <tr> <td class="h" > <a name="3152">3152</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3153">3153</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3154">3154</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3155">3155</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the brightness for the display where 0.0 is completely dark and C<1.0> </td> </tr> <tr> <td class="h" > <a name="3156">3156</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> is normal brightness. </td> </tr> <tr> <td class="h" > <a name="3157">3157</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3158">3158</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowOpacity( ... )> </td> </tr> <tr> <td class="h" > <a name="3159">3159</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3160">3160</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the opacity for a window. </td> </tr> <tr> <td class="h" > <a name="3161">3161</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3162">3162</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowOpacity( $window, .5 ); </td> </tr> <tr> <td class="h" > <a name="3163">3163</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3164">3164</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The parameter C<opacity> will be clamped internally between C<0.0> </td> </tr> <tr> <td class="h" > <a name="3165">3165</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> (transparent) and C<1.0> (opaque). </td> </tr> <tr> <td class="h" > <a name="3166">3166</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3167">3167</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function also returns C<-1> if setting the opacity isn't supported. </td> </tr> <tr> <td class="h" > <a name="3168">3168</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3169">3169</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3170">3170</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3171">3171</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3172">3172</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3173">3173</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window which will be made transparent or opaque </td> </tr> <tr> <td class="h" > <a name="3174">3174</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3175">3175</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<opacity> - the opacity value (0.0 - transparent, 1.0 - opaque) </td> </tr> <tr> <td class="h" > <a name="3176">3176</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3177">3177</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3178">3178</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3179">3179</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="3180">3180</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3181">3181</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3182">3182</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowOpacity( ... )> </td> </tr> <tr> <td class="h" > <a name="3183">3183</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3184">3184</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the opacity of a window. </td> </tr> <tr> <td class="h" > <a name="3185">3185</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3186">3186</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $opacity = SDL_GetWindowOpacity( $window ); </td> </tr> <tr> <td class="h" > <a name="3187">3187</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3188">3188</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If transparency isn't supported on this platform, opacity will be reported as </td> </tr> <tr> <td class="h" > <a name="3189">3189</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> 1.0 without error. </td> </tr> <tr> <td class="h" > <a name="3190">3190</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3191">3191</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The parameter C<opacity> is ignored if it is undefined. </td> </tr> <tr> <td class="h" > <a name="3192">3192</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3193">3193</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function also returns C<-1> if an invalid window was provided. </td> </tr> <tr> <td class="h" > <a name="3194">3194</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3195">3195</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3196">3196</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3197">3197</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3198">3198</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3199">3199</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to get the current opacity value from </td> </tr> <tr> <td class="h" > <a name="3200">3200</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3201">3201</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3202">3202</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3203">3203</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the current opacity on success or a negative error code on failure; </td> </tr> <tr> <td class="h" > <a name="3204">3204</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3205">3205</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3206">3206</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowModalFor( ... )> </td> </tr> <tr> <td class="h" > <a name="3207">3207</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3208">3208</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the window as a modal for another window. </td> </tr> <tr> <td class="h" > <a name="3209">3209</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3210">3210</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $ok = !SDL_SetWindowModalFor( $winodw, $parent ); </td> </tr> <tr> <td class="h" > <a name="3211">3211</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3212">3212</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3213">3213</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3214">3214</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3215">3215</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3216">3216</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<modal_window> - the window that should be set modal </td> </tr> <tr> <td class="h" > <a name="3217">3217</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3218">3218</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<parent_window> - the parent window for the modal window </td> </tr> <tr> <td class="h" > <a name="3219">3219</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3220">3220</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3221">3221</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3222">3222</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="3223">3223</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3224">3224</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3225">3225</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3226">3226</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowInputFocus( ... )> </td> </tr> <tr> <td class="h" > <a name="3227">3227</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3228">3228</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Explicitly set input focus to the window. </td> </tr> <tr> <td class="h" > <a name="3229">3229</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3230">3230</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowInputFocus( $window ); </td> </tr> <tr> <td class="h" > <a name="3231">3231</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3232">3232</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> You almost certainly want L<< C<SDL_RaiseWindow( ... )>\|/C<SDL_RaiseWindow( ... </td> </tr> <tr> <td class="h" > <a name="3233">3233</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )> >> instead of this function. Use this with caution, as you might give focus </td> </tr> <tr> <td class="h" > <a name="3234">3234</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> to a window that is completely obscured by other windows. </td> </tr> <tr> <td class="h" > <a name="3235">3235</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3236">3236</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3237">3237</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3238">3238</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3239">3239</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3240">3240</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window that should get the input focus </td> </tr> <tr> <td class="h" > <a name="3241">3241</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3242">3242</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3243">3243</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3244">3244</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="3245">3245</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3246">3246</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3247">3247</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowGammaRamp( ... )> </td> </tr> <tr> <td class="h" > <a name="3248">3248</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3249">3249</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the gamma ramp for the display that owns a given window. </td> </tr> <tr> <td class="h" > <a name="3250">3250</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3251">3251</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $ok = !SDL_SetWindowGammaRamp( $window, \@red, \@green, \@blue ); </td> </tr> <tr> <td class="h" > <a name="3252">3252</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3253">3253</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the gamma translation table for the red, green, and blue channels of the </td> </tr> <tr> <td class="h" > <a name="3254">3254</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> video hardware. Each table is an array of 256 16-bit quantities, representing a </td> </tr> <tr> <td class="h" > <a name="3255">3255</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> mapping between the input and output for that channel. The input is the index </td> </tr> <tr> <td class="h" > <a name="3256">3256</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> into the array, and the output is the 16-bit gamma value at that index, scaled </td> </tr> <tr> <td class="h" > <a name="3257">3257</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> to the output color precision. Despite the name and signature, this method sets </td> </tr> <tr> <td class="h" > <a name="3258">3258</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the gamma ramp of the entire display, not an individual window. A window is </td> </tr> <tr> <td class="h" > <a name="3259">3259</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> considered to be owned by the display that contains the window's center pixel. </td> </tr> <tr> <td class="h" > <a name="3260">3260</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> (The index of this display can be retrieved using L<< </td> </tr> <tr> <td class="h" > <a name="3261">3261</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetWindowDisplayIndex( ... )>\|/C<SDL_GetWindowDisplayIndex( ... )> >>.) </td> </tr> <tr> <td class="h" > <a name="3262">3262</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The gamma ramp set will not follow the window if it is moved to another </td> </tr> <tr> <td class="h" > <a name="3263">3263</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> display. </td> </tr> <tr> <td class="h" > <a name="3264">3264</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3265">3265</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3266">3266</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3267">3267</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3268">3268</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3269">3269</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window used to select the display whose gamma ramp will be changed </td> </tr> <tr> <td class="h" > <a name="3270">3270</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3271">3271</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<red> - a 256 element array of 16-bit quantities representing the translation table for the red channel, or NULL </td> </tr> <tr> <td class="h" > <a name="3272">3272</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3273">3273</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<green> - a 256 element array of 16-bit quantities representing the translation table for the green channel, or NULL </td> </tr> <tr> <td class="h" > <a name="3274">3274</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3275">3275</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<blue> - a 256 element array of 16-bit quantities representing the translation table for the blue channel, or NULL </td> </tr> <tr> <td class="h" > <a name="3276">3276</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3277">3277</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3278">3278</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3279">3279</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="3280">3280</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3281">3281</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3282">3282</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetWindowGammaRamp( ... )> </td> </tr> <tr> <td class="h" > <a name="3283">3283</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3284">3284</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the gamma ramp for a given window's display. </td> </tr> <tr> <td class="h" > <a name="3285">3285</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3286">3286</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($red, $green, $blue) = SDL_GetWindowGammaRamp( $window ); </td> </tr> <tr> <td class="h" > <a name="3287">3287</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3288">3288</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Despite the name and signature, this method retrieves the gamma ramp of the </td> </tr> <tr> <td class="h" > <a name="3289">3289</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> entire display, not an individual window. A window is considered to be owned by </td> </tr> <tr> <td class="h" > <a name="3290">3290</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the display that contains the window's center pixel. (The index of this display </td> </tr> <tr> <td class="h" > <a name="3291">3291</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> can be retrieved using L<< C<SDL_GetWindowDisplayIndex( ... </td> </tr> <tr> <td class="h" > <a name="3292">3292</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GetWindowDisplayIndex( ... )> >>.) </td> </tr> <tr> <td class="h" > <a name="3293">3293</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3294">3294</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3295">3295</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3296">3296</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3297">3297</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3298">3298</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window used to select the display whose gamma ramp will be queried </td> </tr> <tr> <td class="h" > <a name="3299">3299</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3300">3300</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3301">3301</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3302">3302</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns three 256 element arrays of 16-bit quantities filled in with the </td> </tr> <tr> <td class="h" > <a name="3303">3303</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> translation table for the red, gree, and blue channels on success or a negative </td> </tr> <tr> <td class="h" > <a name="3304">3304</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> error code on failure; call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) </td> </tr> <tr> <td class="h" > <a name="3305">3305</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> for more information. </td> </tr> <tr> <td class="h" > <a name="3306">3306</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3307">3307</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetWindowHitTest( ... )> </td> </tr> <tr> <td class="h" > <a name="3308">3308</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3309">3309</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Provide a callback that decides if a window region has special properties. </td> </tr> <tr> <td class="h" > <a name="3310">3310</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3311">3311</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetWindowHitTest( $window, sub ($win, $point, $data) { </td> </tr> <tr> <td class="h" > <a name="3312">3312</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> warn sprintf 'Click at x:%d y:%d', $point->x, $point->y; </td> </tr> <tr> <td class="h" > <a name="3313">3313</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ...; </td> </tr> <tr> <td class="h" > <a name="3314">3314</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> }); </td> </tr> <tr> <td class="h" > <a name="3315">3315</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3316">3316</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Normally, windows are dragged and resized by decorations provided by the system </td> </tr> <tr> <td class="h" > <a name="3317">3317</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> window manager (a title bar, borders, etc), but for some apps, it makes sense </td> </tr> <tr> <td class="h" > <a name="3318">3318</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> to drag them from somewhere else inside the window itself; for example, one </td> </tr> <tr> <td class="h" > <a name="3319">3319</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> might have a borderless window that wants to be draggable from any part, or </td> </tr> <tr> <td class="h" > <a name="3320">3320</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> simulate its own title bar, etc. </td> </tr> <tr> <td class="h" > <a name="3321">3321</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3322">3322</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function lets the app provide a callback that designates pieces of a given </td> </tr> <tr> <td class="h" > <a name="3323">3323</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> window as special. This callback is run during event processing if we need to </td> </tr> <tr> <td class="h" > <a name="3324">3324</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> tell the OS to treat a region of the window specially; the use of this callback </td> </tr> <tr> <td class="h" > <a name="3325">3325</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> is known as "hit testing." </td> </tr> <tr> <td class="h" > <a name="3326">3326</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3327">3327</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Mouse input may not be delivered to your application if it is within a special </td> </tr> <tr> <td class="h" > <a name="3328">3328</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> area; the OS will often apply that input to moving the window or resizing the </td> </tr> <tr> <td class="h" > <a name="3329">3329</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> window and not deliver it to the application. </td> </tr> <tr> <td class="h" > <a name="3330">3330</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3331">3331</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Specifying undef for a callback disables hit-testing. Hit-testing is disabled </td> </tr> <tr> <td class="h" > <a name="3332">3332</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> by default. </td> </tr> <tr> <td class="h" > <a name="3333">3333</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3334">3334</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Platforms that don't support this functionality will return C<-1> </td> </tr> <tr> <td class="h" > <a name="3335">3335</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> unconditionally, even if you're attempting to disable hit-testing. </td> </tr> <tr> <td class="h" > <a name="3336">3336</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3337">3337</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Your callback may fire at any time, and its firing does not indicate any </td> </tr> <tr> <td class="h" > <a name="3338">3338</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> specific behavior (for example, on Windows, this certainly might fire when the </td> </tr> <tr> <td class="h" > <a name="3339">3339</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> OS is deciding whether to drag your window, but it fires for lots of other </td> </tr> <tr> <td class="h" > <a name="3340">3340</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> reasons, too, some unrelated to anything you probably care about B<and when the </td> </tr> <tr> <td class="h" > <a name="3341">3341</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> mouse isn't actually at the location it is testing>). Since this can fire at </td> </tr> <tr> <td class="h" > <a name="3342">3342</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> any time, you should try to keep your callback efficient, devoid of </td> </tr> <tr> <td class="h" > <a name="3343">3343</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> allocations, etc. </td> </tr> <tr> <td class="h" > <a name="3344">3344</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3345">3345</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3346">3346</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3347">3347</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3348">3348</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3349">3349</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to set hit-testing on </td> </tr> <tr> <td class="h" > <a name="3350">3350</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3351">3351</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<callback> - the function to call when doing a hit-test </td> </tr> <tr> <td class="h" > <a name="3352">3352</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3353">3353</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<callback_data> - an app-defined void pointer passed to C<callback> </td> </tr> <tr> <td class="h" > <a name="3354">3354</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3355">3355</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3356">3356</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3357">3357</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or C<-1> on error (including unsupported); call L<< </td> </tr> <tr> <td class="h" > <a name="3358">3358</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3359">3359</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3360">3360</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_FlashWindow( ... )> </td> </tr> <tr> <td class="h" > <a name="3361">3361</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3362">3362</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Request a window to give a signal, e.g. a visual signal, to demand attention </td> </tr> <tr> <td class="h" > <a name="3363">3363</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> from the user. </td> </tr> <tr> <td class="h" > <a name="3364">3364</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3365">3365</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_FlashWindow( $window, 10 ); </td> </tr> <tr> <td class="h" > <a name="3366">3366</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3367">3367</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3368">3368</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3369">3369</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3370">3370</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3371">3371</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to request the flashing for </td> </tr> <tr> <td class="h" > <a name="3372">3372</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3373">3373</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<flash_count> - number of times the window gets flashed on systems that support flashing the window multiple times, like Windows, else it is ignored </td> </tr> <tr> <td class="h" > <a name="3374">3374</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3375">3375</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3376">3376</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3377">3377</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="3378">3378</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3379">3379</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3380">3380</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_DestroyWindow( ... )> </td> </tr> <tr> <td class="h" > <a name="3381">3381</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3382">3382</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Destroy a window. </td> </tr> <tr> <td class="h" > <a name="3383">3383</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3384">3384</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_DestoryWindow( $window ); </td> </tr> <tr> <td class="h" > <a name="3385">3385</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3386">3386</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If C<window> is undefined, this function will return immediately after setting </td> </tr> <tr> <td class="h" > <a name="3387">3387</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the SDL error message to "Invalid window". See L<< C<SDL_GetError( </td> </tr> <tr> <td class="h" > <a name="3388">3388</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GetError( )> >>( ). </td> </tr> <tr> <td class="h" > <a name="3389">3389</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3390">3390</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3391">3391</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3392">3392</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3393">3393</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3394">3394</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to destroy </td> </tr> <tr> <td class="h" > <a name="3395">3395</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3396">3396</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3397">3397</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3398">3398</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_IsScreenSaverEnabled( ... )> </td> </tr> <tr> <td class="h" > <a name="3399">3399</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3400">3400</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Check whether the screensaver is currently enabled. </td> </tr> <tr> <td class="h" > <a name="3401">3401</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3402">3402</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $enabled = SDL_IsScreenSaverEnabled( ); </td> </tr> <tr> <td class="h" > <a name="3403">3403</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3404">3404</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The screensaver is disabled by default since SDL 2.0.2. Before SDL 2.0.2 the </td> </tr> <tr> <td class="h" > <a name="3405">3405</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> screensaver was enabled by default. </td> </tr> <tr> <td class="h" > <a name="3406">3406</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3407">3407</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The default can also be changed using C<SDL_HINT_VIDEO_ALLOW_SCREENSAVER>. </td> </tr> <tr> <td class="h" > <a name="3408">3408</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3409">3409</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns true if the screensaver is enabled, false if it is disabled. </td> </tr> <tr> <td class="h" > <a name="3410">3410</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3411">3411</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_EnableScreenSaver( ... )> </td> </tr> <tr> <td class="h" > <a name="3412">3412</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3413">3413</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Allow the screen to be blanked by a screen saver. </td> </tr> <tr> <td class="h" > <a name="3414">3414</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3415">3415</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_EnableScreenSaver( ); </td> </tr> <tr> <td class="h" > <a name="3416">3416</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3417">3417</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3418">3418</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_DisableScreenSaver( ... )> </td> </tr> <tr> <td class="h" > <a name="3419">3419</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3420">3420</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Prevent the screen from being blanked by a screen saver. </td> </tr> <tr> <td class="h" > <a name="3421">3421</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3422">3422</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_DisableScreenSaver( ); </td> </tr> <tr> <td class="h" > <a name="3423">3423</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3424">3424</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If you disable the screensaver, it is automatically re-enabled when SDL quits. </td> </tr> <tr> <td class="h" > <a name="3425">3425</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3426">3426</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head1 OpenGL Support Functions </td> </tr> <tr> <td class="h" > <a name="3427">3427</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3428">3428</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> These may be imported with the C<:opengl> tag. </td> </tr> <tr> <td class="h" > <a name="3429">3429</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3430">3430</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_LoadLibrary( ... )> </td> </tr> <tr> <td class="h" > <a name="3431">3431</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3432">3432</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Dynamically load an OpenGL library. </td> </tr> <tr> <td class="h" > <a name="3433">3433</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3434">3434</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $ok = SDL_GL_LoadLibrary( ); </td> </tr> <tr> <td class="h" > <a name="3435">3435</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3436">3436</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This should be done after initializing the video driver, but before creating </td> </tr> <tr> <td class="h" > <a name="3437">3437</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> any OpenGL windows. If no OpenGL library is loaded, the default library will be </td> </tr> <tr> <td class="h" > <a name="3438">3438</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> loaded upon creation of the first OpenGL window. </td> </tr> <tr> <td class="h" > <a name="3439">3439</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3440">3440</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If you do this, you need to retrieve all of the GL functions used in your </td> </tr> <tr> <td class="h" > <a name="3441">3441</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> program from the dynamic library using L<< C<SDL_GL_GetProcAddress( </td> </tr> <tr> <td class="h" > <a name="3442">3442</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GL_GetProcAddress( )> >>. </td> </tr> <tr> <td class="h" > <a name="3443">3443</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3444">3444</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3445">3445</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3446">3446</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3447">3447</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3448">3448</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<path> - the platform dependent OpenGL library name, or undef to open the default OpenGL library </td> </tr> <tr> <td class="h" > <a name="3449">3449</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3450">3450</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3451">3451</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3452">3452</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="3453">3453</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3454">3454</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3455">3455</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_GetProcAddress( ... )> </td> </tr> <tr> <td class="h" > <a name="3456">3456</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3457">3457</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get an OpenGL function by name. </td> </tr> <tr> <td class="h" > <a name="3458">3458</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3459">3459</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $ptr = SDL_GL_GetProcAddress( 'glGenBuffers' ); </td> </tr> <tr> <td class="h" > <a name="3460">3460</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ...; # TODO </td> </tr> <tr> <td class="h" > <a name="3461">3461</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> # TODO: In the future, this should return an XSUB loaded with FFI. </td> </tr> <tr> <td class="h" > <a name="3462">3462</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3463">3463</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If the GL library is loaded at runtime with L<< C<SDL_GL_LoadLibrary( ... </td> </tr> <tr> <td class="h" > <a name="3464">3464</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GL_LoadLibrary( ... )> >>, then all GL functions must be retrieved </td> </tr> <tr> <td class="h" > <a name="3465">3465</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> this way. Usually this is used to retrieve function pointers to OpenGL </td> </tr> <tr> <td class="h" > <a name="3466">3466</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> extensions. </td> </tr> <tr> <td class="h" > <a name="3467">3467</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3468">3468</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> There are some quirks to looking up OpenGL functions that require some extra </td> </tr> <tr> <td class="h" > <a name="3469">3469</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> care from the application. If you code carefully, you can handle these quirks </td> </tr> <tr> <td class="h" > <a name="3470">3470</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> without any platform-specific code, though: </td> </tr> <tr> <td class="h" > <a name="3471">3471</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3472">3472</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3473">3473</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3474">3474</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item On Windows, function pointers are specific to the current GL context; </td> </tr> <tr> <td class="h" > <a name="3475">3475</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> this means you need to have created a GL context and made it current before </td> </tr> <tr> <td class="h" > <a name="3476">3476</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> calling SDL_GL_GetProcAddress( ). If you recreate your context or create a </td> </tr> <tr> <td class="h" > <a name="3477">3477</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> second context, you should assume that any existing function pointers </td> </tr> <tr> <td class="h" > <a name="3478">3478</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> aren't valid to use with it. This is (currently) a Windows-specific </td> </tr> <tr> <td class="h" > <a name="3479">3479</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> limitation, and in practice lots of drivers don't suffer this limitation, </td> </tr> <tr> <td class="h" > <a name="3480">3480</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> but it is still the way the wgl API is documented to work and you should </td> </tr> <tr> <td class="h" > <a name="3481">3481</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> expect crashes if you don't respect it. Store a copy of the function </td> </tr> <tr> <td class="h" > <a name="3482">3482</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> pointers that comes and goes with context lifespan. </td> </tr> <tr> <td class="h" > <a name="3483">3483</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3484">3484</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item * On X11, function pointers returned by this function are valid for any </td> </tr> <tr> <td class="h" > <a name="3485">3485</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> context, and can even be looked up before a context is created at all. This </td> </tr> <tr> <td class="h" > <a name="3486">3486</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> means that, for at least some common OpenGL implementations, if you look up </td> </tr> <tr> <td class="h" > <a name="3487">3487</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> a function that doesn't exist, you'll get a non-NULL result that is _NOT_ </td> </tr> <tr> <td class="h" > <a name="3488">3488</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> safe to call. You must always make sure the function is actually available </td> </tr> <tr> <td class="h" > <a name="3489">3489</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> for a given GL context before calling it, by checking for the existence of </td> </tr> <tr> <td class="h" > <a name="3490">3490</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the appropriate extension with L<< C<SDL_GL_ExtensionSupported( ... )>\|C<SDL_GL_ExtensionSupported( ... )> >>, or verifying </td> </tr> <tr> <td class="h" > <a name="3491">3491</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> that the version of OpenGL you're using offers the function as core </td> </tr> <tr> <td class="h" > <a name="3492">3492</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> functionality. </td> </tr> <tr> <td class="h" > <a name="3493">3493</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3494">3494</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item * Some OpenGL drivers, on all platforms, B<will> return undef if a function </td> </tr> <tr> <td class="h" > <a name="3495">3495</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> isn't supported, but you can't count on this behavior. Check for extensions </td> </tr> <tr> <td class="h" > <a name="3496">3496</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> you use, and if you get an undef anyway, act as if that extension wasn't </td> </tr> <tr> <td class="h" > <a name="3497">3497</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> available. This is probably a bug in the driver, but you can code </td> </tr> <tr> <td class="h" > <a name="3498">3498</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> defensively for this scenario anyhow. </td> </tr> <tr> <td class="h" > <a name="3499">3499</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3500">3500</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item * Just because you're on Linux/Unix, don't assume you'll be using X11. </td> </tr> <tr> <td class="h" > <a name="3501">3501</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Next-gen display servers are waiting to replace it, and may or may not make </td> </tr> <tr> <td class="h" > <a name="3502">3502</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the same promises about function pointers. </td> </tr> <tr> <td class="h" > <a name="3503">3503</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3504">3504</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item * OpenGL function pointers must be declared C<APIENTRY> as in the example </td> </tr> <tr> <td class="h" > <a name="3505">3505</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> code. This will ensure the proper calling convention is followed on </td> </tr> <tr> <td class="h" > <a name="3506">3506</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> platforms where this matters (Win32) thereby avoiding stack corruption. </td> </tr> <tr> <td class="h" > <a name="3507">3507</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3508">3508</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3509">3509</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3510">3510</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3511">3511</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3512">3512</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3513">3513</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3514">3514</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<proc> - the name of an OpenGL function </td> </tr> <tr> <td class="h" > <a name="3515">3515</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3516">3516</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3517">3517</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3518">3518</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns a pointer to the named OpenGL function. The returned pointer should be </td> </tr> <tr> <td class="h" > <a name="3519">3519</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> cast to the appropriate function signature. </td> </tr> <tr> <td class="h" > <a name="3520">3520</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3521">3521</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_UnloadLibrary( )> </td> </tr> <tr> <td class="h" > <a name="3522">3522</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3523">3523</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Unload the OpenGL library previously loaded by L<< C<SDL_GL_LoadLibrary( ... </td> </tr> <tr> <td class="h" > <a name="3524">3524</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GL_LoadLibrary( ... )> >>. </td> </tr> <tr> <td class="h" > <a name="3525">3525</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3526">3526</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_ExtensionSupported( ... )> </td> </tr> <tr> <td class="h" > <a name="3527">3527</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3528">3528</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Check if an OpenGL extension is supported for the current context. </td> </tr> <tr> <td class="h" > <a name="3529">3529</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3530">3530</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $ok = SDL_GL_ExtensionSupported( 'GL_ARB_texture_rectangle' ); </td> </tr> <tr> <td class="h" > <a name="3531">3531</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3532">3532</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function operates on the current GL context; you must have created a </td> </tr> <tr> <td class="h" > <a name="3533">3533</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> context and it must be current before calling this function. Do not assume that </td> </tr> <tr> <td class="h" > <a name="3534">3534</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> all contexts you create will have the same set of extensions available, or that </td> </tr> <tr> <td class="h" > <a name="3535">3535</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> recreating an existing context will offer the same extensions again. </td> </tr> <tr> <td class="h" > <a name="3536">3536</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3537">3537</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> While it's probably not a massive overhead, this function is not an O(1) </td> </tr> <tr> <td class="h" > <a name="3538">3538</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> operation. Check the extensions you care about after creating the GL context </td> </tr> <tr> <td class="h" > <a name="3539">3539</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> and save that information somewhere instead of calling the function every time </td> </tr> <tr> <td class="h" > <a name="3540">3540</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> you need to know. </td> </tr> <tr> <td class="h" > <a name="3541">3541</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3542">3542</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3543">3543</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3544">3544</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3545">3545</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3546">3546</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<extension> - the name of the extension to check </td> </tr> <tr> <td class="h" > <a name="3547">3547</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3548">3548</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3549">3549</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3550">3550</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns true if the extension is supported, false otherwise. </td> </tr> <tr> <td class="h" > <a name="3551">3551</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3552">3552</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_ResetAttributes( )> </td> </tr> <tr> <td class="h" > <a name="3553">3553</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3554">3554</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Reset all previously set OpenGL context attributes to their default values. </td> </tr> <tr> <td class="h" > <a name="3555">3555</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3556">3556</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_GL_ResetAttributes( ); </td> </tr> <tr> <td class="h" > <a name="3557">3557</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3558">3558</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_SetAttribute( ... )> </td> </tr> <tr> <td class="h" > <a name="3559">3559</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3560">3560</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set an OpenGL window attribute before window creation. </td> </tr> <tr> <td class="h" > <a name="3561">3561</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3562">3562</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_GL_SetAttribute(SDL_GL_RED_SIZE, 5); </td> </tr> <tr> <td class="h" > <a name="3563">3563</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_GL_SetAttribute(SDL_GL_GREEN_SIZE, 5); </td> </tr> <tr> <td class="h" > <a name="3564">3564</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_GL_SetAttribute(SDL_GL_BLUE_SIZE, 5); </td> </tr> <tr> <td class="h" > <a name="3565">3565</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_GL_SetAttribute(SDL_GL_DEPTH_SIZE, 16); </td> </tr> <tr> <td class="h" > <a name="3566">3566</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_GL_SetAttribute(SDL_GL_DOUBLEBUFFER, 1); </td> </tr> <tr> <td class="h" > <a name="3567">3567</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3568">3568</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function sets the OpenGL attribute C<attr> to C<value>. The requested </td> </tr> <tr> <td class="h" > <a name="3569">3569</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> attributes should be set before creating an OpenGL window. You should use L<< </td> </tr> <tr> <td class="h" > <a name="3570">3570</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GL_GetAttribute( ... )>\|/C<SDL_GL_GetAttribute( ... )> >> to check the </td> </tr> <tr> <td class="h" > <a name="3571">3571</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> values after creating the OpenGL context, since the values obtained can differ </td> </tr> <tr> <td class="h" > <a name="3572">3572</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> from the requested ones. </td> </tr> <tr> <td class="h" > <a name="3573">3573</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3574">3574</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3575">3575</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3576">3576</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3577">3577</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3578">3578</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<attr> - an SDL_GLattr enum value specifying the OpenGL attribute to set </td> </tr> <tr> <td class="h" > <a name="3579">3579</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3580">3580</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<value> - the desired value for the attribute </td> </tr> <tr> <td class="h" > <a name="3581">3581</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3582">3582</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3583">3583</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3584">3584</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="3585">3585</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3586">3586</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3587">3587</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_GetAttribute( ... )> </td> </tr> <tr> <td class="h" > <a name="3588">3588</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3589">3589</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the actual value for an attribute from the current context. </td> </tr> <tr> <td class="h" > <a name="3590">3590</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3591">3591</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $value = SDL_GL_GetAttribute(SDL_GL_DOUBLEBUFFER); </td> </tr> <tr> <td class="h" > <a name="3592">3592</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3593">3593</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3594">3594</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3595">3595</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3596">3596</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3597">3597</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<attr> - an SDL_GLattr enum value specifying the OpenGL attribute to get </td> </tr> <tr> <td class="h" > <a name="3598">3598</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3599">3599</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3600">3600</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3601">3601</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the value on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="3602">3602</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3603">3603</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3604">3604</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_CreateContext( ... )> </td> </tr> <tr> <td class="h" > <a name="3605">3605</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3606">3606</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Create an OpenGL context for an OpenGL window, and make it current. </td> </tr> <tr> <td class="h" > <a name="3607">3607</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3608">3608</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> # Window mode MUST include SDL_WINDOW_OPENGL for use with OpenGL. </td> </tr> <tr> <td class="h" > <a name="3609">3609</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $window = SDL_CreateWindow( </td> </tr> <tr> <td class="h" > <a name="3610">3610</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> 'SDL2/OpenGL Demo', 0, 0, 640, 480, </td> </tr> <tr> <td class="h" > <a name="3611">3611</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_WINDOW_OPENGL\|SDL_WINDOW_RESIZABLE); </td> </tr> <tr> <td class="h" > <a name="3612">3612</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3613">3613</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> # Create an OpenGL context associated with the window </td> </tr> <tr> <td class="h" > <a name="3614">3614</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $glcontext = SDL_GL_CreateContext( $window ); </td> </tr> <tr> <td class="h" > <a name="3615">3615</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3616">3616</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> # now you can make GL calls. </td> </tr> <tr> <td class="h" > <a name="3617">3617</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> glClearColor( 0, 0, 0 ,1 ); </td> </tr> <tr> <td class="h" > <a name="3618">3618</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> glClear( GL_COLOR_BUFFER_BIT ); </td> </tr> <tr> <td class="h" > <a name="3619">3619</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_GL_SwapWindow( $window ); </td> </tr> <tr> <td class="h" > <a name="3620">3620</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3621">3621</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> # Once finished with OpenGL functions, the SDL_GLContext can be deleted. </td> </tr> <tr> <td class="h" > <a name="3622">3622</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_GL_DeleteContext( $glcontext ); </td> </tr> <tr> <td class="h" > <a name="3623">3623</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3624">3624</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Windows users new to OpenGL should note that, for historical reasons, GL </td> </tr> <tr> <td class="h" > <a name="3625">3625</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> functions added after OpenGL version 1.1 are not available by default. Those </td> </tr> <tr> <td class="h" > <a name="3626">3626</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> functions must be loaded at run-time, either with an OpenGL extension-handling </td> </tr> <tr> <td class="h" > <a name="3627">3627</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> library or with L<< C<SDL_GL_GetProcAddress( ... )>\|/C<SDL_GL_GetProcAddress( </td> </tr> <tr> <td class="h" > <a name="3628">3628</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ... )> >> and its related functions. </td> </tr> <tr> <td class="h" > <a name="3629">3629</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3630">3630</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL2::GLContext is opaque to the application. </td> </tr> <tr> <td class="h" > <a name="3631">3631</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3632">3632</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3633">3633</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3634">3634</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3635">3635</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3636">3636</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to associate with the context </td> </tr> <tr> <td class="h" > <a name="3637">3637</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3638">3638</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3639">3639</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3640">3640</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the OpenGL context associated with C<window> or undef on error; call </td> </tr> <tr> <td class="h" > <a name="3641">3641</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more details. </td> </tr> <tr> <td class="h" > <a name="3642">3642</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3643">3643</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_MakeCurrent( ... )> </td> </tr> <tr> <td class="h" > <a name="3644">3644</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3645">3645</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set up an OpenGL context for rendering into an OpenGL window. </td> </tr> <tr> <td class="h" > <a name="3646">3646</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3647">3647</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_GL_MakeCurrent( $window, $gl ); </td> </tr> <tr> <td class="h" > <a name="3648">3648</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3649">3649</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The context must have been created with a compatible window. </td> </tr> <tr> <td class="h" > <a name="3650">3650</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3651">3651</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3652">3652</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3653">3653</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3654">3654</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3655">3655</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to associate with the context </td> </tr> <tr> <td class="h" > <a name="3656">3656</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3657">3657</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<context> - the OpenGL context to associate with the window </td> </tr> <tr> <td class="h" > <a name="3658">3658</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3659">3659</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3660">3660</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3661">3661</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="3662">3662</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3663">3663</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3664">3664</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_GetCurrentWindow( )> </td> </tr> <tr> <td class="h" > <a name="3665">3665</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3666">3666</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the currently active OpenGL window. </td> </tr> <tr> <td class="h" > <a name="3667">3667</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3668">3668</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $window = SDL_GL_GetCurrentWindow( ); </td> </tr> <tr> <td class="h" > <a name="3669">3669</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3670">3670</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the currently active OpenGL window on success or undef on failure; call </td> </tr> <tr> <td class="h" > <a name="3671">3671</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3672">3672</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3673">3673</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_GetCurrentContext( )> </td> </tr> <tr> <td class="h" > <a name="3674">3674</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3675">3675</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the currently active OpenGL context. </td> </tr> <tr> <td class="h" > <a name="3676">3676</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3677">3677</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $gl = SDL_GL_GetCurrentContext( ); </td> </tr> <tr> <td class="h" > <a name="3678">3678</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3679">3679</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the currently active OpenGL context or NULL on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="3680">3680</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3681">3681</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3682">3682</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_GetDrawableSize( ... )> </td> </tr> <tr> <td class="h" > <a name="3683">3683</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3684">3684</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the size of a window's underlying drawable in pixels. </td> </tr> <tr> <td class="h" > <a name="3685">3685</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3686">3686</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($w, $h) = SDL_GL_GetDrawableSize( $window ); </td> </tr> <tr> <td class="h" > <a name="3687">3687</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3688">3688</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This returns info useful for calling C<glViewport( ... )>. </td> </tr> <tr> <td class="h" > <a name="3689">3689</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3690">3690</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This may differ from L<< C<SDL_GetWindowSize( ... )>\|/C<SDL_GetWindowSize( ... </td> </tr> <tr> <td class="h" > <a name="3691">3691</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )> >> if we're rendering to a high-DPI drawable, i.e. the window was created </td> </tr> <tr> <td class="h" > <a name="3692">3692</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> with C<SDL_WINDOW_ALLOW_HIGHDPI> on a platform with high-DPI support (Apple </td> </tr> <tr> <td class="h" > <a name="3693">3693</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> calls this "Retina"), and not disabled by the </td> </tr> <tr> <td class="h" > <a name="3694">3694</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_HINT_VIDEO_HIGHDPI_DISABLED> hint. </td> </tr> <tr> <td class="h" > <a name="3695">3695</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3696">3696</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3697">3697</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3698">3698</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3699">3699</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3700">3700</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window from which the drawable size should be queried </td> </tr> <tr> <td class="h" > <a name="3701">3701</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3702">3702</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3703">3703</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3704">3704</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the width and height in pixels, either of which may be undefined. </td> </tr> <tr> <td class="h" > <a name="3705">3705</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3706">3706</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_SetSwapInterval( ... )> </td> </tr> <tr> <td class="h" > <a name="3707">3707</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3708">3708</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the swap interval for the current OpenGL context. </td> </tr> <tr> <td class="h" > <a name="3709">3709</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3710">3710</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $ok = !SDL_GL_SetSwapInterval( 1 ); </td> </tr> <tr> <td class="h" > <a name="3711">3711</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3712">3712</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Some systems allow specifying C<-1> for the interval, to enable adaptive vsync. </td> </tr> <tr> <td class="h" > <a name="3713">3713</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Adaptive vsync works the same as vsync, but if you've already missed the </td> </tr> <tr> <td class="h" > <a name="3714">3714</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> vertical retrace for a given frame, it swaps buffers immediately, which might </td> </tr> <tr> <td class="h" > <a name="3715">3715</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> be less jarring for the user during occasional framerate drops. If application </td> </tr> <tr> <td class="h" > <a name="3716">3716</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> requests adaptive vsync and the system does not support it, this function will </td> </tr> <tr> <td class="h" > <a name="3717">3717</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> fail and return C<-1>. In such a case, you should probably retry the call with </td> </tr> <tr> <td class="h" > <a name="3718">3718</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<1> for the interval. </td> </tr> <tr> <td class="h" > <a name="3719">3719</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3720">3720</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Adaptive vsync is implemented for some glX drivers with </td> </tr> <tr> <td class="h" > <a name="3721">3721</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<GLX_EXT_swap_control_tear>: </td> </tr> <tr> <td class="h" > <a name="3722">3722</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> L<https://www.opengl.org/registry/specs/EXT/glx_swap_control_tear.txt> and for </td> </tr> <tr> <td class="h" > <a name="3723">3723</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> some Windows drivers with C<WGL_EXT_swap_control_tear>: </td> </tr> <tr> <td class="h" > <a name="3724">3724</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> L<https://www.opengl.org/registry/specs/EXT/wgl_swap_control_tear.txt> </td> </tr> <tr> <td class="h" > <a name="3725">3725</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3726">3726</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Read more on the Khronos wiki: </td> </tr> <tr> <td class="h" > <a name="3727">3727</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> L<https://www.khronos.org/opengl/wiki/Swap_Interval#Adaptive_Vsync> </td> </tr> <tr> <td class="h" > <a name="3728">3728</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3729">3729</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3730">3730</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3731">3731</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3732">3732</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3733">3733</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<interval> - 0 for immediate updates, 1 for updates synchronized with the vertical retrace, -1 for adaptive vsync </td> </tr> <tr> <td class="h" > <a name="3734">3734</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3735">3735</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3736">3736</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3737">3737</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or C<-1> if setting the swap interval is not supported; </td> </tr> <tr> <td class="h" > <a name="3738">3738</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3739">3739</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3740">3740</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_GetSwapInterval( )> </td> </tr> <tr> <td class="h" > <a name="3741">3741</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3742">3742</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the swap interval for the current OpenGL context. </td> </tr> <tr> <td class="h" > <a name="3743">3743</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3744">3744</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $interval = SDL_GL_GetSwapInterval( ); </td> </tr> <tr> <td class="h" > <a name="3745">3745</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3746">3746</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If the system can't determine the swap interval, or there isn't a valid current </td> </tr> <tr> <td class="h" > <a name="3747">3747</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> context, this function will return 0 as a safe default. </td> </tr> <tr> <td class="h" > <a name="3748">3748</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3749">3749</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> if there is no vertical retrace synchronization, C<1> if the </td> </tr> <tr> <td class="h" > <a name="3750">3750</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> buffer swap is synchronized with the vertical retrace, and C<-1> if late swaps </td> </tr> <tr> <td class="h" > <a name="3751">3751</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> happen immediately instead of waiting for the next retrace; call L<< </td> </tr> <tr> <td class="h" > <a name="3752">3752</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3753">3753</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3754">3754</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_SwapWindow( ... )> </td> </tr> <tr> <td class="h" > <a name="3755">3755</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3756">3756</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Update a window with OpenGL rendering. </td> </tr> <tr> <td class="h" > <a name="3757">3757</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3758">3758</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_GL_SwapWindow( $window ); </td> </tr> <tr> <td class="h" > <a name="3759">3759</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3760">3760</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This is used with double-buffered OpenGL contexts, which are the default. </td> </tr> <tr> <td class="h" > <a name="3761">3761</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3762">3762</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> On macOS, make sure you bind 0 to the draw framebuffer before swapping the </td> </tr> <tr> <td class="h" > <a name="3763">3763</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> window, otherwise nothing will happen. If you aren't using C<glBindFramebuffer( </td> </tr> <tr> <td class="h" > <a name="3764">3764</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>, this is the default and you won't have to do anything extra. </td> </tr> <tr> <td class="h" > <a name="3765">3765</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3766">3766</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3767">3767</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3768">3768</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3769">3769</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3770">3770</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to change </td> </tr> <tr> <td class="h" > <a name="3771">3771</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3772">3772</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3773">3773</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3774">3774</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_DeleteContext( ... )> </td> </tr> <tr> <td class="h" > <a name="3775">3775</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3776">3776</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Delete an OpenGL context. </td> </tr> <tr> <td class="h" > <a name="3777">3777</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3778">3778</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_GL_DeleteContext( $context ); </td> </tr> <tr> <td class="h" > <a name="3779">3779</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3780">3780</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3781">3781</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3782">3782</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3783">3783</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3784">3784</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<context> - the OpenGL context to be deleted </td> </tr> <tr> <td class="h" > <a name="3785">3785</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3786">3786</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3787">3787</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3788">3788</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 2D Accelerated Rendering </td> </tr> <tr> <td class="h" > <a name="3789">3789</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3790">3790</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This category contains functions for 2D accelerated rendering. You may import </td> </tr> <tr> <td class="h" > <a name="3791">3791</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> these functions with the C<:render> tag. </td> </tr> <tr> <td class="h" > <a name="3792">3792</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3793">3793</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This API supports the following features: </td> </tr> <tr> <td class="h" > <a name="3794">3794</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3795">3795</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3796">3796</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3797">3797</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item single pixel points </td> </tr> <tr> <td class="h" > <a name="3798">3798</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3799">3799</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item single pixel lines </td> </tr> <tr> <td class="h" > <a name="3800">3800</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3801">3801</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item filled rectangles </td> </tr> <tr> <td class="h" > <a name="3802">3802</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3803">3803</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item texture images </td> </tr> <tr> <td class="h" > <a name="3804">3804</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3805">3805</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3806">3806</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3807">3807</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> All of these may be drawn in opaque, blended, or additive modes. </td> </tr> <tr> <td class="h" > <a name="3808">3808</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3809">3809</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The texture images can have an additional color tint or alpha modulation </td> </tr> <tr> <td class="h" > <a name="3810">3810</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> applied to them, and may also be stretched with linear interpolation, rotated </td> </tr> <tr> <td class="h" > <a name="3811">3811</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> or flipped/mirrored. </td> </tr> <tr> <td class="h" > <a name="3812">3812</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3813">3813</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> For advanced functionality like particle effects or actual 3D you should use </td> </tr> <tr> <td class="h" > <a name="3814">3814</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL's OpenGL/Direct3D support or one of the many available 3D engines. </td> </tr> <tr> <td class="h" > <a name="3815">3815</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3816">3816</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This API is not designed to be used from multiple threads, see L<SDL issue </td> </tr> <tr> <td class="h" > <a name="3817">3817</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> #986\|https://github.com/libsdl-org/SDL/issues/986> for details. </td> </tr> <tr> <td class="h" > <a name="3818">3818</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3819">3819</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetNumRenderDrivers( )> </td> </tr> <tr> <td class="h" > <a name="3820">3820</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3821">3821</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the number of 2D rendering drivers available for the current display. </td> </tr> <tr> <td class="h" > <a name="3822">3822</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3823">3823</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $drivers = SDL_GetNumRenderDrivers( ); </td> </tr> <tr> <td class="h" > <a name="3824">3824</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3825">3825</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> A render driver is a set of code that handles rendering and texture management </td> </tr> <tr> <td class="h" > <a name="3826">3826</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> on a particular display. Normally there is only one, but some drivers may have </td> </tr> <tr> <td class="h" > <a name="3827">3827</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> several available with different capabilities. </td> </tr> <tr> <td class="h" > <a name="3828">3828</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3829">3829</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> There may be none if SDL was compiled without render support. </td> </tr> <tr> <td class="h" > <a name="3830">3830</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3831">3831</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns a number >= 0 on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="3832">3832</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3833">3833</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3834">3834</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetRenderDriverInfo( ... )> </td> </tr> <tr> <td class="h" > <a name="3835">3835</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3836">3836</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get info about a specific 2D rendering driver for the current display. </td> </tr> <tr> <td class="h" > <a name="3837">3837</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3838">3838</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $info = !SDL_GetRendererDriverInfo( ); </td> </tr> <tr> <td class="h" > <a name="3839">3839</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3840">3840</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3841">3841</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3842">3842</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3843">3843</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3844">3844</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<index> - the index of the driver to query information about </td> </tr> <tr> <td class="h" > <a name="3845">3845</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3846">3846</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3847">3847</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3848">3848</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns an L<SDL2::RendererInfo> structure on success or a negative error code </td> </tr> <tr> <td class="h" > <a name="3849">3849</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> on failure; call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more </td> </tr> <tr> <td class="h" > <a name="3850">3850</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> information. </td> </tr> <tr> <td class="h" > <a name="3851">3851</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3852">3852</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_CreateWindowAndRenderer( ... )> </td> </tr> <tr> <td class="h" > <a name="3853">3853</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3854">3854</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Create a window and default renderer. </td> </tr> <tr> <td class="h" > <a name="3855">3855</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3856">3856</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($window, $renderer) = SDL_CreateWindowAndRenderer(640, 480, 0); </td> </tr> <tr> <td class="h" > <a name="3857">3857</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3858">3858</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3859">3859</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3860">3860</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3861">3861</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3862">3862</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<width> - the width of the window </td> </tr> <tr> <td class="h" > <a name="3863">3863</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3864">3864</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<height> - the height of the window </td> </tr> <tr> <td class="h" > <a name="3865">3865</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3866">3866</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window_flags> - the flags used to create the window (see L<< C<SDL_CreateWindow( ... )>\|/C<SDL_CreateWindow( ... )> >>) </td> </tr> <tr> <td class="h" > <a name="3867">3867</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3868">3868</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3869">3869</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3870">3870</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns a L<SDL2::Window> and L<SDL2::Renderer> objects on success, or -1 on </td> </tr> <tr> <td class="h" > <a name="3871">3871</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> error; call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more </td> </tr> <tr> <td class="h" > <a name="3872">3872</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> information. </td> </tr> <tr> <td class="h" > <a name="3873">3873</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3874">3874</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_CreateRenderer( ... )> </td> </tr> <tr> <td class="h" > <a name="3875">3875</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3876">3876</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Create a 2D rendering context for a window. </td> </tr> <tr> <td class="h" > <a name="3877">3877</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3878">3878</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $renderer = SDL_CreateRenderer( $window, -1, 0); </td> </tr> <tr> <td class="h" > <a name="3879">3879</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3880">3880</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3881">3881</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3882">3882</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3883">3883</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3884">3884</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window where rendering is displayed </td> </tr> <tr> <td class="h" > <a name="3885">3885</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3886">3886</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<index> - the index of the rendering driver to initialize, or C<-1> to initialize the first one supporting the requested flags </td> </tr> <tr> <td class="h" > <a name="3887">3887</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3888">3888</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<flags> - C<0>, or one or more C<SDL_RendererFlags> OR'd together </td> </tr> <tr> <td class="h" > <a name="3889">3889</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3890">3890</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3891">3891</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3892">3892</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns a valid rendering context or undefined if there was an error; call L<< </td> </tr> <tr> <td class="h" > <a name="3893">3893</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3894">3894</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3895">3895</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_CreateSoftwareRenderer( ... )> </td> </tr> <tr> <td class="h" > <a name="3896">3896</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3897">3897</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Create a 2D software rendering context for a surface. </td> </tr> <tr> <td class="h" > <a name="3898">3898</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3899">3899</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $renderer = SDL_CreateSoftwareRenderer( $surface ); </td> </tr> <tr> <td class="h" > <a name="3900">3900</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3901">3901</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Two other API which can be used to create SDL_Renderer: </td> </tr> <tr> <td class="h" > <a name="3902">3902</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3903">3903</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> L<< C<SDL_CreateRenderer( ... )>\|/C<SDL_CreateRenderer( ... )> >> and L<< </td> </tr> <tr> <td class="h" > <a name="3904">3904</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_CreateWindowAndRenderer( ... )>\|/C<SDL_CreateWindowAndRenderer( ... )> </td> </tr> <tr> <td class="h" > <a name="3905">3905</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> >>. These can B<also> create a software renderer, but they are intended to be </td> </tr> <tr> <td class="h" > <a name="3906">3906</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> used with an L<SDL2::Window> as the final destination and not an </td> </tr> <tr> <td class="h" > <a name="3907">3907</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> L<SDL2::Surface>. </td> </tr> <tr> <td class="h" > <a name="3908">3908</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3909">3909</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3910">3910</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3911">3911</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3912">3912</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3913">3913</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<surface> - the L<SDL2::Surface> structure representing the surface where rendering is done </td> </tr> <tr> <td class="h" > <a name="3914">3914</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3915">3915</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3916">3916</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3917">3917</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns a valid rendering context or undef if there was an error; call L<< </td> </tr> <tr> <td class="h" > <a name="3918">3918</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3919">3919</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3920">3920</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetRenderer( ... )> </td> </tr> <tr> <td class="h" > <a name="3921">3921</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3922">3922</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the renderer associated with a window. </td> </tr> <tr> <td class="h" > <a name="3923">3923</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3924">3924</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $renderer = SDL_GetRenderer( $window ); </td> </tr> <tr> <td class="h" > <a name="3925">3925</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3926">3926</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3927">3927</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3928">3928</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3929">3929</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3930">3930</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<window> - the window to query </td> </tr> <tr> <td class="h" > <a name="3931">3931</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3932">3932</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3933">3933</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3934">3934</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the rendering context on success or undef on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="3935">3935</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3936">3936</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3937">3937</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetRendererInfo( ... )> </td> </tr> <tr> <td class="h" > <a name="3938">3938</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3939">3939</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get information about a rendering context. </td> </tr> <tr> <td class="h" > <a name="3940">3940</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3941">3941</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $info = !SDL_GetRendererInfo( $renderer ); </td> </tr> <tr> <td class="h" > <a name="3942">3942</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3943">3943</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3944">3944</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3945">3945</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3946">3946</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3947">3947</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="3948">3948</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3949">3949</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3950">3950</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3951">3951</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns an L<SDL2::RendererInfo> structure on success or a negative error code </td> </tr> <tr> <td class="h" > <a name="3952">3952</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> on failure; call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more </td> </tr> <tr> <td class="h" > <a name="3953">3953</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> information. </td> </tr> <tr> <td class="h" > <a name="3954">3954</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3955">3955</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetRendererOutputSize( ... )> </td> </tr> <tr> <td class="h" > <a name="3956">3956</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3957">3957</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the output size in pixels of a rendering context. </td> </tr> <tr> <td class="h" > <a name="3958">3958</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3959">3959</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($w, $h) = SDL_GetRendererOutputSize( $renderer ); </td> </tr> <tr> <td class="h" > <a name="3960">3960</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3961">3961</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Due to high-dpi displays, you might end up with a rendering context that has </td> </tr> <tr> <td class="h" > <a name="3962">3962</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> more pixels than the window that contains it, so use this instead of L<< </td> </tr> <tr> <td class="h" > <a name="3963">3963</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetWindowSize( ... )>\|/C<SDL_GetWindowSize( ... )> >> to decide how much </td> </tr> <tr> <td class="h" > <a name="3964">3964</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> drawing area you have. </td> </tr> <tr> <td class="h" > <a name="3965">3965</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3966">3966</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3967">3967</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3968">3968</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3969">3969</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3970">3970</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="3971">3971</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3972">3972</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="3973">3973</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3974">3974</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the width and height on success or a negative error code on failure; </td> </tr> <tr> <td class="h" > <a name="3975">3975</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="3976">3976</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3977">3977</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_CreateTexture( ... )> </td> </tr> <tr> <td class="h" > <a name="3978">3978</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3979">3979</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Create a texture for a rendering context. </td> </tr> <tr> <td class="h" > <a name="3980">3980</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3981">3981</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $texture = SDL_CreateTexture( $renderer, SDL_PIXELFORMAT_RGBA8888, SDL_TEXTUREACCESS_TARGET, 1024, 768); </td> </tr> <tr> <td class="h" > <a name="3982">3982</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3983">3983</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: https://gist.github.com/malja/2193bd656fe50c203f264ce554919976 </td> </tr> <tr> <td class="h" > <a name="3984">3984</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3985">3985</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> You can set the texture scaling method by setting </td> </tr> <tr> <td class="h" > <a name="3986">3986</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_HINT_RENDER_SCALE_QUALITY> before creating the texture. </td> </tr> <tr> <td class="h" > <a name="3987">3987</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3988">3988</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="3989">3989</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3990">3990</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="3991">3991</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3992">3992</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="3993">3993</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3994">3994</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<format> - one of the enumerated values in C<:pixelFormatEnum> </td> </tr> <tr> <td class="h" > <a name="3995">3995</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3996">3996</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<access> - one of the enumerated values in C<:textureAccess> </td> </tr> <tr> <td class="h" > <a name="3997">3997</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="3998">3998</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<w> - the width of the texture in pixels </td> </tr> <tr> <td class="h" > <a name="3999">3999</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4000">4000</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<h> - the height of the texture in pixels </td> </tr> <tr> <td class="h" > <a name="4001">4001</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4002">4002</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4003">4003</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4004">4004</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns a pointer to the created texture or undefined if no rendering context </td> </tr> <tr> <td class="h" > <a name="4005">4005</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> was active, the format was unsupported, or the width or height were out of </td> </tr> <tr> <td class="h" > <a name="4006">4006</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> range; call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more </td> </tr> <tr> <td class="h" > <a name="4007">4007</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> information. </td> </tr> <tr> <td class="h" > <a name="4008">4008</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4009">4009</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_CreateTextureFromSurface( ... )> </td> </tr> <tr> <td class="h" > <a name="4010">4010</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4011">4011</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Create a texture from an existing surface. </td> </tr> <tr> <td class="h" > <a name="4012">4012</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4013">4013</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> use Config; </td> </tr> <tr> <td class="h" > <a name="4014">4014</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($rmask, $gmask, $bmask, $amask) = </td> </tr> <tr> <td class="h" > <a name="4015">4015</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> $Config{byteorder} == 4321 ? (0xff000000,0x00ff0000,0x0000ff00,0x000000ff) : </td> </tr> <tr> <td class="h" > <a name="4016">4016</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> (0x000000ff,0x0000ff00,0x00ff0000,0xff000000); </td> </tr> <tr> <td class="h" > <a name="4017">4017</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $surface = SDL_CreateRGBSurface( 0, 640, 480, 32, $rmask, $gmask, $bmask, $amask ); </td> </tr> <tr> <td class="h" > <a name="4018">4018</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $texture = SDL_CreateTextureFromSurface( $renderer, $surface ); </td> </tr> <tr> <td class="h" > <a name="4019">4019</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4020">4020</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The surface is not modified or freed by this function. </td> </tr> <tr> <td class="h" > <a name="4021">4021</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4022">4022</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The SDL_TextureAccess hint for the created texture is </td> </tr> <tr> <td class="h" > <a name="4023">4023</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_TEXTUREACCESS_STATIC>. </td> </tr> <tr> <td class="h" > <a name="4024">4024</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4025">4025</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The pixel format of the created texture may be different from the pixel format </td> </tr> <tr> <td class="h" > <a name="4026">4026</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> of the surface. Use L<< C<SDL_QueryTexture( ... )>\|/C<SDL_QueryTexture( ... )> </td> </tr> <tr> <td class="h" > <a name="4027">4027</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> >> to query the pixel format of the texture. </td> </tr> <tr> <td class="h" > <a name="4028">4028</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4029">4029</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4030">4030</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4031">4031</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4032">4032</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4033">4033</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4034">4034</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4035">4035</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<surface> - the L<SDL2::Surface> structure containing pixel data used to fill the texture </td> </tr> <tr> <td class="h" > <a name="4036">4036</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4037">4037</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4038">4038</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4039">4039</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the created texture or undef on failure; call L<< C<SDL_GetError( </td> </tr> <tr> <td class="h" > <a name="4040">4040</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4041">4041</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4042">4042</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_QueryTexture( ... )> </td> </tr> <tr> <td class="h" > <a name="4043">4043</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4044">4044</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Query the attributes of a texture. </td> </tr> <tr> <td class="h" > <a name="4045">4045</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4046">4046</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ( $format, $access, $w, $h ) = SDL_QueryTexture( $texture ); </td> </tr> <tr> <td class="h" > <a name="4047">4047</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4048">4048</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4049">4049</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4050">4050</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4051">4051</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4052">4052</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to query </td> </tr> <tr> <td class="h" > <a name="4053">4053</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4054">4054</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4055">4055</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4056">4056</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the following on success... </td> </tr> <tr> <td class="h" > <a name="4057">4057</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4058">4058</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4059">4059</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4060">4060</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<format> - a pointer filled in with the raw format of the texture; the </td> </tr> <tr> <td class="h" > <a name="4061">4061</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> actual format may differ, but pixel transfers will use this </td> </tr> <tr> <td class="h" > <a name="4062">4062</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> format (one of the L<< C<:pixelFormatEnum>\|/C<:pixelFormatEnum> >> values) </td> </tr> <tr> <td class="h" > <a name="4063">4063</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4064">4064</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<access> - a pointer filled in with the actual access to the texture (one of the L<< C<:textureAccess>\|/C<:textureAccess> >> values) </td> </tr> <tr> <td class="h" > <a name="4065">4065</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4066">4066</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<w> - a pointer filled in with the width of the texture in pixels </td> </tr> <tr> <td class="h" > <a name="4067">4067</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4068">4068</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<h> - a pointer filled in with the height of the texture in pixels </td> </tr> <tr> <td class="h" > <a name="4069">4069</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4070">4070</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4071">4071</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4072">4072</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ...or a negative error code on failure; call L<< C<SDL_GetError( </td> </tr> <tr> <td class="h" > <a name="4073">4073</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4074">4074</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4075">4075</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetTextureColorMod( ... )> </td> </tr> <tr> <td class="h" > <a name="4076">4076</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4077">4077</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set an additional color value multiplied into render copy operations. </td> </tr> <tr> <td class="h" > <a name="4078">4078</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4079">4079</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $ok = !SDL_SetTextureColorMod( $texture, 64, 64, 64 ); </td> </tr> <tr> <td class="h" > <a name="4080">4080</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4081">4081</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> When this texture is rendered, during the copy operation each source color </td> </tr> <tr> <td class="h" > <a name="4082">4082</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> channel is modulated by the appropriate color value according to the following </td> </tr> <tr> <td class="h" > <a name="4083">4083</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> formula: </td> </tr> <tr> <td class="h" > <a name="4084">4084</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4085">4085</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> srcC = srcC * (color / 255) </td> </tr> <tr> <td class="h" > <a name="4086">4086</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4087">4087</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Color modulation is not always supported by the renderer; it will return C<-1> </td> </tr> <tr> <td class="h" > <a name="4088">4088</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> if color modulation is not supported. </td> </tr> <tr> <td class="h" > <a name="4089">4089</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4090">4090</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4091">4091</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4092">4092</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4093">4093</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4094">4094</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to update </td> </tr> <tr> <td class="h" > <a name="4095">4095</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4096">4096</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<r> - the red color value multiplied into copy operations </td> </tr> <tr> <td class="h" > <a name="4097">4097</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4098">4098</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<g> - the green color value multiplied into copy operations </td> </tr> <tr> <td class="h" > <a name="4099">4099</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4100">4100</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<b> - the blue color value multiplied into copy operations </td> </tr> <tr> <td class="h" > <a name="4101">4101</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4102">4102</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4103">4103</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4104">4104</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4105">4105</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4106">4106</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4107">4107</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetTextureColorMod( ... )> </td> </tr> <tr> <td class="h" > <a name="4108">4108</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4109">4109</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the additional color value multiplied into render copy operations. </td> </tr> <tr> <td class="h" > <a name="4110">4110</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4111">4111</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ( $r, $g, $b ) = SDL_GetTextureColorMod( $texture ); </td> </tr> <tr> <td class="h" > <a name="4112">4112</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4113">4113</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4114">4114</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4115">4115</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4116">4116</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4117">4117</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to query </td> </tr> <tr> <td class="h" > <a name="4118">4118</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4119">4119</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4120">4120</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4121">4121</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the current red, green, and blue color values on success or a negative </td> </tr> <tr> <td class="h" > <a name="4122">4122</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> error code on failure; call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) </td> </tr> <tr> <td class="h" > <a name="4123">4123</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> for more information. </td> </tr> <tr> <td class="h" > <a name="4124">4124</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4125">4125</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetTextureAlphaMod( ... )> </td> </tr> <tr> <td class="h" > <a name="4126">4126</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4127">4127</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set an additional alpha value multiplied into render copy operations. </td> </tr> <tr> <td class="h" > <a name="4128">4128</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4129">4129</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetTextureAlphaMod( $texture, 100 ); </td> </tr> <tr> <td class="h" > <a name="4130">4130</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4131">4131</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> When this texture is rendered, during the copy operation the source alpha </td> </tr> <tr> <td class="h" > <a name="4132">4132</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4133">4133</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> value is modulated by this alpha value according to the following formula: </td> </tr> <tr> <td class="h" > <a name="4134">4134</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4135">4135</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> srcA = srcA * (alpha / 255) </td> </tr> <tr> <td class="h" > <a name="4136">4136</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4137">4137</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Alpha modulation is not always supported by the renderer; it will return C<-1> </td> </tr> <tr> <td class="h" > <a name="4138">4138</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> if alpha modulation is not supported. </td> </tr> <tr> <td class="h" > <a name="4139">4139</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4140">4140</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4141">4141</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4142">4142</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4143">4143</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4144">4144</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to update </td> </tr> <tr> <td class="h" > <a name="4145">4145</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4146">4146</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<alpha> - the source alpha value multiplied into copy operations </td> </tr> <tr> <td class="h" > <a name="4147">4147</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4148">4148</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4149">4149</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4150">4150</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4151">4151</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4152">4152</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4153">4153</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetTextureAlphaMod( ... )> </td> </tr> <tr> <td class="h" > <a name="4154">4154</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4155">4155</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the additional alpha value multiplied into render copy operations. </td> </tr> <tr> <td class="h" > <a name="4156">4156</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4157">4157</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $alpha = SDL_GetTextureAlphaMod( $texture ); </td> </tr> <tr> <td class="h" > <a name="4158">4158</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4159">4159</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4160">4160</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4161">4161</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4162">4162</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4163">4163</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to query </td> </tr> <tr> <td class="h" > <a name="4164">4164</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4165">4165</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4166">4166</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4167">4167</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the current alpha value on success or a negative error code on failure; </td> </tr> <tr> <td class="h" > <a name="4168">4168</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4169">4169</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4170">4170</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetTextureBlendMode( ... )> </td> </tr> <tr> <td class="h" > <a name="4171">4171</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4172">4172</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the blend mode for a texture, used by L<< C<SDL_RenderCopy( ... </td> </tr> <tr> <td class="h" > <a name="4173">4173</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_RenderCopy( ... )> >>. </td> </tr> <tr> <td class="h" > <a name="4174">4174</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4175">4175</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If the blend mode is not supported, the closest supported mode is chosen and </td> </tr> <tr> <td class="h" > <a name="4176">4176</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> this function returns C<-1>. </td> </tr> <tr> <td class="h" > <a name="4177">4177</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4178">4178</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4179">4179</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4180">4180</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4181">4181</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4182">4182</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to update </td> </tr> <tr> <td class="h" > <a name="4183">4183</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4184">4184</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<blendMode> - the L<< C<:blendMode>\|/C<:blendMode> >> to use for texture blending </td> </tr> <tr> <td class="h" > <a name="4185">4185</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4186">4186</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4187">4187</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4188">4188</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns 0 on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4189">4189</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4190">4190</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4191">4191</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetTextureBlendMode( ... )> </td> </tr> <tr> <td class="h" > <a name="4192">4192</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4193">4193</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the blend mode used for texture copy operations. </td> </tr> <tr> <td class="h" > <a name="4194">4194</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4195">4195</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_GetTextureBlendMode( $texture, SDL_BLENDMODE_ADD ); </td> </tr> <tr> <td class="h" > <a name="4196">4196</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4197">4197</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4198">4198</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4199">4199</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4200">4200</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4201">4201</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to query </td> </tr> <tr> <td class="h" > <a name="4202">4202</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4203">4203</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4204">4204</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4205">4205</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the current C<:blendMode> on success or a negative error code on </td> </tr> <tr> <td class="h" > <a name="4206">4206</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> failure; call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more </td> </tr> <tr> <td class="h" > <a name="4207">4207</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> information. </td> </tr> <tr> <td class="h" > <a name="4208">4208</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4209">4209</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetTextureScaleMode( ... )> </td> </tr> <tr> <td class="h" > <a name="4210">4210</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4211">4211</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the scale mode used for texture scale operations. </td> </tr> <tr> <td class="h" > <a name="4212">4212</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4213">4213</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetTextureScaleMode( $texture, $scaleMode ); </td> </tr> <tr> <td class="h" > <a name="4214">4214</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4215">4215</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If the scale mode is not supported, the closest supported mode is chosen. </td> </tr> <tr> <td class="h" > <a name="4216">4216</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4217">4217</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4218">4218</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4219">4219</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4220">4220</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4221">4221</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - The texture to update. </td> </tr> <tr> <td class="h" > <a name="4222">4222</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4223">4223</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<scaleMode> - the SDL_ScaleMode to use for texture scaling. </td> </tr> <tr> <td class="h" > <a name="4224">4224</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4225">4225</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4226">4226</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4227">4227</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success, or C<-1> if the texture is not valid. </td> </tr> <tr> <td class="h" > <a name="4228">4228</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4229">4229</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetTextureScaleMode( ... )> </td> </tr> <tr> <td class="h" > <a name="4230">4230</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4231">4231</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the scale mode used for texture scale operations. </td> </tr> <tr> <td class="h" > <a name="4232">4232</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4233">4233</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $ok = SDL_GetTextureScaleMode( $texture ); </td> </tr> <tr> <td class="h" > <a name="4234">4234</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4235">4235</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4236">4236</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4237">4237</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4238">4238</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4239">4239</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to query. </td> </tr> <tr> <td class="h" > <a name="4240">4240</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4241">4241</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4242">4242</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4243">4243</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the current scale mode on success, or C<-1> if the texture is not </td> </tr> <tr> <td class="h" > <a name="4244">4244</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> valid. </td> </tr> <tr> <td class="h" > <a name="4245">4245</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4246">4246</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_UpdateTexture( ... )> </td> </tr> <tr> <td class="h" > <a name="4247">4247</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4248">4248</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Update the given texture rectangle with new pixel data. </td> </tr> <tr> <td class="h" > <a name="4249">4249</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4250">4250</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $rect = SDL2::Rect->new( { x => 0, y => ..., w => $surface->w, h => $surface->h } ); </td> </tr> <tr> <td class="h" > <a name="4251">4251</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_UpdateTexture( $texture, $rect, $surface->pixels, $surface->pitch ); </td> </tr> <tr> <td class="h" > <a name="4252">4252</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4253">4253</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The pixel data must be in the pixel format of the texture. Use L<< </td> </tr> <tr> <td class="h" > <a name="4254">4254</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_QueryTexture( ... )>\|/C<SDL_QueryTexture( ... )> >> to query the pixel </td> </tr> <tr> <td class="h" > <a name="4255">4255</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> format of the texture. </td> </tr> <tr> <td class="h" > <a name="4256">4256</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4257">4257</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This is a fairly slow function, intended for use with static textures that do </td> </tr> <tr> <td class="h" > <a name="4258">4258</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> not change often. </td> </tr> <tr> <td class="h" > <a name="4259">4259</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4260">4260</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If the texture is intended to be updated often, it is preferred to create the </td> </tr> <tr> <td class="h" > <a name="4261">4261</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> texture as streaming and use the locking functions referenced below. While this </td> </tr> <tr> <td class="h" > <a name="4262">4262</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> function will work with streaming textures, for optimization reasons you may </td> </tr> <tr> <td class="h" > <a name="4263">4263</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> not get the pixels back if you lock the texture afterward. </td> </tr> <tr> <td class="h" > <a name="4264">4264</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4265">4265</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4266">4266</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4267">4267</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4268">4268</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4269">4269</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to update </td> </tr> <tr> <td class="h" > <a name="4270">4270</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4271">4271</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rect> - an L<SDL2::Rect> structure representing the area to update, or undef to update the entire texture </td> </tr> <tr> <td class="h" > <a name="4272">4272</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4273">4273</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<pixels> - the raw pixel data in the format of the texture </td> </tr> <tr> <td class="h" > <a name="4274">4274</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4275">4275</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<pitch> - the number of bytes in a row of pixel data, including padding between lines </td> </tr> <tr> <td class="h" > <a name="4276">4276</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4277">4277</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4278">4278</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4279">4279</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4280">4280</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4281">4281</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4282">4282</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_UpdateYUVTexture( ... )> </td> </tr> <tr> <td class="h" > <a name="4283">4283</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4284">4284</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Update a rectangle within a planar YV12 or IYUV texture with new pixel data. </td> </tr> <tr> <td class="h" > <a name="4285">4285</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4286">4286</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_UpdateYUVTexture( $texture, $rect, $yPlane, $yPitch, $uPlane, $uPitch, $vPlane, $vPitch ); </td> </tr> <tr> <td class="h" > <a name="4287">4287</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4288">4288</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> You can use L<< C<SDL_UpdateTexture( ... )>\|/C<SDL_UpdateTexture( ... )> >> as </td> </tr> <tr> <td class="h" > <a name="4289">4289</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> long as your pixel data is a contiguous block of Y and U/V planes in the proper </td> </tr> <tr> <td class="h" > <a name="4290">4290</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> order, but this function is available if your pixel data is not contiguous. </td> </tr> <tr> <td class="h" > <a name="4291">4291</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4292">4292</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4293">4293</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4294">4294</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4295">4295</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4296">4296</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to update </td> </tr> <tr> <td class="h" > <a name="4297">4297</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4298">4298</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rect> - a pointer to the rectangle of pixels to update, or undef to update the entire texture </td> </tr> <tr> <td class="h" > <a name="4299">4299</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4300">4300</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<Yplane> - the raw pixel data for the Y plane </td> </tr> <tr> <td class="h" > <a name="4301">4301</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4302">4302</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<Ypitch> - the number of bytes between rows of pixel data for the Y plane </td> </tr> <tr> <td class="h" > <a name="4303">4303</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4304">4304</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<Uplane> - the raw pixel data for the U plane </td> </tr> <tr> <td class="h" > <a name="4305">4305</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4306">4306</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<Upitch> - the number of bytes between rows of pixel data for the U plane </td> </tr> <tr> <td class="h" > <a name="4307">4307</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4308">4308</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<Vplane> - the raw pixel data for the V plane </td> </tr> <tr> <td class="h" > <a name="4309">4309</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4310">4310</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<Vpitch> - the number of bytes between rows of pixel data for the V plane </td> </tr> <tr> <td class="h" > <a name="4311">4311</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4312">4312</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4313">4313</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4314">4314</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or -1 if the texture is not valid; call L<< </td> </tr> <tr> <td class="h" > <a name="4315">4315</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4316">4316</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4317">4317</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_UpdateNVTexture( ... )> </td> </tr> <tr> <td class="h" > <a name="4318">4318</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4319">4319</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Update a rectangle within a planar NV12 or NV21 texture with new pixels. </td> </tr> <tr> <td class="h" > <a name="4320">4320</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4321">4321</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_UpdateNVTexture( $texture, $rect, $yPlane, $yPitch, $uPlane, $uPitch ); </td> </tr> <tr> <td class="h" > <a name="4322">4322</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4323">4323</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> You can use L<< C<SDL_UpdateTexture( ... )>\|/C<SDL_UpdateTexture( ... )> >> as </td> </tr> <tr> <td class="h" > <a name="4324">4324</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> long as your pixel data is a contiguous block of NV12/21 planes in the proper </td> </tr> <tr> <td class="h" > <a name="4325">4325</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> order, but this function is available if your pixel data is not contiguous. </td> </tr> <tr> <td class="h" > <a name="4326">4326</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4327">4327</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4328">4328</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4329">4329</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4330">4330</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4331">4331</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to update </td> </tr> <tr> <td class="h" > <a name="4332">4332</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4333">4333</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rect> - a pointer to the rectangle of pixels to update, or undef to update the entire texture. </td> </tr> <tr> <td class="h" > <a name="4334">4334</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4335">4335</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<Yplane> - the raw pixel data for the Y plane. </td> </tr> <tr> <td class="h" > <a name="4336">4336</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4337">4337</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<Ypitch> - the number of bytes between rows of pixel data for the Y plane. </td> </tr> <tr> <td class="h" > <a name="4338">4338</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4339">4339</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<UVplane> - the raw pixel data for the UV plane. </td> </tr> <tr> <td class="h" > <a name="4340">4340</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4341">4341</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<UVpitch> - the number of bytes between rows of pixel data for the UV plane. </td> </tr> <tr> <td class="h" > <a name="4342">4342</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4343">4343</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4344">4344</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4345">4345</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success, or C<-1> if the texture is not valid. </td> </tr> <tr> <td class="h" > <a name="4346">4346</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4347">4347</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_LockTexture( ... )> </td> </tr> <tr> <td class="h" > <a name="4348">4348</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4349">4349</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Lock a portion of the texture for B<write-only> pixel access. </td> </tr> <tr> <td class="h" > <a name="4350">4350</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4351">4351</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_LockTexture( $texture, $rect, $pixels, $pitch ); </td> </tr> <tr> <td class="h" > <a name="4352">4352</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4353">4353</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> As an optimization, the pixels made available for editing don't necessarily </td> </tr> <tr> <td class="h" > <a name="4354">4354</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> contain the old texture data. This is a write-only operation, and if you need </td> </tr> <tr> <td class="h" > <a name="4355">4355</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> to keep a copy of the texture data you should do that at the application level. </td> </tr> <tr> <td class="h" > <a name="4356">4356</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4357">4357</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> You must use L<< C<SDL_UpdateTexture( ... )>\|/C<SDL_UpdateTexture( ... )> >> to </td> </tr> <tr> <td class="h" > <a name="4358">4358</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> unlock the pixels and apply any changes. </td> </tr> <tr> <td class="h" > <a name="4359">4359</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4360">4360</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4361">4361</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4362">4362</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4363">4363</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4364">4364</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to lock for access, which was created with C<SDL_TEXTUREACCESS_STREAMING> </td> </tr> <tr> <td class="h" > <a name="4365">4365</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4366">4366</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rect> - an L<SDL2::Rect> structure representing the area to lock for access; undef to lock the entire texture </td> </tr> <tr> <td class="h" > <a name="4367">4367</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4368">4368</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<pixels> - this is filled in with a pointer to the locked pixels, appropriately offset by the locked area </td> </tr> <tr> <td class="h" > <a name="4369">4369</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4370">4370</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<pitch> - this is filled in with the pitch of the locked pixels; the pitch is the length of one row in bytes </td> </tr> <tr> <td class="h" > <a name="4371">4371</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4372">4372</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4373">4373</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4374">4374</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns 0 on success or a negative error code if the texture is not valid or </td> </tr> <tr> <td class="h" > <a name="4375">4375</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> was not created with `SDL_TEXTUREACCESS_STREAMING`; call L<< C<SDL_GetError( </td> </tr> <tr> <td class="h" > <a name="4376">4376</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4377">4377</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4378">4378</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_LockTextureToSurface( ... )> </td> </tr> <tr> <td class="h" > <a name="4379">4379</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4380">4380</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Lock a portion of the texture for B<write-only> pixel access, and expose it as </td> </tr> <tr> <td class="h" > <a name="4381">4381</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> a SDL surface. </td> </tr> <tr> <td class="h" > <a name="4382">4382</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4383">4383</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $surface = SDL_LockTextureSurface( $texture, $rect ); </td> </tr> <tr> <td class="h" > <a name="4384">4384</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4385">4385</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Besides providing an L<SDL2::Surface> instead of raw pixel data, this function </td> </tr> <tr> <td class="h" > <a name="4386">4386</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> operates like L<SDL2::LockTexture>. </td> </tr> <tr> <td class="h" > <a name="4387">4387</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4388">4388</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> As an optimization, the pixels made available for editing don't necessarily </td> </tr> <tr> <td class="h" > <a name="4389">4389</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> contain the old texture data. This is a write-only operation, and if you need </td> </tr> <tr> <td class="h" > <a name="4390">4390</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> to keep a copy of the texture data you should do that at the application level. </td> </tr> <tr> <td class="h" > <a name="4391">4391</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4392">4392</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> You must use L<< C<SDL_UnlockTexture( ... )>\|/C<SDL_UnlockTexture( ... )> >> to </td> </tr> <tr> <td class="h" > <a name="4393">4393</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> unlock the pixels and apply any changes. </td> </tr> <tr> <td class="h" > <a name="4394">4394</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4395">4395</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The returned surface is freed internally after calling L<< C<SDL_UnlockTexture( </td> </tr> <tr> <td class="h" > <a name="4396">4396</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ... )>\|/C<SDL_UnlockTexture( ... )> >> or L<< C<SDL_DestroyTexture( ... </td> </tr> <tr> <td class="h" > <a name="4397">4397</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_DestroyTexture( ... )> >>. The caller should not free it. </td> </tr> <tr> <td class="h" > <a name="4398">4398</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4399">4399</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4400">4400</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4401">4401</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4402">4402</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4403">4403</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to lock for access, which was created with C<SDL_TEXTUREACCESS_STREAMING> </td> </tr> <tr> <td class="h" > <a name="4404">4404</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4405">4405</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rect> - a pointer to the rectangle to lock for access. If the rect is undef, the entire texture will be locked </td> </tr> <tr> <td class="h" > <a name="4406">4406</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4407">4407</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4408">4408</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4409">4409</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the L<SDL2::Surface> structure on success, or C<-1> if the texture is </td> </tr> <tr> <td class="h" > <a name="4410">4410</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> not valid or was not created with C<SDL_TEXTUREACCESS_STREAMING>. </td> </tr> <tr> <td class="h" > <a name="4411">4411</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4412">4412</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_UnlockTexture( ... )> </td> </tr> <tr> <td class="h" > <a name="4413">4413</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4414">4414</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Unlock a texture, uploading the changes to video memory, if needed. </td> </tr> <tr> <td class="h" > <a name="4415">4415</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4416">4416</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_UnlockTexture( $texture ); </td> </tr> <tr> <td class="h" > <a name="4417">4417</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4418">4418</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> B<Warning>: Please note that L<< C<SDL_LockTexture( ... )>\|/C<SDL_LockTexture( </td> </tr> <tr> <td class="h" > <a name="4419">4419</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ... )> >> is intended to be write-only; it will not guarantee the previous </td> </tr> <tr> <td class="h" > <a name="4420">4420</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> contents of the texture will be provided. You must fully initialize any area of </td> </tr> <tr> <td class="h" > <a name="4421">4421</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> a texture that you lock before unlocking it, as the pixels might otherwise be </td> </tr> <tr> <td class="h" > <a name="4422">4422</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> uninitialized memory. </td> </tr> <tr> <td class="h" > <a name="4423">4423</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4424">4424</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Which is to say: locking and immediately unlocking a texture can result in </td> </tr> <tr> <td class="h" > <a name="4425">4425</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> corrupted textures, depending on the renderer in use. </td> </tr> <tr> <td class="h" > <a name="4426">4426</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4427">4427</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4428">4428</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4429">4429</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4430">4430</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4431">4431</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - a texture locked by L<< C<SDL_LockTexture( ... )>\|/C<SDL_LockTexture( ... )> >> </td> </tr> <tr> <td class="h" > <a name="4432">4432</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4433">4433</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4434">4434</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4435">4435</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderTargetSupported( ... )> </td> </tr> <tr> <td class="h" > <a name="4436">4436</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4437">4437</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Determine whether a renderer supports the use of render targets. </td> </tr> <tr> <td class="h" > <a name="4438">4438</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4439">4439</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $bool = SDL_RenderTargetSupported( $renderer ); </td> </tr> <tr> <td class="h" > <a name="4440">4440</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4441">4441</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4442">4442</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4443">4443</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4444">4444</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4445">4445</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the renderer that will be checked </td> </tr> <tr> <td class="h" > <a name="4446">4446</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4447">4447</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4448">4448</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4449">4449</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns true if supported or false if not. </td> </tr> <tr> <td class="h" > <a name="4450">4450</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4451">4451</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetRenderTarget( ... )> </td> </tr> <tr> <td class="h" > <a name="4452">4452</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4453">4453</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set a texture as the current rendering target. </td> </tr> <tr> <td class="h" > <a name="4454">4454</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4455">4455</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetRenderTarget( $renderer, $texture ); </td> </tr> <tr> <td class="h" > <a name="4456">4456</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4457">4457</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Before using this function, you should check the C<SDL_RENDERER_TARGETTEXTURE> </td> </tr> <tr> <td class="h" > <a name="4458">4458</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> bit in the flags of L<SDL2::RendererInfo> to see if render targets are </td> </tr> <tr> <td class="h" > <a name="4459">4459</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> supported. </td> </tr> <tr> <td class="h" > <a name="4460">4460</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4461">4461</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The default render target is the window for which the renderer was created. To </td> </tr> <tr> <td class="h" > <a name="4462">4462</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> stop rendering to a texture and render to the window again, call this function </td> </tr> <tr> <td class="h" > <a name="4463">4463</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> with a undefined C<texture>. </td> </tr> <tr> <td class="h" > <a name="4464">4464</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4465">4465</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4466">4466</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4467">4467</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4468">4468</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4469">4469</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4470">4470</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4471">4471</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the targeted texture, which must be created with the C<SDL_TEXTUREACCESS_TARGET> flag, or undef to render to the window instead of a texture. </td> </tr> <tr> <td class="h" > <a name="4472">4472</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4473">4473</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4474">4474</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4475">4475</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4476">4476</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4477">4477</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4478">4478</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetRenderTarget( ... )> </td> </tr> <tr> <td class="h" > <a name="4479">4479</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4480">4480</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the current render target. </td> </tr> <tr> <td class="h" > <a name="4481">4481</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4482">4482</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $texture = SDL_GetRenderTarget( $renderer ); </td> </tr> <tr> <td class="h" > <a name="4483">4483</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4484">4484</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The default render target is the window for which the renderer was created, and </td> </tr> <tr> <td class="h" > <a name="4485">4485</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> is reported an undefined value here. </td> </tr> <tr> <td class="h" > <a name="4486">4486</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4487">4487</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4488">4488</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4489">4489</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4490">4490</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4491">4491</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4492">4492</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4493">4493</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4494">4494</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4495">4495</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the current render target or undef for the default render target. </td> </tr> <tr> <td class="h" > <a name="4496">4496</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4497">4497</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderSetLogicalSize( ... )> </td> </tr> <tr> <td class="h" > <a name="4498">4498</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4499">4499</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set a device independent resolution for rendering. </td> </tr> <tr> <td class="h" > <a name="4500">4500</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4501">4501</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderSetLogicalSize( $renderer, 100, 100 ); </td> </tr> <tr> <td class="h" > <a name="4502">4502</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4503">4503</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function uses the viewport and scaling functionality to allow a fixed </td> </tr> <tr> <td class="h" > <a name="4504">4504</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> logical resolution for rendering, regardless of the actual output resolution. </td> </tr> <tr> <td class="h" > <a name="4505">4505</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If the actual output resolution doesn't have the same aspect ratio the output </td> </tr> <tr> <td class="h" > <a name="4506">4506</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> rendering will be centered within the output display. </td> </tr> <tr> <td class="h" > <a name="4507">4507</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4508">4508</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If the output display is a window, mouse and touch events in the window will be </td> </tr> <tr> <td class="h" > <a name="4509">4509</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> filtered and scaled so they seem to arrive within the logical resolution. </td> </tr> <tr> <td class="h" > <a name="4510">4510</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4511">4511</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If this function results in scaling or subpixel drawing by the rendering </td> </tr> <tr> <td class="h" > <a name="4512">4512</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> backend, it will be handled using the appropriate quality hints. </td> </tr> <tr> <td class="h" > <a name="4513">4513</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4514">4514</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4515">4515</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4516">4516</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4517">4517</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4518">4518</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the renderer for which resolution should be set </td> </tr> <tr> <td class="h" > <a name="4519">4519</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4520">4520</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<w> - the width of the logical resolution </td> </tr> <tr> <td class="h" > <a name="4521">4521</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4522">4522</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<h> - the height of the logical resolution </td> </tr> <tr> <td class="h" > <a name="4523">4523</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4524">4524</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4525">4525</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4526">4526</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4527">4527</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4528">4528</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4529">4529</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderGetLogicalSize( ... )> </td> </tr> <tr> <td class="h" > <a name="4530">4530</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4531">4531</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get device independent resolution for rendering. </td> </tr> <tr> <td class="h" > <a name="4532">4532</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4533">4533</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($w, $h) = SDL_RenderGetLogicalSize( $renderer ); </td> </tr> <tr> <td class="h" > <a name="4534">4534</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4535">4535</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This may return C<0> for C<w> and C<h> if the L<SDL2::Renderer> has never had </td> </tr> <tr> <td class="h" > <a name="4536">4536</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> its logical size set by L<< C<SDL_RenderSetLogicalSize( ... </td> </tr> <tr> <td class="h" > <a name="4537">4537</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_RenderSetLogicalSize( ... )> >> and never had a render target set. </td> </tr> <tr> <td class="h" > <a name="4538">4538</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4539">4539</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4540">4540</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4541">4541</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4542">4542</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4543">4543</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - a rendering context </td> </tr> <tr> <td class="h" > <a name="4544">4544</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4545">4545</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4546">4546</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4547">4547</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the width and height. </td> </tr> <tr> <td class="h" > <a name="4548">4548</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4549">4549</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderSetIntegerScale( ... )> </td> </tr> <tr> <td class="h" > <a name="4550">4550</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4551">4551</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set whether to force integer scales for resolution-independent rendering. </td> </tr> <tr> <td class="h" > <a name="4552">4552</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4553">4553</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderSetIntegerScale( $renderer, 1 ); </td> </tr> <tr> <td class="h" > <a name="4554">4554</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4555">4555</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function restricts the logical viewport to integer values - that is, when </td> </tr> <tr> <td class="h" > <a name="4556">4556</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> a resolution is between two multiples of a logical size, the viewport size is </td> </tr> <tr> <td class="h" > <a name="4557">4557</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> rounded down to the lower multiple. </td> </tr> <tr> <td class="h" > <a name="4558">4558</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4559">4559</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4560">4560</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4561">4561</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4562">4562</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4563">4563</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the renderer for which integer scaling should be set </td> </tr> <tr> <td class="h" > <a name="4564">4564</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4565">4565</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<enable> - enable or disable the integer scaling for rendering </td> </tr> <tr> <td class="h" > <a name="4566">4566</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4567">4567</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4568">4568</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4569">4569</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4570">4570</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4571">4571</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4572">4572</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderGetIntegerScale( ... )> </td> </tr> <tr> <td class="h" > <a name="4573">4573</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4574">4574</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get whether integer scales are forced for resolution-independent rendering. </td> </tr> <tr> <td class="h" > <a name="4575">4575</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4576">4576</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderGetIntegerScale( $renderer ); </td> </tr> <tr> <td class="h" > <a name="4577">4577</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4578">4578</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4579">4579</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4580">4580</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4581">4581</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4582">4582</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the renderer from which integer scaling should be queried </td> </tr> <tr> <td class="h" > <a name="4583">4583</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4584">4584</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4585">4585</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4586">4586</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns true if integer scales are forced or false if not and on failure; call </td> </tr> <tr> <td class="h" > <a name="4587">4587</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4588">4588</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4589">4589</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderSetViewport( ... )> </td> </tr> <tr> <td class="h" > <a name="4590">4590</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4591">4591</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the drawing area for rendering on the current target. </td> </tr> <tr> <td class="h" > <a name="4592">4592</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4593">4593</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderSetViewport( $renderer, $rect ); </td> </tr> <tr> <td class="h" > <a name="4594">4594</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4595">4595</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> When the window is resized, the viewport is reset to fill the entire new window </td> </tr> <tr> <td class="h" > <a name="4596">4596</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> size. </td> </tr> <tr> <td class="h" > <a name="4597">4597</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4598">4598</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4599">4599</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4600">4600</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4601">4601</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4602">4602</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4603">4603</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4604">4604</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rect> - the L<SDL2::Rect> structure representing the drawing area, or undef to set the viewport to the entire target </td> </tr> <tr> <td class="h" > <a name="4605">4605</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4606">4606</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4607">4607</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4608">4608</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4609">4609</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4610">4610</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4611">4611</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderGetViewport( ... )> </td> </tr> <tr> <td class="h" > <a name="4612">4612</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4613">4613</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the drawing area for the current target. </td> </tr> <tr> <td class="h" > <a name="4614">4614</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4615">4615</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $rect = SDL_RenderGetViewport( $renderer ); </td> </tr> <tr> <td class="h" > <a name="4616">4616</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4617">4617</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4618">4618</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4619">4619</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4620">4620</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4621">4621</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4622">4622</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4623">4623</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4624">4624</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4625">4625</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns an L<SDL2::Rect> structure filled in with the current drawing area. </td> </tr> <tr> <td class="h" > <a name="4626">4626</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4627">4627</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderSetClipRect( ... )> </td> </tr> <tr> <td class="h" > <a name="4628">4628</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4629">4629</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the clip rectangle for rendering on the specified target. </td> </tr> <tr> <td class="h" > <a name="4630">4630</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4631">4631</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderSetClipRect( $renderer, $rect ); </td> </tr> <tr> <td class="h" > <a name="4632">4632</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4633">4633</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4634">4634</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4635">4635</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4636">4636</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4637">4637</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context for which clip rectangle should be set </td> </tr> <tr> <td class="h" > <a name="4638">4638</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4639">4639</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rect> - an L<SDL2::Rect> structure representing the clip area, relative to the viewport, or undef to disable clipping </td> </tr> <tr> <td class="h" > <a name="4640">4640</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4641">4641</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4642">4642</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4643">4643</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4644">4644</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4645">4645</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4646">4646</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderGetClipRect( ... )> </td> </tr> <tr> <td class="h" > <a name="4647">4647</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4648">4648</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the clip rectangle for the current target. </td> </tr> <tr> <td class="h" > <a name="4649">4649</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4650">4650</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $rect = SDL_RenderGetClipRect( $renderer ); </td> </tr> <tr> <td class="h" > <a name="4651">4651</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4652">4652</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4653">4653</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4654">4654</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4655">4655</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4656">4656</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context from which clip rectangle should be queried </td> </tr> <tr> <td class="h" > <a name="4657">4657</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4658">4658</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4659">4659</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4660">4660</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns an L<SDL2::Rect> structure filled in with the current clipping area or </td> </tr> <tr> <td class="h" > <a name="4661">4661</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> an empty rectangle if clipping is disabled. </td> </tr> <tr> <td class="h" > <a name="4662">4662</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4663">4663</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderIsClipEnabled( ... )> </td> </tr> <tr> <td class="h" > <a name="4664">4664</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4665">4665</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get whether clipping is enabled on the given renderer. </td> </tr> <tr> <td class="h" > <a name="4666">4666</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4667">4667</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $tf = SDL_RenderIsClipEnabled( $renderer ); </td> </tr> <tr> <td class="h" > <a name="4668">4668</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4669">4669</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4670">4670</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4671">4671</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4672">4672</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4673">4673</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the renderer from which clip state should be queried </td> </tr> <tr> <td class="h" > <a name="4674">4674</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4675">4675</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4676">4676</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4677">4677</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns true if clipping is enabled or false if not; call L<< C<SDL_GetError( </td> </tr> <tr> <td class="h" > <a name="4678">4678</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4679">4679</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4680">4680</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderSetScale( ... )> </td> </tr> <tr> <td class="h" > <a name="4681">4681</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4682">4682</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the drawing scale for rendering on the current target. </td> </tr> <tr> <td class="h" > <a name="4683">4683</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4684">4684</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderSetScale( $renderer, .5, 1 ); </td> </tr> <tr> <td class="h" > <a name="4685">4685</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4686">4686</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The drawing coordinates are scaled by the x/y scaling factors before they are </td> </tr> <tr> <td class="h" > <a name="4687">4687</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> used by the renderer. This allows resolution independent drawing with a single </td> </tr> <tr> <td class="h" > <a name="4688">4688</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> coordinate system. </td> </tr> <tr> <td class="h" > <a name="4689">4689</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4690">4690</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If this results in scaling or subpixel drawing by the rendering backend, it </td> </tr> <tr> <td class="h" > <a name="4691">4691</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> will be handled using the appropriate quality hints. For best results use </td> </tr> <tr> <td class="h" > <a name="4692">4692</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> integer scaling factors. </td> </tr> <tr> <td class="h" > <a name="4693">4693</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4694">4694</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4695">4695</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4696">4696</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4697">4697</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4698">4698</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - a rendering context </td> </tr> <tr> <td class="h" > <a name="4699">4699</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4700">4700</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<scaleX> - the horizontal scaling factor </td> </tr> <tr> <td class="h" > <a name="4701">4701</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4702">4702</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<scaleY> - the vertical scaling factor </td> </tr> <tr> <td class="h" > <a name="4703">4703</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4704">4704</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4705">4705</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4706">4706</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4707">4707</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4708">4708</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4709">4709</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderGetScale( ... )> </td> </tr> <tr> <td class="h" > <a name="4710">4710</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4711">4711</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the drawing scale for the current target. </td> </tr> <tr> <td class="h" > <a name="4712">4712</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4713">4713</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($scaleX, $scaleY) = SDL_RenderGetScale( $renderer ); </td> </tr> <tr> <td class="h" > <a name="4714">4714</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4715">4715</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4716">4716</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4717">4717</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4718">4718</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4719">4719</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the renderer from which drawing scale should be queried </td> </tr> <tr> <td class="h" > <a name="4720">4720</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4721">4721</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4722">4722</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4723">4723</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the horizonal and vertical scaling factors. </td> </tr> <tr> <td class="h" > <a name="4724">4724</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4725">4725</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetRenderDrawColor( ... )> </td> </tr> <tr> <td class="h" > <a name="4726">4726</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4727">4727</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the color used for drawing operations (Rect, Line and Clear). </td> </tr> <tr> <td class="h" > <a name="4728">4728</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4729">4729</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetRenderDrawColor( $renderer, 0, 0, 128, SDL_ALPHA_OPAQUE ); </td> </tr> <tr> <td class="h" > <a name="4730">4730</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4731">4731</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the color for drawing or filling rectangles, lines, and points, and for L<< </td> </tr> <tr> <td class="h" > <a name="4732">4732</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_RenderClear( ... )>\|/C<SDL_RenderClear( ... )> >>. </td> </tr> <tr> <td class="h" > <a name="4733">4733</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4734">4734</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4735">4735</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4736">4736</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4737">4737</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4738">4738</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4739">4739</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4740">4740</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<r> - the red value used to draw on the rendering target </td> </tr> <tr> <td class="h" > <a name="4741">4741</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4742">4742</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<g> - the green value used to draw on the rendering target </td> </tr> <tr> <td class="h" > <a name="4743">4743</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4744">4744</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<b> - the blue value used to draw on the rendering target </td> </tr> <tr> <td class="h" > <a name="4745">4745</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4746">4746</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<a> - the alpha value used to draw on the rendering target; usually C<SDL_ALPHA_OPAQUE> (255). Use C<SDL_SetRenderDrawBlendMode> to specify how the alpha channel is used </td> </tr> <tr> <td class="h" > <a name="4747">4747</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4748">4748</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4749">4749</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4750">4750</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4751">4751</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4752">4752</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4753">4753</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetRenderDrawColor( ... )> </td> </tr> <tr> <td class="h" > <a name="4754">4754</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4755">4755</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the color used for drawing operations (Rect, Line and Clear). </td> </tr> <tr> <td class="h" > <a name="4756">4756</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4757">4757</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($r, $g, $b, $a) = SDL_GetRenderDrawColor( $renderer ); </td> </tr> <tr> <td class="h" > <a name="4758">4758</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4759">4759</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4760">4760</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4761">4761</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4762">4762</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4763">4763</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4764">4764</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4765">4765</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4766">4766</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4767">4767</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns red, green, blue, and alpha values on success or a negative error code </td> </tr> <tr> <td class="h" > <a name="4768">4768</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> on failure; call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more </td> </tr> <tr> <td class="h" > <a name="4769">4769</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> information. </td> </tr> <tr> <td class="h" > <a name="4770">4770</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4771">4771</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_SetRenderDrawBlendMode( ... )> </td> </tr> <tr> <td class="h" > <a name="4772">4772</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4773">4773</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Set the blend mode used for drawing operations (Fill and Line). </td> </tr> <tr> <td class="h" > <a name="4774">4774</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4775">4775</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_SetRenderDrawBlendMode( $renderer, SDL_BLENDMODE_BLEND ); </td> </tr> <tr> <td class="h" > <a name="4776">4776</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4777">4777</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If the blend mode is not supported, the closest supported mode is chosen. </td> </tr> <tr> <td class="h" > <a name="4778">4778</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4779">4779</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4780">4780</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4781">4781</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4782">4782</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4783">4783</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4784">4784</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4785">4785</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<blendMode> - the L<< C<:blendMode>\|/C<:blendMode> >> to use for blending </td> </tr> <tr> <td class="h" > <a name="4786">4786</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4787">4787</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4788">4788</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4789">4789</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4790">4790</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4791">4791</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4792">4792</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetRenderDrawBlendMode( ... )> </td> </tr> <tr> <td class="h" > <a name="4793">4793</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4794">4794</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the blend mode used for drawing operations. </td> </tr> <tr> <td class="h" > <a name="4795">4795</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4796">4796</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $blendMode = SDL_GetRenderDrawBlendMode( $rendering ); </td> </tr> <tr> <td class="h" > <a name="4797">4797</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4798">4798</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4799">4799</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4800">4800</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4801">4801</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4802">4802</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4803">4803</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4804">4804</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4805">4805</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4806">4806</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the current C<:blendMode> on success or a negative error code on </td> </tr> <tr> <td class="h" > <a name="4807">4807</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> failure; call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more </td> </tr> <tr> <td class="h" > <a name="4808">4808</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> information. </td> </tr> <tr> <td class="h" > <a name="4809">4809</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4810">4810</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderClear( ... )> </td> </tr> <tr> <td class="h" > <a name="4811">4811</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4812">4812</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Clear the current rendering target with the drawing color. </td> </tr> <tr> <td class="h" > <a name="4813">4813</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4814">4814</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderClear( $renderer ); </td> </tr> <tr> <td class="h" > <a name="4815">4815</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4816">4816</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function clears the entire rendering target, ignoring the viewport and the </td> </tr> <tr> <td class="h" > <a name="4817">4817</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> clip rectangle. </td> </tr> <tr> <td class="h" > <a name="4818">4818</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4819">4819</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4820">4820</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4821">4821</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4822">4822</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4823">4823</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4824">4824</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4825">4825</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4826">4826</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4827">4827</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4828">4828</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderDrawPoint( ... )> </td> </tr> <tr> <td class="h" > <a name="4829">4829</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4830">4830</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Draw a point on the current rendering target. </td> </tr> <tr> <td class="h" > <a name="4831">4831</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4832">4832</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderDrawPoint( $renderer, 100, 100 ); </td> </tr> <tr> <td class="h" > <a name="4833">4833</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4834">4834</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_RenderDrawPoint( ... )> draws a single point. If you want to draw </td> </tr> <tr> <td class="h" > <a name="4835">4835</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> multiple, use L<< C<SDL_RenderDrawPoints( ... )>\|/C<SDL_RenderDrawPoints( ... </td> </tr> <tr> <td class="h" > <a name="4836">4836</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )> >> instead. </td> </tr> <tr> <td class="h" > <a name="4837">4837</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4838">4838</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4839">4839</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4840">4840</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4841">4841</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4842">4842</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4843">4843</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4844">4844</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<x> - the x coordinate of the point </td> </tr> <tr> <td class="h" > <a name="4845">4845</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4846">4846</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<y> - the y coordinate of the point </td> </tr> <tr> <td class="h" > <a name="4847">4847</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4848">4848</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4849">4849</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4850">4850</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4851">4851</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4852">4852</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4853">4853</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderDrawPoints( ... )> </td> </tr> <tr> <td class="h" > <a name="4854">4854</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4855">4855</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Draw multiple points on the current rendering target. </td> </tr> <tr> <td class="h" > <a name="4856">4856</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4857">4857</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my @points = map { SDL2::Point->new( {x => int rand, y => int rand } ) } 1..1024; </td> </tr> <tr> <td class="h" > <a name="4858">4858</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderDrawPoints( $renderer, @points ); </td> </tr> <tr> <td class="h" > <a name="4859">4859</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4860">4860</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4861">4861</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4862">4862</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4863">4863</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4864">4864</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<points> - an array of L<SDL2::Point> structures that represent the points to draw </td> </tr> <tr> <td class="h" > <a name="4865">4865</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4866">4866</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4867">4867</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4868">4868</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4869">4869</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4870">4870</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4871">4871</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderDrawLine( ... )> </td> </tr> <tr> <td class="h" > <a name="4872">4872</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4873">4873</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Draw a line on the current rendering target. </td> </tr> <tr> <td class="h" > <a name="4874">4874</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4875">4875</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderDrawLine( $renderer, 300, 240, 340, 240 ); </td> </tr> <tr> <td class="h" > <a name="4876">4876</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4877">4877</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_RenderDrawLine( ... )> draws the line to include both end points. If you </td> </tr> <tr> <td class="h" > <a name="4878">4878</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> want to draw multiple, connecting lines use L<< C<SDL_RenderDrawLines( ... </td> </tr> <tr> <td class="h" > <a name="4879">4879</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_RenderDrawLines( ... )> >> instead. </td> </tr> <tr> <td class="h" > <a name="4880">4880</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4881">4881</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4882">4882</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4883">4883</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4884">4884</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4885">4885</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4886">4886</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4887">4887</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<x1> - the x coordinate of the start point </td> </tr> <tr> <td class="h" > <a name="4888">4888</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4889">4889</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<y1> - the y coordinate of the start point </td> </tr> <tr> <td class="h" > <a name="4890">4890</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4891">4891</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<x2> - the x coordinate of the end point </td> </tr> <tr> <td class="h" > <a name="4892">4892</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4893">4893</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<y2> - the y coordinate of the end point </td> </tr> <tr> <td class="h" > <a name="4894">4894</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4895">4895</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4896">4896</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4897">4897</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4898">4898</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4899">4899</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4900">4900</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderDrawLines( ... )> </td> </tr> <tr> <td class="h" > <a name="4901">4901</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4902">4902</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Draw a series of connected lines on the current rendering target. </td> </tr> <tr> <td class="h" > <a name="4903">4903</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4904">4904</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderDrawLines( $renderer, @points); </td> </tr> <tr> <td class="h" > <a name="4905">4905</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4906">4906</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4907">4907</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4908">4908</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4909">4909</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4910">4910</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4911">4911</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4912">4912</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<points> - an array of L<SDL2::Point> structures representing points along the lines </td> </tr> <tr> <td class="h" > <a name="4913">4913</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4914">4914</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4915">4915</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4916">4916</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4917">4917</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4918">4918</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4919">4919</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderDrawRect( ... )> </td> </tr> <tr> <td class="h" > <a name="4920">4920</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4921">4921</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Draw a rectangle on the current rendering target. </td> </tr> <tr> <td class="h" > <a name="4922">4922</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4923">4923</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderDrawRect( $renderer, SDL2::Rect->new( { x => 100, y => 100, w => 100, h => 100 } ) ); </td> </tr> <tr> <td class="h" > <a name="4924">4924</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4925">4925</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4926">4926</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4927">4927</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4928">4928</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4929">4929</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4930">4930</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4931">4931</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rect> - an L<SDL2::Rect> structure representing the rectangle to draw </td> </tr> <tr> <td class="h" > <a name="4932">4932</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4933">4933</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO - or undef to outline the entire rendering target </td> </tr> <tr> <td class="h" > <a name="4934">4934</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4935">4935</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4936">4936</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4937">4937</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4938">4938</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4939">4939</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4940">4940</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderDrawRects( ... )> </td> </tr> <tr> <td class="h" > <a name="4941">4941</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4942">4942</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Draw some number of rectangles on the current rendering target. </td> </tr> <tr> <td class="h" > <a name="4943">4943</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4944">4944</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderDrawRects( $renderer, </td> </tr> <tr> <td class="h" > <a name="4945">4945</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL2::Rect->new( { x => 100, y => 100, w => 100, h => 100 } ), </td> </tr> <tr> <td class="h" > <a name="4946">4946</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL2::Rect->new( { x => 75, y => 75, w => 50, h => 50 } ) </td> </tr> <tr> <td class="h" > <a name="4947">4947</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ); </td> </tr> <tr> <td class="h" > <a name="4948">4948</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4949">4949</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4950">4950</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4951">4951</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4952">4952</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4953">4953</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4954">4954</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4955">4955</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rects> - an array of SDL2::Rect structures representing the rectangles to be drawn </td> </tr> <tr> <td class="h" > <a name="4956">4956</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4957">4957</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4958">4958</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4959">4959</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4960">4960</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4961">4961</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4962">4962</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderFillRect( ... )> </td> </tr> <tr> <td class="h" > <a name="4963">4963</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4964">4964</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Fill a rectangle on the current rendering target with the drawing color. </td> </tr> <tr> <td class="h" > <a name="4965">4965</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4966">4966</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderFillRect( $renderer, SDL2::Rect->new( { x => 100, y => 100, w => 100, h => 100 } ) ); </td> </tr> <tr> <td class="h" > <a name="4967">4967</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4968">4968</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The current drawing color is set by L<< C<SDL_SetRenderDrawColor( ... </td> </tr> <tr> <td class="h" > <a name="4969">4969</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_SetRenderDrawColor( ... )> >>, and the color's alpha value is ignored </td> </tr> <tr> <td class="h" > <a name="4970">4970</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> unless blending is enabled with the appropriate call to L<< </td> </tr> <tr> <td class="h" > <a name="4971">4971</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_SetRenderDrawBlendMode( ... )>\|/C<SDL_SetRenderDrawBlendMode( ... )> >>. </td> </tr> <tr> <td class="h" > <a name="4972">4972</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4973">4973</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4974">4974</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4975">4975</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="4976">4976</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4977">4977</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="4978">4978</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4979">4979</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rect> - the L<SDL2::Rect> structure representing the rectangle to fill </td> </tr> <tr> <td class="h" > <a name="4980">4980</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4981">4981</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO - or undef for the entire rendering target </td> </tr> <tr> <td class="h" > <a name="4982">4982</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4983">4983</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="4984">4984</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4985">4985</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="4986">4986</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="4987">4987</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4988">4988</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderFillRects( ... )> </td> </tr> <tr> <td class="h" > <a name="4989">4989</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4990">4990</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Fill some number of rectangles on the current rendering target with the drawing </td> </tr> <tr> <td class="h" > <a name="4991">4991</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> color. </td> </tr> <tr> <td class="h" > <a name="4992">4992</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4993">4993</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderFillRects( $renderer, </td> </tr> <tr> <td class="h" > <a name="4994">4994</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL2::Rect->new( { x => 100, y => 100, w => 100, h => 100 } ), </td> </tr> <tr> <td class="h" > <a name="4995">4995</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL2::Rect->new( { x => 75, y => 75, w => 50, h => 50 } ) </td> </tr> <tr> <td class="h" > <a name="4996">4996</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ); </td> </tr> <tr> <td class="h" > <a name="4997">4997</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="4998">4998</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="4999">4999</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5000">5000</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5001">5001</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5002">5002</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="5003">5003</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5004">5004</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rects> - an array of L<SDL2::Rect> structures representing the rectangles to be filled </td> </tr> <tr> <td class="h" > <a name="5005">5005</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5006">5006</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5007">5007</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5008">5008</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="5009">5009</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="5010">5010</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5011">5011</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderCopy( ... )> </td> </tr> <tr> <td class="h" > <a name="5012">5012</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5013">5013</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Copy a portion of the texture to the current rendering target. </td> </tr> <tr> <td class="h" > <a name="5014">5014</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5015">5015</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderCopy( $renderer, $blueShapes, $srcR, $destR ); </td> </tr> <tr> <td class="h" > <a name="5016">5016</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5017">5017</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The texture is blended with the destination based on its blend mode set with </td> </tr> <tr> <td class="h" > <a name="5018">5018</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> L<< C<SDL_SetTextureBlendMode( ... )>\|/C<SDL_SetTextureBlendMode( ... )> >>. </td> </tr> <tr> <td class="h" > <a name="5019">5019</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5020">5020</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The texture color is affected based on its color modulation set by L<< </td> </tr> <tr> <td class="h" > <a name="5021">5021</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_SetTextureColorMod( ... )>\|/C<SDL_SetTextureColorMod( ... )> >>. </td> </tr> <tr> <td class="h" > <a name="5022">5022</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5023">5023</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The texture alpha is affected based on its alpha modulation set by L<< </td> </tr> <tr> <td class="h" > <a name="5024">5024</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_SetTextureAlphaMod( ... )>\|/C<SDL_SetTextureAlphaMod( ... )> >>. </td> </tr> <tr> <td class="h" > <a name="5025">5025</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5026">5026</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5027">5027</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5028">5028</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5029">5029</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5030">5030</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="5031">5031</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5032">5032</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the source texture </td> </tr> <tr> <td class="h" > <a name="5033">5033</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5034">5034</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<srcrect> - the source L<SDL2::Rect> structure </td> </tr> <tr> <td class="h" > <a name="5035">5035</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5036">5036</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: or NULL for the entire texture </td> </tr> <tr> <td class="h" > <a name="5037">5037</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5038">5038</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<dstrect> - the destination L<SDL2::Rect> structure; the texture will be stretched to fill the given rectangle </td> </tr> <tr> <td class="h" > <a name="5039">5039</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5040">5040</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO or NULL for the entire rendering target; </td> </tr> <tr> <td class="h" > <a name="5041">5041</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5042">5042</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5043">5043</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5044">5044</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="5045">5045</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="5046">5046</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5047">5047</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderCopyEx( ... )> </td> </tr> <tr> <td class="h" > <a name="5048">5048</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5049">5049</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Copy a portion of the texture to the current rendering, with optional rotation </td> </tr> <tr> <td class="h" > <a name="5050">5050</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> and flipping. </td> </tr> <tr> <td class="h" > <a name="5051">5051</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5052">5052</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: I need an example for this... it's complex </td> </tr> <tr> <td class="h" > <a name="5053">5053</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5054">5054</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Copy a portion of the texture to the current rendering target, optionally </td> </tr> <tr> <td class="h" > <a name="5055">5055</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> rotating it by angle around the given center and also flipping it top-bottom </td> </tr> <tr> <td class="h" > <a name="5056">5056</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> and/or left-right. </td> </tr> <tr> <td class="h" > <a name="5057">5057</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5058">5058</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The texture is blended with the destination based on its blend mode set with </td> </tr> <tr> <td class="h" > <a name="5059">5059</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> L<< C<SDL_SetTextureBlendMode( ... )>\|/C<SDL_SetTextureBlendMode( ... )> >>. </td> </tr> <tr> <td class="h" > <a name="5060">5060</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5061">5061</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The texture color is affected based on its color modulation set by L<< </td> </tr> <tr> <td class="h" > <a name="5062">5062</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_SetTextureColorMod( ... )>\|/C<SDL_SetTextureColorMod( ... )> >>. </td> </tr> <tr> <td class="h" > <a name="5063">5063</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5064">5064</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The texture alpha is affected based on its alpha modulation set by L<< </td> </tr> <tr> <td class="h" > <a name="5065">5065</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_SetTextureAlphaMod( ... )>\|/C<SDL_SetTextureAlphaMod( ... )> >>. </td> </tr> <tr> <td class="h" > <a name="5066">5066</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5067">5067</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5068">5068</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5069">5069</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5070">5070</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5071">5071</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="5072">5072</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5073">5073</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the source texture </td> </tr> <tr> <td class="h" > <a name="5074">5074</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5075">5075</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<srcrect> - the source L<SDL2::Rect> structure </td> </tr> <tr> <td class="h" > <a name="5076">5076</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5077">5077</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: or NULL for the entire texture </td> </tr> <tr> <td class="h" > <a name="5078">5078</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5079">5079</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<dstrect> - the destination SDL_Rect structure </td> </tr> <tr> <td class="h" > <a name="5080">5080</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5081">5081</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: or NULL for the entire rendering target </td> </tr> <tr> <td class="h" > <a name="5082">5082</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5083">5083</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<angle> - an angle in degrees that indicates the rotation that will be applied to dstrect, rotating it in a clockwise direction </td> </tr> <tr> <td class="h" > <a name="5084">5084</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5085">5085</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<center> - a pointer to a point indicating the point around which dstrect will be rotated (if NULL, rotation will be done around C<dstrect.w / 2>, C<dstrect.h / 2>) </td> </tr> <tr> <td class="h" > <a name="5086">5086</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5087">5087</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<flip> - a L<:rendererFlip> value stating which flipping actions should be performed on the texture </td> </tr> <tr> <td class="h" > <a name="5088">5088</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5089">5089</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5090">5090</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5091">5091</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="5092">5092</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="5093">5093</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5094">5094</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderDrawPointF( ... )> </td> </tr> <tr> <td class="h" > <a name="5095">5095</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5096">5096</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Draw a point on the current rendering target at subpixel precision. </td> </tr> <tr> <td class="h" > <a name="5097">5097</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5098">5098</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderDrawPointF( $renderer, 25.5, 100.25 ); </td> </tr> <tr> <td class="h" > <a name="5099">5099</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5100">5100</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5101">5101</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5102">5102</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5103">5103</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5104">5104</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - The renderer which should draw a point. </td> </tr> <tr> <td class="h" > <a name="5105">5105</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5106">5106</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<x> - The x coordinate of the point. </td> </tr> <tr> <td class="h" > <a name="5107">5107</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5108">5108</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<y> - The y coordinate of the point. </td> </tr> <tr> <td class="h" > <a name="5109">5109</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5110">5110</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5111">5111</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5112">5112</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success, or C<-1> on error </td> </tr> <tr> <td class="h" > <a name="5113">5113</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5114">5114</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderDrawPointsF( ... )> </td> </tr> <tr> <td class="h" > <a name="5115">5115</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5116">5116</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Draw multiple points on the current rendering target at subpixel precision. </td> </tr> <tr> <td class="h" > <a name="5117">5117</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5118">5118</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my @points = map { SDL2::Point->new( {x => int rand, y => int rand } ) } 1..1024; </td> </tr> <tr> <td class="h" > <a name="5119">5119</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderDrawPointsF( $renderer, @points ); </td> </tr> <tr> <td class="h" > <a name="5120">5120</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5121">5121</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5122">5122</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5123">5123</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5124">5124</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5125">5125</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - The renderer which should draw multiple points </td> </tr> <tr> <td class="h" > <a name="5126">5126</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5127">5127</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<points> - The points to draw </td> </tr> <tr> <td class="h" > <a name="5128">5128</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5129">5129</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5130">5130</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5131">5131</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success, or C<-1> on error; call L<< C<SDL_GetError( </td> </tr> <tr> <td class="h" > <a name="5132">5132</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="5133">5133</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5134">5134</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderDrawLineF( ... )> </td> </tr> <tr> <td class="h" > <a name="5135">5135</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5136">5136</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Draw a line on the current rendering target at subpixel precision. </td> </tr> <tr> <td class="h" > <a name="5137">5137</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5138">5138</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderDrawLineF( $renderer, 100, 100, 250, 100); </td> </tr> <tr> <td class="h" > <a name="5139">5139</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5140">5140</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5141">5141</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5142">5142</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5143">5143</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5144">5144</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - The renderer which should draw a line. </td> </tr> <tr> <td class="h" > <a name="5145">5145</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5146">5146</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<x1> - The x coordinate of the start point. </td> </tr> <tr> <td class="h" > <a name="5147">5147</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5148">5148</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<y1> - The y coordinate of the start point. </td> </tr> <tr> <td class="h" > <a name="5149">5149</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5150">5150</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<x2> - The x coordinate of the end point. </td> </tr> <tr> <td class="h" > <a name="5151">5151</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5152">5152</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<y2> - The y coordinate of the end point. </td> </tr> <tr> <td class="h" > <a name="5153">5153</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5154">5154</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5155">5155</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5156">5156</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success, or C<-1> on error. </td> </tr> <tr> <td class="h" > <a name="5157">5157</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5158">5158</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderDrawLinesF( ... )> </td> </tr> <tr> <td class="h" > <a name="5159">5159</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5160">5160</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Draw a series of connected lines on the current rendering target at subpixel </td> </tr> <tr> <td class="h" > <a name="5161">5161</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> precision. </td> </tr> <tr> <td class="h" > <a name="5162">5162</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5163">5163</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderDrawLines( $renderer, @points); </td> </tr> <tr> <td class="h" > <a name="5164">5164</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5165">5165</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5166">5166</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5167">5167</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5168">5168</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5169">5169</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - The renderer which should draw multiple lines. </td> </tr> <tr> <td class="h" > <a name="5170">5170</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5171">5171</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<points> - The points along the lines </td> </tr> <tr> <td class="h" > <a name="5172">5172</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5173">5173</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5174">5174</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5175">5175</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Return C<0> on success, or C<-1> on error. </td> </tr> <tr> <td class="h" > <a name="5176">5176</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5177">5177</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderDrawRectF( ... )> </td> </tr> <tr> <td class="h" > <a name="5178">5178</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5179">5179</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Draw a rectangle on the current rendering target at subpixel precision. </td> </tr> <tr> <td class="h" > <a name="5180">5180</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5181">5181</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderDrawRectF( $renderer, $point); </td> </tr> <tr> <td class="h" > <a name="5182">5182</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5183">5183</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5184">5184</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5185">5185</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5186">5186</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5187">5187</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - The renderer which should draw a rectangle. </td> </tr> <tr> <td class="h" > <a name="5188">5188</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5189">5189</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rect> - A pointer to the destination rectangle </td> </tr> <tr> <td class="h" > <a name="5190">5190</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5191">5191</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: or NULL to outline the entire rendering target. </td> </tr> <tr> <td class="h" > <a name="5192">5192</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5193">5193</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5194">5194</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5195">5195</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success, or C<-1> on error </td> </tr> <tr> <td class="h" > <a name="5196">5196</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5197">5197</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderDrawRectsF( ... )> </td> </tr> <tr> <td class="h" > <a name="5198">5198</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5199">5199</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Draw some number of rectangles on the current rendering target at subpixel </td> </tr> <tr> <td class="h" > <a name="5200">5200</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> precision. </td> </tr> <tr> <td class="h" > <a name="5201">5201</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5202">5202</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderDrawRectsF( $renderer, </td> </tr> <tr> <td class="h" > <a name="5203">5203</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL2::Rect->new( { x => 100, y => 100, w => 100, h => 100 } ), </td> </tr> <tr> <td class="h" > <a name="5204">5204</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL2::Rect->new( { x => 75, y => 75, w => 50, h => 50 } ) </td> </tr> <tr> <td class="h" > <a name="5205">5205</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ); </td> </tr> <tr> <td class="h" > <a name="5206">5206</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5207">5207</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5208">5208</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5209">5209</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5210">5210</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5211">5211</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - The renderer which should draw multiple rectangles. </td> </tr> <tr> <td class="h" > <a name="5212">5212</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5213">5213</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rects> - A pointer to an array of destination rectangles. </td> </tr> <tr> <td class="h" > <a name="5214">5214</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5215">5215</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5216">5216</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5217">5217</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success, or C<-1> on error. </td> </tr> <tr> <td class="h" > <a name="5218">5218</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5219">5219</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderFillRectF( ... )> </td> </tr> <tr> <td class="h" > <a name="5220">5220</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5221">5221</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Fill a rectangle on the current rendering target with the drawing color at </td> </tr> <tr> <td class="h" > <a name="5222">5222</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> subpixel precision. </td> </tr> <tr> <td class="h" > <a name="5223">5223</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5224">5224</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderFillRectF( $renderer, </td> </tr> <tr> <td class="h" > <a name="5225">5225</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL2::Rect->new( { x => 75, y => 75, w => 50, h => 50 } ) </td> </tr> <tr> <td class="h" > <a name="5226">5226</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ); </td> </tr> <tr> <td class="h" > <a name="5227">5227</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5228">5228</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5229">5229</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5230">5230</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5231">5231</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5232">5232</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - The renderer which should fill a rectangle. </td> </tr> <tr> <td class="h" > <a name="5233">5233</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5234">5234</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rect> - A pointer to the destination rectangle </td> </tr> <tr> <td class="h" > <a name="5235">5235</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5236">5236</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: or NULL for the entire rendering target. </td> </tr> <tr> <td class="h" > <a name="5237">5237</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5238">5238</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5239">5239</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5240">5240</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success, or C<-1> on error. </td> </tr> <tr> <td class="h" > <a name="5241">5241</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5242">5242</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderFillRectsF( ... )> </td> </tr> <tr> <td class="h" > <a name="5243">5243</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5244">5244</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Fill some number of rectangles on the current rendering target with the drawing </td> </tr> <tr> <td class="h" > <a name="5245">5245</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> color at subpixel precision. </td> </tr> <tr> <td class="h" > <a name="5246">5246</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5247">5247</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderFillRectsF( $renderer, </td> </tr> <tr> <td class="h" > <a name="5248">5248</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL2::Rect->new( { x => 100, y => 100, w => 100, h => 100 } ), </td> </tr> <tr> <td class="h" > <a name="5249">5249</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL2::Rect->new( { x => 75, y => 75, w => 50, h => 50 } ) </td> </tr> <tr> <td class="h" > <a name="5250">5250</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ); </td> </tr> <tr> <td class="h" > <a name="5251">5251</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5252">5252</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5253">5253</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5254">5254</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5255">5255</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5256">5256</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - The renderer which should fill multiple rectangles. </td> </tr> <tr> <td class="h" > <a name="5257">5257</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5258">5258</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rects> - A pointer to an array of destination rectangles. </td> </tr> <tr> <td class="h" > <a name="5259">5259</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5260">5260</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5261">5261</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5262">5262</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success, or C<-1> on error. </td> </tr> <tr> <td class="h" > <a name="5263">5263</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5264">5264</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderCopyF( ... )> </td> </tr> <tr> <td class="h" > <a name="5265">5265</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5266">5266</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Copy a portion of the texture to the current rendering target at subpixel </td> </tr> <tr> <td class="h" > <a name="5267">5267</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> precision. </td> </tr> <tr> <td class="h" > <a name="5268">5268</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5269">5269</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: I need to come up with an example for this as well </td> </tr> <tr> <td class="h" > <a name="5270">5270</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5271">5271</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5272">5272</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5273">5273</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5274">5274</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5275">5275</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - The renderer which should copy parts of a texture </td> </tr> <tr> <td class="h" > <a name="5276">5276</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5277">5277</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - The source texture </td> </tr> <tr> <td class="h" > <a name="5278">5278</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5279">5279</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<srcrect> - A pointer to the source rectangle </td> </tr> <tr> <td class="h" > <a name="5280">5280</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5281">5281</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: or NULL for the entiretexture. </td> </tr> <tr> <td class="h" > <a name="5282">5282</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5283">5283</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<dstrect> - A pointer to the destination rectangle </td> </tr> <tr> <td class="h" > <a name="5284">5284</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5285">5285</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: or NULL for the entire rendering target </td> </tr> <tr> <td class="h" > <a name="5286">5286</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5287">5287</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5288">5288</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5289">5289</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success, or C<-1> on error. </td> </tr> <tr> <td class="h" > <a name="5290">5290</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5291">5291</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderCopyExF( ... )> </td> </tr> <tr> <td class="h" > <a name="5292">5292</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5293">5293</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Copy a portion of the source texture to the current rendering target, with </td> </tr> <tr> <td class="h" > <a name="5294">5294</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> rotation and flipping, at subpixel precision. </td> </tr> <tr> <td class="h" > <a name="5295">5295</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5296">5296</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: I need to come up with an example for this as well </td> </tr> <tr> <td class="h" > <a name="5297">5297</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5298">5298</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5299">5299</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5300">5300</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - The renderer which should copy parts of a texture </td> </tr> <tr> <td class="h" > <a name="5301">5301</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5302">5302</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - The source texture </td> </tr> <tr> <td class="h" > <a name="5303">5303</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5304">5304</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<srcrect> - A pointer to the source rectangle </td> </tr> <tr> <td class="h" > <a name="5305">5305</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5306">5306</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: or NULL for the entire texture </td> </tr> <tr> <td class="h" > <a name="5307">5307</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5308">5308</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<dstrect> - A pointer to the destination rectangle </td> </tr> <tr> <td class="h" > <a name="5309">5309</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5310">5310</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: or NULL for the entire rendering target. </td> </tr> <tr> <td class="h" > <a name="5311">5311</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5312">5312</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<angle> - An angle in degrees that indicates the rotation that will be applied to dstrect, rotating it in a clockwise direction </td> </tr> <tr> <td class="h" > <a name="5313">5313</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5314">5314</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<center> - A pointer to a point indicating the point around which dstrect will be rotated (if NULL, rotation will be done around C<dstrect.w/2>, C<dstrect.h/2>) </td> </tr> <tr> <td class="h" > <a name="5315">5315</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5316">5316</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<flip> - A C<:rendererFlip> value stating which flipping actions should be performed on the texture </td> </tr> <tr> <td class="h" > <a name="5317">5317</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5318">5318</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5319">5319</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5320">5320</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success, or C<-1> on error </td> </tr> <tr> <td class="h" > <a name="5321">5321</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5322">5322</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderReadPixels( ... )> </td> </tr> <tr> <td class="h" > <a name="5323">5323</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5324">5324</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Read pixels from the current rendering target to an array of pixels. </td> </tr> <tr> <td class="h" > <a name="5325">5325</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5326">5326</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderReadPixels( </td> </tr> <tr> <td class="h" > <a name="5327">5327</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> $renderer, </td> </tr> <tr> <td class="h" > <a name="5328">5328</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL2::Rect->new( { x => 0, y => 0, w => 640, h => 480 } ), </td> </tr> <tr> <td class="h" > <a name="5329">5329</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_PIXELFORMAT_RGB888, </td> </tr> <tr> <td class="h" > <a name="5330">5330</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> $surface->pixels, $surface->pitch </td> </tr> <tr> <td class="h" > <a name="5331">5331</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ); </td> </tr> <tr> <td class="h" > <a name="5332">5332</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5333">5333</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> B<WARNING>: This is a very slow operation, and should not be used frequently. </td> </tr> <tr> <td class="h" > <a name="5334">5334</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5335">5335</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<pitch> specifies the number of bytes between rows in the destination </td> </tr> <tr> <td class="h" > <a name="5336">5336</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<pixels> data. This allows you to write to a subrectangle or have padded rows </td> </tr> <tr> <td class="h" > <a name="5337">5337</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> in the destination. Generally, C<pitch> should equal the number of pixels per </td> </tr> <tr> <td class="h" > <a name="5338">5338</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> row in the `pixels` data times the number of bytes per pixel, but it might </td> </tr> <tr> <td class="h" > <a name="5339">5339</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> contain additional padding (for example, 24bit RGB Windows Bitmap data pads all </td> </tr> <tr> <td class="h" > <a name="5340">5340</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> rows to multiples of 4 bytes). </td> </tr> <tr> <td class="h" > <a name="5341">5341</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5342">5342</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5343">5343</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5344">5344</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5345">5345</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5346">5346</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="5347">5347</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5348">5348</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<rect> - an L<SDL2::Rect> structure representing the area to read </td> </tr> <tr> <td class="h" > <a name="5349">5349</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5350">5350</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =for TODO: or NULL for the entire render target </td> </tr> <tr> <td class="h" > <a name="5351">5351</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5352">5352</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<format> - an C<:pixelFormatEnum> value of the desired format of the pixel data, or C<0> to use the format of the rendering target </td> </tr> <tr> <td class="h" > <a name="5353">5353</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5354">5354</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<pixels> - pointer to the pixel data to copy into </td> </tr> <tr> <td class="h" > <a name="5355">5355</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5356">5356</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<pitch> - the pitch of the C<pixels> parameter </td> </tr> <tr> <td class="h" > <a name="5357">5357</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5358">5358</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5359">5359</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5360">5360</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="5361">5361</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="5362">5362</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5363">5363</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderPresent( ... )> </td> </tr> <tr> <td class="h" > <a name="5364">5364</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5365">5365</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Update the screen with any rendering performed since the previous call. </td> </tr> <tr> <td class="h" > <a name="5366">5366</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5367">5367</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderPresent( $renderer ); </td> </tr> <tr> <td class="h" > <a name="5368">5368</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5369">5369</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL's rendering functions operate on a backbuffer; that is, calling a rendering </td> </tr> <tr> <td class="h" > <a name="5370">5370</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> function such as L<< C<SDL_RenderDrawLine( ... )>\|/C<SDL_RenderDrawLine( ... )> </td> </tr> <tr> <td class="h" > <a name="5371">5371</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> >> does not directly put a line on the screen, but rather updates the </td> </tr> <tr> <td class="h" > <a name="5372">5372</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> backbuffer. As such, you compose your entire scene and present the composed </td> </tr> <tr> <td class="h" > <a name="5373">5373</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> backbuffer to the screen as a complete picture. </td> </tr> <tr> <td class="h" > <a name="5374">5374</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5375">5375</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Therefore, when using SDL's rendering API, one does all drawing intended for </td> </tr> <tr> <td class="h" > <a name="5376">5376</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the frame, and then calls this function once per frame to present the final </td> </tr> <tr> <td class="h" > <a name="5377">5377</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> drawing to the user. </td> </tr> <tr> <td class="h" > <a name="5378">5378</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5379">5379</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The backbuffer should be considered invalidated after each present; do not </td> </tr> <tr> <td class="h" > <a name="5380">5380</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> assume that previous contents will exist between frames. You are strongly </td> </tr> <tr> <td class="h" > <a name="5381">5381</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> encouraged to call L<< C<SDL_RenderClear( ... )>\|/C<SDL_RenderClear( ... )> >> </td> </tr> <tr> <td class="h" > <a name="5382">5382</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> to initialize the backbuffer before starting each new frame's drawing, even if </td> </tr> <tr> <td class="h" > <a name="5383">5383</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> you plan to overwrite every pixel. </td> </tr> <tr> <td class="h" > <a name="5384">5384</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5385">5385</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5386">5386</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5387">5387</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5388">5388</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5389">5389</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="5390">5390</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5391">5391</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5392">5392</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5393">5393</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_DestroyTexture( ... )> </td> </tr> <tr> <td class="h" > <a name="5394">5394</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5395">5395</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Destroy the specified texture. </td> </tr> <tr> <td class="h" > <a name="5396">5396</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5397">5397</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_DestroyTexture( $texture ); </td> </tr> <tr> <td class="h" > <a name="5398">5398</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5399">5399</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Passing undef or an otherwise invalid texture will set the SDL error message to </td> </tr> <tr> <td class="h" > <a name="5400">5400</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> "Invalid texture". </td> </tr> <tr> <td class="h" > <a name="5401">5401</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5402">5402</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5403">5403</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5404">5404</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5405">5405</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5406">5406</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to destroy </td> </tr> <tr> <td class="h" > <a name="5407">5407</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5408">5408</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5409">5409</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5410">5410</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5411">5411</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_DestroyRenderer( ... )> </td> </tr> <tr> <td class="h" > <a name="5412">5412</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5413">5413</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Destroy the rendering context for a window and free associated textures. </td> </tr> <tr> <td class="h" > <a name="5414">5414</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5415">5415</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_DestroyRenderer( $renderer ); </td> </tr> <tr> <td class="h" > <a name="5416">5416</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5417">5417</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5418">5418</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5419">5419</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5420">5420</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5421">5421</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="5422">5422</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5423">5423</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5424">5424</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5425">5425</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderFlush( ... )> </td> </tr> <tr> <td class="h" > <a name="5426">5426</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5427">5427</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Force the rendering context to flush any pending commands to the underlying </td> </tr> <tr> <td class="h" > <a name="5428">5428</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> rendering API. </td> </tr> <tr> <td class="h" > <a name="5429">5429</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5430">5430</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RenderFlush( $renderer ); </td> </tr> <tr> <td class="h" > <a name="5431">5431</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5432">5432</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> You do not need to (and in fact, shouldn't) call this function unless you are </td> </tr> <tr> <td class="h" > <a name="5433">5433</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> planning to call into OpenGL/Direct3D/Metal/whatever directly in addition to </td> </tr> <tr> <td class="h" > <a name="5434">5434</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> using an SDL_Renderer. </td> </tr> <tr> <td class="h" > <a name="5435">5435</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5436">5436</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This is for a very-specific case: if you are using SDL's render API, you asked </td> </tr> <tr> <td class="h" > <a name="5437">5437</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> for a specific renderer backend (OpenGL, Direct3D, etc), you set </td> </tr> <tr> <td class="h" > <a name="5438">5438</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_HINT_RENDER_BATCHING> to "C<1>", and you plan to make OpenGL/D3D/whatever </td> </tr> <tr> <td class="h" > <a name="5439">5439</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> calls in addition to SDL render API calls. If all of this applies, you should </td> </tr> <tr> <td class="h" > <a name="5440">5440</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> call L<< C<SDL_RenderFlush( ... )>\|/C<SDL_RenderFlush( ... )> >> between calls </td> </tr> <tr> <td class="h" > <a name="5441">5441</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> to SDL's render API and the low-level API you're using in cooperation. </td> </tr> <tr> <td class="h" > <a name="5442">5442</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5443">5443</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> In all other cases, you can ignore this function. This is only here to get </td> </tr> <tr> <td class="h" > <a name="5444">5444</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> maximum performance out of a specific situation. In all other cases, SDL will </td> </tr> <tr> <td class="h" > <a name="5445">5445</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> do the right thing, perhaps at a performance loss. </td> </tr> <tr> <td class="h" > <a name="5446">5446</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5447">5447</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function is first available in SDL 2.0.10, and is not needed in 2.0.9 and </td> </tr> <tr> <td class="h" > <a name="5448">5448</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> earlier, as earlier versions did not queue rendering commands at all, instead </td> </tr> <tr> <td class="h" > <a name="5449">5449</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> flushing them to the OS immediately. </td> </tr> <tr> <td class="h" > <a name="5450">5450</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5451">5451</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5452">5452</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5453">5453</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5454">5454</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5455">5455</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the rendering context </td> </tr> <tr> <td class="h" > <a name="5456">5456</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5457">5457</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5458">5458</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5459">5459</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success or a negative error code on failure; call L<< </td> </tr> <tr> <td class="h" > <a name="5460">5460</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="5461">5461</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5462">5462</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5463">5463</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_BindTexture( ... )> </td> </tr> <tr> <td class="h" > <a name="5464">5464</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5465">5465</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Bind an OpenGL/ES/ES2 texture to the current context. </td> </tr> <tr> <td class="h" > <a name="5466">5466</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5467">5467</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my ($texw, $texh) = SDL_GL_BindTexture( $texture ); </td> </tr> <tr> <td class="h" > <a name="5468">5468</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5469">5469</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This is for use with OpenGL instructions when rendering OpenGL primitives </td> </tr> <tr> <td class="h" > <a name="5470">5470</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> directly. </td> </tr> <tr> <td class="h" > <a name="5471">5471</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5472">5472</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If not NULL, the returned width and height values suitable for the provided </td> </tr> <tr> <td class="h" > <a name="5473">5473</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> texture. In most cases, both will be C<1.0>, however, on systems that support </td> </tr> <tr> <td class="h" > <a name="5474">5474</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the GL_ARB_texture_rectangle extension, these values will actually be the pixel </td> </tr> <tr> <td class="h" > <a name="5475">5475</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> width and height used to create the texture, so this factor needs to be taken </td> </tr> <tr> <td class="h" > <a name="5476">5476</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> into account when providing texture coordinates to OpenGL. </td> </tr> <tr> <td class="h" > <a name="5477">5477</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5478">5478</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> You need a renderer to create an L<SDL2::Texture>, therefore you can only use </td> </tr> <tr> <td class="h" > <a name="5479">5479</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> this function with an implicit OpenGL context from L<< C<SDL_CreateRenderer( </td> </tr> <tr> <td class="h" > <a name="5480">5480</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ... )>\|/C<SDL_CreateRenderer( ... )> >>, not with your own OpenGL context. If </td> </tr> <tr> <td class="h" > <a name="5481">5481</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> you need control over your OpenGL context, you need to write your own </td> </tr> <tr> <td class="h" > <a name="5482">5482</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> texture-loading methods. </td> </tr> <tr> <td class="h" > <a name="5483">5483</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5484">5484</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Also note that SDL may upload RGB textures as BGR (or vice-versa), and re-order </td> </tr> <tr> <td class="h" > <a name="5485">5485</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the color channels in the shaders phase, so the uploaded texture may have </td> </tr> <tr> <td class="h" > <a name="5486">5486</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> swapped color channels. </td> </tr> <tr> <td class="h" > <a name="5487">5487</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5488">5488</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5489">5489</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5490">5490</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5491">5491</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5492">5492</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to bind to the current OpenGL/ES/ES2 context </td> </tr> <tr> <td class="h" > <a name="5493">5493</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5494">5494</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5495">5495</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5496">5496</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the texture's with and height on success, or -1 if the operation is not </td> </tr> <tr> <td class="h" > <a name="5497">5497</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> supported; call L<< C<SDL_GetError( )>\|/C<SDL_GetError( )> >>( ) for more </td> </tr> <tr> <td class="h" > <a name="5498">5498</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> information. </td> </tr> <tr> <td class="h" > <a name="5499">5499</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5500">5500</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GL_UnbindTexture( ... )> </td> </tr> <tr> <td class="h" > <a name="5501">5501</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5502">5502</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Unbind an OpenGL/ES/ES2 texture from the current context. </td> </tr> <tr> <td class="h" > <a name="5503">5503</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5504">5504</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_GL_UnbindTexture( $texture ); </td> </tr> <tr> <td class="h" > <a name="5505">5505</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5506">5506</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> See L<< C<SDL_GL_BindTexture( ... )>\|/C<SDL_GL_BindTexture( ... )> >> for </td> </tr> <tr> <td class="h" > <a name="5507">5507</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> examples on how to use these functions. </td> </tr> <tr> <td class="h" > <a name="5508">5508</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5509">5509</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5510">5510</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5511">5511</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5512">5512</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5513">5513</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<texture> - the texture to unbind from the current OpenGL/ES/ES2 context </td> </tr> <tr> <td class="h" > <a name="5514">5514</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5515">5515</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5516">5516</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5517">5517</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success, or C<-1> if the operation is not supported. </td> </tr> <tr> <td class="h" > <a name="5518">5518</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5519">5519</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderGetMetalLayer( ... )> </td> </tr> <tr> <td class="h" > <a name="5520">5520</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5521">5521</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the CAMetalLayer associated with the given Metal renderer. </td> </tr> <tr> <td class="h" > <a name="5522">5522</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5523">5523</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $opaque = SDL_RenderGetMetalLayer( $renderer ); </td> </tr> <tr> <td class="h" > <a name="5524">5524</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5525">5525</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function returns C<void >, so SDL doesn't have to include Metal's </td> </tr> <tr> <td class="h" > <a name="5526">5526</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> headers, but it can be safely cast to a C<CAMetalLayer >. </td> </tr> <tr> <td class="h" > <a name="5527">5527</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5528">5528</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5529">5529</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5530">5530</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5531">5531</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5532">5532</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the renderer to query </td> </tr> <tr> <td class="h" > <a name="5533">5533</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5534">5534</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5535">5535</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5536">5536</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<CAMetalLayer> on success, or undef if the renderer isn't a Metal </td> </tr> <tr> <td class="h" > <a name="5537">5537</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> renderer. </td> </tr> <tr> <td class="h" > <a name="5538">5538</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5539">5539</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RenderGetMetalCommandEncoder( ... )> </td> </tr> <tr> <td class="h" > <a name="5540">5540</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5541">5541</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the Metal command encoder for the current frame </td> </tr> <tr> <td class="h" > <a name="5542">5542</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5543">5543</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> $opaque = SDL_RenderGetMetalCommandEncoder( $renderer ); </td> </tr> <tr> <td class="h" > <a name="5544">5544</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5545">5545</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function returns C<void >, so SDL doesn't have to include Metal's </td> </tr> <tr> <td class="h" > <a name="5546">5546</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> headers, but it can be safely cast to an </td> </tr> <tr> <td class="h" > <a name="5547">5547</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<idE<lt>MTLRenderCommandEncoderE<gt>>. </td> </tr> <tr> <td class="h" > <a name="5548">5548</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5549">5549</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5550">5550</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5551">5551</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5552">5552</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5553">5553</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<renderer> - the renderer to query </td> </tr> <tr> <td class="h" > <a name="5554">5554</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5555">5555</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5556">5556</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5557">5557</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<idE<lt>MTLRenderCommandEncoderE<gt>> on success, or undef if the </td> </tr> <tr> <td class="h" > <a name="5558">5558</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> renderer isn't a Metal renderer. </td> </tr> <tr> <td class="h" > <a name="5559">5559</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5560">5560</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5561">5561</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5562">5562</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5563">5563</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5564">5564</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5565">5565</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5566">5566</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5567">5567</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5568">5568</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5569">5569</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5570">5570</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5571">5571</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5572">5572</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5573">5573</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5574">5574</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5575">5575</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5576">5576</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5577">5577</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5578">5578</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5579">5579</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5580">5580</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5581">5581</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5582">5582</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5583">5583</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5584">5584</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5585">5585</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5586">5586</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5587">5587</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5588">5588</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5589">5589</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5590">5590</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5591">5591</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5592">5592</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5593">5593</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5594">5594</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5595">5595</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5596">5596</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5597">5597</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5598">5598</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5599">5599</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5600">5600</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5601">5601</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5602">5602</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5603">5603</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5604">5604</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5605">5605</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5606">5606</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5607">5607</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5608">5608</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5609">5609</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5610">5610</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5611">5611</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5612">5612</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_ComposeCustomBlendMode( ... )> </td> </tr> <tr> <td class="h" > <a name="5613">5613</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5614">5614</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Compose a custom blend mode for renderers. </td> </tr> <tr> <td class="h" > <a name="5615">5615</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5616">5616</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5617">5617</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5618">5618</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The functions SDL_SetRenderDrawBlendMode and SDL_SetTextureBlendMode accept the </td> </tr> <tr> <td class="h" > <a name="5619">5619</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_BlendMode returned by this function if the renderer supports it. </td> </tr> <tr> <td class="h" > <a name="5620">5620</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5621">5621</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> A blend mode controls how the pixels from a drawing operation (source) get </td> </tr> <tr> <td class="h" > <a name="5622">5622</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> combined with the pixels from the render target (destination). First, the </td> </tr> <tr> <td class="h" > <a name="5623">5623</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> components of the source and destination pixels get multiplied with their blend </td> </tr> <tr> <td class="h" > <a name="5624">5624</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> factors. Then, the blend operation takes the two products and calculates the </td> </tr> <tr> <td class="h" > <a name="5625">5625</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> result that will get stored in the render target. </td> </tr> <tr> <td class="h" > <a name="5626">5626</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5627">5627</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expressed in pseudocode, it would look like this: </td> </tr> <tr> <td class="h" > <a name="5628">5628</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5629">5629</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $dstRGB = colorOperation( $srcRGB * $srcColorFactor, $dstRGB * $dstColorFactor ); </td> </tr> <tr> <td class="h" > <a name="5630">5630</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $dstA = alphaOperation( $srcA * $srcAlphaFactor, $dstA * $dstAlphaFactor ); </td> </tr> <tr> <td class="h" > <a name="5631">5631</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5632">5632</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Where the functions C<colorOperation(src, dst)> and C<alphaOperation(src, dst)> </td> </tr> <tr> <td class="h" > <a name="5633">5633</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> can return one of the following: </td> </tr> <tr> <td class="h" > <a name="5634">5634</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5635">5635</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5636">5636</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5637">5637</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<src + dst> </td> </tr> <tr> <td class="h" > <a name="5638">5638</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5639">5639</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<src - dst> </td> </tr> <tr> <td class="h" > <a name="5640">5640</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5641">5641</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<dst - src> </td> </tr> <tr> <td class="h" > <a name="5642">5642</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5643">5643</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<min(src, dst)> </td> </tr> <tr> <td class="h" > <a name="5644">5644</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5645">5645</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<max(src, dst)> </td> </tr> <tr> <td class="h" > <a name="5646">5646</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5647">5647</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5648">5648</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5649">5649</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The red, green, and blue components are always multiplied with the first, </td> </tr> <tr> <td class="h" > <a name="5650">5650</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> second, and third components of the SDL_BlendFactor, respectively. The fourth </td> </tr> <tr> <td class="h" > <a name="5651">5651</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> component is not used. </td> </tr> <tr> <td class="h" > <a name="5652">5652</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5653">5653</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The alpha component is always multiplied with the fourth component of the L<< </td> </tr> <tr> <td class="h" > <a name="5654">5654</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<:blendFactor>\|/C<:blendFactor> >>. The other components are not used in the </td> </tr> <tr> <td class="h" > <a name="5655">5655</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> alpha calculation. </td> </tr> <tr> <td class="h" > <a name="5656">5656</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5657">5657</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Support for these blend modes varies for each renderer. To check if a specific </td> </tr> <tr> <td class="h" > <a name="5658">5658</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> L<< C<:blendMode>\|/C<:blendMode> >> is supported, create a renderer and pass it </td> </tr> <tr> <td class="h" > <a name="5659">5659</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> to either C<SDL_SetRenderDrawBlendMode> or C<SDL_SetTextureBlendMode>. They </td> </tr> <tr> <td class="h" > <a name="5660">5660</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> will return with an error if the blend mode is not supported. </td> </tr> <tr> <td class="h" > <a name="5661">5661</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5662">5662</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This list describes the support of custom blend modes for each renderer in SDL </td> </tr> <tr> <td class="h" > <a name="5663">5663</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> 2.0.6. All renderers support the four blend modes listed in the L<< </td> </tr> <tr> <td class="h" > <a name="5664">5664</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<:blendMode>\|/C<:blendMode> >> enumeration. </td> </tr> <tr> <td class="h" > <a name="5665">5665</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5666">5666</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5667">5667</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5668">5668</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item B<direct3d> - Supports C<SDL_BLENDOPERATION_ADD> with all factors. </td> </tr> <tr> <td class="h" > <a name="5669">5669</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5670">5670</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item B<direct3d11> - Supports all operations with all factors. However, some factors produce unexpected results with C<SDL_BLENDOPERATION_MINIMUM> and C<SDL_BLENDOPERATION_MAXIMUM>. </td> </tr> <tr> <td class="h" > <a name="5671">5671</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5672">5672</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item B<opengl> - Supports the C<SDL_BLENDOPERATION_ADD> operation with all factors. OpenGL versions 1.1, 1.2, and 1.3 do not work correctly with SDL 2.0.6. </td> </tr> <tr> <td class="h" > <a name="5673">5673</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5674">5674</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item B<opengles> - Supports the C<SDL_BLENDOPERATION_ADD> operation with all factors. Color and alpha factors need to be the same. OpenGL ES 1 implementation specific: May also support C<SDL_BLENDOPERATION_SUBTRACT> and C<SDL_BLENDOPERATION_REV_SUBTRACT>. May support color and alpha operations being different from each other. May support color and alpha factors being different from each other. </td> </tr> <tr> <td class="h" > <a name="5675">5675</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5676">5676</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item B<opengles2> - Supports the C<SDL_BLENDOPERATION_ADD>, C<SDL_BLENDOPERATION_SUBTRACT>, C<SDL_BLENDOPERATION_REV_SUBTRACT> operations with all factors. </td> </tr> <tr> <td class="h" > <a name="5677">5677</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5678">5678</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item B<psp> - No custom blend mode support. </td> </tr> <tr> <td class="h" > <a name="5679">5679</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5680">5680</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item B<software> - No custom blend mode support. </td> </tr> <tr> <td class="h" > <a name="5681">5681</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5682">5682</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5683">5683</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5684">5684</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Some renderers do not provide an alpha component for the default render target. </td> </tr> <tr> <td class="h" > <a name="5685">5685</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The C<SDL_BLENDFACTOR_DST_ALPHA> and C<SDL_BLENDFACTOR_ONE_MINUS_DST_ALPHA> </td> </tr> <tr> <td class="h" > <a name="5686">5686</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> factors do not have an effect in this case. </td> </tr> <tr> <td class="h" > <a name="5687">5687</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5688">5688</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5689">5689</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5690">5690</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5691">5691</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5692">5692</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<srcColorFactor> -the C<:blendFactor> applied to the red, green, and blue components of the source pixels </td> </tr> <tr> <td class="h" > <a name="5693">5693</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5694">5694</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<dstColorFactor> - the C<:blendFactor> applied to the red, green, and blue components of the destination pixels </td> </tr> <tr> <td class="h" > <a name="5695">5695</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5696">5696</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<colorOperation> - the C<:blendOperation> used to combine the red, green, and blue components of the source and destination pixels </td> </tr> <tr> <td class="h" > <a name="5697">5697</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5698">5698</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<srcAlphaFactor> - the C<:blendFactor> applied to the alpha component of the source pixels </td> </tr> <tr> <td class="h" > <a name="5699">5699</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5700">5700</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<dstAlphaFactor> - the C<:blendFactor> applied to the alpha component of the destination pixels </td> </tr> <tr> <td class="h" > <a name="5701">5701</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5702">5702</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<alphaOperation> - the C<:blendOperation> used to combine the alpha component of the source and destination pixels </td> </tr> <tr> <td class="h" > <a name="5703">5703</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5704">5704</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5705">5705</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5706">5706</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns a C<:blendMode> that represents the chosen factors and operations. </td> </tr> <tr> <td class="h" > <a name="5707">5707</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5708">5708</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head1 Time Management Routines </td> </tr> <tr> <td class="h" > <a name="5709">5709</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5710">5710</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This section contains functions for handling the SDL time management routines. </td> </tr> <tr> <td class="h" > <a name="5711">5711</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> They may be imported with the C<:timer> tag. </td> </tr> <tr> <td class="h" > <a name="5712">5712</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5713">5713</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetTicks( )> </td> </tr> <tr> <td class="h" > <a name="5714">5714</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5715">5715</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the number of milliseconds since SDL library initialization. </td> </tr> <tr> <td class="h" > <a name="5716">5716</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5717">5717</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $time = SDL_GetTicks( ); </td> </tr> <tr> <td class="h" > <a name="5718">5718</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5719">5719</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This value wraps if the program runs for more than C<~49> days. </td> </tr> <tr> <td class="h" > <a name="5720">5720</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5721">5721</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns an unsigned 32-bit value representing the number of milliseconds since </td> </tr> <tr> <td class="h" > <a name="5722">5722</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the SDL library initialized. </td> </tr> <tr> <td class="h" > <a name="5723">5723</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5724">5724</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetPerformanceCounter( )> </td> </tr> <tr> <td class="h" > <a name="5725">5725</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5726">5726</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the current value of the high resolution counter. </td> </tr> <tr> <td class="h" > <a name="5727">5727</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5728">5728</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $high_timer = SDL_GetPerformanceCounter( ); </td> </tr> <tr> <td class="h" > <a name="5729">5729</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5730">5730</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function is typically used for profiling. </td> </tr> <tr> <td class="h" > <a name="5731">5731</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5732">5732</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The counter values are only meaningful relative to each other. Differences </td> </tr> <tr> <td class="h" > <a name="5733">5733</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> between values can be converted to times by using L<< </td> </tr> <tr> <td class="h" > <a name="5734">5734</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetPerformanceFrequency( )>\|/C<SDL_GetPerformanceFrequency( )> >>. </td> </tr> <tr> <td class="h" > <a name="5735">5735</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5736">5736</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the current counter value. </td> </tr> <tr> <td class="h" > <a name="5737">5737</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5738">5738</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetPerformanceFrequency( ... )> </td> </tr> <tr> <td class="h" > <a name="5739">5739</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5740">5740</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the count per second of the high resolution counter. </td> </tr> <tr> <td class="h" > <a name="5741">5741</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5742">5742</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $hz = SDL_GetPerformanceFrequency( ); </td> </tr> <tr> <td class="h" > <a name="5743">5743</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5744">5744</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns a platform-specific count per second. </td> </tr> <tr> <td class="h" > <a name="5745">5745</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5746">5746</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_Delay( ... )> </td> </tr> <tr> <td class="h" > <a name="5747">5747</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5748">5748</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Wait a specified number of milliseconds before returning. </td> </tr> <tr> <td class="h" > <a name="5749">5749</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5750">5750</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_Delay( 1000 ); </td> </tr> <tr> <td class="h" > <a name="5751">5751</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5752">5752</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function waits a specified number of milliseconds before returning. It </td> </tr> <tr> <td class="h" > <a name="5753">5753</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> waits at least the specified time, but possibly longer due to OS scheduling. </td> </tr> <tr> <td class="h" > <a name="5754">5754</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5755">5755</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5756">5756</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5757">5757</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5758">5758</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5759">5759</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<ms> - the number of milliseconds to delay </td> </tr> <tr> <td class="h" > <a name="5760">5760</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5761">5761</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5762">5762</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5763">5763</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_AddTimer( ... )> </td> </tr> <tr> <td class="h" > <a name="5764">5764</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5765">5765</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Call a callback function at a future time. </td> </tr> <tr> <td class="h" > <a name="5766">5766</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5767">5767</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $id = SDL_AddTimer( 1000, sub ( $interval, $data ) { warn 'ping!'; $interval; } ); </td> </tr> <tr> <td class="h" > <a name="5768">5768</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5769">5769</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> If you use this function, you must pass C<SDL_INIT_TIMER> to L<< C<SDL_Init( </td> </tr> <tr> <td class="h" > <a name="5770">5770</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ... )>\|/C<SDL_Init( ... )> >>. </td> </tr> <tr> <td class="h" > <a name="5771">5771</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5772">5772</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The callback function is passed the current timer interval and returns the next </td> </tr> <tr> <td class="h" > <a name="5773">5773</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> timer interval. If the returned value is the same as the one passed in, the </td> </tr> <tr> <td class="h" > <a name="5774">5774</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> periodic alarm continues, otherwise a new alarm is scheduled. If the callback </td> </tr> <tr> <td class="h" > <a name="5775">5775</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> returns C<0>, the periodic alarm is cancelled. </td> </tr> <tr> <td class="h" > <a name="5776">5776</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5777">5777</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The callback is run on a separate thread. </td> </tr> <tr> <td class="h" > <a name="5778">5778</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5779">5779</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Timers take into account the amount of time it took to execute the callback. </td> </tr> <tr> <td class="h" > <a name="5780">5780</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> For example, if the callback took 250 ms to execute and returned 1000 (ms), the </td> </tr> <tr> <td class="h" > <a name="5781">5781</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> timer would only wait another 750 ms before its next iteration. </td> </tr> <tr> <td class="h" > <a name="5782">5782</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5783">5783</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Timing may be inexact due to OS scheduling. Be sure to note the current time </td> </tr> <tr> <td class="h" > <a name="5784">5784</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> with L<< C<SDL_GetTicks( )>\|/C<SDL_GetTicks( )> >> or L<< </td> </tr> <tr> <td class="h" > <a name="5785">5785</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_GetPerformanceCounter( )>\|/C<SDL_GetPerformanceCounter( )> >> in case </td> </tr> <tr> <td class="h" > <a name="5786">5786</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> your callback needs to adjust for variances. </td> </tr> <tr> <td class="h" > <a name="5787">5787</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5788">5788</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5789">5789</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5790">5790</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5791">5791</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5792">5792</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<interval> - the timer delay, in milliseconds, passed to C<callback> </td> </tr> <tr> <td class="h" > <a name="5793">5793</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5794">5794</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<callback> - the C<CODE> reference to call when the specified C<interval> elapses </td> </tr> <tr> <td class="h" > <a name="5795">5795</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5796">5796</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<param> - a pointer that is passed to C<callback> </td> </tr> <tr> <td class="h" > <a name="5797">5797</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5798">5798</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5799">5799</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5800">5800</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns a timer ID or C<0> if an error occurs; call L<< C<SDL_GetError( </td> </tr> <tr> <td class="h" > <a name="5801">5801</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_GetError( )> >>( ) for more information. </td> </tr> <tr> <td class="h" > <a name="5802">5802</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5803">5803</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_RemoveTimer( ... )> </td> </tr> <tr> <td class="h" > <a name="5804">5804</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5805">5805</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_RemoveTimer( $id ); </td> </tr> <tr> <td class="h" > <a name="5806">5806</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5807">5807</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Remove a timer created with L<< C<SDL_AddTimer( ... )>\|/C<SDL_AddTimer( ... )> </td> </tr> <tr> <td class="h" > <a name="5808">5808</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> >>. </td> </tr> <tr> <td class="h" > <a name="5809">5809</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5810">5810</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5811">5811</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5812">5812</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5813">5813</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5814">5814</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<id> - the ID of the timer to remove </td> </tr> <tr> <td class="h" > <a name="5815">5815</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5816">5816</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5817">5817</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5818">5818</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns true if the timer is removed or false if the timer wasn't found. </td> </tr> <tr> <td class="h" > <a name="5819">5819</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5820">5820</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head1 Raw Audio Mixing </td> </tr> <tr> <td class="h" > <a name="5821">5821</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5822">5822</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> These methods provide access to the raw audio mixing buffer for the SDL </td> </tr> <tr> <td class="h" > <a name="5823">5823</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> library. They may be imported with the C<:audio> tag. </td> </tr> <tr> <td class="h" > <a name="5824">5824</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5825">5825</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetNumAudioDrivers( )> </td> </tr> <tr> <td class="h" > <a name="5826">5826</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5827">5827</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns a list of built in audio drivers, in the order that they were normally </td> </tr> <tr> <td class="h" > <a name="5828">5828</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> initialized by default. </td> </tr> <tr> <td class="h" > <a name="5829">5829</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5830">5830</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetAudioDriver( ... )> </td> </tr> <tr> <td class="h" > <a name="5831">5831</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5832">5832</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns an audio driver by name. </td> </tr> <tr> <td class="h" > <a name="5833">5833</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5834">5834</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $driver = SDL_GetAudioDriver( 1 ); </td> </tr> <tr> <td class="h" > <a name="5835">5835</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5836">5836</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Expected parameters include: </td> </tr> <tr> <td class="h" > <a name="5837">5837</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5838">5838</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5839">5839</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5840">5840</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item C<index> - The zero-based index of the desired audio driver </td> </tr> <tr> <td class="h" > <a name="5841">5841</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5842">5842</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5843">5843</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5844">5844</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_AudioInit( ... )> </td> </tr> <tr> <td class="h" > <a name="5845">5845</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5846">5846</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Audio system initialization. </td> </tr> <tr> <td class="h" > <a name="5847">5847</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5848">5848</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_AudioInit( 'pulseaudio' ); </td> </tr> <tr> <td class="h" > <a name="5849">5849</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5850">5850</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This method is used internally, and should not be used unless you have a </td> </tr> <tr> <td class="h" > <a name="5851">5851</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> specific need to specify the audio driver you want to use. You should normally </td> </tr> <tr> <td class="h" > <a name="5852">5852</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> use L<< C<SDL_Init( ... )>\|/C<SDL_Init( ... )> >>. </td> </tr> <tr> <td class="h" > <a name="5853">5853</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5854">5854</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns C<0> on success. </td> </tr> <tr> <td class="h" > <a name="5855">5855</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5856">5856</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_AudioQuit( )> </td> </tr> <tr> <td class="h" > <a name="5857">5857</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5858">5858</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Cleaning up initialized audio system. </td> </tr> <tr> <td class="h" > <a name="5859">5859</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5860">5860</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_AudioQuit( ); </td> </tr> <tr> <td class="h" > <a name="5861">5861</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5862">5862</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This method is used internally, and should not be used unless you have a </td> </tr> <tr> <td class="h" > <a name="5863">5863</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> specific need to close the selected audio driver. You should normally use L<< </td> </tr> <tr> <td class="h" > <a name="5864">5864</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> C<SDL_Quit( )>\|/C<SDL_Quit( )> >>. </td> </tr> <tr> <td class="h" > <a name="5865">5865</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5866">5866</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_GetCurrentAudioDriver( )> </td> </tr> <tr> <td class="h" > <a name="5867">5867</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5868">5868</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Get the name of the current audio driver. </td> </tr> <tr> <td class="h" > <a name="5869">5869</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5870">5870</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $driver = SDL_GetCurrentAudioDriver( ); </td> </tr> <tr> <td class="h" > <a name="5871">5871</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5872">5872</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> The returned string points to internal static memory and thus never becomes </td> </tr> <tr> <td class="h" > <a name="5873">5873</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> invalid, even if you quit the audio subsystem and initialize a new driver </td> </tr> <tr> <td class="h" > <a name="5874">5874</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> (although such a case would return a different static string from another call </td> </tr> <tr> <td class="h" > <a name="5875">5875</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> to this function, of course). As such, you should not modify or free the </td> </tr> <tr> <td class="h" > <a name="5876">5876</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> returned string. </td> </tr> <tr> <td class="h" > <a name="5877">5877</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5878">5878</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Returns the name of the current audio driver or undef if no driver has been </td> </tr> <tr> <td class="h" > <a name="5879">5879</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> initialized. </td> </tr> <tr> <td class="h" > <a name="5880">5880</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5881">5881</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head2 C<SDL_OpenAudio( ... )> </td> </tr> <tr> <td class="h" > <a name="5882">5882</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5883">5883</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function is a legacy means of opening the audio device. </td> </tr> <tr> <td class="h" > <a name="5884">5884</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5885">5885</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> my $obtained = SDL_OpenAudio( </td> </tr> <tr> <td class="h" > <a name="5886">5886</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL2::AudioSpec->new( { freq => 48000, channels => 2, format => AUDIO_F32 } ) ); </td> </tr> <tr> <td class="h" > <a name="5887">5887</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5888">5888</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function remains for compatibility with SDL 1.2, but also because it's </td> </tr> <tr> <td class="h" > <a name="5889">5889</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> slightly easier to use than the new functions in SDL 2.0. The new, more </td> </tr> <tr> <td class="h" > <a name="5890">5890</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> powerful, and preferred way to do this is L<< C<SDL_OpenAudioDevice( ... </td> </tr> <tr> <td class="h" > <a name="5891">5891</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> )>\|/C<SDL_OpenAudioDevice( ... )> >> . </td> </tr> <tr> <td class="h" > <a name="5892">5892</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5893">5893</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This function is roughly equivalent to: </td> </tr> <tr> <td class="h" > <a name="5894">5894</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5895">5895</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> SDL_OpenAudioDevice( (), 0, $desired, SDL_AUDIO_ALLOW_ANY_CHANGE ); </td> </tr> <tr> <td class="h" > <a name="5896">5896</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5897">5897</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> With two notable exceptions: </td> </tr> <tr> <td class="h" > <a name="5898">5898</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5899">5899</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =over </td> </tr> <tr> <td class="h" > <a name="5900">5900</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5901">5901</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item - If C<obtained> is undefined, we use C<desired> (and allow no changes), which </td> </tr> <tr> <td class="h" > <a name="5902">5902</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> means desired will be modified to have the correct values for silence, </td> </tr> <tr> <td class="h" > <a name="5903">5903</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> etc, and SDL will convert any differences between your app's specific </td> </tr> <tr> <td class="h" > <a name="5904">5904</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> request and the hardware behind the scenes. </td> </tr> <tr> <td class="h" > <a name="5905">5905</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5906">5906</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =item - The return value is always success or failure, and not a device ID, which </td> </tr> <tr> <td class="h" > <a name="5907">5907</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> means you can only have one device open at a time with this function. </td> </tr> <tr> <td class="h" > <a name="5908">5908</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5909">5909</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="5910">5910</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5911">5911</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * \param desired an SDL_AudioSpec structure representing the desired output </td> </tr> <tr> <td class="h" > <a name="5912">5912</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * format. Please refer to the SDL_OpenAudioDevice documentation </td> </tr> <tr> <td class="h" > <a name="5913">5913</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * for details on how to prepare this structure. </td> </tr> <tr> <td class="h" > <a name="5914">5914</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * \param obtained an SDL_AudioSpec structure filled in with the actual </td> </tr> <tr> <td class="h" > <a name="5915">5915</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * parameters, or NULL. </td> </tr> <tr> <td class="h" > <a name="5916">5916</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * \returns This function opens the audio device with the desired parameters, </td> </tr> <tr> <td class="h" > <a name="5917">5917</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * and returns 0 if successful, placing the actual hardware </td> </tr> <tr> <td class="h" > <a name="5918">5918</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * parameters in the structure pointed to by `obtained`. </td> </tr> <tr> <td class="h" > <a name="5919">5919</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * </td> </tr> <tr> <td class="h" > <a name="5920">5920</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * If `obtained` is NULL, the audio data passed to the callback </td> </tr> <tr> <td class="h" > <a name="5921">5921</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * function will be guaranteed to be in the requested format, and </td> </tr> <tr> <td class="h" > <a name="5922">5922</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * will be automatically converted to the actual hardware audio </td> </tr> <tr> <td class="h" > <a name="5923">5923</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * format if necessary. If `obtained` is NULL, `desired` will </td> </tr> <tr> <td class="h" > <a name="5924">5924</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * have fields modified. </td> </tr> <tr> <td class="h" > <a name="5925">5925</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * </td> </tr> <tr> <td class="h" > <a name="5926">5926</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * This function returns a negative error code on failure to open the </td> </tr> <tr> <td class="h" > <a name="5927">5927</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * audio device or failure to set up the audio thread; call </td> </tr> <tr> <td class="h" > <a name="5928">5928</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> * SDL_GetError() for more information. </td> </tr> <tr> <td class="h" > <a name="5929">5929</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5930">5930</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5931">5931</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5932">5932</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head1 LICENSE </td> </tr> <tr> <td class="h" > <a name="5933">5933</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5934">5934</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Copyright (C) Sanko Robinson. </td> </tr> <tr> <td class="h" > <a name="5935">5935</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5936">5936</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> This library is free software; you can redistribute it and/or modify it under </td> </tr> <tr> <td class="h" > <a name="5937">5937</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> the terms found in the Artistic License 2. Other copyrights, terms, and </td> </tr> <tr> <td class="h" > <a name="5938">5938</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> conditions may apply to data transmitted through this module. </td> </tr> <tr> <td class="h" > <a name="5939">5939</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5940">5940</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =head1 AUTHOR </td> </tr> <tr> <td class="h" > <a name="5941">5941</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5942">5942</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> Sanko Robinson E<lt>sanko@cpan.orgE<gt> </td> </tr> <tr> <td class="h" > <a name="5943">5943</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5944">5944</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =begin stopwords </td> </tr> <tr> <td class="h" > <a name="5945">5945</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5946">5946</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> libSDL enum iOS iPhone tvOS gamepad gamepads bitmap colorkey asyncify keycode </td> </tr> <tr> <td class="h" > <a name="5947">5947</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> ctrl+click OpenGL glibc pthread screensaver fullscreen SDL_gamecontroller.h </td> </tr> <tr> <td class="h" > <a name="5948">5948</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> XBox XInput pthread pthreads realtime rtkit Keycode mutexes resources imple </td> </tr> <tr> <td class="h" > <a name="5949">5949</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> irectMedia ayer errstr coderef patchlevel distro WinRT raspberrypi psp macOS </td> </tr> <tr> <td class="h" > <a name="5950">5950</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> NSHighResolutionCapable lowlevel vsync gamecontroller framebuffer XRandR </td> </tr> <tr> <td class="h" > <a name="5951">5951</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> XVidMode libc musl non letterbox libsamplerate AVAudioSessionCategoryAmbient </td> </tr> <tr> <td class="h" > <a name="5952">5952</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> AVAudioSessionCategoryPlayback VoIP OpenGLES opengl opengles opengles2 spammy </td> </tr> <tr> <td class="h" > <a name="5953">5953</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> popup tooltip taskbar subwindow high-dpi subpixel borderless draggable viewport </td> </tr> <tr> <td class="h" > <a name="5954">5954</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> user-resizable resizable srcA srcC GiB dstrect rect subrectangle pseudocode ms </td> </tr> <tr> <td class="h" > <a name="5955">5955</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> verystrict resampler eglSwapBuffers backbuffer scancode unhandled lifespan wgl </td> </tr> <tr> <td class="h" > <a name="5956">5956</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> glX framerate deadzones vice-versa kmsdrm jp CAMetalLayer </td> </tr> <tr> <td class="h" > <a name="5957">5957</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5958">5958</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =end stopwords </td> </tr> <tr> <td class="h" > <a name="5959">5959</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5960">5960</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> =cut </td> </tr> <tr> <td class="h" > <a name="5961">5961</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> </td> </tr> <tr> <td class="h" > <a name="5962">5962</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> # Examples: </td> </tr> <tr> <td class="h" > <a name="5963">5963</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> # - https://github.com/crust/sdl2-examples </td> </tr> <tr> <td class="h" > <a name="5964">5964</a> </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td > </td> <td class="s"> # </td> </tr> </table> </body> </html>