Paintutils APIを使って図形を描こう - Minecraftとタートルと僕

はじめに

前回の説明でターミナル画面に点を描き、線を引き、長方形を描きました。
これらの描画を通して基本的な原理を理解できたと思うので、今回は楽をする方法を紹介しましょう。

Paintutils API

標準で用意されているPaintutils　APIは、画像を取り扱い、点を描き、線を引くための便利な関数を用意しています。

コンピュータクラフト非公式Wiki - API/Paintutils

ここではその中から以下の2つの関数を簡単に紹介しましょう。

paintutils.drawPixel(X座標, Y座標, 色)

ターミナル画面上で、指定した座標に、指定した色で点を描く。

サンプルコード

--座標(2,2)に青色で点を描く
paintitls.drawPixel(2,2,colors.blue)

実行結果

paintutils.drawLine(始点X座標, 始点Y座標, 終点X座標, 終点Y座標, 色)

ターミナル画面上で、始点座標から終点座標まで、指定した色で線を引く。

サンプルコード

-- (2,2)から(11,11)まで青い線を引く
paintutils.drawLine(2,2,11,11, colors.blue)

実行結果

四角形を描くサンプルプログラム

これらの関数を使って、図形を描いてみます。

四角形（枠）

まずは、四角形の枠だけ描いて中を塗りつぶさないプログラムです。

左上の始点(2,2)から右下の終点(11,11)という青い四角形を描きます。中は塗りつぶしません。
単純に枠となる4本の線を引いているだけです。シンプル。

サンプルコード

-- ### function
function drawFrame(startX, startY, endX, endY, color)
  paintutils.drawLine(startX,startY,endX,startY, color) -- 上の横棒
  paintutils.drawLine(endX,startY,endX,endY, color) -- 右の縦棒
  paintutils.drawLine(startX,startY,startX,endY, color) -- 左の縦棒
  paintutils.drawLine(startX,endY,endX,endY, color) -- 下の横棒
end

-- ### main
drawFrame(2,2,11,11, colors.blue)

実行結果

四角形（塗りつぶし）

次は中を塗りつぶす場合です。
左上の始点(2,2)から右下の終点(11,11)という青い四角形を描きます。

サンプルコード

-- ### function
function drawRectangle(startX, startY, endX, endY, color)
  for y=startY, endY do
    paintutils.drawLine(startX,y,endX,y, color)
  end
end

-- ### main
drawRectangle(2,2,11,11, colors.blue)

単純に、横線を10本引いているだけです。