メインコンテンツへスキップ
見出し画像

Pythonで3Dの「動く立方体」を作る | 外部モジュールなし | python | tkinter |

    普通、pythonなどのプログラミング言語で画面に普通に表示できるのは2Dまでです。しかし、投影の手法を使うと3Dの立体も無理やり描画することができます。今回はpythonで3Dの「動く立方体」を描く仕組みの解説です。

    ※ 前半は数学です

    1. 3Dを2Dに投影する考え方

    (1) 透視投影のやり方

    今回は「透視投影」というやり方で3Dの立体を2Dに投影します。透視投影は、普段見ている物体の見え方に近くするやり方で、よく耳にする遠近法などという技術もこれを応用したものです。実際、立方体を透視投影してみると以下のようになります。

    画像
    ※ python実装の前にgeogebraでテストした時の画像です

    透視投影のやり方は簡単で、やろうと思えばすぐにできます。

    ① 投影面と視点を決める
    ② 物体の頂点から視点に直線を引く(※)
    ③ 投影面と直線との交点に点を打つ
    ④ ③の点をつなげば投影完了

    (※) 頂点でなくても、目印になるわかりやすいところならどこでも良いです。最終的に③④ができればよいので。

    画像
    この図を作るのに平気で30分かかりました…(mathchaで作成)
    図がちょっと歪んでるのはご容赦ください

    (2) 3次元空間の点(p,q,r)の透視投影の式

    投影の仕組みがわかったところで、一般化をしてみます。投影の手順④の線を引くところは後でやればよいので、ひとまずは③までの「点を投影する」ことを考えます。

    ここからは、便宜上xyz平面を用いて考えます。xyz平面とは、基本の座標平面のxy平面上に、さらに一本軸を足して3次元空間を表現できるようにしたものです。今回は、横がx、奥行きがy、縦をzとして考えていきます。

    視点を(0,0,0)(0,0,0)とし、点P(p,q,r)P(p,q,r)を平面y=d (d>0)y=d  (d>0)に投影することを考えます。このままでは考えにくいので、一度分割して考えてみましょう。

    まず、これを上からみた図、つまりxy平面で考えます。

    画像
    r についてはここでは無視できます
    (上から見た図なので r がどんな値だろうと変わらない)

    ここで、求めたいのはP′P'の座標です。

    2組の角が等しいので△OPHと△OP′H′は相似∴ PH:P′H′=OH:OH′ ∴ p:P′H′=q:d ∴ q⋅P′H′=dp ∴ P′H′=dpqよって、P′ の座標は (dpq,d)\displaystyle 2組の角が等しいので△OPHと△OP'H'は相似\\[3pt]\therefore  PH:P'H'=OH:OH'  \therefore  p:P'H'=q:d  \\[3pt]\therefore  q\cdot P'H'=dp  \therefore  P'H'=\frac{dp}{q}\\[6pt]よって、P'  の座標は  \left(\frac{dp}{q},d\right)

    次に、真横からみた図、つまりyz平面で考えます。といっても、考え方は全く同じです。

    画像
    同様に p は無視できます

    2組の角が等しいので△OPHと△OP′H′は相似∴ PH:P′H′=OH:OH′ ∴ r:P′H′=q:d ∴ q⋅P′H′=dr ∴ P′H′=drqよって、P′ の座標は (d,drq)\displaystyle 2組の角が等しいので△OPHと△OP'H'は相似\\[3pt]\therefore  PH:P'H'=OH:OH'  \therefore  r:P'H'=q:d  \\[3pt]\therefore  q\cdot P'H'=dr  \therefore  P'H'=\frac{dr}{q}\\[6pt]よって、P'  の座標は  \left(d,\frac{dr}{q}\right)

    以上より、y=dy=dの平面に(p,q,r)(p,q,r)を投影すると(dpq,d,drq)\displaystyle\left(\frac{dp}{q},d,\frac{dr}{q}\right)になると分かります。

    ※なお、処理上はxz平面で描画するので、(dpq,drq)\displaystyle\left(\frac{dp}{q},\frac{dr}{q}\right)で十分です。

    2. 回転する立方体の座標

    次に、回転したあとの立方体の座標の変化を考えます。なお、ここではすべて中心が原点の立方体の回転を考えます。

    ※ 中心が原点でない場合は、平行移動で原点に持ってきて回転させた後、再度平行移動で元の位置に戻せばよいです

    (1) z軸での回転を考える

    まずはわかりやすくxy平面で考えるために、z軸を軸とした回転を考えます。

    画像
    PからP'に、θz度だけ回転させることを考えます

    円の半径を r とし、P を極座標変換すると、x=rcos⁡α , y=rsin⁡α同様に、x′=rcos⁡(α+θz) , y′=rsin⁡(α+θz)これを加法定理を用いて展開する。x′=rcos⁡αcos⁡θz−rsin⁡αsin⁡θz=xcos⁡θz−ysin⁡θzy′=rsin⁡αcos⁡θz+rcos⁡αsin⁡θz=xsin⁡θz+ycos⁡θz\displaystyle 円の半径を  r  とし、P  を極座標変換すると、\\[3pt]x=r\cos\alpha  ,  y=r\sin\alpha\\[3pt]同様に、x'=r\cos(\alpha+\theta_z)  ,  y'=r\sin(\alpha+\theta_z)\\[3pt]これを加法定理を用いて展開する。\\[3pt]x'=r\cos\alpha\cos\theta_z-r\sin\alpha\sin\theta_z=x\cos\theta_z-y\sin\theta_z\\[3pt]y'=r\sin\alpha\cos\theta_z+r\cos\alpha\sin\theta_z=x\sin\theta_z+y\cos\theta_z

    このことから、3次元空間内で(x,y,z)(x,y,z)をzz軸でθz\theta_zだけ回転させた座標は(xcos⁡θz−ysin⁡θz,xsin⁡θz+ycos⁡θz,z)(x\cos\theta_z-y\sin\theta_z,x\sin\theta_z+y\cos\theta_z,z)となります(zz軸回転なのでzz座標はそのまま変わりません)。

    (2) x,y軸での回転の結果

    xx軸やyy軸回転でも考え方は全く同じなので、ここでは計算結果だけ書きます。

    以下は、点(x,y,z)(x,y,z)をそれぞれの軸でそれぞれθx,θy,θz\theta_x,\theta_y,\theta_zだけ回転させたときの座標です。

    【x軸】
    (x , ycos⁡θx−zsin⁡θx , ysin⁡θx+zcos⁡θx)(x  ,  y\cos\theta_x-z\sin\theta_x  ,  y\sin\theta_x+z\cos\theta_x)
    【y軸】
    (xcos⁡θy+zsin⁡θy , y , −xsin⁡θy+zcos⁡θy)(x\cos\theta_y+z\sin\theta_y  ,  y  ,  -x\sin\theta_y+z\cos\theta_y)
    【z軸】
    (xcos⁡θz−ysin⁡θz , xsin⁡θz+ycos⁡θz , z)(x\cos\theta_z-y\sin\theta_z  ,  x\sin\theta_z+y\cos\theta_z  ,  z)

    3. 描画する処理の考え方

    (1) 描画の手順

    1.と2.を踏まえて、描画の手順は以下のようになります。

    ① x軸方向の回転処理をする
    ② y軸方向の回転処理をする
    ③ z軸方向の回転処理をする
    ④ 透視投影をする
    ⑤ 投影後の座標を踏まえて線(辺)の描画

    ①から③の回転について補足です。一般に、3次元空間では、回転の順序を入れ替えると物体の状態は変わってしまいます。例えば、ある物体をxx軸方向に45∘45^{\circ}回転させてからyy軸方向に90∘90^{\circ}回転させた状態と、その逆のyy軸方向に90∘90^{\circ}回転させてからxx軸方向に45∘45^{\circ}回転させる状態は異なるということです(円柱などがわかりやすいと思います)。しかし、立方体のような対称性がある立体では、頂点の位置などの細かい違いはあっても外見上はその違いを区別できません。したがって、回転順序はさほど影響がないのです。

    (2) 描画の注意点

    さて、ここからはプログラミングの話になります。今回はtkinter\verb|tkinter|を使いますが、tkinter\verb|tkinter|での座標は、キャンバスが横width\verb|width|、縦height\verb|height|の場合、左上が(0,0)で右下が(width\verb|width|,height\verb|height|)となるので、先ほど考えた座標軸の「中心が(0,0)で右上が最大」とは違うものになってしまいます。これを補正するためには、以下のようにする必要があります。

    【x軸】
    これは単純で、単にwidth2\dfrac{\verb|width|}{2}を足すだけでよいです。例えば、600×600のキャンバスで、普通の座標平面におけるx=0x=0を描画したいとすれば、tkinter\verb|tkinter|では300を足してx=300x=300に書けばよいということです。

    【y軸】
    難しいのはこれで、tkinter\verb|tkinter|のものと一般的な座標軸では増加の方向が違います。そこで、-1を掛けてから300を足します。例えば、600×600のキャンバスで、普通の座標平面におけるy=5y=5を描画したいとすれば、tkinter\verb|tkinter|では-1を掛けて-5、それに300を足してy=295y=295に書けばよいということです。

    しかし、このままではx,yx,yともに-300から300という広範囲で、素直に投影したものをここに入れると非常に小さく表示されてしまいます。これを避けるため、今回はどちらも100倍に調整して処理します。
    調整法は簡単で、足したり掛けたりする前(つまり変換前)のx,yx,yに100を掛けておくだけです。この処理を実装した関数は以下のものになります。

    # 座標軸を100倍してtkinterのものに補正
    def offset(x,y):
        return (x*100+300,300-y*100)

    4. 描画のプログラム

    いままでのことを実装したプログラムは以下のようになります。

    # モジュールのインポート
    import tkinter as tk
    import math
    
    # 処理用クラス
    class Cube():
        def __init__(self):
            # メインウィンドウの作成
            self.wid = 600
            self.hei = 600
            self.root = tk.Tk()
            self.root.resizable(0,0)
            self.root.title("Cube")
            self.root.attributes("-topmost",1)
            self.canvas = tk.Canvas(self.root,width=self.wid,height=self.hei,
                                    bd=0,highlightthickness=0)
            self.canvas.pack()
            self.canvas.create_rectangle(0,0,self.wid,self.hei,fill="black")
            # 変数の初期化
            self.edge = 7
            self.distance = 2
            self.center = 12
            self.rotation_x = 60
            self.rotation_y = 30
            self.rotation_z = 0
            self.make_cube()
            self.project()
    
        # 投影後の立方体の描画
        def draw(self):
            # 回転と透視投影処理
            self.make_cube()
            self.rotation()
            self.project()
            # 座標をtkinterに変換
            for num_n in range(len(self.plist)):
                self.plist[num_n]=self.offset(self.plist[num_n][0],self.plist[num_n][1])
            # 線の(再)描画
            self.canvas.delete("cubeline")
            self.line(0,1)
            self.line(0,4)
            self.line(1,5)
            self.line(4,5)
            self.line(2,3)
            self.line(2,6)
            self.line(3,7)
            self.line(6,7)
            self.line(0,2)
            self.line(4,6)
            self.line(1,3)
            self.line(5,7)
            self.root.after(50,self.draw)
        
        # 回転前の立方体の座標を原点中心で作る
        def make_cube(self):
            self.slist = []
            for num_a in range(-1,2,2):
                for num_b in range(-1,2,2):
                    self.slist.append([num_a*self.edge/2,num_b*self.edge/2,self.edge/2])
                    self.slist.append([num_a*self.edge/2,num_b*self.edge/2,-self.edge/2])
    
        # 立方体の中心を移動して透視投影
        def project(self):
            self.plist = []
            for element in self.slist:
                p = element[0]
                q = element[1] + self.center
                r = element[2]
                self.plist.append([self.distance*p/q,self.distance*r/q])
    
        # 回転処理
        def rotation(self):
            # x軸について回転
            for num_x in range(len(self.slist)):
                s = self.slist[num_x]
                self.slist[num_x] = [s[0],
                                     s[1]*self.cos(self.rotation_x)-s[2]*self.sin(self.rotation_x),
                                     s[1]*self.sin(self.rotation_x)+s[2]*self.cos(self.rotation_x)]
            # y軸について回転
            for num_y in range(len(self.slist)):
                s = self.slist[num_y]
                self.slist[num_y] = [s[2]*self.sin(self.rotation_y)+s[0]*self.cos(self.rotation_y),
                                     s[1],
                                     -s[0]*self.sin(self.rotation_y)+s[2]*self.cos(self.rotation_y)]
            # z軸について回転
            for num_z in range(len(self.slist)):
                s = self.slist[num_z]
                self.slist[num_z] = [s[0]*self.cos(self.rotation_z)-s[1]*self.sin(self.rotation_z),
                                     s[0]*self.sin(self.rotation_z)+s[1]*self.cos(self.rotation_z),
                                     s[2]]
    
        # 座標軸を100倍してtkinterのものに補正
        def offset(self,x,y):
            return (x*100+300,300-y*100)
    
        # self.plistから2つ選んで白線を引く
        def line(self,i1,i2):
            self.canvas.create_line(self.plist[i1][0],self.plist[i1][1],
                                    self.plist[i2][0],self.plist[i2][1],
                                    fill="white",tags="cubeline")
    
        # 三角関数を度数表記に修正
        def sin(self,theta):
            return math.sin(math.radians(theta))
    
        def cos(self,theta):
            return math.cos(math.radians(theta))
    
    
    c = Cube()
    c.draw()
    c.root.mainloop()
    

    ここではx軸に60°、y軸に30°回転させたものを描画させています。__init__\verb|__init__|関数内のself.rotation_x,self.rotation_y,self.rotation_z\verb|self.rotation_x,self.rotation_y,self.rotation_z|変数の値を変えれば回転角度を変えることができます。また、draw\verb|draw|関数のself.root.after\verb|self.root.after|の前にself.rotation_x += 1\verb|self.rotation_x += 1|のように変数を変化させる処理を追加すれば連続して回転する立方体を描くこともできます。

    5. 回転角度を制御できるようにする

    さて、プログラムはこのままでももちろん良いのですが、これだと回転角度を任意に変えたい際にいちいち再実行する必要があって大変ですね。そこで、サブウィンドウを作成してスライドバーで制御できるようにします。

    (1) tkinterでの2つのウィンドウの制御方法

    tkinter\verb|tkinter|で2つ以上のウィンドウを制御する場合は、1つと同じようにtk.Tk()\verb|tk.Tk()|で呼び出してはいけません。代わりにtk.Toplevel()\verb|tk.Toplevel()|を使います。他の制御方法は1つの方法と変わらず、変数名が変わるだけです。

    例としては以下のようになります。

    import tkinter as tk
    
    root = tk.Tk()
    canvas = tk.Canvas(root,width=600,height=600)
    canvas.pack()
    
    sub = tk.Toplevel()
    subcanvas = tk.Canvas(sub,width=300,height=300)
    subcanvas.pack()

    これを実行すると、600×600のメインウィンドウと300×300のサブウィンドウの2つが開きます。今回は使いませんが、3つ以上の場合でもtk.Toplevel()\verb|tk.Toplevel()|で対応できます。

    (2) tk.Scaleを利用したスライドバーの作成

    スライドバーを作成するにはtk.Scale\verb|tk.Scale|を使います。これを使うには以下のようにします。

    val = tk.DoubleVar(value=50)
    scale = tk.Scale(root,from_=0,to=100,orient="horizontal",variable=val,length=200)
    scale.place(x=10,y=10)
    n = val.get()

    1行目はバーの初期値の設定です。ここではvalue=50\verb|value=50|として初期値50にしています。
    2行目ではscale\verb|scale|の設定、引数については、root\verb|root|は良いとして、from_,to\verb|from_,to|はそれぞれ値の始点と終点を示し、orient\verb|orient|はバーの方向、variable\verb|variable|は先ほど設定した変数へのバーの値の代入、length\verb|length|はバー自体の幅(長さ)です。
    3行目では左上を(10,10)\verb|(10,10)|としてscale\verb|scale|を表示しています。
    バーの値を取り出したい場合は4行目のようにval.get()\verb|val.get()|とします。

    (3) 最終的な全体プログラム

    # モジュールのインポート
    import tkinter as tk
    import math
    
    # 処理用クラス
    class Cube():
        def __init__(self):
            # メインウィンドウの作成
            self.wid = 600
            self.hei = 600
            self.root = tk.Tk()
            self.root.resizable(0,0)
            self.root.title("Cube")
            self.root.wm_attributes("-topmost",1)
            self.canvas = tk.Canvas(self.root,width=self.wid,height=self.hei,
                                    bd=0,highlightthickness=0)
            self.canvas.pack()
            self.canvas.create_rectangle(0,0,self.wid,self.hei,fill="black")
            # 変数の初期化
            self.edge = 7
            self.distance = 2
            self.center = 12
            self.rotation_x = 60
            self.rotation_y = 30
            self.rotation_z = 0
            self.make_cube()
            self.project()
            # サブウィンドウの作成
            self.subwid = 400
            self.subhei = 200
            self.valuex = tk.DoubleVar(value=self.rotation_x)
            self.valuey = tk.DoubleVar(value=self.rotation_y)
            self.valuez = tk.DoubleVar(value=self.rotation_z)
            self.sub = tk.Toplevel()
            self.sub.resizable(0,0)
            self.sub.title("Settings")
            self.sub.wm_attributes("-topmost",1)
            self.subcanvas = tk.Canvas(self.sub,width=self.subwid,height=self.subhei,
                                       bd=0,highlightthickness=0)
            self.subcanvas.pack()
            self.scalex = tk.Scale(self.sub,from_=0,to=360,orient="horizontal",
                                   variable=self.valuex,length=self.subwid-30,label="θx")
            self.scaley = tk.Scale(self.sub,from_=0,to=360,orient="horizontal",
                                   variable=self.valuey,length=self.subwid-30,label="θy")
            self.scalez = tk.Scale(self.sub,from_=0,to=360,orient="horizontal",
                                   variable=self.valuez,length=self.subwid-30,label="θz")
            self.scalex.place(x=20,y=0)
            self.scaley.place(x=20,y=66)
            self.scalez.place(x=20,y=132)
    
        # 投影後の立方体の描画
        def draw(self):
            # 回転と透視投影処理
            self.make_cube()
            self.rotation()
            self.project()
            # 座標をtkinterに変換
            for num_n in range(len(self.plist)):
                self.plist[num_n]=self.offset(self.plist[num_n][0],self.plist[num_n][1])
            # 線の(再)描画
            self.canvas.delete("cubeline")
            self.line(0,1)
            self.line(0,4)
            self.line(1,5)
            self.line(4,5)
            self.line(2,3)
            self.line(2,6)
            self.line(3,7)
            self.line(6,7)
            self.line(0,2)
            self.line(4,6)
            self.line(1,3)
            self.line(5,7)
            self.root.after(50,self.draw)
    
        # サブウィンドウの描画
        def subdraw(self):
            self.rotation_x = self.valuex.get()
            self.rotation_y = self.valuey.get()
            self.rotation_z = self.valuez.get()
            self.root.after(50,self.subdraw)
        
        # 回転前の立方体の座標を原点中心で作る
        def make_cube(self):
            self.slist = []
            for num_a in range(-1,2,2):
                for num_b in range(-1,2,2):
                    self.slist.append([num_a*self.edge/2,num_b*self.edge/2,self.edge/2])
                    self.slist.append([num_a*self.edge/2,num_b*self.edge/2,-self.edge/2])
    
        # 立方体の中心を移動して透視投影
        def project(self):
            self.plist = []
            for element in self.slist:
                p = element[0]
                q = element[1] + self.center
                r = element[2]
                self.plist.append([self.distance*p/q,self.distance*r/q])
    
        # 回転処理
        def rotation(self):
            # x軸について回転
            for num_x in range(len(self.slist)):
                s = self.slist[num_x]
                self.slist[num_x] = [s[0],
                                     s[1]*self.cos(self.rotation_x)-s[2]*self.sin(self.rotation_x),
                                     s[1]*self.sin(self.rotation_x)+s[2]*self.cos(self.rotation_x)]
            # y軸について回転
            for num_y in range(len(self.slist)):
                s = self.slist[num_y]
                self.slist[num_y] = [s[2]*self.sin(self.rotation_y)+s[0]*self.cos(self.rotation_y),
                                     s[1],
                                     -s[0]*self.sin(self.rotation_y)+s[2]*self.cos(self.rotation_y)]
            # z軸について回転
            for num_z in range(len(self.slist)):
                s = self.slist[num_z]
                self.slist[num_z] = [s[0]*self.cos(self.rotation_z)-s[1]*self.sin(self.rotation_z),
                                     s[0]*self.sin(self.rotation_z)+s[1]*self.cos(self.rotation_z),
                                     s[2]]
    
        # 座標軸を100倍してtkinterのものに補正
        def offset(self,x,y):
            return (x*100+300,300-y*100)
    
        # self.plistから2つ選んで白線を引く
        def line(self,i1,i2):
            self.canvas.create_line(self.plist[i1][0],self.plist[i1][1],
                                    self.plist[i2][0],self.plist[i2][1],
                                    fill="white",tags="cubeline")
    
        # 三角関数を度数表記に修正
        def sin(self,theta):
            return math.sin(math.radians(theta))
    
        def cos(self,theta):
            return math.cos(math.radians(theta))
    
    
    c = Cube()
    c.draw()
    c.subdraw()
    c.root.mainloop()
    

    ファイルも貼っておきます。完全フリーにするのでご自由にお使いください。(使い道は不明)

    (4) 実行結果

    実行すると以下のような2つのウィンドウが出てくると思います。

    画像
    奥のIDLE Shellのウィンドウは気にしないでください…
    実行用のPythonのIDLEなので

    θx,θy,θzと書かれたバーをそれぞれいじると立方体が回転したように見えると思います。


    ~追記~
    今回の記事のネタで(自分の人生で)初めて3Dを扱うコードを書きましたが、思った以上に投影の式や回転を考えるのが大変でした(思いついてからは速かったですが)。また、今までマトモにclass\verb|class|を使ったことがなかったので多少構文が汚いと思いますがご容赦ください。そして、今回の記事を書くにあたってChatGPTを酷使した(むろんプログラムを全部書かせるなどということはしていませんが部分部分の考え方は参考にしました)ので、もしかしたら誤りやプログラムにバグがある可能性があります。見つけ次第直したいと思っているのでもし誤りなどあればコメントなどでご教示ください。



    >>>全記事ポータルページはこちら


    この記事が参加している募集

     
     
    数学とPythonが好きな人です。 主に数学と自作のPythonプログラムの解説記事を書いています。 最近はBVE関連にハマってます… X垢(主にBVE):https://x.com/__init__92435

    あなたへのおすすめ