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 (出力引数の配列を含む)にパック化します(詳細については、「C#
からのコマンドの呼び出し」を参照)。
SIAddImageSource( [FileName], [Name], [Source] ); |
| パラメータ | タイプ | 詳細 |
|---|---|---|
| FileName | 文字列 | 新しいイメージ ソースの完全パス
デフォルト値：ユーザがファイルを指定します。 |
| Name | 文字列 | 新しいソースに使用する名前 |
| Source | Source | ソースを戻します。 |
'--------------------------------------------------------- ' 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" '--------------------------------------------------------- |