Versions Compared

Old Version 1

changes.mady.by.user Kristin Ivanova

Saved on

compared with

New Version Current

changes.mady.by.user Kristina Gaytandzhieva

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

 

Overview


Overview

...

Section
Column
width50%

The V-Ray Bitmap can

...

be used to load high dynamic range images (HDRI) and map them onto the environment. V-Ray supports most of the standard HDRI-environment mapping methods. This texture can also be used to load other file formats. 


UI Path: Texture > V-Ray > VRayBitmap

Column
width5%


Column
width45%

Image Added



Tiled OpenEXR and TIFF Files

...

You can convert many common image file formats to tiled OpenEXR files using the img2tiledexr tool. You can also convert all files in a scene using the Vthe V-Ray Bitmap to VRayBitmap converter script. Conversion to tiled TIFF can be done using the maketx tool from the OpenImageIO library.

Tiled TIFF files have the advantage that they can store 8-bit color components, whereas OpenEXR stores at least 16 bits. This means that tiled 8-bit TIFF textures are smaller on the disk and take up less RAM while rendering. 


Tags and Environment Variables in Bitmap Names

...

VRayBitmap allows the use of named tags, enclosed with the characters < and >, which are replaced at render time with other strings.

Anchor
tagsForMultiTiles
tagsForMultiTiles

Tags for Multi-Tiles

Some modeling applications allow to specify specifying a different bitmap file for different portions of a model, based on the UV coordinates of that model. For example, one file may be used for UVs in the range [0,0] x (1,1), another file may be used for UVs in [1,0] x (2,1) and so on. There are several ways to specify the correct file for each tile, and in each case, a different format for the file name is used in the File node. This is done by using special tags in the file name, which are replaced at render time with a particular string, based on the UVs of the current shading point.

...

Upper-case tags usually assume the tile coordinates start from 1, whereas lower-case tags assume the tiles start from 0.

Mari Tiles and the <UDIM> Tag

Mari forms the file name of textures using a four-digit number equal to 1000+(u+1+v*10). So the UV tile [0,0] x (1,1) is assigned the number 1001, UV tile [0,1] x (1,2) is assigned 1011 and so on. To specify a Mari-style tiled texture, use the <UDIM> tag in the file name, which is then replaced with the respective four digits, for example, my_texture_<UDIM>.exr becomes my_texture_1001.exr and so on during rendering.

Mudbox Tiles and the <UVTILE> Tag

Mudbox can form the file name in many ways, but the default format is to use _uU_vV in the file name where U=u+1 and V=v+1 are the tile coordinates plus one. So the UV tile [0,0] x (1,1) is marked with _u1_v1, UV tile [0,1] x (1,2) is marked with _u1_v2 and so on. To specify this format, use the <UVTILE> tag in the file name. If you use lower case letters <uvtile> , then the tile coordinates will start from 0, instead of one, so tile [ 0,0] x (1,1) will be resolved to _u0_v0 and so on. For example, my_texture<UVTILE>.exr becomes my_texture_u1_v1.exr and so on during rendering.

The $U and $V Tags

You can also specify the u and v coordinates of the tiles separately by using the $U and $V tags. Each of them is expanded to the respective 1-based coordinate of the tile. For example, if the file name is specified as my_texture_$U_$V.exr, this becomes my_texture_1_1.exr and so on. You can use lower-case tags to make the tile coordinates start from zero, instead of 1, for example my_texture_$u_$v.exr becomes my_texture_0_0.exr and so on.

...

For example, if the first image in the sequence is located at C:\textures\myImage.0001.png, change the string to C:\textures\myImage.<frameNum>.png and V-Ray will look looks for an image that corresponds to each frame within the animation range.

Environment Variables

