GetShotClip

導入

v12.0 (2014)

説明

フレームのシーケンス時間が指定された Clip を検索します。

スクリプト構文

GetShotClip( Frame, [GlobalFrame], [Clip], [DirectlyOver], [ActiveCamera] );

パラメータ

パラメータ タイプ 説明
Frame Double シーケンス時間のフレーム数。
GlobalFrame Double シーン時間のフレーム数をリマップした時間を返します。不要な場合は、グローバル フレームの計算を回避するために -1 に設定することをお勧めします。処理時間が短縮されます。

デフォルト値: -1

Clip Clip 現在のシーケンス時間でのショット クリップを返します。
DirectlyOver Boolean 要求されたフレームが ShotClip のタイム スパン内に直接存在する場合は true、それ以外の場合は false を返します。
ActiveCamera カメラ(Camera) ShotClip で使用されているカメラを返します。

1. VBScript の例

Application.NewScene "", false

Application.AddShotClip , "SampleClip", "Camera", 5, 1, 20

globalFrame = -1	'global frame time will not be calculate and will return -1.

Application.GetShotClip 20, globalFrame, oClip, bDirectly, oActiveCam

Application.LogMessage globalFrame

Application.LogMessage oClip

Application.LogMessage bDirectly

Application.LogMessage oActiveCam

'OUTPUT:

' INFO : -1

' INFO : Camera_Sequencer.Shot_Track.SampleClip

' INFO : True

' INFO : Camera

2. Python の例

"""

This example shows how to retrieve the output arguments from 

the returning ISIVTCollection object.

"""

Application.AddShotClip( "", "SampleClip", "Camera", 5, 1, 20 )	# This will add a shotclip between sequence frame 5 and 24.

retCol = Application.GetShotClip( 10, 0 )	# Retrieve the shot clip information at frame 10

# Retrieves the output argument using it key value

GlobalFrame = retCol.Value( "GlobalFrame"  )	# Returns the Global Frame time.

oShotClip = retCol.Value( "Clip" ) 			# Returns the Shot Clip object

DirectlyOver = retCol.Value( "DirectlyOver" )# Returns True if frame is directly within time frame of the Shot Clip

ActiveCamera = retCol.Value( "ActiveCamera" )# Returns the active camera object of the shot clip

Application.LogMessage( GlobalFrame )

Application.LogMessage( oShotClip )

Application.LogMessage( DirectlyOver )

Application.LogMessage( ActiveCamera )

# OUTPUT:

# INFO : 6.0

# INFO : Camera_Sequencer.Shot_Track.SampleClip

# INFO : True

# INFO : Camera

関連項目

AddShotClip Clip