allegro4r 0.0.1-x86-mswin32-60

data/ext/a4r_API_JOYSTICK_STICK_INFO.c

@@ -0,0 +1,62 @@
+#include "allegro4r.h"
+
+/*
+ * call-seq:
+ *   jsi.flags -> int
+ *
+ * Status flags for this input
+ */
+VALUE a4r_API_JOYSTICK_STICK_INFO_flags(VALUE self)
+{
+  JOYSTICK_STICK_INFO *jsi;
+  Data_Get_Struct(self, JOYSTICK_STICK_INFO, jsi);
+  return INT2NUM(jsi->flags);
+}
+
+/*
+ * call-seq:
+ *   jsi.num_axis -> int
+ *
+ * How many axes do we have? (note the misspelling)
+ */
+VALUE a4r_API_JOYSTICK_STICK_INFO_num_axis(VALUE self)
+{
+  JOYSTICK_STICK_INFO *jsi;
+  Data_Get_Struct(self, JOYSTICK_STICK_INFO, jsi);
+  return INT2FIX(jsi->num_axis);
+}
+
+/*
+ * call-seq:
+ *   jsi.axis -> ary
+ *
+ * Axis state information
+ */
+VALUE a4r_API_JOYSTICK_STICK_INFO_axis(VALUE self)
+{
+  JOYSTICK_STICK_INFO *jsi;
+  Data_Get_Struct(self, JOYSTICK_STICK_INFO, jsi);
+
+  VALUE ret = rb_ary_new2(jsi->num_axis);
+  long x;
+  for (x = 0; x < jsi->num_axis; x++)
+  {
+    VALUE obj = Data_Wrap_Struct(cAPI_JOYSTICK_AXIS_INFO, 0, 0, &(jsi->axis[x]));
+    rb_ary_store(ret, x, obj);
+  }
+
+  return ret;
+}
+
+/*
+ * call-seq:
+ *   jsi.name -> str
+ *
+ * Description of this input
+ */
+VALUE a4r_API_JOYSTICK_STICK_INFO_name(VALUE self)
+{
+  JOYSTICK_STICK_INFO *jsi;
+  Data_Get_Struct(self, JOYSTICK_STICK_INFO, jsi);
+  return rb_str_new2(jsi->name);
+}

data/ext/a4r_API_KEYBOARD_DRIVER.c

@@ -0,0 +1,14 @@
+#include "allegro4r.h"
+
+/*
+ * call-seq:
+ *   driver.name -> str
+ *
+ * Returns the name of the keyboard driver.
+ */
+VALUE a4r_API_KEYBOARD_DRIVER_name_get(VALUE self)
+{
+  KEYBOARD_DRIVER *driver;
+  Data_Get_Struct(self, KEYBOARD_DRIVER, driver);
+  return rb_str_new2(driver->name);
+}

data/ext/a4r_API_MIDI_DRIVER.c

@@ -0,0 +1,14 @@
+#include "allegro4r.h"
+
+/*
+ * call-seq:
+ *   driver.name -> str
+ *
+ * Driver name
+ */
+VALUE a4r_API_MIDI_DRIVER_name_get(VALUE self)
+{
+  MIDI_DRIVER *driver;
+  Data_Get_Struct(self, MIDI_DRIVER, driver);
+  return rb_str_new2(driver->name);
+}

data/ext/a4r_API_MOUSE_DRIVER.c

@@ -0,0 +1,14 @@
+#include "allegro4r.h"
+
+/*
+ * call-seq:
+ *   driver.name -> str
+ *
+ * Returns the name of the mouse driver.
+ */
+VALUE a4r_API_MOUSE_DRIVER_name_get(VALUE self)
+{
+  MOUSE_DRIVER *driver;
+  Data_Get_Struct(self, MOUSE_DRIVER, driver);
+  return rb_str_new2(driver->name);
+}

data/ext/a4r_API_PALETTE.c

