Table of Contents


This page provides information on the V-Ray Bitmap Texture.


Overview


The Bitmap texture has a versatile use, allowing a bitmap image to be loaded as a texture.

The Bitmap texture settings are organized in Basic and Advanced modes. You can switch the mode from the toggle button under the Preview Swatch or globally from the Configuration rollout of the Settings tab.


Any texture can be replaced via the Replace With New Texture () button, which activates when you select the texture to be replaced. If the texture is an instance, all copies are changed as well.

With V-Ray 5 permanent support for the SketchUp texture colorization functionality is added. Note that for Bitmap textures it does not affect the material preview in the Asset Editor but only the appearance of the rendered image.







The Switch To Advanced Settings () toggle activates the Advance Settings mode, giving you access to a larger number of settings for modification of the Bitmap texture.






UI Paths


||V-Ray Asset Editor|| > Textures (right-click) > Bitmap

||V-Ray Asset Editor|| > Create Asset (left-click) > Textures Bitmap



Image File


Some options are available only in Advanced mode.

File – Specifies the file from which the bitmap is loaded.

Filter Type – Specifies a type of filter to be applied to the bitmap.

Sharp Isotropic - Sharp and accurate isotropic filter. Produces results that are close to the results with disabled filtering with less AA samples required.
No Filter – No filter is applied.
Mip-map – Depending on the distance from the camera, the texture is rendered in full detail (when closer to the camera) or blurred, if it is far away. 
Summed-area – Applies a summed-area filter. It is not recommended to use this filter.

Filter Blur – Specifies the strength of the blur filter applied to the bitmap.

Transfer Function 2 – Specifies the transfer function for the loaded image file.

None – No correction is applied.
sRGB – The loaded image is considered in sRGB transfer function.
Custom Gamma Curve – The transfer function is controlled through the Gamma parameter.
Auto – Automatically determines the color transfer function. If a bitmap file name contains the string "_srgb" the transfer function is sRGB. If a bitmap file name contains the strings "_lin_srgb" or "raw", no correction is applied. For bitmap files with 8 bits per color component and 3 or 4 color components (like png, jpg and other), the transfer function is sRGB. In all other cases, no correction is applied.

RGB Primaries – Allows you to manually override the RGB primaries of the Bitmap.

Raw – No transformation is applied to R|G|B colors. This option is suitable for normal maps, linear textures and textures controlling float value parameters.
sRGB primaries – The loaded image is considered in sRGB color space.
ACEScg primaries – The loaded image is considered in ACEScg color space. It is recommended to use this option when the texture is saved in ACEScg color space.

Gamma – Specifies the gamma curve correction applied when the Transfer Function is set to Custom Gamma Curve.




Sequence


Start Frame – Specifies the start frame at which the map animation begins.

Playback Speed – This options speeds up or slows down the animation rate.

Playback Type1 – Determines what happens after the last frame of the bitmap animation, in case the animation is shorter than the scene.

Loop – Causes the animation to repeat over again from the beginning.
Ping-Pong – Causes the animation to be played forward and then backwards repeatedly, making every animated sequence loop smoothly.
Hold – Freezes the bitmap animation on the last frame.




Color Manipulation


Invert Texture – Inverts the RGB texture values.

Invert Alpha – When enabled, inverts the bitmap alpha values.

Alpha from Intensity – Uses the texture RGB intensity/luminance as alpha channel.

Color Gain – Corrects the color of the texture by multiplying the RGB color values in the texture with the RGB color values specified here. A texture map can be assigned here.

Color Offset – Corrects the color of the texture by adding the RGB color values specified here to the RGB color values of the texture. A texture map can be assigned here.

Default Color – Specifies a default color used for polygons with no valid UVs. In case the map is not tiled, specifies a default color that is used outside the texture square.  When a texture is selected, it overrides the color as long as the texture checkbox is enabled.




Crop/Place


These settings are available only when you switch to the Advanced mode.

Placement – Specifies the type of placement to be used.

Whole Texture – Uses the whole bitmap.
Crop – Uses a section of the bitmap.
Place – Adjusts of the position of the image.

Width/ Height  – Specifies the width/height of the bitmap. A value of 1 specifies the full width/height. 

Jitter Placement – Specifies the amount of displacement to be applied in order to produce better anti-aliasing.




UV Noise


These settings are available only when you switch to the Advanced mode.

Amount – Controls the amount of noise.

Size – Controls the scale of the noise function.

Levels – Controls the noise color distribution.




Texture Placement




Type – Controls how the texture is positioned on the geometry.

2D (UV Channel) – The texture uses the object UV coordinates.
Environment – This mode is applicable if the map is connected to an Environment slot or a Dome light.
Mapping Source – The texture uses an external UV placement source.


2D (UV Channel)


UV Channel/Set – Specifies the index of the mapping channel data to use. A value of 1 takes the first available channel. 

Repeat U/V – Determines how many times the texture is repeated in the 0 to 1 UV square.

Lock U/V Repeat – Locks the U/V Repeat.

Offset U/V – Controls the texture offset in the U and V direction. 

Rotate – Rotates the texture (in degrees). 

Tile U/V – Tiles the texture in the U and V direction. If the option is disabled, the Default texture color is used outside the 0 to 1 UV square. Default color is found in Parameters > Color Manipulation.

Mirror U/V  – Mirrors the texture in the U and V direction separately. The option cuts the texture in the half flipping one side vertically or horizontally. This can be used to avoid seams in-between non-tileable repeated textures. 


Environment


Mapping – Specifies the type and shape of the texture.

Angular
Cubic
Spherical
Mirror Ball
Screen

Rotate H – Rotates the environment sphere horizontally. 

Flip H – Flips the environment sphere horizontally.  

Rotate V – Rotates the environment sphere vertically.

Flip V – Flips the environment sphere vertically. This option is active only in Spherical Mapping. 

Ground – Enables ground projection of the texture.  

Position X/Y/Z – Offsets the ground projection along the X/Y/Z axis. 

Radius – Specifies a projection radius. Can be used to control the scale of the projection.  

2d Transformation – see 2D (UV channel) parameters.


Mapping Source


UV Placement Source – External UV placement source to be used for the texture placement.


2D (UV Channel)

Environment


Mapping Placement



Notes


  1. The playback options are currently not supported.
  2. The Bitmap texture's transfer function (gamma curve correction) is automatically adjusted when it is created in any of the following material map slots:

    • Roughness
    • Highlight Glossiness
    • Reflection Glossiness
    • Fresnel IOR
    • Metalness
    • Refraction Glossiness
    • Refraction IOR
    • Opacity
    • Coat Amount
    • Coat Glossiness
    • Coat IOR
    • Coat Bump
    • Coat Bump Amount
    • Sheen Glossiness
    • Bump
    • Bump Amount

Copy-pasting, replacing or wrapping a texture does not trigger this automatic adjustment. It is reserved solely when creating a Bitmap in any of the specified material slots.