AddImageSource

導入

v1.0

詳細

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

このコマンドは、構文と動作が SIAddImageClip コマンドと似ていますが、パラメータではなく関数によって直接的に値を戻す点が異なります。

このコマンドには、メインメニューの[レンダ-] からアクセスできます。

スクリプト構文

oReturn = AddImageSource( [FileName], [Name] );

戻り値

新しいイメージ ソース(Source オブジェクト)を戻します。

パラメータ

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

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

Name 文字列 新しいソースに使用する名前

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

set XSIsrc = AddImageSource(Source1, "XSI")

set Teethsrc = AddImageSource(Source2, "Teeth")

set Jiosrc = AddImageSource(Source3, "Jio")

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"

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

関連項目

CreateImageClip AddImageClip SIAddImageSource Clip.Source