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

objects_drawリファレンス

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

入力

入力内容既定値
SOURCEcostumecostume-groupvideotextmodel
ASSET資産名または資産選択値
TEXTtext描画時の文字列
VIDEO_MODEビデオのフレーム列再生またはタイムライン連動再生
FRAMEビデオまたはモデルのフレーム番号
SPEEDビデオ再生速度
VOLUMEオブジェクトビデオの音量
PXPYPZワールド位置0, 0, 480
RXRYRZ回転角
SXSYSZXYZスケール1, 1, 1
SIZEScratchサイズ相当の倍率100
WIDTHHEIGHT平面の幅・高さ倍率100, 100
T1T2描画する時間範囲0〜無限大

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

素材の種類

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

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

時間とフレーム

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

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

関連ページ