Introduced
5.0
Description
Creates and adds a new writable image Source in the Sources container. The source will create images using the image path given. The files do not have to exist.
Writable image sources are used by lightmaps for example to create an image to receive the lightmap data. Image sources are used by ImageClip objects in order to perform image compositing effects, such as texturing.
Note: This command uses output arguments. C# and some scripting languages (such as JScript, PerlScript and Python) don't support arguments passed by reference so you need to use the best workaround for your situation:
For scripting languages this command returns an ISIVTCollection which you can use to get the output arguments.
For C# you can use the XSIApplication.ExecuteCommand method to call this command. ExecuteCommand packs the output arguments into a C# System.Object containing an Array of the output arguments (see Calling Commands from C#).
Scripting Syntax
SIAddWritableImageSource( [FileName], [Name], [Width], [Height], [Type], [UseExisting], [Source] )
Parameters
|
Parameter |
Type |
Description |
|
FileName [in/out] |
Full path of the new image source. Default Value: User is prompted to select a file. |
|
|
Name |
The name to use for the new source. |
|
|
Width |
Number |
The width, in pixels, of the new images. Default Value: 256 |
|
Height |
Number |
The height, in pixels, of the new images. Default Value: 256 |
|
Type |
The channel types to restrict this image type to. Default Value: siRenderChannelType |
|
|
UseExisting |
If a writable image source already exists with the same filename, use that instead. Default Value: False |
|
|
Source [out] |
Returns the source |
See Also
Autodesk Softimage v7.5