プチコン3号＆BIGまとめWiki

パンくずリスト

• トップ
• Toukou
• 3Dライブラリー 「SBTD」

2018年10月22日投稿 / 2020年1月4日更新 / 投稿者 : しんスタイル / タグ : 投稿プログラム 3D ライブラリ

概要

※画像はイメージです。3Dがわかりやすいように色を変えています。

• 「Smile Basic Three Dimensions」、略して「SBTD」です
• プチコン3号&BIGの3D表示ライブラリーです
• なんと3DSでも毎秒約4000ポリゴンも描画できます*1

使い方

「TD○○」というファイルのうち、使いたいバージョンの中身をライブラリーを使うプログラムに全部コピーしてください

注意

• 極力「TD○○」という変数名や関数名の定義は避けてください。思わぬ動作をする場合があります
• レンダリングしてからコピーするため、使用するGRP以外にもう一つGRPを開けておいてください(デフォルトはGRP3)
• 右手座標系です。←間違えていました。左手座標系(z座標が大きいほど奥へ行く)です
• 予告もなしに仕様を変更することだあります(α1.1→ver1.1が特に顕著)
• 立体視には対応していません

仕様

α1.1

• ポリゴンを設定してから回転・平行移動などを指定する
• カメラとポリゴンは設定上は独立している

ver 1.1~

• 内部で行列を使用し、ポリゴンを回転させる
• 〇penglや〇irect3〇に似たものになっている

パッチノート

α1.1

• 記念すべき最初のバージョン

ver 1.1

変更

• 大幅に仕様変更
  • これにより、〇penglや〇irect3〇に近い仕様に
• 全体的にかなりの軽量化
• TDADDQUADの座標の指定方法が時計回りか反時計回りになった

追加

• 新命令:
  • TDROTATE
  • TDTRANSLATE
  • TDSCALE
  • TDRESETMATRIX
  • TDPUSHMATRIX
  • TDPOPMATRIX
  • TDSETMATRIX
  • TDSETLOOKAT

削除

• 命令
  • TDROTATEPOLYGON
  • TDROTATEQUAD
  • TDSETCAMERA
  • TDSETCAMERAANGLE

ver 1.1.1

変更

• 軽量化:
  • TDDRAWを若干軽量化
• TDORTHOMODEがTRUE/FALSEを指定できなくなった
• 沢山のコメントアウトを削除
• エラーを日本語化

追加

• 新命令:
  • TDADDPOLYGONS
  • TDADDQUADS
  • TDRESETFV

ver 1.1.2

変更

• 関数内でエラーが起きた時にスタックトレースが表示されるように

修正

• プログラム
  • TDDRAWにおいて全画面表示以外は変な表示になる
• 誤値
  • TDADDPOLYGONSのエラーの冒頭近くがTDADDPOLYGONS:TDADDQUADS:になっている
  • TDRESETFVの簡易説明が「へいこうとうえいのせってい」になっている

命令表

+

α1.1