You can include environment variables in the form ${VAR_NAME} which , which are replaced with the value of the respective environment variable during rendering. For example, if the file name is specified as ${TEX_PATH}\${PROJ_FOLDER}\mytexture.exr, then V-Ray will look looks up the environment variables TEX_PATH and PROJ_FOLDER and replace replaces the tags with their values. Suppose that TEX_PATH is set to c:\textures and PROJ_FOLDER is set to proj1, then the final bitmap file name will is be expanded as c:\textures\proj1\mytexture.exr

 


Bitmap Properties

...

Section
Column
62%
width50%

Reload Image – Reloads the attached image file.

Locate Image – Opens the location of the attached image file.

Edit Image – Opens the attached image file in the system's default image editor.

Bitmap – Specifies the name of the file name , from which the bitmap is loaded. Currently supported formats are HDR, EXR, PNG, BMP, TGA, SGI, JPG, PIC, TIF, PSD, VRIMG. Image file lists in the form of IFL files are also supported.

Column
width5%

 

Column
width33%

 

 

Common

Section
Column
width62%

Alpha from Intensity –

Invert –

Invert Alpha –

Color Mult –

Texture –

Mix Strength –

Color Offset –

Texture –

Mix Strength –

Alpha Mult –

Alpha Offset –

No UVs Color –

Texture –

Mix Strength –

Column
width5%

 

Column
width33%

Image Removed

 

Mapped

Section
Column
width62%

 

Tile –

Placement Type –

U/V – Adjusts the texture location - specifies the location of the top left corner of the image.

Width/Height – Adjusts the width and height of the texture or crop area.

Jitter –

Tile U/V –

Column
width5%

 

Column
width33%

Image Removed

 

Processing

UV Tiling Mode – Specifies the type of UV tiling used by the texture.You can also do this manually, see the Tags for Multi-Tiles section. In brackets are examples of texturing tools that support the mode.

Off – Disables UV tiling.
0-based (ZBrush) – The UV coordinates start at 0.
1-based (Mudbox) – The UV coordinates start at 1.
UDIM (Mari) – Uses UDIM tiling for the texture.

Filter

Section
Column
width62%

Filter Type – Specifies the V-Ray internal texture filtering method.  Possible Possible values are:

Nearest –  The nearest texel from the map is taken without any interpolation. 
No Filter – Does not apply any filtering. No filtering – Disables filtering for the texture.
Mip-map filtering –
Summed are table filtering – Pyramidal MIP map filtering is used to compute the texture color. Can be blurry for textures seen at grazing angles. 
Area – Applies an anti-aliasing area filter.
Elliptical – – High-quality anisotropic MIP map texture filtering that reduces blurring and aliasing artifacts. Can be slower compared to the Summed are table Isotropic filtering. 
Sharp Mip-Map filtering – map – Sharper and more accurate version of the Summed are table Mip-map filtering. Produces results that are closer to the results with disabled filtering but with less AA samples are required.

Interpolation – Determines how the image is interpolated from the pixel values. Possible values are:

Bilinear – Image values are interpolated from four pixels in the bitmap. This is the fastest interpolation method, but the result is not continuous (non-smooth) and may produce artifacts when the map is used for displacement or bump mapping.
Bicubic – Image values are interpolated from sixteen pixels in the bitmap. This is the slowest method, but the results are smooth without too much blur.
Biquadratic – Image values are interpolated from nine pixels in the bitmap. This method is faster than the Bicubic interpolation, but may smooth the image too much. 

Filter Blur – Additional multiplier, which controls filter blurring, especially useful with the mapping source feature. The higher the value, the more blurred the texture renders and the less render time it takes, and vice versa. A value of 0.01 means no filtering, but leads to increased render times. If a Bitmap is connected to the VRayBitmap as a mapping source, the Filter multiplier option serves as a multiplier for the Blur parameter of the Bitmap. For example, if the Bitmap Blur parameter is set to 10, and the VRayBitmap Filter multiplier is set to 0.1, the texture's blur amount is effectively, 1. 

