Installation_instructions

NOTE: This page was valid until Maya2OSG 0.4.2c. For newer releases or SVN trunk, check the new page [Building_and_installing] __

This page gives the instructions to install Maya2OSG in the system to be usable from Maya. Some or all these steps can be done automatically after the compilation, depending on the environment and project used. They are described here as they are not available in every platform and for help in case of any problem during the installation or configuration.

• Windows
• Linux
• Installation steps
• Troubleshooting

Windows

The Visual Studio project will try to copy the

maya2osg.mll

in the right Maya directory if there are permissions.

MEL scripts, shelf and icons also install automatically into the current user Maya default directory for the chosen Maya version.

For the binary package, just running the file

INSTALL.bat

will do, assuming you have write permission in the Maya

bin\plug-ins

directory.

Linux

To install the plug-in the Maya directory just do

make install

as root or any other user with the needed write access to the destination directory. After that, copy the contents of

scripts

and

prefs

directories to the right place, as described in the next section.

Installation steps

1. The result of the compilation (

   maya2osg.mll
   

or

    maya2osg.so

) must be copied to the Maya plug-ins directory. In Maya 2010 the default location is

    C:\Program Files\Autodesk\Maya 2010\bin\plug-ins

in Windows and

    /usr/autodesk/maya2010-x64/bin/plug-ins

in Linux.
2. Some MEL scripts are provided to make it easy to use the plug-in. They must be copied to the Maya global scripts directory (e.g.

    C:\Program Files\Autodesk\Maya 2010\scripts

) or to the user configuration scripts directory (userdir

    \maya\scripts

or userdir

    \maya\

version

    \scripts

). Whatever the case, the only important thing is to make it available to Maya.
3. Copy to userdir

    \maya\

version

    \prefs

the directories

    shelves

and

    icons

, that are actually the MEL script to create a new shelf (

    shelves/shelf_OSG.mel

) with some buttons and the icon images (.bmp) for these buttons.

Troubleshooting

If Maya2OSG plug-in does not work, check the following:

1. Make sure the plug-in (

   maya2osg.mll
   

or

    maya2osg.so

) is placed in the right directory, where Maya can find it, and with the right file permissions. If it is not, Maya will show a message like this one:

    // Error: Plug-in, "maya2osg.mll", was not found on MAYA_PLUG_IN_PATH.

1. Make sure all the libraries the plug-in depends on are available in the system or user PATH. Otherwise, Maya will show a message like this one:

   // Error: The specified module could not be found.
   

Check also that the OSG version installed in your system is the same version used to compile the plug-in.
3. Check the Output Window (or the standard output in Linux) for error messages or debugging information during the execution of the Maya2OSG plug-in.