Bitmap

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

在画面上显示位图,必须使用精灵(Sprite)之类的对象。

超类

类方法

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_rectRect)中的数据整体传送到当前位图的坐标 (x, y) 处。

opacity 是不透明度,范围 0~255。

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

将位图 src_bitmap 的矩形 src_rectRect)中的数据整体传送到当前位图的矩形 dest_rectRect)处。

opacity 是不透明度,范围 0~255。

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

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

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

将位图的矩形 (x, y, width, height) 或(Rect)渐变填充颜色 color1Color)至 color2Color)。

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

clear

清除整个位图。

clear_rect(x, y, width, height)
clear_rect(rect)

清除位图的矩形 (x, y, width, height) 或 rectRect)。

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) 或 rectRect)中描绘字符串 str

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

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

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

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

text_size(str)

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

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

属性

font

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