Vray for Maya Domemaster3D - zicher3d-org/domemaster-stereo-shader GitHub Wiki
- Overview
- Known Issues
- Adding a Vray Lens Shader in Maya + VRay DomemasterStereo Camera + VRay LatLongStereo Camera + Removing a Lens Shader
- Maya Shader Installation + Windows 64-bit + macOS 64-bit + Linux 64-bit
- Compiling Instructions + Windows 64-bit + macOS 64-bit + Linux 64-bit
This guide covers the Vray for Maya version of the Domemaster3D Shaders.
The current version of the Vray Domemaster3D shaders for Maya is a development build.The Vray for Maya version generally works for 2D mono panoramic renderings without too many issues but the screen space mapping features for the lens shaders is still a work in progress.
The Vray Domemaster3D shaders for Maya/Vray Standalone don't have feature parity at the moment with the 3DS Max version of the lens shaders which are complete from a development perspective.
More work needs to be done to apply a black overlay to the circular outside area of the domemaster frame. Right now the DomemasterStereo shader will fill the outside circular area in the frame with a solid color based upon the current data at the 0/0/0 X/Y/Z ray angle. Also the shader doesn't apply a circular alpha channel overlay yet.
The Maya integration is still a work in progress. The Domemaster3D shaders are now active in the Maya render view and the custom Vray Extra Attributes are linked into the Vray for Maya .vrscene exporter when the lens shaders are added as Vray Extra Attributes on the camera shape node.
There is now a custom VrayDomemaster3D shelf that makes it easier to use the Domemaster3D lens shaders. In addition to the shelf tools there is also a pair of LatLongStereo and DomemasterStereo camera rigs that work with Maya's native StereoRigManager system.
Note: If you want to use the Maya Render View's native stereo preview system, you have to turn off the Use V-Ray VFB checkbox in the Maya render settings window.
You can add a custom Vray lens shader to a Maya camera using the VRay Extra Attributes feature.
To turn a normal camera into a DomemasterStereo or LatLongStereo formatted camera, select the camera's shape node in the Attribute Editor window. Open the Attributes > VRay menu, and select either the "DomemasterStereo camera" or "LatLongStereo camera" items.
At this point you can turn ON the lens shader by scrolling down to the bottom of the Attribute Editor window and expanding the "Extra VRay Attributes" section. Then enable the appropriate "Treat as a Vray DomemasterStereo" or "Treat as a Vray LatLongStereo Cam" checkbox.
When the "DomemasterStereo" or "LatLongStereo" Vray Extra Attribute section is enabled with the checkbox a new Vray Render Settings Mel/Python Callbacks Post Translate Python Script entry is added automatically that allows the "DomemasterStereo" and "LatLongStereo" lens shaders to work in the Maya Render View and the Vray Frame Buffer window.
The "Post Translate Python Script" field is set to use the following python code:
import domeVrayRender
reload(domeVrayRender)
domeVrayRender.domeVrayTranslator()
You can remove a vray lens shader from a Maya camera by opening the Attributes > VRay menu and unchecking the specific lens shader. This will remove the lens shader's attributes that are listed in the Extra VRay Attributes section.
You can also delete the python code in the Mel/Python Callbacks Post Translate Python Script field if you want to completly remove all references to the Domemaster3D shader elements from the Maya scene file.
Step 1. Download and install the Visual Studio 2013 (VC++ 12.0) Redistributable Package.
Step 2. Download and install the file "Domemaster3D for Maya + 3DS Max on Windows 64-bit" from the Domemaster Project's GitHub Releases page or from Andrew Hazelden's blog.
Step 3. Open up the new Domemaster3D modules folder:
C:\Program Files\Domemaster3D\vray\maya\modules\
Copy the Maya module file "VrayDomemaster3D.mod" from the Domemaster3D "modules" folder to:
(Single User Modules Install)
C:\Users\<User Account>\Documents\maya\<Maya Version>\modules\
If the modules folder doesn't exist in the destination folder path, then create the modules directory too.
or
(System Wide Modules Install)
C:\Program Files\Common Files\Autodesk Shared\Modules\Maya\<Maya Version>\
Step 4. Copy the .dll files from C:\Program Files\Domemaster3D\vray\install\maya\vray <Vray Version> for Maya\shaders\windows x64\ to the vray-plugins directory:
C:\Program Files\Autodesk\Maya<Version>\vray\vrayplugins\
Vray Plugin Files:
vray_DomemasterStereo.dll
vray_LatLongStereo.dll
Step 5. Copy the Vray script files from C:\Program Files\Domemaster3D\vray\install\maya\vray <Vray Version> for Maya\vray scripts\ to the Vray scripts folder:
C:\Program Files\Autodesk\Maya<Version>\vray\scripts\
Vray Script Files:
attributes.txt
attributeNodes.txt
attributeGroups.txt
vrayAEFunctions.mel
domeVrayRender.py
Note: Several of the Vray script files listed above already exist in the standard Vray install. Those items need to be replaced with new ones that have the DomemasterStereo and LatLongStereo modules integrated in the settings. You should make a backup copy of the original files so you can restore them if required.
Step 6. Copy the Maya shelf file from C:\Program Files\Domemaster3D\vray\maya\shelves\shelf_VRayDomemaster3D.mel to your user account's Maya shelf folder:
C:\Users\<User Account>\Documents\maya\<Version>\prefs\shelves\
Step 1. Download and install the file "Domemaster3D for Maya on macOS" from the Domemaster Project's GitHub Releases page or from Andrew Hazelden's blog.
Step 2. Open up the new Domemaster3D modules folder:
/Applications/Domemaster3D/vray/maya/modules/
Copy the Maya module file "VrayDomemaster3D.mod" from the Domemaster3D "modules" folder to:
(Single User Modules Install)
/Users/<User Account>/Library/Preferences/Autodesk/maya/<Maya Version>/modules/
or
(System Wide Modules Install)
/Users/Shared/Autodesk/modules/maya/<Maya Version>/
If the modules folder doesn't exist in the destination folder path, then create the modules directory too.
Step 3. Copy the .so files from /Applications/Domemaster3D/vray/install/maya/vray <Vray Version> for Maya/shaders/mac x64/ to the vray-plugins directory:
/Applications/Autodesk/maya<Version>/vray/vrayplugins/
Vray Plugin Files:
vray_DomemasterStereo.so
vray_LatLongStereo.so
Step 4. Copy the Vray script files from /Applications/Domemaster3D/vray/install/maya/vray <Vray Version> for Maya/vray scripts/ to the Vray scripts folder:
/Applications/Autodesk/maya<Version>/vray/scripts/
Vray Script Files:
attributes.txt
attributeNodes.txt
attributeGroups.txt
vrayAEFunctions.mel
domeVrayRender.py
Note: Several of the Vray script files listed above already exist in the standard Vray install. Those items need to be replaced with new ones that have the DomemasterStereo and LatLongStereo modules integrated in the settings. You should make a backup copy of the original files so you can restore them if required.
Step 5. Copy the Maya shelf file from /Applications/Domemaster3D/vray/maya/shelves/shelf_VRayDomemaster3D.mel to your user account's Maya shelf folder:
~/Library/Preferences/Autodesk/maya/<Version>/prefs/shelves/
Step 1. Download and install the file "Domemaster3D Manual Install for Maya + 3DS Max + Mental Ray Standalone 64-bit on Windows, macOS, Linux" from the Domemaster Project's GitHub Releases page or from Andrew Hazelden's blog.
Step 2. Open up the new Domemaster3D modules folder:
/opt/Domemaster3D/vray/maya/modules/
Copy the Maya module file "VrayDomemaster3D.mod" from the Domemaster3D "modules" folder to:
(Single User Modules Install)
~/maya/<Maya Version>/modules/
If the modules folder doesn't exist in the destination folder path, then create the modules directory too.
Step 3. Copy the .so files from /opt/Domemaster3D/vray/install/maya/vray <Vray Version> for Maya/shaders/linux x64/ to the vray-plugins directory:
/usr/Autodesk/Maya<Version>/vray/vrayplugins/
Vray Plugin Files:
vray_DomemasterStereo.so
vray_LatLongStereo.so
Step 4. Copy the Vray script files from /opt/Domemaster3D/vray/install/maya/vray <Vray Version> for Maya/vray scripts/ to the Vray scripts folder:
/usr/Autodesk/Maya<Version>/vray/scripts/
Vray Script Files:
attributes.txt
attributeNodes.txt
attributeGroups.txt
vrayAEFunctions.mel
domeVrayRender.py
Note: Several of the Vray script files listed above already exist in the standard Vray install. Those items need to be replaced with new ones that have the DomemasterStereo and LatLongStereo modules integrated in the settings. You should make a backup copy of the original files so you can restore them if required.
Step 5. Copy the Maya shelf file from /opt/Domemaster3D/vray/maya/shelves/shelf_VRayDomemaster3D.mel to your user account's Maya shelf folder:
~/maya/<Version>/prefs/shelves/
Step 1. Install Visual Studio 2013 Community Edition and Vray Standalone (which includes a copy of the Vray plugin SDK).
Step 2. Open a new command prompt and cd into the Vray cameras source code folder:
cd C:\Program Files\Chaos Group\V-Ray\Maya <Version> for x64\samples\vray_plugins\cameras\
Step 3. Copy the Domemaster3D "vray_DomemasterStereo" and "vray_LatLongStereo" source code folders into the vray cameras source code folder.
Step 4. Set the compiling mode to "release" and compile the source code in Visual Studio 2013 with the following project files:
vray_DomemasterStereo.vcxproj
vray_LatLongStereo.vcxproj
If you are running an older version of Visual Studio you can use the legacy Microsoft Developer Studio project file:
vray_DomemasterStereo.dsp
vray_LatLongStereo.dsp
The Vray for macOS support has been added to the lens shaders.
Step 1. Install Xcode.
Step 2. Open a new terminal window and cd into the source code folder.
Step 3. Copy the Vray SDK Lib and Include files into the matching folders located next to the source code files.
Step 4. Use the macOS makefile to compile a new "vray_DomemasterStereo.so" and "vray_LatLongStereo.so" shader:
make -f MakefileMavericks.osx
Step 5. You can check your compiled .so architecture with the following commands:
You can check your compiled .so architecture with the following commands:
otool -L libvray_LatLongStereo.so
lipo -info libvray_LatLongStereo.so
otool -L libvray_DomemasterStereo.so
lipo -info libvray_DomemasterStereo.so
Step 1. Install GCC.
Step 2. Open a new terminal window and cd into the source code folder.
Step 3. Copy the Vray SDK Lib and Include files into the matching folders located next to the source code files.
Step 4. Use the Linux makefile to compile a new "vray_DomemasterStereo.so" and "vray_LatLongStereo.so" shader:
make -f Makefile