There are two pieces of Softimage Version information: the runtime version, which is available from the Application::GetVersion function, and the version which is used for the compilation check. The compilation version is accessible via the XSI_VERSION preprocessor define.
• For Linux, the recommended compiler is gcc 4.1.1.
• For Windows the recommended development environment is Visual Studio C++ 2005 SP1.
1. In a shell (tcsh) window, type:
source <Softimage home directory>/.xsi_7.5
This ensures that environment variables such as XSISDK_ROOT are set (otherwise you'll get build and link errors).
Tip: In the Plug-in Tree, right-click the Plug-ins node and choose Command Prompt to open an xterm window.
2. Change directories to the location of the plug-in source code.
3. To remove all intermediate files before building the example, run this command:
gmake clean
4. To compile the example, run this command:
gmake
5. Load the plug-in into Softimage by doing one of the following:
- In the Plug-in Manager, click Update All.
- In the Plug-in Manager, click Load, locate the plug-in .SO, and click OK.
|
You can compile both 32-bit and 64-bit plug-ins for Linux and differentiate them using the path: for example, $xsi_home/Application/bin/linux-x86/MyPlugin.so and Application/bin/linux-x86-64/MyPlugin.so. For more information, see Cross-Platform Deployment. |
In order to compile Softimage plug-ins for both the x86 and x64 platforms, you need to launch Visual Studio .NET with the proper options, which you can set up using a batch file (.bat) as demonstrated below.
1. If you are using Visual Studio .NET 2005, you can set your choose the batch file that most closely fits your situation:
- Using a 32-bit environment to compile Softimage x86 plug-ins
- Using a 32-bit environment to compile Softimage x64 plug-ins
- Using a 64-bit environment to compile Softimage x86 plug-ins
- Using a 64-bit environment to compile Softimage x64 plug-ins
|
If you are usingVisual Studio .NET 2003, you can just open a Softimage command prompt, and type devenv to start Visual Studio .NET. Starting Visual Studio .NET from a Softimage command prompt ensures that environment variables such as XSISDK_ROOT are set (otherwise you'll get build and link errors). |
2. In Visual Studio .NET, open the project file .vcproj.
If a Source Control dialog box appears, click OK, and then in the Change Source Control dialog box, click Work Disconnected.
3. From the Build menu, click Configuration Manager.
4. Select one of the following from the Active solution configuration drop-down list:
- If you are building Softimage win32 plug-ins, choose either Debug or Release.
- If you are building Softimage x64 plug-ins, choose either Debug x64 or Release x64.
5. Select one of the following from the Active solution platform drop-down list:
- If you are building plug-ins in a 32-bit environment, choose either Win32.
- If you are building Softimage x64 plug-ins, choose New... and then type x64 on the New Solution Platform dialog.
6. Build the DLL.
The first time you build the plug-in, you will be prompted to save a Solution File (.sln).
7. Load the plug-in into Softimage by doing one of the following:
- In the Plug-in Manager, click Update All.
- In the Plug-in Manager, click Load, locate the plug-in .DLL, and click OK.
Batch Files to Configure .NET 2005
To set up a 32-bit environment for compiling Softimage x86 plug-ins
- Save the following snippet in a batch file (for example, VC32XSIx86.bat):
@echo off call "C:\Softimage\Softimage_7.5\Application\bin\Setenv.bat" call "C:\Program Files\Microsoft Visual Studio 8\VC\vcvarsall.bat" x86 set PATH set XSISDK_ROOT="C:\Softimage\Softimage_7.5\XSISDK" "C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\devenv.exe" /useenv echo on
To set up a 32-bit environment for compiling Softimage x64 plug-ins
- Save the following snippet in a batch file (for example, VC32XSIx64.bat):
@echo off call "C:\Softimage\Softimage_7.5_x64\Application\bin\Setenv.bat" call "C:\Program Files\Microsoft Visual Studio 8\VC\vcvarsall.bat" amd64 set PATH set XSISDK_ROOT="C:\Softimage\Softimage_7.5_x64\XSISDK" "C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\devenv.exe" /useenv echo on
To set up a 64-bit environment for compiling Softimage x86 plug-ins
- Save the following snippet in a batch file (for example, VC64XSIx86.bat):
@echo off call "C:\Softimage\Softimage_7.5\Application\bin\Setenv.bat" call "C:\Program Files (x86)\Microsoft Visual Studio 8\VC\vcvarsall.bat" x86 set PATH set XSISDK_ROOT="C:\Softimage\Softimage_7.5\XSISDK" "C:\Program Files (x86)\Microsoft Visual Studio 8\Common7\IDE\devenv.exe" /useenv echo on
To set up a 64-bit environment for compiling Softimage x64 plug-ins
- Save the following snippet in a batch file (for example, VC64XSIx64.bat):
@echo off call "C:\Softimage\Softimage_7.5_x64\Application\bin\Setenv.bat" call "C:\Program Files (x86)\Microsoft Visual Studio 8\VC\vcvarsall.bat" amd64 set PATH set XSISDK_ROOT="C:\Softimage\Softimage_7.5_x64\XSISDK" "C:\Program Files (x86)\Microsoft Visual Studio 8\Common7\IDE\devenv.exe" /useenv echo on
Autodesk Softimage v7.5