Module: MiniGL::Res
- Defined in:
- lib/minigl/global.rb
Overview
This class is responsible for resource management. It keeps references to all loaded resources until a call to clear
is made. Resources can be loaded as global, so that their references won’t be removed even when clear
is called.
It also provides an easier syntax for loading resources, assuming a particular folder structure. All resources must be inside subdirectories of a ‘data’ directory, so that you will only need to specify the type of resource being loaded and the file name (either as string or as symbol). There are default extensions for each type of resource, so the extension must be specified only if the file is in a format other than the default.
Class Attribute Summary collapse
-
.font_dir ⇒ Object
Gets the current path to font files (under
prefix
). -
.img_dir ⇒ Object
Gets the current path to image files (under
prefix
). -
.prefix ⇒ Object
Get the current prefix for searching data files.
-
.retro_images ⇒ Object
Gets or sets a flag that indicates whether images will be loaded with the ‘retro’ option set (see
Gosu::Image
for details), when this option is not specified in a ‘Res.img’ or ‘Res.imgs’ call. -
.separator ⇒ Object
Gets or sets the character that is currently being used in the
id
parameter of the loading methods as a folder separator. -
.song_dir ⇒ Object
Gets the current path to song files (under
prefix
). -
.sound_dir ⇒ Object
Gets the current path to sound files (under
prefix
). -
.tileset_dir ⇒ Object
Gets the current path to tileset files (under
prefix
).
Class Method Summary collapse
-
.clear ⇒ Object
Releases the memory used by all non-global resources.
-
.font(id, size, global = true, ext = '.ttf') ⇒ Object
Returns a
Gosu::Font
object. -
.img(id, global = false, tileable = false, ext = '.png', retro = nil) ⇒ Object
Returns a
Gosu::Image
object. -
.imgs(id, sprite_cols, sprite_rows, global = false, ext = '.png', retro = nil, tileable = false) ⇒ Object
Returns an array of
Gosu::Image
objects, using the image as a spritesheet. -
.initialize ⇒ Object
This is called by
GameWindow.initialize
. -
.song(id, global = false, ext = '.ogg') ⇒ Object
Returns a
Gosu::Song
object. -
.sound(id, global = false, ext = '.wav') ⇒ Object
Returns a
Gosu::Sample
object. -
.tileset(id, tile_width = 32, tile_height = 32, global = false, ext = '.png', retro = nil) ⇒ Object
Returns an array of
Gosu::Image
objects, using the image as a tileset.
Class Attribute Details
.font_dir ⇒ Object
Gets the current path to font files (under prefix
). Default is ‘font’.
511 512 513 |
# File 'lib/minigl/global.rb', line 511 def font_dir @font_dir end |
.img_dir ⇒ Object
Gets the current path to image files (under prefix
). Default is ‘img’.
498 499 500 |
# File 'lib/minigl/global.rb', line 498 def img_dir @img_dir end |
.prefix ⇒ Object
Get the current prefix for searching data files. This is the directory under which ‘img’, ‘sound’, ‘song’, etc. folders are located.
495 496 497 |
# File 'lib/minigl/global.rb', line 495 def prefix @prefix end |
.retro_images ⇒ Object
Gets or sets a flag that indicates whether images will be loaded with the ‘retro’ option set (see Gosu::Image
for details), when this option is not specified in a ‘Res.img’ or ‘Res.imgs’ call.
524 525 526 |
# File 'lib/minigl/global.rb', line 524 def retro_images @retro_images end |
.separator ⇒ Object
Gets or sets the character that is currently being used in the id
parameter of the loading methods as a folder separator. Default is ‘_’. Note that if you want to use symbols to specify paths, this separator should be a valid character in a Ruby symbol. On the other hand, if you want to use only slashes in Strings, you can specify a ‘weird’ character that won’t appear in any file name.
519 520 521 |
# File 'lib/minigl/global.rb', line 519 def separator @separator end |
.song_dir ⇒ Object
Gets the current path to song files (under prefix
). Default is ‘song’.
508 509 510 |
# File 'lib/minigl/global.rb', line 508 def song_dir @song_dir end |
.sound_dir ⇒ Object
Gets the current path to sound files (under prefix
). Default is ‘sound’.
505 506 507 |
# File 'lib/minigl/global.rb', line 505 def sound_dir @sound_dir end |
.tileset_dir ⇒ Object
Gets the current path to tileset files (under prefix
). Default is ‘tileset’.
502 503 504 |
# File 'lib/minigl/global.rb', line 502 def tileset_dir @tileset_dir end |
Class Method Details
.clear ⇒ Object
Releases the memory used by all non-global resources.
738 739 740 741 742 743 744 |
# File 'lib/minigl/global.rb', line 738 def clear @imgs.clear @tilesets.clear @sounds.clear @songs.clear @fonts.clear end |
.font(id, size, global = true, ext = '.ttf') ⇒ Object
Returns a Gosu::Font
object. Fonts are needed to draw text and used by MiniGL elements like buttons, text fields and TextHelper objects.
Parameters:
- id
-
A string or symbol representing the path to the song. It must be specified the same way as in
img
, but the base directory isprefix
/font_dir
. - size
-
The size of the font, in pixels. This will correspond, approximately, to the height of the tallest character when drawn.
- global
-
Set to true if you want to keep the font in memory until the game execution is finished. If false, the font will be released when you call
clear
. - ext
-
The extension of the file being loaded. Specify only if it is other than “.ttf”.
728 729 730 731 732 733 734 735 |
# File 'lib/minigl/global.rb', line 728 def font(id, size, global = true, ext = '.ttf') a = global ? @global_fonts : @fonts id_size = "#{id}_#{size}" return a[id_size] if a[id_size] s = @prefix + @font_dir + id.to_s.split(@separator).join('/') + ext font = Gosu::Font.new size, name: s a[id_size] = font end |
.img(id, global = false, tileable = false, ext = '.png', retro = nil) ⇒ Object
Returns a Gosu::Image
object.
Parameters:
- id
-
A string or symbol representing the path to the image. If the file is inside
prefix
/img_dir
, only the file name is needed. If it’s inside a subdirectory ofprefix
/img_dir
, the id must be prefixed by each subdirectory name followed byseparator
. Example: to load ‘data/img/sprite/1.png’, with the default values ofprefix
,img_dir
andseparator
, provide:sprite_1
or “sprite_1”. - global
-
Set to true if you want to keep the image in memory until the game execution is finished. If false, the image will be released when you call
clear
. - tileable
-
Whether the image should be loaded in tileable mode, which is proper for images that will be used as a tile, i.e., that will be drawn repeated times, side by side, forming a continuous composition.
- ext
-
The extension of the file being loaded. Specify only if it is other than ‘.png’.
- retro
-
Whether the image should be loaded with the ‘retro’ option set (see
Gosu::Image
for details). If the value is omitted, theRes.retro_images
value will be used.
609 610 611 612 613 614 615 616 |
# File 'lib/minigl/global.rb', line 609 def img(id, global = false, tileable = false, ext = '.png', retro = nil) a = global ? @global_imgs : @imgs return a[id] if a[id] s = @prefix + @img_dir + id.to_s.split(@separator).join('/') + ext retro = Res.retro_images if retro.nil? img = Gosu::Image.new s, tileable: tileable, retro: retro a[id] = img end |
.imgs(id, sprite_cols, sprite_rows, global = false, ext = '.png', retro = nil, tileable = false) ⇒ Object
Returns an array of Gosu::Image
objects, using the image as a spritesheet. The image with index 0 will be the top left sprite, and the following indices raise first from left to right and then from top to bottom.
Parameters:
- id
-
A string or symbol representing the path to the image. See
img
for details. - sprite_cols
-
Number of columns in the spritesheet.
- sprite_rows
-
Number of rows in the spritesheet.
- global
-
Set to true if you want to keep the image in memory until the game execution is finished. If false, the image will be released when you call
clear
. - ext
-
The extension of the file being loaded. Specify only if it is other than “.png”.
- retro
-
Whether the image should be loaded with the ‘retro’ option set (see
Gosu::Image
for details). If the value is omitted, theRes.retro_images
value will be used.
636 637 638 639 640 641 642 643 |
# File 'lib/minigl/global.rb', line 636 def imgs(id, sprite_cols, sprite_rows, global = false, ext = '.png', retro = nil, tileable = false) a = global ? @global_imgs : @imgs return a[id] if a[id] s = @prefix + @img_dir + id.to_s.split(@separator).join('/') + ext retro = Res.retro_images if retro.nil? imgs = Gosu::Image.load_tiles s, -sprite_cols, -sprite_rows, tileable: tileable, retro: retro a[id] = imgs end |
.initialize ⇒ Object
This is called by GameWindow.initialize
. Don’t call it explicitly.
528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 |
# File 'lib/minigl/global.rb', line 528 def initialize @imgs = {} @global_imgs = {} @tilesets = {} @global_tilesets = {} @sounds = {} @global_sounds = {} @songs = {} @global_songs = {} @fonts = {} @global_fonts = {} @prefix = File.(File.dirname($0)) + '/data/' @img_dir = 'img/' @tileset_dir = 'tileset/' @sound_dir = 'sound/' @song_dir = 'song/' @font_dir = 'font/' @separator = '_' @retro_images = false end |
.song(id, global = false, ext = '.ogg') ⇒ Object
Returns a Gosu::Song
object. This should be used for the background musics of your game.
Parameters:
- id
-
A string or symbol representing the path to the song. It must be specified the same way as in
img
, but the base directory isprefix
/song_dir
. - global
-
Set to true if you want to keep the song in memory until the game execution is finished. If false, the song will be released when you call
clear
. - ext
-
The extension of the file being loaded. Specify only if it is other than “.ogg”.
705 706 707 708 709 710 711 |
# File 'lib/minigl/global.rb', line 705 def song(id, global = false, ext = '.ogg') a = global ? @global_songs : @songs return a[id] if a[id] s = @prefix + @song_dir + id.to_s.split(@separator).join('/') + ext song = Gosu::Song.new s a[id] = song end |
.sound(id, global = false, ext = '.wav') ⇒ Object
Returns a Gosu::Sample
object. This should be used for simple and short sound effects.
Parameters:
- id
-
A string or symbol representing the path to the sound. It must be specified the same way as in
img
, but the base directory isprefix
/sound_dir
. - global
-
Set to true if you want to keep the sound in memory until the game execution is finished. If false, the sound will be released when you call
clear
. - ext
-
The extension of the file being loaded. Specify only if it is other than “.wav”.
685 686 687 688 689 690 691 |
# File 'lib/minigl/global.rb', line 685 def sound(id, global = false, ext = '.wav') a = global ? @global_sounds : @sounds return a[id] if a[id] s = @prefix + @sound_dir + id.to_s.split(@separator).join('/') + ext sound = Gosu::Sample.new s a[id] = sound end |
.tileset(id, tile_width = 32, tile_height = 32, global = false, ext = '.png', retro = nil) ⇒ Object
Returns an array of Gosu::Image
objects, using the image as a tileset. Works the same as imgs
, except you must provide the tile size instead of the number of columns and rows, and that the images will be loaded as tileable.
Parameters:
- id
-
A string or symbol representing the path to the image. It must be specified the same way as in
img
, but the base directory isprefix
/tileset_dir
. - tile_width
-
Width of each tile, in pixels.
- tile_height
-
Height of each tile, in pixels.
- global
-
Set to true if you want to keep the image in memory until the game execution is finished. If false, the image will be released when you call
clear
. - ext
-
The extension of the file being loaded. Specify only if it is other than “.png”.
- retro
-
Whether the image should be loaded with the ‘retro’ option set (see
Gosu::Image
for details). If the value is omitted, theRes.retro_images
value will be used.
664 665 666 667 668 669 670 671 |
# File 'lib/minigl/global.rb', line 664 def tileset(id, tile_width = 32, tile_height = 32, global = false, ext = '.png', retro = nil) a = global ? @global_tilesets : @tilesets return a[id] if a[id] s = @prefix + @tileset_dir + id.to_s.split(@separator).join('/') + ext retro = Res.retro_images if retro.nil? tileset = Gosu::Image.load_tiles s, tile_width, tile_height, tileable: true, retro: retro a[id] = tileset end |