Readme for Informatix EPix file plugins for modo 401    	July 2009

This readme describes how to use our Piranesi EPix file plugins with modo401
on Windows and Mac.


============
Installation
============

Load the appropriate plugin:

    Win32/modoepix.lx    if you are using Windows 32-bit
    x64/modoepix.lx        if you are using Windows 64-bit
    MacOSX/modoepix.lx  if you are using Mac OS X

using the "File>Add Plug-in" command in modo.


=================
Using the Plug-in
=================

The plugin needs "Depth" and "Surface ID" Render Output layer, if these are not
present it will attempt to create them, and will prompt for a maximum depth value.
Note that the script may fail to create these layers, for example if a camera has 
been selected with the mouse. In this case use the mouse to select the Render node
in the shader tree and try again.

If you have a Depth layer you should ensure the maximum depth channel value is
sufficient.

Run the epixrender.pl script using the "System>Run Script" command in modo.

This will prompt for the filename you want to save and then perform 2 renders. It
will also create 2 temporary files in the folder containing the epix file you chose.
It will normally delete these files.


=====
Notes
=====

1) The plugin does not support film offsets or lens squeeze, and the script 
will refuse to render if they are used.

2) The material channel may merge distinct materials, or fail to combine pixels 
that should be in the same material. It is unable to relate the materials it sets
back to the modo model, so it generates arbitrary names for them.


**********
Disclaimer
**********

The Software is being delivered to you AS IS and Informatix Inc.
(Informatix) makes no warranty as to its use or performance. 
INFORMATIX AND ITS SUPPLIERS DO NOT AND CANNOT WARRANT THE
PERFORMANCE OR RESULTS YOU MAY OBTAIN BY USING THE SOFTWARE OR
DOCUMENTATION. INFORMATIX AND ITS SUPPLIERS MAKE NO WARRANTIES, EXPRESS
OR IMPLIED, AS TO NONINFRINGEMENT OF THIRD PARTY RIGHTS, MERCHANTABILITY,
OR FITNESS FOR ANY PARTICULAR PURPOSE. IN NO EVENT WILL INFORMATIX OR
ITS SUPPLIERS BE LIABLE TO YOU FOR ANY CONSEQUENTIAL, INCIDENTAL OR
SPECIAL DAMAGES, INCLUDING ANY LOST PROFITS OR LOST SAVINGS, EVEN IF AN
INFORMATIX REPRESENTATIVE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES, OR FOR ANY CLAIM BY ANY THIRD PARTY.


Contacting us
*************

Please visit our website at:

    http://www.piranesi.co.uk

Or you can contact us by email at:

    info@piranesi.co.uk


COPYRIGHT & TRADEMARK INFORMATION
*********************************

modo is a registered trademark of Luxology LLC., in the USA and/or other countries. 

Piranesi is a registered trademark of Informatix Inc. in the United
Kingdom, the United States of America, and other countries. 

Piranesi is the subject of the following patents:

US-6226000
EP-0870284
JP-3837162