siv3Dチュートリアル逆引き辞典

まえおき

可能性しか感じないsiv3Dの求めている関数がいまいち見つからないチュートリアルのメモ書きです。中の人の学習が進み次第追記しておきます。あの関数、チュートリアルのどこに書いてあったっけというときにご利用ください。

公式サイトのclass一覧でよくね？それはそう。
ヘッダ読め？それはそう。

凡例

分類(その関数がやること)

ひとことコメント

• 関数
• 関数
  • 引数に指定するclassやら構造体やら//補足コメント

<チュートリアルのURL>

システム系

処理タイミング調整

画面更新タイミングに合わせて処理を進めてくれるありがたいやつ。

• System::Update()

※3記事ぐらい連続して記載

データ型一覧

stdライブラリの上位互換？なあれこれ達。

画面の座標系について

※冒頭

前フレームからの経過時間を取得

• Scene::DeltaTime()

ライセンス関係

ライセンスの表示、追加

• LicenseManager::ShowInBrowser()
• LicenseManager::AddLicense()

文字コード関係

• UTF-32で文字列を表記する際の注意

forループ

画面表示系

文字列簡易表示

std<<coutのようなもの

• Print << ○○
• ClearPrint()

std::format()のようなもの

• U"{}"_fmt(x)

背景色

背景色変更

• Scene::SetBackground()
  • Palette:://色名がまとめられている
  • ColorF{}//RGBで指定
  • HSV{}//HSVで指定

図形を描く

基本的な円、四角形、四角枠の描画

• Circle//円を描画するためのクラス
• Rect//四角形を描画するための準備
• RectF//RectF型はパラメータをdoubleで指定できる
• インスタンス名.draw()//描画
• インスタンス名.drawFrame()//枠のみ描画

発展的な円の描画

• グラデーション
• Circle.draw()//描画
• Point.asCircle{}//Point型インスタンスの指す位置を中心とした円(描画はまだ)
• Vec2.asCircle{}//Vec2型インスタンスの指す位置を中心とした円(描画はまだ)
• Circle.drawFrame()//枠を描画
• Circle.drawPie()//扇形を描画
• Circle.drawArc()//円弧を描画
• Circle.drawSegment//弓形を描画

発展的な四角形、四角枠の描画

• グラデーション
• Rect.draw()//描画
  • Size//四角形のサイズを入れれるクラス
  • SizeF//四角形のサイズを入れれるクラス
• Rect.drawFrame

線を描画

• Line//円を描画するためのクラス
• Line.draw()

三角形を描画

• Triangle//三角形を描画するためのクラス
• Triangle型インスタンス.draw()//描画

辺が平行でない四角形を描画

• Quad//三角形を描画するためのクラス
• Quad.draw()//描画
• Rect.rotated()//Rect型を回転させてQuad型に変換
• Rect.rotatedAt()//Rect型を回転させてQuad型に変換
• Rect.shearedX()//Rect型を平行四辺形にしてQuad型に変換
• Rect.shearedY()//Rect型を平行四辺形にしてQuad型に変換

絵文字を表示

絵文字のテクスチャ生成、表示

• Texture インスタンス名{}
• インスタンス名.drawAt()
• インスタンス名.scaled().drawAt()//大きさを変えて表示
• インスタンス名.rotated().drawAt()//回転して表示
• インスタンス名.mirrored().drawAt()//左右反転して表示

文字を表示

文字を任意の場所、サイズ、フォントで表示。
つよつよsiv3Der曰く、Fontのoperator () (関数呼び出し演算子)は文字列を受け取ってDrawableTextを返すという実装とのこと。(draw()の宣言はDrawableTextに書かれている)。

• Font インスタンス名{}
  • FontMethod:://フォントの描画方式
  • Typeface:://文字の太さを
• font().draw()
• font().drawat()//座標の基準点を指定して表示
  • Arg:://座標の基準点

マウスカーソルの形を変更

• Cursor::RequestStyle()
  • CursorStyle::

入力系

ショートカットキー変更

ソフトウエア終了操作を変更。

• System::SetTerminationTriggers()
  • UserAction:://キーの種類がまとめられている

スクリーンショット操作を変更

• ScreenCapture::SetShortcutKeys()

特定のキーが押されたか確認

• キー名.down()//押した瞬間のみ
• キー名.pressed()//押している間ずっと

特定のマウスボタンが押されたか確認

おそらくキーボードと同じ関数が使える。

• キー名.down()

マウスポインタの座標を取得

Vec2型と互換性あり。

• Cursor::Pos()

図形がクリックされたか判定

もちろん右クリック用関数もあります。

• 図形のインスタンス名.leftClicked()

マウスポインタが図形の上にあるか判定

• 図形のインスタンス名.mouseOver()

出力系

演算系

ラジアンと度数法の変換

• 角度_deg//度数法をラジアンに計算してくれるoperatorが実装されている