SetFieldOfView

ExportSystemCamera.SetFieldOfView(fov)

カメラの視野角を設定します。
視野角は最小視野角と最大視野角の間で設定する必要があります。
アイテムの生成者以外が呼び出した場合は何もしません。

Parameters:

fov (number) -- カメラの垂直視野角[°]

Returns:

実行結果(0: 成功、その他: 失敗)

Return type:

number

説明

視野角を設定可能なカメラ

一部のカメラでのみ視野角を設定できます。

カメラ	視野角を設定可能か
モニターカメラ	NO
ハンディカメラ	YES
追従カメラ	YES
スイッチングカメラ	NO

ハンディカメラに表示される焦点距離について

ハンディカメラのプレビュー画面に表示される 50mm といった数値があります。
これはズームとともに連動する値で、現実のカメラではよく使われる「焦点距離」という指標です。
なおかつアスペクト比の違いを吸収するため、焦点距離の中でも対角換算での焦点距離を使用しています。
このようにハンディカメラでは分かりやすさのために焦点距離が使われています。
一方で SetFieldOfView で設定可能な値は垂直換算の視野角です。
ハンディカメラのプレビュー画面に表示されている焦点距離を基準に視野角を設定したい場合は次の計算で、対角換算の焦点距離から垂直換算の視野角を算出できます。

\[\begin{split}&視野角 = \frac{360}{\pi} \times \arctan{\left(\frac{D}{x \times 2 \sqrt{a^{2}+1}}\right)} \\ &\text{x: 35mm判換算焦点距離[mm]} \\ &\text{a: カメラのアスペクト比 (基本的に16/9)} \\ &\text{D: 35mmフルサイズセンサーの対角長 (≒43.27[mm])} \\\end{split}\]