+   ポリゴン 命令 TDCLEAR 説明 ポリゴンを全削除します ただし、ポリゴン以外はリセットされません 引数 なし 命令 TDSETCOLOR 説明 ポリゴンの色を設定します 次に色を変えるまでこの色のままです 引数 col% ポリゴンの色 命令 TDADDPOLYGON 説明 ポリゴンを追加します 引数 x1 ポリゴンの1つ目の点のx座標 y1 ポリゴンの1つ目の点のy座標 z1 ポリゴンの1つ目の点のz座標 x2 ポリゴンの2つ目の点のx座標 y2 ポリゴンの2つ目の点のy座標 z2 ポリゴンの2つ目の点のz座標 x3 ポリゴンの3つ目の点のx座標 y3 ポリゴンの3つ目の点のy座標 z3 ポリゴンの3つ目の点のz座標 命令 TDADDQUAD 説明 四角形を追加します 実際は(点1,点3,点4)と(点1,点2,点4)のポリゴンを追加しています 引数 x1 四角形の1つ目の点のx座標 y1 四角形の1つ目の点のy座標 z1 四角形の1つ目の点のz座標 x2 四角形の2つ目の点のx座標 y2 四角形の2つ目の点のy座標 z2 四角形の2つ目の点のz座標 x3 四角形の3つ目の点のx座標 y3 四角形の3つ目の点のy座標 z3 四角形の3つ目の点のz座標 x4 四角形の4つ目の点のx座標 y4 四角形の4つ目の点のy座標 z4 四角形の4つ目の点のz座標 命令 TDROTATEPOLYGON 説明 直前に追加したポリゴンを回転します 引数 angle 回転する角度 axis 回転軸(x軸:0,y軸:1,z軸:2) cx 軸のx座標 cy 軸のy座標 cz 軸のz座標 命令 TDROTATEQUAD 説明 直前に追加した四角形を回転します 挙動的には、直前に追加したポリゴン二つを回転します 引数 angle 回転する角度 axis 回転軸(x軸:0,y軸:1,z軸:2) cx 軸のx座標 cy 軸のy座標 cz 軸のz座標 命令 TDDRAW 説明 現在の操作ページに描画します 引数 x 描画をする左上のx座標 y 描画をする左上のy座標 w 描画をする幅 h 描画をする高さ +   設定 命令 TDSETRENDERPAGE 説明 レンダリングするページを指定します 引数 page% レンダリングするページ 命令 TDSETBACKGROUNDCOLOR 説明 ポリゴンが表示されない部分の色を指定します いわゆる背景です 引数 col% 背景の色 命令 TDSETWIREFRAMEMODE 説明 ワイヤーフレームを表示するかポリゴンを表示するかを設定します(ポリゴンの方が軽い) 引数 fmode TRUEでワイヤーフレーム、FALSEでポリゴン 命令 TDSETORTHOMODE 説明 透視投影か平行投影かを設定します 引数 omode TRUEで平行投影,FALSEで透視投影 命令 TDSETFV 説明 視野を設定します 引数 hfv 水平方向の視野 vfv 垂直方向の視野 命令 TDSETWAIT 説明 レンダリング後の待ち時間を設定します ちらつかないのでほぼ意味ないです 引数 w 待ち時間 +   カメラ 命令 TDSETCAMERA 説明 カメラの座標を設定します 引数 x カメラのx座標 y カメラのy座標 z カメラのz座標 命令 TDSETCAMERAANGLE 説明 オイラー角でカメラの回転をします 引数 ax カメラのx軸の回転角 ay カメラのy軸の回転角 az カメラのz軸の回転角 order カメラの回転の順番(下記) 回転の順番 0 x-y-z 6 x-y-x 1 x-z-y 7 x-z-x 2 y-x-z 8 y-x-y 3 y-z-x 9 y-z-y 4 z-x-y 10 z-x-z 5 z-y-x 11 z-y-z

+

ver 1.1

