	CC_runOnce readme



/// CONTACT

Christopher Crouzet <christopher.crouzet@gmail.com>
http://www.christophercrouzet.com




/// DESCRIPTION

This plug-in is a time saver for C++ developers. No more need to unload, compile then reload to 
test a C++ Softimage|XSI plug-in. Just specify the location of your .dll file, put some optional 
code to be fired while your plug-in is loaded, and click the "run" button. Everything else is 
handled.

To popup the interface, simply call the "CC_runOnce" command without any argument.

Compatible with Softimage|XSI 7 and above.




/// FEATURES

- loading and unloading of plug-ins is automatically managed.
- put some code to be executed while the plug-in is loaded.
- see the details of your plug-in.




/// PLUG-IN ITEMS

___ commands

- CC_runOnce(filepath, code, language, unload)
    Main command.

    \param filepath  (string)  Filepath of the plug-in to load.
    \param code      (string)  Code to execute while the plug-in is loaded.
    \param language  (string)  Scripting language of the code to execute. Valid languages are:
                               "JScript", "VBScript", "Python", "PerlScript", "Python", 
                               and "PythonScript".
    \param unload    (bool)    True to unload the plug-in after the execution of the code.
    
    \return (string) The plug-in name.



___ properties

- CC_runOnceProp
    Main property.




/// INSTALLATION

- copy the "CC_runOnce.dll" file to your "{XSI_USER_PATH}/Application/Plugins/" directory.
- update your XSI plug-ins using the "Plugin Manager" if necessary.




/// CHANGELOG

___ v1.2 - October 11, 2009

- code cleaning.
- the plug-in is now under the GPL license.



___ v1.1 - November 17, 2008

- fixed XSI crashing while exiting.



___ v1.0 - September 30, 2008

- initial release.