Vray Standalone Domemaster3D Install

Table of Contents

• Overview
• Known Issues
• Vray Standalone
  • DomemasterStereo in a VRSCENE File
  • LatLongStereo in a VRSCENE File
• Vray Standalone Shader Installation
• Verify the Shader is Loaded in Vray
  • Vray Shader Parameters Screenshot
  • Listing the Nodes
    • Windows Node List
    • macOS Node List
    • Linux Node List
  • Node Parameters
    • plgparams.exe DomemasterStereo
    • plgparams.exe LatLongStereo
    • Windows Parameters
    • macOS Parameters
    • Linux Parameters
• Rendering the Example Scenes

Overview

This guide covers the Vray Standalone version of the Domemaster3D Shaders. This specific shader library file is from the Vray for Maya development branch.

Known Issues

The current version of the Vray Domemaster3D shaders for Maya/Vray Standalone are a development build. The Vray Standalone 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.

Vray Standalone

Right now the DomemasterStereo and LatLongStereo shaders are accessible from Vray Standalone and Vray RT version 2.5 / 3.0 using the vray.exe command line program. Until the Maya and 3DS Max shader integrations are complete you will have to add the DomemasterStereo and LatLongStereo camera parameters to your .vrscene files manually.

Andrew Hazelden's Vray Syntax Highlighter module for Notepad++, GEDIT, BBEdit, and TextWrangler is a good tool for simplifying the process of editing a .vrscene file.

DomemasterStereo in a VRSCENE File

You can upgrade a regular Vray camera (in this case named RenderCamShape) to a DomemasterStereo camera by finding the camera entry in your Vray .vrscene file and pasting the following text in its place:

DomemasterStereo RenderCamShape {
  camera=0;
  fov_angle=360.0;
  parallax_distance=355.0;
  separation=6.5;
  forward_tilt=0.0;
  tilt_compensation=0;
  vertical_mode=1;
  separation_map=1.0;
  head_turn_map=1.0;
  head_tilt_map=0.5;
  flip_x=0;
  flip_y=0;
  neck_offset=0.0;
}

Note: camera=0 means center view, camera=1 is left view, and camera=2 is right view.

You can test this code out using the included vray example scene "vray 2 DomemasterStereo.vrscene". To render the sample scene launch vray standalone from the command prompt with:

vray.exe -sceneFile="vray 2 DomemasterStereo.vrscene"

LatLongStereo in a VRSCENE File

You can upgrade a regular Vray camera (in this case named RenderCamShape) to a LatLongStereo camera by finding the camera entry in your Vray .vrscene file and pasting the following text in its place:

LatLongStereo RenderCamShape {
  camera=0;
  fov_vert_angle=180.0;
  fov_horiz_angle=360.0;
  parallax_distance=355.0;
  separation=6.5;
  zenith_mode=1;
  separation_map=1;
  neck_offset=0.0;
  zenith_fov=0;
}

Note: camera=0 means center view, camera=1 is left view, and camera=2 is right view.

You can test this code out using the included vray example scene "vray 2 LatLongStereo.vrscene". To render the sample scene launch vray standalone from the command prompt with:

vray.exe -sceneFile="vray 2 LatLongStereo.vrscene"

Vray Standalone Shader Installation

Windows 64-bit

Step 1. Download the Visual Studio 2013 (VC++ 12.0) Redistributable Package.

Step 2. Copy the .dll files to the vray-plugins directory:

C:\Program Files\Chaos Group\V-Ray\Standalone for x64\bin\x64\vc101\plugins

Vray Plugin Files:

vray_DomemasterStereo.dll
vray_LatLongStereo.dll

Step 3. Edit the Windows environment variables and add an entry for the VRAY_PLUGINS_x64 Vray standalone plugins path location.

For Vray Standalone 2.5 the standard VRAY_PLUGINS_x64 setting would be:

VRAY_PLUGINS_x64
C:\Program Files\Chaos Group\V-Ray\Standalone for x64\bin\x64\vc101\plugins

Verify the Shader is Loaded in Vray

