プログラミング実践:第03回(PVectorクラス)

PVectorクラス

型とクラスの復習

前回は String と PImage を使いました.今回は,ベクトルを扱うためのクラス PVector を学びます.

参考: Processing/Reference/PVector

ベクトルとは

ベクトルとは,「大きさ」と「向き」を持つ量のことです.座標平面上では,成分 \((x, y)\) の組で表せます.

たとえば,

  • 位置
  • 速度
  • 力

などは,ベクトルとして扱うと簡潔に記述できます.

PVectorクラス

PVector は,2次元または3次元のベクトルを扱うためのクラスです.

PVector を使うと,ベクトルの成分を1つのまとまりとして扱え,ベクトルの加算・減算・大きさの計算などをメソッドとして呼び出せます.

PVectorの作成

new を使って,成分を指定して作成します.

PVector v1 = new PVector(3, 4);      // 2次元 (x=3, y=4)
PVector v2 = new PVector(1, 2, 3);   // 3次元 (x=1, y=2, z=3)

2つの成分だけを指定した場合, z の値は 0 になります.

作成したベクトルは, println() で成分を確認できます.

PVector v = new PVector(3, 4);
println(v);
[ 3.0, 4.0, 0.0 ]

成分は float 型で保持されます.

PVectorのフィールド

PVector には,成分を保持するフィールドがあります.

  • x :ベクトルの x 成分
  • y :ベクトルの y 成分
  • z :ベクトルの z 成分

フィールドは次のようにして使用できます.

変数名.フィールド名
PVector v = new PVector(3, 4);
println(v.x);
println(v.y);

v.x = 10;
println(v.x);
3.0
4.0
10.0

上の例のように, x , y , z には値を代入して書き換えることもできます.

PVectorのメソッド

PVector には,ベクトルの計算を行うためのメソッドがあります.

メソッド 内容
set() ベクトルの成分を設定する
copy() ベクトルのコピーを作る
mag() ベクトルの大きさを求める
add() ベクトルを加算する
sub() ベクトルを減算する
mult() ベクトルをスカラー倍する
div() ベクトルをスカラーで割る
dist() 2つのベクトル(点)の間の距離を求める
normalize() ベクトルの大きさを1にする(正規化)
setMag() ベクトルの大きさを指定した値にする
heading() 2次元ベクトルの向きを角度で求める
rotate() 2次元ベクトルを回転する
angleBetween() 2つのベクトルのなす角を求める

set(x, y) - 成分を設定する

例
PVector v = new PVector(3, 4);
v.set(10, 20);
println(v);
[ 10.0, 20.0, 0.0 ]

copy() - ベクトルのコピーを作る

PVector もクラスの型なので, = で代入しても値のコピーにはなりません.同じベクトルを指す名前が2つできるだけです.

例
PVector a = new PVector(3, 4);
PVector b = a;        // a と b は同じベクトルを指す
b.x = 100;
println(a);

PVector c = a.copy(); // a の内容をコピーした新しいベクトル
c.x = 5;
println(a);
println(c);
[ 100.0, 2.0, 0.0 ]
[ 100.0, 2.0, 0.0 ]
[ 5.0, 2.0, 0.0 ]

ベクトルを書き換えるメソッド( add() など)を使うときは,元の値を残したい場合に copy() を使います.

mag() - ベクトルの大きさを求める

\( \sqrt{x^2 + y^2 + z^2} \) を返します.

例
PVector v = new PVector(3, 4);
println(v.mag());
5.0

add(v) - ベクトルを加算する

呼び出したベクトルに, v の各成分を加えます.

例
PVector a = new PVector(3, 4);
PVector b = new PVector(1, 2);
a.add(b);
println(a);
[ 4.0, 6.0, 0.0 ]

sub(v) - ベクトルを減算する

呼び出したベクトルから, v の各成分を引きます.

例
PVector a = new PVector(3, 4);
PVector b = new PVector(1, 2);
a.sub(b);
println(a);
[ 2.0, 2.0, 0.0 ]

mult(n) - スカラー倍する

各成分に n を掛けます.

例
PVector v = new PVector(3, 4);
v.mult(2);
println(v);
[ 6.0, 8.0, 0.0 ]

div(n) - スカラーで割る

各成分を n で割ります.

例
PVector v = new PVector(3, 4);
v.div(2);
println(v);
[ 1.5, 2.0, 0.0 ]

dist(v) - 2点間の距離を求める

2つのベクトルを,原点からの位置を表すベクトル(点の座標)とみなしたときの,2点間の距離を返します.

例
PVector a = new PVector(1, 2);
PVector b = new PVector(4, 6);
println(a.dist(b));
5.0

normalize() - 大きさを1にする(正規化)

向きを保ったまま,ベクトルの大きさを1にします.大きさが 0 のベクトルは変化しません.

