メインコンテンツまでスキップ

Scene クリップ

3D空間を表現するクリップタイプです。

1. 概要​

Scene クリップは、3D空間内にカメラ、ライト、メッシュなどを配置して立体表現を行うためのコンテナです。OpenMotion の強力な 3D レンダリングエンジンを使用して、動的な 3D シーンを構築できます。

[!TIP] Scene クリップ自体にカラー補正やフィルターなどのエフェクトを適用することも可能です。エフェクトの詳細な仕様については、Adjustment クリップ を参照してください。

2. プロパティ構成​

{
  "id": 1,
  "type": "scene",
  "start": 0,
  "duration": 300,
  "blendMode": "src-over",
  "properties": {
    "adjustments": [],
    "position": [0, 0],
    "scale": [1.0, 1.0],
    "rotation": 0,
    "opacity": 1.0,
    "fps": 0.0,
    "adjustments": [],
    "children": [
      {
        "id": 1,
        "type": "shape",
        "objectType": "Box",
        "name": "My Cube",
        "enabled": true,
        "visibility": "normal",
        "centerPoint": "center",
        "transform": {
          "position": [0, 0, 0],
          "rotation": [0, 0, 0],
          "scale": [1, 1, 1],
          "rotationOrder": "XYZ"
        },
        "properties": { "size": [10, 10, 10] },
        "material": {
          "type": "singlecolor",
          "properties": { "color": [1, 0, 0] }
        }
      }
    ]
  }
}

3. オブジェクトの基本構造 (SceneObject)​

シーンを構成する各要素の共通定義です。

3.1 共通プロパティ​

オブジェクトの用途や性質に応じた共通プロパティの定義です。

3.1.1 基本プロパティ (全オブジェクト共通)​

Camera, Light, Group, Shape 等、すべての要素が共通して持つプロパティです。

プロパティ型説明
idnumberオブジェクトの一意な識別子。
typeType大まかなカテゴリ（shape, light, etc.）。
objectTypestring具体的な種別（Box, Directional 等）。
namestringエディタ上の表示名。
enabledbooleanオブジェクト自体の有効/無効。
parentIdnumber親オブジェクトの ID（親子関係の設定）。
delayAnimatedValue親オブジェクトの動きに対する追従遅延（秒）。
rotationOriginstring親の回転を継承する際の中継点 (local: 自身, parent: 親)。
scaleOriginstring親の拡大を継承する際の中継点 (local: 自身, parent: 親)。
transformTransform位置、回転、スケールの情報。
propertiesobject各種別固有のパラメータ。

3.1.2 描画プロパティ (描画オブジェクト専用)​

Shape, Text, Model, Particles 等、3D空間に「実体」として描画されるオブジェクトのみが持つプロパティです。

プロパティ型説明
visibilitystring表示設定 (normal, reflections only, scene + reflections)。
centerPointstring変形の中心点（アンカーポイント）。
materialobject表面の質感（マテリアル）の設定。

3.1.3 遅延追従 (Delayed Follow)​

[!IMPORTANT] delay プロパティを設定すると、そのオブジェクトは親オブジェクトの動き（位置・回転・スケール）に対して、指定した秒数分だけ「遅れて」追従するようになります。これは Null オブジェクトだけでなく、Shape や Light などすべてのオブジェクトで利用可能です。

3.2 トランスフォーム (Transform Object)​

3D空間上の配置情報を管理する再利用可能なオブジェクトです。

プロパティ型説明デフォルト
positionAnimatedValue[3][x, y, z] の座標。[0, 0, 0]
rotationAnimatedValue[3][x, y, z] の回転角（度）。[0, 0, 0]
scaleAnimatedValue[3][x, y, z] の拡大率。[1, 1, 1]
rotationOrderstring回転の適用順序 (XYZ, YXZ, ZXY 等)。XYZ

3.3 カテゴリと種別 (objectType) 一覧​

カテゴリ (type)主な種別 (objectType)
shapeBox, Cylinder, Rectangle, Circle, Sphere, Donut, Wire, Curve
lightSpot, Point, Directional, Hemisphere
text(標準)
particles(標準)
group(標準)
null(標準)
cameraPerspective, Orthographic
model(標準)

