Procedural Textures

What are procedural textures

Procedural textures are textures generated by our engine on the basis of theirs text description. They can be used anywhere instead of normal textures. Text description of procedural texture is set in standard place of texture path and filename. To identify procedural texture is used character "#" on beginning of string. Usually string consists of procedural texture type name and arguments on sides enclosed in brackets: #(A)TypeName(B). There can't be any spaces or mathematical expressions within name.

Textures may be generated procedurally and they take nearly no space on HDD but they still use space in video-memory. Yet if two materials use procedural texture with same name then it's taken as only one texture and uses memory space only once. Thus it's needed to avoid creating unnecessarily nearly same textures.

Types of procedural textures

color

#(format,width,height,number of mipmaps)color(r,g,b,a,texture type)

• format - texture color format (RGB nebo ARGB)
• width - number of pixels in X
• height - number of pixels in Y
• number of mipmaps - number of mipmaps
• r, g, b, a - texture channels (Red, Green, Blue, Alpha). Decimals have to be preceded by a 0 (e.g. 0.5 instead of .5).
• texture type - texture type which match texture name ending without "_" (optional)

Examples:

#(rgb,8,8,3)color(1,0,0,1)
#(rgb,8,8,3)color(0.5,0.5,0.5,1,dt)
#(rgb,8,8,3)color(0.5,0.5,1,1,no)

Render To Texture

#(argb,512,512,1)r2t(surface,aspect)

• surface - The name that will later be used as reference in the camera script
• aspect - Aspect ratio of the image

Examples:

#(argb,512,512,1)r2t(rtt,1.0)
#(argb,512,512,1)r2t(rendersurface,1.333)

Note: Avoid using capital letters when naming rtt surfaces.

perlinNoise

#(format,width,height,number of mipmaps)perlinNoise(xScale,yScale,min,max)

• xScale - horizontal noise scale (typically a multiply of 256)
• yScale - horizontal noise scale (typically a multiply of 256)
• min - minimum value
• max - minimum value

Examples:

#(ai,512,512,9)perlinNoise(256,256,0,1)

irradiance

#(format,width,height,number of mipmaps)irradiance(specular power)

• format - texture color format (RGB nebo ARGB)
• width - number of pixels in X
• height - number of pixels in Y
• number of mipmaps - number of mipmaps
• specular power - specular strenght

It's values table which is used with per-pixel lighting. Modern shaders aren't using this type of texture anymore.

Examples:

#(ai,32,128,1)irradiance(8)

Fresnel

see Super_shader#6._Fresnel_function

#(ai,64,64,1)Fresnel(1.3,7)

fresnelGlass

#(format,width,height,number of mipmaps)fresnelGlass()

• format - texture color format (RGB nebo ARGB)
• width - number of pixels in X
• height - number of pixels in Y
• number of mipmaps - number of mipmaps

Examples:

#(ai,64,64,1)fresnelGlass()

waterIrradiance

#(format,width,height,number of mipmaps)waterIrradiance(specular power)

• format - texture color format (RGB nebo ARGB)
• width - number of pixels in X
• height - number of pixels in Y
• number of mipmaps - number of mipmaps
• specular power - specular strenght

Possible future expansion : As addition to specular exponen there might be refractive index.

This texture main value is solely with special pixel shaders for water.

treeCrown

#(format,width,height,number of mipmaps)treeCrown(density)

• format - texture color format (RGB nebo ARGB)
• width - number of pixels in X
• height - number of pixels in Y
• number of mipmaps - number of mipmaps
• specular power - specular strenght
• density - defines how much light pass thought tree-top via longest line segment

It's used only for diffuse lighting actually it just counts exponential function (v PS2 can be done easily w/o texture)

For ambient lighting is used another type of textures: texture="#(ai,32,32,1)treeCrownAmb(0.5)"; Parameter defines how much surrounding light pass into defined point. Textura is exponential function of distance from circle boundary.

Examples:

#(ai,32,32,1)treeCrown(0.2)

Others

Engine supports also simple procedural textures, you can just write instead of filename

#(format,width,height,number of mipmaps)color(r,g,b,a)

Empty detail map

#(rgb,1,1,1)color(0.5,0.5,0.5,1)

Empty normal map

#(rgb,1,1,1)color(0.5,0.5,1,1)