ウィジェットとしてのシーン

SpringSceneView は、アプリのウィジェットの中の 3D シーンです。エンジンの SceneView にアプリのプロパティを適用したもので、シーンが描画されない場所では素のウィジェットになります。SpringSceneView.declarative は、子で記述された自分のシーンを持ちます。const SpringSceneView() は アプリケーションのシーン を表示します。

使う理由

エンジンが与えるのは、シーンを描画するビューです。アプリは、ビューごとに同じコードをその周りに書くことになります。エンジンを起動する、その間は別のものを表示する、デバイスがそもそも描画できるかを調べる、フレームを減らす、といったコードです。SpringSceneView は、それを spring.flutter.scene.* から一度で行います。

例

SpringSceneView.declarative(
  name: 'showroom',                       // デバッグタブでの名前
  placeholder: const ShowroomPicture(),   // 描画されるまで、または描画できない場所で
  children: [
    SpringSceneModel('hero'),             // spring.flutter.scene.models.hero
    SceneMesh(geometry: floor, material: concrete),
  ],
)

子はシーンウィジェットです。エンジンのもの (SceneNode、SceneMesh、SceneModel、ライト) と、スターターの SpringSceneModel (モデル を参照) です。ビューは自分のシーンを持ち、ウィジェットとともに解放します。

スターターがエンジンのビューの周りで行うこと

エンジンの SceneView の周りで、スターターは次のことを行います。

プレースホルダーがなければ、ビューは描画されるまで空です。

パラメーター

どちらのコンストラクターも、次のものを受け取ります。

パラメーター 型 デフォルト 意味
name String 'scene'。SpringSceneView() では 'application' デバッグタブ でのビューの名前
placeholder Widget? なし シーンが描画されるまで、そして描画できない場所ではずっと、代わりに表示されるもの
camera Camera? なし。SpringSceneView() ではプロパティのカメラ カメラ。camera と cameraBuilder はどちらか一つまで
cameraBuilder SceneCameraBuilder? なし シーンが動いてきた時間に応じた、フレームごとのカメラ
maxFrameRate double? プロパティの値 このビューが一秒あたりに描画する最大のフレーム数。max-frame-rate 以下。0 はプロパティが許す数をそのまま求める
pixelRatio double? プロパティの pixel-ratio ビュー独自のピクセル比
canvas SceneCanvas? プロパティの canvas ブラウザーでシーンが描かれるキャンバス。SceneCanvas.page、または SceneCanvas.layer (ページの下にあるシーン専用のキャンバスで、フレームが一枚ずつ受け渡される)。プロパティが canvas: engine なら、これが何であってもすべてのビューがエンジンのキャンバスに描かれる。ブラウザー以外では Flutter がシーンを描く
onTick SceneTickCallback? なし ビューが描画するフレームごとに、前のフレームからの時間とともに呼ばれる
loading ResourceGroup? なし ビューが表示の前に待つ読み込み。自分のシーンウィジェットの読み込みに加えて待つ (SpringSceneModel はこれがなくても待たれる)
warmUp bool true シーンのマテリアルのプログラムを、最初のフレームの前にコンパイルするようエンジンに求めるかどうか
children List<Widget> なし シーンウィジェット

SpringSceneView.declarative は、自分のシーンを照らし、表示するためのものも受け取ります。

パラメーター 型 デフォルト 意味
environment EnvironmentMap? エンジンのもの シーンを照らす画像
environmentIntensity double 1.0 environment がシーンを照らす強さ
exposure double 1.0 シーンの露出
toneMapping ToneMappingMode ToneMappingMode.pbrNeutral 明るい色を画面の範囲に収める方法

Camera、EnvironmentMap、ResourceGroup、ToneMappingMode はエンジンの型で、package:flutter_scene/scene.dart のものです。

静止フレーム

spring.flutter.scene.render: still のとき、spring.flutter.scene.when の条件が still を求めている間、またはシステムが動きを減らすよう求めているとき、ビューは一つのフレームを描画し、表示するものが変わったときだけ描画し直します。

void _recolor(BuildContext context, Color color) {
  material.baseColorFactor = color.linearWithAlpha;
  SpringSceneView.repaintOf(context); // 静止フレームが新しい色を表示する
}

ビューの中のアプリケーションのシーン

const SpringSceneView()

これは applicationScene Bean (spring.flutter.scene.app.enabled: true) のビューで、camera またはプロパティのカメラを通して見たものです。その children は、ビューが表示されている間、そのシーンに追加されます。そのようなシーンがなければ、プレースホルダーになります。アプリケーションのシーン を参照してください。

関連項目