Skip to content

Vray Standalone Domemaster3D Install

Andrew Hazelden edited this page May 23, 2015 · 35 revisions

Table of Contents

Overview

The Domemaster Stereo Shader is a set of fulldome stereo and latlong stereo production lens shaders for 3DS Max, Maya, Softimage, Houdini, Maxwell Studio, Mental Ray Standalone, Vray Standalone, and Arnold Standalone. The lens shaders are available for Mental Ray, Vray, and Arnold, and comes integrated in Maxwell Render version 3.1+.

This guide covers the Vray Standalone version of the Domemaster3D Shaders.

Known Issues

The current version of the Vray Domemaster3D shaders (as of 2015-05-23 ) is a development build.

The Vray Standalone version generally works without too many issues.

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

DomemasterStereo Renderings

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

LatLongStereo Renderings

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.

Adding an ENV Var

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

Plgparams Listing the Shader Parameters

Plgparams Listing the Shader Parameters on the Mac 1

Plgparams Listing the Shader Parameters on the Mac 2

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

Mac Node List

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

Linux Node List

./plgparams.bin -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

Mac 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"  
Clone this wiki locally