Bitmap

位图类。位图表示图像的数据。

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

超类

• Object

类方法

Bitmap.new(filename)

载入由 filename 参数所指定的图像，生成一个 Bitmap 对象。

RGSS-RTP 和加密档案中的文件会自动搜索。扩展名可以省略。

Bitmap.new(width, height)

生成指定大小的 Bitmap 对象。

方法

dispose

释放位图，若位图已释放，则什么都不做。

disposed?

如果位图已释放，则返回 true。

width

获取位图的宽度。

height

获取位图的高度。

rect

获取位图的矩形（Rect）。

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

将位图 src_bitmap 的矩形 src_rect（Rect）中的数据整体传送到当前位图的坐标 (x, y) 处。

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

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

将位图 src_bitmap 的矩形 src_rect（Rect）中的数据整体传送到当前位图的矩形 dest_rect（Rect）处。

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

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

fill_rect(rect, color)

将位图的矩形 (x, y, width, height) 或（Rect）填充指定的颜色 color（Color）。

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

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

将位图的矩形 (x, y, width, height) 或（Rect）渐变填充颜色 color1（Color）至 color2（Color）。

将 vertical 设为 true 可以纵向渐变。默认为横向渐变。

clear

清除整个位图。

clear_rect(x, y, width, height)

clear_rect(rect)

清除位图的矩形 (x, y, width, height) 或 rect（Rect） 。

get_pixel(x, y)

获取点 (x, y) 的颜色（Color）。

set_pixel(x, y, color)

设置点 (x, y) 的颜色（Color）。

hue_change(hue)

在 360 度内变换位图的色相。

此处理需要花费时间。另外，由于转换误差，反复转换可能会导致色彩失真。

blur

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

radial_blur(angle, division)

对位图执行放射型模糊。angle 指定 0~360 的角度，角度越大，效果越圆润。

division 指定 2～100 的分界数，分界数越大，效果越平滑。此处理需要花费大量时间。

draw_text(x, y, width, height, str[, align])

draw_text(rect, str[, align])

在位图的矩形 (x, y, width, height) 或 rect（Rect）中描绘字符串 str 。

若 str 不是字符串对象，则会在执行之前，先调用 to_s 方法转换成字符串。

若文字长度超过区域的宽度，文字宽度会自动缩小到 60%。

文字的横向对齐方式默认为居左，可以设置 align 为 1 居中，或设置为 2 居右。垂直方向总是居中对齐。

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

text_size(str)

获取使用 draw_text 方法描绘字符串 str 时的矩形（Rect）。该区域不包含轮廓部分 (RGSS3) 和斜体的突出部分。

若 str 不是字符串对象，则会在执行之前，先调用 to_s 方法转换成字符串。

属性

font

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