[ruby-list:5669] Re: GD-0.4

とりあえず、大雑把に使い方も書いてみました。

ソースの順番に簡単なコメントを付けただけですが、間違いの訂正をして頂け
るでしょうか？　その後でもう少し詳しい物を書こうと思います。


===== GD 拡張モジュールの使い方 =====

im = GD::Image.new(x_size, y_size)               # 新規イメージ
im = GD::Image.newFromGif(gif_file_name)         # gif ファイルから読み込む
im = GD::Image.newFronXbm(xbm_file_name)         # xbm ファイルから読み込む
im = GD::Image.newFromGd(gd_file_name)           # gd ファイルから読み込む

# もちろん、どれか１つにするか、別オブジェクトにしなければなりません。

im.destroy                                       # イメージ破棄

color = im.colorAllocate(r, g, b)                # その色を割り当てる
im.colorDeallocate(color)                        # その色の割り当て取消
color = im.colorClosest(r, g, b)                 # その色の割り当て保留
color = im.colorExact(r, g, b)                   # 既存の色から割り当てる

# 慎重な色割り当ての仕方はこんな感じかな。

color = im.colorExact(r, g, b) or
        im.colorAllocate(r, g, b) or
        im.colorClosest(r, g, b)

# と思ったら、nil ではなく -1 を返すので、これではだめなんですね。

im.colorsTotal                                   # 全使用色数
color_name = im.getPixel(x, y)                   # そのポイントの色
im.rgb(color)                                    # カラーテーブル --> RGB
im.trasparent(color)                             # その色を透明にする

im.setBrush(brush)                               # 筆の選択
blush = GD::Image.newFromGif(burush_file)

GD::Styled                                       # (破)線
im.setStyle(color, color, ...)                   # (破)線のスタイルを定義
GD::Brushed                                      # 筆
GD::StyledBrushed                                # 筆と(破)線

# 紅白線は、こんな感じ。
im.setStyle(red, white)
im.line(0, 0, 100, 0, GD::Styled)

im.setTile(tile)                                 # 塗潰しのパターンの選択
tile = GD::Image.newFromGif(tile_file)

GD::Tiled                                        # 塗潰しのパターン
GD::Transparent                                  # 透明色

im.setPixel(x, y, color)                         # １ピクセルの色変更
im.line(x1, y1, x2, y2, color)                   # 線を引く
im.dashedLine(x1, y1, x2, y2, color)             # (破)線を引く
im.rectangle(x1, y1, x2, y2, color)              # 長方形を描く
im.filledRectangle(x1, y1, x2, y2, color)        # 中を塗潰した長方形を描く
im.polygon(polygon, color)                       # 多角形を描く
im.filledPolygon(polygon, color)                 # 中を塗潰した多角形を描く
# polygon は後述の Polygon オブジェクト。

im.arc(cx, cy, width, heihgt, start, end, color) # 円弧を描く
im.fill(x, y, color_name)                        # 塗潰す
im.fillToBorder(x, y, border_color, fill_color)  # 縁線内を塗潰す

im.copy(im, x, y, sx, sy, sw, sh)                # イメージを張り付ける

# もちろん im は別の Image オブジェクトでも良い。
# x, y の位置に、sx, sy, sw, sh の部分が張り付けられる。

im.copyResized(im, x, y, sx, sy, w, h, sw, sh)   # リサイズして張り付ける

# x, y, w, h の範囲に sx, sy, sw, sh の範囲が張り付けられる。

im.string(font, x, y, string, color)             # 文字列を書く
# font は後述の font オブジェクト。

im.stringUp(font, x, y, string, color)           # 縦方向に文字列を書く
# 縦書きではない。単に90度回転した方向に書かれて行く。

im.char(font, x, y, string, color)               # 文字を書く
im.charUP(font, x, y, string, color)             # 縦方向に文字を書く

im.interlace                                     # インターレースの状態
im.interlace = TRUE                              # インターレースにする

x_size, y_size = im.bounds                       # イメージの大きさ
x_size = im.width                                # イメージの横の大きさ
y_size = im.height                               # イメージの縦の大きさ

im.gif(OUT)                                      # gif 形式での出力
im.gd(OUT)                                       # gd 形式での出力

polygon = GD::Polygon.new                        # 多角形オブジェクトの生成
polygon.addPt(x, y)                              # 点(角) x, y を追加
x, y = polygon.getPt(n)                          # n 番目の点の位置
polygon.setPt(n, x, y)                           # n 番目の点を x, y に変更
polygon.deletePt(n)                              # n 番目の点を削除
all_points = polygon.length                      # 点の総数
xs = polygon.vertices                            # 各点の x 位置？
x1, y1, x2, y2 = polygon.bounds                  # 多角形の範囲
polygon.offset(vx, vy)                           # 多角形全体の移動
polygon.map(x1, y1, x2, y2)                      # 多角形全体のリサイズ
polygon.map(sx1, sy1, sx2, sy2, x1, y1, x2, y2)  # 多角形の一部のリサイズ
# sx1, sy1, sx2, sy2 の範囲を x1, y1, x2, y2 の範囲に。(だと思うのですが)

font = GD::Font.new(font_name)                   # フォントオブジェクトの生成
# font_name : "Giant", "Small", "Large", "Medium", "Medium", "Tiny"

characters = font.nchars                         # フォントの文字数
first_character_no = font.offset                 # 最初の有効な文字の番号？
width = font.width                               # フォントの幅
height = font.height                             # フォントの高さ


青山 和光 Wakou Aoyama <[e-mail]>