Interpolation – Determines how the image is interpolated from the pixel values. Possible values are:

 

Bilinear – Image values are interpolated from four pixels in the bitmap. This is the fastest interpolation method, but the result is not continuous (non-smooth) and may produce artifacts when the map is used for displacement or bump mapping.
Bicubic – Image values are interpolated from sixteen pixels in the bitmap. This is the slowest method, but the results are smooth without too much blur.
Biquadratic – Image values are interpolated from nine pixels in the bitmap. This method is faster than the Bicubic interpolation, but may smooth the image too much. 

Allow Negative Colors –

Transfer Function –

Gamma –

 

Column
width5%

 

Column
width33%

Image Removed

 

Time

 

Section
Column
width62%

These options allow you to control animated textures.

Start Frame – Specifies the beginning of the texture animation. The frame number specified here will be played at the first frame of the scene animation

Playback Rate – Controls the animation speed of the texture as fraction of the actual animation speed. A value of 1 means that the texture animation will run at regular speed. A value of 2 means that the texture animation will run twice as fast as the scene animation.

End Condition – Allows you to control what happens when the last frame of the animated texture is reached. The available options are:

Loop – The animation will start again from the frame specified in the Start Frame option
Ping-pong – The animation will be played backwards until it reaches the the frame specified in the Start Frame option and then play forward again
Hold – The animation will stop at the last frame and it will be displayed until the end of the scene animation.

Column
width5%

 

Column
width33%

Image Removed

 

Noise

Section
Column
width62%

UV Noise On –

Animate UV Noise –

UV Noise Amount –

UV Noise Levels –

UV Noise Size –

UV Noise Phase –

Column
width5%

 

Column
width33%

Image Removed

 

 

...

Transfer Function – Specifies the transfer function for the loaded image file. We recommend keeping this parameter at Auto,  unless you know what you are doing.

Linear – Linear transfer function is applied to the loaded image.  This does not correct any lights or colors. It is good for 16-bit image formats like .exr and some .tiff files.
Gamma corrected – The transfer function is controlled through the Gamma parameter.
sRGB – sRGB transfer function is applied to the loaded image, good for standard image-compressing formats, like .jpg and .png.
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.

Gamma – A gamma–correction value for the image. For example, if the bitmap was saved to disk with a 2.2 gamma correction, you need to enter 0.4545 to remove that correction for the rendering.

RGB Primaries – Allows you to manually override the RGB primaries of the VRayBitmap. The RGB Primaries are, by default, inherited from the current global active color space in V-Ray. To change the global RGB Primaries, go to the Color Management sub-tab in the V-Ray Render Settings. The automatic RGB Primaries inheritance can also be disabled from the Preferences V-Ray Menu.

Raw – No transformation is applied to R|G|B colors. This option is suitable for normal maps, linear textures, and floating value parameters.
sRGB – The loaded image is considered in sRGB color space.
ACEScg – The loaded image is considered in ACEScg color space.

Allow Negative Colors – If disabled, negative colors are clamped. Enable to allow negative colors.

Column
width5%


Column
width45%

Image Added


Output

...


Section
Column
width50%

Color Mult – 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.

Invert – Inverts the output map's hues.

Alpha Source – Determines how the texture alpha is computed:

Bitmap – From the alpha channel of the bitmap image, if present (and returns 1.0, if the image has no alpha channel);
Intensity – The alpha is taken from the intensity of the bitmap image colors (red+green+blue)/3;
Opaque – The alpha channel of the bitmap image is ignored and the VRayBitmap texture always returns 1.0 for alpha.

Alpha Mult –

Alpha Offset –

No UVs 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.

Column
width5%


Column
width45%

Image Added


Mapping

...

Section
Column
width50%

Tile – Specifies how the texture is repeated:

No tiling – No repetition is done;
Tile in UV – Repeats the texture in both U and V axis;
Tile in U – Repeats the texture only on the U axis;
Tile in V – Repeats the texture only on the V axis;
Tile in UV - No Filter