+   ポリゴン 命令 TDCLEAR 説明 ポリゴンを全削除します ただし、ポリゴン以外はリセットされません 引数 なし 命令 TDSETCOLOR 説明 ポリゴンの色を設定します 次に色を変えるまでこの色のままです 引数 col% ポリゴンの色 命令 TDADDPOLYGON 説明 ポリゴンを追加します 引数 x1 ポリゴンの1つ目の点のx座標 y1 ポリゴンの1つ目の点のy座標 z1 ポリゴンの1つ目の点のz座標 x2 ポリゴンの2つ目の点のx座標 y2 ポリゴンの2つ目の点のy座標 z2 ポリゴンの2つ目の点のz座標 x3 ポリゴンの3つ目の点のx座標 y3 ポリゴンの3つ目の点のy座標 z3 ポリゴンの3つ目の点のz座標 命令 TDADDQUAD 説明 四角形を追加します 時計回りか、反時計回りに指定します 引数 x1 四角形の1つ目の点のx座標 y1 四角形の1つ目の点のy座標 z1 四角形の1つ目の点のz座標 x2 四角形の2つ目の点のx座標 y2 四角形の2つ目の点のy座標 z2 四角形の2つ目の点のz座標 x3 四角形の3つ目の点のx座標 y3 四角形の3つ目の点のy座標 z3 四角形の3つ目の点のz座標 x4 四角形の4つ目の点のx座標 y4 四角形の4つ目の点のy座標 z4 四角形の4つ目の点のz座標 命令 TDROTATE 説明 クォータニオンを使ってポリゴンを回転させます これを呼び出した後のポリゴンにはすべてこの回転がかかります 引数 angle 回転する角度 cx 軸のベクトルのx成分 cy 軸のベクトルのy成分 cz 軸のベクトルのz成分 命令 TDTRANSLATE 説明 ポリゴンを平行移動させます これを呼び出した後のポリゴンにはすべてこの平行移動がかかります 引数 tx x軸に平行な移動量 ty y軸に平行な移動量 tz z軸に平行な移動量 命令 TDSCALE 説明 ポリゴンを拡大・縮小させます これを呼び出した後のポリゴンにはすべてこの拡大・縮小がかかります 平行移動にもこの拡大・縮小がかかることに注意してください 引数 tx x軸に平行な移動量 ty y軸に平行な移動量 tz z軸に平行な移動量 +   行列 命令 TDRESETMATRIX 説明 行列をリセットします つまり、回転や平行移動などがリセットされます 引数 なし 命令 TDPUSHMATRIX 説明 行列を保存します モデル単体で回転させたいときに便利です 引数 なし 命令 TDPOPMATRIX 説明 保存した行列をとりだし、現在の行列にします 保存した順番とは逆の順番でとりだされます 引数 なし エラー STACK UNDERFLOW 行列が足りない 命令 TDSETMATRIX 説明 行列を設定します 引数 m00~m33 〇penglを参考にしてください m30~m33は設定しても無意味です。 +   設定 命令 TDSETRENDERPAGE 説明 レンダリングするページを指定します 引数 page% レンダリングするページ 命令 TDSETBACKGROUNDCOLOR 説明 ポリゴンが表示されない部分の色を指定します いわゆる背景です 引数 col% 背景の色 命令 TDSETWIREFRAMEMODE 説明 ワイヤーフレームを表示するかポリゴンを表示するかを設定します(ポリゴンの方が軽い) 引数 fmode TRUEでワイヤーフレーム、FALSEでポリゴン 命令 TDSETORTHOMODE 説明 透視投影か平行投影かを設定します 引数 omode TRUEで平行投影,FALSEで透視投影 命令 TDSETFV 説明 視野を設定します 引数 hfv 水平方向の視野 vfv 垂直方向の視野 命令 TDSETWAIT 説明 レンダリング後の待ち時間を設定します ちらつかないのでほぼ意味ないです 引数 w 待ち時間 +   描画 命令 TDDRAW 説明 現在の操作ページに描画します 引数 x 描画をする左上のx座標 y 描画をする左上のy座標 w 描画をする幅 h 描画をする高さ +   カメラ 命令 TDSETLOOKAT 説明 カメラの座標や向きを設定します 引数 ex カメラのx座標 ey カメラのy座標 ez カメラのz座標 cx カメラが見るx座標 cy カメラが見るy座標 cz カメラが見るz座標 ux カメラの上方向のベクトルのx成分 uy カメラの上方向のベクトルのy成分 uz カメラの上方向のベクトルのz成分

+

ver 1.1.1

