In brief
- The VRayGaussianSplat node in V-Ray for Maya only supports Gaussian Splat files in .ply format.
- Splats can be used as an environment (background) or as a standalone object; the Affect Matte Surfaces and Casts Shadows settings need to be configured differently for each use case.
- The clipping feature lets you cut away specific parts of a splat using an object or a 3D texture mask such as VRayDistanceTex.
- According to Chaos documentation, splats do not yet support motion blur and cannot function as holdout (matte) objects.
Chaos has made it possible to bring 3D Gaussian Splat scenes generated from photos or video directly into renders through the VRayGaussianSplat node added to V-Ray for Maya. Based on Chaos' official documentation, this guide explains how to set up this node, what each parameter does, and how to build a typical clipping workflow.
What you'll learn
In this guide, you'll see step by step how to decide whether to use a Gaussian Splat as an environment in V-Ray for Maya or as a standalone object, the basic visibility and shadow parameters, the clipping workflow, and the lighting options.
Requirements
V-Ray for Maya (a version that includes the VRayGaussianSplat node).
A Gaussian Splat scene exported only in .ply format; according to the documentation, no other format is currently supported.
If using a splat sequence, file names must be sequentially numbered like
gaussians_0001.ply,gaussians_0002.ply.
The tag used in the sequence file path is written as follows:
<frame04>Here, the number 4 specifies how many digits the frame number should have; the 0 indicates how many leading zeros to add.
Step-by-step usage
Load the file. In the VRayGaussianSplat node, select the .ply file from the File field. If using a sequence, add the tag above to the file path.
Decide on the use case. Whether the splat will be used as an environment (background) or as a standalone object in the scene determines which of the two parameter groups below you should apply.
Use as an environment: Affect Matte Surfaces should be on, Casts Shadows should be off. This way the splat is visible in the background and can receive shadows from other objects.
Use as a standalone object: Affect Matte Surfaces should be off, Casts Shadows should be on. This allows the object to cast shadows correctly onto other elements in the scene.
Configure visibility settings. The Primary Visibility, Visible in Reflections, and Visible in Refractions parameters control whether the splat appears in the camera, in reflections, or in refractions.
Scale. Use the Scale parameter to bring the splat proportionally in line with the rest of the scene.
Adjust color and intensity. Use Intensity to control brightness, Color for the filter color, and RGB Primaries to specify the color space in the file (sRGB, ACEScg, or Raw).
Apply clipping if needed. There are two methods for cutting away unwanted areas:
Clipping with an object: Leave Use Texture off and assign the clipping geometry to the Objects field; the Distance parameter controls edge softness.
Clipping with a texture: Turn Use Texture on and assign, typically, VRayDistanceTex to the Mask field; white areas of the mask preserve the splat, black areas clip it away.
Configure lighting. When Lighting On is enabled, the splat is affected by scene lights; Blend sets the ratio between the original splat color and the new lighting, while Shadow Blur and Shadow Offset adjust the blur and position of the shadow. The Normals Mode option determines how normals are calculated.
Set up the viewport preview. Use Preview Type to choose whether the splat is shown in the viewport as a Bounding Box or Point Cloud; Viewport Primitives % and Preview Primitives Limit let you limit the number of points displayed.
Implications for architecture and archviz workflows
The ability to add a photographed building or interior into a scene as a Gaussian Splat offers a practical option, especially for architecture firms that want to produce renders integrating survey data with an existing building context. When used in environment mode, it offers advantages such as parallax and angle-dependent reflections compared to traditional HDRI backgrounds. However, the documentation notes that splats cannot function as holdout (matte) objects and do not support motion blur; these limitations should be kept in mind for projects involving animated camera movement or complex compositing. Also, since the scene background needs to be black and dome lights need to be set to invisible, existing scene setups need to be adjusted according to this rule.
Common mistakes
Leaving Casts Shadows on for a splat used as an environment; this is not recommended per the documentation and can lead to unexpected shadow issues.
Rendering without making the scene background black or setting the dome light to invisible; in this case, the splat is not rendered correctly.
Using multiple intersecting Gaussian Splat files in the same scene; the documentation states this can produce undefined or erroneous results.
Writing the frame number tag (such as
<frame04>) in the wrong format for sequence files, which prevents the files from loading in the correct order.
What's next
Testing the parameters on small test scenes to observe the effect of Affect Matte Surfaces, Casts Shadows, and clipping settings on the render makes it easier to find the right combination before moving on to the actual project scene. Then, balancing the splat's baked-in lighting with scene lights using the Lighting On and Blend parameters helps achieve a more consistent composition.
Source and license
This guide has been adapted based on information from Chaos' official documentation pages "VRayGaussianSplat" (docs.chaos.com) and the general Chaos Docs introduction page.
Sources
2 sourcesSource texts are not republished; short quotes are marked, everything else is our own summary and commentary.
The arrival of Gaussian Splat support in V-Ray for Maya offers a practical tool for architecture and interior design firms in Turkey, especially those looking to integrate existing building surroundings produced from survey photos or drone scans into their renders. Providing a parallax effect compared to classic HDRI backgrounds can make it easier to produce visuals that are more consistent with the real environment in restoration and urban design projects.
Still, the fact that the system cannot function as a holdout object and lacks motion blur support requires additional planning for work involving animated presentations or complex post-production. Firms testing clipping and lighting parameters on small test scenes first, before moving to larger projects, will reduce wasted time.
Frequently asked questions
Which file format does Gaussian Splat support in V-Ray for Maya?
According to Chaos documentation, only Gaussian Splat files in .ply format are currently supported.
Are Gaussian Splats affected by motion blur in V-Ray?
No, Chaos documentation states that Gaussian splats are not yet affected by the motion blur effect.
What settings should be made when using a Gaussian Splat as a standalone object?
According to the documentation, when used as a standalone object, Affect Matte Surfaces should be turned off, while Casts Shadows should be turned on so it can cast shadows correctly onto other objects.



