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 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 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.
There are several different interfaces for textures, depending on the type of the return result:
Texture type Interface Class AColor EXT_TEXTURE class 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 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.
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 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.
Voumetric effects support the EXT_VOLUMETRIC interface and can be derived from class VRayVolumetric.
Geometry plugins support the EXT_GEOM_GEN interface and can be derived from class VRayGeomGen.
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.