@@ -0,0 +1,63 @@
+#include "allegro4r.h"
+
+void a4r_API_PALETTE_free(void *palette)
+{
+  free((PALETTE*)palette);
+}
+
+/* :nodoc: */
+VALUE a4r_API_PALETTE_alloc(VALUE klass)
+{
+  PALETTE *palette;
+  VALUE obj = Data_Make_Struct(klass, PALETTE, 0, a4r_API_PALETTE_free, palette);
+  return obj;
+}
+
+/* :nodoc: */
+VALUE a4r_API_PALETTE_initialize_copy(VALUE copy, VALUE orig)
+{
+  if (copy == orig)
+    return copy;
+
+  if (TYPE(orig) != T_DATA || RDATA(orig)->dfree != (RUBY_DATA_FUNC)a4r_API_PALETTE_free)
+    rb_raise(rb_eTypeError, "wrong argument type");
+
+  PALETTE *orig_pal, *copy_pal;
+  Data_Get_Struct(orig, PALETTE, orig_pal);
+  Data_Get_Struct(copy, PALETTE, copy_pal);
+  MEMCPY(copy_pal, orig_pal, PALETTE, 1);
+  return copy;
+}
+
+/*
+ * call-seq:
+ *   palette[index] -> an_rgb
+ *
+ * Returns the RGB element at the specified index.
+ */
+VALUE a4r_API_PALETTE_getter(VALUE self, VALUE index)
+{
+  // TODO: Index validation && converting to "array" of RGBs
+  PALETTE *palette;
+  Data_Get_Struct(self, PALETTE, palette);
+  RGB *rgb = &((*palette)[FIX2INT(index)]);
+  VALUE obj = Data_Wrap_Struct(cAPI_RGB, 0, 0, rgb);
+  return obj;
+}
+
+/*
+ * call-seq:
+ *   palette[index] = an_rgb -> an_rgb
+ *
+ * Sets the element at index to the specified RGB element.
+ */
+VALUE a4r_API_PALETTE_setter(VALUE self, VALUE index, VALUE val)
+{
+  // TODO: Index validation, val validation && converting to "array" of RGBs
+  PALETTE *palette;
+  Data_Get_Struct(self, PALETTE, palette);
+  RGB *rgb;
+  Data_Get_Struct(val, RGB, rgb);
+  (*palette)[FIX2INT(index)] = *rgb;
+  return val;
+}

data/ext/a4r_API_RGB.c

@@ -0,0 +1,118 @@
+#include "allegro4r.h"
+
+void a4r_API_RGB_free(void *rgb)
+{
+  free((RGB*)rgb);
+}
+
+/* :nodoc: */
+VALUE a4r_API_RGB_alloc(VALUE klass)
+{
+  RGB *rgb;
+  VALUE obj = Data_Make_Struct(klass, RGB, 0, a4r_API_RGB_free, rgb);
+  return obj;
+}
+
+/* :nodoc: */
+VALUE a4r_API_RGB_initialize_copy(VALUE copy, VALUE orig)
+{
+  if (copy == orig)
+    return copy;
+
+  // TODO: Bring back this check.  We do Data_Wrap_Structs in other places,
+  //   which is causing this to have two structs with different free methods
+/*
+  if (TYPE(orig) != T_DATA || RDATA(orig)->dfree != (RUBY_DATA_FUNC)a4r_API_RGB_free)
+    rb_raise(rb_eTypeError, "wrong argument type");
+*/
+
+  RGB *orig_rgb, *copy_rgb;
+  Data_Get_Struct(orig, RGB, orig_rgb);
+  Data_Get_Struct(copy, RGB, copy_rgb);
+  MEMCPY(copy_rgb, orig_rgb, RGB, 1);
+  return copy;
+}
+
+/*
+ * call-seq:
+ *   rgb.r -> int
+ *
+ * Returns the red value of the RGB.
+ */
+VALUE a4r_API_RGB_r_get(VALUE self)
+{
+  RGB *rgb;
+  Data_Get_Struct(self, RGB, rgb);
+  return CHR2FIX(rgb->r);
+}
+
+/*
+ * call-seq:
+ *   rgb.r = int -> int
+ *
+ * Sets the red value of the RGB.  The value must be in the range 0-255.
+ */
+VALUE a4r_API_RGB_r_set(VALUE self, VALUE val)
+{
+  // TODO: val validation
+  RGB *rgb;
+  Data_Get_Struct(self, RGB, rgb);
+  rgb->r = NUM2CHR(val);
+  return val;
+}
+
+/*
+ * call-seq:
+ *   rgb.g -> int
+ *
+ * Returns the green value of the RGB.
+ */
+VALUE a4r_API_RGB_g_get(VALUE self)
+{
+  RGB *rgb;
+  Data_Get_Struct(self, RGB, rgb);
+  return CHR2FIX(rgb->g);
+}
+
+/*
+ * call-seq:
+ *   rgb.g = int -> int
+ *
+ * Sets the green value of the RGB.  The value must be in the range 0-255.
+ */
+VALUE a4r_API_RGB_g_set(VALUE self, VALUE val)
+{
+  // TODO: val validation
+  RGB *rgb;
+  Data_Get_Struct(self, RGB, rgb);
+  rgb->g = NUM2CHR(val);
+  return val;
+}
+
+/*
+ * call-seq:
+ *   rgb.b -> int
+ *
+ * Returns the blue value of the RGB.
+ */
+VALUE a4r_API_RGB_b_get(VALUE self)
+{
+  RGB *rgb;
+  Data_Get_Struct(self, RGB, rgb);
+  return CHR2FIX(rgb->b);
+}
+
+/*
+ * call-seq:
+ *   rgb.b = int -> int
+ *
+ * Sets the blue value of the RGB.  The value must be in the range 0-255.
+ */
+VALUE a4r_API_RGB_b_set(VALUE self, VALUE val)
+{
+  // TODO: val validation
+  RGB *rgb;
+  Data_Get_Struct(self, RGB, rgb);
+  rgb->b = NUM2CHR(val);
+  return val;
+}

