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