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

objects_drawリファレンス

objects_drawは、Objectsで描画する素材と、そのフレーム内での状態を指定するブロックです。Objects UIが生成する資産セレクターの値も、ASSETとして扱われます。

入力​

入力内容既定値
SOURCEcostume、costume-group、video、text、model—
ASSET資産名または資産選択値—
TEXTtext描画時の文字列—
VIDEO_MODEビデオのフレーム列再生またはタイムライン連動再生—
FRAMEビデオまたはモデルのフレーム番号—
SPEEDビデオ再生速度—
VOLUMEオブジェクトビデオの音量—
PX、PY、PZワールド位置0, 0, 480
RX、RY、RZ回転角—
SX、SY、SZXYZスケール1, 1, 1
SIZEScratchサイズ相当の倍率100
WIDTH、HEIGHT平面の幅・高さ倍率100, 100
T1、T2描画する時間範囲0〜無限大

PX、PY、PZはスクリーン座標ではなくワールド位置です。3Dの回転、スケール、カメラとの関係はCameraと3Dを参照してください。

素材の種類​

SOURCE描画対象
costume1枚のコスチューム
costume-group複数コスチュームをまとめたグループ
videoフレーム列、またはタイムラインに同期した動画
textTEXTの文字列と登録フォント
model3Dモデルと、そのモデルに登録されたモーション

資産名が見つからない場合は、セレクターの実装に従って最初の資産へフォールバックします。描画対象の時刻がT1〜T2の範囲外なら、そのフレームでは描画しません。

時間とフレーム​

動画のFRAMEは、VIDEO_MODEに応じてフレーム列またはタイムライン連動再生に使われます。モデルのFRAMEはモデルアニメーションのフレームです。

objects_drawが生成するDrawノードは、現在フレームのframe graphに収集されます。ノードがScene内にあるかどうかで、通常の2D/Pen経路とThree.jsの共有深度バッファ経路が決まります。

関連ページ​