<     > 

AddDevice (DeviceCollection)

Description

Adds a new device driver to the list in the device manager. Before you can use a device driver, you need to create a Device object using this method.

Scripting Syntax

DeviceCollection.AddDevice( DeviceName )

C# Syntax

Device DeviceCollection.AddDevice( String in_bstrDeviceName );

Parameters

Return Value

Device

Examples

JScript Example

/*
   This example demonstrates how to work with devices through scripting.
*/

NewScene( null, false );
// First make sure the device manager is active (we can't add devices if it isn't)
if (!Application.Devices.Enable) {
   Application.Devices.Enable = true;
}

// Get the DeviceManager (DeviceCollection)
var oDevices = Application.Devices;

// Get a pointer to the PC1600 Device, if it exists
var oDevice = oDevices.Item("PC1600");

// If it doesn't exist, then create it
if (oDevice == null) {
   oDevice = oDevices.AddDevice( "PC1600" );
}

LogMessage( "The device name is " + oDevice );
//INFO : The device name is DeviceManager.PC1600

See Also

Autodesk Softimage v7.5     <     >