SIAddImageSource

導入

v1.0

詳細

Sources コンテナに新しいイメージ ソースを作成、追加します。 このコマンドを実行するには、ディスク上にイメージ ソース ファイルが存在していなければなりません。 イメージ ソースは、テクスチャリングなど、イメージ合成エフェクトを実行する際に ImageClip オブジェクトによって使用されます。

このコマンドは、構文と動作が AddImageClip コマンドと似ていますが、関数から値を直接戻さずにパラメータから値を戻す点が異なります。

メインメニューでRender->Get - Clip->Create Source From Fileを選択してコマンドにアクセスし、イメージソースファイルを選択することもできます。

このコマンドは、インターネットからのファイルのダウンロードに対応しています。ファイル名に URL を指定すると、コマンドが実行される前にそのファイルがローカルにダウンロードされます。

注: このコマンドは、出力引数を使用します。C# および一部のスクリプト言語(JScript、PerlScript、Python など)は、リファレンスによって渡される引数をサポートしていません。このため、状況に応じた適切な回避策を実行する必要があります。

スクリプト言語の場合、このコマンドは出力引数を取得するために使用できる ISIVTCollection を戻します。

C# の場合は、XSIApplication.ExecuteCommand メソッドを使用してこのコマンドを呼び出すことができます。ExecuteCommand は、出力引数を C# の System.Object (出力引数の Array を含む)にパック化します(詳細については、「C# からのコマンドの呼び出し」を参照)。

スクリプト構文

SIAddImageSource( [FileName], [Name], [Source] );

パラメータ

パラメータ タイプ 説明
FileName 文字列 新しいイメージ ソースの完全パス

デフォルト値: ユーザがファイルを指定します。

Name 文字列 新しいソースに使用する名前
Source Source ソースを戻します。

例

VBScript の例

'---------------------------------------------------------

' VBScript example : Adding image sources. This script 

' demonstrates the use of SIAddImageSource to add image sources

' to the scene.

'---------------------------------------------------------

' Get the filenames of some image sources.

Dim Source1, Source2, Source3

Source1 = Application.InstallationPath( siFactoryPath ) & "\Data\XSI_SAMPLES\Pictures\xsilogo.jpg"

Source2 = Application.InstallationPath( siFactoryPath ) & "\Data\XSI_SAMPLES\Pictures\top_teeth.jpg"

Source3 = Application.InstallationPath( siFactoryPath ) & "\Data\XSI_SAMPLES\Pictures\jio.jpg"

' Now create image sources from the filenames.

Dim XSIsrc, Teethsrc, Jiosrc

SIAddImageSource Source1, "XSI", XSIsrc

SIAddImageSource Source2, "Teeth", Teethsrc

SIAddImageSource Source3, "Jio", Jiosrc

logmessage XSIsrc & " created with source file : " & Source1

logmessage Teethsrc & " created with source file : " & Source2

logmessage Jiosrc & " created with source file : " & Source3

'---------------------------------------------------------

' Output from this script:

'INFO : "Sources.XSI created with source file : <FactoryPath>\Data\XSI_SAMPLES\Pictures\xsilogo.jpg"

'INFO : "Sources.Teeth created with source file : <FactoryPath>\Data\XSI_SAMPLES\Pictures\top_teeth.jpg"

'INFO : "Sources.Jio created with source file : <FactoryPath>\Data\XSI_SAMPLES\Pictures\jio.jpg"

'---------------------------------------------------------

関連項目

AddImageSource AddImageClip CreateImageClip