Bitmapの機能を拡張します。
何度目か分からない車輪の再発明 です。
基本情報 説明 概要 ◆ メソッド一覧 ● draw_line(x1, y1, x2, y2[, color]) ● draw_line(rect[, color]) ● draw_line_g(x1, y1, x2, y2[, color1[, color2]]) ● draw_line_g(rect[, color1[, color2]]) ● draw_line_a(x1, y1, x2, y2[, color]) ● draw_line_ag(x1, y1, x2, y2[, color1[, color2]]) ● draw_line_a2(x1, y1, x2, y2[, color]) ● draw_line_ag2(x1, y1, x2, y2[, color1[, color2]]) ● draw_rect(x, y, width, height[, color]) ● draw_rect(rect[, color]) ● draw_multiangle(x1, y1, x2, y2, ... xn, yn[, color]) ● draw_multiangle_a(x1, y1, x2, y2, ... xn, yn[, color]) ● fill_triangle(x0, y0, x1, y1, x2, y2[, color]) ● fill_triangle_g(x0, y0, x1, y1, x2, y2[, color1[, color2[, radial]]]) ● draw_circle(ox, oy, radius[, color]) ● draw_circle_a(ox, oy, radius[, color]) ● fill_circle(ox, oy, radius[, color]) ◆ 色変更関連メソッド ◆ 画像保存 備考 更新履歴 基本情報
前提スクリプト
挿入位置
説明
概要
Bitmapクラスに図形描画用のメソッドをいくつか追加します。全ての描画メソッドがスクリプト上で実装されているため、DLLを用いた拡張に比べ動作は遅くなります。
◆ メソッド一覧
● draw_line(x1, y1, x2, y2[, color])
● draw_line(rect[, color])
指定座標を結ぶ直線を描画します。
ブレゼンハムのアルゴリズム を利用した高速な描画を行います。
colorを省略した場合はフォントの色が使われます。上の形式の場合は (x1, y1) から (x2, y2) に至る直線を、下の形式の場合は矩形の左上から右下までを結ぶ直線を描きます。
● draw_line_g(x1, y1, x2, y2[, color1[, color2]])
● draw_line_g(rect[, color1[, color2]])
指定座標を結ぶ直線をグラデーションさせながら描画します。draw_line に比べて数十倍の時間がかかるため短時間での多用は避けたほうがいいです。
color1
始点の色(省略時 / nil の場合は文字色と同じ)
color2
終点の色(省略時 / nil の場合は color1 と同じ)
● draw_line_a(x1, y1, x2, y2[, color])
● draw_line_ag(x1, y1, x2, y2[, color1[, color2]])
基本的に draw_line または draw_line_g と同じですが、アンチエイリアスを適用しよりなめらかな直線を描画します。矩形範囲を指定する形式も可能です。
● draw_line_a2(x1, y1, x2, y2[, color])
● draw_line_ag2(x1, y1, x2, y2[, color1[, color2]])
アンチエイリアス直線描画のブレンド版です。draw_line_a よりさらに時間がかかります。
draw_line_a の他、「_a」で終わるアンチエイリアス描画メソッドについては同様にブレンド版が用意されています。
● draw_rect(x, y, width, height[, color])
● draw_rect(rect[, color])
矩形の枠を描画します。fill_rect が内側を塗りつぶすのに対して、こちらは枠だけを描画するメソッドです。引数の形式は基本的に fill_rect と同じですが、color を省略した場合はフォントの色が使われます。
● draw_multiangle(x1, y1, x2, y2, ... xn, yn[, color])
● draw_multiangle_a(x1, y1, x2, y2, ... xn, yn[, color])
指定された頂点を持つ多角形を描画します。最初に指定された座標と最後に指定された座標を結んで多角形を閉じます。単純に指定された頂点を順に結んでいくため、指定方法によっては辺が重なって多角形ではなくなる場合があります。
● fill_triangle(x0, y0, x1, y1, x2, y2[, color])
3つの頂点を指定し、内部を塗りつぶした三角形を描画します。color を省略した場合はフォントの色が使われます。
● fill_triangle_g(x0, y0, x1, y1, x2, y2[, color1[, color2[, radial]]])
3つの頂点を指定し、内部をグラデーションで塗りつぶした三角形を描画します。
radial が偽、または省略時
(x0, y0)から(x1, y1)までの辺Aを color1、(x0, y0)から(x2, y2)までの辺Bを color2 で描画し、その間は辺A,Bからの距離に応じてグラデーションします。
radial が真の時
点(x0, y0)をcolor1、(x1, y1)から(x2, y2)までの辺Cを color2 で描画し、その間は辺Cからの距離に応じてグラデーションします。
サンプル画像では左上の頂点が(x0, y0)になっています。
● draw_circle(ox, oy, radius[, color])
● draw_circle_a(ox, oy, radius[, color])
中心(ox, oy)、半径 radius の円周を描画します。color は他と同様です。
● fill_circle(ox, oy, radius[, color])
内部を塗りつぶした円を描画します。
◆ 色変更関連メソッド
元画像サンプル
● convert_color(dest, src[, swap])
convert_color(:red, :green)
convert_color(:red, :green, true)
dest で指定されたRGB値を src に変更します。
自身を変更するメソッドです。
convert_color(:alpha, :red) とすると、赤の値を基準に不透明度に変換できます。
この処理は時間がかかるため、頻繁な呼び出しは避けてください。特に swap が有効な場合、非常に時間がかかります。
dest
変更するRGB値。シンボル(:red, :green, :blue, :alpha)で指定します。
src
参照するRGB値。シンボルまたは定数(0-255の整数)で指定します。
swap
変更先と参照元の値を入れ替えます。src がシンボルの場合のみ有効です。
● invert_color([dest])
invert_color(:red)
invert_color(:alpha)
invert_color(:all)
dest で指定されたRGB値を反転します。
自身を変更するメソッドです。
元の値が X の場合、255 - X になります。dest を省略、または :all を指定した場合、アルファ値を除く全てが反転します。
この処理は時間がかかるため、頻繁な呼び出しは避けてください。
dest
変更するRGB値。シンボル(上記に加えて :all)で指定します。
● fill_bitmap([color[, thick]])
fill_bitmap(Color.new(255,0,0))
fill_bitmap(Color.new(255,0,0), 2) ※輪郭が少し大きくなっている
全体を指定の色で塗りつぶした新たなビットマップを生成して返します。
自身は変更されません。
塗りつぶす際、不透明度は元々のビットマップのものが適用されます(引数の不透明度は無視されます)。
この処理は時間がかかるため、頻繁な呼び出しは避けてください。
color
塗りつぶす色。省略時はフォントの色が使われます。
thick
塗りつぶす輪郭の太さ。省略時は 0 (ビットマップと同じ大きさ)です。
● Cache.fill_bitmap(src_bitmap[, color[, thick[, key]]])
Bitmap#fill_bitmap のキャッシュ版です。src_bitmap にはレシーバとなるべきビットマップを指定します。key にはキャッシュの同一性判別用の文字列や数値を指定します。省略時には src_bitmap.object_id が使われるため、見た目が同じビットマップでも異なるものとして扱われることがあります。
◆ 画像保存
● save(filename[, type[, back]])
ビットマップを画像ファイルとして出力します。PNG と TIFF の場合は透過画像として出力されますが、それ以外は透過情報が失われるため、back を指定しなかった場合には画像が乱れる可能性があります。
filename
保存するファイル名。拡張子は省略できます。
type
保存形式。:png , :bmp , :jpeg , :tiff , :gif のいずれかです。省略時や不正な値が渡された場合は :png として扱われます。
back
透明部分を指定色で塗りつぶします。以下のいずれかです。
● save_bmp(filename, back)
● save_png(filename)
ビットマップを BMP または PNG 形式でファイルとして出力します。save_bmp では、back を省略した場合 "white" になります。
備考
再定義されるメソッド
なし
なし
更新履歴
2020/11/25 アンチエイリアス描画を改善、画像保存を高速化 最終更新：2020年11月25日 23:59