4. オブジェクト詳細仕様​

各オブジェクトは、3. オブジェクトの基本構造 で定義された共通プロパティ（enable, visibility, transform 等）をすべて含みます。ここでは、各種別固有の properties の内容について解説します。

4.1 Shape (形状)​

4.1.1 Box​

立方体または直方体。

Properties (固有):

プロパティ型説明
sizeAnimatedValue[3][幅, 高さ, 奥行き] のサイズ。

4.1.2 Cylinder​

円柱・円錐。

Properties (固有):

プロパティ型説明
sizeAnimatedValue[3][上面半径, 底面半径, 高さ] のサイズ。
detailnumber円周方向の分割数。
endFacesstring端面の状態 (closed, open)。

4.1.3 Rectangle​

2D 矩形平面。

Properties (固有):

プロパティ型説明
sizeAnimatedValue[2][幅, 高さ] のサイズ。

4.1.4 Circle​

2D 円形平面。

Properties (固有):

プロパティ型説明
radiusAnimatedValue半径。
detailnumber円周方向の分割数。

4.1.5 Sphere​

球体。

Properties (固有):

プロパティ型説明
radiusAnimatedValue半径。
detailnumber[2][水平方向, 垂直方向] の分割数。

4.1.6 Donut​

トーラス（ドーナツ型）。

Properties (固有):

プロパティ型説明
sizeAnimatedValue[2][全体の半径, 管の太さ] のサイズ。
detailnumber[2][円環方向, 管方向] の分割数。

4.1.7 Wire​

直線・コイル状の線。

Properties (固有):

プロパティ型説明
sizeAnimatedValue[3][幅, 高さ, 奥行き] のサイズ。
thicknessAnimatedValue線の太さ。
loopsnumberコイルの巻き数。
detailnumber[2][分割数1, 分割数2]。

4.1.8 Curve​

Cubic Bezier を使用した 3D 曲線。

Properties (固有):

プロパティ型説明
pointsobject[]ベジェ曲線の制御点データ（座標とハンドル）。
detailnumber曲線の分割数。
startAnimatedValue描画開始地点 (0.0 - 1.0)。
endAnimatedValue描画終了地点 (0.0 - 1.0)。

4.2 Light (光源)​

シーンを照らすライト。以下のプロパティはすべてのライトで共通です。

Properties (共通):

プロパティ型説明
colorAnimatedValue[3]光の色（RGB）。
intensityAnimatedValue光の強度。

4.2.1 Spot​

円錐状に照らすスポットライト。

Properties (固有):

プロパティ型説明
targetAnimatedValue[3]照らす対象の座標 [x, y, z]。
angleAnimatedValue照射角（度）。

[!TIP] 光源自体の位置は共通プロパティの transform.position を使用します。target を指定することで、ライトの向きを自動的に制御できます。

4.2.2 Point​

全方位を照らす点光源。固有のプロパティはなく、共通プロパティ（Color, Intensity）とトランスフォームで制御します。

4.2.3 Directional​

特定の方向から平行に降り注ぐ光（太陽光や広範囲を照らす面光源）。

Properties (固有):

プロパティ型説明
targetAnimatedValue[3]照らす対象の座標 [x, y, z]。

4.2.4 Hemisphere​

空と地面の色を模した半球状の環境光源。シーン全体に自然な陰影を与えます。

Properties (固有):

プロパティ型説明
skyColorAnimatedValue[3]空（上方向）の色。
groundColorAnimatedValue[3]地面（下方向）の色。

[!NOTE] ※ Hemisphere の場合、共通の color プロパティは全体の乗算色として機能します。通常は skyColor と groundColor を使用します。

4.3 Text (テキスト)​

3D空間に配置可能なテキスト。

Properties (固有):

プロパティ型説明
textstring表示する文字列。
fontstringフォント名またはアセット ID。
sizeAnimatedValue[2][フォントサイズ, 押し出しの厚み]。
detailnumber曲線の分割数。
bevelbooleanベベル（面取り）を有効にするか。
bevelSizeAnimatedValue[2][ベベルの厚み, ベベルのサイズ]。