Vray Shader Parameters Screenshot

Listing the Nodes

You can list all of the active Vray Shader nodes using the plugin parameters tool:

Windows Node List

cd C:\Program Files\Chaos Group\V-Ray\Standalone for x64\bin\x64\vc101\
plgparams.exe -list

macOS Node List

cd /Applications/Autodesk/maya2017/vray/bin
./plgparams -list

or

cd /Applications/ChaosGroup/V-Ray/Standalone_for_snow_leopard_x86/bin/snow_leopard_x86/gcc-4.2/
./plgparams -list

Linux Node List

cd /usr/ChaosGroup/V-Ray/Maya2017-x64/bin/
./plgparams -list

Node Parameters

If you run the plgparams with the shader name listed you can see the individual node parameters. If you get a plgparams error asking for the -plugindir that means you are missing the vray plugins environment variable such as VRAY_PLUGINS_x64 or VRAY_PLUGINS_x86.

plgparams.exe DomemasterStereo

Parameters for plugin 'DomemasterStereo'
  camera: integer = 0, Center, Left, Right Camera Views
  fov_angle: float = 180, Field of View
  parallax_distance: float = 360, Parallax Distance
  separation: float = 6.5, Camera Separation Distance
  forward_tilt: float = 0, Forward Tilt
  tilt_compensation: bool = false, Tilt Compensation Mode
  vertical_mode: bool = false, Vertical Mode
  separation_map: float = 1, Separation Map
  head_turn_map: float = 1, Head Turn Map
  head_tilt_map: float = 0.5, Head Tilt map
  flip_x: bool = false, Flip X
  flip_y: bool = false, Flip Y
  neck_offset: float = 0, Neck Offset

plgparams.exe LatLongStereo

Parameters for plugin 'LatLongStereo'
  camera: integer = 0, Center, Left, Right Camera Views
  fov_vert_angle: float = 180, Field of View Vertical
  fov_horiz_angle: float = 360, Field of View Horizontal
  parallax_distance: float = 360, Zero Parallax Distance
  separation: float = 6.5, Camera Separation
  zenith_mode: bool = false, Zenith Mode
  separation_map: float = 1, Separation Map
  head_tilt_map: float = 0.5, Head Tilt map
  flip_x: bool = false, Flip X
  flip_y: bool = false, Flip Y
  neck_offset: float = 0, Neck Offset
  zenith_fov: float = 0, Hemi-equirectangular

Note: If you receive the following error message it means you have tried to load a Vray 2.5 shader in Vray 3.0:

// Error: Error loading plugin library "C:\Program Files\Autodesk\Maya2015\vray\vrayplugins\vray_DomemasterStereo.dll" (127): The specified procedure could not be found. //   
// Error: Error loading plugin library "C:\Program Files\Autodesk\Maya2015\vray\vrayplugins\vray_LatLongStereo.dll" (127): The specified procedure could not be found. //   

Windows Parameters

plgparams.exe DomemasterStereo
plgparams.exe LatLongStereo

macOS Parameters

./plgparams.bin DomemasterStereo
./plgparams.bin LatLongStereo

Linux Parameters

./plgparams.bin DomemasterStereo
./plgparams.bin LatLongStereo

Rendering the Example Scenes

If you navigate to the Domemaster3D vray scenes folder you can try rendering the sample vray standalone vrscene files.

vray.exe -sceneFile="vray 2 DomemasterStereo.vrscene"  
vray.exe -sceneFile="vray 2 LatLongStereo.vrscene"  

vray.exe -sceneFile="LatLongStereo_Boxworld_center.vrscene"  
vray.exe -sceneFile="LatLongStereo_Boxworld_left.vrscene"  
vray.exe -sceneFile="LatLongStereo_Boxworld_right.vrscene"  

vray.exe -sceneFile="DomemasterStereo_Boxworld_center.vrscene"  
vray.exe -sceneFile="DomemasterStereo_Boxworld_left.vrscene"  
vray.exe -sceneFile="DomemasterStereo_Boxworld_right.vrscene"