Square Enix © Goodbye Kansas

Table of Contents

This page provides information on the V-Ray PTex Map.


The VRayPtex node loads and uses PTex textures with V-Ray. PTex is a mapping system that applies a separate texture to each face of a subdivision or polygon mesh and therefore requires no UV assignment. A PTex file can store an arbitrary number of textures along with mipmaps and adjacency data used for filtering across face boundaries. For more information on the PTex concept, see the Notes section below.  


Ptex File Name – Specifies the .ptex file to use as a texture.

Use Image Sequence – When enabled, animates the texture per frame.

Image Number – Specifies the frame number of the image to load. This attribute can be animated.

Image Offset – Specifies a static offset to the image sequence.

Cache Size (MB) – The information in a PTex file is compressed for storage. In order to be used it has to be uncompressed and stored in the RAM. This parameter controls how much memory (in MB) is available for the current texture. If the value is large enough for the whole texture the information is extracted only once and is stored during the entire rendering. Otherwise the information is constantly read from the hard drive, extracted and used when necessary. Low value for this parameter may cause large PTex files to render slowly.

Filter Type – Specifies the type of filtering to apply to the texture. 

Width – Specifies the width of the filter. 

Blur – Specifies the amount of the blurring. 

Sharpness – Controls the amount of sharpening applied by the filter. This option is only available when the Filter Type is set to Bicubic.

Interpolation between mipmap levels – A PTex texture may have several mipmap levels which are basically versions of the texture at different resolutions. This allows a higher resolution texture to be applied to parts of the object closer to the camera and a lower resolution version to be applied to parts of the object that are far away. When this option is enabled, V-Ray interpolates between different mipmap levels to create a smooth seamless texture in the end.

Reverse vertex order – A PTex is generated for a specific mesh. Sometimes the program generating the PTex numbers the vertices of the mesh in the reverse order, which results in texturing issues. Enabling this option fixes that issue.

Automatically select color channels – A PTex may have an arbitrary number of channels and there is no sure way to determine which channel contains which information. When this option is enabled, V-Ray tries to select the correct channel for Red, Blue and Green. When disabled, the user manually specifies which channel contains which information. 

Red/Green/Blue Channel – Allows the user to manually specify the channel numbers for Red, Green, and Blue .

Alpha – Specifies the mode in which alpha is applied.

Solid – All alpha information is ignored.
Alpha from texture – The information for the alpha is taken from the specified Alpha channel in the texture.
Alpha from luminance – The alpha information is taken from the Luminance of the RGB channels.

Automatically select alpha channel – When enabled, V-Ray automatically selects the alpha channel from the PTex file.

Alpha channel – Manually specifies which channel from the PTex is the alpha channel.

Color Gain – Allows the user to color correct the PTex buy multiplying the RGB color values in the texture with the RGB color values specified here.

Color Offset – Allows the user to color correct the PTex by adding the the RGB color values specified here to the RGB color values in the texture.


More information about PTex is available here.

  • PTex files are strongly connected to the topology of an objects's mesh. Therefore any modification which change the topology will break the rendering of the PTex texture. If you want to smooth the object, you can use V-Ray's own subdivision/displacement.
  • When using PTex textures for displacement, small cracks might appear along polygon edges because of slightly different filtering applied to the PTex texture on adjacent polygons. Setting the filter width to 0.0 will improve the situation, but will cause the most detailed mip-map level of the PTex file to be loaded thus increasing the required memory.
  • When using PTex textures for displacement, it might be necessary to adjust the Min/Max parameters of the Displacement Control, especially if the texture has negative colors. Otherwise the texture values might be clipped away.