4.4 Particles (パーティクル)​

火花、煙、雪などのパーティクルシステム。

Properties (固有):

プロパティ型説明
timeAnimatedValueパーティクルの経過時間。
colorGradient寿命（Lifetime）に応じた色の変化。※
sizeGradient寿命に応じたサイズの変化。※
numbernumber最大パーティクル数。
emitterRatenumber1秒あたりの放出量。
lifetimenumber個々のパーティクルの寿命。
positionModestring放出領域の形状 (box, sphere 等)。
positionSpreadnumber[3]放出位置のばらつき範囲。
speednumber[3]初速度。
speedSpreadnumber[3]速度のばらつき範囲。
gravitynumber[3]重力加速度。

[!NOTE] ※ Gradient（グラデーション）オブジェクトのデータ構造については現在策定中です。今後のアップデートにより実装予定です。

4.5 Group (グループ)​

複数のオブジェクトをまとめ、親子関係や共通のトランスフォームを適用するためのコンテナ。

Properties (固有):

プロパティ型説明
controlsProperty[]ユーザー定義のカスタムパラメータ群。

[!TIP] controls に定義した値は、グループ内の子要素のプロパティにおいて、エクスプレッション（数式）から parent.key（または parent["key"], parent['key']）のように参照することができます。これにより、複数のオブジェクトを一つのコントロールで一括制御する「リグ（Rig）」を構築可能です。詳細は Property Object を参照してください。

4.6 Camera (カメラ)​

シーンを撮影する視点。以下のプロパティはすべてのカメラで共通です。

Properties (共通):

プロパティ型説明
shakeAmountAnimatedValue手ぶれの強さ。
shakeSpeedAnimatedValue手ぶれの速さ。
shakeModestring手ぶれの反映方式 (rotate, translate 等)。
amplitudeAnimatedValue[4]各軸（あるいは成分）の振幅。
frequencyAnimatedValue[4]各軸の周波数。
phaseAnimatedValue[4]各軸の位相（タイミングのずれ）。
noiseAnimatedValue[4]ノイズの混入率。
smoothnumber[4]動きの滑らかさ。

4.6.1 Perspective (遠近)​

遠近感のある 3D レンダリング用のカメラ。

Properties (固有):

プロパティ型説明
fovAnimatedValue視野角（Field of View）。

4.6.2 Orthographic (平行)​

遠近感のない 2D 的なレンダリング用のカメラ。

Properties (固有):

プロパティ型説明
zoomAnimatedValueズーム倍率。

4.7 Model (モデル)​

glTF, GLB, OBJ 形式の外部モデル。

Properties (固有):

プロパティ型説明
assetIdstring使用する 3D モデルアセットの ID。
animationIndexnumber使用するアニメーションの番号。
animationTimeAnimatedValueアニメーションの再生位置（秒）。

4.8 Null (ヌル)​

描画されない不可視の制御用オブジェクト。主に他のオブジェクトの親として、構造を整理したり、複雑な動きをリグ（Rig）として管理するために使用します。

固有のパラメータはありません。共通プロパティの parentId や delay を活用して、システム上の補助的なハンドルとして機能します。

5. Material Object (マテリアル)​

5.1 共通構造​

プロパティ型説明
typestringマテリアルの種別。
blendingBlendMode合成モード。詳細は 合成モード仕様 を参照。
sidestring描画する面 (front, back, both)。
reflectionboolean環境反射の有効化。
propertiesobjectタイプ固有のパラメータ。

5.2 マテリアルタイプ一覧​

singlecolor, image, video, custom, original

(詳細は各節を参照)

5.3 TextureMap Object​

プロパティ型説明
assetIdstring画像アセットの ID。
wrapstring折り返し (none, tile, reflect)。
repeatAnimatedValue[2]繰り返し回数。
offsetAnimatedValue[2]位置のずれ。
centerAnimatedValue[2]変形の中心点。
rotationAnimatedValue回転角。