例
PVector v = new PVector(3, 4);
v.normalize();
println(v);
println(v.mag());
[ 0.6, 0.8, 0.0 ]
1.0

float 型は誤差を含むため,環境によっては mag() が 1.0 にごく近い値として表示されることがあります.

setMag(n) - 大きさを指定した値にする

向きを保ったまま,ベクトルの大きさを n にします. normalize() のあとに mult(n) を行うことと同じです.

例
PVector v = new PVector(3, 4);
v.setMag(10);
println(v.mag());
10.0

heading() - 向きを角度で求める

2次元ベクトルの向きを,x 軸の正の向きからの角度で返します.単位は ラジアン です.

Processing では y 軸が下向きなので, y が正のベクトルでは,画面上で時計回りの向きの角度になります.

例
PVector v = new PVector(1, 1);
println(v.heading());
println(PI / 4);
0.7853982
0.7853982

角度の単位を度に直したい場合は, degrees() を使います.

rotate(theta) - ベクトルを回転する

2次元ベクトルを,角度 theta (ラジアン)だけ回転します.大きさは変わりません.正の角度は,画面上で時計回りの回転になります.

例
PVector v = new PVector(1, 0);
v.rotate(HALF_PI);   // 90度

回転後のベクトルは,ほぼ \((0, 1)\) になります.ただし, float の誤差のため, x は厳密に 0 にならず,非常に小さい値が残ります.

PVector.angleBetween(v1, v2) - 2つのベクトルのなす角を求める

2つのベクトルのなす角を,ラジアンで返します.このメソッドは,PVector 型の変数ではなく PVector というクラス名を用いて呼び出す static メソッド です.

例
PVector a = new PVector(1, 0);
PVector b = new PVector(0, 1);
println(PVector.angleBetween(a, b));
println(HALF_PI);
1.5707964
1.5707964

static メソッドによる演算

add() , sub() , mult() , div() , dist() には,クラス名から呼び出す static 版もあります. add() , sub() , mult() , div() の static 版は,元のベクトルを書き換えず, 新しいベクトル として結果を返します.

例
PVector a = new PVector(1, 2);
PVector b = new PVector(3, 4);
PVector c = PVector.add(a, b);
println(a);
println(b);
println(c);
[ 1.0, 2.0, 0.0 ]
[ 3.0, 4.0, 0.0 ]
[ 4.0, 6.0, 0.0 ]

PVectorの配列

int や float と同じように,PVector も配列にできます.

PVector[] positions = new PVector[3];
例
PVector[] positions = new PVector[3];

for (int i = 0; i < positions.length; i++) {
  positions[i] = new PVector(i * 10, i * 20);
}

for (int i = 0; i < positions.length; i++) {
  println(positions[i]);
}
[ 0.0, 0.0, 0.0 ]
[ 10.0, 20.0, 0.0 ]
[ 20.0, 40.0, 0.0 ]

配列の要素も PVector なので, positions[i].add(v) や positions[i].x のように,メソッドやフィールドをそのまま使えます.

練習

練習1

次の操作を順番に行ってください.

  1. 成分 \((6, 8)\) の PVector 型の変数 v を作成してください.

  2. v の大きさをコンソールに表示してください.

  3. 成分 \((1, 2)\) の PVector 型の変数 w を作成し, v に w を加えて, v をコンソールに表示してください.

  4. v を2倍にして,コンソールに表示してください.

  5. v と w の距離をコンソールに表示してください.

実行結果の例

5 の表示結果は \(\sqrt{(14-1)^2 + (20-2)^2} = \sqrt{493}\) (約22.2)になります.

10.0
[ 7.0, 10.0, 0.0 ]
[ 14.0, 20.0, 0.0 ]
22.2...(小数点以下の桁数は環境による)

練習2 ( クラス-基礎6 )

上下左右の端で跳ね返る円を描いてください.

起動するたびに,円の初期位置,移動速度,円の大きさがランダムになるようにしてください.

  • キャンバスサイズは (500, 500) とします.

  • 円の直径は5〜30ピクセルの範囲でランダムに決めます.

  • 円の初期位置は,円全体がキャンバス内に収まる範囲でランダムに決めます.

  • 移動速度は,x 方向,y 方向それぞれ -5〜5 の範囲でランダムに決めます.

  • まずはPVectorを使わず, float 型の変数で書いてください.

ヒント

  • 半透明の円は, fill(0, 15); のように fill() の2番目の引数(不透明度)を小さくして描きます.

続き: PVectorを使って書き換える

上記ができたら,円の位置と速度を PVector で表すように書き換えてください.

  • 位置を PVector 型の変数 position ,速度を PVector 型の変数 velocity で表します.

ヒント

  • float posX, posY; の2つの変数が, PVector position; の1つにまとまります.
  • 成分は position.x , position.y のように取り出せます.

課題