data/ext/a4r_API_TIMER_DRIVER.c

@@ -0,0 +1,14 @@
+#include "allegro4r.h"
+
+/*
+ * call-seq:
+ *   driver.name -> str
+ *
+ * Returns the name of the timer driver.
+ */
+VALUE a4r_API_TIMER_DRIVER_name_get(VALUE self)
+{
+  TIMER_DRIVER *driver;
+  Data_Get_Struct(self, TIMER_DRIVER, driver);
+  return rb_str_new2(driver->name);
+}

data/ext/a4r_API_bitmap_objects.c

@@ -0,0 +1,310 @@
+#include "allegro4r.h"
+
+/*
+ * call-seq:
+ *   screen -> a_bmp
+ *
+ * Global reference to a bitmap, sized VIRTUAL_W x VIRTUAL_H. This is created by
+ * set_gfx_mode, and represents the hardware video memory. Only a part of this
+ * bitmap will actually be visible, sized SCREEN_W x SCREEN_H. Normally this is
+ * the top left corner of the larger virtual screen, so you can ignore the extra
+ * invisible virtual size of the bitmap if you aren't interested in hardware
+ * scrolling or page flipping. To move the visible window to other parts of the
+ * screen bitmap, call scroll_screen. Initially the clipping rectangle will be
+ * limited to the physical screen size, so if you want to draw onto a larger
+ * virtual screen space outside this rectangle, you will need to adjust the
+ * clipping.
+ *
+ * For example, to draw a pixel onto the screen you would write:
+ *   putpixel(screen, x, y, color)
+ *
+ * Or to implement a double-buffered system:
+ *   # Make a bitmap in RAM.
+ *   bmp = create_bitmap(320, 200)
+ *   # Clean the memory bitmap.
+ *   clear_bitmap(bmp)
+ *   # Draw onto the memory bitmap.
+ *   putpixel(bmp, x, y, color)
+ *   # Copy it to the screen.
+ *   blit(bmp, screen, 0, 0, 0, 0, 320, 200)
+ *
+ * Warning: be very careful when using this reference at the same time as any
+ * bitmaps created by the create_video_bitmap function (see the description of
+ * this function for more detailed information). And never try to destroy it
+ * with destroy_bitmap.
+ */
+VALUE a4r_API_screen(VALUE self)
+{
+  // TODO: Convert to data struct or cached or hooked variable?
+  BITMAP *bmp = screen;
+  VALUE obj = Data_Wrap_Struct(cAPI_BITMAP, 0, 0, bmp);
+  return obj;
+}
+
+/*
+ * call-seq:
+ *   SCREEN_W -> int
+ *
+ * Global defines that return the width and height of the screen, or zero if the
+ * screen has not been initialised yet. Example:
+ *   buf = "\0" * 100
+ *   uszprintf(buf, buf.length, "The screen size is %d x %d pixels" %
+ *     [SCREEN_W, SCREEN_H])
+ */
+VALUE a4r_API_SCREEN_W(VALUE self)
+{
+  // TODO: Convert to hooked or virtual variable?
+  return INT2FIX(SCREEN_W);
+}
+
+/*
+ * call-seq:
+ *   SCREEN_H -> int
+ *
+ * See SCREEN_W.
+ */
+VALUE a4r_API_SCREEN_H(VALUE self)
+{
+  // TODO: Convert to hooked or virtual variable?
+  return INT2FIX(SCREEN_H);
+}
+
+/*
+ * call-seq:
+ *   create_bitmap(width, height) -> a_bmp or nil
+ *
+ * Creates a memory bitmap sized width by height. The bitmap will have clipping
+ * turned on, and the clipping rectangle set to the full size of the bitmap. The
+ * image memory will not be cleared, so it will probably contain garbage: you
+ * should clear the bitmap before using it. This routine always uses the global
+ * pixel format, as specified by calling set_color_depth. The minimum height of
+ * the BITMAP must be 1 and width can't be negative. Example:
+ *   # Create a 10 pixel tall bitmap, as wide as the screen.
+ *   bmp = create_bitmap(SCREEN_W, 10)
+ *   abort_on_error("Couldn't create bitmap!") if bmp.nil?
+ *   # Use the bitmap.
+ *   ...
+ *   # Destroy it when we don't need it any more.
+ *   destroy_bitmap(bmp)
+ *
+ * Return value: Returns a reference to the created bitmap, or nil if the bitmap
+ * could not be created. Remember to free this bitmap later to avoid memory
+ * leaks.
+ */
+VALUE a4r_API_create_bitmap(VALUE self, VALUE width, VALUE height)
+{
+  // TODO: Change to call destroy_bitmap on free?
+  BITMAP *bmp = create_bitmap(FIX2INT(width), FIX2INT(height));
+  if (bmp == NULL)
+    return Qnil;
+  VALUE obj = Data_Wrap_Struct(cAPI_BITMAP, 0, 0, bmp);
+  return obj;
+}
+
+/*
+ * call-seq:
+ *   create_sub_bitmap(parent, x, y, width, height) -> a_bmp or nil
+ *
+ * Creates a sub-bitmap, ie. a bitmap sharing drawing memory with a pre-existing
+ * bitmap, but possibly with a different size and clipping settings. When
+ * creating a sub-bitmap of the mode-X screen, the x position must be a multiple
+ * of four. The sub-bitmap width and height can extend beyond the right and
+ * bottom edges of the parent (they will be clipped), but the origin point must
+ * lie within the parent region.
+ *
+ * Return value: Returns a reference to the created sub bitmap, or nil if the
+ * sub bitmap could not be created. Remember to free the sub bitmap before
+ * freeing the parent bitmap to avoid memory leaks and potential crashes
+ * accessing memory which has been freed.
+ */
+VALUE a4r_API_create_sub_bitmap(VALUE self, VALUE parent, VALUE x, VALUE y, VALUE width, VALUE height)
+{
+  BITMAP *bmp;
+  Data_Get_Struct(parent, BITMAP, bmp);
+  BITMAP *ret = create_sub_bitmap(bmp, FIX2INT(x), FIX2INT(y), FIX2INT(width), FIX2INT(height));
+  if (ret == NULL)
+    return Qnil;
+  VALUE obj = Data_Wrap_Struct(cAPI_BITMAP, 0, 0, ret);
+  return obj;
+}
+
+/*
+ * call-seq:
+ *   create_video_bitmap(width, height) -> a_bmp or nil
+ *
+ * Allocates a video memory bitmap of the specified size. This can be used to
+ * allocate offscreen video memory for storing source graphics ready for a
+ * hardware accelerated blitting operation, or to create multiple video memory
+ * pages which can then be displayed by calling show_video_bitmap. Read the
+ * introduction of this chapter for a comparison with other types of bitmaps and
+ * other specific details.
+ *
+ * Warning: video memory bitmaps are usually allocated from the same space as
+ * the screen bitmap, so they may overlap with it; it is therefore not a good
+ * idea to use the global screen at the same time as any surfaces returned by
+ * this function.
+ *
+ * Return value: Returns a reference to the bitmap on success, or nil if you
+ * have run out of video ram. Remember to destroy this bitmap before any
+ * subsequent call to set_gfx_mode.
+ */
+VALUE a4r_API_create_video_bitmap(VALUE self, VALUE width, VALUE height)
+{
+  // TODO: Change to call destroy_bitmap on free?
+  BITMAP *bmp = create_video_bitmap(FIX2INT(width), FIX2INT(height));
+  if (bmp == NULL)
+    return Qnil;
+  VALUE obj = Data_Wrap_Struct(cAPI_BITMAP, 0, 0, bmp);
+  return obj;
+}
+
+/*
+ * call-seq:
+ *   destroy_bitmap(bitmap) -> nil
+ *
+ * Destroys a memory bitmap, sub-bitmap, video memory bitmap, or system bitmap
+ * when you are finished with it. If you pass a nil this function won't do
+ * anything. See above for the restrictions as to when you are allowed to
+ * destroy the various types of bitmaps.
+ *
+ * The bitmap must not have a mouse cursor shown on it at the time it is
+ * destroyed.
+ */
+VALUE a4r_API_destroy_bitmap(VALUE self, VALUE bitmap)
+{
+  BITMAP *bmp;
+  if (bitmap == Qnil)
+    bmp = NULL;
+  else
+    Data_Get_Struct(bitmap, BITMAP, bmp);
+  destroy_bitmap(bmp);
+  return Qnil;
+}
+
+/*
+ * call-seq:
+ *   bitmap_mask_color(bmp) -> int
+ *
+ * Returns the mask color for the specified bitmap (the value which is skipped
+ * when drawing sprites). For 256-color bitmaps this is zero, and for truecolor
+ * bitmaps it is bright pink (maximum red and blue, zero green). A frequent use
+ * of this function is to clear a bitmap with the mask color so you can later
+ * use this bitmap with masked_blit or draw_sprite after drawing other stuff on
+ * it. Example:
+ *   # Replace mask color with another color.
+ *   (0...bmp.h).each do |y|
+ *     (0...bmp.w).each do |x|
+ *       if (getpixel(bmp, x, y) == bitmap_mask_color(bmp))
+ *         putpixel(bmp, x, y, another_color)
+ *       end
+ *     end
+ *   end
+ */
+VALUE a4r_API_bitmap_mask_color(VALUE self, VALUE bmp)
+{
+  BITMAP *bitmap;
+  Data_Get_Struct(bmp, BITMAP, bitmap);
+  return INT2FIX(bitmap_mask_color(bitmap));
+}
+
+/*
+ * call-seq:
+ *   acquire_bitmap(bmp) -> nil
+ *
+ * Acquires the specified video bitmap prior to drawing onto it. You never need
+ * to call the function explicitly as it is low level, and will only give you a
+ * speed up if you know what you are doing. Using it wrongly may cause slowdown,
+ * or even lock up your program.
+ *
+ * Note: You do never need to use acquire_bitmap on a memory bitmap, i.e. a
+ * normal bitmap created with create_bitmap. It will simply do nothing in that
+ * case.
+ *
+ * It still can be useful, because e.g. under the current DirectDraw driver of
+ * Allegro, most drawing functions need to lock a video bitmap before drawing to
+ * it. But doing this is very slow, so you will get much better performance if
+ * you acquire the screen just once at the start of your main redraw function,
+ * then call multiple drawing operations which need the bitmap locked, and only
+ * release it when done.
+ *
+ * Multiple acquire calls may be nested, but you must make sure to match up the
+ * acquire_bitmap and release_bitmap calls. Be warned that DirectX and X11
+ * programs activate a mutex lock whenever a surface is locked, which prevents
+ * them from getting any input messages, so you must be sure to release all your
+ * bitmaps before using any timer, keyboard, or other non-graphics routines!
+ *
+ * Note that if you are using hardware accelerated VRAM->VRAM functions, you
+ * should not call acquire_bitmap. Such functions need an unlocked target bitmap
+ * under DirectX, so there is now just the opposite case from before - if the
+ * bitmap is already locked with acquire_bitmap, the drawing operation has to
+ * unlock it.
+ *
+ * Note: For backwards compatibility, the unlocking behavior of such functions
+ * is permanent. That is, if you call acquire_bitmap first, then call e.g. an
+ * accelerated blit, the DirectX bitmap will be unlocked internally (it won't
+ * affect the nesting counter of acquire/release calls).
+ *
+ * There is no clear cross-platform way in this Allegro version to know which
+ * drawing operations need a locked/unlocked state. For example a normal
+ * rectfill most probably is accelerated under DirectX, and therefore needs the
+ * screen unlocked, but an XOR rectfill, or one with blending activated, most
+ * probably is not, and therefore locks the screen. And while the DirectX driver
+ * will do automatic unlocking, there is no such thing under X11, where the
+ * function is used to synchronize X11 calls from different threads. Your best
+ * bet is to never use acquire_bitmap - changes are you are doing something in
+ * the wrong way if you think you need it.
+ *
+ * Warning: This function can be very dangerous to use, since the whole program
+ * may get locked while the bitmap is locked. So the lock should only be held
+ * for a short time, and you should not call anything but drawing operations
+ * onto the locked video bitmap while a lock is in place. Especially don't call
+ * things like show_mouse (or scare_mouse which calls that) or readkey, since it
+ * will most likely deadlock your entire program.
+ */
+VALUE a4r_API_acquire_bitmap(VALUE self, VALUE bmp)
+{
+  BITMAP *bitmap;
+  Data_Get_Struct(bmp, BITMAP, bitmap);
+  acquire_bitmap(bitmap);
+  return Qnil;
+}
+
+/*
+ * call-seq:
+ *   release_bitmap(bmp) -> nil
+ *
+ * Releases a bitmap that was previously locked by calling acquire_bitmap. If
+ * the bitmap was locked multiple times, you must release it the same number of
+ * times before it will truly be unlocked.
+ */
+VALUE a4r_API_release_bitmap(VALUE self, VALUE bmp)
+{
+  BITMAP *bitmap;
+  Data_Get_Struct(bmp, BITMAP, bitmap);
+  release_bitmap(bitmap);
+  return Qnil;
+}
+
+/*
+ * call-seq:
+ *   acquire_screen -> nil
+ *
+ * Shortcut version of acquire_bitmap(screen)
+ */
+VALUE a4r_API_acquire_screen(VALUE self)
+{
+  acquire_screen();
+  return Qnil;
+}
+
+/*
+ * call-seq:
+ *   release_screen -> nil
+ *
+ * Shortcut version of release_bitmap(screen)
+ */
+VALUE a4r_API_release_screen(VALUE self)
+{
+  release_screen();
+  return Qnil;
+}

