Types of V-Ray plugins

Listed here are some of the most common types of V-Ray plugins that can be created with the V-Ray SDK. The type of a specific plugin is determined entirely by the interfaces that is supports (see the section on Interface programming). It is possible for a single plugin to support more than one interface (for example, an area light plugin supports the interfaces for both light sources and geometry generators).

 

For many of the plugin types, there are convenience classes from which they may derived and which automatically add support for the required interface(s), so only the actual implementations of the interface methods need to be provided.

 

This section only describes the plugins from the point of view of V-Ray. The plugins can be directly used by V-Ray Standalone and other V-Ray implementations based on V-Ray plugins, but additional steps may be required to make them accessible from a modeling application (f.e. in Maya, so that they can be used by V-Ray for Maya).

 

Materials

BSDF plugins

Textures

Bitmap plugins

Lights

UVW generators

Volumetric effects

Geometry plugins

Settings plugins

Camera plugins

Render elements

Anitaliasing filters

Color mappers

Materials

Materials are plugins that support the EXT_MATERIAL interface. They are usually derived from class VRayMaterial. Geometry sources typically use materials to shade intersections with that geometry. The difference between material and BSDF plugins is that materials can do arbitrary calculations, not necessary related to the surface appearance (for example, they may compute the resulting colors without using scene lights based on some other information). Most materials also support the EXT_BSDF interface so that it is possible to obtain the BSDF information directly (this is used by some global illumination methods).

BSDF plugins

BSDF plugins are plugins that support the EXT_BSDF interface. They describe the way a surface scatters light. They are usually derived from class VRayBSDF or class SimpleBSDF. Material plugins use BSDF plugins to shade intersections with scene geometry. It is also possible to assign a BSDF plugin to a geometry source directly, without using a material plugin.

Textures

There are several different interfaces for textures, depending on the type of the return result:

Texture typeInterfaceClass
AColorEXT_TEXTUREclass VRayTexture
Float EXT_TEXTURE_FLOAT class VRayTextureFloat
Integer EXT_TEXTURE_INT class VRayTextureInt
Vector EXT_TEXTURE_VECTOR  
Matrix EXT_TEXTURE_MATRIX  
Transform EXT_TEXTURE_TRANSFORM  

 

It is also possible to derive a texture plugin from one of the following classes, which implement a number of common texture functions:

Bitmap plugins

Bitmap plugins support the EXT_BITMAP interface and can be derived from class VRayBitmap. They can be used as parameters to the standard TexBitmap plugin to provide information about a 2D array of pixels.

Lights

Light plugins suppor the EXT_LIGHT interface and can be derived from class VRayLight. Area lights which generate actual scene geometry must also support the EXT_GEOM_GEN interface.

 

It is also possible to derive a light plugin from one of the following classes:

UVW generators

UVW generators support the EXT_UVWGEN interface and can be derived from class VRayUVWGen. UVW generators provide UVW information to mapped textures.

 

It is also possible to derive UVW generators from class UVWGenBase which provides some common functionality related to UVW generation (UVW coordinates transformation, cropping and wrapping options). This class is derived from class VRayUVWGen.

Volumetric effects

Voumetric effects support the EXT_VOLUMETRIC interface and can be derived from class VRayVolumetric.

Geometry plugins

Geometry plugins support the EXT_GEOM_GEN interface and can be derived from class VRayGeomGen.

Settings plugins

Settings plugins can modify the sequence and/or frame parameters for V-Ray. They support the EXT_RENDER_SETTINGS interface and can be derived from class VRayRenderSettings. By modifying the sequence and/or frame data, several additional types of plugins can be implemented. Some of the possible plugin types are given below. Settings plugins are called before any other plugins in the scene.

Camera plugins

These set the cameraRaySampler parameter in the sequence data.

Render elements

These use the EXT_SDATA_OUTPUT_CHANNELS interface from the sequence data to add render elements to the V-Ray frame buffer. Additionally, they may also replace the intersectionShader member of the sequence data to hook into the V-Ray shading pipeline so that the required data can be written into the frame buffer.

Antialiasing filters

These set the imageFilter member of the sequence data.

Color mappers

These set the colorMapper member of the sequence data.