Placement Type – Specifies how the mapping controls below work:

Full – Uses the whole bitmap.
Crop – Uses a section of the bitmap.
Place – Adjusts, according to the position of the image.

Tile U/V – Adjust the tiling along the U and V axis.

U/V – Adjusts the texture location - specifies the location of the top left corner of the image.

Width/Height – Adjusts the width and height of the texture or crop area.

Jitter – Introduces random offset.

Column
width5%


Column
width45%

Image Added


UV Noise

...


Section
Column
width50%

UV Noise On – Enables noise in the pattern of the texture.

Animate UV Noise – Enables animation of the noise effect.

UV Noise Amount – Specifies the strength of the noise. A value of 0 means no noise, while higher values introduce increasing noise.

UV Noise Levels – Specifies how many times the noise is applied to the texture.

UV Noise Size – Allows you to scale the noise, according to the object with the selected texture.

UV Noise Phase – Allows you to control the animation speed of the noise effect, if the noise is animated.

Column
width5%


Column
width45%

Image Added


Animation

...

Type – Determines whether the files are treated as an image Sequence or an Explicit animation. The Sequence Type reads the files as a whole animation, and offers more intuitive settings. It is ideal for general purposes. The Explicit type allows you to manually animate and offset the animation frames, and offers more advanced settings.


Section
Column
width50%

Sequence

Mode – Determines how the animation is played.

Simple – Plays the animation once from start to finish.
Loop – Plays the animation from start to finish infinitely.
Ping-Pong – Plays the animation from start to finish, then from finish to start, and continues like this infinitely.

Timing – Determines the playback speed of the animation.

Exact Frame – Plays one frame of the animation per frame of the render. With this mode, no frames are dropped. If the project and the texture animation have a different Frames Per Second (FPS) setup, the project speed overrides the animation speed.
Exact Second – Matches each second of the animation to each second of the project. This mode ensures that the animation's original speed is kept.
Range – Determines a custom frame range for the animation to play. Use this mode when you don't want the texture animation to play from the first frame.

Range Start and Range End determine the first and last frame of the animation when the Timing is set to Range.

Loops – Determines the number of times the texture animation repeats from the start.

Start Frame – Allows you to manually determine the first frame of the texture animation.

End Frame – Allows you to manually determine the last frame of the texture animation.

Frame Rate – Allows you to manually determine the rate of frames per second of the texture animation.

Calculate – Automatically determines the texture animation's Start Frame, End Frame,and Frame Rate. When rendering sequential images, this information is determined from the images with the lowest and highest number. A frame rate of 25fps is assumed. Other rates have to be entered manually.

Column
width5%


Column
width45%

Image Added


...

Section
Column
width50%

Explicit

Frame Sequence – Enables reading the image sequence.

Use Current Animation Frame – Syncs the timeline frames to the image sequence numbers. This is similar to how the Sequence Type behaves.

Frame Number – Selects the image to be displayed on the current frame. This option allows for manually animating the sequence. We recommend setting the keyframe interpolation in the Timeline to Linear for a predictable frame rate of animation.

Frame Offset – Adds this value to the Frame Number, offsetting the static image to a new frame from the image sequence. Negative numbers can be used here.

Column
width5%


Column
width45%

Image Added



Image File List (.IFL)

...

Section
Column
width50%

This rollout allows you to manually set the properties of your animated texture when using .ifl files.

Start Frame – Determines the first frame of the animation.

Playback Rate – Determines how many frames per second and played back. 

End Condition – Determines the playback mode of the texture animation. 

Loop – Plays the animation from start to finish infinitely.
Ping Pong – Plays the animation from start to finish and then from finish to start. Loops like this infinitely.
Hold – Plays the animation once from start to finish.

Column
width5%


Column
width45%

Image Added