data/ext/a4r_API_blitting_and_sprites.c

@@ -0,0 +1,86 @@
+#include "allegro4r.h"
+
+/*
+ * call-seq:
+ *   blit(source, dest, source_x, source_y, dest_x, dest_y, width, height) -> nil
+ *
+ * Copies a rectangular area of the source bitmap to the destination bitmap. The
+ * source_x and source_y parameters are the top left corner of the area to copy
+ * from the source bitmap, and dest_x and dest_y are the corresponding position
+ * in the destination bitmap. This routine respects the destination clipping
+ * rectangle, and it will also clip if you try to blit from areas outside the
+ * source bitmap. Example:
+ *   # Blit src on the screen.
+ *   blit(bmp, screen, 0, 0, 0, 0, bmp.w, bmp.h)
+ *
+ *   # Now copy a chunk to a corner, slightly outside.
+ *   blit(screen, screen, 100, 100, -10, -10, 25, 30)
+ *
+ * You can blit between any parts of any two bitmaps, even if the two memory
+ * areas overlap (ie. source and dest are the same, or one is sub-bitmap of the
+ * other). You should be aware, however, that a lot of SVGA cards don't provide
+ * separate read and write banks, which means that blitting from one part of the
+ * screen to another requires the use of a temporary bitmap in memory, and is
+ * therefore extremely slow. As a general rule you should avoid blitting from
+ * the screen onto itself in SVGA modes.
+ *
+ * In mode-X, on the other hand, blitting from one part of the screen to another
+ * can be significantly faster than blitting from memory onto the screen, as
+ * long as the source and destination are correctly aligned with each other.
+ * Copying between overlapping screen rectangles is slow, but if the areas
+ * don't overlap, and if they have the same plane alignment (ie. (source_x%4) ==
+ * (dest_x%4)), the VGA latch registers can be used for a very fast data
+ * transfer. To take advantage of this, in mode-X it is often worth storing
+ * tile graphics in a hidden area of video memory (using a large virtual
+ * screen), and blitting them from there onto the visible part of the screen.
+ *
+ * If the GFX_HW_VRAM_BLIT bit in the gfx_capabilities flag is set, the current
+ * driver supports hardware accelerated blits from one part of the screen onto
+ * another. This is extremely fast, so when this flag is set it may be worth
+ * storing some of your more frequently used graphics in an offscreen portion of
+ * the video memory.
+ *
+ * Unlike most of the graphics routines, blit allows the source and destination
+ * bitmaps to be of different color depths, so it can be used to convert images
+ * from one pixel format to another. In this case, the behavior is affected by
+ * the COLORCONV_KEEP_TRANS and COLORCONV_DITHER* flags of the current color
+ * conversion mode: see set_color_conversion for more information.
+ */
+VALUE a4r_API_blit(VALUE self, VALUE source, VALUE dest, VALUE source_x, VALUE source_y, VALUE dest_x, VALUE dest_y, VALUE width, VALUE height)
+{
+  BITMAP *bmp_source, *bmp_dest;
+  Data_Get_Struct(source, BITMAP, bmp_source);
+  Data_Get_Struct(dest, BITMAP, bmp_dest);
+  blit(bmp_source, bmp_dest, FIX2INT(source_x), FIX2INT(source_y), FIX2INT(dest_x), FIX2INT(dest_y), FIX2INT(width), FIX2INT(height));
+  return Qnil;
+}
+
+/*
+ * call-seq:
+ *   masked_blit(source, dest, source_x, source_y, dest_x, dest_y, width, height) -> nil
+ *
+ * Like blit, but skips transparent pixels, which are marked by a zero in
+ * 256-color modes or bright pink for truecolor data (maximum red and blue, zero
+ * green), and requires the source and destination bitmaps to be of the same
+ * color depth. The source and destination regions must not overlap. Example:
+ *   # Paint hud overlay on the screen.
+ *   masked_blit(hud_overlay, screen, 0, 0, 0, 0, hud_overlay.w, hud_overlay.h)
+ *
+ * If the GFX_HW_VRAM_BLIT_MASKED bit in the gfx_capabilities flag is set, the
+ * current driver supports hardware accelerated masked blits from one part of
+ * the screen onto another. This is extremely fast, so when this flag is set it
+ * may be worth storing some of your more frequently used sprites in an
+ * offscreen portion of the video memory.
+ *
+ * Warning: if the hardware acceleration flag is not set, masked_blit will not
+ * work correctly when used with a source image in system or video memory so the
+ * latter must be a memory bitmap.
+ */
+VALUE a4r_API_masked_blit(VALUE self, VALUE source, VALUE dest, VALUE source_x, VALUE source_y, VALUE dest_x, VALUE dest_y, VALUE width, VALUE height)
+{
+  BITMAP *bmp_source, *bmp_dest;
+  Data_Get_Struct(source, BITMAP, bmp_source);
+  Data_Get_Struct(dest, BITMAP, bmp_dest);
+  masked_blit(bmp_source, bmp_dest, FIX2INT(source_x), FIX2INT(source_y), FIX2INT(dest_x), FIX2INT(dest_y), FIX2INT(width), FIX2INT(height));
+  return Qnil;
+}