SetCameraPositionAndTarget_UpVecY

カメラの視点、注視点を設定する( 上方向はY軸から算出 )

SetCameraPositionAndTarget_UpVecY Position, Target

VECTOR Position : カメラの位置
VECTOR Target : カメラの注視点( 見ている座標 )

(プラグイン / モジュール : DxLibW)

解説

3Dソフトと言えば視点がグリグリ変わります、
この関数はその視点の位置と見ているものを指定する関数です。


カメラの姿勢は、視点、注視点と、あとカメラの上方向があれば決まりますが、
この関数はカメラの上方向をY軸のプラス方向を基本的なカメラの上方向として姿勢を算出します。

因みに、DXライブラリでは初期状態では視点の位置が x = 320.0f, y = 240.0f, z = ( 画面のサイズによって変化 )、
注視点の位置は x = 320.0f, y = 240.0f, z = 1.0f、カメラの上方向は x = 0.0f, y = 1.0f, z = 0.0f、
つまり画面のXY平面上の中心に居てZ軸のプラス方向を見るようなカメラになっています。

引数 Position と引数 Target は float x, y, z の三つのメンバ変数を持っている構造体 VECTOR で、
この3要素を使用して3次元の座標を指定します。

引数が構造体だと事前に引数に渡す構造体を宣言してメンバ変数に座標値を代入して・・・と準備が面倒ですが、
引数に x, y, z の値を渡すとそれを元にした VECTOR 構造体を戻り値で返してくれる関数 VGet を使用することで簡素に引数を渡すことができます。

戻り値:
  0:成功

関連項目

SetCameraPositionAndTarget_UpVecYDカメラの視点、注視点、アップベクトルを設定する( アップベクトルはY軸方向から導き出す )(DxLibW)
SetCameraNearFarカメラの 手前クリップ距離と 奥クリップ距離を設定する(DxLibW)
GetCameraPositionカメラの位置を取得する(DxLibW)
GetCameraTargetカメラの注視点を取得する(DxLibW)

情報

プラグイン / モジュールDxLibW
バージョン3.24f
作成日2026/04/12
著作者DxLib: Takumi Yamada / HSP binding: IronHSP Project
URLhttps://dxlib.xsrv.jp/
備考hspdxlib.as をインクルードして使用
タイプDxLib ゲームライブラリ
グループDxLib 3Dカメラ
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\hspdxlib.hs