+   ポリゴン 命令 TDCLEAR 説明 ポリゴンを全削除します ただし、ポリゴン以外はリセットされません 引数 なし 命令 TDSETCOLOR 説明 ポリゴンの色を設定します 次に色を変えるまでこの色のままです 引数 col% ポリゴンの色 命令 TDADDPOLYGON 説明 ポリゴンを追加します 引数 x1 ポリゴンの1つ目の点のx座標 y1 ポリゴンの1つ目の点のy座標 z1 ポリゴンの1つ目の点のz座標 x2 ポリゴンの2つ目の点のx座標 y2 ポリゴンの2つ目の点のy座標 z2 ポリゴンの2つ目の点のz座標 x3 ポリゴンの3つ目の点のx座標 y3 ポリゴンの3つ目の点のy座標 z3 ポリゴンの3つ目の点のz座標 命令 TDADDPOLYGONS 説明 ポリゴンを配列を使って追加します 引数 xa ポリゴンのx座標の配列 ya ポリゴンのy座標の配列 za ポリゴンのz座標の配列 off% 配列のオフセット この番号から指定される len% 指定するポリゴンの数 エラー OFF%+LEN%*3が一番短い配列の長さより大きい 命令 TDADDQUAD 説明 四角形を追加します 時計回りか、反時計回りに指定します 引数 x1 四角形の1つ目の点のx座標 y1 四角形の1つ目の点のy座標 z1 四角形の1つ目の点のz座標 x2 四角形の2つ目の点のx座標 y2 四角形の2つ目の点のy座標 z2 四角形の2つ目の点のz座標 x3 四角形の3つ目の点のx座標 y3 四角形の3つ目の点のy座標 z3 四角形の3つ目の点のz座標 x4 四角形の4つ目の点のx座標 y4 四角形の4つ目の点のy座標 z4 四角形の4つ目の点のz座標 命令 TDADDQUADS 説明 四角形を配列を使って追加します TDADDQUADと同じく、時計回りか、反時計回りに指定します 引数 xa 四角形のx座標の配列 ya 四角形のy座標の配列 za 四角形のz座標の配列 off% 配列のオフセット この番号から指定される len% 指定する四角形の数 エラー OFF%+LEN%*4が一番短い配列の長さより大きい 命令 TDROTATE 説明 クォータニオンを使ってポリゴンを回転させます これを呼び出した後のポリゴンにはすべてこの回転がかかります 引数 angle 回転する角度 cx 軸のベクトルのx成分 cy 軸のベクトルのy成分 cz 軸のベクトルのz成分 命令 TDTRANSLATE 説明 ポリゴンを平行移動させます これを呼び出した後のポリゴンにはすべてこの平行移動がかかります 引数 tx x軸に平行な移動量 ty y軸に平行な移動量 tz z軸に平行な移動量 命令 TDSCALE 説明 ポリゴンを拡大・縮小させます これを呼び出した後のポリゴンにはすべてこの拡大・縮小がかかります 平行移動にもこの拡大・縮小がかかることに注意してください 引数 tx x軸に平行な移動量 ty y軸に平行な移動量 tz z軸に平行な移動量 +   行列 命令 TDRESETMATRIX 説明 行列をリセットします つまり、回転や平行移動などがリセットされます 引数 なし 命令 TDPUSHMATRIX 説明 行列を保存します モデル単体で回転させたいときに便利です 引数 なし 命令 TDPOPMATRIX 説明 保存した行列をとりだし、現在の行列にします 保存した順番とは逆の順番でとりだされます 引数 なし エラー スタックアンダーフロー 行列が足りない 命令 TDSETMATRIX 説明 行列を設定します 引数 m00~m33 〇penglを参考にしてください m30~m33は設定しても無意味です。 +   設定 命令 TDSETRENDERPAGE 説明 レンダリングするページを指定します 引数 page% レンダリングするページ 命令 TDSETBACKGROUNDCOLOR 説明 ポリゴンが表示されない部分の色を指定します いわゆる背景です 引数 col% 背景の色 命令 TDSETWIREFRAMEMODE 説明 ワイヤーフレームを表示するかポリゴンを表示するかを設定します(ポリゴンの方が軽い) 引数 fmode TRUEでワイヤーフレーム、FALSEでポリゴン 命令 TDSETFV 説明 視野を設定します 引数 hfv 水平方向の視野 vfv 垂直方向の視野 命令 TDRESETFV 説明 視野をリセットします 引数 なし 命令 TDSETORTHOMODE 説明 平行投影に設定します 引数 なし 命令 TDSETWAIT 説明 レンダリング後の待ち時間を設定します ちらつかないのでほぼ意味ないです 引数 w 待ち時間 +   描画 命令 TDDRAW 説明 現在の操作ページに描画します 引数 x 描画をする左上のx座標 y 描画をする左上のy座標 w 描画をする幅 h 描画をする高さ +   カメラ 命令 TDSETLOOKAT 説明 カメラの座標や向きを設定します 引数 ex カメラのx座標 ey カメラのy座標 ez カメラのz座標 cx カメラが見るx座標 cy カメラが見るy座標 cz カメラが見るz座標 ux カメラの上方向のベクトルのx成分 uy カメラの上方向のベクトルのy成分 uz カメラの上方向のベクトルのz成分

既知のバグ

• Zソート法を採用しているので前後がおかしくなることがある
• ポリゴン同士が交差すると正常に描画されない

プログラム

• TDDRAWにおいて全画面表示以外は変な表示になる(ver1.1.2で修正)

誤値

• TDADDPOLYGONSのエラーの冒頭近くがTDADDPOLYGONS:TDADDQUADS:になっている(ver1.1.2で修正)
• TDRESETFVの簡易説明が「へいこうとうえいのせってい」になっている(ver1.1.2で修正)

テストプログラムについて

TD_TEST1

TD_TEST2

※重たいのは500ポリゴンを表示しているため

公開キー

プチコン3号用の公開キーです。トップメニューの「作品公開とダウンロード」から公開キーを入力すると、作品をダウンロードすることができます。

+

以前のバージョン

ver α1.1 ver α1.1 公開終了 ver 1.1 ver 1.1 公開終了 ver 1.1.1 ver 1.1.1 公開終了

ver 1.1.2

CHECKER FLAG (ひとことコメント)

バグや感想などがあれば、どうぞ。(作品に直接関係ない質問や雑談は掲示板へ)

お名前: