Bitmap

在画面上显示 Bitmap，必须使用（Sprite）之类的对象。

超类

• Object

类方法

Bitmap.new(filename)

载入由 filename 所指定的图像文件，并生成 Bitmap 实例。扩展名可以省略。

Bitmap.new(width, height)

生成指定大小的 Bitmap 实例。

Bitmap.new(buffer, size)

从内存 buffer 中载入图像文件并生成 Bitmap 实例。，size 为 buffer 的内存大小。

方法

dispose

释放 Bitmap 。若是已经释放则什么都不做。

disposed?

Bitmap 已释放时返回 true。

width

获取 Bitmap 的宽度。

height

获取 Bitmap 的高度。

rect

获取 Bitmap 的矩形范围（Rect）。

blt(x, y, src_bitmap, src_rect[, opacity])

将源 Bitmap 指定区域的像素绘制到 Bitmap 的指定区域。x, y 为指定区域的左上角坐标。

src_bitmap 为源 Bitmap 。src_rect（Rect）为源 Bitmap 指定区域的矩形范围。

opacity 为透明度，范围 0～255。

stretch_blt(dest_rect, src_bitmap, src_rect[, opacity])

将源 Bitmap 指定区域的像素拉伸绘制到 Bitmap 的指定区域。dest_rect 为指定区域的矩形范围（Rect）。

src_bitmap 为源 Bitmap 。src_rect（Rect）为源 Bitmap 指定区域的矩形范围。

opacity 为透明度，范围 0～255。

fill_rect(x, y, width, height, color)

fill_rect(rect, color)

以指定颜色 color（Color 或 32 位颜色（Bignum））填充 Bitmap (x, y, width, height) 或（Rect）指定的区域。

gradient_fill_rect(x, y,width, height, color1,color2[, vertical])

gradient_fill_rect(rect,color1, color2[, vertical])

以指定颜色 color1（Color 或 32 位颜色（Bignum））, color2（Color 或 32 位颜色（Bignum））渐变填充 Bitmap (x, y, width, height) 或（Rect）指定的区域。

vertical 为 true 时纵向绘制，为 false 时横向绘制，预设为 false 。

clear

以透明色填充整张 Bitmap 。

clear_rect(x, y,width, height)

clear_rect(rect)

以透明色填充 Bitmap 的指定区域。

get_pixel(x, y)

获取指定像素点 (x, y) 的颜色（Color）。

set_pixel(x, y, color)

设定指定像素点 (x, y) 的颜色（Color 或 32 位颜色（Bignum））。

hue_change(hue)

在 360 度内变换 Bitmap 的色相。

此处理需要花费时间，另外颜色转换会产生误差，反复转换可能会导致颜色损失。

blur

对 Bitmap 执行模糊效果。此处理需要花费时间。

radial_blur(angle, division)

暂未实现

draw_text(x, y, width, height, str[, halign[, valign]])

draw_text(rect, str[, halign[, valign]])

在 Bitmap 指定区域 (x, y, width, height) 或 rect（Rect）中绘制字符串 str 。

若 str 不是字符串对象，则会调用 to_s 方法转换成字符串。

文字的横向对齐方式预设为 0 靠左对齐，可以设置 halign 为 1 居中对齐，或设置为 2 靠右对齐。

文字的纵向对齐方式预设为 1 居中对齐，可以设置 valign 为 0 靠上对齐，或设置为 2 靠下对齐。

此处理需要花费时间，因此不建议每帧重复绘制文字。

text_size(str)

获取使用 draw_text 方法描绘 str 字符串时所需要的矩形范围（Rect）。不包含斜体倾斜的文字部分。

若 str 不是字符串对象，则会调用 to_s 方法转换成字符串。

brightness_change(brightness)

改变 Bitmap 的亮度。brightness 为亮度，范围 -255～255

tone_change(tone)

tone_change(red, green, blue, gray)

将 Bitmap 设置为指定的 tone（Tone 或 32 位颜色（Bignum））或 red, green, blue, gray 色调。

flip_h

水平翻转 Bitmap 。

flip_v

垂直翻转 Bitmap 。

filename

获取 Bitmap 的文件名。

如果是使用 Bitmap.new(width, height) 或 Bitmap.new(buffer, size) 创建的 Bitmap ，返回 nil。

save_to_file(filename)

将 Bitmap 保存为指定文件名 filename 的 bmp 格式位图文件。

属性

font

使用 draw_text 方法描绘字符串时所使用的字体。（Font）。