XSIApplication
 
 
 

XSIApplication

Object Hierarchy

Inheritance

SIObject

Application

XSIApplication

Introduced

v1.5

Description

The XSIApplication object derives from the Application; its properties and methods are specific to Softimage, whereas Application contains only generic properties and methods. XSIApplication manages access to high-level objects such as the Softimage active Project, Selection object, Softimage Command objects, etc.

XSIApplication is an intrinsic object that represents the running instance of the Softimage application. An intrinsic (global) object is one that you can refer to by name in your code without creating an instance of it first; in this case the name is Application. In other words, script writers can assume that there is a global variable with the name 'Application' of type 'XSIApplication'.

However, within NetView scripts this object is not available as an intrinsic so it is neccessary to explicitly create an instance of the XSIApplication object. The scripting syntax for explicitly creating an XSIApplication object within NetView is illustrated below in the examples.

In normal (non-Netview) VBScript and JScript code it is possible to drop the "Application." prefix and call methods and properties of this object directly. For example calling "LogMessage" is actually a short form for "Application.LogMessage". This syntactic shortcut is not available to Python or PerlScript.

It is also possible to invoke all Softimage Commands as if they were methods of XSIApplication. This is the best way to invoke commands inside Python and PerlScript and for all script languages that run inside Netview.

Methods

ActivateWorkgroup AddCommand AddWorkgroup ClassName
CloseUndo CreateAddon CreateCommand CreateProject
CreateProject2 ExecuteCommand ExecuteScript ExecuteScriptCode
ExecuteScriptCommand FindObjects2 GetCommandByScriptingName GetCustomPropertyCount
GetInstallationPath2 GetObjectFromID GetObjectFromID2 GetShaderDef operator
InstallAddon IsClassOf operator IsEqualTo operator LoadPlugin
LogMessage OpenUndo RegisterShaderCustomParameterType operator RegisterShaderFamily operator
RemoveCommand RemoveWorkgroup RescanWorkgroups UnInstallAddon
UnloadPlugin UpdatePlugins Version  
       

Properties

ActiveProject2 ActiveProject3 ActiveSceneRoot ActiveToolName
Application Categories Commands Desktop
Devices Dictionary EventInfos FCurveSelection
Filters FullName operator Help InstallationPath
Interactive IsUndoing License Name operator
NestedObjects Origin OriginPath Parent
Platform Plugins Preferences Renderers
Selection ShaderDefinitions operator StatusBar Type operator
Workgroups      
       

Examples

1. VBScript Example

'
'       hello world from vbscript
'
Application.LogMessage "Hello Softimage world"
'In vbscript we don't need to specify 
'the Application. prefix
LogMessage "Shortcut of Hello World"

2. VBScript Example

'
' How to create an instance of the Application Object
' from VBScript for use within a NetView html page.
'
Dim oApplication
set oApplication = CreateObject("XSI.Application") 
'Use SIObject.Application to convert from Application object 
'to XSIApplication
Dim oXSIApplication
set oXSIApplication = oApplication.Application
oXSIApplication.Application.LogMessage "Hello from Netview"

3. JScript Example

/*
        hello world from jscript
*/
Application.LogMessage("Hello Softimage world");
//This shortcut is equivalent
LogMessage("Hello from ShortCut code");

4. JScript Example

/*
        How to create an instance of the Application Object
        from JScript for use within a NetView html page.
*/
var oApplication = new ActiveXObject("XSI.Application"); 
var oXSIApplication = oApplication.Application;
oXSIApplication.LogMessage( "There are " + oXSIApplication.Plugins.Count + " plugins installed" ) ;

5. Python Example

#
#       hello world from pythonscript
#
Application.LogMessage("Hello Softimage world")

6. Python Example

#Python script example, using the global Application
#object to invoke the NewScene command.
Application.NewScene( "",0 )

7. Python Example

#
#       How to create an instance of the Application Object
#       from pythonscript for use within a NetView html page.
#
# Normally you create a instance of an automation object using:
# import win32com.client;
# o=win32com.client.Dispatch('XSI.Application') 
# however win32com is not a trusted module so you get around
# this by defining a vbscript function called getXSIApp() 
# that returns the Application object.
try :
        Application = window.getXSIApp()
except :
        print("No browser")
# Note: Python is not a fully functional choice for web programming.
# We recommend writing the Python code as Softimage Custom Commands
# which are invoked using a little JScript or VBScript embedded in the
# html.

See Also

Application