rubysdl-mswin32-1.9 2.1.0.1 → 2.1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/doc/wm.rd DELETED
@@ -1,78 +0,0 @@
1
- = Window Management
2
- * ((<Window Management����>))
3
- * ((<Window Management��Ϣ�᥽�å�>))
4
- * ((<SDL::WM.caption>)) -- ������ɥ��Υ����ȥ�ȥ�������̾��������ޤ���
5
- * ((<SDL::WM.set_caption>)) -- ������ɥ��Υ����ȥ�ȥ�������̾�򥻥åȤ��ޤ���
6
- * ((<SDL::WM.icon=>)) -- ɽ��������ɥ��˥�������򥻥åȤ��ޤ���
7
- * ((<SDL::WM.iconify>)) -- ������ɥ��򥢥�����/�Ǿ������ޤ���
8
- * ((<SDL::WM.grab_input>)) -- �ޥ����ȥ����ܡ������Ϥ�Ĥ����Υ���ʤ��褦�ˤ��ޤ���
9
-
10
- == Window Management����
11
- SDL �ϥ�����ɥ������ε�ǽ�ΰ������󶡤��Ƥ��ꡢ
12
- ���ץꥱ������󤬼��ȤΥ����ȥ���ѹ������ꡢ
13
- �ե륹���꡼��⡼�ɤ����ݡ��Ȥ���Ƥ����
14
- ������ɥ��⡼�ɤȥե륹���꡼��⡼�ɤȤ��ڤ괹����
15
- ���Ȥ��Ǥ��ޤ���
16
-
17
- == Window Management��Ϣ�᥽�å�
18
-
19
- --- SDL::WM.caption
20
-
21
- ������ɥ��Υ����ȥ�ȥ�������̾��ʸ����2�Ĥ�������֤��ޤ���
22
-
23
- * See Also
24
-
25
- ((<SDL::WM.set_caption>))
26
-
27
- --- SDL::WM.set_caption(title, icon)
28
- --- SDL::WM.setCaption(title, icon)
29
-
30
- ɽ��������ɥ��Υ����ȥ�С��ȥ�������̾�򥻥åȤ��ޤ���
31
-
32
- * See Also
33
-
34
- ((<SDL::WM.caption>)), ((<SDL::WM.icon=>))
35
-
36
- --- SDL::WM.icon=(icon_image)
37
-
38
- ɽ��������ɥ��˥�������򥻥åȤ��ޤ���
39
- Win32 �Υ�������� 32��32 �Ǥʤ���Ф����ޤ���
40
-
41
- ���Υ⥸�塼��ؿ��ϡ�((<SDL.set_video_mode>)) ��
42
- ���ƸƤ����˸ƤФ�ʤ���Ф����ޤ���
43
- ((|icon|))�Ȥ��Ƥ� ((<SDL::Surface>)) �Υ��󥹥��󥹤�Ϳ���ޤ���
44
-
45
-
46
- EXAMPLE
47
- SDL::WM.icon = SDL::Surface.load_bmp("icon.bmp")
48
-
49
- * See Also
50
-
51
- ((<SDL.set_video_mode>)), ((<SDL::WM.caption>))
52
-
53
- --- SDL::WM.iconify
54
-
55
- ������ɥ����������Ķ��ǥ��ץꥱ������󤬼¹Ԥ���Ƥ����硢
56
- Ruby/SDL �ϥ��ץꥱ�������򥢥�����/�Ǿ������뤳�Ȥ��ߤޤ���
57
- �⤷��������С����ץꥱ�������� ((<SDL::Event::APPACTIVE>)) �򼺤ʤä�
58
- ���٥�Ȥ�������Ǥ��礦��
59
-
60
- ���Ԥ����Ȥ��ˤ��㳰((<SDL::Error>))��ȯ�������ޤ���
61
-
62
- --- SDL::WM.grab_input(mode)
63
- --- SDL::WM.grabInput(mode)
64
-
65
- �Ĥ���(Grabbing)�Ȥϡ��ޥ��������ץꥱ������󥦥���ɥ����Ĥ������졢
66
- �ۤ����ƤΥ����ܡ������Ϥ�ľ�ܥ��ץꥱ��������ž�����졢
67
- ������ɥ��ޥ͡�����ˤ��ᤵ��ʤ����Ȥ�ɽ���ޤ���
68
-
69
- ((|mode|)) �Ȥ��ưʲ��������Ϳ���뤳�Ȥ��Ǥ��ޤ���
70
- * SDL::WM::GRAB_QUERY
71
- * SDL::WM::GRAB_OFF
72
- * SDL::WM::GRAB_ON
73
-
74
- ((|mode|)) �� SDL::WM::GRAB_QUERY �ΤȤ��ϡ�
75
- grab �⡼�ɤ��ѹ�����ʤ��Ǹ��ߤ� grab �⡼�ɤ��֤���ޤ���
76
-
77
- ���ߤΡ����뤤�Ͽ������⡼�ɤ��֤��ޤ���
78
-
data/ext/sdl.so DELETED
Binary file
@@ -1,2181 +0,0 @@
1
- =begin
2
-
3
- = SDL
4
-
5
- Interface of this lib is very close to SDL.
6
- So you also had better refer to SDL document.
7
-
8
- nAll classes/modules in Ruby/SDL are in "module SDL".
9
- In this module number starts 0,not 1.
10
-
11
- == Class/Module
12
- * ((<Error handling>))
13
- * ((<SDL::Error>))
14
- * ((<initialize>))
15
- * ((<video>))
16
- * ((<SDL::Surface>))
17
- * ((<SDL::Screen>))
18
- * ((<SDL::CollisionMap>))
19
- * ((<SDL::PixelFormat>))
20
- * ((<Event handling>))
21
- * ((<SDL::Event>))
22
- * ((<SDL::Event2>))
23
- * ((<SDL::Key>)) (module)
24
- * ((<SDL::Mouse>)) (module)
25
- * ((<audio>))
26
- * ((<SDL::Mixer>)) (module)
27
- * ((<SDL::Mixer::Wave>))
28
- * ((<SDL::Mixer::Music>))
29
- * ((<Window Manager>))
30
- * ((<SDL::WM>)) (module)
31
- * ((<CDROM>))
32
- * ((<SDL::CD>))
33
- * ((<Joystick handling>))
34
- * ((<SDL::Joystick>))
35
- * ((<Font handling>))
36
- * ((<SDL::BMFont>))
37
- * ((<SDL::Kanji>))
38
- * ((<SDL::TTF>))
39
- * ((<MPEG stream>))
40
- * ((<SDL::MPEG>))
41
- * ((<Time>))
42
- * ((<Japanese input method with SDLSKK>))
43
- * ((<SDL::SKK::Context>))
44
- * ((<SDL::SKK::Dictionary>))
45
- * ((<SDL::SKK::RomKanaRuleTable>))
46
- * ((<SDL::SKK::Keybind>))
47
- * ((<3D drawing with OpenGL>))
48
- * ((<Others>))
49
-
50
- == Error handling
51
- === SDL::Error
52
-
53
- SDL::Error is exception class. Almost all of errors in Ruby/SDL are
54
- reported by this class.
55
-
56
- ==== super class
57
-
58
- StandardError
59
-
60
- == initialize
61
-
62
- === module functions in module SDL
63
-
64
- --- SDL.init(flag)
65
- Initialize SDL. This should be called before all other SDL functions. The
66
- flags parameter specifies what part(s) of SDL to initialize.
67
- SDL::INIT_AUDIO initialize audio output functions
68
- SDL::INIT_VIDEO initialize video output functions and input functions
69
- SDL::INIT_CDROM initialize CD playback fucntions
70
- SDL::INIT_JOYSTICK initialize joystick input functions
71
- You should call this method before calling other Ruby/SDL methods.
72
-
73
- --- SDL.quit
74
- Quit SDL system. You needn't call this function normally because
75
- this library call this function automatically when the process
76
- stops.
77
-
78
-
79
- --- SDL.initedSystem(flag)
80
- --- SDL.inited_system(flag)
81
- Not documented yet
82
-
83
- --- SDL.getenv
84
- --- SDL.putenv(envstr)
85
- Change or add an environment variable on Win32. On other platforms
86
- this method is equal to ENV.
87
-
88
- ((|envstr|)) should be of the form "name=value".
89
-
90
- Returns nil, raise exception `SDL::Error' when it fails.
91
-
92
- You should use this method to set SDL_WINDOWID or SDL_VIDEODRIVER.
93
- == video
94
-
95
- some functions need SGE or SDL_image
96
-
97
- === functions in module SDL
98
-
99
- --- SDL.getVideoSurface
100
- --- SDL.get_video_surface
101
- Not documented yet
102
-
103
- --- SDL.setVideoMode(w,h,bpp,flags)
104
- --- SDL.set_video_mode(w,h,bpp,flags)
105
- Set up a video mode with the specified width, height and bits-per-pixel.
106
- If bpp is 0, it is treated as the current display bits per pixel.
107
- Return the instanse of ((<SDL::Screen>)), if succeeded.
108
- Raise SDL::Error, if failed.
109
- * SDL::SWSURFACE
110
-
111
- Create the video surface in system memory.
112
-
113
- * SDL::HWSURFACE
114
-
115
- Create the video surface in video memory.
116
-
117
- * SDL::FULLSCREEN
118
-
119
- SDL will attempt to use a fullscreen mode.
120
-
121
- * SDL::SDL_DOUBLEBUF
122
-
123
- Enable double buffering.
124
- Calling ((<SDL::Screen#flip>)) will flip the buffers and update
125
- the screen.
126
-
127
- --- SDL.checkVideoMode(w,h,bpp,flags)
128
- --- SDL.check_video_mode(w,h,bpp,flags)
129
- Check to see if a particular video mode is supported.
130
- Returns 0 if the requested mode is not supported under any
131
- bit depth, or returns the bits-per-pixel of the closest available mode
132
- with the given width, height and requested surface flags (see
133
- SDL_SetVideoMode).
134
-
135
- The bits-per-pixel value returned is only a suggested mode. You can
136
- usually request and bpp you want when setting the video mode and SDL will
137
- emulate that color depth with a shadow video surface.
138
-
139
- The arguments to checkVideoMode are the same ones you would pass to
140
- ((<SDL.setVideoMode>)).
141
-
142
- --- SDL.listModes(flags)
143
- --- SDL.list_modes(flags)
144
- Returns availanel screen demensions for the given flags.
145
- Returns nil if there are no available dimensions.
146
- Returns true if any dimension is okay.
147
- Otherwise returns list of available dimensions in array.
148
-
149
- --- SDL.videoDriverName
150
- --- SDL.video_driver_name
151
- Returns the name of initialized video driver like "x11" or "windib".
152
- Raise exeption if video have not been initialized.
153
-
154
- --- SDL.setGamma(redgamma,greengamma,bluegamma)
155
- --- SDL.set_gamma(redgamma,greengamma,bluegamma)
156
- Sets the "gamma function" for the display of each color component.
157
- Gamma controls the brightness/contrast of colors displayed on
158
- the screen. A gamma value of 1.0 is identity
159
- (i.e., no adjustment is made).
160
-
161
- --- SDL.getGammaRamp
162
- --- SDL.get_gamma_ramp
163
- Returns the gamma translation lookup tables currently used
164
- by the display. Return value is array that has r, g, b table.
165
- Each table is array that has 256 integer.
166
-
167
- --- SDL.setGammaRamp(table)
168
- --- SDL.set_gamma_ramp(table)
169
- Sets the gamma lookup tables for the display for each color component.
170
- table should be an array like what you can get
171
- with ((<SDL.getGammaRamp>)).
172
-
173
- --- SDL.autoLock
174
- --- SDL.auto_lock
175
- --- SDL.autoLock?
176
- --- SDL.auto_lock?
177
- Needs SGE
178
-
179
- Returns whether Ruby/SDL locks surface automatically when
180
- need.Default is true.
181
-
182
- Please see ((<SDL::Surface#lock>)) to know more.
183
-
184
- --- SDL.autoLock=(autolocking)
185
- --- SDL.auto_lock=(autolocking)
186
- --- SDL.autoLockON
187
- --- SDL.auto_lock_on
188
- --- SDL.autoLockOFF
189
- --- SDL.auto_lock_off
190
- Needs SGE
191
-
192
- Set whether Ruby/SDL locks surface automatically when
193
- needed.
194
-
195
- --- SDL.videoInfo
196
- --- SDL.video_info
197
- Return video information in the object of VideoInfo .
198
- The contents are following.
199
- Values represent boolean value are true/false .
200
- Please read SDL document to know about this information.
201
- SDL::VideoInfo#hw_available
202
- SDL::VideoInfo#wm_available
203
- SDL::VideoInfo#blit_hw
204
- SDL::VideoInfo#blit_hw_CC
205
- SDL::VideoInfo#blit_hw_A
206
- SDL::VideoInfo#blit_sw
207
- SDL::VideoInfo#blit_sw_CC
208
- SDL::VideoInfo#blit_sw_A
209
- SDL::VideoInfo#blit_fill
210
- SDL::VideoInfo#video_mem
211
- SDL::VideoInfo#bpp
212
-
213
- --- SDL.blitSurface(src,srcX,srcY,srcW,srcH,dst,dstX,dstY)
214
- --- SDL.blit_surface(src,srcX,srcY,srcW,srcH,dst,dstX,dstY)
215
- This performs a fast blit from the source surface to the destination
216
- surface.
217
-
218
- If srcX=srcY=srcW=srcH=0,the entire surface is copied.
219
-
220
- The blit function should not be called on a locked surface.
221
-
222
- --- SDL.blitSurface2(src,srcRect,dst,dstRect)
223
- --- SDL.blit_surface2(src,src_rect,dst,dst_rect)
224
- You use this function like:
225
- blitSurface2(src,[0,32,32,32],dst,[100,200])
226
- or
227
- Rect = Struct.new( 'Rect', :x, :y, :w, :h )
228
-
229
- rect1 = Rect.new( 16, 0, 16, 16 )
230
- rect2 = Rect.new( 120, 0, 0, 0 )
231
- blitSurface2( src, rect1, dst, rect2 )
232
-
233
- --- SDL.rotateXYScaled(src,dst,x,y,angle,xscale,yscale)
234
- --- SDL.rotateXY_scaled(src,dst,x,y,angle,xscale,yscale)
235
- Needs SGE
236
-
237
- Note that this function is different from SGE sge_rotate_xyscaled API
238
- in that src and dst are changing.
239
- Following two functions are same.
240
- This is equal to blitSurface.
241
-
242
- And note that this function ignores colorkey.
243
-
244
- This method is obsolete. Please use ((<SDL.transform>)) or
245
- ((<SDL.transformBlit>))
246
-
247
- --- SDL.rotateScaled(src,dst,x,y,angle,scale)
248
- --- SDL.rotate_scaled(src,dst,x,y,angle,scale)
249
- Same as above, but with xscale=yscale.
250
-
251
- --- SDL.rotate(src,dst,x,y,angle)
252
- Same as above, but with xscale=yscale=1.0.
253
-
254
- --- SDL.rotateScaledBlit(src,dst,x,y,angle,scale)
255
- --- SDL.rotate_scaled_blit(src,dst,x,y,angle,scale)
256
- Needs SGE
257
-
258
- Same as rotateScaled,but respect colorkey.
259
-
260
- --- SDL.rotateBlit(src,dst,x,y,angle)
261
- --- SDL.rotate_blit(src,dst,x,y,angle)
262
- Same as rotateScaledBlit,but with scale=1.0;
263
-
264
- --- SDL.transform(src,dst,angle,xscale,yscale,px,py,qx,qy,flags)
265
- Need SGE
266
-
267
- Draw src surface to dst surface with scaling and rotation.
268
- Ignore colorkey.
269
-
270
- *src - The surface to be rotated and scaled
271
- *src - The surface to be rotated and scaled
272
- *angle - The rotation angle in degrees.
273
- *xscale yscale - The x and y scaling factor. Can be negative
274
- (mirroring). 1.0 is 1:1 scale.
275
- *px / py - The pivot point to rotate around in the src surface.
276
- *qx / qy - The destination point on dst surface.
277
- *flags
278
- *0 - Default.
279
- *SGE_TAA - Use the interpolating renderer. Much slower but
280
- can look better.
281
- *SGE_TSAFE - Don't asume that the src and dst surfaces has the
282
- same pixel format. This is the default when the two surfaces
283
- don't have the same BPP.
284
- This is slower but will render wierd pixel formats right.
285
- *SGE_TTMAP - Use texture mapping. This is a bit faster
286
- but the result isn't
287
- as nice as in the normal mode. This mode will also ignore the px/py
288
- coordinates and the other flags.
289
-
290
- --- SDL.transformBlit(src,dst,angle,xscale,yscale,px,py,qx,qy,flags)
291
- --- SDL.transform_blit(src,dst,angle,xscale,yscale,px,py,qx,qy,flags)
292
- Need SGE
293
-
294
- Blit src surface to dst surface with scaling and rotation.
295
- Same as ((<SDL.transform>)) , but respect colorkey.
296
-
297
- === SDL::Surface
298
-
299
- This class have image.
300
-
301
- ==== super class
302
-
303
- Object
304
-
305
- ==== class method
306
-
307
- --- SDL::Surface.new(flag,w,h,format)
308
- --- SDL::Surface.new(flags,w,h,depth,Rmask,Gmask,Bmask,Amask)
309
- Create an empty surface.
310
- You must call this method after ((<SDL.setVideoMode>))
311
-
312
- format must be the instance of ((<SDL::Surface>)), and create the
313
- surface that has same bpp as specified surface.
314
-
315
- The flags specifies the type of surface that should be
316
- created, it is an OR'd combination of the following possible values.
317
-
318
- * SDL::SWSURFACE
319
-
320
- SDL will create the surface in system memory.
321
-
322
- * SDL::HWSURFACE
323
-
324
- SDL will attempt to create the surface in video memory.
325
-
326
- * SDL::SRCCOLORKEY
327
-
328
- With this flag SDL will attempt to find the best
329
- location for this surface, either in system memory or
330
- video memory, to obtain hardware colorkey blitting
331
- support.
332
-
333
- * SDL::SRCALPHA
334
-
335
- With this flag SDL will attempt to find the best
336
- location for this surface, either in system memory or
337
- video memory, to obtain hardware alpha support.
338
-
339
- --- SDL::Surface.new_from(pixels,w,h,depth,pitch,Rmask,Gmask,Bmask,Amask)
340
- Create a surface from pixel data.
341
- ((|pixels|)) must be String. ((|pitch|)) is the length of
342
- each scanline in bytes.
343
-
344
- --- SDL::Surface.loadBMP(filename)
345
- --- SDL::Surface.load_bmp(filename)
346
- Loads a image from a named Windows BMP file and return
347
- the instance of ((<SDL::Screen>)).
348
-
349
- Raise SDL::Error if you have an error,for example file didn't exist.
350
-
351
- --- SDL::Surface.load(filename)
352
- Needs SDL_image
353
- Loads a image from a named Windows BMP file and return
354
- the instance of ((<SDL::Screen>)).
355
-
356
- Available formats are BMP,PPX,XPM,PCX,GIF,JPEG,PNG,TGA.
357
-
358
- ==== method
359
-
360
- --- SDL::Surface#saveBMP(filename)
361
- --- SDL::Surface#save_bmp(filename)
362
- Saves the surface as a Windows BMP file named file.
363
-
364
- --- SDL::Surface#displayFormat
365
- --- SDL::Surface#display_format
366
- This method copies self to a new surface of the pixel
367
- format and colors of the video framebuffer, suitable for fast blitting
368
- onto the display surface.
369
-
370
- If you want to take advantage of hardware colorkey or alpha blit
371
- acceleration, you should set the colorkey and alpha value before calling
372
- this method.
373
-
374
- --- SDL::Surface#displayFormatAlpha
375
- --- SDL::Surface#display_format_alpha
376
- Same as ((<SDL::Surface#displayFormat>)), except respecting
377
- alpha value per pixel.
378
-
379
- --- SDL::Surface#setColorKey(flag,key)
380
- --- SDL::Surface#set_color_key(flag,key)
381
- Sets the color key (transparent pixel) in a blittable surface and enables
382
- or disables RLE blit acceleration.
383
- If flag is SDL::SRCCOLORKEY then key is the transparent pixel
384
- value in the source image of a blit.
385
- If flag is OR'd with SDL::RLEACCEL then the surface will be draw
386
- using RLE acceleration when drawn with blitting.
387
-
388
- --- SDL::Surface#fillRect(x,y,w,h)
389
- --- SDL::Surface#fill_rect(x,y,w,h)
390
- This function performs a fast fill of the given rectangle with color.
391
-
392
- --- SDL::Surface#setClipRect(x,y,w,h)
393
- --- SDL::Surface#set_clip_rect(x,y,w,h)
394
- Sets the clipping rectangle for a surface. When this surface is the
395
- destination of a blit, only the area within the clip rectangle will
396
- be drawn into.
397
-
398
- The rectangle pointed to by rect will be clipped to the edges of the
399
- surface so that the clip rectangle for a surface can never fall
400
- outside the edges of the surface.
401
-
402
- --- SDL::Surface#getClipRect
403
- --- SDL::Surface#get_clip_rect
404
- Returns the clipping rectangle for this surface.
405
- Return value is an array including x, y, r, w value.
406
-
407
- --- SDL::Surface#setAlpha(flag,alpha)
408
- --- SDL::Surface#set_alpha(flag,alpha)
409
- SDL_SetAlpha is used for setting the per-surface alpha and/or enabling
410
- and disabling per-pixel alpha blending.
411
-
412
- flags is used to specify whether alpha blending should be used
413
- (SDL::SRCALPHA) and whether the surface should use RLE acceleration
414
- for blitting (SDL::RLEACCEL). flags can be an OR'd combination of these
415
- two options, one of these options or 0. If SDL_SRCALPHA is not passed
416
- as a flag then all alpha information is ignored when blitting
417
- the surface. The alpha parameter is the per-surface alpha value,
418
- a surface need not have an alpha channel to use
419
- per-surface alpha and blitting can still be accelerated with
420
- SDL_RLEACCEL. Setting the per-surface alpha value to 0 disables
421
- per-surface alpha blending.
422
-
423
- --- SDL::Surface#h
424
- Return height.
425
-
426
- --- SDL::Surface#w
427
- Return width.
428
-
429
- --- SDL::Surface#format
430
- Return pixel format.
431
- See ((<SDL::PixelFormat>)).
432
-
433
- --- SDL::Surface#put(image,x,y)
434
- Draw image on (x,y) in self.
435
- This method are implemented using blitSurface.
436
-
437
- --- SDL::Surface#copyRect(x,y,w,h)
438
- --- SDL::Surface#copy_rect(x,y,w,h)
439
- Copy given rect and return copyed surface.
440
-
441
- --- SDL::Surface#lock
442
- This method sets up a surface for directly accessing the pixels.You call
443
- this before calling ((<SDL::Surface#getPixel>)) ,
444
- ((<SDL::Surface#drawLine>)) or some other mehtods of Surface.
445
-
446
- Between calls to ((<SDL::Surface#lock>)) and ((<SDL::Surface#unlock>)),
447
- you can use methods that 'need locking'.
448
- Once you are done accessing the surface, you
449
- should use ((<SDL::Surface#unlock>)) to release it.
450
-
451
- Not all surfaces require locking. If ((<SDL::Surface#mustLock?>)) returns
452
- false, then you can read and write to the surface at any time, and the
453
- pixel format of the surface will not change.
454
-
455
- No operating system or library calls should be made between lock/unlock
456
- pairs, as critical system locks may be held during this time.
457
-
458
- If ((<SDL.autoLock>)) returns true,you don't have to call this methods
459
- because this library locks surface automatically.
460
-
461
- --- SDL::Surface#unlock
462
- Unlock the surface.
463
-
464
- --- SDL::Surface#mustLock?
465
- --- SDL::Surface#must_lock?
466
- Returns true if you must lock surface for directly accessing the pixels,
467
- otherwise returns false.
468
-
469
- --- SDL::Surface#getPixel(x,y)
470
- --- SDL::Surface#get_pixel(x,y)
471
- --- SDL::Surface#[](x,y)
472
- Needs SGE ,Needs lock
473
- Gets the color of the specified pixel.
474
- You can convert this color value to RGB with ((<SDL::Surface#getRGBA>)).
475
-
476
- --- SDL::Surface#putPixel(x,y,color)
477
- --- SDL::Surface#put_pixel(x,y,color)
478
- --- SDL::Surface#[]=(x,y,color)
479
- Needs SGE ,Needs lock
480
- Changes the color of the pixel on (x, y).
481
- You can specify color by [r, g, b], [r, g, b, a] array or integer
482
- given by ((<SDL::Surface#mapRGBA>)).
483
-
484
- --- SDL::Surface#drawLine(x1,y1,x2,y2,color)
485
- --- SDL::Surface#draw_line(x1,y1,x2,y2,color)
486
- Needs SGE ,Needs lock
487
- Draws a line from (x1,y1) to (x2,y2).
488
-
489
- --- SDL::Surface#drawRect(x,y,w,h,color)
490
- --- SDL::Surface#draw_rect(x,y,w,h,color)
491
- Needs SGE ,Needs lock
492
- Draws a rectangle.
493
-
494
- --- SDL::Surface#drawCircle(x,y,r,color)
495
- --- SDL::Surface#draw_circle(x,y,r,color)
496
- Needs SGE ,Needs lock
497
- Draws a circle.
498
-
499
- --- SDL::Surface#drawFilledCircle(x,y,r,color)
500
- --- SDL::Surface#draw_filled_circle(x,y,r,color)
501
- Needs SGE ,Needs lock
502
- Draws a filled circle.
503
-
504
- --- SDL::Surface#drawEllipse(x,y,rx,ry,color)
505
- --- SDL::Surface#draw_ellipse(x,y,rx,ry,color)
506
- Needs SGE, Needs lock
507
- Draws an ellipse.
508
-
509
- --- SDL::Surface#drawEllispe(x,y,rx,ry,color)
510
- See drawEllipse. This method exists for compatability but should not
511
- be used.
512
-
513
- --- SDL::Surface#drawFilledEllipse(x,y,rx,ry,color)
514
- --- SDL::Surface#draw_filled_ellipse(x,y,rx,ry,color)
515
- Needs SGE, Needs lock
516
- Draws a filled ellipse.
517
-
518
- --- SDL::Surface#drawFilledEllispe(x,y,rx,ry,color)
519
- See drawFilledEllipse. This method exists for compatability but
520
- should not be used.
521
-
522
- --- SDL::Surface#drawAALine(x1,y1,x2,y2,color)
523
- --- SDL::Surface#draw_aa_line(x1,y1,x2,y2,color)
524
- Needs SGE ,Needs lock
525
-
526
- Draws an antialiased line from (x1,y1) to (x2,y2).
527
-
528
- --- SDL::Surface#drawAACircle(x,y,r,color)
529
- --- SDL::Surface#draw_aa_circle(x,y,r,color)
530
- Needs SGE ,Needs lock
531
-
532
- Draws an antialiased circle.
533
-
534
- --- SDL::Surface#drawAAFilledCircle(x,y,r,color)
535
- --- SDL::Surface#draw_aa_filled_circle(x,y,r,color)
536
- Needs SGE ,Needs lock
537
-
538
- Draws a filled antialiased circle.
539
-
540
- --- SDL::Surface#drawAAEllipse(x,y,rx,ry,color)
541
- --- SDL::Surface#draw_aa_ellipse(x,y,rx,ry,color)
542
- Needs SGE ,Needs lock
543
-
544
- Draws an antialiased ellipse.
545
-
546
- --- SDL::Surface#drawLineAlpha(x1,y1,x2,y2,color,alpha)
547
- --- SDL::Surface#draw_line_alpha(x1,y1,x2,y2,color,alpha)
548
- Needs SGE ,Needs lock
549
-
550
- Draws a line with alpha blending.
551
-
552
- --- SDL::Surface#drawRectAlpha(x,y,w,h,color,alpha)
553
- --- SDL::Surface#draw_rect_alpha(x,y,w,h,color,alpha)
554
- Needs SGE ,Needs lock
555
-
556
- Draws a rectangle with alpha blending.
557
-
558
- --- SDL::Surface#drawFilledRectAlpha(x,y,w,h,color,alpha)
559
- --- SDL::Surface#draw_filled_rect_alpha(x,y,w,h,color,alpha)
560
- Needs SGE ,Needs lock
561
-
562
- x
563
-
564
- --- SDL::Surface#drawCircleAlpha(x,y,r,color,alpha)
565
- --- SDL::Surface#draw_circle_alpha(x,y,r,color,alpha)
566
- Needs SGE ,Needs lock
567
-
568
- Draws a circle with alpha blending.
569
-
570
- --- SDL::Surface#drawFilledCircleAlpha(x,y,r,color,alpha)
571
- --- SDL::Surface#draw_filled_circle_alpha(x,y,r,color,alpha)
572
- Needs SGE ,Needs lock
573
-
574
- Draws a filled circle with alpha blending.
575
-
576
- --- SDL::Surface#drawEllipseAlpha(x,y,rx,ry,color,alpha)
577
- --- SDL::Surface#draw_ellipse_alpha(x,y,rx,ry,color,alpha)
578
- Needs SGE ,Needs lock
579
-
580
- Draws an ellipse with alpha blending.
581
-
582
- --- SDL::Surface#drawFilledEllipseAlpha(x,y,rx,ry,color,alpha)
583
- --- SDL::Surface#draw_filled_ellipse_alpha(x,y,rx,ry,color,alpha)
584
- Needs SGE ,Needs lock
585
-
586
- Draws a filled ellipse with alpha blending.
587
-
588
- --- SDL::Surface#drawAALineAlpha(x1,y1,x2,y2,color,alpha)
589
- --- SDL::Surface#draw_aa_line_alpha(x1,y1,x2,y2,color,alpha)
590
- Needs SGE ,Needs lock
591
-
592
- Draws an antialiased line with alpha blending.
593
-
594
- --- SDL::Surface#drawAACircleAlpha(x,y,r,color,alpha)
595
- --- SDL::Surface#draw_aa_circle_alpha(x,y,r,color,alpha)
596
- Needs SGE ,Needs lock
597
-
598
- Draws an antialiased circle with alpha blending.
599
-
600
- --- SDL::Surface#drawAAEllipseAlpha(x,y,rx,ry,color,alpha)
601
- --- SDL::Surface#draw_aa_ellipse_alpha(x,y,rx,ry,color,alpha)
602
- Needs SGE ,Needs lock
603
-
604
- Draws an antialiased ellipse with alpha blending.
605
-
606
- --- SDL::Surface#drawBezier(x1,y1,x2,y2,x3,y3,x4,y4,level,color)
607
- --- SDL::Surface#draw_bezier(x1,y1,x2,y2,x3,y3,x4,y4,level,color)
608
- Needs SGE ,Needs lock
609
-
610
- Draws a bezier curve from (x1,y1) to (x4,y4) with the control
611
- points (x2,y2) and (x3,y3). level indicates how good precision
612
- the function should use, 4-7 is normal.
613
-
614
- --- SDL::Surface#drawAABezier(x1,y1,x2,y2,x3,y3,x4,y4,level,color)
615
- --- SDL::Surface#draw_aa_bezier(x1,y1,x2,y2,x3,y3,x4,y4,level,color)
616
- Needs SGE ,Needs lock
617
-
618
- Draws a antialiased bezier curve from (x1,y1) to (x4,y4) with the control
619
- points (x2,y2) and (x3,y3). level indicates how good precision
620
- the function should use, 4-7 is normal.
621
-
622
- --- SDL::Surface#drawBezierAlpha(x1,y1,x2,y2,x3,y3,x4,y4,level,color,alpha)
623
- --- SDL::Surface#draw_bezier_alpha(x1,y1,x2,y2,x3,y3,x4,y4,level,color,alpha)
624
- Needs SGE ,Needs lock
625
-
626
- Draws an alpha bezier curve from (x1,y1) to (x4,y4) with the control
627
- points (x2,y2) and (x3,y3). level indicates how good precision
628
- the function should use, 4-7 is normal.
629
-
630
- --- SDL::Surface#drawAABezierAlpha(x1,y1,x2,y2,x3,y3,x4,y4,level,color,alpha)
631
- --- SDL::Surface#draw_aa_bezier_alpha(x1,y1,x2,y2,x3,y3,x4,y4,level,color,alpha)
632
- Needs SGE ,Needs lock
633
-
634
- Draws an antialiased alpha bezier curve from (x1,y1) to (x4,y4)
635
- with the control
636
- points (x2,y2) and (x3,y3). level indicates how good precision
637
- the function should use, 4-7 is normal.
638
-
639
- --- SDL::Surface#rotateScaledSurface(angle,scale,bgcolor)
640
- --- SDL::Surface#rotate_scaled_surface(angle,scale,bgcolor)
641
- Needs SGE
642
- This function makes the instance of Surface with a rotated and scaled
643
- copy of "self". "angle" is the rotation angle in degrees.
644
- "scale" is the scaling value , 1.0 is the normal size.
645
-
646
- This method is obsolete. Please use ((<SDL::Surface#transformSurface>)).
647
-
648
- --- SDL::Surface#rotateSurface(angle,bgcolor)
649
- --- SDL::Surface#rotate_surface(angle,bgcolor)
650
- Same as above,but with scale=1.0 .
651
-
652
- --- SDL::Surface#transformSurface(bgcolor,angle,xscale,yscale,flags)
653
- --- SDL::Surface#transform_surface(bgcolor,angle,xscale,yscale,flags)
654
- Creates a rotated and scaled image of src. See ((<SDL.transform>))
655
- for more information.
656
-
657
- * bgcolor - What background color should the new surface have.
658
-
659
- --- SDL::Surface#mapRGB(r,g,b)
660
- --- SDL::Surface#map_rgb(r,g,b)
661
- Maps the RGB color value to the pixel format of specified surface
662
- and returns the pixel value as a integer.
663
-
664
- --- SDL::Surface#mapRGBA(r,g,b,a)
665
- --- SDL::Surface#map_rgba(r,g,b,a)
666
- Same as above,but includes alpha value.
667
-
668
- --- SDL::Surface#getRGB(pixel)
669
- --- SDL::Surface#get_rgb(pixel)
670
- Get RGB component values from a pixel stored in the specified pixel
671
- format.Returns r,g,b value in array as [r,g,b].
672
-
673
- --- SDL::Surface#getRGBA(pixel)
674
- --- SDL::Surface#get_rgba(pixel)
675
- Same as above, but return value includes alplah value.
676
- Returns r,g,b,a in arrary as [r,g,b,a].
677
-
678
- --- SDL::Surface#bpp
679
- Return bits per pixel on this surface.
680
-
681
- --- SDL::Surface#colorkey
682
- Returns colorkey on this surface.
683
-
684
- --- SDL::Surface#alpha
685
- Returns alpha on this surface.
686
-
687
- --- SDL::Surface#flags
688
- Returns flags on this surface.
689
-
690
- --- SDL::Surface#Rmask
691
- --- SDL::Surface#Gmask
692
- --- SDL::Surface#Bmask
693
- --- SDL::Surface#Amask
694
- Returns [RGBA] mask on this surface.
695
-
696
- --- SDL::Surface#pixels
697
- Returns pixel data as String.
698
-
699
- --- SDL::Surface#setPalette(flag,colors,firstcolor)
700
- --- SDL::Surface#set_palette(flag,colors,firstcolor)
701
- Sets a portion of the palette for the given 8-bit surface.
702
-
703
- Palettized (8-bit) screen surfaces with the SDL_HWPALETTE flag have two
704
- palettes, a logical palette that is used for mapping blits to/from
705
- the surface and a physical palette (that determines how the
706
- hardware will map the colors to the display).
707
-
708
- This method can modify either the logical or physical
709
- palette by specifing SDL::LOGPAL or SDL::PHYSPAL in the flags parameter.
710
-
711
- If you want to modify the palette from Xth to th, you will give
712
- following array as colors, and X as firstcolor.
713
- [ [rX,gX,bX],[rX+1,gX+1,bX+1], ... ,[rY,gY,bY] ]
714
-
715
- --- SDL::Surface#setColors(colors,firstcolor)
716
- --- SDL::Surface#set_colors(colors,firstcolor)
717
- Same as ((<SDL::Surface#setPalette>)), but flag is
718
- SDL::LOGPAL|SDL::PHYSPAL.
719
-
720
- --- SDL::Surface#getPalette
721
- --- SDL::Surface#get_palette
722
- Returns the palette of the specified surface. Return value is array
723
- as following.
724
- [ [r0,g0,b0],[r1,g1,b1], ... ,[r255,g255,b255] ]
725
- Returns nil if the surface have no palette.
726
-
727
- --- SDL::Surface#makeCollisionMap
728
- Need SGE
729
-
730
- Create a collision map. Call SetColorKey first. Every
731
- non-transparent pixel in the surface is set to solid in the collision
732
- map. Returns an instance of CollisionMap.
733
-
734
- === SDL::CollisionMap
735
-
736
- Need SGE
737
-
738
- This is a map of which pixels in a surface are solid and which are
739
- transparent. Its methods can quickly determine whether or not two
740
- surfaces would overlap if drawn at particular coordinates.
741
-
742
- Only ((<SDL::Surface#makeCollisionMap>)) makes this object.
743
-
744
- ==== class method
745
-
746
- --- SDL::CollisionMap#boundingBoxCheck(x1, y1, w1, h1, x2, y2, w2, h2)
747
- Return true if the bounding boxes overlap.
748
-
749
- ==== method
750
-
751
- --- SDL::CollisionMap#collisionCheck(x1, y1, collisionMap, x2, y2)
752
- Determine if this collision map, if drawn with its upper-left
753
- corner at (x1, y1), would collide with collisionMap if drawn
754
- with its upper-left corner at (x2, y2). If so, return the
755
- coordinate of the last collision found as an array ([x, y]).
756
- If no collision, returns nil.
757
-
758
- This method calls boundingBoxCheck automatically.
759
-
760
- --- SDL::CollisionMap#boundingBoxCheck(x1, y1, collisionMap, x2, y2)
761
- Return true if the bounding boxes of the two maps would overlap if
762
- drawn with upper-left corners at (x1, y1) and (x2, y2).
763
-
764
- --- SDL::CollisionMap#clear(x1, y1, w, h)
765
- Clear (make transparent) an area of the collision map.
766
-
767
- --- SDL::CollisionMap#set(x1, y1, w, h)
768
- Set (make solid) an area of the collision map.
769
-
770
- === SDL::Screen
771
-
772
- SDL display the image that the instance of "Screen" have.
773
- Only ((<SDL.setVideoMode>)) makes this object.
774
- In fact the class named "Screen" doesn't exist,and the object that
775
- SDL::setVideoMode returns is the instance of Surface with following
776
- singleton methods.
777
-
778
- ==== super class
779
-
780
- ((<SDL::Surface>))
781
-
782
- ==== class method
783
-
784
-
785
- ==== method
786
-
787
- --- SDL::Screen#updateRect(x,y,w,h)
788
- --- SDL::Screen#update_rect(x,y,w,h)
789
- Makes sure the given rectangle is updated on the given screen.
790
- Thhis function should not be called while screen is locked.
791
-
792
- If 'x', 'y', 'w' and 'h' are all 0, SDL_UpdateRect will update the entire
793
- screen.
794
-
795
- --- SDL::Screen#updateRects(*rects)
796
- --- SDL::Screen#update_rects(*rects)
797
- Makes sure the given list of rectangles is updated on the given screen.
798
- Each rectagle is represented as an array of 4 elements([x, y, w, h]).
799
- The rectangles must all be confined within the screen boundaries
800
- (no clipping is done).
801
-
802
-
803
- --- SDL::Screen#flip
804
- On hardware that supports double-buffering, this method sets up a flip
805
- and returns. The hardware will wait for vertical retrace, and then swap
806
- video buffers before the next video surface blit or lock will return. On
807
- hardware that doesn't support double-buffering, this is equivalent to
808
- calling ((<SDL::Screen#updateRect>))(0, 0, 0, 0)
809
-
810
- The SDL::DOUBLEBUF flag must have been passed to
811
- ((<SDL.setVideoMode>)), when
812
- setting the video mode for this method to perform hardware flipping.
813
-
814
- === SDL::PixelFormat
815
-
816
- ((<SDL::Surface>)) has all methods of ((<SDL::PixelFormat>)).
817
- This class is obsolete,
818
- and you should use ((<SDL::Surface>)) instead of ((<SDL::PixelFormat>)).
819
-
820
- In SDL you can use some type surface,for example 32bit color surface and
821
- 16bit surface.Therefore you need the information about that type,and
822
- object of PixelFormat represents this information.
823
-
824
- In this lib,you use one integer to specify color.To change from r,g,b value
825
- to this integer you use ((<SDL::PixelFormat#mapRGB>)) and to change this integer
826
- to r,g,b value ((<SDL::PixelFormat#getRGB>))
827
-
828
- ==== super class
829
-
830
- Object
831
-
832
- ==== class method
833
-
834
- nothing
835
-
836
- ==== method
837
-
838
- --- SDL::PixelFormat#mapRGB(r,g,b)
839
- Maps the RGB color value to the specified pixel format and returns the
840
- pixel value as a integer.
841
-
842
- --- SDL::PixelFormat#mapRGBA(r,g,b,a)
843
- Same as above,but includes alpha value.
844
-
845
- --- SDL::PixelFormat#getRGB(pixel)
846
- Get RGB component values from a pixel stored in the specified pixel
847
- format.Returns r,g,b value in array as [r,g,b].
848
-
849
- --- SDL::PixelFormat#getRGBA(pixel)
850
- Same as above, but return value includes alplah value.
851
- Returns r,g,b,a in arrary as [r,g,b,a].
852
-
853
- --- SDL::PixelFormat#bpp
854
- Return bits per pixel on this format.
855
-
856
- --- SDL::PixelFormat#colorkey
857
- Not documented yet
858
-
859
- --- SDL::PixelFormat#alpha
860
- Not documented yet
861
-
862
- == Event handling
863
-
864
- === SDL::Event
865
-
866
- The class handling event.
867
- You had better use ((<SDL::Event2>)) instead of this class.
868
-
869
- ==== super class
870
-
871
- Object
872
-
873
- ==== class method
874
-
875
- --- SDL::Event.new
876
- Create a new ((<SDL::Event>)) Object.
877
-
878
- --- SDL::Event.appState
879
- --- SDL::Event.app_state
880
- Returns the current state of the application. The value returned
881
- is a bitwise combination of:
882
- SDL::Event::APPMOUSEFOCUS
883
- SDL::Event::APPINPUTFOCUS
884
- SDL::Event::APPACTIVE
885
-
886
- --- SDL::Event.enableUNICODE
887
- --- SDL::Event.enable_unicode
888
- Enables UNICODE keyboard translation.
889
- UNICODE translation is disabled by default.
890
- If you will use SDLSKK on Ruby/SDL, you should enable translation.
891
-
892
- --- SDL::Event.disableUNICODE
893
- --- SDL::Event.disable_unicode
894
- Disable UNICODE keyboard translation.
895
-
896
- --- SDL::Event.enableUNICODE?
897
- --- SDL::Event.enable_unicode?
898
- Returns whether UNICODE keyboard translation is enabled.
899
-
900
- ==== method
901
-
902
- --- SDL::Event#poll
903
- Polls for currently pending events, and returns 1 if there are any
904
- pending events, or 0 if there are none available.
905
- If there are any events ,the next event is removed from the queue
906
- and stored in self.
907
-
908
- --- SDL::Event#wait
909
- Waits indefinitely for the next available event, returning 1, or 0 if
910
- there was an error while waiting for events.
911
- The next event is removed from the queue and stored in self.
912
-
913
- --- SDL::Event#type
914
- Returns the type of stored event.
915
- SDL::Event::ACTIVEEVENT
916
- SDL::Event::KEYDOWN
917
- SDL::Event::KEYUP
918
- SDL::Event::MOUSEMOTION
919
- SDL::Event::MOUSEBUTTONDOWN
920
- SDL::Event::MOUSEBUTTONUP
921
- SDL::Event::JOYAXISMOTION
922
- SDL::Event::JOYBALLMOTION
923
- SDL::Event::JOYHATMOTION
924
- SDL::Event::JOYBUTTONDOWN
925
- SDL::Event::JOYBUTTONUP
926
- SDL::Event::QUIT
927
- SDL::Event::SYSWMEVENT
928
- SDL::Event::VIDEORESIZE
929
-
930
- --- SDL::Event#info
931
- Return event information in array.
932
- This method can handle all event.
933
-
934
- --- SDL::Event#keyPress?
935
- --- SDL::Event#key_press?
936
- Returns true when you got key event and a key pressed down,
937
- otherwise returns false.
938
-
939
- --- SDL::Event#keySym
940
- --- SDL::Event#key_sym
941
- Returns SDL vertual keysym.
942
-
943
- --- SDL::Event#keyMod
944
- --- SDL::Event#key_mod
945
- Returns Current Key modifiers.
946
-
947
- --- SDL::Event#gain?
948
- On ACTIVEEVENT,
949
- returns true when gaining focus in this event,otherwise retursn false.
950
-
951
- --- SDL::Event#appState
952
- --- SDL::Event#app_state
953
- Returns the kind of ActiveEvent.
954
- This value is following.
955
- SDL::Event::APPMOUSEFOCUS
956
- SDL::Event::APPINPUTFOCUS
957
- SDL::Event::APPACTIVE
958
-
959
- --- SDL::Event#mouseX
960
- --- SDL::Event#mouse_x
961
- Returns the X coordinate of the mouse.
962
-
963
- --- SDL::Event#mouseY
964
- --- SDL::Event#mouse_y
965
- Returns the Y coordinate of the mouse.
966
-
967
- --- SDL::Event#mouseXrel
968
- --- SDL::Event#mouse_xrel
969
- Returns the relative motion in the X direction.
970
-
971
- --- SDL::Event#mouseYrel
972
- --- SDL::Event#mouse_yrel
973
- Returns the relative motion in the Y direction.
974
-
975
- --- SDL::Event#mouseButton
976
- --- SDL::Event#mouse_button
977
- Returns the mouse button index.
978
- SDL::Mouse::BUTTON_LEFT
979
- SDL::Mouse::BUTTON_MIDDLE
980
- SDL::Mouse::BUTTON_RIGHT
981
-
982
- --- SDL::Event#mousePress?
983
- --- SDL::Event#mouse_press?
984
- Returns true when this mouse event is SDL::Event::MOUSEBUTTONDOWN,
985
- otherwise returns false.
986
-
987
- === SDL::Event2
988
- Another event handling class.
989
- I think ((<SDL::Event2>)) is easier to use than ((<SDL::Event>))
990
-
991
- ==== super class
992
-
993
- Object
994
-
995
- ==== class method
996
-
997
- --- SDL::Event2.poll
998
- Polls for currently pending events, and returns the instance represents
999
- that event.Returns nil if there is no pending event.
1000
- The class of that instance is following.
1001
- SDL::Event2::Active
1002
- SDL::Event2::KeyDown
1003
- SDL::Event2::KeyUp
1004
- SDL::Event2::MouseMotion
1005
- SDL::Event2::MouseButtonDown
1006
- SDL::Event2::MouseButtonUp
1007
- SDL::Event2::JoyAxis
1008
- SDL::Event2::JoyBall
1009
- SDL::Event2::JoyHat
1010
- SDL::Event2::JoyButtonUp
1011
- SDL::Event2::JoyButtonDown
1012
- SDL::Event2::Quit
1013
- SDL::Event2::SysWM
1014
- SDL::Event2::VideoResize
1015
- All of these classes are subclass of SDL::Event2.
1016
-
1017
- --- SDL::Event2.wait
1018
- Waits indefinitely for the next available event,returning the instance
1019
- represents that event.
1020
-
1021
- Note that while waiting next event, ruby's interpreter is blocked
1022
- and it cannot switch other threads because ruby's thread is
1023
- user-level thread.
1024
-
1025
- --- SDL::Event2.push(event)
1026
- Not documented yet.
1027
-
1028
- --- SDL::Event2.new
1029
- Not documented yet.
1030
-
1031
- --- SDL::Event2.appState
1032
- --- SDL::Event2.app_state
1033
- Same as ((<SDL::Event.appState>)).
1034
-
1035
- --- SDL::Event2.enableUNICODE
1036
- --- SDL::Event2.enable_unicode
1037
- Same as ((<SDL::Event.enableUNICODE>)).
1038
-
1039
- --- SDL::Event2.disableUNICODE
1040
- --- SDL::Event2.disable_unicode
1041
- Same as ((<SDL::Event2.disableUNICODE>)).
1042
-
1043
- --- SDL::Event2.enableUNICODE?
1044
- --- SDL::Event2.enable_unicode?
1045
- Same as ((<SDL::Event.enableUNICODE?>)).
1046
-
1047
- ==== method
1048
-
1049
- Nothing
1050
-
1051
- === subclasses of SDL::Event2
1052
- SDL::Event2.poll and SDL::Event2.wait return the instance of
1053
- the subclasses of SDL::Event2.
1054
- These classes and following.
1055
-
1056
- ==== SDL::Event2::Active
1057
- This event occurs when mouse/keyboard focus gains/loss.
1058
- + Method
1059
- --- SDL::Event2::Active#gain
1060
- Returns true focus gains, otherwise returns false
1061
- --- SDL::Event2::Active#state
1062
- Returns the kind of event.
1063
- SDL::Event::APPMOUSEFOCUS
1064
- SDL::Event::APPINPUTFOCUS
1065
- SDL::Event::APPACTIVE iconify or restored.
1066
-
1067
- ==== SDL::Event2::KeyDown
1068
- This event occurs when a key is pressed.
1069
- + Method
1070
- --- SDL::Event2::KeyDown#press
1071
- Returns true.
1072
- --- SDL::Event2::KeyDown#sym
1073
- Returns the pressed key such as SDL::Key::ESCAPE.
1074
- --- SDL::Event2::KeyDown#mod
1075
- Same as ((<SDL::Key.modState>)).
1076
- --- SDL::Event2::KeyDown#unicode
1077
- Returns key input translated to UNICODE.If you will use this,
1078
- you need to call ((<SDL::Event2.enableUNICODE>)) beforehand.
1079
- ==== SDL::Event2::KeyUp
1080
- This event occurs when a key is released.
1081
- + Method
1082
- --- SDL::Event2::KeyUp#press
1083
- Returns false.
1084
- --- SDL::Event2::KeyUp#sym
1085
- Returns the released key such as SDL::Key::ESCAPE.
1086
- --- SDL::Event2::KeyUp#mod
1087
- Same as ((<SDL::Key.modState>)).
1088
-
1089
- ==== SDL::Event2::MouseMotion
1090
- This event occurs when mouse is moved.
1091
- + Method
1092
- --- SDL::Event2::MouseMotion#state
1093
- Returns the button state.
1094
- --- SDL::Event2::MouseMotion#x
1095
- Returns x of mouse cursor.
1096
- --- SDL::Event2::MouseMotion#y
1097
- Returns y of mouse cursor.
1098
- --- SDL::Event2::MouseMotion#xrel
1099
- Returns relative x coordinates.
1100
- --- SDL::Event2::MouseMotion#yrel
1101
- Returns relative y coordinates.
1102
-
1103
- ==== SDL::Event2::MouseButtonDown
1104
- This event occurs when a mouse button is pressed.
1105
- + Method
1106
- --- SDL::Event2::MouseButtonDown#button
1107
- Returns the which button is pressed.
1108
- SDL::Mouse::BUTTON_LEFT
1109
- SDL::Mouse::BUTTON_MIDDLE
1110
- SDL::Mouse::BUTTON_RIGHT
1111
-
1112
- --- SDL::Event2::MouseButtonDown#press
1113
- Returns true.
1114
- --- SDL::Event2::MouseButtonDown#x
1115
- Returns x of mouse cursor.
1116
- --- SDL::Event2::MouseButtonDown#y
1117
- Returns y of mouse cursor.
1118
-
1119
- ==== SDL::Event2::MouseButtonUp
1120
- This event occurs when a mouse button is pressed.
1121
- + Method
1122
- --- SDL::Event2::MouseButtonUp#button
1123
- Returns the which button is released.
1124
- SDL::Mouse::BUTTON_LEFT
1125
- SDL::Mouse::BUTTON_MIDDLE
1126
- SDL::Mouse::BUTTON_RIGHT
1127
-
1128
- --- SDL::Event2::MouseButtonUp#press
1129
- Returns false.
1130
- --- SDL::Event2::MouseButtonUp#x
1131
- Returns x of mouse cursor.
1132
- --- SDL::Event2::MouseButtonUp#y
1133
- Returns y of mouse cursor.
1134
-
1135
- ==== SDL::Event2::JoyAxis
1136
- This event occurs when axis of joystick is moved.
1137
- + Method
1138
- --- SDL::Event2::JoyAxis#which
1139
- Returns joystick device index.
1140
- --- SDL::Event2::JoyAxis#axis
1141
- Returns joystick axis index.
1142
- --- SDL::Event2::JoyAxis#value
1143
- Returns axis value(from -32768 to 32767).
1144
-
1145
- ==== SDL::Event2::JoyBall
1146
- This event occurs when joystick trackball moves.
1147
- + Method
1148
- --- SDL::Event2::JoyBall#which
1149
- Returns joystick device index.
1150
- --- SDL::Event2::JoyBall#ball
1151
- Returns joystick trackball index.
1152
- --- SDL::Event2::JoyBall#xrel
1153
- Returns the relative motion in the X direction.
1154
- --- SDL::Event2::JoyBall#yrel
1155
- Returns the relative motion in the Y direction.
1156
-
1157
- ==== SDL::Event2::JoyHat
1158
- This event occurs when joystick hat moves.
1159
- + Method
1160
- --- SDL::Event2::JoyHat#which
1161
- Returns joystick device index.
1162
- --- SDL::Event2::JoyHat#hat
1163
- Returns joystick hat index.
1164
- --- SDL::Event2::JoyHat#value
1165
- Returns hat position.
1166
- That values is a logically OR'd combination
1167
- of the following values.
1168
- SDL::Joystick::HAT_CENTERED
1169
- SDL::Joystick::HAT_UP
1170
- SDL::Joystick::HAT_RIGHT
1171
- SDL::Joystick::HAT_DOWN
1172
- SDL::Joystick::HAT_LEFT
1173
-
1174
- The following defines are also provided
1175
- SDL::Joystick::HAT_RIGHTUP
1176
- SDL::Joystick::HAT_RIGHTDOWN
1177
- SDL::Joystick::HAT_LEFTUP
1178
- SDL::Joystick::HAT_LEFTDOWN
1179
-
1180
- ==== SDL::Event2::JoyButtonUp
1181
- This event occurs when joystick button is released.
1182
- + Method
1183
- --- SDL::Event2::JoyButtonUp#which
1184
- Returns joystick device index.
1185
- --- SDL::Event2::JoyButtonUp#button
1186
- Returns joystick button index.
1187
- --- SDL::Event2::JoyButtonUp#press
1188
- Returns false.
1189
-
1190
- ==== SDL::Event2::JoyButtonDown
1191
- This event occurs when joysick button is pressed.
1192
- + Method
1193
- --- SDL::Event2::JoyButtonDown#which
1194
- Returns joystick device index.
1195
- --- SDL::Event2::JoyButtonDown#button
1196
- Returns joystick button index.
1197
- --- SDL::Event2::JoyButtonDown#press
1198
- Returns true.
1199
-
1200
- ==== SDL::Event2::Quit
1201
- This event occurs when quit requested, such as pressed exit button.
1202
-
1203
- ==== SDL::Event2::SysWM
1204
- This event occurs when platform-dependent window manager occurs.
1205
- You can't get more information.
1206
-
1207
- ==== SDL::Event2::VideoResize
1208
- This event occurs when window are resized.
1209
- You will get this event only when you call ((<SDL.setVideoMode>)) with
1210
- SDL::RESIZABLE.
1211
-
1212
- + Method
1213
- --- SDL::Event2::VideoResize#w
1214
- Returns new width of window.
1215
- --- SDL::Event2::VideoResize#h
1216
- Returns new height of window.
1217
-
1218
- === SDL::Key
1219
-
1220
- The module defines key constants.
1221
- This module has some functions to get the key state.
1222
-
1223
- ==== module functions
1224
-
1225
- --- SDL::Key.scan
1226
- scan key state.
1227
-
1228
- --- SDL::Key.press?(key)
1229
- Get key state that "scan" function scan.
1230
- return true if "key" is pressed and return false if "key" is released.
1231
-
1232
- --- SDL::Key.modState
1233
- --- SDL::Key.mod_state
1234
- Returns the current of the modifier keys (CTRL,ATL,etc.).
1235
- The return value can be an OR'd combination of following constants.
1236
- SDL::Key::MOD_NONE
1237
- SDL::Key::MOD_LSHIFT
1238
- SDL::Key::MOD_RSHIFT
1239
- SDL::Key::MOD_LCTRL
1240
- SDL::Key::MOD_RCTRL
1241
- SDL::Key::MOD_LALT
1242
- SDL::Key::MOD_RALT
1243
- SDL::Key::MOD_LMETA
1244
- SDL::Key::MOD_RMETA
1245
- SDL::Key::MOD_NUM
1246
- SDL::Key::MOD_CAPS
1247
- SDL::Key::MOD_MODE
1248
- SDL::Key::MOD_RESERVED
1249
- SDL::Key::MOD_CTRL = SDL::Key::MOD_LCTRL|SDL::Key::MOD_RCTRL
1250
- SDL::Key::MOD_SHIFT = SDL::Key::MOD_LSHIFT|SDL::Key::MOD_RSHIFT
1251
- SDL::Key::MOD_ALT = SDL::Key::MOD_LALT|SDL::Key::MOD_RALT
1252
- SDL::Key::MOD_META = SDL::Key::MOD_LMETA|SDL::Key::MOD_RMETA
1253
-
1254
- --- SDL::Key.enableKeyRepeat(delay,interval)
1255
- --- SDL::Key.enable_key_repeat(delay,interval)
1256
- Set keyboard repeat rate.
1257
-
1258
- --- SDL::Key.disableKeyRepeat
1259
- --- SDL::Key.disable_key_repeat
1260
- Disables key repeat.
1261
-
1262
- --- SDL::Key.getKeyName(key)
1263
- --- SDL::Key.get_key_name(key)
1264
- Return the string of key name.
1265
-
1266
- === SDL::Mouse
1267
-
1268
- The module mouse constants and mouse functions.
1269
-
1270
- === module functions
1271
-
1272
- --- SDL::Mouse.state
1273
- Return mouse state in array.
1274
- Return value is following,
1275
- [ x , y , pressLButton? , pressMButton? , pressRButton? ]
1276
-
1277
- --- SDL::Mouse.warp(x,y)
1278
- Set the position of the mouse cursor (generates a mouse motion event).
1279
-
1280
- --- SDL::Mouse.show
1281
- Show mouse cursor.
1282
-
1283
- --- SDL::Mouse.hide
1284
- Hide mouse cursor.
1285
-
1286
- --- SDL::Mouse.setCursor(bitmap,white,black,transparent,inverted,hot_x=0,hot_y=0)
1287
- --- SDL::Mouse.set_cursor(bitmap,white,black,transparent,inverted,hot_x=0,hot_y=0)
1288
- Change mouse cursor. bitmap is form of cursor,instance of
1289
- ((<SDL::Surface>)).The cursor width must be a multiple of 8.
1290
- The cursor is created in black and white according to
1291
- bitmap and white,black,transparent,inverted.
1292
- white,black,transparent,inverted represents that elements in
1293
- bitmap as pixel value.
1294
-
1295
- == audio
1296
-
1297
- === SDL::Mixer
1298
-
1299
- The module that have sound functions and constants.
1300
- Note that volume is between 0 and 128.
1301
- Needs SDL_mixer to use functions if this module.
1302
-
1303
- ==== module functions
1304
-
1305
- --- SDL::Mixer.open(frequency=Mixer::DEFAULT_FREQUENCY,format=Mixer::DEFAULT_FORMAT,cannels=Mixer::DEFAULT_CHANNELS,chunksize=4096)
1306
- Initializes SDL_mixer.
1307
-
1308
- --- SDL::Mixer.spec
1309
- Returns the audio spec in array.
1310
- [ rate,format,channels ]
1311
-
1312
- --- SDL::Mixer.driverName
1313
- --- SDL::Mixer.driver_name
1314
- Returns the current audio device name.
1315
- Raises SDL::Error if mixer is not initialized yet.
1316
-
1317
- --- SDL::Mixer.allocateChannels(numchannels)
1318
- --- SDL::Mixer.allocate_channels(numchannels)
1319
- Dynamically change the number of channels managed by the mixer.
1320
- If decreasing the number of channels, the upper channels are
1321
- stopped.
1322
- This method returns the new number of allocated channels.
1323
-
1324
- --- SDL::Mixer.playChannel(channel,wave,looping)
1325
- --- SDL::Mixer.play_channel(channel,wave,looping)
1326
- Play a wave on a specific channel.
1327
-
1328
- If the specified channel is -1, play on the first free channel.
1329
- If 'loops' is greater than zero, loop the sound that many times.
1330
- If 'loops' is -1, loop inifinitely (~65000 times).
1331
-
1332
- Returns which channel was used to play the sound.
1333
-
1334
- --- SDL::Mixer.play?(channel)
1335
- Returns whether specific channel is playing or not.
1336
-
1337
- If the specified channel is -1, check all channels.
1338
-
1339
- --- SDL::Mixer.setVolume(channel,volume)
1340
- --- SDL::Mixer.set_volume(channel,volume)
1341
- Set the volume in the range of 0-128 of a specific channel.
1342
- If the specified channel is -1, set volume for all channels.
1343
- Returns the original volume.
1344
- If the specified volume is -1, just return the current volume.
1345
-
1346
- --- SDL::Mixer.halt(channel)
1347
- Halt playing of a particular channel
1348
-
1349
- --- SDL::Mixer.pause(chennel)
1350
- Pause a particular channel
1351
-
1352
- --- SDL::Mixer.resume(channel)
1353
- Resume a particular channel
1354
-
1355
- --- SDL::Mixer.pause?(channel)
1356
- Returns whether a particular channel is pausing.
1357
-
1358
- --- SDL::Mixer.playMusic(music,loops)
1359
- --- SDL::Mixer.play_music(music,loops)
1360
- Play a music.
1361
-
1362
- --- SDL::Mixer.fadeInMusic(music,loops,ms)
1363
- --- SDL::Mixer.fade_in_music(music,loops,ms)
1364
- Fade in the given music in ms milliseconds.
1365
- The meaning of loops is same as in ((<SDL::Mixer.playChannel>))
1366
-
1367
- --- SDL::Mixer.setVolumeMusic(volume)
1368
- --- SDL::Mixer.set_volume_music(volume)
1369
- Sets the volume of music.
1370
-
1371
- --- SDL::Mixer.haltMusic
1372
- --- SDL::Mixer.halt_music
1373
- Halts music.
1374
-
1375
- --- SDL::Mixer.fadeOutMusic(ms)
1376
- --- SDL::Mixer.fade_out_music(ms)
1377
- Fade out the music in ms milliseconds.
1378
-
1379
- --- SDL::Mixer.pauseMusic
1380
- --- SDL::Mixer.pause_music
1381
- Pauses music.
1382
-
1383
- --- SDL::Mixer.resumeMusic
1384
- --- SDL::Mixer.resume_music
1385
- Resumes music.
1386
-
1387
- --- SDL::Mixer.rewindMusic
1388
- --- SDL::Mixer.rewind_music
1389
- Rewinds music.
1390
-
1391
- --- SDL::Mixer.pauseMusic?
1392
- --- SDL::Mixer.pause_music?
1393
- Returns whether the music is pausing.
1394
-
1395
- --- SDL::Mixer.playMusic?
1396
- --- SDL::Mixer.play_music?
1397
- Returns whether the music is playing.
1398
-
1399
- === SDL::Mixer::Wave
1400
-
1401
- The class handling wave
1402
-
1403
- ==== super class
1404
-
1405
- Object
1406
-
1407
- ==== class method
1408
-
1409
- --- SDL::Mixer::Wave.load(filename)
1410
- Loads a wave file and returns the object of ((<SDL::Mixer::Wave>)).
1411
-
1412
- ==== method
1413
-
1414
- --- SDL::Mixer::Wave#setVolume(volume)
1415
- --- SDL::Mixer::Wave#set_volume(volume)
1416
- Set volume of self.
1417
-
1418
- === SDL::Mixer::Music
1419
-
1420
- ==== super class
1421
-
1422
- Object
1423
-
1424
- ==== class method
1425
-
1426
- --- SDL::Mixer::Music.load(filename)
1427
- Loads a music (.mod .s3m .it .xm .mid .mp3, .ogg) file and returns the
1428
- object of ((<SDL::Mixer::Music>)).
1429
-
1430
- You have to setup your environment to play MIDI, Ogg Vorbis, and MP3 file.
1431
-
1432
- == Window Manager
1433
-
1434
- === SDL::WM
1435
-
1436
- The module that have the functions for window management.
1437
-
1438
- ==== module functions
1439
-
1440
- --- SDL::WM.caption
1441
- Returns captions of the window title and icon name.
1442
-
1443
- --- SDL::WM.setCaption(title,icon)
1444
- --- SDL::WM.set_caption(title,icon)
1445
- Set captions of the window title and icon name.
1446
-
1447
- --- SDL::WM.icon=(iconImage)
1448
- --- SDL::WM.icon=(icon_image)
1449
- Sets the icon for the display window.
1450
-
1451
- This function must be called before the first call to
1452
- setVideoMode.
1453
-
1454
- It takes an icon surface.
1455
-
1456
- --- SDL::WM.iconify
1457
- If the application is running in a window managed environment SDL
1458
- attempts to iconify/minimise it. If ((<SDL::WM.iconify>)) is successful,
1459
- the application will receive a APPACTIVE loss event.
1460
-
1461
- --- SDL::Screen#toggleFullScreen
1462
- --- SDL::Screen#toggle_fullscreen
1463
- Toggles fullscreen mode.
1464
-
1465
- == CDROM
1466
-
1467
- === SDL::CD
1468
-
1469
- The class represents CDROM drive.
1470
-
1471
- Note that the information that you get with ((<SDL::CD#numTracks>)) is stored
1472
- when you call ((<SDL::CD#status>)).
1473
-
1474
- A CD-ROM is organized into one or more tracks, each consisting of a
1475
- certain number of "frames". Each frame is ~2K in size, and at normal
1476
- playing speed, a CD plays 75 frames per second. SDL works with the
1477
- number of frames on a CD.
1478
-
1479
- ==== super class
1480
-
1481
- ==== class method
1482
-
1483
- --- SDL::CD.numDrive
1484
- --- SDL::CD.num_drive
1485
- Returns the number of CD-ROM drives on the system.
1486
-
1487
- --- SDL::CD.indexName(drive)
1488
- --- SDL::CD.index_name(drive)
1489
- Returns a human-readable, system-dependent identifier for the CD-ROM.
1490
- drive is the index of the drive. Drive indices start to 0 and end at
1491
- SDL::CD.numDrive-1
1492
-
1493
- --- SDL::CD.open(drive)
1494
- Opens a CD-ROM drive for access.
1495
- It returns a object of CD.
1496
- Raises SDL::Error if the drive was invalid or busy.
1497
- Drives are numbered starting with 0. Drive 0 is the system default
1498
- CD-ROM.
1499
-
1500
- ==== method
1501
-
1502
- --- SDL::CD#status
1503
- Stores the information of currentTrack,currentFrame,numTracks,trackType,
1504
- trackLenght .
1505
- This function returns the current status.
1506
- Status is described like so:
1507
- SDL::CD::TRAYEMPTY
1508
- SDL::CD::STOPPED
1509
- SDL::CD::PLAYING
1510
- SDL::CD::PAUSED
1511
- SDL::CD::ERROR
1512
-
1513
- --- SDL::CD#play(start,length)
1514
- Plays the given cdrom, starting a frame start for length frames.
1515
-
1516
- --- SDL::CD#playTrack(start_track,start_frame,ntracks,nframes)
1517
- --- SDL::CD#play_track(start_track,start_frame,ntracks,nframes)
1518
- SDL_CDPlayTracks plays the given CD starting at track start_track, for
1519
- ntracks tracks.
1520
-
1521
- start_frame is the frame offset, from the beginning of the start_track,
1522
- at which to start. nframes is the frame offset, from the beginning of
1523
- the last track (start_track+ntracks), at which to end playing.
1524
-
1525
- SDL::CD#playTracks should only be called after calling
1526
- ((<SDL::CD#status>)) to get track information about the CD.
1527
-
1528
- --- SDL::CD#pause
1529
- Pauses play.
1530
-
1531
- --- SDL::CD#resume
1532
- Resumes play.
1533
-
1534
- --- SDL::CD#stop
1535
- Stops play.
1536
-
1537
- --- SDL::CD#eject
1538
- Ejects cdrom.
1539
-
1540
- --- SDL::CD#numTracks
1541
- --- SDL::CD#num_tracks
1542
- Returns the number of tracks on the CD.
1543
-
1544
- --- SDL::CD#currentTrack
1545
- --- SDL::CD#current_track
1546
- Returns current track.
1547
-
1548
- --- SDL::CD#currentFrame
1549
- --- SDL::CD#current_frame
1550
- Returns current frame.
1551
-
1552
- --- SDL::CD#trackType(track)
1553
- --- SDL::CD#track_type(track)
1554
- Returns the track type of given track.
1555
- SDL::CD::AUDIO_TRACK
1556
- SDL::CD::DATA_TRACK
1557
-
1558
- --- SDL::CD#trackLength(track)
1559
- --- SDL::CD#track_length(track)
1560
- Returns the track length in frame,of given track.
1561
-
1562
- == Joystick handling
1563
-
1564
- === SDL::Joystick
1565
-
1566
- The class represents one joystick.
1567
-
1568
- === super class
1569
-
1570
- Object
1571
-
1572
- === class method
1573
-
1574
- --- SDL::Joystick.pall
1575
- Return whether ((<SDL::Joystick.updateAll>)) is called automatically.
1576
-
1577
- --- SDL::JoyStick.pall=(polling)
1578
- Set whether ((<SDL::Joystick.updateAll>)) is called automatically and
1579
- whether joystick events are processed.
1580
- Default is true, and you shouldn't change.
1581
-
1582
- --- SDL::Joystick.num
1583
- Returns the number of attached joysticks.
1584
-
1585
- --- SDL::Joystick.indexName(index)
1586
- --- SDL::Joystick.index_name(index)
1587
- Get the implementation dependent name of joystick. The index parameter
1588
- refers to the N'th joystick on the system.
1589
-
1590
- --- SDL::Joystick.open(index)
1591
- Opens a joystick for use within SDL. The index refers to the N'th
1592
- joystick in the system. A joystick must be opened before it game be
1593
- used.
1594
- Returns the object of Joystick.
1595
-
1596
- --- SDL::Joystick.open?(index)
1597
- Determines whether a joystick has already been opened within the
1598
- application. index refers to the N'th joystick on the system.
1599
-
1600
- --- SDL::Joystick.updateAll
1601
- --- SDL::Joystick.update_all
1602
- --- SDL::Joystick.update
1603
- Updates the state(position, buttons, etc.) of all open joysticks.
1604
-
1605
- === method
1606
-
1607
- --- SDL::Joystick#index
1608
- Returns the index of self.
1609
-
1610
- --- SDL::Joystick#numAxes
1611
- --- SDL::Joystick#num_axes
1612
- Return the number of axes available from a previously opened
1613
- joystick.
1614
-
1615
- --- SDL::Joystick#numBalls
1616
- --- SDL::Joystick#num_balls
1617
- Return the number of trackballs available.
1618
-
1619
- --- SDL::Joystick#numButtons
1620
- --- SDL::Joystick#num_buttons
1621
- Returns the number of buttons available.
1622
-
1623
- --- SDL::Joystick#axis(axis_index)
1624
- Returns a 16-bit signed integer representing the current position of the
1625
- axis.
1626
- On most modern joysticks the X axis is usually represented by axis 0 and
1627
- the Y axis by axis 1. The value returned by Joystick#axis is a
1628
- signed integer (-32768 to 32768) representing the current position of
1629
- the axis, it maybe necessary to impose certain tolerances on these
1630
- values to account for jitter. It is worth noting that some joysticks use
1631
- axes 2 and 3 for extra buttons.
1632
-
1633
- --- SDL::Joystick#hat(hat_index)
1634
- The current state is returned as a 8bit unsigned integer
1635
- which is defined as an OR'd combination of one or more of the following
1636
- SDL::Joystick::HAT_CENTERED
1637
- SDL::Joystick::HAT_UP
1638
- SDL::Joystick::HAT_RIGHT
1639
- SDL::Joystick::HAT_DOWN
1640
- SDL::Joystick::HAT_LEFT
1641
- SDL::Joystick::HAT_RIGHTUP
1642
- SDL::Joystick::HAT_RIGHTDOWN
1643
- SDL::Joystick::HAT_LEFTUP
1644
- SDL::Joystick::HAT_LEFTDOWN
1645
-
1646
- --- SDL::Joystick#button(button_index)
1647
- Returns the current state of the given button.
1648
- Returns true if the button is pressed,otherwise 0.
1649
-
1650
- --- SDL::Joystick#ball(ball_index)
1651
- Returns the motion deltas in array, [ dx,dy ] .
1652
- Trackballs can only return relative motion since the last call to
1653
- Joystick#ball, these motion deltas a placed into dx and dy.
1654
-
1655
- == Font handling
1656
-
1657
- === SDL::BMFont
1658
-
1659
- The class handles BitMap Font. This needs SGE.
1660
-
1661
- ==== super class
1662
-
1663
- Object
1664
-
1665
- ==== class method
1666
-
1667
- --- SDL::BMFont.open(filename,flags)
1668
- Open a font file and create a bitmap font object.
1669
- * SDL::BMFont::TRANSPARENT
1670
- Transparent(Should usually be set)
1671
- * SDL::BMFont::NOCONVERT
1672
- * SDL::BMFont::SFONT
1673
- * SDL::BMFont::PALETTE
1674
-
1675
- ==== method
1676
- --- SDL::BMFont#setColor(r,g,b)
1677
- --- SDL::BMFont#set_color
1678
- Changes the color of the font.
1679
- This doesn't work on 'color font' or sfont.
1680
-
1681
- --- SDL::BMFont#height
1682
- Get the height of the font.
1683
-
1684
- --- SDL::BMFont#width
1685
- Get the width of the font.
1686
-
1687
- --- SDL::BMFont#textout(surface,string,x,y)
1688
- Render the given string on surface. (x,y) is the position
1689
- of the left top corner.
1690
-
1691
- === SDL::Kanji
1692
- This class handles bdf fonts. You can draw Japanese character with this
1693
- class.
1694
-
1695
- ==== super class
1696
-
1697
- Object
1698
-
1699
- ==== class method
1700
- --- SDL::Kanji.open(filename,size)
1701
- Open bdf font file and return font object.
1702
- You should specify font size as ((|size|)).
1703
-
1704
- ==== method
1705
- --- SDL::Kanji#add(filename)
1706
- Open other bdf file and add lacked glyphs.
1707
-
1708
- --- SDL::Kanji#setCodingSystem
1709
- --- SDL::Kanji#set_coding_system
1710
- Set Character coding system. You can use following.
1711
- * SDL::Kanji::JIS
1712
- * SDL::Kanji::SJIS
1713
- * SDL::Kanji::EUC
1714
-
1715
- Default is SDL::Kanji::EUC.
1716
-
1717
- --- SDL::Kanji#textwidth(text)
1718
- Return the width of text.
1719
-
1720
- --- SDL::Kanji#width
1721
- Return the width of one ascii character.
1722
-
1723
- --- SDL::Kanji#height
1724
- Return font height.
1725
-
1726
- --- SDL::Kanji#put(surface,text,x,y,r,g,b)
1727
- Draw text on surface at (x,y) whose color is (r,g,b).
1728
-
1729
- --- SDL::Kanji#putTate(surface,text,x,y,r,g,b)
1730
- --- SDL::Kanji#put_tate(surface,text,x,y,r,g,b)
1731
- Draw Tategaki text.
1732
-
1733
- === SDL::TTF
1734
-
1735
- The class handles True Type Font. This needs SDL_ttf.
1736
-
1737
- ==== super class
1738
-
1739
- Object
1740
-
1741
- ==== class method
1742
-
1743
- --- SDL::TTF.init
1744
- You must call TTF.init first when you use True Type Font.
1745
-
1746
- --- SDL::TTF.open(filename,size,index=0)
1747
- Open a font file and create a font of the specified point size.
1748
-
1749
- And you can specify font face with index. Need SDL_ttf 2.0.4 or
1750
- later to use this feature.
1751
-
1752
- ==== method
1753
-
1754
- --- SDL::TTF#style
1755
- Returns the font style.
1756
-
1757
- --- SDL::TTF#style=(style)
1758
- Set font style.
1759
- style is an OR'd conbination of one or more of the following
1760
- SDL::TTF::STYLE_NORMAL
1761
- SDL::TTF::STYLE_BOLD
1762
- SDL::TTF::STYLE_ITALIC
1763
- SDL::TTF::STYLE_UNDERLINE
1764
-
1765
- --- SDL::TTF#textSize(text)
1766
- --- SDL::TTF#text_size(text)
1767
- Get Text size on image in array. Return [width,height].
1768
-
1769
- --- SDL::TTF#faces
1770
- Need SDL_ttf 2.0.4 or later
1771
- Returns the number of face.
1772
-
1773
- --- SDL::TTF#fixedWidth?
1774
- --- SDL::TTF#fixed_width?
1775
- Need SDL_ttf 2.0.4 or later.
1776
- Returns whether this font has fixed width or not.
1777
-
1778
- --- SDL::TTF#familyName
1779
- --- SDL::TTF#family_name
1780
- Need SDL_ttf 2.0.4 or later
1781
- Returns the name of font family.
1782
-
1783
- --- SDL::TTF#styleName
1784
- --- SDL::TTF#style_name
1785
- Need SDL_ttf 2.0.4 or later
1786
- Returns the name of style.
1787
-
1788
- --- SDL::TTF#height
1789
- Get the total height of the font - usually equal to point size.
1790
-
1791
- --- SDL::TTF#ascent
1792
- Get the offset from the baseline to the top of the font
1793
- This is a positive value, relative to the baseline.
1794
-
1795
- --- SDL::TTF#descent
1796
- Get the offset from the baseline to the bottom of the font
1797
- This is a negative value, relative to the baseline.
1798
-
1799
- --- SDL::TTF#lineSkip
1800
- --- SDL::TTF#line_skip
1801
- Get the recommended spacing between lines of text for this font.
1802
-
1803
- --- SDL::TTF#drawSolidUTF8(dest,text,x,y,r,g,b)
1804
- --- SDL::TTF#draw_solid_utf8(dest,text,x,y,r,g,b)
1805
- Draw text on "dest" at ("x","y"). r,g,b are color elements of text.
1806
- This function use colorkey internally.
1807
- Text must be UTF-8 (you can use ASCII code).
1808
-
1809
- --- SDL::TTF#drawBlendedUTF8(dest,text,x,y,r,g,b)
1810
- --- SDL::TTF#draw_blended_utf8(dest,text,x,y,r,g,b)
1811
- Similar to drawSolidUTF8.
1812
- More beautiful than drawSolidUTF8,but more slowly than drawSolidUTF8.
1813
-
1814
- --- SDL::TTF#drawShadedUTF8(dest,text,x,y,fg_r,fg_g,fg_b,bg_r,bg_g,bg_b)
1815
- --- SDL::TTF#draw_shaded_utf8(dest,text,x,y,fg_r,fg_g,fg_b,bg_r,bg_g,bg_b)
1816
- Similar to drawSolidUTF8.
1817
- This method is defferent from drawSolidUTF8 in that this method
1818
- fills the background of text with specified color.
1819
-
1820
- --- SDL::TTF#renderSolidUTF8(text,r,g,b)
1821
- --- SDL::TTF#render_solid_utf8(text,r,g,b)
1822
- Draws text on the new surface and returns it.
1823
- If this method fails to render, you'll get nil.
1824
- This method draws text like drawSolidUTF8.
1825
-
1826
- --- SDL::TTF#renderBlendedUTF8(text,r,g,b)
1827
- --- SDL::TTF#render_blended_utf8(text,r,g,b)
1828
- Same as ((<SDL::TTF#renderSolidUTF8>)), but this method draws
1829
- like ((<SDL::TTF#drawBlendedUTF8>)).
1830
-
1831
- --- SDL::TTF#renderShadedUTF8(text,fg_r,fg_g,fg_b,bg_r,bg_g,bg_b)
1832
- --- SDL::TTF#render_shaded_utf8(text,fg_r,fg_g,fg_b,bg_r,bg_g,bg_b)
1833
- Same as ((<SDL::TTF#renderSolidUTF8>)), but this method draws
1834
- like ((<SDL::TTF#drawShadedUTF8>)).
1835
-
1836
- == MPEG stream
1837
-
1838
- Needs SMPEG library.
1839
-
1840
- If you will play mpeg with sound, you should call ((<SDL.init>)) with
1841
- SDL::INIT_AUDIO, and call ((<SDL::Mixer.open>)).
1842
-
1843
- Don't touch the destination surface while playing mpeg, because smpeg uses
1844
- native thread.
1845
-
1846
- Don't play sound with ((<SDL::Mixer>)) when playing mpeg, because smpeg
1847
- hooks SDL_Mixer's playback functions.
1848
-
1849
- === SDL::MPEG
1850
-
1851
- This class handles MPEG stream
1852
-
1853
- ==== super class
1854
-
1855
- Object
1856
-
1857
- ==== class method
1858
-
1859
- --- SDL::MPEG.load(filename)
1860
- --- SDL::MPEG.new(filename)
1861
- Create a new SDL::MPEG object from an MPEG file.
1862
-
1863
- ==== �᥽�å�
1864
-
1865
- --- SDL::MPEG#info
1866
- Returns the current information of SDL::MPEG instance.
1867
- Return value is a instance of ((<SDL::MPEG::Info>))
1868
-
1869
- --- SDL::MPEG#enableAudio(enable)
1870
- --- SDL::MPEG#enable_audio(enable)
1871
- Enable or disable audio playback in MPEG stream.
1872
-
1873
- --- SDL::MPEG#enableVideo(enable)
1874
- --- SDL::MPEG#enable_video(enable)
1875
- Enable or disable video playback in MPEG stream.
1876
-
1877
- --- SDL::MPEG#status
1878
- Returns the current status.Returns following value.
1879
- SDL::MPEG::ERROR
1880
- SDL::MPEG::STOPPED
1881
- SDL::MPEG::PLAYING
1882
-
1883
- --- SDL::MPEG#setVolume(volume)
1884
- --- SDL::MPEG#set_volume(volume)
1885
- Set the audio volume of an MPEG stream, in the range 0-100.
1886
-
1887
- --- SDL::MPEG#setDisplay(surface)
1888
- --- SDL::MPEG#set_display(surface)
1889
- Set the destination surface for MPEG video playback.
1890
-
1891
- --- SDL::MPEG#setLoop(repeat)
1892
- --- SDL::MPEG#set_loop(repeat)
1893
- Set or clear looping play.
1894
-
1895
- --- SDL::MPEG#scaleXY(w,h)
1896
- --- SDL::MPEG#scale_xy(w,h)
1897
- Scale pixel display.
1898
-
1899
- --- SDL::MPEG#scale(scale)
1900
- Scale pixel display.
1901
-
1902
- --- SDL::MPEG#move(x,y)
1903
- Move the video display area within the destination surface.
1904
-
1905
- --- SDL::MPEG#setDisplayRegion(x,y,w,h)
1906
- --- SDL::MPEG#set_display_region(x,y,w,h)
1907
- Set the region of the video to be shown.
1908
-
1909
- --- SDL::MPEG#play
1910
- Play an MPEG stream.
1911
-
1912
- Warning: Don't access the surface while playing.
1913
-
1914
- --- SDL::MPEG#pause
1915
- Pause/Resume playback.
1916
-
1917
- --- SDL::MPEG#stop
1918
- Stop playback.
1919
-
1920
- --- SDL::MPEG#rewind
1921
- Rewind the play position of MPEG stream to the begining of the MPEG.
1922
-
1923
- --- SDL::MPEG#seek(bytes)
1924
- Seek 'bytes' bytes in the MPEG stream.
1925
-
1926
- --- SDL::MPEG#skip(seconds)
1927
- Skip 'seconds' seconds in the MPEG stream.
1928
-
1929
- --- SDL::MPEG#renderFrame(framenum)
1930
- --- SDL::MPEG#render_frame(framenum)
1931
- Render a particular frame in the MPEG video.
1932
-
1933
- --- SDL::MPEG#setFilter(filter)
1934
- --- SDL::MPEG#set_filter(filter)
1935
- Set video filter. Available filter is following.
1936
- SDL::MPEG::NULL_FILTER No filter
1937
- SDL::MPEG::BILINEAR_FILTER Bilinear filter
1938
- SDL::MPEG::DEBLOCKING_FILTER Deblocking filter
1939
-
1940
- === SDL::MPEG::Info
1941
-
1942
- The instance of this class has the information of ((<SDL::MPEG>)).
1943
- Get that with ((<SDL::MPEG#info>)).
1944
-
1945
- ==== super class
1946
-
1947
- Object
1948
-
1949
- ==== method
1950
-
1951
- --- SDL::MPEG::Info#has_audio
1952
- --- SDL::MPEG::Info#has_video
1953
- --- SDL::MPEG::Info#width
1954
- --- SDL::MPEG::Info#height
1955
- --- SDL::MPEG::Info#current_frame
1956
- --- SDL::MPEG::Info#current_fps
1957
- --- SDL::MPEG::Info#audio_string
1958
- --- SDL::MPEG::Info#audio_current_frame
1959
- --- SDL::MPEG::Info#current_offset
1960
- --- SDL::MPEG::Info#total_size
1961
- --- SDL::MPEG::Info#current_time
1962
- --- SDL::MPEG::Info#total_time
1963
-
1964
- == Time
1965
-
1966
- === module function
1967
-
1968
- --- SDL.getTicks
1969
- --- SDL.get_ticks
1970
- Get the number of milliseconds since the SDL library initialization.
1971
- Note that this value wraps if the program runs for more than ~49 days.
1972
-
1973
- --- SDL.delay(ms)
1974
- Wait a specified number of milliseconds before returning. this
1975
- function will wait at least the specified time, but possible
1976
- longer due to OS scheduling.
1977
-
1978
- == Japanese input method with SDLSKK
1979
-
1980
- Needs SDLSKK library.
1981
-
1982
- You need calling ((<SDL::Event2.enableUNICODE>)) after calling ((<SDL.init>))
1983
- to use SDLSKK.
1984
-
1985
- === module function
1986
-
1987
- --- SDL::SKK.encoding=(encoding)
1988
- Set encoding of SDLSKK.
1989
- * SDL::SKK::EUCJP
1990
- * SDL::SKK::UTF8
1991
- * SDL::SKK::SJIS
1992
-
1993
- --- SDL::SKK.encoding
1994
- Return encoding.
1995
-
1996
- === SDL::SKK::Context
1997
-
1998
- This class represents the state of input.
1999
-
2000
- ==== super class
2001
-
2002
- Object
2003
-
2004
- ==== class method
2005
-
2006
- --- SDL::SKK::Context.new(dict,romkana_table,keybind,use_minibuffer)
2007
- Create an instance of ((<SDL::SKK::Context>)) from the dictionary,
2008
- the keybind and the RomKanaRuleTable. And if use_minibuffer is true, you
2009
- can use minibuffer.
2010
-
2011
- ==== method
2012
-
2013
- --- SDL::SKK::Context#input(event)
2014
- Inputs from keyboard thorough event object.
2015
-
2016
- --- SDL::SKK::Context#str
2017
- Returns input (Japanese) string.
2018
-
2019
- --- SDL::SKK::Context#render_str(font,r,g,b)
2020
- Renders the text.
2021
-
2022
- --- SDL::SKK::Context#render_minibuffer_str(font,r,g,b)
2023
- Renders minibuffer text.
2024
-
2025
- --- SDL::SKK::Context#clear
2026
- Clears text and initializes context.
2027
-
2028
- --- SDL::SKK::Context#get_basic_mode
2029
- Returns whether context's state is basic mode.
2030
-
2031
- If this method returns true, and you get return, you can
2032
- stop inputting.
2033
-
2034
-
2035
- === SDL::SKK::Dictionary
2036
-
2037
- ==== super class
2038
-
2039
- Object
2040
-
2041
- ==== class method
2042
-
2043
- --- SDL::SKK::Dictionary.new
2044
- Creates the instance of ((<SDL::SKK::Dictionary>)).
2045
- The content of that is empty just after creating.
2046
-
2047
- ==== method
2048
-
2049
- --- SDL::SKK::Dictionary#load(dictfile,users)
2050
- Load dictionary from file.
2051
- If users is true, then this method regards it as user's dictionary.
2052
-
2053
- --- SDL::SKK::Dictionary#save(filename)
2054
- Save user's dictionary.
2055
-
2056
- === SDL::SKK::RomKanaRuleTable
2057
-
2058
- This class represents the rule of conversion from Alphabet to Japanese kana.
2059
-
2060
- ==== super class
2061
-
2062
- Object
2063
-
2064
- ==== class method
2065
-
2066
- --- SDL::SKK::RomKanaRuleTable.new(table_file)
2067
- Create the instance of ((<SDL::SKK::RomKanaRuleTable>)) from rule file.
2068
-
2069
- ==== method
2070
-
2071
- === SDL::SKK::Keybind
2072
-
2073
- This class represents the keybind in SDLSKK input system.
2074
-
2075
- ==== super class
2076
-
2077
- Object
2078
-
2079
- ==== class method
2080
-
2081
- --- SDL::SKK::Keybind.new
2082
- Create the instance of ((<SDL::SKK::Keybind>)) without any keybind.
2083
-
2084
- ==== method
2085
-
2086
- --- SDL::SKK::Keybind#set_key(key_str,cmd_str)
2087
- Set keybind.
2088
-
2089
- You can use following string as ((|key_str|)).
2090
- * alphabet and other ascii character
2091
- * "SPC" "TAB" "DEL" "RET" "UP" "DOWN" "RIGHT" "LEFT" "INSERT" "HOME" "END"
2092
- "PAGEUP" "PAGEDOWN" "F1" "F2" "F3" "F4" "F5" "F6" "F7" "F8" "F9" "F10"
2093
- "F11" "F12" "F13" "F14" "F15" "HELP"
2094
- * Modified key like "C-a" or "M-C-a"
2095
-
2096
- And you can following as ((|cmd_str|))
2097
- * "backward-char",
2098
- * "forward-char",
2099
- * "backward-delete-char",
2100
- * "delete-char",
2101
- * "kakutei",
2102
- * "kettei",
2103
- * "space",
2104
- * "keyboard-quit",
2105
- * "set-mark-command",
2106
- * "kill-region",
2107
- * "yank",
2108
- * "copy",
2109
- * "graph-char",
2110
- * "upper-char",
2111
- * "lower-char",
2112
- * "abbrev-input",
2113
- * "latin-mode",
2114
- * "previous-candidate",
2115
- * "jisx0208-mode",
2116
- * "toggle-kana",
2117
- * "beginning-of-line"
2118
- * "end-of-line"
2119
- * "do-nothing"
2120
-
2121
- You should not set any command on one ascii character like "a" or "/".
2122
-
2123
- --- SDL::SKK::Keybind#set_default_key
2124
- Set default keybind. You should call this method immediately after
2125
- call ((<SDL::SKK::Keybind.new>))
2126
-
2127
- --- SDL::SKK::Keybind#unset_key(key_str)
2128
- Unset keybind.
2129
-
2130
- == 3D drawing with OpenGL
2131
- You can draw 3D graphics with OpenGL.
2132
-
2133
- How to use OpenGL.
2134
- (1) require 'sdl'; require 'opengl'
2135
- (2) Call ((<SDL.init>)) with SDL::INIT_VIDEO
2136
- (3) Set attribute of OpenGL, please use ((<SDL.setGLAttr>))
2137
- (4) Call ((<SDL.setVideoMode>)) with SDL::OPENGL
2138
- (5) Use GL module methods to draw
2139
- (6) Call ((<SDL.GLSwapBuffersn>)) instead of ((<SDL.flip>)) to update screen
2140
-
2141
- Please see sample/opengl.rb .
2142
-
2143
- === module function
2144
- --- SDL.setGLAttr(attr,val)
2145
- --- SDL.set_GL_attr(attr,val)
2146
- Set the value of special SDL/OpenGL attribute.
2147
-
2148
- List of attribute:
2149
- * SDL::GL_RED_SIZE
2150
- * SDL::GL_GREEN_SIZE
2151
- * SDL::GL_BLUE_SIZE
2152
- * SDL::GL_ALPHA_SIZE
2153
- * SDL::GL_BUFFER_SIZE
2154
- * SDL::GL_DOUBLEBUFFER
2155
- * SDL::GL_DEPTH_SIZE
2156
- * SDL::GL_STENCIL_SIZE
2157
- * SDL::GL_ACCUM_RED_SIZE
2158
- * SDL::GL_ACCUM_GREEN_SIZE
2159
- * SDL::GL_ACCUM_BLUE_SIZE
2160
- * SDL::GL_ACCUM_ALPHA_SIZE
2161
-
2162
- --- SDL.getGLAttr(attr)
2163
- --- SDL.get_GL_attr(attr)
2164
- Get the value of special SDL/OpenGL attribute.
2165
-
2166
- --- SDL.GLSwapBuffers
2167
- --- SDL.GL_swap_buffers
2168
- Swap the OpenGL buffers, update display, if double-buffering is supported.
2169
-
2170
- == Others
2171
- === Avoid pthread problem
2172
- You can possibly avoid Ruby/SDL pthread problem when you put following
2173
- in your script.
2174
- require 'rbconfig'
2175
-
2176
- if RUBY_PLATFORM =~ /linux/
2177
- trap('INT','EXIT')
2178
- trap('EXIT','EXIT')
2179
- end
2180
-
2181
- =end