iOS 12 SDK Bata 4 の SceneKit 変更内容

Beta 版から記事を起こしているため今後変更される可能性あり。

Apple のデベロッパーページのドキュメントの最初で SceneKit の仕様変更がなかったので気づかなかったが中身は変更されている模様。

Bata 4 の変更内容としてはいるが、自分の見落としで以前から変わっていたものかもしれない。

変更の概要

主には tvOS でジオメトリテッセレーションが使用できるようになったり、物理シミュレーションの物理ボディの設定変更など。
物理ボディの設定変更は多分 ARKit 2 の Sling Shot のサンプル制作の際に問題になったものだと思われる。

ちなみにジオメトリテッセレーションは A9 以降のチップ機能を使用するため、現状の Apple TV では 4K のものでしか動作させることはできない。

追加

SCNGeometry

tessellator

tvOS 12 で使用可能になった。

class SCNGeometryTessellator

tvOS 12 で使用可能になった。
以下、このクラスのプロパティの SDKs の表記が変更されたもの。
全て変更だが一応列挙しておく。

var smoothingMode: SCNTessellationSmoothingMode
enum SCNTessellationSmoothingMode
var edgeTessellationFactor: CGFloat
var insideTessellationFactor: CGFloat
var isAdaptive: Bool
var isScreenSpace: Bool
var maximumEdgeLength: CGFloat
var tessellationFactorScale: CGFloat
var tessellationPartitionMode: MTLTessellationPartitionMode

SCNPhysicsBody

var centerOfMassOffset: SCNVector3

ローカル座標の原点を基準とした、ボディの重心の位置。
長いハンドルと重い頭を持つハンマーのような質量の不均一なボディをシミュレートするために使用する模様。

var continuousCollisionDetectionThreshold: CGFloat

物理ボディとの接触を正確に検出するための最小移動間隔を設定する。

SceneKit が行う通常の物理シミュレーションではボディの速度に基づいて各物理ボディの位置を更新し、次のフレームで新しい位置のボディが他のボディと交差するかどうかを調べる。
continuousCollisionDetectionThreshold を 0 以上にすると連続的に衝突の検出が行われ、各フレームでボディから走査される領域を計算し、他のボディと衝突するかどうかを調べる。

例えば、何かを物体に投げるゲームでは、1回の処理でターゲットの厚さよりも遠くに球が移動するとターゲットから通過してしまうことがある。 continuousCollisionDetectionThreshold を弾と同じサイズにすると正確に衝突を検知できる。

通常の物理処理よりも重いらしいので多用は禁物。

func setResting(Bool)

物理ボディを Resting の状態を設定、または解除する。

物理シミュレーション時に物理ボディが他からの力の影響を受けていない場合、必要のない物理演算を省くため isResting が true となりの静止状態になる。
もし物理演算中に動作を強制的に変えたい場合、このパラメータを true にして変更する。

var linearSleepingThreshold: CGFloat

物理ボディが動くための必要な最小移動速度。

物理ボディの速度がこの値よりも低い場合、SceneKit は Resting の状態として扱う。デフォルト値は1秒あたり 0.1 単位。

値が大きいと速く止まり、値が小さいとゆっくり止まる。

var angularSleepingThreshold: CGFloat

物理ボディが動くための必要な最小角速度。

物理ボディの角速度がこの値よりも低い場合、SceneKit は Resting の状態として扱う。デフォルト値は1秒あたり 0.1 ラジアン。

値が大きいと速く止まり、値が小さいとゆっくり止まる。

変更

SCNNode

simdLook(at:)

引数を vector_float3 から simd_float3 に変更。

func simdLook(at worldTarget: vector_float3)

func simdLook(at worldTarget: simd_float3)

simdLook(at:up:localFront:)